update document

[Doug Barton]

Ceri Davies wrote:
> On 15/3/06 19:15, "Alfred Morgan" <alfred.morgan at experclick.com> wrote:
> 
>> In this document:
>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.h
>> tml
>>
>> Can we change:
>>
>> rcvar=${name}_enable
>>
>> to be :
>>
>> rcvar=`set_rcvar`
>>
>> so that it would be a good example how to be other OS (OpenBSD)
>> compatible as well.

The set_rcvar function simply returns ${name}_enable, so setting that value
explicitly in the example removes a layer of indirection, and helps make it
more clear what's happening there, which makes it a better example.

There are occasionally good reasons for making $rcvar something other than
${name}_enable, however that's considered more of an "expert" knob, and the
reasons for doing so are beyond the scope of that particular document.

hth,

Doug

-- 

    This .signature sanitized for your protection