python / cpython

The Python programming language
https://www.python.org/
Other
59.96k stars 29.02k forks source link

Doc/ doesn't compile in 2.2b1 #35365

Closed abead9f8-555f-4c51-bb70-f1e6f54a32d9 closed 22 years ago

abead9f8-555f-4c51-bb70-f1e6f54a32d9 commented 22 years ago
BPO 473060
Nosy @loewis, @freddrake

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 = [] ```

abead9f8-555f-4c51-bb70-f1e6f54a32d9 commented 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.

61337411-43fc-4a9c-b8d5-4060aede66d0 commented 22 years ago

Logged In: YES user_id=21627

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

abead9f8-555f-4c51-bb70-f1e6f54a32d9 commented 22 years ago

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.

freddrake commented 22 years ago

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.

freddrake commented 22 years ago

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: