[Patches] [ python-Patches-429611 ] doc build on win32 with MiKTeX et al.

[noreply@sourceforge.net]

Patches item #429611, was opened at 2001-06-02 08:40
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=305470&aid=429611&group_id=5470

Category: documentation
Group: None
>Status: Open
Resolution: Accepted
Priority: 5
Submitted By: Frederic Giacometti (giacometti)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: doc build on win32 with MiKTeX et al.

Initial Comment:

With this patch, everything build fine on win32 but for the following problems:

  - html/api/labels.pl not generated -> html/api/*.html uncorrect
  - lib/modindex.html not generated -> html/modindex.html uncorrect

Problems worked out:

- fancyhdr.sty is not in the Miktex distribution ...

- Makefile content made compatible with the Windows command line (now runs fine with VC++'s 
nmake, or cygnus's make --win32)

- misc. problems regarding the path formats

- miktex 2.0's pdflatex would block on a mismatching macro level in python.sty -> fixed


Hints on installing latex2html:

- I had to work out some fixes in the config.pl script (2,000 lines of perl...)
- make sure the paths to the ghostscript and miktex installations have no spaces!!!!!! latex2html 
will silently screw up its configuration process
- looking at perl scripts gave me a serious trauma



----------------------------------------------------------------------

>Comment By: Frederic Giacometti (giacometti)
Date: 2001-08-14 17:39

Message:
Logged In: YES 
user_id=93657

When you say 'windows/cygwin', I  don't know if you mean 'cygwin on windows', or 'cygwin' and 'windows'...
So, here are some precisions:

The changes in the doc makefile are first meant to make it compatible with the
Win2K command line shell, and using VC++'s nmake.

As a rule, I try not to mix up Win32 and Cygwin environments together (the bundling of python and some 
Tetex/Latex in the standard cygwin distribution does not help at all).

Since MikTek is easy to install and works fine (in contrast to cygwin's tetex), I build the doc in a 'win32' 
environment; and to put most chances on my side:
    - I don't use cygwin bash for the builds
    - if cygwin make is used, I run it as 'make --win32'.

In what I have installed to compile the docs, cygwin is only required for building some 3rd party graphic 
library required for installing properly latex2html (I could not work it around).

Frederic Giacometti


----------------------------------------------------------------------

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2001-08-10 13:22

Message:
Logged In: YES 
user_id=3066

Added fancyhdr.sty in Doc/texinputs/.

Doc/perl/l2hinit.perl no longer needs "cat" (revision 1.55),
so the adjustment to support CygWin cat is no longer needed
in mkhowto.

Doc/tools/mkhowto revision 1.29 contains changes to be
portable to Windows/CygWin, based on the attached patch.
Still not closed ;-(  -- I need to try to actually
understand what's going on with \pdfendlink, and the README
probably needs a little work.

Frederic, have I missed anything else?  (Sorry to take so
long getting this in!)

Marked "Pending" waiting for feedback.

----------------------------------------------------------------------

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2001-07-17 10:25

Message:
Logged In: YES 
user_id=3066

I've checked in some of the required changes, but others
still need to be considered.

----------------------------------------------------------------------

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2001-07-03 21:30

Message:
Logged In: YES 
user_id=3066

Assigned to the doc-tsar for review.

----------------------------------------------------------------------

You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=305470&aid=429611&group_id=5470