Date: Sun, 22 Mar 2020 21:52:06 +0000 From: Matthew Seaman <matthew@FreeBSD.org> To: svn-doc-all@freebsd.org Subject: Re: svn commit: r54009 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <0ce28833-6480-bead-f9d4-4595946ad663@FreeBSD.org> In-Reply-To: <202003221817.02MIHIMY074045@repo.freebsd.org> References: <202003221817.02MIHIMY074045@repo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --1E5Qgt3bCctmzVX3o2VTqS66fswfdDhwj Content-Type: multipart/mixed; boundary="gDSc6UXA8hRcGGegWum20eX6OadBEZ33Z" --gDSc6UXA8hRcGGegWum20eX6OadBEZ33Z Content-Type: text/plain; charset=utf-8 Content-Language: en-GB Content-Transfer-Encoding: quoted-printable 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 >=20 > Log: > Add a section about switching pkg from the quarterly branch > to the latest branch. > =20 > PR: 228333 > Submitted by: 0mp@ > Approved by: bcr@(mentor) > Differential Revision: https://reviews.freebsd.org/D24151 >=20 > Modified: > head/en_US.ISO8859-1/books/handbook/ports/chapter.xml >=20 > Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D > --- 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 (simila= r to > examples.</para> > </sect2> > =20 > + <sect2 xml:id=3D"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/l= ocal/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></scre= en> > + > + </sect2> > + > <sect2 xml:id=3D"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. --gDSc6UXA8hRcGGegWum20eX6OadBEZ33Z-- --1E5Qgt3bCctmzVX3o2VTqS66fswfdDhwj Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAEBCgB9FiEEGfFU7L8RLlBUTj8wAFE/EOCp5OcFAl533gZfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDE5 RjE1NEVDQkYxMTJFNTA1NDRFM0YzMDAwNTEzRjEwRTBBOUU0RTcACgkQAFE/EOCp 5OfWAA/+OnimmFm7Nd9v++is6iVKpDR+tB2fcwDTYERVkp4Lw2AjNFcb1TDF8H/c uXbM78tFApBdzrvEYaLoS9Quv5g6CmR8ND1YlBZRE/pkNzP3R785jmjP8Ibxow5S 0S6CtWjqG+pQ3CdhUDE65oDNclIso4eihiZkZ5a3NVBhoWkwb37NlXC0bFPzQrFb ExNgeKo2EgFWoMXrYEm5PsEvC3hlrMiqfyB3Q/A8q1Cqr6krjapPJGdTUGAlgblA ojtdzy92MujCJvnUCeBCgT3j575Ji+AcMFpSY9laAm/TQUuaHmwblhoPY/FEsQnu CxtopdT96c33ApFMo0exCyPfvLVflcxf8LjP0ryK3dST9D4qla1lmXNiYDq1voEt mkR3dGCpgLxtZTn69YwpQ0a08Aq6MsbpdwnHfakge0B3uzE6SHev4x4KNEpJLFHe 4dKtwmwKQ/N+zFHClg03feZuTq+WHqmDzIaojDcejlQqUiCBDUV2Vh8CpgSG9D9u 9qmxCG9HlqOSIC6HZQwm5nvO7/TS6kdXVjE0Krp6H2um/2USRVY2aELYG8TaZbE6 zSjNP/jHq32dq0f2ZRE5pzxUxActXO/XTBtlt9Ho+ZLlz8GXGCo5STWMXOusm1lC AYiLc5jNuN96k1Mi+IeWvC7NVa87T0QMenioSdDwXZJ3jx7I4GU= =vCeu -----END PGP SIGNATURE----- --1E5Qgt3bCctmzVX3o2VTqS66fswfdDhwj--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?0ce28833-6480-bead-f9d4-4595946ad663>