version 1.110, 2018/12/16 01:34:56 |
version 1.116, 2021/09/18 12:23:06 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2010-2018 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2010-2019 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
The proper spacing is also intelligently preserved if a sentence ends at |
The proper spacing is also intelligently preserved if a sentence ends at |
the boundary of a macro line. |
the boundary of a macro line. |
.Pp |
.Pp |
|
If an input line happens to end with a period, exclamation or question |
|
mark that isn't the end of a sentence, append a zero-width space |
|
.Pq Sq \e& . |
|
.Pp |
Examples: |
Examples: |
.Bd -literal -offset indent -compact |
.Bd -literal -offset indent -compact |
Do not end sentences mid-line like this. Instead, |
Do not end sentences mid-line like this. Instead, |
end a sentence like this. |
end a sentence like this. |
A macro would end like this: |
A macro would end like this: |
\&.Xr mandoc 1 \&. |
\&.Xr mandoc 1 \&. |
|
An abbreviation at the end of an input line needs escaping, e.g.\e& |
|
like this. |
.Ed |
.Ed |
.Sh REQUEST SYNTAX |
.Sh REQUEST SYNTAX |
A request or macro line consists of: |
A request or macro line consists of: |
Line 503 This is a Heirloom extension and currently unsupported |
|
Line 509 This is a Heirloom extension and currently unsupported |
|
.It Ic \&br |
.It Ic \&br |
Break the output line. |
Break the output line. |
.It Ic \&break |
.It Ic \&break |
Break out of a |
Break out of the innermost |
.Ic \&while |
.Ic \&while |
loop. |
loop. |
Currently unsupported. |
|
.It Ic \&breakchar Ar char ... |
.It Ic \&breakchar Ar char ... |
Optional line break characters. |
Optional line break characters. |
This is a Heirloom extension and currently ignored. |
This is a Heirloom extension and currently ignored. |
Line 619 Its syntax can be either |
|
Line 624 Its syntax can be either |
|
.Pp |
.Pp |
or |
or |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
.Pf . Ic \&de Ar macroname Ar endmacro |
.Pf . Ic \&de Ar macroname endmacro |
.Ar definition |
.Ar definition |
.Pf . Ar endmacro |
.Pf . Ar endmacro |
.Ed |
.Ed |
Line 908 This is a Heirloom extension and currently ignored. |
|
Line 913 This is a Heirloom extension and currently ignored. |
|
Enable or disable an OpenType feature. |
Enable or disable an OpenType feature. |
This is a Heirloom extension and currently ignored. |
This is a Heirloom extension and currently ignored. |
.It Ic \&fi |
.It Ic \&fi |
Switch to fill mode. |
Break the output line and switch to fill mode, |
See |
which is active by default but can be ended with the |
.Xr man 7 . |
.Ic \&nf |
Ignored in |
request. |
.Xr mdoc 7 . |
In fill mode, input from subsequent input lines is added to |
|
the same output line until the next word no longer fits, |
|
at which point the output line is broken. |
|
This request is implied by the |
|
.Xr mdoc 7 |
|
.Ic \&Sh |
|
macro and by the |
|
.Xr man 7 |
|
.Ic \&SH , |
|
.Ic \&SS , |
|
and |
|
.Ic \&EE |
|
macros. |
.It Ic \&fkern Ar font minkern |
.It Ic \&fkern Ar font minkern |
Control the use of kerning tables for a font. |
Control the use of kerning tables for a font. |
This is a Heirloom extension and currently ignored. |
This is a Heirloom extension and currently ignored. |
Line 1347 Declare the need for the specified minimum vertical sp |
|
Line 1364 Declare the need for the specified minimum vertical sp |
|
before the next trap or the bottom of the page. |
before the next trap or the bottom of the page. |
Currently ignored. |
Currently ignored. |
.It Ic \&nf |
.It Ic \&nf |
Switch to no-fill mode. |
Break the output line and switch to no-fill mode. |
See |
Subsequent input lines are kept together on the same output line |
.Xr man 7 . |
even when exceeding the right margin, |
Ignored by |
and line breaks in subsequent input cause output line breaks. |
.Xr mdoc 7 . |
This request is implied by the |
|
.Xr mdoc 7 |
|
.Ic \&Bd Fl unfilled |
|
and |
|
.Ic \&Bd Fl literal |
|
macros and by the |
|
.Xr man 7 |
|
.Ic \&EX |
|
macro. |
|
The |
|
.Ic \&fi |
|
request switches back to the default fill mode. |
.It Ic \&nh |
.It Ic \&nh |
Turn off automatic hyphenation mode. |
Turn off automatic hyphenation mode. |
Currently ignored. |
Currently ignored. |
|
|
.Pp |
.Pp |
The special semantics of the |
The special semantics of the |
.Cm nS |
.Cm nS |
number register is an idiosyncracy of |
number register is an idiosyncrasy of |
.Ox |
.Ox |
manuals and not supported by other |
manuals and not supported by other |
.Xr mdoc 7 |
.Xr mdoc 7 |
|
|
.At v2 , |
.At v2 , |
then ported nroff to C as troff, which Brian W. Kernighan released with |
then ported nroff to C as troff, which Brian W. Kernighan released with |
.At v7 . |
.At v7 . |
In 1989, James Clarke re-implemented troff in C++, naming it groff. |
In 1989, James Clark re-implemented troff in C++, naming it groff. |
.Sh AUTHORS |
.Sh AUTHORS |
.An -nosplit |
.An -nosplit |
This |
This |