From nobody@FreeBSD.org  Thu Mar 12 20:56:54 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 798781065672
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Mar 2009 20:56:54 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 672CB8FC29
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Mar 2009 20:56:54 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n2CKusc0052812
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Mar 2009 20:56:54 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n2CKur6H052811;
	Thu, 12 Mar 2009 20:56:53 GMT
	(envelope-from nobody)
Message-Id: <200903122056.n2CKur6H052811@www.freebsd.org>
Date: Thu, 12 Mar 2009 20:56:53 GMT
From: Patrick McCary <pat@patmccary.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Ton of broken links to man pages in the hand book. Easy fix.
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 12 21:00:09 UTC 2009
>Closed-Date:    Thu Mar 12 23:09:37 UTC 2009
>Last-Modified:  Thu Mar 12 23:10:01 UTC 2009
>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:
State-Changed-From-To: open->closed 
State-Changed-By: manolis 
State-Changed-When: Thu Mar 12 23:08:26 UTC 2009 
State-Changed-Why:  
A patch has been committed and the pages will be updated in the next few hours. 
Thanks for submitting this! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=132587 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/132587: commit references a PR
Date: Thu, 12 Mar 2009 23:00:12 +0000 (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"
 
>Unformatted:
