[Python-bugs-list] [ python-Bugs-727692 ] Documentation formatting bugs

[SourceForge.net]

Bugs item #727692, was opened at 2003-04-25 14:57
Message generated for change (Comment added) made by fdrake
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=727692&group_id=5470

Category: Documentation
Group: Python 2.3
Status: Open
Resolution: None
Priority: 5
Submitted By: Martin v. Löwis (loewis)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: Documentation formatting bugs

Initial Comment:
I found that some of my changes get incorrectly 

formatted, but I don't know how to fix them. Assigning to 

Fred in the hope that he knows the proper incantations.



- HTML version of 4.9.2 (standard encodings):

The table is incorrect in the lines that have an empty 

Aliases column (e.g. cp874). The Alias ought to be 

empty, and "Thai" ought to occur in the third column



- HTML version of 4.9.3 (encodings.IDNA)

The first paragraph starts with a bogus "P>"



- HTML of whatsnew, 17, "Support for internationalized 

domain names": The first line of Python prints as a 

guillemet, not as ">>" Notice that I used a non-

preformatted enviroment so that I could output c-cedilla.



- Postscript version of 4.9.2: the table is overfull in its 

width. It would be ok to wrap the aliases lists as much 

as necessary

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

>Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2003-09-04 17:26

Message:
Logged In: YES 
user_id=3066

Fixed table generation in HTML that caused cells to be

dropped in the standard encodings table in

Doc/perl/python.perl revision 1.140.

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

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2003-04-30 11:06

Message:
Logged In: YES 
user_id=3066

- Standard encodings table: ouch!  I'll see what I can do

about this, but it'll take more time than I can spend right now.



- encodings.idna documentation:  That's a bug in the

formatting software; hopefully I'll be able to fix it. 

Worked around it for now (Doc/lib/libcodecs.tex 1.20).



- What's New document: I've worked around the problem so the

interactive prompt shows up properly, but an extraneous

space is generated at the beginning of the line; not sure

why (Doc/whatsnew/whatsnew23.tex 1.144).



- Postscript:  I expect the PDF to exhibit the same problem.

 This is a general problem for tables with a lot of

horizontal-mode material in LaTeX; I don't know how to work

around this (yet).

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

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