Broken \ref link in documentation

[freddrake]

BPO	217195
Nosy	@freddrake, @terryjreedy

^{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 2002-10-18.15:23:25.000>
created_at = <Date 2000-10-18.18:51:29.000>
labels = ['docs']
title = 'Broken \\ref link in documentation'
updated_at = <Date 2002-10-18.15:23:25.000>
user = 'https://github.com/freddrake'

bugs.python.org fields:

activity = <Date 2002-10-18.15:23:25.000>
actor = 'fdrake'
assignee = 'fdrake'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2000-10-18.18:51:29.000>
creator = 'fdrake'
dependencies = []
files = []
hgrepos = []
issue_num = 217195
keywords = []
message_count = 7.0
messages = ['2084', '2085', '2086', '2087', '2088', '2089', '2090']
nosy_count = 4.0
nosy_names = ['nobody', 'jhylton', 'fdrake', 'terry.reedy']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue217195'
versions = []

[freddrake]

[Report received by python-docs.]

From: Roy Smith <rsmith@micromuse.com>
Date: Wed, 18 Oct 2000 14:45:25 -0700

On the page http://www.python.org/doc/current/ref/exceptions.html, if I
click on the link for secion 7.4
(http://www.python.org/doc/current/ref/node83.html#try), I get an Error
404: file not found.

[freddrake]

I'll note that I think this is a LaTeX2HTML bug, but I need to spend some time digging into the \ref{} handling. It seems to have other problems as well. ;-(

[nobody]

Logged In: NO

ergdfvgdfdfgsdgff

[jhylton]

Logged In: YES
user_id=31392

Was it a LaTeX2HTML bug or not?

[terryjreedy]

Logged In: YES
user_id=593130

The page in question is '4.2 Exceptions'
http://www.python.org/doc/current/ref/exceptions.html

The line in question is:
See also the description of the try statement in section 7.4
and raise statement in section 6.9.

6.9 links to '6.9 The raise statement'
http://www.python.org/doc/current/ref/raise.html#raise
which works fine

7.4 links to the now obsolete URL
http://www.python.org/doc/current/ref/node83.html#try
It should link to the current '7.4 The try statement '
http://www.python.org/doc/current/ref/try.html
or maybe?
http://www.python.org/doc/current/ref/try.html#try

Isn't this a simple update so that the 7.4 ref works like the
6.9 ref?

PS. I would like also like references from 7.4 to 4.2 and 6.9

[freddrake]

Logged In: YES
user_id=3066

Links fixed with a patch by Neal Norwitz in
Doc/tools/node2label.pl revisions 1.14 and 1.12.18.1.

This turned out not to be a LaTeX2HTML bug but a bug in our
own re-naming script that we use to post-process the
generated HTML (not surprising, but this was a question
earlier).

I'm marking this fixed but left open since this issue's
comments include a request for additional cross-references
in the language reference.

[freddrake]

Logged In: YES
user_id=3066

Added additional cross-references in Doc/ref/ref6.tex
revisions 1.56, 1.47.4.4, and Doc/ref/ref7.tex revisions
1.35, 1.29.8.6.
Closing the report.