version 1.68, 2015/01/23 20:18:40 |
version 1.69, 2015/01/29 00:33:57 |
Line 2028 approximated in |
|
Line 2028 approximated in |
|
.Xr mandoc 1 |
.Xr mandoc 1 |
by simply skipping the next character. |
by simply skipping the next character. |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section documents compatibility between mandoc and other |
The |
|
.Xr mandoc 1 |
|
implementation of the |
.Nm |
.Nm |
implementations, at this time limited to GNU troff |
language is intentionally incomplete. |
.Pq Qq groff . |
Unimplemented features include: |
The term |
|
.Qq historic groff |
|
refers to groff version 1.15. |
|
.Pp |
.Pp |
.Bl -dash -compact |
.Bl -dash -compact |
.It |
.It |
|
For security reasons, |
|
.Xr mandoc 1 |
|
never reads or writes external files except via |
|
.Sx \&so |
|
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. |
|
.It |
|
Support for setting tabulator positions |
|
and tabulator and leader characters is missing, |
|
and support for manually changing indentation is limited. |
|
.It |
The |
The |
.Sq u |
.Sq u |
scaling unit is the default terminal unit. |
scaling unit is the default terminal unit. |
In traditional troff systems, this unit would change depending on the |
In traditional troff systems, this unit changes depending on the |
output media. |
output media. |
.It |
.It |
In mandoc, the |
Width measurements are implemented in a crude way |
.Sx \&EQ , |
and often yield wrong results. |
.Sx \&TE , |
Explicit movement requests and escapes are ignored. |
.Sx \&TS , |
|
and |
|
.Sx \&T& , |
|
macros are considered regular macros. |
|
In all other |
|
.Nm |
|
implementations, these are special macros that must be specified without |
|
spacing between the control character (which must be a period) and the |
|
macro name. |
|
.It |
.It |
The |
There is no concept of output pages, no support for floats, |
.Cm nS |
graphics drawing, and picture inclusion; |
register is only compatible with OpenBSD's groff-1.15. |
terminal output is always continuous. |
.It |
.It |
Historic groff did not accept white-space before a custom |
Requests regarding color, font families, and glyph manipulation |
.Ar end |
are ignored. |
macro for the |
Font support is very limited. |
.Sx \&ig |
Kerning is not implemented, and no ligatures are produced. |
request. |
|
.It |
.It |
The |
The |
.Sx \&if |
.Qq \(aq |
and family would print funny white-spaces with historic groff when |
macro control character does not suppress output line breaks. |
using the next-line syntax. |
.It |
|
Diversions are not implemented, |
|
and support for traps is very incomplete. |
|
.It |
|
While recursion is supported, |
|
.Sx \&while |
|
loops are not. |
.El |
.El |
|
.Pp |
|
The special semantics of the |
|
.Cm nS |
|
number register is an idiosyncracy of |
|
.Ox |
|
manuals and not supported by other |
|
.Xr mdoc 7 |
|
implementations. |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr mandoc 1 , |
.Xr mandoc 1 , |
.Xr eqn 7 , |
.Xr eqn 7 , |