[src/trunk]: src/share/man/man7 - Use .Li for head line in .Bl too.

[joerg <joerg%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/b57df45a2633
branches:  trunk
changeset: 753309:b57df45a2633
user:      joerg <joerg%NetBSD.org@localhost>
date:      Mon Mar 22 18:51:32 2010 +0000

description:
- Use .Li for head line in .Bl too.
- Do not use headers as example for .Aq, they should be marked up with
  .In
- Drop the use of .Xo/.Xc
- Make sure to quote .Sh as argument to .Bl. groff warns about the list
  otherwise and the size computation was off anyway as the string is
  used as literal later.

diffstat:

 share/man/man7/mdoc.samples.7 |  27 +++++++++------------------
 1 files changed, 9 insertions(+), 18 deletions(-)

diffs (78 lines):

diff -r 873f8612cff3 -r b57df45a2633 share/man/man7/mdoc.samples.7
--- a/share/man/man7/mdoc.samples.7     Mon Mar 22 18:38:43 2010 +0000
+++ b/share/man/man7/mdoc.samples.7     Mon Mar 22 18:51:32 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mdoc.samples.7,v 1.44 2009/03/09 23:01:08 wiz Exp $
+.\"    $NetBSD: mdoc.samples.7,v 1.45 2010/03/22 18:51:32 joerg Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -1540,7 +1540,7 @@
 .ne 5
 .Bd -filled -offset indent
 .Bl -column "quote " "close " "open " "Enclose Stringx(in XX) " XXstringXX
-.Em " Quote     Close   Open   Function        Result"
+.It Em " Quote  Close   Open   Function        Result"
 .It Li ".Aq    .Ac     .Ao" Ta No Angle Bracket Enclosure      \*[Lt]string\*[Gt]
 .It Li ".Bq    .Bc     .Bo" Ta No Bracket Enclosure    [string]
 .It Li ".Dq    .Dc     .Do" Ta No Double Quote ``string''
@@ -1601,11 +1601,11 @@
 .Pp
 .ne 4
 Examples of quoting:
-.Bl -tag -width ".Aq Pa ctype.h ) ,xxxxxxxx" -compact -offset indent
+.Bl -tag -width ".Aq ENTER ) ,xxxxxxxx" -compact -offset indent
 .It Li \&.Aq
 .Aq
-.It Li \&.Aq \&Ar ctype.h\ )\ ,
-.Aq Ar ctype.h ) ,
+.It Li \&.Aq ENTER\ )\ ,
+.Aq ENTER ) ,
 .It Li \&.Bq
 .Bq
 .It Li \&.Bq \&Em Greek \&, French \&.
@@ -1794,9 +1794,7 @@
 .Bd -filled -offset indent
 .Bl -tag -width flag -compact
 .Sm off
-.It Xo Sy I Ar operation
-.No \en Ar count No \en
-.Xc
+.It Sy I Ar operation No \en Ar count No \en
 .Sm on
 .El
 .Ed
@@ -1815,10 +1813,7 @@
 .Bd -filled -offset indent
 .Bl -tag -width flag -compact
 .Sm off
-.It Cm S No \&/ Ar old_pattern Xo
-.No \&/ Ar new_pattern
-.No \&/ Op Cm g
-.Xc
+.It Cm S No \&/ Ar old_pattern No \&/ Ar new_pattern No \&/ Op Cm g
 .Sm on
 .El
 .Ed
@@ -1838,11 +1833,7 @@
 Produces
 .Bd -filled -offset indent
 .Bl -tag -width flag -compact
-.It Xo
-.Ic .ifndef
-.Oo \&! Oc Ns Ar variable
-.Op Ar operator variable ...
-.Xc
+.It Ic .ifndef Oo \&! Oc Ns Ar variable Op Ar operator variable ...
 .El
 .Ed
 .Pp
@@ -1895,7 +1886,7 @@
 .Ql \&.Sh
 macro can take up to nine arguments.
 It is parsed but is not callable.
-.Bl -tag -width ".Sh SYNOPSIS"
+.Bl -tag -width "\&.Sh DESCRIPTION"
 .It Li \&.Sh NAME
 The
 .Ql \&.Sh NAME