Closed abead9f8-555f-4c51-bb70-f1e6f54a32d9 closed 22 years ago
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.
Logged In: YES user_id=21627
Can you give more details as to how exactly compilation fails?
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.
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.
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.
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields: ```python assignee = 'https://github.com/freddrake' closed_at =
created_at =
labels = ['build']
title = "Doc/ doesn't compile in 2.2b1"
updated_at =
user = 'https://bugs.python.org/omote'
```
bugs.python.org fields:
```python
activity =
actor = 'fdrake'
assignee = 'fdrake'
closed = True
closed_date = None
closer = None
components = ['Build']
creation =
creator = 'omote'
dependencies = []
files = []
hgrepos = []
issue_num = 473060
keywords = []
message_count = 5.0
messages = ['7089', '7090', '7091', '7092', '7093']
nosy_count = 3.0
nosy_names = ['loewis', 'fdrake', 'omote']
pr_nums = []
priority = 'low'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue473060'
versions = []
```