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

Diff for /mandoc/mandoc.1 between version 1.109 and 1.116

version 1.109, 2014/08/30 18:08:10 version 1.116, 2014/10/10 08:44:24
Line 23 
Line 23 
 .Nd format and display UNIX manuals  .Nd format and display UNIX manuals
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm mandoc  .Nm mandoc
 .Op Fl acfklV  .Op Fl acfhklV
 .Sm off  .Sm off
 .Op Fl I Cm os Li = Ar name  .Op Fl I Cm os Li = Ar name
 .Sm on  .Sm on
Line 85  for the
Line 85  for the
 .Xr mdoc 7  .Xr mdoc 7
 .Sq \&Os  .Sq \&Os
 macro.  macro.
   .It Fl h
   Display only the SYNOPSIS lines.
   Implies
   .Fl a .
 .It Fl k  .It Fl k
 A synonym for  A synonym for
 .Xr apropos 1 .  .Xr apropos 1 .
Line 229  This is the default.
Line 233  This is the default.
 See  See
 .Sx ASCII Output .  .Sx ASCII Output .
 .It Fl T Ns Cm html  .It Fl T Ns Cm html
 Produce strict CSS1/HTML-4.01 output.  Produce HTML5, CSS1, and MathML output.
 See  See
 .Sx HTML Output .  .Sx HTML Output .
 .It Fl T Ns Cm lint  .It Fl T Ns Cm lint
Line 261  Encode output in the UTF\-8 multi-byte format.
Line 265  Encode output in the UTF\-8 multi-byte format.
 See  See
 .Sx UTF\-8 Output .  .Sx UTF\-8 Output .
 .It Fl T Ns Cm xhtml  .It Fl T Ns Cm xhtml
 Produce strict CSS1/XHTML-1.0 output.  This is a synonym for
 See  .Fl T Ns Cm html .
 .Sx XHTML Output .  
 .El  .El
 .Pp  .Pp
 If multiple input files are specified, these will be processed by the  If multiple input files are specified, these will be processed by the
Line 316  which will normalise to \(>=60.
Line 319  which will normalise to \(>=60.
 .Ss HTML Output  .Ss HTML Output
 Output produced by  Output produced by
 .Fl T Ns Cm html  .Fl T Ns Cm html
 conforms to HTML-4.01 strict.  conforms to HTML5 using optional self-closing tags.
   Default styles use only CSS1.
   Equations rendered from
   .Xr eqn 7
   blocks use MathML.
 .Pp  .Pp
 The  The
 .Pa example.style.css  .Pa example.style.css
Line 324  file documents style-sheet classes available for custo
Line 331  file documents style-sheet classes available for custo
 If a style-sheet is not specified with  If a style-sheet is not specified with
 .Fl O Ns Ar style ,  .Fl O Ns Ar style ,
 .Fl T Ns Cm html  .Fl T Ns Cm html
 defaults to simple output readable in any graphical or text-based web  defaults to simple output (via an embedded style-sheet)
   readable in any graphical or text-based web
 browser.  browser.
 .Pp  .Pp
 Special characters are rendered in decimal-encoded UTF\-8.  Special characters are rendered in decimal-encoded UTF\-8.
Line 467  to force a UTF\-8 locale.
Line 475  to force a UTF\-8 locale.
 See  See
 .Sx Locale Output  .Sx Locale Output
 for details and options.  for details and options.
 .Ss XHTML Output  
 Output produced by  
 .Fl T Ns Cm xhtml  
 conforms to XHTML-1.0 strict.  
 .Pp  
 See  
 .Sx HTML Output  
 for details; beyond generating XHTML tags instead of HTML tags, these  
 output modes are identical.  
 .Sh ENVIRONMENT  .Sh ENVIRONMENT
 .Bl -tag -width MANPAGER  .Bl -tag -width MANPAGER
 .It Ev MANPAGER  .It Ev MANPAGER
Line 762  The same standard section title occurs more than once.
Line 761  The same standard section title occurs more than once.
 .Pq mdoc  .Pq mdoc
 A standard section header occurs in a section of the manual  A standard section header occurs in a section of the manual
 where it normally isn't useful.  where it normally isn't useful.
   .It Sy "unusual Xr order"
   .Pq mdoc
   In the SEE ALSO section, an
   .Ic \&Xr
   macro with a lower section number follows one with a higher number,
   or two
   .Ic \&Xr
   macros refering to the same section are out of alphabetical order.
   .It Sy "unusual Xr punctuation"
   .Pq mdoc
   In the SEE ALSO section, punctuation between two
   .Ic \&Xr
   macros differs from a single comma, or there is trailing punctuation
   after the last
   .Ic \&Xr
   macro.
   .It Sy "AUTHORS section without An macro"
   .Pq mdoc
   An AUTHORS sections contains no
   .Ic \&An
   macros, or only empty ones.
   Probably, there are author names lacking markup.
 .El  .El
 .Ss "Warnings related to macros and nesting"  .Ss "Warnings related to macros and nesting"
 .Bl -ohang  .Bl -ohang
Line 1092  macro has an invalid argument.
Line 1113  macro has an invalid argument.
 It is used verbatim, with  It is used verbatim, with
 .Qq "AT&T UNIX "  .Qq "AT&T UNIX "
 prefixed to it.  prefixed to it.
   .It Sy "comma in function argument"
   .Pq mdoc
   An argument of an
   .Ic \&Fa
   or
   .Ic \&Fn
   macro contains a comma; it should probably be split into two arguments.
 .It Sy "invalid content in Rs block"  .It Sy "invalid content in Rs block"
 .Pq mdoc  .Pq mdoc
 An  An
Line 1110  or
Line 1138  or
 The invalid argument is moved out of the macro, which leaves the macro  The invalid argument is moved out of the macro, which leaves the macro
 empty, causing it to toggle the spacing mode.  empty, causing it to toggle the spacing mode.
 .It Sy "unknown font, skipping request"  .It Sy "unknown font, skipping request"
 .Pq man  .Pq man , tbl
 A  A
 .Xr roff 7  .Xr roff 7
 .Ic \&ft  .Ic \&ft
 request has an invalid argument.  request or a
   .Xr tbl 7
   .Ic \&f
   layout modifier has an unknown
   .Ar font
   argument.
 .El  .El
 .Ss "Warnings related to plain text"  .Ss "Warnings related to plain text"
 .Bl -ohang  .Bl -ohang
Line 1496  has no effect.
Line 1529  has no effect.
 .It  .It
 Words aren't hyphenated.  Words aren't hyphenated.
 .El  .El
 .Ss HTML/XHTML Compatibility  .Ss HTML Compatibility
 .Bl -bullet -compact  .Bl -bullet -compact
 .It  .It
 The  The
Legend:
Removed from v.1.109  
changed lines
  Added in v.1.116
CVSweb