cvsintro.7: patch to fix .Bx invocation

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

cvsintro.7: patch to fix .Bx invocation

Fabio Scotoni
The cvsintro(7) man page uses ".Bx -licensed",
which is rendered as "-licensedBSD".
This patch fixes this to correctly read "BSD-licensed"
in both mandoc and groff.
I'm not entirely sure if .Bx should even be used here,
though apparently that decision has been made deliberately.

Index: cvsintro.7
===================================================================
RCS file: /cvs/src/usr.bin/cvs/cvsintro.7,v
retrieving revision 1.15
diff -u -p -r1.15 cvsintro.7
--- cvsintro.7  14 Aug 2013 08:46:07 -0000      1.15
+++ cvsintro.7  29 Nov 2018 19:18:34 -0000
@@ -223,7 +223,7 @@ unless the development network is local.
 .Xr sshd 8
 .Sh HISTORY
 The OpenCVS project is a
-.Bx -licensed
+.Bx Ns -licensed
 rewrite of the original
 Concurrent Versioning System written by Jean-Francois Brousseau.
 The original CVS code was written in large parts by Dick Grune,

Reply | Threaded
Open this post in threaded view
|

Re: cvsintro.7: patch to fix .Bx invocation

Ingo Schwarze
Hi,

Fabio Scotoni wrote on Wed, Dec 05, 2018 at 02:23:58PM +0100:

> The cvsintro(7) man page uses ".Bx -licensed",
> which is rendered as "-licensedBSD".

You are right, that is incorrect usage.

> This patch fixes this to correctly read "BSD-licensed"
> in both mandoc and groff.
> I'm not entirely sure if .Bx should even be used here,

You are right again.  The .Bx macro refers to releases made by
the Berkeley Computer Systems Research Group, not to a licensing
style.

> though apparently that decision has been made deliberately.

Not all authors are perfectly familiar with the mdoc(7) language,
so glitches happen, just like in code - only that in the docs,
consequences are on average less dire.  :)

See below for what i committed.  I guess i should make more use
of dbm_dump, it is quite handy.

Thanks,
  Ingo


CVSROOT: /cvs
Module name: src
Changes by: [hidden email] 2018/12/05 08:34:52

Modified files:
        share/man/man4 : multicast.4
        share/man/man9 : style.9
        usr.bin/cvs    : cvsintro.7

Log message:
fix incorrect usage of the .Bx macro;
one case reported by Fabio Scotoni <fabio at esse dot ch>,
the rest found with regress/usr.bin/mandoc/db/dbm_dump


Index: share/man/man4/multicast.4
===================================================================
RCS file: /cvs/src/share/man/man4/multicast.4,v
retrieving revision 1.13
diff -u -r1.13 multicast.4
--- share/man/man4/multicast.4 20 Oct 2018 20:09:18 -0000 1.13
+++ share/man/man4/multicast.4 5 Dec 2018 15:30:39 -0000
@@ -122,7 +122,7 @@
 sockets should be used
 for sending and receiving respectively IGMP or MLD messages.
 In the case of
-.Bx -derived
+.Bx Ns -derived
 kernels,
 it may be possible to open separate sockets
 for IGMP or MLD messages only.
Index: share/man/man9/style.9
===================================================================
RCS file: /cvs/src/share/man/man9/style.9,v
retrieving revision 1.72
diff -u -r1.72 style.9
--- share/man/man9/style.9 5 Oct 2018 12:11:21 -0000 1.72
+++ share/man/man9/style.9 5 Dec 2018 15:30:39 -0000
@@ -615,7 +615,7 @@
 .Xr mdoc 7
 .Sh HISTORY
 This man page is largely based on the src/admin/style/style file from the
-.Bx 4.4-Lite2
+.Bx 4.4 Lite2
 release, with updates to reflect the current practice and
 desire of the
 .Ox
Index: usr.bin/cvs/cvsintro.7
===================================================================
RCS file: /cvs/src/usr.bin/cvs/cvsintro.7,v
retrieving revision 1.15
diff -u -r1.15 cvsintro.7
--- usr.bin/cvs/cvsintro.7 14 Aug 2013 08:46:07 -0000 1.15
+++ usr.bin/cvs/cvsintro.7 5 Dec 2018 15:30:39 -0000
@@ -222,9 +222,7 @@
 .Xr cvs 5 ,
 .Xr sshd 8
 .Sh HISTORY
-The OpenCVS project is a
-.Bx -licensed
-rewrite of the original
+The OpenCVS project is a BSD-licensed rewrite of the original
 Concurrent Versioning System written by Jean-Francois Brousseau.
 The original CVS code was written in large parts by Dick Grune,
 Brian Berliner, and Jeff Polk.