From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 24 20:13:23 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id 497DD1DB
 for <freebsd-doc@freebsd.org>; Thu, 24 Jan 2013 20:13:23 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 0BC7B227
 for <freebsd-doc@freebsd.org>; Thu, 24 Jan 2013 20:13:22 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.6/8.14.6) with ESMTP id r0OKDLPV084999;
 Thu, 24 Jan 2013 13:13:21 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.6/8.14.6/Submit) with ESMTP id r0OKDLGM084996;
 Thu, 24 Jan 2013 13:13:21 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Thu, 24 Jan 2013 13:13:21 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Eitan Adler <lists@eitanadler.com>
Subject: Re: explicit use of /etc/rc.d vs service
In-Reply-To: <CAF6rxgnCEc_7tO9QzMPuEuMr1cOBXO-_BU8oouG3J-Jv7MkeqQ@mail.gmail.com>
Message-ID: <alpine.BSF.2.00.1301241308520.84905@wonkity.com>
References: <CAF6rxgnJPFevO7W+ypBZdcL7deB+_cQHF0AEcVaWWv8FFhcNcQ@mail.gmail.com>
 <alpine.BSF.2.00.1301240835180.82165@wonkity.com>
 <CAF6rxgnCEc_7tO9QzMPuEuMr1cOBXO-_BU8oouG3J-Jv7MkeqQ@mail.gmail.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; CHARSET=US-ASCII; format=flowed
Content-ID: <alpine.BSF.2.00.1301241308522.84905@wonkity.com>
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
 (wonkity.com [127.0.0.1]); Thu, 24 Jan 2013 13:13:21 -0700 (MST)
Cc: freebsd-doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/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: Thu, 24 Jan 2013 20:13:23 -0000

On Thu, 24 Jan 2013, Eitan Adler wrote:

> On 24 January 2013 10:36, Warren Block <wblock@wonkity.com> wrote:
>> On Wed, 23 Jan 2013, Eitan Adler wrote:
>>
>>> Would anyone object to a patch which converts uses of
>>> "/etc/rc.d/daemon start" to "service daemon start" and the like?
>>> I would like to see service(1) become the standard interface to using
>>> services.
>>
>>
>> Agreed.  service(1) puts things in one place and abstracts them.  Also, it's
>> less typing and easier to autocomplete.

I did not look at this in detail, but would suggest that the unquoted 
rc.conf examples should be quoted as the preferred form:

> --- a/en_US.ISO8859-1/books/handbook/config/chapter.xml
> +++ b/en_US.ISO8859-1/books/handbook/config/chapter.xml
> @@ -679,7 +679,7 @@ HOME=/var/log
...
>     <para>It is easy to check if a service is enabled in
>       <filename>/etc/rc.conf</filename> by running the appropriate
> @@ -720,7 +720,7 @@ HOME=/var/log
>       <command>sshd</command> is in fact enabled in
>       <filename>/etc/rc.conf</filename> by running:</para>
>
> -    <screen>&prompt.root; <userinput>/etc/rc.d/sshd rcvar</userinput>
> +    <screen>&prompt.root; <userinput>service sshd rcvar</userinput>
> # sshd
> $sshd_enable=YES</screen>
>
> @@ -734,7 +734,7 @@ $sshd_enable=YES</screen>
>       <option>status</option> option is available.  For instance to
>       verify that <command>sshd</command> is actually started:</para>

Should be sshd_enable="YES" in both places.