zeroday0619/MahiroOS-jhalfs
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Update documentation for LFS inclusion in BLFS tools.

Browse source
This commit is contained in:
Pierre Labastie 2017-08-12 13:03:06 +00:00
parent 6d1d77c1e8
commit b15261a649
2 changed files with 38 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
README
View file

@ -236,12 +236,12 @@ $Id$
7. FAQ:: 7. FAQ::
Q. "It doesn't work" Q. "It doesn't work"
A. There are several reasons why it may be so. One possibility is the A. There are several reasons why it may be so. One possibility is the
following:jhalfs was designed to work against the development versions following: jhalfs was designed to work against the development versions
of the LFS series of books. Consequently changes in a book(s) sometimes of the LFS series of books. Consequently changes in a book sometimes
breaks older versions of jhalfs. Before you start pulling out your hair break older versions of jhalfs. Before you start pulling out your hair,
download the latest version of jhalfs to see if that solves your download the latest version of jhalfs to see if that solves your
problem. Note that it may be the other way around. If you want to build problem. Note that it may be the other way around. If you want to build
an old version of the book, you may have to downgrade you jahlfs an old version of the book, you may have to downgrade your jhalfs
version. version.
Q. "How do I specify the build location?" Q. "How do I specify the build location?"
@ -263,10 +263,10 @@ $Id$
Q. "What is the function of the SRC_ARCHIVE variable?" Q. "What is the function of the SRC_ARCHIVE variable?"
A. When jhalfs runs and packages download was selected, it creates a local A. When jhalfs runs and packages download was selected, it creates a local
copy of the necessary packages in BUILDDIR/sources by downloading the copy of the necessary packages in $BUILDDIR/sources by downloading the
files. If the variable SRC_ARCHIVE is defined the software will first files. If the variable SRC_ARCHIVE is defined the software will first
look in this location for the file and, if found, will copy it to look in this location for the file and, if found, will copy it to
BUILDDIR/sources. $BUILDDIR/sources.
If the files are not found in SRC_ARCHIVE _and_ you have write priv to If the files are not found in SRC_ARCHIVE _and_ you have write priv to
the directory any downloaded files will be mirrored there. the directory any downloaded files will be mirrored there.
@ -293,7 +293,7 @@ $Id$
These variables are adjustable also when invoking make: These variables are adjustable also when invoking make:
$BUILDDIR make LUSER=myaccount LGROUP=mygroup cd $BUILDDIR; make LUSER=myaccount LGROUP=mygroup
The only changes to your account will be the creation of a NEW .bashrc The only changes to your account will be the creation of a NEW .bashrc
after saving your original to .bashrc.XXX after saving your original to .bashrc.XXX

35
README.BLFS
View file

@ -13,6 +13,10 @@ $Id$
build scripts and Makefile will work "as is", thus, as a general rule, build scripts and Makefile will work "as is", thus, as a general rule,
you will need to review and edit the scripts while reading the book. 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:: 2. PREREQUISITES::
@ -64,6 +68,20 @@ $Id$
Issues' of the BLFS book), as some instructions in BLFS rely on Issues' of the BLFS book), as some instructions in BLFS rely on
their being present. 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 3.2 INSTALLATION ON A JUST BUILT xLFS SYSTEM
For books that support it (only LFS for jhalfs version 2.4), For books that support it (only LFS for jhalfs version 2.4),
@ -93,6 +111,10 @@ $Id$
- Configure sudo and add the bash shell startup files, as described - Configure sudo and add the bash shell startup files, as described
above 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. 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, Using them to build BLFS packages in a chroot jail is also possible,
but not supported. but not supported.
@ -100,6 +122,7 @@ $Id$
3.3 DIRECTORY LAYOUT IN THE $BLFS_ROOT DIRECTORY 3.3 DIRECTORY LAYOUT IN THE $BLFS_ROOT DIRECTORY
blfs-xml/* SVN tree of the selected BLFS book version 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 lib/constants.inc functions libraries
/func_dependencies for building the dependency tree /func_dependencies for building the dependency tree
menu/* lxdialog and menuconfig source code menu/* lxdialog and menuconfig source code
@ -109,6 +132,8 @@ $Id$
/dependencies.xsl XSL stylesheet to generate the dependency list /dependencies.xsl XSL stylesheet to generate the dependency list
of a package of a package
/make_book.xsl XSL stylesheet to generate the linear book.xml /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 /scripts.xsl XSL stylesheet to generate the scriptlets from
book.xml book.xml
/bump.xsl XSL stylesheet to update the tracking file /bump.xsl XSL stylesheet to update the tracking file
@ -127,7 +152,7 @@ $Id$
database and the tracking file. database and the tracking file.
envars.conf envars needed when running the target build scripts 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 packages.xml auto-generated packages database
Config.in input file for the menu driven choices Config.in input file for the menu driven choices
@ -235,11 +260,13 @@ $Id$
"bar" before "foo" package and the "foo" script is named "064-z-foo", you "bar" before "foo" package and the "foo" script is named "064-z-foo", you
just need to create a "064-y-bar" build script. 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. and knows nothing about packages not in the BLFS book.
Also, review and edit envars.conf. This file is used to set global envars IMPORTANT: Review and edit envars.conf, at least after installing the
needed by the build scripts. 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:: 4.4 CREATING THE MAKEFILE::