This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: texinfo library documentation fails to build
Type: Stage:
Components: Documentation Versions: Python 2.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: Nosy List: diekhans, loewis, pekon, zseil
Priority: normal Keywords:

Created on 2006-11-12 19:15 by diekhans, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
err.txt diekhans, 2006-11-12 19:15 lisp stack trace
Messages (7)
msg30524 - (view) Author: Mark Diekhans (diekhans) Date: 2006-11-12 19:15
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.
msg30525 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2006-11-12 21:47
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)
msg30526 - (view) Author: Petr Konecny (pekon) Date: 2006-11-30 20:42
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.
msg30527 - (view) Author: Petr Konecny (pekon) Date: 2006-11-30 20:55
After changing libmsilib.tex I made some manual fixes in python-lib.texi and was able to get .info files. I am attaching diff, which shows what is broken.

--- python-lib.texi     2006-11-30 12:54:04.626177825 -0800
+++ python-lib.texi.fixed       2006-11-30 12:53:28.767367718 -0800
@@ -30395,7 +30395,7 @@
 QName wrapper.  This can be used to wrap a QName attribute value, in
 order to get proper namespace handling on output.
 @var{text_or_uri} is a string containing the QName value,
-in the form @{@{}uri{@}@}local, or, if the tag argument is given,
+in the form @{uri@}local, or, if the tag argument is given,
 the URI part of a QName.
 If @var{tag} is given, the first argument is interpreted as
 an URI, and this argument is interpreted as a local name.
@@ -49305,8 +49305,6 @@
 @findex EDQUOT
 Quota exceeded @end table
 
-\ifx\locallinewidth\undefined\newlength@{\locallinewidth@}@end ifinfo
-\setlength@{\locallinewidth@}@{\linewidth@}
 @node ctypes,  , errno, Generic Operating System Services
 @section A foreign function library for Python.
 
@@ -51073,12 +51071,14 @@
 
 Here is the wrapping with @code{ctypes}:
 
-@example>>> from ctypes import c_int, WINFUNCTYPE, windll
+@example
+>>> from ctypes import c_int, WINFUNCTYPE, windll
 >>> from ctypes.wintypes import HWND, LPCSTR, UINT
 >>> prototype = WINFUNCTYPE(c_int, HWND, LPCSTR, LPCSTR, c_uint)
 >>> paramflags = (1, "hwnd", 0), (1, "text", "Hi"), (1, "caption", None), (1, "flags", 0)
 >>> MessageBox = prototype(("MessageBoxA", windll.user32), paramflags)
->>>@end example
+>>>
+@end example
 
 The MessageBox foreign function can now be called in these ways:
 @example
@@ -51101,12 +51101,14 @@
 
 Here is the wrapping with @code{ctypes}:
 
-@example>>> from ctypes import POINTER, WINFUNCTYPE, windll
+@example
+>>> from ctypes import POINTER, WINFUNCTYPE, windll
 >>> from ctypes.wintypes import BOOL, HWND, RECT
 >>> prototype = WINFUNCTYPE(BOOL, HWND, POINTER(RECT))
 >>> paramflags = (1, "hwnd"), (2, "lprect")
 >>> GetWindowRect = prototype(("GetWindowRect", windll.user32), paramflags)
->>>@end example
+>>>
+@end example
 
 Functions with output parameters will automatically return the output
 parameter value if there is a single one, or a tuple containing the
@@ -59352,7 +59354,8 @@
 .
 
 Example usage:
-@examplefrom wsgiref.simple_server import make_server, demo_app
+@example
+from wsgiref.simple_server import make_server, demo_app
 
 httpd = make_server('', 8000, demo_app)
 print "Serving HTTP on port 8000..."
msg30528 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2006-11-30 20:59
pekon, it would be quite helpful if you could resolve this. It would be best if you could check out the subversion trunk or release25-maint branch, and then provide a patch that solves it all :-)

After applying your (correct) patch, I still get such an error, so I guess there are more problems in the tex source.
msg30529 - (view) Author: Ziga Seilnacht (zseil) * (Python committer) Date: 2007-03-24 16:38
This should be fixed with r52974 and r52975:
http://svn.python.org/view?view=rev&rev=52974

I can't test it on Windows, so someone else
should close this bug if it is fixed.
msg30530 - (view) Author: Martin v. Löwis (loewis) * (Python committer) Date: 2007-03-24 18:25
There is no need that the documentation builds on Windows, so closing this as fixed. zseil, thanks for looking into it.
History
Date User Action Args
2022-04-11 14:56:21adminsetgithub: 44226
2006-11-12 19:15:40diekhanscreate