Subject: pkg/23466: nmh's folders(1) , and flists(1) man pages should be linked to folder(1), and flist(1) respectively.
To: None <gnats-bugs@gnats.NetBSD.org>
From: None <sobrado@acm.org>
List: netbsd-bugs
Date: 11/17/2003 14:53:28
>Number:         23466
>Category:       pkg
>Synopsis:       nmh's folders(1) , and flists(1) man pages should be linked to folder(1), and flist(1) respectively.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Nov 17 14:54:00 UTC 2003
>Closed-Date:
>Last-Modified:
>Originator:     Igor Sobrado
>Release:        NetBSD 1.6.1
>Organization:
University of Oviedo
>Environment:
NetBSD ns1.v6.x0.priv 1.6.1 NetBSD 1.6.1 (GENERIC_LAPTOP) #0: Tue Apr  8 12:21:37 UTC 2003     autobuild@tgm.daemon.org:/autobuild/netbsd-1-6/i386/OBJ/autobuild/netbsd-1-6/src/sys/arch/i386/compile/GENERIC_LAPTOP i386

>Description:
The new MH message system (nmh) folders(1) man page should be linked to folder(1).  When invoked as folders(1), this command shows information related with all the folders in the user's mail box.  Both variants of the folder(1) command should have an entry on the package manual.  On the other hand, the folder(1) man page shows that this page can be called using both folder(1) and folders(1):

FOLDER(1)                                               FOLDER(1)

NAME
       folder, folders - set/list current folder/message

SYNOPSIS
       folder [+folder] [msg] [-all] [-noall]
            [-create] [-nocreate] [-fast] [-nofast]
            [-header] [-noheader] [-recurse] [-norecurse]
            [-total] [-nototal] [-list] [-nolist]
            [-push] [-pop] [-pack] [-nopack] [-print]
            [-verbose] [-noverbose] [-version] [-help]

     folders is equivalent to folder -all
[...]
>How-To-Repeat:
$ man folders
man: no entry for folders in the manual.

$ man flists
man: no entry for flists in the manual.
>Fix:
There are a lot of approaches to this problem.  IMHO, the best of all those approaches have been followed by nmh in mh-profile(5) and mh_profile(5):

$ ls -lai mh-profile.5 mh_profile.5
49429 -r--r--r--  2 root  wheel  20374 Nov  5 16:15 mh-profile.5
49429 -r--r--r--  2 root  wheel  20374 Nov  5 16:15 mh_profile.5

Both entries are the same file.  I think that the package maintainer is the right person to choose the way this problem must be fixed.
>Release-Note:
>Audit-Trail:
>Unformatted: