Request for review, rc.d-related updates for handbook

Pav Lucistnik pav at FreeBSD.org
Tue Jan 17 09:02:06 UTC 2006


Doug Barton píše v po 16. 01. 2006 v 18:12 -0800:

> I've gone through the handbook and updated a few areas related to the rc.d
> new world order, and would appreciate review, especially for style, of my
> patch, since it's been a while since I've done anything beyond simple doc work.

> http://people.freebsd.org/~dougb/doc-rc.d.diff

Watch whitespace, you converted leading tab to eight-spaces on one
place.

+	<link linkend="configtuning-rcd">rcd</link> section,
perhaps ">rc.d</link> instead?

Regarding Porter's Handbook patch, what's wrong with opening the text
with "Startup scripts"? It's general text and more clear to reader than
"rc.d scripts". Wtf are "rc.d scripts". Don't use term before you
explain it.

+ <literal>%%X11BASE%%</literal> macros is strongly encouraged as well.
I'm not sure these are really "macros" - they are more expansions or
replacements.

-      <para>Integration with &man.rcorder.8; is available by using
-	<makevar>USE_RCORDER</makevar> instead of
-	<makevar>USE_RC_SUBR</makevar>.
Why you deleted this block? It's still valid for 6.0-R and older - we do
support ports on older -STABLE branches. Put it back and perhaps add
"Prior to &os; 6.1-RELEASE, " ?

+	and the latter sets one if the variable is unset OR null.
If the OR is ment as an emphasis, use docbook markup instead of capital
letters.

-	  value of <makevar>USE_RC_SUBR</makevar> and
-	  <makevar>USE_RCORDER</makevar> are automatically added to
+	  value of <makevar>USE_RC_SUBR</makevar>
+	  are automatically added to the
Again, why this change?

-- 
Pav Lucistnik <pav at oook.cz>
              <pav at FreeBSD.org>

Define universe and tell me three examples.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 187 bytes
Desc: Toto je digit?ln? podepsan? ??st zpr?vy
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20060117/992bbc84/attachment.sig>


More information about the freebsd-doc mailing list