Changeset 6ad6bac

Timestamp:

01/06/2023 12:41:33 AM (16 months ago)

Author:

Ken Moffat <ken@…>

Branches:

11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

6a6d01e

Parents:

06c23e6

Message:

Expand gentoo details in Going Beyond BLFS.

Location:

introduction

Files:

• important/beyond.xml (modified) (1 diff)
• welcome/changelog.xml (modified) (1 diff)

introduction/important/beyond.xml

@@ -165 +165 @@
         </listitem>
         <listitem>
-          <para>Gentoo - the mirrors for ebuilds and patches seem to be well-hidden,
-          and they change frequently.  Also, if you have found a mirror, you need to
-          know which directory the application has been assigned to.  The ebuilds
-          themselves can be found at <ulink url="https://packages.gentoo.org/"/> -
-          use the search field.  If there are any patches, a mirror will have them
-          in the <filename class="directory">files/</filename> directory. Depending
-          on your browser, or the mirror, you might need to download the ebuild to
-          be able to read it.  Treat the ebuild as a sort of pseudo-code / shell
-          combination - look in particular for <command>sed</command> commands and
-          patches, or hazard a guess at the meanings of the functions such as
-          <command>dodoc</command>.</para>
+          <para>Gentoo - First use a search engine to find an ebuild which looks as
+          if it will fix the problem, or search at <ulink
+          url="https://packages.gentoo.org/"/> - use the search field. Note where the
+          package lives in the portage hierarchy, e.g.
+          <filename>app-something/</filename>. In general you can treat the ebuild as
+          a sort of pseudo-code / shell combination with some functions you can
+          hazard a guess at, such as <command>dodoc</command>. If the fix is just a
+          <command>sed</command>, try it. However, in most cases the fix will use a
+          patch. To find the patch, use a gentoo-portage mirror: Two links to mirrors
+          in the U.S.A. which seem to usually be up to date are
+          <ulink url="https://mirror.rackspace.com/gentoo-portage/"/> and
+          <ulink url="https://mirror.steadfast.net/gentoo-portage/"/>. Navigate down
+          the tree to the package, then to the <filename>files/</filename> directory
+          to look for the patch. Sometimes a portage mirror has not yet been updated,
+          particularly for a recent new patch. In a few cases, gentoo batch the
+          patches into a tarball and the ebuild will have a link in the form
+          https://dev.gentoo.org/~${PATCH_DEV}/distfiles/${P}-patches-${PATCH_VER}.tar.xz
+          : here, look for PATCH_DEV and PATCH_VER in the build and format the full
+          URL in your browser or for wget : remember the '~' before the developer's
+          ID and note that trying to search the earlier levels of the URL in a
+          browser may drop you at www.gentoo.org or return 403 (forbidden).
+          </para>
         </listitem>
         <listitem>

introduction/welcome/changelog.xml

@@ -40 +40 @@
     -->
     <listitem>
+      <para>January 5th, 2023</para>
+      <itemizedlist>
+        <listitem>
+          <para>[ken] - Expand the gentoo details in 'Going Beyond BLFS'. Fixes
+          <ulink url="&blfs-ticket-root;17004">#17004</ulink>.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>January 4th, 2023</para>
       <itemizedlist>