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

Diff for /mandoc/mdoc.7 between version 1.5 and 1.7

version 1.5, 2009/03/16 22:19:19 version 1.7, 2009/03/19 11:49:00
Line 1 
Line 1 
 .\" $Id$  .\" $Id$
 .\"  .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>  .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@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  .\" purpose with or without fee is hereby granted, provided that the
Line 41  of these macros.
Line 41  of these macros.
 .\" SECTION  .\" SECTION
 .Sh CHARACTER ENCODING  .Sh CHARACTER ENCODING
 .Nm  .Nm
 documents may contain only printable alphanumeric characters, the space  documents may contain only printable characters, the space character
 character  
 .Sq \  ,  .Sq \  ,
 and, in certain circumstances, the tab character  and, in certain circumstances, the tab character
 .Sq \et .  .Sq \et .
Line 128  Enclosures:
Line 127  Enclosures:
 .It \\(rh  .It \\(rh
 .Pq right hand  .Pq right hand
 .It \\(<<  .It \\(<<
 .Pq left guillemot  .Pq left guillemet
 .It \\(>>  .It \\(Fc
 .Pq right guillemot  .Pq right guillemet
   .It \\(Fo
   .Pq left guilsing
   .It \\(fc
   .Pq right guilsing
   .It \\(fo
   .Pq right guilsing
 .It \\(rC  .It \\(rC
 .Pq right brace  .Pq right brace
 .It \\(lC  .It \\(lC
Line 222  Mathematical:
Line 227  Mathematical:
 .El  .El
 .\" PARAGRAPH  .\" PARAGRAPH
 .Pp  .Pp
 Diacritics and letter combinations:  Ligatures:
 .Bl -tag -width 12n -offset "XXXX" -compact  .Bl -tag -width 12n -offset "XXXX" -compact
 .It \\(ga  .It \\(ss
 .Pq accent grave  .Pq German eszett
 .It \\(aa  
 .Pq accent accute  
 .It \\(ad  
 .Pq accent dieresis  
 .It \\(a~  
 .Pq accent tilde  
 .It \\(AE  .It \\(AE
 .Pq upper-case AE  .Pq upper-case AE
 .It \\(ae  .It \\(ae
Line 240  Diacritics and letter combinations:
Line 239  Diacritics and letter combinations:
 .Pq upper-case OE  .Pq upper-case OE
 .It \\(oe  .It \\(oe
 .Pq lower-case OE  .Pq lower-case OE
   .It \\(ff
   .Pq ff ligature
   .It \\(fi
   .Pq fi ligature
   .It \\(fl
   .Pq fl ligature
   .It \\(Fi
   .Pq ffi ligature
   .It \\(Fl
   .Pq ffl ligature
   .El
   .\" PARAGRAPH
   .Pp
   Diacritics and letters:
   .Bl -tag -width 12n -offset "XXXX" -compact
   .It \\(ga
   .Pq grave accent
   .It \\(aa
   .Pq accute accent
   .It \\(ad
   .Pq dieresis accent
   .It \\(a~
   .Pq tilde accent
   .It \\(a^
   .Pq circumflex accent
   .It \\(ac
   .Pq cedilla accent
   .It \\(ad
   .Pq dieresis accent
   .It \\(ah
   .Pq caron accent
   .It \\(ao
   .Pq ring accent
   .It \\(ho
   .Pq hook accent
   .It \\(ab
   .Pq breve accent
   .It \\(a-
   .Pq macron accent
   .It \\(-D
   .Pq upper-case eth
   .It \\(Sd
   .Pq lower-case eth
   .It \\(TP
   .Pq upper-case thorn
   .It \\(Tp
   .Pq lower-case thorn
 .It \\('A  .It \\('A
 .Pq upper-case acute A  .Pq upper-case acute A
 .It \\('E  .It \\('E
Line 314  Diacritics and letter combinations:
Line 360  Diacritics and letter combinations:
 .Pq lower-case dieresis u  .Pq lower-case dieresis u
 .It \\(:y  .It \\(:y
 .Pq lower-case dieresis y  .Pq lower-case dieresis y
   .It \\(^A
   .Pq upper-case circumflex A
   .It \\(^E
   .Pq upper-case circumflex E
   .It \\(^I
   .Pq upper-case circumflex I
   .It \\(^O
   .Pq upper-case circumflex O
   .It \\(^U
   .Pq upper-case circumflex U
   .It \\(^a
   .Pq lower-case circumflex a
   .It \\(^e
   .Pq lower-case circumflex e
   .It \\(^i
   .Pq lower-case circumflex i
   .It \\(^o
   .Pq lower-case circumflex o
   .It \\(^u
   .Pq lower-case circumflex u
   .It \\(,C
   .Pq upper-case cedilla C
   .It \\(,c
   .Pq lower-case cedilla c
   .It \\(/L
   .Pq upper-case stroke L
   .It \\(/l
   .Pq lower-case stroke l
   .It \\(/O
   .Pq upper-case stroke O
   .It \\(/o
   .Pq lower-case stroke o
   .It \\(oA
   .Pq upper-case ring A
   .It \\(oa
   .Pq lower-case ring a
 .El  .El
 .\" PARAGRAPH  .\" PARAGRAPH
 .Pp  .Pp
   Monetary:
   .Bl -tag -width 12n -offset "XXXX" -compact
   .It \\(Cs
   .Pq Scandinavian
   .It \\(Do
   .Pq dollar
   .It \\(Po
   .Pq pound
   .It \\(Ye
   .Pq yen
   .It \\(Fn
   .Pq florin
   .It \\(ct
   .Pq cent
   .El
   .\" PARAGRAPH
   .Pp
 Special symbols:  Special symbols:
 .Bl -tag -width 12n -offset "XXXX" -compact  .Bl -tag -width 12n -offset "XXXX" -compact
 .It \\(bu  .It \\(bu
Line 643  then the macro accepts an arbitrary number of argument
Line 742  then the macro accepts an arbitrary number of argument
 .It \&.Sy    Ta    Yes   Ta    Yes     Ta    >0  .It \&.Sy    Ta    Yes   Ta    Yes     Ta    >0
 .It \&.Tn    Ta    Yes   Ta    Yes     Ta    >0  .It \&.Tn    Ta    Yes   Ta    Yes     Ta    >0
 .It \&.Ux    Ta    Yes   Ta    Yes     Ta    n  .It \&.Ux    Ta    Yes   Ta    Yes     Ta    n
   .It \&.Dx    Ta    Yes   Ta    Yes     Ta    n
 .It \&.Bt    Ta    \&No  Ta    \&No    Ta    0  .It \&.Bt    Ta    \&No  Ta    \&No    Ta    0
 .It \&.Hf    Ta    \&No  Ta    \&No    Ta    n  .It \&.Hf    Ta    \&No  Ta    \&No    Ta    n
 .It \&.Fr    Ta    \&No  Ta    \&No    Ta    n  .It \&.Fr    Ta    \&No  Ta    \&No    Ta    n
Line 652  then the macro accepts an arbitrary number of argument
Line 752  then the macro accepts an arbitrary number of argument
 .It \&.Lp    Ta    \&No  Ta    \&No    Ta    0  .It \&.Lp    Ta    \&No  Ta    \&No    Ta    0
 .It \&.Lk    Ta    \&No  Ta    Yes     Ta    >0  .It \&.Lk    Ta    \&No  Ta    Yes     Ta    >0
 .It \&.Mt    Ta    \&No  Ta    Yes     Ta    >0  .It \&.Mt    Ta    \&No  Ta    Yes     Ta    >0
   .It \&.Es    Ta    \&No  Ta    \&No    Ta    0
   .It \&.En    Ta    \&No  Ta    \&No    Ta    0
 .El  .El
   .Pp
   The
   .Sq \&Ot ,
   .Sq \&Fr ,
   .Sq \&Es
   and
   .Sq \&En ,
   macros are obsolete.
 .\" SECTION  .\" SECTION
 .Sh COMPATIBILITY  .Sh COMPATIBILITY
 The mdoc language was traditionally a  The mdoc language was traditionally a
Line 718  is callable.
Line 828  is callable.
 The  The
 .Nm  .Nm
 utility was written by  utility was written by
 .An Kristaps Dzonsons Aq kristaps@kth.se .  .An Kristaps Dzonsons Aq kristaps@openbsd.org .
 .\" SECTION  .\" SECTION
 .Sh CAVEATS  .Sh CAVEATS
 There are several ambiguous parts of mdoc.  There are several ambiguous parts of mdoc.
Line 773  The
Line 883  The
 .Sq \&Dt  .Sq \&Dt
 macro lacks clarity.  It should be absolutely clear which title will  macro lacks clarity.  It should be absolutely clear which title will
 render when formatting the manual page.  render when formatting the manual page.
   .\" LIST-ITEM
   .It
   A
   .Sq \&Lx
   should be provided for Linux (\(`a la
   .Sq \&Ox ,
   .Sq \&Nx
   etc.).
 .El  .El
Legend:
Removed from v.1.5  
changed lines
  Added in v.1.7
CVSweb