Bug 132587

Summary: Ton of broken links to man pages in the hand book. Easy fix.
Product: Documentation Reporter: Pat McCary <pat>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Pat McCary 2009-03-12 21:00:09 UTC 
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.

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
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.
Comment 1 dfilter service freebsd_committer freebsd_triage 2009-03-12 23:00:12 UTC 
manolis     2009-03-12 22:59:52 UTC

  FreeBSD doc repository

  Modified files:
    share/sgml           freebsd-html.dsl 
  Log:
  Allow ports manpages to point to the now available 7.1-RELEASE pages
  
  PR:             docs/132587
  Submitted by:   Patrick McCary <pat@patmccary.com>
  
  Revision  Changes    Path
  1.3       +1 -1      doc/share/sgml/freebsd-html.dsl
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 2 Manolis Kiagias freebsd_committer freebsd_triage 2009-03-12 23:08:26 UTC 
State Changed
From-To: open->closed

A patch has been committed and the pages will be updated in the next few hours. 
Thanks for submitting this!