[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openbsd-tech
Subject:    Re: patch: mdoc.samples.7
From:       Jason McIntyre <jmc () kerhand ! co ! uk>
Date:       2008-11-30 15:53:04
Message-ID: 20081130155403.GB9683 () bramka ! kerhand ! co ! uk
[Download RAW message or body]

On Sun, Nov 30, 2008 at 03:36:45PM +0100, Kristaps D??onsons wrote:
> The following patch fixes the erroneous claim that the `.Sh' macro is
> parsed, which is demonstrably not so:
> 
>   .Sh FOO Fl b
>       -> FOO Fl b
>   .Sh Fl b
>       -> Fl B
> 
> It also adds some bits about `.Ss', which is referenced but never
> described.  Like `.Sh', `.Ss' is neither parsed nor callable.
> 
> Comments?
>   Kristaps
> 
> 

i committed a fix for this based on your diff, though i tweaked it
somewhat. thanks for the submission,

jmc

> Index: mdoc.samples.7
> ===================================================================
> RCS file: /cvs/src/share/man/man7/mdoc.samples.7,v
> retrieving revision 1.78
> diff -u -r1.78 mdoc.samples.7
> --- mdoc.samples.7      7 Sep 2008 18:35:02 -0000       1.78
> +++ mdoc.samples.7      30 Nov 2008 14:27:46 -0000
> @@ -2340,7 +2340,7 @@
>  The
>  .Ql \&.Sh
>  macro can take up to nine arguments.
> -It is parsed but is not callable.
> +It is neither parsed nor callable.
>  .Bl -tag -width "XSh SYNOPSIS"
>  .It Li \&.Sh NAME
>  The
> @@ -2535,6 +2535,17 @@
>  for example, this section was set with:
>  .Bd -literal -offset 14n
>  \&.Sh PAGE STRUCTURE DOMAIN
> +.Ed
> +.Ss Subsection Headers
> +The
> +.Ql \&.Ss
> +macro begins a subsection header.  The
> +.Ql \&.Ss
> +macro can accept up to nine arguments and is neither parsed nor
> +callable.  Argument text is indented and formatted in bold face, for
> +example, this subsection was set with:
> +.Bd -literal -offset 14n
> +\&.Ss Subsection Headers
>  .Ed
>  .Ss Paragraphs and Line Spacing.
>  .Bl -tag -width 6n

[prev in list] [next in list] [prev in thread] [next in thread]