[ python-Bugs-1595164 ] texinfo library documentation fails to build

[SourceForge.net]

Bugs item #1595164, was opened at 2006-11-12 14:15
Message generated for change (Comment added) made by pekon
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1595164&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: Python 2.5
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Mark Diekhans (diekhans)
Assigned to: Nobody/Anonymous (nobody)
Summary: texinfo library documentation fails to build

Initial Comment:
Attempting to build the texinfo documentation generates
the error  (args-out-of-range 2931944 2931946).

This occurs in download of 2.5 latex doc and from trunk
of svn tree.

elisp stack trace attached.

It would be really nice if texinfo doc was still
available for download.

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

Comment By: Petr Konecny (pekon)
Date: 2006-11-30 15:42

Message:
Logged In: YES 
user_id=828085
Originator: NO

I believe this problem is triggered by a typo in lib/libmsilib.tex:347

\begin{classdesc}{Feature}{database, id, title, desc, display\optional{,
    level=1\optional{, parent\optional\{, directory\optional{,
    attributes=0}}}}

I think it should look like this:

\begin{classdesc}{Feature}{database, id, title, desc, display\optional{,
    level=1\optional{, parent\optional{, directory\optional{,
    attributes=0}}}}}

With this change I am able to build python-lib.texi. However makeinfo
fails:
makeinfo --footnote-style end --fill-column 72 --paragraph-indent 0
--output=python-lib.info python-lib.texi
python-lib.texi:30398: Unmatched }.
python-lib.texi:30398: Misplaced {.
python-lib.texi:36389: warning: @strong{Note...} produces a spurious
cross-reference in Info; reword to avoid that.
python-lib.texi:49309: Unmatched `@end'.
python-lib.texi:51076: Unknown command `example>>>'.
python-lib.texi:51082: Unmatched `@end'.
python-lib.texi:51104: Unknown command `example>>>'.
python-lib.texi:51110: Unmatched `@end'.
python-lib.texi:59355: Unknown command `examplefrom'.
python-lib.texi:59366: `@end' expected `table', but saw `example'.
makeinfo: Removing output file `python-lib.info' due to errors; use
--force to preserve.


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

Comment By: Martin v. Löwis (loewis)
Date: 2006-11-12 16:47

Message:
Logged In: YES 
user_id=21627

Can you find out what is causing this error?

If not, would you be interested in rewriting this in Python?
(AFAICT, there really is no reason that this conversion is
written in elisp)


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

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