jbsrc/lib/README (2420B) - raw
1 ===============================================================================
2 JB, the Jean-Yves Lefort's Build System
3 ===============================================================================
4
5 Index
6
7 0. About this document
8 1. Motivation
9 2. Dependencies
10 3. Customizing the bootstrap compilation
11 4. Log files
12 5. Redirecting the installation
13
14 0. About this document
15
16 $Id: README,v 1.3 2008-04-25 22:58:19 jylefort Exp $
17
18 Copyright (C) 2008 Jean-Yves Lefort.
19
20 Permission is granted to copy, distribute and/or modify this
21 document under the terms of the GNU Free Documentation License
22 (GFDL), Version 1.2 or any later version published by the Free
23 Software Foundation with no Invariant Sections, no Front-Cover
24 Texts, and no Back-Cover Texts. You can find a copy of the
25 GFDL at http://www.gnu.org/licenses/fdl.html or in the file
26 COPYING-DOCS distributed with this manual.
27
28 1. Motivation
29
30 JB is the result of my long-standing dissatisfaction with the
31 GNU Autotools. It makes my programmer's life easier, for
32 reasons that I will not bother enumerating here.
33
34 2. Dependencies
35
36 Regardless of the package dependencies, JB requires a C
37 compiler and the GLib library (version 2.8 or superior).
38
39 3. Customizing the bootstrap compilation
40
41 The first time ./jb is run, it bootstraps itself by compiling
42 the real JB program, which is written in C. If you need to
43 influence the way this program is compiled, you can set the
44 jb_cc, jb_cflags, jb_cppflags, jb_ldflags and jb_libs
45 environment variables, for instance:
46
47 jb_cc=gcc jb_cflags=-g ./jb configure
48
49 Note that these environment variables are only used to compile
50 the JB program. To specify compilation options for the
51 package, use:
52
53 ./jb configure cc=gcc cflags=-g
54
55 4. Log files
56
57 You can check what JB is doing by reviewing the build/*.log
58 files. Each action has its own log file (configure.log,
59 build.log, ...).
60
61 5. Redirecting the installation
62
63 A number of packaging systems rely on the Automake DESTDIR
64 facility, which allows to install the package in a temporary
65 directory rather than directly in its final location.
66
67 JB supports that functionality. To redirect the installation
68 to a different directory, pass the destdir variable to the
69 configure stage, for instance:
70
71 ./jb configure destdir=/my/temp/dir
72
73 As with Automake, the destdir setting does not influence the
74 idea that the package has of its installation location.