From owner-freebsd-doc  Fri Feb 21 20:23:13 2003
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 E2BDE37B401; Fri, 21 Feb 2003 20:23:11 -0800 (PST)
Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 88E4643FBF; Fri, 21 Feb 2003 20:23:10 -0800 (PST)
	(envelope-from keramida@freebsd.org)
Received: from gothmog.gr (patr530-b178.otenet.gr [212.205.244.186])
	by mailsrv.otenet.gr (8.12.6/8.12.6) with ESMTP id h1M4N72O023595;
	Sat, 22 Feb 2003 06:23:08 +0200 (EET)
Received: from gothmog.gr (gothmog [127.0.0.1])
	by gothmog.gr (8.12.7/8.12.7) with ESMTP id h1M4MeCZ001642;
	Sat, 22 Feb 2003 06:22:40 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Received: (from giorgos@localhost)
	by gothmog.gr (8.12.7/8.12.7/Submit) id h1M4MeIR001641;
	Sat, 22 Feb 2003 06:22:40 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Date: Sat, 22 Feb 2003 06:22:40 +0200
From: Giorgos Keramidas <keramida@freebsd.org>
To: Tom Rhodes <trhodes@freebsd.org>
Cc: freebsd-doc@freebsd.org
Subject: Re: docs/48482: using deprecated sysctl option in FAQ
Message-ID: <20030222042240.GB1301@gothmog.gr>
References: <200302220150.h1M1o9lE046749@freefall.freebsd.org> <20030221205521.2b41519d.trhodes@FreeBSD.org> <20030222031230.GA28308@gothmog.gr> <20030221222604.3dfae305.trhodes@FreeBSD.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030221222604.3dfae305.trhodes@FreeBSD.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

On 2003-02-21 22:26, Tom Rhodes <trhodes@FreeBSD.org> wrote:
> Giorgos Keramidas <keramida@FreeBSD.org> wrote:
> > +	  <note>
> > +	    <para>The <option>-w</option> option of &man.sysctl.8; is
> > +	      deprecated and silently ignored in &os; 4.4-RELEASE and all
> > +	      newer versions.  You can safely ommit it when setting options
> > +	      with <command>sysctl</command> as shown above.</para>
> > +	  </note>
>
> This looks good here, but I want to ask a quick question on note.
> All the times I add a <note> tag, I follow it with the <para> tag,
> is this correct, incorrect, not matter?  I would really like to
> follow a `style' and just have not noticed a pattern as of yet.

I prefer writing them on separate lines, to let future versions of the
document minimise diffs.  Thus, when a new para is added, the diff
won't include stuff like:

	-	<note><para>old stuff
	+	<note><para>new stuff...
	+	  <para>old stuff...

but, something like:

		<note>
	+	  <para>new stuff...
		  <para>old stuff...

But, this is just my personal preference.  Not some truly important
style rule that I'd try hard to force upon others :)


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