diff options
| author |   Kristaps Dzonsons <kristaps@bsd.lv> | 2009-03-26 23:01:26 +0000 |
|---|---|---|
| committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-03-26 23:01:26 +0000 |
| commit | 9f8dd9d1a39f94e7aed1b9b4a7abe13a5a96b450 (patch) | |
| tree | 4ec7147168f5fa468ac3b18b17eaedc638d4a342 /man.7 | |
| parent | b4fc0a872c9cf484b77664293dcc7afdfdbd2f83 (diff) | |
| download | mandoc-9f8dd9d1a39f94e7aed1b9b4a7abe13a5a96b450.tar.gz mandoc-9f8dd9d1a39f94e7aed1b9b4a7abe13a5a96b450.tar.zst mandoc-9f8dd9d1a39f94e7aed1b9b4a7abe13a5a96b450.zip | |
Clean-ups to documentation.
Diffstat (limited to 'man.7')
| -rw-r--r-- | man.7 | 33 |
1 files changed, 10 insertions, 23 deletions
@@ -1,4 +1,4 @@ -.\" $Id: man.7,v 1.4 2009/03/26 16:23:22 kristaps Exp $ +.\" $Id: man.7,v 1.5 2009/03/26 23:01:26 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@openbsd.org> .\" @@ -53,10 +53,6 @@ prior macros: \&.SH Macro lines change control state. Other lines are interpreted within the current state. .Ed -.\" PARAGRAPH -.Pp -Macros are character sequences whose structural rules are described -later in this document. .\" SECTION .Sh INPUT ENCODING .Nm @@ -64,10 +60,11 @@ documents may contain only graphable 7-bit ASCII characters and the space character .Sq \ . All manuals must have +.Ux .Sq \en line termination. .Pp -Blank lines are acceptable; where found, the output will also assert a +Blank lines are acceptable; where found, the output will assert a vertical space. .Pp The @@ -135,25 +132,15 @@ and .Sq \&.RI . When these macros are invoked without arguments, the subsequent line is considered a continuation of the macro. Thus: -.Bd -literal -offset indent -\&.RI foo -.Ed -.Pp -and -.Bd -literal -offset indent -\&.RI -foo -.Ed -.Pp -are equivalent. If two consecutive lines exhibit the latter behaviour, -an error is raised. Thus, the following is acceptable: .Bd -literal -offset indent \&.RI -\&.I Hello, world. foo .Ed .Pp -The following, however, is not: +is equivalent to +.Sq \&.RI foo . +If two consecutive lines exhibit the latter behaviour, +an error is raised. Thus, the following is not acceptable: .Bd -literal -offset indent \&.RI \&.I @@ -162,13 +149,13 @@ Hello, world. .Pp The .Sq \&.TP -macro has similar behaviour, but does not need an empty argument line in -order to trigger scope. +macro is similar, but does not need an empty argument line to trigger +the behaviour. .\" PARAGRAPH .Sh MACROS This section contains a complete list of all .Nm -macros, arranged alphabetically, with the number of arguments. +macros and corresponding number of arguments. .Pp .Bl -column "MacroX" "Arguments" -compact -offset indent .It Em Macro Ta Em Arguments |