Bug 37176

Summary: similar nits in assorted man pages
Product: Documentation Reporter: rdm <rdm>
Component: Books & ArticlesAssignee: ru <ru>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description rdm 2002-04-17 09:10:00 UTC
	When I format assorted man pages, a certain class of errors show
        up.  As these all seem very similar, I have folded them into a
        single PR.

        Most of the errors have to do with ".Li" arguments, via the ".Ql"
        macro.  It looks like a fix to the macro is needed...

Fix: 

See below.


ftp.1
-----

> Usage: .Li argument ... (#609)

I don't know what the fix should be; the offending line is:

> .Ql Op Ar seq1 , Ar seq2


mail.1
------

> Usage: .Li argument ... (#167)
> Usage: .Li argument ... (#171)
> Usage: .Li argument ... (#173)
> ...

I don't know what the fix should be; the offending lines are:

> .Ql Ic p ) .
> .Ql Ic \&+
> .Ql Ic \&\-
> ...


make.1
------

> Usage: .Li argument ... (#63)
> Usage: .Li argument ... (#65)
> Usage: .Li argument ... (#68)
> ...

I don't know what the fix should be; the offending lines are:

> .Ql Pa makefile
> .Ql Pa Makefile
> .Ql Va .OBJDIR )
> ...


paste.1
-------

Usage: .Li argument ... (#108)
Usage: .Li argument ... (#112)

I don't know what the fix should be; the offending lines are:

> .Ql Fl
> .Ql Fl .


ps.1
----

> Usage: .Li argument ... (#252)

I don't know what the fix should be; the offending line is:

> .Ql Li /proc/<pid>/status .


cvsupd.8
--------

> Usage: .Li argument ... (#60)

I don't know what the fix should be; the offending line is:

> .Ql Fl C Ar maxClients


dump.8
------

> Usage: .Li argument ... (#145)

I don't know what the fix should be; the offending line is:

> .Ql Fl


intro.8
-------

> Usage: .Li argument ... (#45)
> Usage: .Li argument ... (#47)
> Usage: .Li argument ... (#49)
> ...

I don't know what the fix should be; the offending lines are:

> .Ql Xr newfs ,
> .Ql Xr fsck ,
> .Ql Xr edquota ,
> ...


restore.8
---------

> Usage: .Li argument ... (#295)

I don't know what the fix should be; the offending line is:

> .Ql Fl
How-To-Repeat: 
	"groff -man" the man pages or, alternatively,
	"groff -te -mandoc -mtty-char -Tps" them...
Comment 1 ru freebsd_committer freebsd_triage 2002-04-17 11:52:31 UTC
Responsible Changed
From-To: freebsd-doc->ru

Nice spot!  I will fix these all soon. 

The nroff version of the .Ql macro should also be fixed to not hide these bugs.
Comment 2 ru freebsd_committer freebsd_triage 2002-12-23 16:05:38 UTC
State Changed
From-To: open->closed

Fixed, thanks!