os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Remove references to RC_SUBR and RC_SUBR_SUFFIX, as of bsd.port.mk

Browse source 
version 1.636 they are no longer relevant.

Clarify the text about when USE_RCORDER may be necessary.

Consistently use <filename>rc.d</filename> scripts
This commit is contained in:
Doug Barton 2010-04-16 20:50:10 +00:00
parent 5e384ff153
commit a1746cd22a
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=35657
1 changed files with 7 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

20
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -8418,17 +8418,14 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR}"
<ulink url="&url.articles.rc-scripting">an article</ulink>
on practical aspects of <filename>rc.d</filename> scripting.</para>
<para>One or more rc scripts can be installed:</para>
<para>One or more <filename>rc.d</filename> scripts can be installed:</para>
<programlisting>USE_RC_SUBR= doormand</programlisting>
<para>Scripts must be placed in the <filename>files</filename>
subdirectory and a <literal>.in</literal> suffix must be added to their
filename. The only difference from a base system <filename>rc.d</filename> script is that the
<literal>.&nbsp;/etc/rc.subr</literal> line must be replaced with the
<literal>.&nbsp;%%RC_SUBR%%</literal>, because older versions of &os;
do not have an <filename>/etc/rc.subr</filename> file. Standard
<makevar>SUB_LIST</makevar> expansions are used too.
filename. Standard <makevar>SUB_LIST</makevar> expansions will be used
for this file.
Use of the <literal>%%PREFIX%%</literal> and
<literal>%%LOCALBASE%%</literal> expansions is strongly encouraged as well.
More on
@ -8438,7 +8435,10 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR}"
<para>Prior to &os;&nbsp;6.1-RELEASE, integration with &man.rcorder.8; is available by using
<makevar>USE_RCORDER</makevar> instead of
<makevar>USE_RC_SUBR</makevar>.
However, use of this method is deprecated.</para>
However, use of this method is not necessary unless the port has an
option to install itself in the base, or the service needs to run
prior to the <filename>FILESYSTEMS</filename> <filename>rc.d</filename>
script in the base.</para>
<para>As of &os;&nbsp;6.1-RELEASE, local <filename>rc.d</filename>
scripts (including those installed by ports) are included in
@ -8501,12 +8501,6 @@ run_rc_command "$1"</programlisting>
substitution using &quot;:=&quot; would inappropriately
override the user's intention.</para>
<para>The suffix of the rc script is provided in
<makevar>RC_SUBR_SUFFIX</makevar> for further use in the port's
<filename>Makefile</filename>. Current versions of &os; do not add
any suffix to the script name, but older versions used to add
<filename>.sh</filename> suffix.</para>
<note>
<para>No new scripts should be added with the <filename>.sh</filename>
suffix. At some point there will be a mass repocopy of all the