Re: adding a sysctl man section
Warner Losh <[email protected]>
| Newsgroups | gmane.os.freebsd.architechture |
|---|---|
| Message-ID | <CANCZdfoEmRSrFuXZWsPAd2G9WMGCLegXM4ywSMe3dZHBrLR+2g@mail.gmail.com> |
On Thu, Feb 11, 2021, 12:55 AM Lutz Donnerhacke <[email protected]> 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 <[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. > That part is easy. The symlink is what I worry about. Warner > _______________________________________________ [email protected] mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-arch To unsubscribe, send any mail to "[email protected]"