Clarify the use of RESTRICTED, NO_CDROM and NO_PACKAGE.

Inspired by PR:	docs/62808
Submitted by:	Chuck Swiger <chuck@pkix.net>
Approved by:	blackend (mentor)

en_US.ISO8859-1/books/porters-handbook/book.sgml

@@ -3432,13 +3432,20 @@ LDCONFIG_DIRS=  %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
 	<para>It is your responsibility as a porter to read the licensing
 	  terms of the software and make sure that the FreeBSD project will
 	  not be held accountable for violating them by redistributing the
-	  source or compiled binaries either via FTP or CDROM. If in doubt,
+	  source or compiled binaries either via FTP/HTTP or CD-ROM.  If in doubt,
 	  please contact the &a.ports;.</para>
       </important>
 
-      <para>In situations like this, the following variables can be set.  In
+      <para>In situations like this, the variables described in the following
-	addition, <filename>ports/LEGAL</filename> should also be
+	sections can be set.</para>
-	updated.</para>
+
+      <note>
+	<para><makevar>RESTRICTED</makevar> implies <makevar>NO_CDROM</makevar>
+	  and <makevar>NO_PACKAGE</makevar>, so it should be set alone.
+	  On the contrary, <makevar>NO_PACKAGE</makevar> and
+	  <makevar>NO_CDROM</makevar> are independent and can be set
+	  simultaneously.</para>
+      </note>
 
       <sect2>
 	<title><makevar>NO_PACKAGE</makevar></title>
@@ -3461,39 +3468,47 @@ LDCONFIG_DIRS=  %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
       <sect2>
 	<title><makevar>NO_CDROM</makevar></title>
 
-	<para>This variable indicates that although we are allowed to generate
+	<para>This variable indicates that, although we are allowed to generate
 	  binary packages, we are not allowed to put those packages, or the
-	  port's <makevar>DISTFILES</makevar>, onto a CDROM (or DVD-ROM)
+	  port's <makevar>DISTFILES</makevar>, onto a CD-ROM (or DVD-ROM)
-	  for resale.  The
+	  for resale.  However, the binary packages and the port's
-	  <makevar>DISTFILES</makevar> will still be available via FTP
+	  <makevar>DISTFILES</makevar> will still be available via
-	  (or HTTP if you set it up that way.)</para>
+	  FTP/HTTP.</para>
 
-	<para><makevar>NO_PACKAGE</makevar> and <makevar>NO_CDROM</makevar>
+	<para><makevar>NO_CDROM</makevar> should be set to a string
-	  can be set simultaneously.</para>
+	  describing the reason why the port cannot be redistributed
+	  on CD-ROM.  For instance, this should be used if the port's license
+	  is for <quote>non-commercial</quote> use only.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>RESTRICTED</makevar></title>
 
-	<para>Set this variable if the application's license also forbids us
+	<para>Set this variable if the application's license forbids us
-	  from mirroring the application's <makevar>DISTFILES</makevar> via
+	  from mirroring the application's <makevar>DISTFILES</makevar> and
-	  FTP (or HTTP if you set it up that way.)</para>
+	  distributing the binary package via FTP/HTTP or CD-ROM.</para>
 
-	<para>Also set this if the application's license has general
+	<para><makevar>RESTRICTED</makevar> should be set to a string
-	  restrictions on who may use it, e.g. the application is for
+	  describing the reason why the port cannot be redistributed.
-	  non-commercial use only.</para>
+	  Typically, this indicates that the port contains proprietary
-
+	  software and that the user will need to manually download the
-	<para>Note that the port committer should add an entry to
+	  <makevar>DISTFILES</makevar>, possibly after registering for the
-	  <filename>/usr/ports/LEGAL</filename> describing exactly
+	  software or agreeing to accept the terms of an
-	  what the restriction entails.</para>
+	  <acronym>EULA</acronym>.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>RESTRICTED_FILES</makevar></title>
 
-	<para>If only some of the distribution files are restricted then set
+	<para>When <makevar>RESTRICTED</makevar> or <makevar>NO_CDROM</makevar>
-	  this variable to list them.  It defaults to <literal>${DISTFILES}
+	  is set, this variable defaults to <literal>${DISTFILES}
-	    ${PATCHFILES}</literal>.</para>
+	  ${PATCHFILES}</literal>, otherwise it is empty.  If only some of the
+	  distribution files are restricted, then set this variable to list
+	  them.</para>
+
+	<para>Note that the port committer should add an entry to
+	  <filename>/usr/ports/LEGAL</filename> for every listed distribution
+	  file, describing exactly what the restriction entails.</para>
       </sect2>
     </sect1>