README.BLFS updates.

Install menu/ and README.BLFS.
This commit is contained in:
Manuel Canales Esparcia 2006-08-20 10:49:45 +00:00
parent 5743d54b57
commit e557f501d2
2 changed files with 53 additions and 25 deletions

View file

@ -23,8 +23,9 @@ $Id$
done in several steps: done in several steps:
2.1 INSTALLATION:: 2.1 INSTALLATION::
Run "make" to launch the menuconfig interface. Select the BLFS book
and it version. Then set the installation directory (default Run "make" to launch the jhalfs menuconfig interface. Select the BLFS
book and it version. Then set the installation directory (default
$HOME/blfs_root) and the BLFS sources directory (default blfs-xml). $HOME/blfs_root) and the BLFS sources directory (default blfs-xml).
All required files will be placed in the installation directory and All required files will be placed in the installation directory and
@ -32,26 +33,40 @@ $Id$
Installed files: Installed files:
lib/* functions, xsl, and auto-generates dependencies tree files blfs-xml/* SVN tree of the selected BLFS book version
lib/* functions libraries, xsl stylesheets, and auto-generated
meta-packages dependencies tree files
menu/* lxdialog and menuconfig source code
README.BLFS this file README.BLFS this file
TODO developers notes TODO developers notes
packages auto-generated file with packages info update_book.sh update the XML book sources and regenerates packages
alternatives.conf configuration files for alternative packages database and meta-packages dependencies tree
envars.conf envars needed when running the build scripts gen_config.sh regenerates Config.in
update_book.sh update the XML book sources and regenerate packages file blfs-parser.sh solve dependencies and generates linear BLFS books
and GNOME and KDE dependencies tree and build scripts
blfs-parser.sh generates linear BLFS books and build scripts gen-makefile.sh generates target Makefile
gen-makefile.sh generates Makefile progress_bar.sh the target Makefile progress bar
progress_bar.sh the Makefile progress bar Makefile (not created yet) run gen_config.sh to update Config.in,
then launch the menuconfig interface, and lastly run
blfs-parser.sh based on configuration settings
Config.in menuconfig interface imput file
packages auto-generated packages database
alternatives.conf (to be removed) configuration file for alternative packages
envars.conf envars needed when running the target build scripts
From now on, all the work must be done from inside the installation From now on, all the work must be done from inside the installation
root directory. root directory.
2.2 UPDATING BOOK SOURCES:: 2.2 UPDATING BOOK SOURCES::
If using the SVN book version, from time to time you may want to update
the XML sources. To do that run "./update_book.sh"
2.3 PARSING THE BOOK:: If using the development book version, and if you want to update already
installed packages to the new version found in that book, you need to update
the XML sources and packages database.
To do that run "./update_book.sh"
2.3 CONFIGURING AND PARSING THE BOOK:: (to be rewritten when ready menuconfig)
Next step is to create a book and build scripts in dependencies build order Next step is to create a book and build scripts in dependencies build order
for a target package. A target package can be any of the ones listed in the for a target package. A target package can be any of the ones listed in the
packages file. That is done using the blfs-parser.sh script, but we are trying packages file. That is done using the blfs-parser.sh script, but we are trying
@ -75,14 +90,24 @@ $Id$
dependencies in build order and a "scripts" directory with build scripts dependencies in build order and a "scripts" directory with build scripts
that uses sudo for commands that need root privileges. that uses sudo for commands that need root privileges.
There is also two other directories that contains files generated while There is also two other directories, dependencies and xincludes, that
resolving dependencies trees. contains files generated while resolving dependencies trees.
Now is the time to review the generated book and scripts, making in the 2.4 EDITING BUILD SCRIPTS
scripts any changes you want to fit your needs. Scripts for additional
packages (i.e., for non-BLFS packages) can be inserted in an easy way.
2.4 CREATING THE MAKEFILE Now is the time to review the generated book and scripts, making in the
scripts any changes required to fix generation bugs or to fit your needs.
Scripts for additional packages (i.e., for non-BLFS packages) can be
inserted in an easy way due how the scripts are named. For example, if you
want to install the external dependency "bar" before "foo" package and the
"foo" script is named "064-z-foo", you need to create a "064-y-bar" build
script.
Note that the packages tracking system isn't a packages manegament tool
and know nothing about packages not in the BLFS book.
2.5 CREATING THE MAKEFILE
When the build scripts are ready to be run, the Makefile can be When the build scripts are ready to be run, the Makefile can be
created. Be sure that you cd into the "package" directory and run created. Be sure that you cd into the "package" directory and run
@ -91,16 +116,17 @@ $Id$
Review the Makefile and if all look sane, start the build. Review the Makefile and if all look sane, start the build.
(Text is needed for the installed packages tracking system and like) (Text is needed about meta-packages, the installed packages tracking system
and like)
3. GENERATED BUILD SCRIPTS ISSUES:: 3. GENERATED BUILD SCRIPTS ISSUES::
In this section known issues with the generated build scripts are In this section known issues with the generated build scripts are
discussed. They are due build procedures and BLFS layout particularities discussed. They are due build procedures and/or BLFS layout particularities
than we can't handle. In some cases editing the build scripts is mandatory. than we can't handle. In several cases editing the build scripts is mandatory.
You may need also to insert some build script created by you to resolve You may need also to insert some build script created by you to resolve
unhandled dependencies and/or to remove some script and install the unhandled dependencies and/or to remove some script installing the affected
affected package by hand. package by hand.
3.1 BLFS BOOTSCRIPTS 3.1 BLFS BOOTSCRIPTS

2
blfs
View file

@ -111,7 +111,9 @@ echo "${nl_}${SD_BORDER}${nl_}"
[[ ! -d $BLFS_ROOT ]] && mkdir -p $BLFS_ROOT [[ ! -d $BLFS_ROOT ]] && mkdir -p $BLFS_ROOT
cp -r BLFS/* $BLFS_ROOT cp -r BLFS/* $BLFS_ROOT
cp -r menu $BLFS_ROOT
cp $COMMON_DIR/progress_bar.sh $BLFS_ROOT cp $COMMON_DIR/progress_bar.sh $BLFS_ROOT
cp README.BLFS $BLFS_ROOT
# Start the work # Start the work
cd $BLFS_ROOT cd $BLFS_ROOT