From owner-freebsd-current@FreeBSD.ORG  Mon Dec 11 23:32:09 2006
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
X-Original-To: current@freebsd.org
Delivered-To: freebsd-current@FreeBSD.ORG
Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 0CAE216A49E
	for <current@freebsd.org>; Mon, 11 Dec 2006 23:32:09 +0000 (UTC)
	(envelope-from marius@alchemy.franken.de)
Received: from alchemy.franken.de (alchemy.franken.de [194.94.249.214])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0F2BE43CEB
	for <current@freebsd.org>; Mon, 11 Dec 2006 23:27:22 +0000 (GMT)
	(envelope-from marius@alchemy.franken.de)
Received: from alchemy.franken.de (localhost [127.0.0.1])
	by alchemy.franken.de (8.13.8/8.13.8/ALCHEMY.FRANKEN.DE) with ESMTP id
	kBBNSK6V067121; Tue, 12 Dec 2006 00:28:20 +0100 (CET)
	(envelope-from marius@alchemy.franken.de)
Received: (from marius@localhost)
	by alchemy.franken.de (8.13.8/8.13.8/Submit) id kBBNSKRX067120;
	Tue, 12 Dec 2006 00:28:20 +0100 (CET) (envelope-from marius)
Date: Tue, 12 Dec 2006 00:28:20 +0100
From: Marius Strobl <marius@alchemy.franken.de>
To: Nick Hibma <nick@van-laarhoven.org>
Message-ID: <20061211232820.GI86517@alchemy.franken.de>
References: <20061210110419.H42195@localhost>
	<20061210152755.GA45265@alchemy.franken.de>
	<20061210223217.M1174@localhost>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20061210223217.M1174@localhost>
User-Agent: Mutt/1.4.2.2i
Cc: FreeBSD CURRENT Mailing List <current@freebsd.org>
Subject: Re: Slight interface change on the watchdog fido
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 11 Dec 2006 23:32:09 -0000

On Sun, Dec 10, 2006 at 10:36:17PM +0100, Nick Hibma wrote:
> 
> >Regarding your changes to watchdog.4 and watchdog.9 AFAICT
> >they violate the established style guidelines for FreeBSD
> >man pages; the source should wrap the line on sentence breaks.
> 
> Is there a manual for man page writing? I've not done much of that yet.

I've learnt the FreeBSD man page Do's and Don'ts I'm aware
of by gleaning at commits doc people do and at what they
change/suggest when asking them to fix/review a man page.
AFAICT "rules" like the one mentioned above aren't
documented anywhere but I could be wrong and all of this
actually is burried in mdoc(7) somewhere, I just haven't
found it, yet :)

Marius