From owner-freebsd-doc@FreeBSD.ORG Sat Nov 24 19:55:57 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 75A24BF8; Sat, 24 Nov 2012 19:55:57 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-3.mit.edu (DMZ-MAILSEC-SCANNER-3.MIT.EDU [18.9.25.14]) by mx1.freebsd.org (Postfix) with ESMTP id EC3978FC08; Sat, 24 Nov 2012 19:55:56 +0000 (UTC) X-AuditID: 1209190e-b7f756d000000904-b5-50b126459812 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP id F8.DF.02308.54621B05; Sat, 24 Nov 2012 14:55:50 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id qAOJtnGI011946; Sat, 24 Nov 2012 14:55:49 -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 qAOJtl60028270 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 24 Nov 2012 14:55:49 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id qAOJtluL011948; Sat, 24 Nov 2012 14:55:47 -0500 (EST) Date: Sat, 24 Nov 2012 14:55:47 -0500 (EST) From: Benjamin Kaduk To: Glen Barber Subject: Re: Request for Review: pkgng documentation for the Handbook In-Reply-To: <20121124172712.GB1470@glenbarber.us> Message-ID: References: <20121116165810.GC1335@glenbarber.us> <20121123173758.GA1282@glenbarber.us> <20121124172712.GB1470@glenbarber.us> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrBIsWRmVeSWpSXmKPExsUixCmqreumtjHAYNlTZotTZ7pYLfY3H2Bz YPKY8Wk+SwBjFJdNSmpOZllqkb5dAlfG7xvf2Av28lXc7N/O1MC4iLuLkZNDQsBE4sHx3awQ tpjEhXvr2boYuTiEBPYxSsx5/J4ZwtnAKNF2cCk7hHOCSWLBl0NMIC1CAg1AZfPTQWwWAW2J f1deg41iE1CRmPlmIxuILSKgKLFs7TN2EJtZQFqiYf1msF5hAVeJF4tnAG3g4OAUMJK4eiQe JMwr4CBx5eglRohdmxgl1m5sYQRJiAroSKzeP4UFokhQ4uTMJywQMy0lzv25zjaBUXAWktQs JKkFjEyrGGVTcqt0cxMzc4pTk3WLkxPz8lKLdI31cjNL9FJTSjcxggNUkm8H49eDSocYBTgY lXh4E86sDxBiTSwrrsw9xCjJwaQkyiugujFAiC8pP6UyI7E4I76oNCe1+BCjBAezkgivNUiO NyWxsiq1KB8mJc3BoiTOeyXlpr+QQHpiSWp2ampBahFMVoaDQ0mC1xukUbAoNT21Ii0zpwQh zcTBCTKcB2i4C9jw4oLE3OLMdIj8KUZFKXHeEJCEAEgiozQPrheWQF4xigO9IszrBVLFA0w+ cN2vgAYzAQ1+OnsdyOCSRISUVAPj3B2mB7tdpiysu2GivHdnQ+n3joLrrtWPu6zLHNrPH/nv aZSVmqu7ZPYLbduXJ1evuna5J37llhq3lXbtnCF5t90fT9Urzd9c3D3LcJf/3pK/klOVbQuM /0RkehTeDOJ7IHWj1FE+XLWkqqz0SXdNrGZdxtY5TrzLOxk7tXZw35nKExu79YcSS3FGoqEW c1FxIgCYETxo+wIAAA== 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 19:55:57 -0000 On Sat, 24 Nov 2012, Glen Barber wrote: > On Fri, Nov 23, 2012 at 11:52:37PM -0500, Benjamin Kaduk wrote: >> On Fri, 23 Nov 2012, Glen Barber wrote: > >> % 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. >> > > Yes, that is on my todo list for the next set of changes. I want to get > this into the Handbook though, so people have some documentation on how > things work. Fixing things "by hand" with pkgng is a bit tricky, and > can have a number of edge cases, so it will be a large-ish addition. Ah, having not had to deal with it myself, I didn't realize the potential for complications. Definitely best to leave it out of this round, then. >> % Unlike the > % role="package">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. >> > > I'll switch this to tags then. The other alternative would be > to use  , but that's... ugly. I don't think   would help the issue I saw, as the line break was mid-word (the "word" being "-o"). -Ben