diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2018-10-04 15:32:09 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2018-10-04 15:32:09 +0000 |
commit | 3cf17a318429a45c12b19ab051cb0d67a9c15989 (patch) | |
tree | e88f2421f70c083cdf50569f13ff26b941e843e7 /roff.7 | |
parent | 095ae930b54a7cb713605313744f495b8d3cf826 (diff) | |
download | mandoc-3cf17a318429a45c12b19ab051cb0d67a9c15989.tar.gz |
update DESCRIPTION and COMPATIBILITY, mostly correcting statements
from the past that are no longer true
Diffstat (limited to 'roff.7')
-rw-r--r-- | roff.7 | 35 |
1 files changed, 17 insertions, 18 deletions
@@ -39,17 +39,14 @@ or code. To properly format such manuals, the .Xr mandoc 1 -utility supports a tiny subset of +utility supports a subset of .Nm requests and escapes. -Only these requests and escapes supported by +Even though this manual page lists all +.Nm +requests, it only has partial information about requests not supported by .Xr mandoc 1 -are documented in the present manual, -together with the basic language syntax shared by -.Nm , -.Xr mdoc 7 , -and -.Xr man 7 . +and about language features that do not matter for manual pages. For complete .Nm manuals, consult the @@ -193,7 +190,6 @@ Many requests and macros support scaled widths for their arguments. The syntax for a scaled width is .Sq Li [+-]?[0-9]*.[0-9]*[:unit:] , where a decimal must be preceded or followed by at least one digit. -Negative numbers, while accepted, are truncated to zero. .Pp The following scaling units are accepted: .Pp @@ -2123,8 +2119,8 @@ The .Xr mandoc 1 implementation of the .Nm -language is intentionally incomplete. -Unimplemented features include: +language is incomplete. +Major unimplemented features include: .Pp .Bl -dash -compact .It @@ -2135,10 +2131,9 @@ never reads or writes external files except via requests with safe relative paths. .It There is no automatic hyphenation, no adjustment to the right margin, -and no centering; the output is always set flush-left. +and very limited support for centering; the output is always set flush-left. .It -Support for setting tabulator positions -and tabulator and leader characters is missing, +Support for setting tabulator and leader characters is missing, and support for manually changing indentation is limited. .It The @@ -2149,14 +2144,14 @@ output media. .It Width measurements are implemented in a crude way and often yield wrong results. -Explicit movement requests and escapes are ignored. +Support for explicit movement requests and escapes is limited. .It There is no concept of output pages, no support for floats, graphics drawing, and picture inclusion; terminal output is always continuous. .It -Requests regarding color, font families, and glyph manipulation -are ignored. +Requests regarding color, font families, font sizes, +and glyph manipulation are ignored. Font support is very limited. Kerning is not implemented, and no ligatures are produced. .It @@ -2164,8 +2159,12 @@ The .Qq \(aq macro control character does not suppress output line breaks. .It -Diversions are not implemented, +Diversions and environments are not implemented, and support for traps is very incomplete. +.It +Use of macros is not supported inside +.Xr tbl 7 +code. .El .Pp The special semantics of the |