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 <firstname.lastname@example.org>
Date: 11/17/2003 14:53:28
>Synopsis: nmh's folders(1) , and flists(1) man pages should be linked to folder(1), and flist(1) respectively.
>Arrival-Date: Mon Nov 17 14:54:00 UTC 2003
>Originator: Igor Sobrado
>Release: NetBSD 1.6.1
University of Oviedo
NetBSD ns1.v6.x0.priv 1.6.1 NetBSD 1.6.1 (GENERIC_LAPTOP) #0: Tue Apr 8 12:21:37 UTC 2003 email@example.com:/autobuild/netbsd-1-6/i386/OBJ/autobuild/netbsd-1-6/src/sys/arch/i386/compile/GENERIC_LAPTOP i386
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, folders - set/list current folder/message
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
$ man folders
man: no entry for folders in the manual.
$ man flists
man: no entry for flists in the manual.
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.