Date: Wed, 9 Oct 2013 09:40:43 -0400 (EDT) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Dru Lavigne <dru@freebsd.org> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r42903 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <alpine.GSO.1.10.1310090935580.16692@multics.mit.edu> In-Reply-To: <201310081948.r98JmS9b025117@svn.freebsd.org> References: <201310081948.r98JmS9b025117@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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) > - <note> > - <para>Using only > - <command>make <maketarget>install</maketarget></command> > - 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 <command>make > + <para>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 > + <filename role="package">www/firefox</filename>, > + <filename role="package">security/gpgme</filename>, and > + <filename role="package">mail/sylpheed-claws</filename>. > + 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 <command>make > <maketarget>config-recursive</maketarget></command> to do [...] > - <para>For users which cannot be connected all the time, the > - <command>make <maketarget>fetch</maketarget></command> option > - is provided. Run this command within > - <filename>/usr/ports</filename> and the required files will > - be downloaded. This command also works in the > - lower level categories, such as > - <filename>/usr/ports/net</filename>. Note that if a port > - depends on libraries or other ports, this will > + <para>For users who cannot be connected to the Internet all the time, > + <command>make <maketarget>fetch</maketarget></command> can be run > + within > + <filename class="directory">/usr/ports</filename>, to fetch all distfiles, or within > + a category, such as > + <filename class="directory">/usr/ports/net</filename>, or within the > + specific port skeleton. Note that if a port has any dependencies, > + running this command in a category or ports skeleton will > <emphasis>not</emphasis> fetch the distfiles of ports > - from another category. Use > + from another category. Instead, use > <command>make > <maketarget>fetch-recursive</maketarget></command> > - 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.</para> >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1310090935580.16692>