[ python-Bugs-1595164 ] texinfo library documentation fails to build
SourceForge.net
noreply at sourceforge.net
Sat Mar 24 17:38:14 CET 2007
Bugs item #1595164, was opened at 2006-11-12 20:15
Message generated for change (Comment added) made by zseil
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: Žiga Seilnacht (zseil)
Date: 2007-03-24 17:38
Message:
Logged In: YES
user_id=1326842
Originator: NO
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.
----------------------------------------------------------------------
Comment By: Martin v. Löwis (loewis)
Date: 2006-11-30 21:59
Message:
Logged In: YES
user_id=21627
Originator: NO
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.
----------------------------------------------------------------------
Comment By: Petr Konecny (pekon)
Date: 2006-11-30 21:55
Message:
Logged In: YES
user_id=828085
Originator: NO
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}:
- at example>>> from ctypes import c_int, WINFUNCTYPE, windll
+ at 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
+>>>
+ at 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}:
- at example>>> from ctypes import POINTER, WINFUNCTYPE, windll
+ at 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
+>>>
+ at 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:
- at examplefrom wsgiref.simple_server import make_server, demo_app
+ at example
+from wsgiref.simple_server import make_server, demo_app
httpd = make_server('', 8000, demo_app)
print "Serving HTTP on port 8000..."
----------------------------------------------------------------------
Comment By: Petr Konecny (pekon)
Date: 2006-11-30 21: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 22: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
More information about the Python-bugs-list
mailing list