aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/man.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-06-22 13:09:17 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-06-22 13:09:17 +0000
commit369129e10cecda27554b9987d819367bcfcf3353 (patch)
tree1d9055d8a6102e9072cd7bb27103aea9b53689b5 /man.7
parent47256364f90726421cafc28ec2f147ee98c59f94 (diff)
downloadmandoc-369129e10cecda27554b9987d819367bcfcf3353.tar.gz
mandoc-369129e10cecda27554b9987d819367bcfcf3353.tar.zst
mandoc-369129e10cecda27554b9987d819367bcfcf3353.zip
libman documents require `TH' and at least one node.
libman requirements documented in man.7 STRUCTURE section. Added STRUCTURE section to mdoc.7, too.
Diffstat (limited to 'man.7')
-rw-r--r--man.721
1 files changed, 17 insertions, 4 deletions
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 <kristaps@kth.se>
.\"
@@ -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