aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/roff.7
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2018-10-04 15:32:09 +0000
committerIngo Schwarze <schwarze@openbsd.org>2018-10-04 15:32:09 +0000
commit5f5498f2abb44874721f0c7cfa0a0b396eea3c00 (patch)
tree5b1f4c80715cd787f503412eeae24bc62eaf14d3 /roff.7
parent649a6b17a6c72e426575708fa348400568a31bea (diff)
downloadmandoc-5f5498f2abb44874721f0c7cfa0a0b396eea3c00.tar.gz
mandoc-5f5498f2abb44874721f0c7cfa0a0b396eea3c00.tar.zst
mandoc-5f5498f2abb44874721f0c7cfa0a0b396eea3c00.zip
update DESCRIPTION and COMPATIBILITY, mostly correcting statements
from the past that are no longer true
Diffstat (limited to 'roff.7')
-rw-r--r--roff.737
1 files changed, 18 insertions, 19 deletions
diff --git a/roff.7 b/roff.7
index 903f33a3..ad678453 100644
--- a/roff.7
+++ b/roff.7
@@ -1,4 +1,4 @@
-.\" $Id: roff.7,v 1.106 2018/10/04 15:16:23 schwarze Exp $
+.\" $Id: roff.7,v 1.107 2018/10/04 15:32:09 schwarze Exp $
.\"
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
.\" Copyright (c) 2010-2018 Ingo Schwarze <schwarze@openbsd.org>
@@ -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