From owner-freebsd-doc@FreeBSD.ORG Thu Jan 16 04:22:22 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 2F138F7F for ; Thu, 16 Jan 2014 04:22:22 +0000 (UTC) Received: from smtp.centurylink.net (mail.centurylink.net [205.219.233.9]) by mx1.freebsd.org (Postfix) with ESMTP id E4BF21964 for ; Thu, 16 Jan 2014 04:22:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha1; d=embarqmail.com; s=s012408; c=relaxed/simple; q=dns/txt; i=@embarqmail.com; t=1389846133; h=From:Subject:Date:To:Mime-Version:Content-Type; bh=tArn4LAUJcBU9SZ2sGwR4mstWn8=; b=KM975V0TnxJJPqWH+3xU2sa35iVPRvi4uy1mx0gpC9hBu26SC0i4ix+wXb1D6b5S mO/W+2g+IDw3jN8avRD4t8xu0eUaqu0sUBgKoqUyRAv2zdAnVZgYFegTEZq618TB; X_CMAE_Category: , , X-CNFS-Analysis: v=2.0 cv=C9hrOHz+ c=1 sm=1 a=3dn2BDQDCgitC1PfbxxZ7A==:17 a=woYuQ9x9YFUA:10 a=1poGYrevpj8A:10 a=kj9zAlcOel0A:10 a=1oqGTYSLAAAA:8 a=vQ-Ux2BlmZsA:10 a=zIn1_g8AAAAA:8 a=s1O25tkdAAAA:8 a=0bMT7DezCCigMKB2uQAA:9 a=CjuIK1q_8ugA:10 a=EL3xEuD-4lQA:10 a=OyOq_G8mXAEA:10 a=3dn2BDQDCgitC1PfbxxZ7A==:117 X-CM-Score: 0 X-Scanned-by: Cloudmark Authority Engine Authentication-Results: smtp02.agate.dfw.synacor.com smtp.mail=bsd-unix@embarqmail.com; spf=neutral; sender-id=neutral Authentication-Results: smtp02.agate.dfw.synacor.com header.from=bsd-unix@embarqmail.com; sender-id=neutral Authentication-Results: smtp02.agate.dfw.synacor.com smtp.user=bsd-unix@embarqmail.com; auth=pass (LOGIN) Received-SPF: neutral (smtp02.agate.dfw.synacor.com: 71.3.82.230 is neither permitted nor denied by domain of embarqmail.com) Received: from [71.3.82.230] ([71.3.82.230:26020] helo=earth.milkyway.net) by smtp.centurylink.net (envelope-from ) (ecelerity 3.5.1.37854 r(Momo-dev:3.5.1.0)) with ESMTPA id BF/98-21467-47E57D25; Wed, 15 Jan 2014 23:22:13 -0500 Date: Wed, 15 Jan 2014 23:22:11 -0500 From: Randy Pratt To: freebsd-doc@FreeBSD.org Subject: Re: The Handbook doc on "pkg" is badly out of date Message-Id: <20140115232211.ac5732fc4f8557490e200a5e@embarqmail.com> In-Reply-To: References: <1AD4F981-7EB6-4959-A773-560C9617839E@proper.com> <30026F0F-8FCE-4F4C-B8FE-0A1A814D6B99@proper.com> X-Mailer: Sylpheed 3.3.0 (GTK+ 2.24.22; i386-portbld-freebsd8.4) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Jan 2014 04:22:22 -0000 On Wed, 15 Jan 2014 14:40:14 -0800 Paul Hoffman wrote: > On Jan 15, 2014, at 2:05 PM, Warren Block wrote: > > >> You might have this backwards. I'm pretty sure that the handbook shows the old configuration information, and the Wiki shows the new. > > > > I don't understand how. The Handbook mentions pkg.conf but does not show any entries for it, while the wiki shows a sample file. > > The handbook says: > ===== > The pkgng package management system uses a package repository for most operations. The default package repository location is defined in /usr/local/etc/pkg.conf or by the PACKAGESITE environment variable, which overrides the configuration file. > ===== > That's not true. The default package respository location is defined in /usr/local/etc/pkg/repos/FreeBSD.conf, as the Wiki describes. > > > Again, I believe the file changed, and it was the presence of the obsolete version that caused the messages. The current port only installs pkg.conf.sample. > > Well, yes. And, when you read the above in the Handbook and see the .sample file, you copy to to pkg.conf. > > > Maybe it would help to be more specific: what needs to be changed in the Handbook version? It would be better to incorporate all contents of the wiki into the Handbook, remove the wiki and redirect the users to the Handbook. This would avoid stale and/or conflicting information in the future (and user frustrations). I ran into the same things when I switched to using pkgng a couple months ago and still have a ways to go before I'll be comfortable with it. Best regards, Randy