From 369129e10cecda27554b9987d819367bcfcf3353 Mon Sep 17 00:00:00 2001 From: Kristaps Dzonsons Date: Mon, 22 Jun 2009 13:09:17 +0000 Subject: libman documents require `TH' and at least one node. libman requirements documented in man.7 STRUCTURE section. Added STRUCTURE section to mdoc.7, too. --- man.7 | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'man.7') diff --git a/man.7 b/man.7 index 42ab6e57..5cca8277 100644 --- a/man.7 +++ b/man.7 @@ -1,4 +1,4 @@ -.\" $Id: man.7,v 1.14 2009/06/18 10:32:00 kristaps Exp $ +.\" $Id: man.7,v 1.15 2009/06/22 13:09:17 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: June 18 2009 $ +.Dd $Mdocdate: June 22 2009 $ .Dt MAN 7 .Os .\" SECTION @@ -97,7 +97,7 @@ Characters may alternatively be escaped by a slash-asterisk, .Sq \e* , with the same combinations as described above. This form is deprecated. .\" SECTION -.Sh STRUCTURE +.Sh SYNTAX Macros are one to three three characters in length and begin with a control character , .Sq \&. , @@ -155,7 +155,20 @@ The .Sq \&.TP macro is similar, but does not need an empty argument line to trigger the behaviour. -.\" PARAGRAPH +.\" SECTION +.Sh STRUCTURE +Each +.Nm +document must contain contains at least the +.Sq \&.TH +macro describing the document's section and title. It may occur +anywhere in the document, although conventionally, it appears as the +first macro. +.Pp +Beyond the +.Sq \&.TH , +at least one macro or text node must appear in the document. +.\" SECTION .Sh MACROS This section contains a complete list of all .Nm -- cgit v1.2.3