Bug 25894

Summary: mdoc .Lb macro does not accept punctuation
Product: Base System Reporter: Peter Pentchev <roam>
Component: gnuAssignee: ru <ru>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Unspecified   
Hardware: Any   
OS: Any   

Description Peter Pentchev 2001-03-18 14:10:01 UTC
The mdoc.samples(7) manual page documents the .Lb macro as accepting more
than one argument and then some punctuation; however, this does not seem
to be the case.

Fix: 

Wish I knew my way around groff macros :\
How-To-Repeat: 
[roam@ringworld:v0 ~]$ zcat /usr/share/man/man7/mdoc.samples.7.gz | groff -mdoc -Tascii | fgrep 'Usage: .Lb'
            Usage: .Lb argument ... { . , : ; ? ! ( ) [ ]}
[roam@ringworld:v0 ~]$ echo '.Lb libmd .' | groff -mdoc -Tascii | uniq
Usage: .Lb [library name]
Message Digest (MD4, MD5, etc.) Support Library (libmd, -lmd)

[roam@ringworld:v0 ~]$

This is so on both my Mar 17 -stable, the Mar 10 ref4.FreeBSD.org, and
the Dec 12 freefall.FreeBSD.org.
Comment 1 Peter Pentchev freebsd_committer freebsd_triage 2001-03-18 14:10:50 UTC
Responsible Changed
From-To: freebsd-bugs->ru

I guess Ruslan tinkers with groff and -mdoc macros..
Comment 2 ru freebsd_committer freebsd_triage 2001-03-18 14:43:11 UTC
State Changed
From-To: open->suspended

If you look at the actual Lb sources, you will see the comment 
explaining this macro "does not handle punctuation" and "is 
really only intended for a standalone use".  IOW, this macro 
is not parsed and is not callable. 

The good news are that this is fixed in -mdocNG, hence I put 
this in "suspended" pending the (RSN) new Groff release which 
will come with -mdocNG.
Comment 3 ru freebsd_committer freebsd_triage 2001-04-17 17:39:50 UTC
State Changed
From-To: suspended->analyzed

Groff 1.17 has been imported into FreeBSD 5.0-CURRENT.
Comment 4 Peter Pentchev 2001-04-23 08:45:15 UTC
On Sun, Mar 18, 2001 at 06:50:18AM -0800, ru@FreeBSD.org wrote:
> Synopsis: mdoc .Lb macro does not accept punctuation
> 
> If you look at the actual Lb sources, you will see the comment
> explaining this macro "does not handle punctuation" and "is
> really only intended for a standalone use".  IOW, this macro
> is not parsed and is not callable.
> 
> The good news are that this is fixed in -mdocNG, hence I put
> this in "suspended" pending the (RSN) new Groff release which
> will come with -mdocNG.

OK, this is indeed fixed in -mdocNG, or at least in what is on ref5
right now :)  Thanks!  Now it just needs MFC'ing, but I guess this
could wait, judging from the amount of work you're doing on -mdocNG
in -current - it seems it's not quite trivial ;)

G'luck,
Peter

-- 
I am jealous of the first word in this sentence.
Comment 5 ru freebsd_committer freebsd_triage 2001-05-08 11:54:00 UTC
State Changed
From-To: analyzed->closed

Groff 1.17 has been imported into FreeBSD 4.3-STABLE.