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