From nobody Wed Apr 20 06:46:54 2022 X-Original-To: freebsd-doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id CF13011E593E; Wed, 20 Apr 2022 06:47:26 +0000 (UTC) (envelope-from grahamperrin@gmail.com) Received: from mail-wm1-x32d.google.com (mail-wm1-x32d.google.com [IPv6:2a00:1450:4864:20::32d]) (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 1D4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Kjrnp1RYmz576b; Wed, 20 Apr 2022 06:47:26 +0000 (UTC) (envelope-from grahamperrin@gmail.com) Received: by mail-wm1-x32d.google.com with SMTP id u17-20020a05600c211100b0038eaf4cdaaeso2994593wml.1; Tue, 19 Apr 2022 23:47:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=message-id:date:mime-version:user-agent:to:content-language:from :subject:content-transfer-encoding; bh=JNNWcLkx3Hx+XcEEy0R5docYWWPyjDV7vTLvH2xnOSA=; b=PRItr4CdK1xxIQMq+k5g7+oMEVRuNbqMqoZQflOgBFmzwSATU436ELCOLTCjZGUNZi 4xgs5wTHnuOO3u4oSiX+8PgVlp828m5lnp/dXooD24wr2eUtnZVBDIU0QSt7z6j0bO91 ZxmN3haXbVE+ihH46GK8MHXQaiubzv1DVWCIshGaRRODG/WurEUBbHqb8dJlZ3PQdrU8 J7qtqWtOu6MBewlW0BOV1rFzw+eRN1aOU4FZbiE6cvwGG2acSOIgz9fuVbeGZsuR0cXa yibwBjxU5cyPWujCr7yFcM8rloRR0XFa+PkMcnC3sgSuXWYPivTYJgQ4yb0rvinRW+Kl 3ymA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:date:mime-version:user-agent:to :content-language:from:subject:content-transfer-encoding; bh=JNNWcLkx3Hx+XcEEy0R5docYWWPyjDV7vTLvH2xnOSA=; b=Fz/vjTFh9Xv5eUgxUzB3coMDKC5GQF+OWYclWyfav7fVSShKcztbYgRFe0Qw1A/zKp wF1bU3VSU3jlsxW+8r0GiZzb0VLmhbtSYk61wXXTM79FKJjEtJ5uhsFUgHVQngk1OD4g Rpbvh49kJGaOMAGx7rOgOQ4lbdelhc4SVRzEol0iPQQP0yp459eqTq/8HNiiTKIAEY+F GcYlEr4D37+tJ3D6qEAfGdVFawy7ElXoG706gIBs2ZOHJ+yvhk1x52FaaPenqrdnnDv8 yq3Us69OFVx/+pnDNKRrJC1DuLIXhKCAPvb69nGAK6Mf4BVlZH6qNc8WSyIlX41c1dXm 3fyQ== X-Gm-Message-State: AOAM533PegJoG6Z17+MB4buKyRu1fvh3m8Te6eq3n4zgH8ZbtRi1lqRm jCItcXDHlQJ33FpOpZhEJbkYMReqjgnoyg== X-Google-Smtp-Source: ABdhPJzwR+P65yEZnTkPG3V4U3kikanaHYePLBUjnB2eYRQrNf0A2u3t4kseRp+3ldmvsFAmGRHW2Q== X-Received: by 2002:a05:600c:1f17:b0:392:5c1a:5ed9 with SMTP id bd23-20020a05600c1f1700b003925c1a5ed9mr2183158wmb.148.1650437238892; Tue, 19 Apr 2022 23:47:18 -0700 (PDT) Received: from ?IPV6:2001:470:1f1c:a0::2? (tunnel642390-pt.tunnel.tserv1.lon2.ipv6.he.net. [2001:470:1f1c:a0::2]) by smtp.gmail.com with ESMTPSA id e9-20020a056000178900b0020a9f995a3csm5074060wrg.24.2022.04.19.23.47.18 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 19 Apr 2022 23:47:18 -0700 (PDT) Message-ID: <3755196b-8803-ff72-364e-6b3b067f9702@gmail.com> Date: Wed, 20 Apr 2022 07:46:54 +0100 List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:91.0) Gecko/20100101 Thunderbird/91.8.1 To: FreeBSD questions , FreeBSD documentation project Content-Language: en-GB From: Graham Perrin Subject: Conventions for FreeBSD manual pages Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 4Kjrnp1RYmz576b X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20210112 header.b=PRItr4Cd; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (mx1.freebsd.org: domain of grahamperrin@gmail.com designates 2a00:1450:4864:20::32d as permitted sender) smtp.mailfrom=grahamperrin@gmail.com X-Spamd-Result: default: False [-3.64 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; ARC_NA(0.00)[]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20210112]; NEURAL_HAM_MEDIUM(-0.96)[-0.958]; FROM_HAS_DN(0.00)[]; FREEMAIL_FROM(0.00)[gmail.com]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; R_SPF_ALLOW(-0.20)[+ip6:2a00:1450:4000::/36]; NEURAL_HAM_LONG(-0.68)[-0.685]; RCVD_COUNT_THREE(0.00)[3]; TO_DN_ALL(0.00)[]; DKIM_TRACE(0.00)[gmail.com:+]; RCPT_COUNT_TWO(0.00)[2]; DMARC_POLICY_ALLOW(-0.50)[gmail.com,none]; RCVD_IN_DNSWL_NONE(0.00)[2a00:1450:4864:20::32d:from]; MLMMJ_DEST(0.00)[freebsd-questions,freebsd-doc]; NEURAL_HAM_SHORT(-1.00)[-0.997]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[]; DWL_DNSWL_NONE(0.00)[gmail.com:dkim] X-ThisMailContainsUnwantedMimeParts: N Please: does FreeBSD have anything like the Linux manual page for conventions? I can't find one. Background ========== For years, I assumed that SEE ALSO sections were disorderly. For example: * expecting a–z (alphabetical order) * finding ne, sy, se, at et cetera (disorderly) under Today I discovered that there is, at least for Linux, a convention to sort: * first, by the section number (secondary) * second, by the name of the page, which appears first. I do see some logic to this, however – without first knowing the convention – I never found it helpful. The apparent disorder was unhelpful. Whenever I look for a named thing, in a long string of names, with the intention of clicking (a link): I expect alphabetical order, by name.