From owner-svn-doc-head@FreeBSD.ORG Wed Oct 9 13:40:49 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id DEE2173E; Wed, 9 Oct 2013 13:40:49 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (dmz-mailsec-scanner-4.mit.edu [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 47B952746; Wed, 9 Oct 2013 13:40:48 +0000 (UTC) X-AuditID: 1209190f-b7fa08e0000009c6-9b-52555cdf5c88 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 51.1C.02502.FDC55525; Wed, 9 Oct 2013 09:40:47 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r99Dek1n001068; Wed, 9 Oct 2013 09:40:47 -0400 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.8/8.12.4) with ESMTP id r99DeihB006657 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 9 Oct 2013 09:40:45 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r99DehAR013847; Wed, 9 Oct 2013 09:40:43 -0400 (EDT) Date: Wed, 9 Oct 2013 09:40:43 -0400 (EDT) From: Benjamin Kaduk To: Dru Lavigne Subject: Re: svn commit: r42903 - head/en_US.ISO8859-1/books/handbook/ports In-Reply-To: <201310081948.r98JmS9b025117@svn.freebsd.org> Message-ID: References: <201310081948.r98JmS9b025117@svn.freebsd.org> 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+NgFnrPIsWRmVeSWpSXmKPExsUixCmqrXs/JjTI4MI5JYsfHw8xWXQ1qVrc WLSfyWJ3fy+zA4vHjE/zWQIYo7hsUlJzMstSi/TtErgyrv3+zlJwXqbi5uJdzA2MXeJdjJwc EgImEhu3rWOBsMUkLtxbz9bFyMUhJLCPUWLVqfVgCSGBDYwS65/kQyQOMknMv9cFlaiXWPdw GpjNIqAlsWT5XTYQm01ARWLmm41gtoiAosTTr3sZQWxmgSiJPUsbWbsYOTiEBbwlfh0Ca+UU sJJ4eHUHWDmvgKPE+8v/2SHGW0r8eHcULC4qoCOxev8UFogaQYmTM5+wQIy0lDj35zrbBEbB WUhSs5CkFjAyrWKUTcmt0s1NzMwpTk3WLU5OzMtLLdI10cvNLNFLTSndxAgOV0n+HYzfDiod YhTgYFTi4e3gDQkSYk0sK67MPcQoycGkJMorERkaJMSXlJ9SmZFYnBFfVJqTWnyIUYKDWUmE 1zgaKMebklhZlVqUD5OS5mBREue9yWEfJCSQnliSmp2aWpBaBJOV4eBQkuA9DtIoWJSanlqR lplTgpBm4uAEGc4DNHw12PDigsTc4sx0iPwpRkUpcd6jIAkBkERGaR5cLyydvGIUB3pFmPcq SBUPMBXBdb8CGswENHj79xCQwSWJCCmpBkb73RIHHv2a1uy3Sbpt43qrPYs2Ht99r2uGttXF 1FUii3NnzJ+/5yFX3D+WeVsYtigtFg61m+Yn0myRvKst7Vl46bqgnts3Iwy0O9dvTzu3YNsa /5yJtlPPZddIHo5dWW0Z+ETbiuNNxvPVU/eVF6/YrlRSLKlw2FWjcOc+qdVvF4Wt59qRt2aD EktxRqKhFnNRcSIAnDcd/QIDAAA= Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Oct 2013 13:40:50 -0000 On Tue, 8 Oct 2013, Dru Lavigne wrote: > Author: dru > Date: Tue Oct 8 19:48:28 2013 > New Revision: 42903 > URL: http://svnweb.freebsd.org/changeset/doc/42903 > > Log: > This patch does the following to the first half of 5.6. Using the Ports Collection: > - as per discussion with portmgr, removes csup warnings and how-tos > - as per discussion on IRC, remove Method 3 as sysinstall is being phased out > - adds some text and word-smithing to make unclear instructions a bit clearer > - some tag cleanup > - updated lsof listing > - some text shuffling to improve flow > > Approved by: bcr (mentor) > > Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Tue Oct 8 17:39:20 2013 (r42902) > +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Tue Oct 8 19:48:28 2013 (r42903) > - > - Using only > - make install > - means there will potentially be many > - waiting periods between user interaction as the default > - behaviour is to prompt the user for options. To avoid this > - when there are many dependencies, first run make > + Some ports provide build options which can be used to > + enable or disable application components, > + provide security options, or allow for other customizations. > + Examples include > + www/firefox, > + security/gpgme, and > + mail/sylpheed-claws. > + If the port has configurable options, it may pause > + several times for > + user interaction as the default > + behavior is to prompt the user to select options from a menu. The "pause several times" behavior is a result of dependencies of the port being installed having confugrable options (perhaps in addition to the port itself). I guess I would say: "If the port depends on other ports which have configurable options, it may pause [...]" > + To avoid this, > + run make > config-recursive to do [...] > - For users which cannot be connected all the time, the > - make fetch option > - is provided. Run this command within > - /usr/ports and the required files will > - be downloaded. This command also works in the > - lower level categories, such as > - /usr/ports/net. Note that if a port > - depends on libraries or other ports, this will > + For users who cannot be connected to the Internet all the time, > + make fetch can be run > + within > + /usr/ports, to fetch all distfiles, or within > + a category, such as > + /usr/ports/net, or within the > + specific port skeleton. Note that if a port has any dependencies, > + running this command in a category or ports skeleton will > not fetch the distfiles of ports > - from another category. Use > + from another category. Instead, use > make > fetch-recursive > - to fetch I think it is worth specifying that fetch-recursive be run within a port skeleton, and not in a category. -Ben > + to also fetch the distfiles for > all the dependencies of a port. >