version 1.106, 2018/10/04 15:16:23 |
version 1.107, 2018/10/04 15:32:09 |
|
|
code. |
code. |
To properly format such manuals, the |
To properly format such manuals, the |
.Xr mandoc 1 |
.Xr mandoc 1 |
utility supports a tiny subset of |
utility supports a subset of |
.Nm |
.Nm |
requests and escapes. |
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 |
.Xr mandoc 1 |
are documented in the present manual, |
and about language features that do not matter for manual pages. |
together with the basic language syntax shared by |
|
.Nm , |
|
.Xr mdoc 7 , |
|
and |
|
.Xr man 7 . |
|
For complete |
For complete |
.Nm |
.Nm |
manuals, consult the |
manuals, consult the |
Line 193 Many requests and macros support scaled widths for the |
|
Line 190 Many requests and macros support scaled widths for the |
|
The syntax for a scaled width is |
The syntax for a scaled width is |
.Sq Li [+-]?[0-9]*.[0-9]*[:unit:] , |
.Sq Li [+-]?[0-9]*.[0-9]*[:unit:] , |
where a decimal must be preceded or followed by at least one digit. |
where a decimal must be preceded or followed by at least one digit. |
Negative numbers, while accepted, are truncated to zero. |
|
.Pp |
.Pp |
The following scaling units are accepted: |
The following scaling units are accepted: |
.Pp |
.Pp |
|
|
.Xr mandoc 1 |
.Xr mandoc 1 |
implementation of the |
implementation of the |
.Nm |
.Nm |
language is intentionally incomplete. |
language is incomplete. |
Unimplemented features include: |
Major unimplemented features include: |
.Pp |
.Pp |
.Bl -dash -compact |
.Bl -dash -compact |
.It |
.It |
Line 2135 never reads or writes external files except via |
|
Line 2131 never reads or writes external files except via |
|
requests with safe relative paths. |
requests with safe relative paths. |
.It |
.It |
There is no automatic hyphenation, no adjustment to the right margin, |
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 |
.It |
Support for setting tabulator positions |
Support for setting tabulator and leader characters is missing, |
and tabulator and leader characters is missing, |
|
and support for manually changing indentation is limited. |
and support for manually changing indentation is limited. |
.It |
.It |
The |
The |
|
|
.It |
.It |
Width measurements are implemented in a crude way |
Width measurements are implemented in a crude way |
and often yield wrong results. |
and often yield wrong results. |
Explicit movement requests and escapes are ignored. |
Support for explicit movement requests and escapes is limited. |
.It |
.It |
There is no concept of output pages, no support for floats, |
There is no concept of output pages, no support for floats, |
graphics drawing, and picture inclusion; |
graphics drawing, and picture inclusion; |
terminal output is always continuous. |
terminal output is always continuous. |
.It |
.It |
Requests regarding color, font families, and glyph manipulation |
Requests regarding color, font families, font sizes, |
are ignored. |
and glyph manipulation are ignored. |
Font support is very limited. |
Font support is very limited. |
Kerning is not implemented, and no ligatures are produced. |
Kerning is not implemented, and no ligatures are produced. |
.It |
.It |
|
|
.Qq \(aq |
.Qq \(aq |
macro control character does not suppress output line breaks. |
macro control character does not suppress output line breaks. |
.It |
.It |
Diversions are not implemented, |
Diversions and environments are not implemented, |
and support for traps is very incomplete. |
and support for traps is very incomplete. |
|
.It |
|
Use of macros is not supported inside |
|
.Xr tbl 7 |
|
code. |
.El |
.El |
.Pp |
.Pp |
The special semantics of the |
The special semantics of the |