From owner-freebsd-doc@FreeBSD.ORG Sat Nov 24 04:52:47 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 10F04C8F; Sat, 24 Nov 2012 04:52:47 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-8.mit.edu (DMZ-MAILSEC-SCANNER-8.MIT.EDU [18.7.68.37]) by mx1.freebsd.org (Postfix) with ESMTP id 8B8CF8FC12; Sat, 24 Nov 2012 04:52:46 +0000 (UTC) X-AuditID: 12074425-b7fcc6d00000091f-d1-50b05298b1e9 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP id A0.CE.02335.89250B05; Fri, 23 Nov 2012 23:52:40 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id qAO4qeq2013962; Fri, 23 Nov 2012 23:52:40 -0500 Received: from multics.mit.edu (SYSTEM-LOW-SIPB.MIT.EDU [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id qAO4qbDL010806 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 23 Nov 2012 23:52:39 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id qAO4qbxG002360; Fri, 23 Nov 2012 23:52:37 -0500 (EST) Date: Fri, 23 Nov 2012 23:52:37 -0500 (EST) From: Benjamin Kaduk To: Glen Barber Subject: Re: Request for Review: pkgng documentation for the Handbook In-Reply-To: <20121123173758.GA1282@glenbarber.us> Message-ID: References: <20121116165810.GC1335@glenbarber.us> <20121123173758.GA1282@glenbarber.us> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrBIsWRmVeSWpSXmKPExsUixG6nrjsjaEOAwYuDAhanznSxWuxvPsDm wOQx49N8lgDGKC6blNSczLLUIn27BK6Mqct3MRfclq2YvXk1ewPjQ/EuRk4OCQETiWW79rNC 2GISF+6tZ+ti5OIQEtjHKNH7dgUThLOBUWLa3ulQzgkmiQdPj7JCOA2MEpemzGEH6WcR0JZY NvEMM4jNJqAiMfPNRjYQW0RAUWLZ2mdgNcwC0hIN6zczgdjCAq4SLxbPAKrn4OAUMALqLQIJ 8wo4SKzt2cQCYgsJhEu8/rwNzBYV0JFYvX8KC0SNoMTJmU9YIEZaSvxb+4t1AqPgLCSpWUhS CxiZVjHKpuRW6eYmZuYUpybrFicn5uWlFula6OVmluilppRuYgQHqIvqDsYJh5QOMQpwMCrx 8CacWR8gxJpYVlyZe4hRkoNJSZT3nu+GACG+pPyUyozE4oz4otKc1OJDjBIczEoivHfdgXK8 KYmVValF+TApaQ4WJXHeGyk3/YUE0hNLUrNTUwtSi2CyMhwcShK8xYFAjYJFqempFWmZOSUI aSYOTpDhPEDDD4DU8BYXJOYWZ6ZD5E8xKkqJ884FSQiAJDJK8+B6YQnkFaM40CvCvD4gVTzA 5APX/QpoMBPQ4Kez14EMLklESEk1MO7NbInQUVy+eo1d9aUpf4vv9zy66BbWPzeB66qegwfP v0fWng/Phz9myck111RkPmD+onn/ymszf05iZ2g7coUteKfcxKmeAnXz1r+6euC6Qq9mxBwF LaOvKiYGPiHdQtyv3r6L/nvc/xrnvVvnZOYKaWxsyruhPVf+mTJzHcfsT7LyHxul1ZRYijMS DbWYi4oTAZFreeH7AgAA Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Nov 2012 04:52:47 -0000 On Fri, 23 Nov 2012, Glen Barber wrote: > Hi, > > On Fri, Nov 16, 2012 at 11:58:10AM -0500, Glen Barber wrote: >> Hi, >> >> I would like to get feedback on recent commits to the projects/pkgng/ >> branch, which adds documentation for pkgng to the Handbook. >> >> There are a few sections on my todo list, but I feel what is there now >> covers the basics for FreeBSD users. >> >> The diff is attached, and rendered output is here: >> >> http://people.freebsd.org/~gjb/pkgng/data/doc/en/books/handbook/pkgng-intro.html >> >> I would like to merge this into head/ when 9.1-RELEASE is announced. >> > > As 9.1-RELEASE is delayed longer than originally expected with this > original request for review, I plan to merge this pkgng documentation to > head/ within the next day so I can continue to use the existing > projects/pkgng/ branch for further addtitions to the section. % % The pkgng package management % utility is not supported on % &os; 7.X or % &os; 8.0. 0 is not exactly replacable... % The package database conversion may emit errors as the % contents are converted to the new version. Generally, these % errors can be safely ignored, however a list of third-party % software that was not successfully converted will be listed % after pkg2ng has finished. These must be % fixed by hand. Is that "fix by hand" going to be deinstall/reinstall most of the time? We might want to say so. % % Installing and Removing Packages with % <application>pkgng</application> % % In general, most &os; users will install binary packages % by running: % % &prompt.root; pkg install packagename % % pkg install uses repository data, as Mentioning once at an arbitrary location; this document has a great deal of sentences that start with a markup element (i.e., not a capital letter). Not sure that it's worth trying to do anything about it now, though. % % Automatically Removing Leaf Dependencies with % <application>pkgng</application> % % Removing a package may leave behind unnecessary % dependencies, like security/ca_root_nss in the example % above. Those packages are still installed, but nothing Maybe s/Those/Such/ ? % % By default, pkgng stores % binary packages in a cache directory as defined by % PKG_CACHEDIR in pkg.conf(5). When % upgrading packages with pkg upgrade, old % versions of the upgraded packages are not automatically % removed. % % To remove the outdated binary packages from the system, Perhaps this should be file system instead of just "system"? The current text might be a little ambiguous as to whether the outdated package is actually installed/being used. % Unlike the ports-mgmt/portmaster and % ports-mgmt/portupgrade % ports, the order in which the new and old versions are % listed differ. For pkgng, the % syntax is pkg set -o My broswer puts a line break between the '-' and the 'o', which seems very odd. I don't know that there's a markup fix for that, though; I just mention it as odd. Thanks for putting this all together! -Ben