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

Diff for /mandoc/mdoc.7 between version 1.274 and 1.279

version 1.274, 2018/12/23 22:03:32 version 1.279, 2019/07/15 19:20:30
Line 516  in the alphabetical
Line 516  in the alphabetical
 .Bl -column "Brq, Bro, Brc" description  .Bl -column "Brq, Bro, Brc" description
 .It Ic \&Em Ta italic font or underline (emphasis) (>0 arguments)  .It Ic \&Em Ta italic font or underline (emphasis) (>0 arguments)
 .It Ic \&Sy Ta boldface font (symbolic) (>0 arguments)  .It Ic \&Sy Ta boldface font (symbolic) (>0 arguments)
 .It Ic \&No Ta return to roman font (normal) (no arguments)  .It Ic \&No Ta return to roman font (normal) (>0 arguments)
 .It Ic \&Bf , \&Ef Ta font block: Fl Ar type | Cm \&Em | \&Li | \&Sy  .It Ic \&Bf , \&Ef Ta font block: Fl Ar type | Cm \&Em | \&Li | \&Sy
 .El  .El
 .Ss Physical enclosures  .Ss Physical enclosures
Line 596  block.
Line 596  block.
 Book or journal page number of an  Book or journal page number of an
 .Ic \&Rs  .Ic \&Rs
 block.  block.
   Conventionally, the argument starts with
   .Ql p.\&
   for a single page or
   .Ql pp.\&
   for a range of pages, for example:
   .Pp
   .Dl .%P pp. 42\e(en47
 .It Ic \&%Q Ar name  .It Ic \&%Q Ar name
 Institutional author (school, government, etc.) of an  Institutional author (school, government, etc.) of an
 .Ic \&Rs  .Ic \&Rs
Line 1156  declarations.
Line 1163  declarations.
 This practise is discouraged.  This practise is discouraged.
 .It Ic \&Cm Ar keyword ...  .It Ic \&Cm Ar keyword ...
 Command modifiers.  Command modifiers.
 Typically used for fixed strings passed as arguments, unless  Typically used for fixed strings passed as arguments to interactive
   commands, to commands in interpreted scripts, or to configuration
   file directives, unless
 .Ic \&Fl  .Ic \&Fl
 is more appropriate.  is more appropriate.
 Also useful when specifying configuration options or keys.  
 .Pp  .Pp
 Examples:  Examples:
 .Dl ".Nm mt Fl f Ar device Cm rewind"  .Dl ".Nm mt Fl f Ar device Cm rewind"
 .Dl ".Nm ps Fl o Cm pid , Ns Cm command"  .Dl ".Nm ps Fl o Cm pid , Ns Cm command"
 .Dl ".Nm dd Cm if= Ns Ar file1 Cm of= Ns Ar file2"  .Dl ".Nm dd Cm if= Ns Ar file1 Cm of= Ns Ar file2"
 .Dl ".Cm IdentityFile Pa ~/.ssh/id_rsa"  .Dl ".Ic set Fl o Cm vi"
 .Dl ".Cm LogLevel Dv DEBUG"  .Dl ".Ic lookup Cm file bind"
   .Dl ".Ic permit Ar identity Op Cm as Ar target"
 .It Ic \&D1 Ar line  .It Ic \&D1 Ar line
 One-line indented display.  One-line indented display.
 This is formatted by the default rules and is useful for simple indented  This is formatted by the default rules and is useful for simple indented
Line 1588  Examples:
Line 1597  Examples:
 .Dl \&.Fn \(dqint funcname\(dq \(dqint arg0\(dq \(dqint arg1\(dq  .Dl \&.Fn \(dqint funcname\(dq \(dqint arg0\(dq \(dqint arg1\(dq
 .Dl \&.Fn funcname \(dqint arg0\(dq  .Dl \&.Fn funcname \(dqint arg0\(dq
 .Dl \&.Fn funcname arg0  .Dl \&.Fn funcname arg0
 .Pp  .Bd -literal -offset indent
 .Bd -literal -offset indent -compact  
 \&.Ft functype  \&.Ft functype
 \&.Fn funcname  \&.Fn funcname
 .Ed  .Ed
Line 1678  This macro is not implemented in
Line 1686  This macro is not implemented in
 .Xr mandoc 1 .  .Xr mandoc 1 .
 It was used to include the contents of a (header) file literally.  It was used to include the contents of a (header) file literally.
 .It Ic \&Ic Ar keyword ...  .It Ic \&Ic Ar keyword ...
 Designate an internal or interactive command.  Internal or interactive command, or configuration instruction
 This is similar to  in a configuration file.
 .Ic \&Cm  See also
 but used for instructions rather than values.  .Ic \&Cm .
 .Pp  .Pp
 Examples:  Examples:
 .Dl \&.Ic :wq  .Dl \&.Ic :wq
Line 1933  using semantic annotation macros.
Line 1941  using semantic annotation macros.
 .Pp  .Pp
 Examples:  Examples:
 .Dl ".Em italic , Sy bold , No and roman"  .Dl ".Em italic , Sy bold , No and roman"
 .Pp  .Bd -literal -offset indent
 .Bd -literal -offset indent -compact  
 \&.Sm off  \&.Sm off
 \&.Cm :C No / Ar pattern No / Ar replacement No /  \&.Cm :C No / Ar pattern No / Ar replacement No /
 \&.Sm on  \&.Sm on
Line 2891  then the macro accepts an arbitrary number of argument
Line 2898  then the macro accepts an arbitrary number of argument
 .It Ic \&Ms  Ta    Yes      Ta    Yes      Ta    >0  .It Ic \&Ms  Ta    Yes      Ta    Yes      Ta    >0
 .It Ic \&Mt  Ta    Yes      Ta    Yes      Ta    >0  .It Ic \&Mt  Ta    Yes      Ta    Yes      Ta    >0
 .It Ic \&Nm  Ta    Yes      Ta    Yes      Ta    n  .It Ic \&Nm  Ta    Yes      Ta    Yes      Ta    n
 .It Ic \&No  Ta    Yes      Ta    Yes      Ta    0  .It Ic \&No  Ta    Yes      Ta    Yes      Ta    >0
 .It Ic \&Ns  Ta    Yes      Ta    Yes      Ta    0  .It Ic \&Ns  Ta    Yes      Ta    Yes      Ta    0
 .It Ic \&Nx  Ta    Yes      Ta    Yes      Ta    n  .It Ic \&Nx  Ta    Yes      Ta    Yes      Ta    n
 .It Ic \&Os  Ta    \&No     Ta    \&No     Ta    n  .It Ic \&Os  Ta    \&No     Ta    \&No     Ta    n
Line 2971  exclamation mark
Line 2978  exclamation mark
 Note that even a period preceded by a backslash  Note that even a period preceded by a backslash
 .Pq Sq \e.\&  .Pq Sq \e.\&
 gets this special handling; use  gets this special handling; use
 .Sq \e&.  .Sq \e&.\&
 to prevent that.  to prevent that.
 .Pp  .Pp
 Many in-line macros interrupt their scope when they encounter  Many in-line macros interrupt their scope when they encounter
Line 2998  in the same way as a plain
Line 3005  in the same way as a plain
 .Sq \&|  .Sq \&|
 character.  character.
 Using this predefined string is not recommended in new manuals.  Using this predefined string is not recommended in new manuals.
   .Pp
   Appending a zero-width space
   .Pq Sq \e&
   to the end of an input line is also useful to prevent the interpretation
   of a trailing period, exclamation or question mark as the end of a
   sentence, for example when an abbreviation happens to occur
   at the end of a text or macro input line.
 .Ss Font handling  .Ss Font handling
 In  In
 .Nm  .Nm
Legend:
Removed from v.1.274  
changed lines
  Added in v.1.279
CVSweb