| 1 | $Id$
|
|---|
| 2 |
|
|---|
| 3 | 1. INTRODUCTION::
|
|---|
| 4 |
|
|---|
| 5 | This collection of scripts, known as jhalfs-X, strives to create
|
|---|
| 6 | accurate makefiles from the Linux From Scratch book series XML files.
|
|---|
| 7 |
|
|---|
| 8 | The usage of this script assumes you have read and are familiar with
|
|---|
| 9 | the book(s) and therefore the configuration variables found in config files
|
|---|
| 10 | will have meaning to you. There are a number of command line switches
|
|---|
| 11 | which, if used, will override the config file settings.
|
|---|
| 12 |
|
|---|
| 13 | NOTES::
|
|---|
| 14 | *. The resulting Makefile takes considerable time to run to completion,
|
|---|
| 15 | lay in a supply of caffeine beverages.
|
|---|
| 16 |
|
|---|
| 17 | *. It is recommended that you temporarily unpack your linux kernel and
|
|---|
| 18 | run <make menuconfig> and configure the kernal as per the book and save
|
|---|
| 19 | the resulting .config file. This configuration rule also applies to the
|
|---|
| 20 | configuration of the uClibc package when building a HLFS system using
|
|---|
| 21 | uClibc rather than glibc.
|
|---|
| 22 |
|
|---|
| 23 | 2. INSTALLATION::
|
|---|
| 24 | No installation is required. System-wide installation is not allowed
|
|---|
| 25 | for now.
|
|---|
| 26 |
|
|---|
| 27 | 3. CONFIGURATION FILES::
|
|---|
| 28 | Each book in the LFS series has it's own set of configurable parameters
|
|---|
| 29 | as well as the common parameters file.
|
|---|
| 30 |
|
|---|
| 31 | 4. RUNNING::
|
|---|
| 32 | The script, master.sh, cannot be invoked directly but only via the
|
|---|
| 33 | supplied symlinks. After editing the config file for the project you wish
|
|---|
| 34 | to build run the script.
|
|---|
| 35 |
|
|---|
| 36 | ./<symlink> --help will give you a context sensitive list of command
|
|---|
| 37 | line switches.
|
|---|
| 38 |
|
|---|
| 39 | 5. LAYOUT::
|
|---|
| 40 |
|
|---|
| 41 | blfs --+ /BLFS config ---+ /common/config
|
|---|
| 42 | | master.sh -+ /common_functions
|
|---|
| 43 | | xxxx.xsl -+ /makefile_functions
|
|---|
| 44 | | /func_check_versions.sh
|
|---|
| 45 | clfs --+ /CLFS config ---+ /func_validate_configs.sh
|
|---|
| 46 | | master.sh -+
|
|---|
| 47 | | xxxx.xsl -+
|
|---|
| 48 | |
|
|---|
| 49 | +--------------------- master.sh --------------->>>
|
|---|
| 50 | +--README
|
|---|
| 51 | |
|
|---|
| 52 | hlfs --+ /HLFS config ---+
|
|---|
| 53 | | master.sh -+
|
|---|
| 54 | | xxxx.xsl -+
|
|---|
| 55 | |
|
|---|
| 56 | lfs --+ /LFS config ---+
|
|---|
| 57 | master.sh -+
|
|---|
| 58 | xxxx.xsl -+
|
|---|
| 59 |
|
|---|
| 60 |
|
|---|
| 61 | 6. FAQ::
|
|---|
| 62 | Q. "It doesn't work"
|
|---|
| 63 | A. Yes it does..
|
|---|
| 64 |
|
|---|
