From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from acme.spoerlein.net (acme.spoerlein.net [188.72.220.29]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o4B84Mt4024370 for ; Tue, 11 May 2010 02:04:23 -0600 (MDT) Received: from acme.spoerlein.net (localhost.spoerlein.net [IPv6:::1]) by acme.spoerlein.net (8.14.4/8.14.4) with ESMTP id o4BBqYZv084107 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 11 May 2010 13:52:34 +0200 (CEST) (envelope-from uqs@spoerlein.net) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=spoerlein.net; s=dkim200908; t=1273578754; bh=A/hYCLjDaRs7O6gvBlzrlTk/Yz1se8Y7G7Y/3lT/z20=; h=Date:From:To:Subject:Message-ID:MIME-Version:Content-Type; b=l3R02HBKHsl1dwISu3GUu7DMOUAd5b1XYUzh1QFIfkdNioREgXA/YXuRYIHUUIk1S 9CtJrEuyjA2qO7Kv/sbtR7y4TjKeXvOR93URJK8yPA3Ypd+MA52/eT4te6FVL4/avr V2ml6wLtuMuqwKMeeuz/zrXCb08Y2nKtJwi4J74Y= Received: (from uqs@localhost) by acme.spoerlein.net (8.14.4/8.14.4/Submit) id o4BBqXj5084106 for discuss@mdocml.bsd.lv; Tue, 11 May 2010 13:52:33 +0200 (CEST) (envelope-from uqs@spoerlein.net) Date: Tue, 11 May 2010 13:52:33 +0200 From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= To: discuss@mdocml.bsd.lv Subject: mdoc section ordering Message-ID: <20100511115233.GV88504@acme.spoerlein.net> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.20 (2009-06-14) Hi, right now the lint option of mandoc will complain mildly, if the section order of manpages is not in a certain order. This is good. However, while working on the FreeBSD mdoc corpus, I found that FreeBSD and mdocml diverge on where they think the EXIT STATUS section should be placed. FreeBSD: mdocml: .Dd Month day, year .Dd $Mdocdate$ .Os [OPERATING_SYSTEM] .Dt mdoc 7 .Dt DOCUMENT_TITLE .Os .Sh NAME .Sh NAME .Nm name .Nm foo .Nd one line description of name .Nd a description goes here .Sh LIBRARY .Sh LIBRARY .Sh SYNOPSIS .Sh SYNOPSIS .Sh DESCRIPTION .Sh DESCRIPTION .Sh IMPLEMENTATION NOTES .Sh IMPLEMENTATION NOTES .Sh RETURN VALUES .Sh EXIT STATUS .Sh ENVIRONMENT .Sh RETURN VALUES .Sh FILES .Sh ENVIRONMENT .Sh EXIT STATUS .Sh FILES .Sh EXAMPLES .Sh EXAMPLES .Sh DIAGNOSTICS .Sh DIAGNOSTICS .Sh COMPATIBILITY .Sh ERRORS .Sh ERRORS .Sh SEE ALSO .Sh SEE ALSO .Sh STANDARDS .Sh STANDARDS .Sh HISTORY .Sh HISTORY .Sh AUTHORS .Sh AUTHORS .Sh CAVEATS .Sh BUGS .Sh BUGS .Sh SECURITY CONSIDERATIONS It is desirable that we not diverge in this regard and Ruslan's initial motive for putting EXIT STATUS after FILES in FreeBSD has to do with how POSIX is structuring their manpages. So I'd like to get some consensus on where we should put EXIT STATUS and I'd also like a vote on if COMPATIBILITY should be included as a standard section enforced by mdocml. Please discuss! Uli -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv