build of html docs broken (liboptparse.tex)

[doko42]

BPO	732174
Nosy	@tim-one, @freddrake, @rhettinger, @doko42
Files	info-doc-build.diffs

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/freddrake'
closed_at = <Date 2004-03-25.16:15:26.000>
created_at = <Date 2003-05-04.13:47:51.000>
labels = ['docs']
title = 'build of html docs broken (liboptparse.tex)'
updated_at = <Date 2004-03-25.16:15:26.000>
user = 'https://github.com/doko42'

bugs.python.org fields:

activity = <Date 2004-03-25.16:15:26.000>
actor = 'fdrake'
assignee = 'fdrake'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2003-05-04.13:47:51.000>
creator = 'doko'
dependencies = []
files = ['5248']
hgrepos = []
issue_num = 732174
keywords = ['patch']
message_count = 9.0
messages = ['43617', '43618', '43619', '43620', '43621', '43622', '43623', '43624', '43625']
nosy_count = 4.0
nosy_names = ['tim.peters', 'fdrake', 'rhettinger', 'doko']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue732174'
versions = ['Python 2.3']

[doko42]

The last known working versions is 1.6. 1.7 doesn't
build anymore. latex2html returns

[...]
Reading aux file:
/build/packages/python2.3/python2.3-2.2.102/Doc/lib.aux ...
Processing macros
...,,,,++................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................Subroutine
do_cmd_leftmargin redefined at (eval 732) line 1.

defining handler for \leftmargin using \leftmargini
.............Undefined subroutine
&main::do_cmd_leftmargini called at (eval 732) line 1.

[tim-one]

Logged In: YES
user_id=31435

Assigning to Raymond for practice in finding the Submit
button <wink>.

[doko42]

Logged In: YES
user_id=60903

Reopened. Please practice on other reports ;-)

[doko42]

Logged In: YES
user_id=60903

Attached is a patch to fix the build of the info docs. The
change to libre.tex maybe controversial, as it works around
a problem in py2texi.el.

[rhettinger]

Logged In: YES
user_id=80475

The latest version is 1.9.
Fred made changes to make it build again.

[doko42]

Logged In: YES
user_id=60903

Which version? py2texi.el is at 1.3 and unchanged the last
six months.

[freddrake]

Logged In: YES
user_id=3066

Several parts of the patch are now committed, but not
everything. In particular, the changes to Doc/lib/libre.tex
have not been committed, pending time for me to take a
closer look.

[freddrake]

Logged In: YES
user_id=3066

Current status:

• "Python Library Reference" doesn't format, and I don't
  think this is the libre.tex problem. I get the message
  "Args out of range: 406147, 406149". I don't know what this
  refers to.

• "Documenting Python" doesn't convert because of a couple
  of highly specialized macros that are defined locally within
  other macros with really short names. I don't really want
  to support them directly since they have such short names
  ("p" and "op"), though I did cave for the HTML conversion.

• "Installing Python Modules" doesn't convert because it
  uses a specialized macro defined inline in the document
  ("installscheme"), but I don't really want to replace that
  in the document with the standard table markup.

• "What's New in Python 2.X" is now built; any verision back
  to whatsnew21.tex can be formatted; the 2.0.x version isn't
  worth any work to make it format at this point. Only the
  current version is formatted by default; alternate versions
  can be specified using the WHATSNEW make variable.

[freddrake]

Logged In: YES
user_id=3066

I'm not sure why the comments on this report discuss the
info documentation when the original report is clearly about
the HTML documentation.

As far as I can tell, the HTML is currently being generated
without errors. If I've missed something, please open a new
report with pertinent information.