From owner-freebsd-arch@freebsd.org Thu Feb 11 15:51:37 2021 Return-Path: Delivered-To: freebsd-arch@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id F406D52C89D for ; Thu, 11 Feb 2021 15:51:36 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: from mailman.nyi.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id 4Dc1MX5MbFz4RqZ for ; Thu, 11 Feb 2021 15:51:36 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: by mailman.nyi.freebsd.org (Postfix) id B820752C763; Thu, 11 Feb 2021 15:51:36 +0000 (UTC) Delivered-To: arch@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B7E8E52C7BD for ; Thu, 11 Feb 2021 15:51:36 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: from mail-qt1-x833.google.com (mail-qt1-x833.google.com [IPv6:2607:f8b0:4864:20::833]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Dc1MX4hPTz4RqY for ; Thu, 11 Feb 2021 15:51:36 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: by mail-qt1-x833.google.com with SMTP id w20so4481777qta.0 for ; Thu, 11 Feb 2021 07:51:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bsdimp-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=qA4OWrQMEFpfcYXlrQMjzDVtKfH1POXdtl392ZowftY=; b=XzsZKLX/g6ueqcUyCFahjoaPhbz5mAz754ZtSmbm4atnAQuiE+wYMfG8V5xP3UTkeW Wbj+oxM2i5/MvYIlUVpqmOkdbB5BHW25nGmiO5mBU2Gs+QRnLQMHrfSFfOy6YaWAcidU 0rvM4fcYWMXJuddubCyL4UdQJXtru6hIfGYZi9Ks5yCLghBpA3HWyAZs9TYAw+EHWpuL qIC7ddY1ILCf/BImXwrVrvx9vCxvMH9mBk6dHUQYqz37s8JfsZM2ZQyd/R918VzleMeb 9bw8/YwXvEbV3DyQcbEKqyBbImLFItZj26zAVNp0uNc0cKUKddJvAauym1iPqVp6CPUv UazA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=qA4OWrQMEFpfcYXlrQMjzDVtKfH1POXdtl392ZowftY=; b=NgE0XdAEWs0gqaF5F3FShv5GNspvKt7IH3CmZMyMn0aCC4dTNodVBlYWkzgSeLoTpO VXqMgNi6g1oiCSz7i7BJtcMWuk+PTZbhYZx53ZAbXxbH6JHxnIZ3M+eJC+kZbBOtcuvJ Ug5mVmVWPyHJCTL4hMsw3oprdL2LAcKVg5ARcjVFF/iQ7gYsAVEDRZ/H3XswYjmBxHlK HjQUJS/ia5L7IVK7RSBoxTu3NEuXbPUm1z6fqJG71tO2TML1LANDPyyCh5Eda+rzc3Br qViF9am0ApTtpBeAeQUkNb1aA42K5Al1MaWxnTIZI2GSq5NPUbcGsiROgAcY2ELkU4X2 JglQ== X-Gm-Message-State: AOAM533eJil5tEyxRLv4A2strJAcT+GvV4l9dI54Dt3/vmaJhr2iS9bV A6RIhXuBFKF+c6AmrtVcy4XTae5H3EMJcY5BAngZgPoYXyE= X-Google-Smtp-Source: ABdhPJwV3kHANxZFpiltPGUuK7ZSOGe6Ot/e7/xoPYJI9AmsSFD6Zd8Wik9/8sMTubnXs3UX/0q24+K0uOF558cX2NE= X-Received: by 2002:a05:622a:303:: with SMTP id q3mr7810756qtw.235.1613058695502; Thu, 11 Feb 2021 07:51:35 -0800 (PST) MIME-Version: 1.0 References: <20210211001505.GF31099@funkthat.com> <20210211075456.GA7928@belenus.iks-jena.de> In-Reply-To: <20210211075456.GA7928@belenus.iks-jena.de> From: Warner Losh Date: Thu, 11 Feb 2021 08:51:23 -0700 Message-ID: Subject: Re: adding a sysctl man section To: Lutz Donnerhacke Cc: "freebsd-arch@freebsd.org" X-Rspamd-Queue-Id: 4Dc1MX4hPTz4RqY X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.34 X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Feb 2021 15:51:37 -0000 On Thu, Feb 11, 2021, 12:55 AM Lutz Donnerhacke 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 > 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 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 >