source: README.BLFS@ 5743d54

experimental
Last change on this file since 5743d54 was 9e627f6, checked in by Manuel Canales Esparcia <manuel@…>, 18 years ago

Merged r2969:2972 from trunk.

  • Property mode set to 100644
File size: 5.3 KB
Line 
1$Id$
2
31. INTRODUCTION::
4
5 To automatize packages build from the BLFS book instructions is a huge
6 task. The BLFS book isn't linear, some package pages need to use a non
7 default layout, there are circular dependencies, several packages can be
8 installed on a non default prefix, build commands can change based on what
9 dependencies will be used, etc.
10
11 Said that, the goal of jhalfs is try to help you solving packages
12 dependencies and creating your own build scripts/Makefile. Some of the
13 auto-generated build scripts and Makefile could work "as is", but as a
14 general rule you will need to review and edit the scripts while reading
15 the book.
16
17 NOTE:: The code is still under development and may contains several bugs
18
19
202. USAGE::
21
22 Due the complexity of the BLFS book, the scripts/Makefile generation is
23 done in several steps:
24
25 2.1 INSTALLATION::
26 Run "make" to launch the menuconfig interface. Select the BLFS book
27 and it version. Then set the installation directory (default
28 $HOME/blfs_root) and the BLFS sources directory (default blfs-xml).
29
30 All required files will be placed in the installation directory and
31 BLFS XML sources will be checkout to the named sub-directory.
32
33 Installed files:
34
35 lib/* functions, xsl, and auto-generates dependencies tree files
36 README.BLFS this file
37 TODO developers notes
38 packages auto-generated file with packages info
39 alternatives.conf configuration files for alternative packages
40 envars.conf envars needed when running the build scripts
41 update_book.sh update the XML book sources and regenerate packages file
42 and GNOME and KDE dependencies tree
43 blfs-parser.sh generates linear BLFS books and build scripts
44 gen-makefile.sh generates Makefile
45 progress_bar.sh the Makefile progress bar
46
47 From now on, all the work must be done from inside the installation
48 root directory.
49
50 2.2 UPDATING BOOK SOURCES::
51 If using the SVN book version, from time to time you may want to update
52 the XML sources. To do that run "./update_book.sh"
53
54 2.3 PARSING THE BOOK::
55 Next step is to create a book and build scripts in dependencies build order
56 for a target package. A target package can be any of the ones listed in the
57 packages file. That is done using the blfs-parser.sh script, but we are trying
58 to make a menuconfig based system.
59
60 The script need three arguments:
61
62 package name as listed in packages file
63 dependencies level 1 for required,
64 2 for required an recommended
65 3 for required, recommended, and optional
66 sudo usage y if sudo will be used (you want build as a normal user)
67 n if sudo isn't needed (you want build as root)
68
69 For example:
70
71 ./blfs-parser galeon 3 y
72
73 will create a directory named "galeon". Inside that directory you find a
74 directory named "HTML" that contains a galeon-based HTML book with all
75 dependencies in build order and a "scripts" directory with build scripts
76 that uses sudo for commands that need root privileges.
77
78 There is also two other directories that contains files generated while
79 resolving dependencies trees.
80
81 Now is the time to review the generated book and scripts, making in the
82 scripts any changes you want to fit your needs. Scripts for additional
83 packages (i.e., for non-BLFS packages) can be inserted in an easy way.
84
85 2.4 CREATING THE MAKEFILE
86 When the build scripts are ready to be run, the Makefile can be
87 created. Be sure that you cd into the "package" directory and run
88
89 ../gen_makefile.sh
90
91 Review the Makefile and if all look sane, start the build.
92
93
94(Text is needed for the installed packages tracking system and like)
95
963. GENERATED BUILD SCRIPTS ISSUES::
97
98 In this section known issues with the generated build scripts are
99 discussed. They are due build procedures and BLFS layout particularities
100 than we can't handle. In some cases editing the build scripts is mandatory.
101 You may need also to insert some build script created by you to resolve
102 unhandled dependencies and/or to remove some script and install the
103 affected package by hand.
104
105 3.1 BLFS BOOTSCRIPTS
106
107 For now, bootscripts installation will fail. You will need to edit the
108 scripts for packages that install bootscripts and fix their installation
109 command. That could be fixed in the future, but not sure.
110
111 3.2 PACKAGES CONFIGURATION
112
113 For that packages that have a "Configuration" section, you should to
114 edit it build script to fit the configuration to your needs.
115
116 3.4 PDL and Perl modules.
117
118 The generated scripts for that packages are plainly broken and can't
119 be fixed. You must to replace it by your own ones or install that
120 packages by hand.
121
122 3.4 GCC, JDK, Sane, and KDE-multimedia
123
124 On the pages for that packages, the BLFS book actually have instructions
125 to install two packages. You must to edit the scripts to fix it. We will
126 try to fix some of them, but may not be possible.
127
128 3.5 OTHERS
129
130 May have other issues that we are not aware on them yet. If you find
131 someone, please report it to <alfs-discuss@linuxfromscratch.org>.
132
133
Note: See TracBrowser for help on using the repository browser.