Date: Sat, 10 Apr 2021 08:40:49 +0100 From: Graham Perrin <grahamperrin@gmail.com> To: FreeBSD questions <freebsd-questions@freebsd.org> Cc: Warner Losh <imp@bsdimp.com> Subject: Git-oriented and other documentation Message-ID: <3f8dbb60-e92d-74ba-f4d8-ee07f49ae1e0@gmail.com> In-Reply-To: <CANCZdfod6qfNq-8icNDBoRfLb-ZCJ0e-J%2BrDOVGQ-Zr%2BqtwUBw@mail.gmail.com> References: <20210228023827.f68e6136d688c0a37206c883@3dresearch.com> <CAHu1Y73iJi=A9vwzOWM90zb2uD1pU9VZfwRJLdeZ6AhRF0nb9A@mail.gmail.com> <20210228120313.cdb53cab429a38fdf9817d0d@3dresearch.com> <CAHu1Y70DCR4z8D85ixc2z2GwwY%2BhsK263QsJuq--BQCmByA9GA@mail.gmail.com> <20210301020830.5466d368867bdbc11b0b7648@3dresearch.com> <CAHu1Y73cnWZij52c6_pKHZJiheHZE4wYsYf51sHZq7YGZuTYew@mail.gmail.com> <CAN6yY1uL8Ri3070SJ=dR5AVeG8qgxx5_SUxjdriNE-KWQkqsEQ@mail.gmail.com> <00517bca-fc1b-fcea-50a2-6469ff922092@gmail.com> <c16851a0-accd-9d98-7155-a988e80db532@gmail.com> <CAN6yY1t%2Buew=oReQ2TnM1t0JDjngtrK2rVvbZNaM6S04KTQ3RA@mail.gmail.com> <9bc85f7a-414c-29d4-7762-6d4b90ef35a6@gmail.com> <CANCZdfod6qfNq-8icNDBoRfLb-ZCJ0e-J%2BrDOVGQ-Zr%2BqtwUBw@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
(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 <grahamperrin@gmail.com > <mailto:grahamperrin@gmail.com>> wrote: > > … There's a slight discrepancy between > <https://docs.freebsd.org/en/articles/committers-guide/#_shallow_clone > <https://docs.freebsd.org/en/articles/committers-guide/#_shallow_clone>>; > > (Committer's Guide, undated) exemplifying '-o freebsd' and > <https://docs.freebsd.org/en/books/handbook/mirrors/#git-usage > <https://docs.freebsd.org/en/books/handbook/mirrors/#git-usage>>; > (FreeBSD > Handbook, undated) without the option in at least one example. > > -o <name>, --origin <name> was recently discussed under > <https://forums.FreeBSD.org/threads/ports-transitioned-to-git.79598/post-504699 > <https://forums.FreeBSD.org/threads/ports-transitioned-to-git.79598/post-504699>>; > > > 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 <https://docs.freebsd.org/en/books/handbook/partv/>; in lieu of the word 'Appendix' four times, there should be: A. … B. … C. … D. … ---- <https://docs.freebsd.org/en/books/handbook/>; lacks a link to the glossary. I stumbled into the glossary by clicking 'Next' at the foot of <https://docs.freebsd.org/en/books/handbook/pgpkeys/>.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3f8dbb60-e92d-74ba-f4d8-ee07f49ae1e0>