Issue 1595164: texinfo library documentation fails to build (original) (raw)

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.

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..."