Re: adding a sysctl man section

Lutz Donnerhacke <[email protected]>
Newsgroups gmane.os.freebsd.architechture
Message-ID <[email protected]>
On Wed, Feb 10, 2021 at 06:37:00PM -0700, Warner Losh wrote:
> On Wed, Feb 10, 2021 at 5:15 PM John-Mark Gurney <[email protected]> wrote:
> > Then, any page that describes a sysctl, would add an MLINK to it:
> > MLINK+= xhci.4 hw.usb.xhci.debug.s
> >
> > This section would be added to the default search, and then users
> > would simply be able to type: man <sysctl> and get directed to the
> > page that has information about it.
> >
> > Any objections?

I'd oppose, it will clutter the filesystem for a "man -k" (or similar)
shortcut.

> Also, how do you document things like the dev hierarchy which has a unit
> number tossed into the middle?
> 
> dev.uhub.1.%parent: usbus1
> dev.uhub.1.%pnpinfo:

Device driver man pages (like ixl) tend to document a # instead of the
number. So this would be dev.uhub.#.%parent ... in the man page.
_______________________________________________
[email protected] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-arch
To unsubscribe, send any mail to "[email protected]"
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.