summaryrefslogtreecommitdiffstats
path: root/mdoc.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-10-18 13:58:48 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-10-18 13:58:48 +0000
commitbfb460043e3f0dd1af7b1c54abd537d742393a5d (patch)
treeba8a4583b8467d68ac2ad9a0d876b7a729252a49 /mdoc.7
parent3415d08a3770d6230f784e7a7f2a11e555d18fae (diff)
downloadmandoc-bfb460043e3f0dd1af7b1c54abd537d742393a5d.tar.gz
Fixed typo in Makefile.
Added initial scaling-units section in mdoc.7.
Diffstat (limited to 'mdoc.7')
-rw-r--r--mdoc.761
1 files changed, 61 insertions, 0 deletions
diff --git a/mdoc.7 b/mdoc.7
index 3f8336d1..cb35218e 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -73,6 +73,7 @@ whitespace are stripped from input.
.
.Ss Reserved Characters
Within a macro line, the following characters are reserved:
+.Pp
.Bl -tag -width Ds -offset indent -compact
.It \&.
.Pq period
@@ -208,6 +209,59 @@ considered literal text. Thus, the following produces
.Pp
In free-form mode, quotes are regarded as opaque text.
.
+.Ss Scaling Widths
+Many macros support scaled widths for their arguments, such as
+stipulating a two-inch list indentation with the following:
+.Bd -literal -offset indent
+\&.Bl -tag -width 2i
+.Ed
+.
+.Pp
+The syntax for scaled widths is
+.Sq Li [+-]?[0-9]*.[0-9]*[unit] ,
+where a decimal must be preceded or proceeded by at least one digit.
+Negative numbers, while accepted, are truncated to zero. The following
+scaling units are accepted:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It c
+centimetre
+.It i
+inch
+.It P
+pica (~1/6 inch)
+.It p
+point (~1/72 inch)
+.It f
+synonym for
+.Sq u
+.It v
+default vertical span
+.It m
+width of rendered
+.Sq m
+.Pq em
+character
+.It n
+width of rendered
+.Sq n
+.Pq en
+character
+.It u
+default horizontal span
+.It M
+mini-em (~1/100 em)
+.El
+.Pp
+Using anything other than
+.Sq m ,
+.Sq n ,
+.Sq u ,
+or
+.Sq v
+is necessarily non-portable across output media. See
+.Sx COMPATIBILITY .
+.
.
.Sh MANUAL STRUCTURE
Each
@@ -545,6 +599,13 @@ file re-write
.Pp
.Bl -dash -compact
.It
+Negative scaling units are now truncated to zero instead of creating
+interesting conditions, such as with
+.Sq \&sp -1i .
+Furthermore, the
+.Sq f
+scaling unit, while accepted, is rendered as the default unit.
+.It
The
.Sq \-split
or