Re: Trả lời: making man-pages

[Todd Gruhn <tgruhn2%gmail.com@localhost>]

I just take an existing man-page and hack it.

How do I name the man-page for progam FOO?
Is it 'FOO.3" ??

And in which   dir to I  to ??
(to "/usr/local/man/man*"  ?? )

On Thu, Apr 20, 2023 at 5:44 AM Pham Ngoc-Dung <ifa26417%outlook.com.vn@localhost> wrote:
>
> Check out the manpage for mdoc(7), section "TITLE MACROS".  There is a list of section numbers there, maybe that's what you needed.
> ________________________________
> Từ: netbsd-users-owner%NetBSD.org@localhost <netbsd-users-owner%NetBSD.org@localhost> thay mặt cho Todd Gruhn <tgruhn2%gmail.com@localhost>
> Đã gửi: 20 Tháng Tư 2023 3:41 SA
> Đến: Jeremy C. Reed <reed%reedmedia.net@localhost>
> Cc: Netbsd-Users-List <netbsd-users%netbsd.org@localhost>
> Chủ đề: Re: making man-pages
>
> Did I say that write?
>
>
> I write FOO -- make manpage 'FOO.? '
>
> SOOO, manpage is FOO.3?
> Where do I put this?
>
> On Wed, Apr 19, 2023 at 6:40 PM Jeremy C. Reed <reed%reedmedia.net@localhost> wrote:
> >
> > On Wed, 19 Apr 2023, Todd Gruhn wrote:
> >
> > > If I write a program, and a man-page with it; where do I install this
> > > man-page ??
> >
> > See the manpath on your NetBSD system:
> > man -p
> >
> > That shows what directories actually currently has manuals.
> > So also see:
> > /etc/man.conf
> >
> > A common place to install your own manpage is
> > /usr/local/man/man1/
> >
> > The man manpage or man itself has a bug:
> > the man.c comments say -p prints the directories containing manpages.
> > The manpage says -p prints the path.
> >
> > But actually -p prints the directories from the search path that exist
> > regardless if contain manpages or not.
> >
> > Okay if I commit this?
> >
> >  .It Fl p
> >  Print the search path for the manual pages.
> > +This excludes cat page directories and non-existent directories.
> >
> > Fix man.c comments too?
> > Or should the code be fixed to only -p print directories containing
> > a man page?