[Python-bugs-list] [ python-Bugs-473060 ] Doc/ doesn't compile in 2.2b1

[noreply@sourceforge.net]

Bugs item #473060, was opened at 2001-10-20 02:22
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=473060&group_id=5470

Category: Build
Group: None
>Status: Closed
>Resolution: Fixed
Priority: 4
Submitted By: Masanori Omote (omote)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: Doc/ doesn't compile in 2.2b1

Initial Comment:
Documentations in the distribution tar file of 2.2b1
doesn't compile.  Doc/ of a snapshot tar ball on
10/19/01 compiles correctly.  Materials under Doc/ in
both tar balls are the same according to diff -r
check.  Containing a dot (.) in the name of the top
directory of 2.2b1 leads to a LaTeX2HTML error,
according to its error message.

It wouldn't be a bug because the README file in Doc
directory says that a user should "twiddle"
Doc/Makefile.  But I hope all the documentation can be
easily compiled from the next distribution files.


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

>Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2001-11-02 11:07

Message:
Logged In: YES 
user_id=3066

Oops, I made changes to fix this earlier this week, but
didn't close the bug report.  Here's what I did:

 - Added a --dvips-safe option to mkhowto to control the
   LaTeX2HTML variable $DVIPS_SAFE; setting this causes
   the complaint to go away.

 - Use --dvips-safe in the Makefile so that we always use
   it when generating HTML; this is fine with the Python
   docs since we don't have content that requires dvips.

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

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

Message:
Logged In: YES 
user_id=3066

As noted in the error message, this is because there's a dot
in the path to the documentation sources.  While I consider
this to be primarily a tools problem, it's sufficiently
annoying that it deserves some attention.

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

Comment By: Masanori Omote (omote)
Date: 2001-10-20 09:17

Message:
Logged In: YES 
user_id=232907

Additional info of omote's case:
System: RH 7.1
Python: 2.1.1 (2.2b1 not yet installed)
LaTeX2HTML: 2K.1beta (1.47)

When I compile Doc/ in the extracted tree of 2.2b1
distribution tar file, it fails.  It doesn't fail when I
move Doc/ directory to any other directory which path
doesn't contain a dot.  Following is a failure example to
compile 'doc'.

% pwd
/home/masa/ftp/python/Python-2.2b1/Doc
% make doc
python tools/mkhowto --html --about html/stdabout.dat
--address "See <i><a href=\about.html\>About this
document...</a></i> for information on suggesting changes."
--up-link ../index.html --up-title "Python Documentation
Index" --global-module-index "../modindex.html" --dir
html/doc doc/doc.tex
+++
TEXINPUTS=/home/masa/ftp/python/Python-2.2b1/Doc/doc:/home/masa/ftp/python/Python-2.2b1/Doc/paper-letter:/home/masa/ftp/python/Python-2.2b1/Doc/texinputs:
+++ latex doc
+++ latex2html -init_file doc.l2h -dir
/home/masa/ftp/python/Python-2.2b1/Doc/html/doc
/home/masa/ftp/python/Python-2.2b1/Doc/doc/doc.tex
*** Session transcript and error messages are in
/home/masa/ftp/python/Python-2.2b1/Doc/html/doc/doc.how.
*** Exited with status 255.
The relevant lines from the transcript are:
------------------------------------------------------------------------
+++ latex2html -init_file doc.l2h -dir
/home/masa/ftp/python/Python-2.2b1/Doc/html/doc
/home/masa/ftp/python/Python-2.2b1/Doc/doc/doc.tex
Note: Initialising with file: doc.l2h
This is LaTeX2HTML Version 2K.1beta (1.47)
by Nikos Drakos, Computer Based Learning Unit, University of
Leeds.

Revised and extended by:
 Marcus Hennecke, Ross Moore, Herb Swan and others
...producing markup for HTML version 4.0  



Loading /usr/share/latex2html/versions/html4_0.pl

 *** processing declarations ***

Loading /usr/share/latex2html/versions/latin1.pl


 *** Fatal Error --- but easy to fix ***

Cannot have '.' in file-name prefix, else dvips fails on
images
Change the name from 
/home/masa/ftp/python/Python-2.2b1/Doc/doc/doc.tex  and try
again.

*** Session transcript and error messages are in
/home/masa/ftp/python/Python-2.2b1/Doc/html/doc/doc.how.
*** Exited with status 255.



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

Comment By: Martin v. Löwis (loewis)
Date: 2001-10-20 06:31

Message:
Logged In: YES 
user_id=21627

Can you give more details as to how exactly compilation 
fails?


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

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