docs/132587: Ton of broken links to man pages in the hand book. Easy fix.
Patrick McCary
pat at patmccary.com
Thu Mar 12 21:00:11 UTC 2009
>Number: 132587
>Category: docs
>Synopsis: Ton of broken links to man pages in the hand book. Easy fix.
>Confidential: no
>Severity: serious
>Priority: high
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Mar 12 21:00:09 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator: Patrick McCary
>Release: 7.1-RELEASE
>Organization:
self
>Environment:
7.1-RELEASE i386 i386
>Description:
I noticed this following the portupgrade(1) link from http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html. The portupgrade(1) link is (doesn't work):
http://www.freebsd.org/cgi/man.cgi?query=portupgrade&sektion=1&manpath=FreeBSD+7.0-RELEASE+and+Ports
It should be:
http://www.freebsd.org/cgi/man.cgi?query=portupgrade&apropos=0&sektion=0&manpath=FreeBSD+7.1-RELEASE+and+Ports&format=html
The difference is on the end of the links:
- broke = &sektion=1&manpath=FreeBSD+7.0-RELEASE+and+Ports
- works = &apropos=0&sektion=0&manpath=FreeBSD+7.1-RELEASE+and+Ports&format=html
If you pull up the single page version of the hand book http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book.html and view source, you can search on "&sektion=1&manpath=FreeBSD+7.0-RELEASE+and+Ports" and there are a ton of matches.
I only spot checked a few but making the change referenced above took me to the correct man page every time.
>How-To-Repeat:
Goto http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html and follow the portupgrade(1) link to the man page.
Then follow this link: http://www.freebsd.org/cgi/man.cgi?query=portupgrade&apropos=0&sektion=0&manpath=FreeBSD+7.1-RELEASE+and+Ports&format=html.
>Fix:
In the hand book html files, search for:
&sektion=1&manpath=FreeBSD+7.0-RELEASE+and+Ports
And replace with:
&apropos=0&sektion=0&manpath=FreeBSD+7.1-RELEASE+and+Ports&format=html
>Release-Note:
>Audit-Trail:
>Unformatted:
More information about the freebsd-doc
mailing list