Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 9 Apr 2021 22:19:58 -0600
From:      Warner Losh <imp@bsdimp.com>
To:        Graham Perrin <grahamperrin@gmail.com>
Cc:        FreeBSD CURRENT <freebsd-current@freebsd.org>,  FreeBSD questions <freebsd-questions@freebsd.org>
Subject:   Re: Git-oriented and other documentation
Message-ID:  <CANCZdfod6qfNq-8icNDBoRfLb-ZCJ0e-J%2BrDOVGQ-Zr%2BqtwUBw@mail.gmail.com>
In-Reply-To: <9bc85f7a-414c-29d4-7762-6d4b90ef35a6@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>

next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, Apr 9, 2021 at 9:43 PM Graham Perrin <grahamperrin@gmail.com> wrote:

> On 10/04/2021 00:16, Kevin Oberman wrote:
>
>  > The updated mini-Git Primer is now included in the Developer's
> Handbook. See Chapter 5.
>
> Thanks!
>
> <https://docs.freebsd.org/en/articles/committers-guide/#git-primer>;
>
> There's a slight discrepancy between
> <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>; (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
> >
>

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.



>
> <
> https://docs.freebsd.org/en/books/developers-handbook/book.html#vendor-import-svn>;
>
> (FreeBSD Developers' Handbook, 2021-01-12) there's some
> Subversion-related content in chapter five.
>

Yea, this chapter has been removed. Subversion is no longer relevant to
FreeBSD developers committing to the FreeBSD repo.


> <https://docs.freebsd.org/en/>; lacks a sidebar and currently refers to
> what appears to be an older edition of the FreeBSD Developers' Handbook:
> <https://docs.freebsd.org/en/books/developers-handbook/>; (2020-06-15,
> revision 54255 with reference to
> <https://cgit.freebsd.org/doc/commit/?id=>; (bad link)).
>

I'll defer to others on this and following ones.

Warner


> <https://docs.freebsd.org/en/>; is also mistakenly self-referencing when
> attempting to reach the FreeBSD home page (either click 'Home', or the
> FreeBSD icon).
>
> <https://www.freebsd.org/docs/>; includes a sidebar.
>



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CANCZdfod6qfNq-8icNDBoRfLb-ZCJ0e-J%2BrDOVGQ-Zr%2BqtwUBw>