On 2020-07-29 11:55:46 -0500, Derek Martin wrote:
> On Sun, Jul 26, 2020 at 03:04:33AM +0300, Maxim Tarasov wrote:
> > ---
> > init.h | 2 +-
> > 1 file changed, 1 insertion(+), 1 deletion(-)
> >
> > diff --git a/init.h b/init.h
> > index 06d4cc9a..f0d2c697 100644
> > --- a/init.h
> > +++ b/init.h
> > @@ -920,7 +920,7 @@ struct option_t MuttVars[] = {
> > { "dotlock_program", DT_PATH, R_NONE, {.p=&MuttDotlock}, {.p=BINDIR
> > "/mutt_dotlock"} },
> > /*
> > ** .pp
> > - ** Contains the path of the \fCmutt_dotlock(8)\fP binary to be used by
> > + ** Contains the path of the \fCmutt_dotlock(1)\fP binary to be used by
> > ** mutt.
> > */
> > #endif
>
> I think this is not correct. Section 1 of the man pages is meant for
> user-oriented utilities and applications, and mutt_dotlock is not such
> a thing--users generally have no call to run it directly. It is more
> a helper program for the administration of locks, and section 8 is for
> admin programs.
man-pages(7) says
1 User commands (Programs)
Commands that can be executed by the user from within a shell.
[...]
8 System management commands
Commands like mount(8), many of which only root can execute.
mutt_dotlock is not for system management. mutt_dotlock is a helper
program, but may also be useful for the end user, in particular to
remove locks in some cases. I'd say that in general, helper programs
should be in the same section as the one of the main program.
Note also that the man page for run-mailcap is also in Section 1.
--
Vincent Lefèvre <vinc...@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)
