svn commit: r42903 - head/en_US.ISO8859-1/books/handbook/ports

[Benjamin Kaduk]

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>
>