From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from kerhand.co.uk (_smtpd@82-69-137-214.dsl.in-addr.zen.co.uk [82.69.137.214]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o857xOsx022748 for ; Sun, 5 Sep 2010 03:59:24 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id SoWuUMBD for ; Sun, 5 Sep 2010 08:58:58 +0100 (BST) Date: Sun, 5 Sep 2010 08:58:58 +0059 From: Jason McIntyre To: discuss@mdocml.bsd.lv Subject: Re: Cleanups to mdoc.7 section documentation. Message-ID: <20100905075922.GA28986@bramka.kerhand.co.uk> References: <4C8287F3.4000308@bsd.lv> <20100904211319.GA26112@bramka.kerhand.co.uk> <4C834C17.9000502@bsd.lv> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4C834C17.9000502@bsd.lv> User-Agent: Mutt/1.4.2.3i On Sun, Sep 05, 2010 at 09:51:51AM +0200, Kristaps Dzonsons wrote: > > There are brief examples for both the SYNOPSIS and DESCRIPTION section. > Should these be off-loaded, say, to mdoc.template or something? > i'd say that the examples given in NAME, LIBRARY, SYNOPSIS, and DESCRIPTION are unneccessary and should just be removed. the only bit i would leave is the details within SYNOPSIS about macros getting their own line and so on. jmc -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv