Re: svn commit: r54009 - head/en_US.ISO8859-1/books/handbook/ports

Matthew Seaman <[email protected]> Sun, 22 Mar 2020 21:52:06 +0000
Newsgroups	gmane.os.freebsd.devel.cvs.doc
Message-ID	<[email protected]>
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.
signature.asc (application/pgp-signature, 963 B)