Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 18 Jul 2000 16:58:59 +0200
From:      Sheldon Hearn <sheldonh@uunet.co.za>
To:        Ben Smithurst <ben@FreeBSD.org>
Cc:        freebsd-doc@FreeBSD.org
Subject:   Re: rc.d and rc.local 
Message-ID:  <51369.963932339@axl.ops.uunet.co.za>
In-Reply-To: Your message of "Tue, 18 Jul 2000 15:29:37 %2B0100." <20000718152937.U4668@strontium.scientia.demon.co.uk> 

next in thread | previous in thread | raw e-mail | index | archive | help


On Tue, 18 Jul 2000 15:29:37 +0100, Ben Smithurst wrote:

> Hmm, I've thought about it again, and I agree with you now about putting
> it in the same page.  I'll make my mind up soon, honest. :-)

I do that more and more all the time.  I like to think it's one of the
problems associated with keeping an open mind. ;-)

I like this patch. :-)

> +.It
> +Scripts are only executed if their filename matches
> +.Pa *.sh ,
> +and they have the execute bit set.

Two suggested changes:

.It
Scripts are only executed
if their
.Xr basename 1
matches the shell globbing pattern
.Pa *.sh ,
and they are executable.

I prefer "they are executable" because "they have the execute bit set"
begs the question "which execute bit?".

> +.Pq either boot time or shutdown time

This is one of the situations that Garrett was talking about.  Just use
normal parens:

(either boot time or shutdown time)

> +The output from each script is traditionally a space character,
> +followed by the name of the software package being started or shutdown,

The misspelling of "shut down" is excusable in most of the file, but not
here. :-)

> +The default locations are
> +.Pa /usr/local/etc/rc.d
> +and
> +.Pa /usr/X11R6/etc/rc.d ,
> +but the administrator may specify different directories by setting the
> +.Dq local_startup
> +option of
> +.Xr rc.conf 5 .

I'd prefer this

...
but these may be overridden with the
.Va local_startup
.Xr rc.conf 5
variable.

I prefer to mark up local_startup as a variable, since it _is_ a shell
variable.  Also, I don't like to talk about the administrator when
there's a graceful alternative, but that's just my preference.

What _is_ significant about my alternative is that it makes more clear
the fact that local_startup overrides these defaults, rather than adding
to them.

> +This option's value should be a list of directories to check for
> +.Nm rc.d
> +scripts.

My preference would be to leave this out, but there's no solid argument
for that.

> +.Sh EXAMPLES
> +The following is a simple, fictitious example of an

You might want to consider the word "hypothetical" instead of
"fictitious" here.

Ciao,
Sheldon.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?51369.963932339>