From nobody Fri Dec 31 21:26:40 2021 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 98C53192452B for ; Fri, 31 Dec 2021 21:26:50 +0000 (UTC) (envelope-from grahamperrin@gmail.com) Received: from mail-wm1-x336.google.com (mail-wm1-x336.google.com [IPv6:2a00:1450:4864:20::336]) (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 4JQdWF5V1Zz4YpV for ; Fri, 31 Dec 2021 21:26:49 +0000 (UTC) (envelope-from grahamperrin@gmail.com) Received: by mail-wm1-x336.google.com with SMTP id b73so17908293wmd.0 for ; Fri, 31 Dec 2021 13:26:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=message-id:date:mime-version:user-agent:subject:content-language:to :references:from:in-reply-to:content-transfer-encoding; bh=F96iO978DffqQ6sCx87leEUAOFUIiiue6F0UltWWDTY=; b=ju32UEb7UQqxFfS2b8efbXXnRIlJLECI9citYFWBfszNbcfA/X57AtZ3D8gPGoWkpU xyzOAgcsEaMO1JI3Hhgf054wiBwvJQuqgk2/U0hlBv3/HytLDXQ0GxnqUs498MkgQ8xV 35mZIZ4E65UTNgoQNHeuiwLB6xi0fTWhna9NanFuk0wJLNETmrELnzVZ+mYinGSLOyRP 2B2bZV0GicBV3SUR/87a47gceHWXQ+pf9chuE35+vHvYW1bmhky11KcXAm9q2Fv7+Tlb qOH7AKFyb2CoTp2cl358GFqSAhEi2KtqjHYp2Yk3MkJ/Jo1QN10/Bl+8ZRZYfNEbr2ss piyQ== 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:subject :content-language:to:references:from:in-reply-to :content-transfer-encoding; bh=F96iO978DffqQ6sCx87leEUAOFUIiiue6F0UltWWDTY=; b=apLiXvQPITrIsk+Fq+3eCGJqbXAgYIknmA/DjlohIG6yejm8b1WI1tTmYljaU27Yqd c1UwTk3YJgGJF93t5ap4XrV4D/w9UQsWV6UReLLltG80u9SUzEP5ymFVGYQktt3cf2zl jmHAcm0Jh3cOuOcG/rHgA5qj0G3HNCgpwwOOb8ubVJnkZZZdTpMnjMu3zq5koCDNJMCD yuccJnHlHR18sT2XcaT9lmRKOVq6wJ5ObVkqF54d59kBur08c5lcfjP16AirMX0r71Hr ayjhdsi99xqW1Icc2UVyo000Wxm4G8WCtoF4AJB5herVOs9hjHnh5PM09KcNi1RmayRF ltSA== X-Gm-Message-State: AOAM531dTIVrbnZ/iIZW/Ls1MTwHskseZp4AGqT7avV9RJ7uw6BBpNtp 1KNefhfIRaTkPPQKTmS3oleBTrQh6Y0= X-Google-Smtp-Source: ABdhPJyP5n7xDkQ/43zK0EHPFPu6aYH0SHRQLCi0py+A2BL10CmrjcEozlSVIguhVbWAdJSIPsffww== X-Received: by 2002:a05:600c:1e8b:: with SMTP id be11mr31309260wmb.125.1640986001895; Fri, 31 Dec 2021 13:26:41 -0800 (PST) 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 s1sm29563069wmh.35.2021.12.31.13.26.41 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 31 Dec 2021 13:26:41 -0800 (PST) Message-ID: <73b58ccc-62e6-3a88-3b60-7ca8c75c0078@gmail.com> Date: Fri, 31 Dec 2021 21:26:40 +0000 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.4.1 Subject: Re: The 2000s called. They want their intro(8) back. Content-Language: en-GB To: freebsd-doc@freebsd.org References: <9c8a75538b435638c3e67558ee84d519@gundo.com> From: Graham Perrin In-Reply-To: <9c8a75538b435638c3e67558ee84d519@gundo.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 4JQdWF5V1Zz4YpV X-Spamd-Bar: / Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20210112 header.b=ju32UEb7; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (mx1.freebsd.org: domain of grahamperrin@gmail.com designates 2a00:1450:4864:20::336 as permitted sender) smtp.mailfrom=grahamperrin@gmail.com X-Spamd-Result: default: False [-0.09 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; FREEMAIL_FROM(0.00)[gmail.com]; R_SPF_ALLOW(-0.20)[+ip6:2a00:1450:4000::/36]; TO_DN_NONE(0.00)[]; RCVD_COUNT_THREE(0.00)[3]; DKIM_TRACE(0.00)[gmail.com:+]; DMARC_POLICY_ALLOW(-0.50)[gmail.com,none]; NEURAL_HAM_SHORT(-1.00)[-1.000]; 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]; MID_RHS_MATCH_FROM(0.00)[]; DWL_DNSWL_NONE(0.00)[gmail.com:dkim]; ARC_NA(0.00)[]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20210112]; FROM_HAS_DN(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-doc@freebsd.org]; NEURAL_SPAM_MEDIUM(0.92)[0.917]; RCPT_COUNT_ONE(0.00)[1]; NEURAL_SPAM_LONG(1.00)[0.996]; RCVD_IN_DNSWL_NONE(0.00)[2a00:1450:4864:20::336:from]; RCVD_TLS_ALL(0.00)[] X-ThisMailContainsUnwantedMimeParts: N On 31/12/2021 19:19, Pau Amma wrote: > … What else? history | grep "man "    provokes various thoughts. Without reference to that history, five come to mind immediately: efibootmgr(8) freebsd-update(8) tunefs(8) – two of which (sorry for going off-topic) do not belong in (8): zpoolconcepts(7) zfsconcepts(7) Plus, a mental note to add gitup or got or something to (8) without delay when, eventually, that thing becomes integral to the OS. Maybe also: bsdinstall(8) Avoid shortlisting too many commands? I'd juggle the page to have an alphabetical shortlist towards its foot. At the moment it's, like, two shortlists with a chunk of something introductory in the middle. ---- Incidentally, tunefs(8) is amongst the resources that mention soft update journaling without explanation. And there's that wedge of history in the FreeBSD Handbook that, if I'm not mistaken, explains everything except SUJ.