svn commit: r46269 - head/en_US.ISO8859-1/books/porters-handbook/special

[Brad Davis]

Author: brd
Date: Fri Feb 13 16:02:08 2015
New Revision: 46269
URL: https://svnweb.freebsd.org/changeset/doc/46269

Log:
  Sprinkle replaceable tags in the startup script section
  
  Reviewed by:	brueffer bjk

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Feb 13 15:43:42 2015	(r46268)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Feb 13 16:02:08 2015	(r46269)
@@ -4372,7 +4372,7 @@ post-patch:
       <replaceable>doormand</replaceable> daemon.  Add the following
       to the <filename>Makefile</filename>:</para>
 
-    <programlisting>USE_RC_SUBR=	doormand</programlisting>
+    <programlisting>USE_RC_SUBR=	<replaceable>doormand</replaceable></programlisting>
 
     <para>Multiple scripts may be listed and will be installed.
       Scripts must be placed in the <filename>files</filename>
@@ -4397,37 +4397,37 @@ post-patch:
 
 # $FreeBSD$
 #
-# PROVIDE: doormand
+# PROVIDE: <replaceable>doormand</replaceable>
 # REQUIRE: LOGIN
 # KEYWORD: shutdown
 #
 # Add these lines to /etc/rc.conf.local or /etc/rc.conf
 # to enable this service:
 #
-# doormand_enable (bool):	Set to NO by default.
-#				Set it to YES to enable doormand.
-# doormand_config (path):	Set to %%PREFIX%%/etc/doormand/doormand.cf
+# <replaceable>doormand</replaceable>_enable (bool):	Set to NO by default.
+#				Set it to YES to enable <replaceable>doormand</replaceable>.
+# <replaceable>doormand</replaceable>_config (path):	Set to %%PREFIX%%/etc/<replaceable>doormand/doormand.cf</replaceable>
 #				by default.
 
 . /etc/rc.subr
 
-name=doormand
-rcvar=doormand_enable
+name=<replaceable>doormand</replaceable>
+rcvar=<replaceable>doormand</replaceable>_enable
 
 load_rc_config $name
 
-: ${doormand_enable:="NO"}
-: ${doormand_config="%%PREFIX%%/etc/doormand/doormand.cf"}
+: ${<replaceable>doormand</replaceable>_enable:="NO"}
+: ${<replaceable>doormand</replaceable>_config="%%PREFIX%%/etc/<replaceable>doormand/doormand.cf</replaceable>"}
 
 command=%%PREFIX%%/sbin/${name}
 pidfile=/var/run/${name}.pid
 
-command_args="-p $pidfile -f $doormand_config"
+command_args="<replaceable>-p $pidfile -f $doormand_config</replaceable>"
 
 run_rc_command "$1"</programlisting>
 
     <para>Unless there is a good reason to start the service
-      earlier, all ports scripts should use</para>
+      earlier, all ports scripts should use:</para>
 
     <programlisting>REQUIRE: LOGIN</programlisting>
 
@@ -4447,9 +4447,9 @@ run_rc_command "$1"</programlisting>
       ":=" style here, since the former sets a default
       value only if the variable is unset, and the latter sets one
       if the variable is unset <emphasis>or</emphasis> null.  A user
-      might very well include something like</para>
+      might very well include something like:</para>
 
-    <programlisting>doormand_flags=""</programlisting>
+    <programlisting><replaceable>doormand</replaceable>_flags=""</programlisting>
 
     <para>in their <filename>rc.conf.local</filename>, and a
       variable substitution using ":=" would