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

Diff for /mandoc/mdoc.7 between version 1.268 and 1.270

version 1.268, 2017/07/05 12:25:17 version 1.270, 2017/10/23 13:54:41
Line 674  Examples:
Line 674  Examples:
 .Ss \&Ao  .Ss \&Ao
 Begin a block enclosed by angle brackets.  Begin a block enclosed by angle brackets.
 Does not have any head arguments.  Does not have any head arguments.
 .Pp  This macro is almost never useful.
 Examples:  See
 .Dl \&.Fl -key= \&Ns \&Ao \&Ar val \&Ac  .Sx \&Aq
 .Pp  for more details.
 See also  
 .Sx \&Aq .  
 .Ss \&Ap  .Ss \&Ap
 Inserts an apostrophe without any surrounding whitespace.  Inserts an apostrophe without any surrounding whitespace.
 This is generally used as a grammatical device when referring to the verb  This is generally used as a grammatical device when referring to the verb
Line 689  Examples:
Line 687  Examples:
 .Dl \&.Fn execve \&Ap d  .Dl \&.Fn execve \&Ap d
 .Ss \&Aq  .Ss \&Aq
 Encloses its arguments in angle brackets.  Encloses its arguments in angle brackets.
   The only important use case is for email addresses.
   See
   .Sx \&Mt
   for an example.
 .Pp  .Pp
 Examples:  Occasionally, it is used for names of characters and keys, for example:
 .Dl \&.Fl -key= \&Ns \&Aq \&Ar val  .Bd -literal -offset indent
   Press the
   \&.Aq escape
   key to ...
   .Ed
 .Pp  .Pp
 .Em Remarks :  For URIs, use
 this macro is often abused for rendering URIs, which should instead use  
 .Sx \&Lk  .Sx \&Lk
   instead, and
   .Sx \&In
   for
   .Dq #include
   directives.
   Never wrap
   .Sx \&Ar
   in
   .Sx \&Aq .
   .Pp
   Since
   .Sx \&Aq
   usually renders with non-ASCII characters in non-ASCII output modes,
   do not use it where the ASCII characters
   .Sq <
   and
   .Sq >
   are required as syntax elements.
   Instead, use these characters directly in such cases, combining them
   with the macros
   .Sx \&Pf ,
   .Sx \&Ns ,
 or  or
 .Sx \&Mt ,  .Sx \&Eo
 or to note pre-processor  as needed.
 .Dq Li #include  
 statements, which should use  
 .Sx \&In .  
 .Pp  .Pp
 See also  See also
 .Sx \&Ao .  .Sx \&Ao .
Line 3198  but produces large indentations.
Line 3222  but produces large indentations.
 .Xr tbl 7  .Xr tbl 7
 .Pp  .Pp
 The web page  The web page
 .Lk http://mdocml.bsd.lv/mdoc/ "extended documentation for the mdoc language"  .Lk http://mandoc.bsd.lv/mdoc/ "extended documentation for the mdoc language"
 provides a few tutorial-style pages for beginners, an extensive style  provides a few tutorial-style pages for beginners, an extensive style
 guide for advanced authors, and an alphabetic index helping to choose  guide for advanced authors, and an alphabetic index helping to choose
 the best macros for various kinds of content.  the best macros for various kinds of content.
Legend:
Removed from v.1.268  
changed lines
  Added in v.1.270
CVSweb