From owner-freebsd-questions@freebsd.org Sat Apr 10 07:40:52 2021 Return-Path: Delivered-To: freebsd-questions@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 2A9315CBCB2 for ; Sat, 10 Apr 2021 07:40:52 +0000 (UTC) (envelope-from grahamperrin@gmail.com) Received: from mail-wr1-x42b.google.com (mail-wr1-x42b.google.com [IPv6:2a00:1450:4864:20::42b]) (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 4FHRkW3Ygpz4dv0 for ; Sat, 10 Apr 2021 07:40:51 +0000 (UTC) (envelope-from grahamperrin@gmail.com) Received: by mail-wr1-x42b.google.com with SMTP id d11so3805177wro.13 for ; Sat, 10 Apr 2021 00:40:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language; bh=NXsOj+IydO1ZehMQ165r8p3V6l1CSoxqb4XoIrV/3q4=; b=dz4O0ce6OmzVuNLg0SRfFtqw1sXkA0YTnUEuXPlqImreUbeEvLbyriDJji3UA+vQqt f4iTDWx9T3Olq/sX8ZS8Xp9ryIqYqEkluABiNtJUOfesN7aEp5/Ya4vgBBP0tKv1pDQS E0pDkRq7UT4kFDf3oMiDtKxx2Yr1vb4l8c435lNgpEfRPZoqXyZFoIzx4mRZQCQhvv3i QZ96+nkf7EeAIlG6ygWzTj7+8d+MUdw7MWJQZhKIpFvrP8vken6AYEnIcLiRI6ZGM6DU 7MU2L8ISaUsD0UxIHh7cqY0fWsKCi2B+Mh3BIcLD67QJt3U/20q7vZ73BZRwwAWc3eRK vgfQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language; bh=NXsOj+IydO1ZehMQ165r8p3V6l1CSoxqb4XoIrV/3q4=; b=J+t26FINTuhijwTEV0MYflUIKH+xVVqt+MjX00rV/46mOckzLrmFAVPwiSzZvmo7Iv MRR90a50TuUXAACAiQFqL0tyEkq5sHUOE3ALGuLz72CQn3FT9HjjyC8zBND5NcGVXtxY Q6AZIGDULfN5z3wRm2JUbNcVud5bhdhyPDvzPFvQyF6q5lmagwXNPE69RMwpVCkXTF4V wL9YfT4DkgHIcRYxPPgWS57nG8UeZF7ebfQyANelSXtfrZKG+reojKewg8Th5mUuD5w/ +/BbwjrHTaoM7z/mbnANJBfkNm/6Itp/6P8y7xP90FbxNKSCviUXol6ilmwO1TY89I5N ELoA== X-Gm-Message-State: AOAM533cjd9fcifUEROU0m2RmMtdZMi1e9v6eYCZlvuV4xeFeX2ZkDH0 tPz4kvvV3+Ve/f1dASTorJo= X-Google-Smtp-Source: ABdhPJzHWx2Meq3DnGWISMBUia4JlCt4dg7kT0+i8LQtuwZ6ql4hylWc7wffY2TSE4Hx0gAIuoSsaQ== X-Received: by 2002:a5d:55d2:: with SMTP id i18mr12353917wrw.280.1618040450071; Sat, 10 Apr 2021 00:40:50 -0700 (PDT) Received: from [192.168.1.13] (88-105-96-80.dynamic.dsl.as9105.com. [88.105.96.80]) by smtp.gmail.com with ESMTPSA id y31sm7236242wmp.46.2021.04.10.00.40.49 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 10 Apr 2021 00:40:49 -0700 (PDT) Subject: Git-oriented and other documentation To: FreeBSD questions Cc: Warner Losh References: <20210228023827.f68e6136d688c0a37206c883@3dresearch.com> <20210228120313.cdb53cab429a38fdf9817d0d@3dresearch.com> <20210301020830.5466d368867bdbc11b0b7648@3dresearch.com> <00517bca-fc1b-fcea-50a2-6469ff922092@gmail.com> <9bc85f7a-414c-29d4-7762-6d4b90ef35a6@gmail.com> From: Graham Perrin Message-ID: <3f8dbb60-e92d-74ba-f4d8-ee07f49ae1e0@gmail.com> Date: Sat, 10 Apr 2021 08:40:49 +0100 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.9.0 MIME-Version: 1.0 In-Reply-To: Content-Language: en-GB X-Rspamd-Queue-Id: 4FHRkW3Ygpz4dv0 X-Spamd-Bar: - Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20161025 header.b=dz4O0ce6; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (mx1.freebsd.org: domain of grahamperrin@gmail.com designates 2a00:1450:4864:20::42b as permitted sender) smtp.mailfrom=grahamperrin@gmail.com X-Spamd-Result: default: False [-1.00 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; FREEMAIL_FROM(0.00)[gmail.com]; R_SPF_ALLOW(-0.20)[+ip6:2a00:1450:4000::/36]; URI_COUNT_ODD(1.00)[9]; 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]; NEURAL_HAM_SHORT(-1.00)[-1.000]; RECEIVED_SPAMHAUS_PBL(0.00)[88.105.96.80:received]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+,1:+,2:~]; FREEMAIL_ENVFROM(0.00)[gmail.com]; MID_RHS_MATCH_FROM(0.00)[]; RBL_DBL_DONT_QUERY_IPS(0.00)[2a00:1450:4864:20::42b:from]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20161025]; FROM_HAS_DN(0.00)[]; DWL_DNSWL_NONE(0.00)[gmail.com:dkim]; MIME_GOOD(-0.10)[multipart/alternative,text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-questions@freebsd.org]; SPAMHAUS_ZRD(0.00)[2a00:1450:4864:20::42b:from:127.0.2.255]; TO_MATCH_ENVRCPT_SOME(0.00)[]; NEURAL_SPAM_LONG(1.00)[1.000]; RCVD_IN_DNSWL_NONE(0.00)[2a00:1450:4864:20::42b:from]; RCVD_TLS_ALL(0.00)[]; MAILMAN_DEST(0.00)[freebsd-questions] Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit X-Content-Filtered-By: Mailman/MimeDel 2.1.34 X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 10 Apr 2021 07:40:52 -0000 (Dropping freebsd-current from the list of addressees at this point …) On 10/04/2021 05:19, Warner Losh wrote: > On Fri, Apr 9, 2021 at 9:43 PM Graham Perrin > wrote: > > … There's a slight discrepancy between > > > > (Committer's Guide, undated) exemplifying '-o freebsd' and > > > (FreeBSD > Handbook, undated) without the option in at least one example. > > -o , --origin was recently discussed under > > > > > Yes. The examples in mirrors were written and copied from elsewhere > about the same time I decided to make all examples use  -o freebsd. I > missed these. I'm about  to push a fix. Thanks, Warner. ---- Incidentally (for people with an interest in documentation) I spent around half an hour trying to understand how I had found my way to a mirror of the handbook. I didn't recall being there as a result of a Google search. Eventually I realised: * /mirrors/ is used for Appendix A, which is about much more than mirrors; and * official mirrors a subsection of Appendix D, with mirrors nowhere in the URL. ---- At in lieu of the word 'Appendix' four times, there should be: A. … B. … C. … D. … ---- lacks a link to the glossary. I stumbled into the glossary by clicking 'Next' at the foot of .