From owner-freebsd-doc@FreeBSD.ORG Tue Jan 17 09:02:06 2006 Return-Path: X-Original-To: freebsd-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 95D9F16A41F for ; Tue, 17 Jan 2006 09:02:06 +0000 (GMT) (envelope-from pav@FreeBSD.org) Received: from e0-a11.b1.lan.prg.vol.cz (e0-a11.b1.lan.prg.vol.cz [195.122.204.152]) by mx1.FreeBSD.org (Postfix) with ESMTP id ACB5443D49 for ; Tue, 17 Jan 2006 09:02:05 +0000 (GMT) (envelope-from pav@FreeBSD.org) Received: from pav.hide.vol.cz (localhost [127.0.0.1]) by e0-a11.b1.lan.prg.vol.cz (8.13.4/8.13.4) with ESMTP id k0H921jJ054686; Tue, 17 Jan 2006 10:02:01 +0100 (CET) (envelope-from pav@FreeBSD.org) Received: (from pav@localhost) by pav.hide.vol.cz (8.13.4/8.13.4/Submit) id k0H920GK054685; Tue, 17 Jan 2006 10:02:00 +0100 (CET) (envelope-from pav@FreeBSD.org) X-Authentication-Warning: pav.hide.vol.cz: pav set sender to pav@FreeBSD.org using -f From: Pav Lucistnik To: Doug Barton In-Reply-To: <43CC529C.2080800@dougbarton.us> References: <43CC529C.2080800@dougbarton.us> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-s/zHQbrwJ13U+QFpaF7a" Date: Tue, 17 Jan 2006 10:02:00 +0100 Message-Id: <1137488520.38904.18.camel@pav.hide.vol.cz> Mime-Version: 1.0 X-Mailer: Evolution 2.4.2.1 FreeBSD GNOME Team Port Cc: freebsd-doc@FreeBSD.org Subject: Re: Request for review, rc.d-related updates for handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: pav@FreeBSD.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jan 2006 09:02:06 -0000 --=-s/zHQbrwJ13U+QFpaF7a Content-Type: text/plain; charset=ISO8859-2 Content-Transfer-Encoding: quoted-printable Doug Barton p=ED=B9e 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. + rcd section, perhaps ">rc.d 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. + %%X11BASE%% macros is strongly encouraged as well. I'm not sure these are really "macros" - they are more expansions or replacements. - Integration with &man.rcorder.8; is available by using - USE_RCORDER instead of - USE_RC_SUBR. 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 USE_RC_SUBR and - USE_RCORDER are automatically added to + value of USE_RC_SUBR + are automatically added to the Again, why this change? --=20 Pav Lucistnik Define universe and tell me three examples. --=-s/zHQbrwJ13U+QFpaF7a Content-Type: application/pgp-signature; name=signature.asc Content-Description: Toto je =?iso-8859-2?Q?digit=E1ln=EC?= =?ISO-8859-1?Q?_podepsan=E1?= =?iso-8859-2?Q?_=E8=E1st?= =?ISO-8859-1?Q?_zpr=E1vy?= -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQBDzLKHntdYP8FOsoIRAiacAKCyXcQSWv1KJ4sIYFZ1cw4HjN+WKwCgysMU osh27T2bYwJiQAPOu9iV6xQ= =HY7A -----END PGP SIGNATURE----- --=-s/zHQbrwJ13U+QFpaF7a--