README.BLFS updates.
Install menu/ and README.BLFS.
This commit is contained in:
parent
5743d54b57
commit
e557f501d2
2 changed files with 53 additions and 25 deletions
76
README.BLFS
76
README.BLFS
|
@ -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
2
blfs
|
@ -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
|
||||||
|
|
Reference in a new issue