From owner-freebsd-doc@FreeBSD.ORG Thu Mar 12 21:00:09 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D5C65106568B for ; Thu, 12 Mar 2009 21:00:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 9ACBE8FC1E for ; Thu, 12 Mar 2009 21:00:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n2CL09dO027793 for ; Thu, 12 Mar 2009 21:00:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n2CL09wt027792; Thu, 12 Mar 2009 21:00:09 GMT (envelope-from gnats) Resent-Date: Thu, 12 Mar 2009 21:00:09 GMT Resent-Message-Id: <200903122100.n2CL09wt027792@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Patrick McCary Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 798781065672 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/132587: Ton of broken links to man pages in the hand book. Easy fix. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Mar 2009 21:00:11 -0000 >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: