svn commit: r54009 - head/en_US.ISO8859-1/books/handbook/ports
Matthew Seaman
matthew at FreeBSD.org
Sun Mar 22 21:52:08 UTC 2020
On 22/03/2020 18:17, Sergio Carlavilla Delgado wrote:
> Author: carlavilla
> Date: Sun Mar 22 18:17:18 2020
> New Revision: 54009
> URL: https://svnweb.freebsd.org/changeset/doc/54009
>
> Log:
> Add a section about switching pkg from the quarterly branch
> to the latest branch.
>
> PR: 228333
> Submitted by: 0mp@
> Approved by: bcr@(mentor)
> Differential Revision: https://reviews.freebsd.org/D24151
>
> Modified:
> head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
>
> Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sun Mar 22 13:45:50 2020 (r54008)
> +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sun Mar 22 18:17:18 2020 (r54009)
> @@ -525,6 +525,51 @@ Info: Lists information about open files (similar to
> examples.</para>
> </sect2>
>
> + <sect2 xml:id="quarterly-latest-branch">
> + <title>Quarterly and Latest Ports Branches</title>
> +
> + <para>The <literal>Quarterly</literal> branch provides users
> + with a more predictable and stable experience for port and
> + package installation and upgrades. This is done essentially
> + by only allowing non-feature updates. Quarterly branches aim
> + to receive security fixes (that may be version updates, or
> + backports of commits), bug fixes and ports compliance or
> + framework changes. The Quarterly branch is cut from HEAD at
> + the beginning of every (yearly) quarter in January, April,
> + July, and October. Branches are named according to the year
> + (YYYY) and quarter (Q1-4) they are created in. For example,
> + the quarterly branch created in January 2016, is named 2016Q1.
> + And the <literal>Latest</literal> branch provides the latest
> + versions of the packages to the users.</para>
> +
> + <para>To switch from quarterly to latest run the following
> + commands:</para>
> +
> + <screen>&prompt.root; <userinput>cp /etc/pkg/FreeBSD.conf /usr/local/etc/pkg/repos/FreeBSD.conf</userinput></screen>
> +
> + <para>Edit the file
> + <filename>/usr/local/etc/pkg/repos/FreeBSD.conf</filename>
> + and change the string <emphasis>quarterly</emphasis> to
> + <emphasis>latest</emphasis> in the <literal>url:</literal>
> + line.</para>
> +
> + <para>The result should be similar to the following:</para>
> +
> + <programlisting>FreeBSD: {
> + url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest",
> + mirror_type: "srv",
> + signature_type: "fingerprints",
> + fingerprints: "/usr/share/keys/pkg",
> + enabled: yes
> +}</programlisting>
> +
> + <para>And finally run this command to update from the new
> + (latest) repository metadata.</para>
> +
> + <screen>&prompt.root; <userinput>pkg update -f</userinput></screen>
> +
> + </sect2>
> +
> <sect2 xml:id="pkgng-pkg-info">
> <title>Obtaining Information About Installed Packages</title>
Woah! That's overkill. All you need to do is create a file
/usr/local/etc/pkg/repos/FreeBSD.conf[*] with the one-line contents:
FreeBSD: { url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest" }
pkg(8) will merge this with /etc/pkg/FreeBSD.conf, only overwriting the
one parameter that needs to be changed.
Also, it would probably be a good idea to mention the use of 'pkg -vv'
to display what pkg(8)'s active configuration is.
Cheers,
Matthew
[*] Actually, the file name here is arbitrary so long as it matches
*.conf It's just a convention to call it after the repo name.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 963 bytes
Desc: OpenPGP digital signature
URL: <http://lists.freebsd.org/pipermail/svn-doc-all/attachments/20200322/073cc156/attachment.sig>
More information about the svn-doc-all
mailing list