From owner-freebsd-doc@freebsd.org  Sat Feb 20 18:34:21 2016
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 1ADFBAAF39D
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Sat, 20 Feb 2016 18:34:21 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id C531B123B;
 Sat, 20 Feb 2016 18:34:20 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.15.2/8.15.2) with ESMTPS id u1KIYJmu039579
 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sat, 20 Feb 2016 11:34:19 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id u1KIYJa4039576;
 Sat, 20 Feb 2016 11:34:19 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Sat, 20 Feb 2016 11:34:19 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Fedde Schaeffer <fedde.schaeffer@gmail.com>
cc: freebsd-doc@freebsd.org, wblock@FreeBSD.org
Subject: Re: Dead link in handbook
In-Reply-To: <CACk0=Kuqc_7H6YVBxS1wT_b5-fryWiTLk+vCfzroLNnjOoy=2w@mail.gmail.com>
Message-ID: <alpine.BSF.2.20.1602200821350.64002@wonkity.com>
References: <CACk0=Kuqc_7H6YVBxS1wT_b5-fryWiTLk+vCfzroLNnjOoy=2w@mail.gmail.com>
User-Agent: Alpine 2.20 (BSF 67 2015-01-07)
MIME-Version: 1.0
Content-ID: <alpine.BSF.2.20.1602201134000.64002@wonkity.com>
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sat, 20 Feb 2016 11:34:19 -0700 (MST)
Content-Type: text/plain; CHARSET=ISO-8859-7; FORMAT=flowed
Content-Transfer-Encoding: 8BIT
X-Content-Filtered-By: Mailman/MimeDel 2.1.20
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 20 Feb 2016 18:34:21 -0000

On Sat, 20 Feb 2016, Fedde Schaeffer wrote:

> Good day,
>
> On
> https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html
> , in a note under ˇ4.5.3.1. Upgrading Ports Using Portmaster˘, I found a
> link to http://www.freebsd.org/cgi/man.cgi?query=portmaster&sektion=8 , at
> which no manpage could be found. I believe this is because the default
> manpath includes only the base FreeBSD system and not ports, as
> https://www.freebsd.org/cgi/man.cgi?query=portmaster&sektion=8&manpath=FreeBSD+Ports+10.2-RELEASE
> and
> https://www.freebsd.org/cgi/man.cgi?query=portmaster&sektion=8&manpath=FreeBSD+10.2-RELEASE+and+Ports
> do display it.

Yes, this has been a problem for a while.  I have just committed a 
change that will give a default manpath that includes ports.  The HTML 
document has been rebuilt, so please refresh and test that link again.

> Is it difficult to adjust this without unnoticedly making the link 
> point to an old version of the page once a new release comes out?

The documents are rebuilt frequently, so this should not be a problem. 
Old archived versions of the documents will have links to older 
releases, but that is pretty much expected for old documents.

> Thanks,
> Fedde Schaeffer, a long-time laptop Linux (Debianoid) user who was forced
> to try out Mac OS X at work and is now curious to try if proper FreeBSD
> might suit him

Welcome, and thank you!