adding a sysctl man section

[Warner Losh]

On Thu, Feb 11, 2021, 12:55 AM Lutz Donnerhacke <lutz at donnerhacke.de> wrote:

> 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 <jmg at funkthat.com>
> 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.
>

That part is easy. The symlink is what I worry about.

Warner

>