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

[Sergio Carlavilla Delgado]

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>