Merged r2633:2639 from trunk.

This commit is contained in:
Manuel Canales Esparcia 2006-05-05 17:28:39 +00:00
parent b4145493b0
commit d20c553943
2 changed files with 66 additions and 39 deletions

75
README
View file

@ -37,44 +37,65 @@ $Id$
The term <symlink> refers to the 1 of 4 package symlinks, lfs,hlfs,clfs,blfs. The term <symlink> refers to the 1 of 4 package symlinks, lfs,hlfs,clfs,blfs.
Replace <symlink> with your choice of packages; i.e.: ./lfs Replace <symlink> with your choice of packages; i.e.: ./lfs
./<symlink> ./<symlink> eg: ./lfs or ./hlfs
Create a makefile based on the settings found in the config files. Create a makefile based on the settings found in the config files.
You must enter the build partition/jhalfs directory and manually run <make> You must enter the build partition/jhalfs directory and manually run <make>
./<symlink> -G ./<symlink> -G eg: ./lfs -G
Download the packages and patches necessary to build <symlink> Download the packages and patches necessary to build <symlink>
./<symlink> -G -M ./<symlink> -G -M eg: ./lfs -G -M
Download the packages, create and automatically run the Makefile Download the packages, create and automatically run the Makefile
./<symlink> --help will give you a context sensitive list of command ./<symlink> --help eg: ./lfs --help
line switches. will give you a context sensitive list of command line switches.
5. LAYOUT:: 5. LAYOUT::
blfs --+ /BLFS config ---+ /common/config /BLFS/config
| master.sh -+ /common_functions /master.sh
| xxxx.xsl -+ /makefile_functions /xxxx.xsl
| /func_check_versions.sh
clfs --+ /CLFS config ---+ /func_validate_configs.sh /CLFS/config
| master.sh -+ /master.sh
| xxxx.xsl -+ /xxxx.xsl
|
+--------------------- master.sh --------------->>> /HLFS/config
+--README /master.sh
| /xxxx.xsl
hlfs --+ /HLFS config ---+
| master.sh -+ /LFS/config
| xxxx.xsl -+ / master.sh
| /xxxx.xsl
lfs --+ /LFS config ---+
master.sh -+ /common/config
xxxx.xsl -+ /common_functions
/makefile_functions
/func_check_versions.sh
/func_validate_configs.sh
/contrib/jhalfs-paco.patch
/extras/do_copy_files
/do_ica_prep
/do_ica_work
/farce
/filelist
README
README.PACO
TODO
./blfs ---+
./clfs ---|
+---> master.sh
./hlfs ---|
./lfs ---+
6. FAQ:: 6. FAQ::
Q. "It doesn't work" Q. "It doesn't work"
A. Yes it does.. A. Yes it does, try ./lfs --help
Q. "How do I specify the build location" Q. "How do I specify the build location"
A. The original LFS document worked against the well know location /mnt/lfs. A. The original LFS document worked against the well know location /mnt/lfs.
@ -85,9 +106,9 @@ $Id$
The layout below $BUILDDIR is as follows. The layout below $BUILDDIR is as follows.
$BUILDDIR/ $BUILDDIR/
jhalfs (makefile,cmd scripts,logs..etc) jhalfs (makefile,cmd scripts,logs..etc)
sources (where packages reside sources (where packages reside)
temptools (temporary bootstrap system temptools (temporary bootstrap system)
cross-tools (CLFS only) cross-tools (temporary CLFS only)
... ...
FHS dir structure FHS dir structure
... ...

View file

@ -39,6 +39,10 @@ ${DD_BORDER}
${BOLD} ${BOLD}
Usage: $0 ${BOLD}[OPTION] Usage: $0 ${BOLD}[OPTION]
${RED}IMPORTANT:${OFF} Only supported command line switches are listed here.
For more fine-grained setups you must edit the relevant
configuration files placed under ${BOLD}common/${OFF} and ${BOLD}$(echo $PROGNAME | tr [a-z] [A-Z])/${OFF}
Options: Options:
${BOLD} -h, --help${OFF} ${BOLD} -h, --help${OFF}
print this help, then exit print this help, then exit
@ -47,8 +51,9 @@ ${BOLD} -V, --version${OFF}
print version information, then exit print version information, then exit
${BOLD} -B, --book VER${OFF} ${BOLD} -B, --book VER${OFF}
checkout VER version of the book. Supported versions at this time are: use VER version of the book as the system to build.
dev* | trunk | SVN aliases for Development {C,H,B}LFS Supported versions are: dev*, trunk, SVN
These are aliases for the Development version of {C,H,B}LFS
${BOLD} -D --directory DIR${OFF} ${BOLD} -D --directory DIR${OFF}
use DIR directory for building ${BOLD}$(echo $PROGNAME | tr [a-z] [A-Z])${OFF}; all files jhalfs-X produces use DIR directory for building ${BOLD}$(echo $PROGNAME | tr [a-z] [A-Z])${OFF}; all files jhalfs-X produces
@ -63,11 +68,12 @@ ${BOLD} -G, --get-packages${OFF}
${BOLD} -T, --testsuites N ${OFF} ${BOLD} -T, --testsuites N ${OFF}
Run test suites [0-3] Run test suites [0-3]
0 = none 0 = none
1 = only chapter06 Glibc, GCC and Binutils testsuites 1 = only final system Glibc, GCC and Binutils testsuites
2 = all chapter06 testsuites (in BLFS, alias to 1) 2 = all final system testsuites
3 = all chapter05 and chapter06 testsuites 3 = all temporary tools and final system testsuites
In BLFS, 2 and 3 are aliases to 1
In CLFS, 3 is an alias to 2 In CLFS, 3 is an alias to 2
In BLFS, 1, 2, and 3 are equivalents and means that the testsuites
will be run.
${BOLD} -W, --working-copy DIR${OFF} ${BOLD} -W, --working-copy DIR${OFF}
use the local working copy placed in DIR as the $(echo $PROGNAME | tr [a-z] [A-Z]) book use the local working copy placed in DIR as the $(echo $PROGNAME | tr [a-z] [A-Z]) book
@ -77,11 +83,11 @@ ${BOLD} -W, --working-copy DIR${OFF}
cat <<- -EOF- cat <<- -EOF-
${BOLD} -C, --comparasion TYPE${OFF} ${BOLD} -C, --comparasion TYPE${OFF}
do iterative comparison analysis. That will take several time due that do iterative comparison analysis. This extends the total build time
the final system packages wil be rebuilded the times defined in the considerably because the entire final system will rebuild itself
ITERATIONS config option. the number of times specified by ITERATIONS in common/config.
Analisys types allowed are: Types allowed are:
ICA = do the ICA analysis designed by Greg Schafer ICA = do ICA as designed by Greg Schafer
farce = do the farce analysis designed by Ken Moffat farce = do the farce analysis designed by Ken Moffat
both = perfom both ICA and farce analysis both = perfom both ICA and farce analysis
@ -97,7 +103,7 @@ ${BOLD} -M, --run-make${OFF}
run make on the generated Makefile run make on the generated Makefile
${BOLD} -R --rebuild${OFF} ${BOLD} -R --rebuild${OFF}
clean the build directory before to perfom any other task. The directory clean the build directory before perfoming any other task. The directory
is cleaned only if it was populated by a previous jhalfs-X run. is cleaned only if it was populated by a previous jhalfs-X run.
-EOF- -EOF-