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

Diff for /mandoc/roff.7 between version 1.98 and 1.103

version 1.98, 2018/08/10 20:40:45 version 1.103, 2018/08/23 14:29:38
Line 86  character, and, in certain circumstances, the tab char
Line 86  character, and, in certain circumstances, the tab char
 The backslash character  The backslash character
 .Sq \e  .Sq \e
 indicates the start of an escape sequence, used for example for  indicates the start of an escape sequence, used for example for
 .Sx Comments ,  .Sx Comments
 .Sx Special Characters ,  
 .Sx Predefined Strings ,  
 and  and
 user-defined strings defined using the  .Sx Special Characters .
 .Sx ds  
 request.  
 For a listing of escape sequences, consult the  For a listing of escape sequences, consult the
 .Sx ESCAPE SEQUENCE REFERENCE  .Sx ESCAPE SEQUENCE REFERENCE
 below.  below.
Line 169  Text decoration is
Line 165  Text decoration is
 recommended for  recommended for
 .Xr mdoc 7 ,  .Xr mdoc 7 ,
 which encourages semantic annotation.  which encourages semantic annotation.
 .Ss Predefined Strings  
 Predefined strings, like  
 .Sx Special Characters ,  
 mark special output glyphs.  
 Predefined strings are escaped with the slash-asterisk,  
 .Sq \e* :  
 single-character  
 .Sq \e*X ,  
 two-character  
 .Sq \e*(XX ,  
 and N-character  
 .Sq \e* Ns Bq N .  
 .Pp  
 Examples:  
 .Bl -tag -width Ds -offset indent -compact  
 .It Li \e*(Am  
 Two-letter ampersand predefined string.  
 .It Li \e*q  
 One-letter double-quote predefined string.  
 .El  
 .Pp  
 Predefined strings are not recommended for use,  
 as they differ across implementations.  
 Those supported by  
 .Xr mandoc 1  
 are listed in  
 .Xr mandoc_char 7 .  
 Manuals using these predefined strings are almost certainly not portable.  
 .Ss Whitespace  .Ss Whitespace
 Whitespace consists of the space character.  Whitespace consists of the space character.
 In text lines, whitespace is preserved within a line.  In text lines, whitespace is preserved within a line.
Line 666  produces
Line 634  produces
 in the input stream, and thus in the output: \fI\^XtFree\^\fP.  in the input stream, and thus in the output: \fI\^XtFree\^\fP.
 Each occurrence of \e\e$* is replaced with all the arguments,  Each occurrence of \e\e$* is replaced with all the arguments,
 joined together with single space characters.  joined together with single space characters.
   The variant \e\e$@ is similar, except that each argument is
   individually quoted.
 .Pp  .Pp
 Since macros and user-defined strings share a common string table,  Since macros and user-defined strings share a common string table,
 defining a macro  defining a macro
Line 1037  is
Line 1007  is
 or  or
 .Sq o  .Sq o
 .Pq odd page ,  .Pq odd page ,
 it evaluates to true.  it evaluates to true, and the
   .Ar body
   starts with the next character.
 .It  .It
 If the first character of  If the first character of
 .Ar condition  .Ar condition
 is  is
 .Sq c  
 .Pq character available ,  
 .Sq e  .Sq e
 .Pq even page ,  .Pq even page ,
 .Sq t  .Sq t
Line 1051  is
Line 1021  is
 or  or
 .Sq v  .Sq v
 .Pq vroff mode ,  .Pq vroff mode ,
 it evaluates to false.  it evaluates to false, and the
   .Ar body
   starts with the next character.
 .It  .It
 If the first character of  If the first character of
 .Ar condition  .Ar condition
 is  is
   .Sq c
   .Pq character available ,
   it evaluates to true if the following character is an ASCII character
   or a valid character escape sequence, or to false otherwise.
   The
   .Ar body
   starts with the character following that next character.
   .It
   If the first character of
   .Ar condition
   is
 .Sq d ,  .Sq d ,
 it evaluates to true if the rest of  it evaluates to true if the rest of
 .Ar condition  .Ar condition
Line 1489  Currently ignored.
Line 1472  Currently ignored.
 Set the maximum stack depth for recursive macros.  Set the maximum stack depth for recursive macros.
 This is a Heirloom extension and currently ignored.  This is a Heirloom extension and currently ignored.
 .It Ic \&return Op Ar twice  .It Ic \&return Op Ar twice
 Exit a macro and return to the caller.  Exit the presently executed macro and return to the caller.
 Currently unsupported.  The argument is currently ignored.
 .It Ic \&rfschar Ar font glyph ...  .It Ic \&rfschar Ar font glyph ...
 Remove font-specific fallback glyph definitions.  Remove font-specific fallback glyph definitions.
 Currently unsupported.  Currently unsupported.
Line 1539  This is a Heirloom extension and currently ignored.
Line 1522  This is a Heirloom extension and currently ignored.
 Change the soft hyphen character.  Change the soft hyphen character.
 Currently ignored.  Currently ignored.
 .It Ic \&shift Op Ar number  .It Ic \&shift Op Ar number
 Shift macro arguments.  Shift macro arguments
 Currently unsupported.  .Ar number
   times, by default once: \e\e$i becomes what \e\e$i+number was.
   Also decrement \en(.$ by
   .Ar number .
 .It Ic \&sizes Ar size ...  .It Ic \&sizes Ar size ...
 Define permissible point sizes.  Define permissible point sizes.
 This is a groff extension and currently ignored.  This is a groff extension and currently ignored.
Line 1851  is an unpaddable space-sized non-breaking space charac
Line 1837  is an unpaddable space-sized non-breaking space charac
 .Ss \e\(dq  .Ss \e\(dq
 The rest of the input line is treated as  The rest of the input line is treated as
 .Sx Comments .  .Sx Comments .
   .Ss \e#
   Line continuation with comment.
   Discard the rest of the physical input line and continue the logical
   input line on the next physical input line, joining the text on
   both lines together as if it were on a single input line.
   This is a groff extension.
   .Ss \e$ Ns Ar arg
   Macro argument expansion, see
   .Sx de .
 .Ss \e%  .Ss \e%
 Hyphenation allowed at this point of the word; ignored by  Hyphenation allowed at this point of the word; ignored by
 .Xr mandoc 1 .  .Xr mandoc 1 .
Line 1867  with two-letter names, see
Line 1862  with two-letter names, see
 .Xr mandoc_char 7 .  .Xr mandoc_char 7 .
 .Ss \e* Ns Bq Ar name  .Ss \e* Ns Bq Ar name
 Interpolate the string with the  Interpolate the string with the
 .Ar name ;  .Ar name .
 see  
 .Sx Predefined Strings  
 and  
 .Sx ds .  
 For short names, there are variants  For short names, there are variants
 .No \e* Ns Ar c  .No \e* Ns Ar c
 and  and
 .No \e*( Ns Ar cc .  .No \e*( Ns Ar cc .
   .Pp
   One string is predefined on the
   .Nm
   language level: \e*(.T expands to the name of the output device,
   for example ascii, utf8, ps, pdf, html, or markdown.
   .Pp
   Macro sets traditionally predefine additional strings which are not
   portable and differ across implementations.
   Those supported by
   .Xr mandoc 1
   are listed in
   .Xr mandoc_char 7 .
   .Pp
   Strings can be defined, changed, and deleted with the
   .Ic \&ds ,
   .Ic \&as ,
   and
   .Ic \&rm
   requests.
 .Ss \e,  .Ss \e,
 Left italic correction (groff extension); ignored by  Left italic correction (groff extension); ignored by
 .Xr mandoc 1 .  .Xr mandoc 1 .
Legend:
Removed from v.1.98  
changed lines
  Added in v.1.103
CVSweb