From owner-freebsd-doc@FreeBSD.ORG  Mon Mar 20 08:19:14 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.ORG
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 328D916A423
	for <doc@FreeBSD.org>; Mon, 20 Mar 2006 08:19:14 +0000 (UTC)
	(envelope-from dougb@FreeBSD.org)
Received: from mail2.fluidhosting.com (mx21.fluidhosting.com [204.14.89.4])
	by mx1.FreeBSD.org (Postfix) with SMTP id 68EC443D49
	for <doc@FreeBSD.org>; Mon, 20 Mar 2006 08:19:13 +0000 (GMT)
	(envelope-from dougb@FreeBSD.org)
Received: (qmail 20745 invoked by uid 399); 20 Mar 2006 08:19:10 -0000
Received: from localhost (HELO ?192.168.1.100?) (dougb@dougbarton.us@127.0.0.1)
	by localhost with SMTP; 20 Mar 2006 08:19:10 -0000
Message-ID: <441E657C.1040209@FreeBSD.org>
Date: Mon, 20 Mar 2006 00:19:08 -0800
From: Doug Barton <dougb@FreeBSD.org>
Organization: http://www.FreeBSD.org/
User-Agent: Thunderbird 1.5 (Windows/20051201)
MIME-Version: 1.0
To: Ceri Davies <ceri@submonkey.net>
References: <C0435540.ADB4%ceri@submonkey.net>
In-Reply-To: <C0435540.ADB4%ceri@submonkey.net>
X-Enigmail-Version: 0.94.0.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Cc: ports@FreeBSD.org, doc@FreeBSD.org,
	Alfred Morgan <alfred.morgan@experclick.com>
Subject: Re: update document
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 20 Mar 2006 08:19:14 -0000

Ceri Davies wrote:
> On 15/3/06 19:15, "Alfred Morgan" <alfred.morgan@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