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

Mathieu Arnold mat at
Tue Mar 18 15:31:36 UTC 2014

Author: mat (ports committer)
Date: Tue Mar 18 15:31:36 2014
New Revision: 44278

  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
--- 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>
@@ -3449,6 +3454,11 @@ OPT6_DESC=	Describe OPT6</programlisting
+	<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
@@ -3637,11 +3647,6 @@ CONFIGURE_ARGS+=	--enable-foo
 FOO_CONFIGURE_ENABLE=	foo</programlisting>
-      <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>
 	<para>Under some circumstances, the shorthand conditional
 	  syntax can cause problems with complex constructs.  If you

More information about the svn-doc-all mailing list