[BACK]Return to roff.7 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/roff.7 between version 1.110 and 1.117

version 1.110, 2018/12/16 01:34:56 version 1.117, 2022/05/20 13:09:13
Line 1 
Line 1 
 .\"     $Id$  .\" $Id$
 .\"  .\"
   .\" Copyright (c) 2010-2019, 2022 Ingo Schwarze <schwarze@openbsd.org>
 .\" 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>  
 .\"  .\"
 .\" 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
Line 315  delimiters
Line 315  delimiters
 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.
Line 2138  Break the output line at the end of the current word.
Line 2166  Break the output line at the end of the current word.
 Set number register; ignored by  Set number register; ignored by
 .Xr mandoc 1 .  .Xr mandoc 1 .
 .It Ic \er  .It Ic \er
 Move up by one line; ignored by  Reverse line feed: move up by one output line.
 .Xr mandoc 1 .  Currently unsupported.
 .It Ic \eS\(aq Ns Ar number Ns Ic \(aq  .It Ic \eS\(aq Ns Ar number Ns Ic \(aq
 Slant output; ignored by  Slant output; ignored by
 .Xr mandoc 1 .  .Xr mandoc 1 .
Line 2256  code.
Line 2284  code.
 .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
Line 2303  for
Line 2331  for
 .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
Legend:
Removed from v.1.110  
changed lines
  Added in v.1.117
CVSweb