Skip site navigation (1)Skip section navigation (2)
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>