Changeset b15261a for README.BLFS

Timestamp:

08/12/2017 01:03:06 PM (7 years ago)

Author:

Pierre Labastie <pierre@…>

Branches:

ablfs-more, legacy, trunk

Children:

ce244f6

Parents:

6d1d77c

Message:

Update documentation for LFS inclusion in BLFS tools.

File:

• README.BLFS (modified) (7 diffs)

README.BLFS

@@ -14 +14 @@
   you will need to review and edit the scripts while reading the book.
 
+     Since version 3.0 of jhalfs, the blfs tools allow also to update packages
+  from the LFS book. LFS packages which may be updated appear in the menu
+  interface. When selected, their scriptlet is generated in the same manner
+  as for BLFS packages.
 
 2. PREREQUISITES::
@@ -65 +69 @@
       their being present.
 
+    - In this case, the tool has no way to know which version of LFS packages
+      is installed, so that the menu interface will show all the LFS packages,
+      as if they were not installed. If you have a released version of LFS, or
+      the date of your SVN version of LFS is known, you should run the
+      update-lfs.sh script. If you have updated some
+      LFS packages since first installation, or have been using a custom
+      working copy of the LFS book, the only (tedious) way is to create
+      empty files with names <package>-<installed-version> in the tracking
+      directory, and run the tool.
+
+    - If you have also installed some BLFS packages, they are not in the
+      tracking file. The only way is to create empty files with names
+      <package>-<installed-version> in the tracking directory, and run the tool.
+
   3.2 INSTALLATION ON A JUST BUILT xLFS SYSTEM
 
@@ -94 +112 @@
       above
 
+    - Note that the versions of LFS packages are automatically known to
+      the tool in this case, and there is no need to run the update-lfs.sh
+      script.
+
      We assume that the BLFS tools will be used on a booted xLFS system.
   Using them to build BLFS packages in a chroot jail is also possible,
@@ -101 +123 @@
 
     blfs-xml/*              SVN tree of the selected BLFS book version
+    lfs-xml/*               SVN tree of the selected LFS book version
     lib/constants.inc       functions libraries 
        /func_dependencies     for building the dependency tree
@@ -110 +133 @@
                             of a package
        /make_book.xsl       XSL stylesheet to generate the linear book.xml
+       /lfs_make_book.xsl   XSL stylesheet to incoporate LFS pages into the
+                            linear book.xml
        /scripts.xsl         XSL stylesheet to generate the scriptlets from
                             book.xml
@@ -128 +153 @@
     envars.conf             envars needed when running the target build scripts
 
-    Working files: several files are generated when first running the tool
+Working files: several files are generated when first running the tool
 
     packages.xml            auto-generated packages database
@@ -236 +261 @@
     just need to create a "064-y-bar" build script.
 
-      Remember, the package tracking system isn't a package management tool
+       Remember, the package tracking system isn't a package management tool
     and knows nothing about packages not in the BLFS book.
 
-      Also, review and edit envars.conf. This file is used to set global envars
-    needed by the build scripts.
+       IMPORTANT: Review and edit envars.conf, at least after installing the
+    tool. This file is used to set global envars needed by the build scripts.
+    If you use package management, the variable PACK_INSTALL should point to
+    where the packInstall.sh script resides.
 
   4.4  CREATING THE MAKEFILE::