mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.3 and 1.7

-version 1.3, 2009/03/20 15:14:01
+version 1.7, 2009/03/23 09:42:43
 Line 88  were provided.
 Line 88  were provided.
 Line 88  were provided.
  .Pp
  .Ex -std mandoc
  .\" SUB-SECTION
+ .Ss Reserved Words
+ The reserved words described in
+ .Xr mdoc 7
+ are handled according to the following rules:
+ .Bl -enum -offset XXX
+ .It
+ Opening delimiters
+ .Po
+ .Sq \&( ,
+ .Sq \&[ ,
+ and
+ .Sq \&{
+ .Pc are not followed by whitespace.
+ .It
+ Closing delimiters
+ .Po
+ .Sq \&. ,
+ .Sq \&, ,
+ .Sq \&; ,
+ .Sq \&: ,
+ .Sq \&? ,
+ .Sq \&! ,
+ .Sq \&) ,
+ .Sq \&]
+ and
+ .Sq \&}
+ .Pc are not preceeded by whitespace.
+ .El
+ .\" PARAGRAPH
+ .Pp
+ Note that reserved words only register as such as if they appear as
+ standalone tokens, either in parsed lines or streams of text.  Thus, the
+ following fragment:
+ .Bd -literal -offset XXXX
+ this self is not that of the waking , empirically real man
+ .Ed
+ .\" PARAGRAPH
+ .Pp
+ \&...correctly adjusts the comma spacing to
+ .Dq this self is not that of the waking , empirically real man .
+ However, if the comma were part of
+ .Dq ,empirically ,
+ it would not.
+ .\" SUB-SECTION
  .Ss Output Formats
  The
  .Nm
-Line 145  utility was written by
+Line 189  utility was written by
 Line 145  utility was written by
 Line 189  utility was written by
  .Sh CAVEATS
  The
  .Nm
- utility doesn't yet know how to display the following:
+ utility in
+ .Fl T Ns Ar ascii
+ mode doesn't yet know how to display the following:
  .Pp
  .Bl -bullet -compact
  .It
  The \-hang
  .Sq \&Bl
  list is not yet supported.
- .It
- The \-literal and \-unfilled
- .Sq \&Bd
- displays types are synonyms, as are \-filled and \-ragged.
- .It
- The
- .Sq \&Xo/Xc
- pair isn't supported.
- .It
- The
- .Sq \&Sm
- macro has no effect, yet.
  .El
  .Pp
  Other macros still aren't supported by virtue of nobody complaining
  about their absence.  Please report any omissions: this is a work in
  progress.
+ .Pp
+ The following list documents differences between traditional
+ .Xr nroff 1
+ output and
+ .Nm :
+ .Pp
+ .Bl -bullet -compact
+ .It
+ A list of display following
+ .Sq \&Ss
+ does not assert a prior vertical break, just as it doesn't with
+ .Sq \&Sh .
+ .It
+ Special characters don't follow the current font style.
+ .\" LIST-ITEM
+ .It
+ The \-literal and \-unfilled
+ .Sq \&Bd
+ displays types are synonyms, as are \-filled and \-ragged.
+ .El

CVSweb