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: "make info" croaks
Type: Stage:
Components: Documentation Versions: Python 2.3
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: fdrake Nosy List: fdrake, skip.montanaro
Priority: normal Keywords:

Created on 2003-07-11 20:50 by skip.montanaro, last changed 2022-04-10 16:09 by admin. This issue is now closed.

Messages (2)
msg17037 - (view) Author: Skip Montanaro (skip.montanaro) * (Python triager) Date: 2003-07-11 20:50
I noticed this problem mentioned on the fink list.  In the
Docs/info directory, executing "make" leads to an Emacs
error:

% pwd
/Users/skip/src/python/head/dist/src/Doc/info
% make
Using emacs to build the info docs
EMACS=emacs ../tools/mkinfo ../lib/lib.tex python-lib.texi 
python-lib.info
emacs -batch -q --no-site-file -l /Users/skip/src/python/
head/dist/src/Doc/tools/py2texi.el --eval (setq py2texi-dirs 
'("./" "../texinputs/" "/Users/skip/src/python/head/dist/src/
Doc/lib")) --eval (setq py2texi-texi-file-name "python-
lib.texi") --eval (setq py2texi-info-file-name "python-
lib.info") --eval (py2texi "/Users/skip/src/python/head/dist/
src/Doc/lib/lib.tex") -f kill-emacs
Mark set
Args out of range: 405571, 405573
make: *** [python-lib.info] Error 255

The regular expression used to match Latex commands
will skip over an optional argument, but that argument
can't contain a right square bracket.  This is okay:

    \versionchanged[foo bar baz]{2.3}

but this is not

    \versionchanged[foo [bar] baz]{2.3}

The \versionchanged macro at the end of libre.tex violates
this property.  I'm not sure what to do about it since
regular expressions can't count nesting depth.  A
quick hack appears to be to change the search pattern in
py2texi-process-commands to

    "\\\\\\([a-zA-Z*]+\\)\\(\\[[^}]*\\]\\)?"

but I'm not sure what other side-effects that might have
on the info file generation.

msg17038 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2003-07-16 16:27
Logged In: YES 
user_id=3066

This particular bug has been fixed in Doc/lib/libre.tex
revision 1.101.
Other issues remain in the GNU info conversion; still
working on those.
History
Date User Action Args
2022-04-10 16:09:56adminsetgithub: 38839
2003-07-11 20:50:58skip.montanarocreate