svn commit: r44278 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat (ports committer)
Date: Tue Mar 18 15:31:36 2014
New Revision: 44278
URL: http://svnweb.freebsd.org/changeset/doc/44278

Log:
  Add a note about knobs and options being in all uppercase.
  Remove an obsolete paragraph.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Tue Mar 18 10:02:13 2014	(r44277)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Tue Mar 18 15:31:36 2014	(r44278)
@@ -3374,6 +3374,11 @@ MASTERDIR=	${.CURDIR}/../xdvi300
 	  When a port has a lib-prefix in the
 	  <varname>PORTNAME</varname> the lib-prefix should be
 	  dropped in knob naming.</para>
+
+	<note>
+	  <para>Knob names should be always be in all
+	    uppercase.</para>
+	</note>
       </sect3>
     </sect2>
 
@@ -3449,6 +3454,11 @@ OPT6_DESC=	Describe OPT6</programlisting
 	    helpful.</para>
 	</tip>
 
+	<note>
+	  <para>Option names should always be in all uppercase.  They
+	    should not use mixed case or lowercase.</para>
+	</note>
+
 	<para><varname>OPTIONS</varname> can be grouped as radio
 	  choices, where only one choice from each group is
 	  allowed:</para>
@@ -3637,11 +3647,6 @@ CONFIGURE_ARGS+=	--enable-foo
 FOO_CONFIGURE_ENABLE=	foo</programlisting>
       </example>
 
-      <para>In the second example, the library libfoo is explicitly
-	disabled.  The configure script does not enable related
-	features in the application, despite library's presence in the
-	system.</para>
-
       <note>
 	<para>Under some circumstances, the shorthand conditional
 	  syntax can cause problems with complex constructs.  If you