~m-grant-prg/libmgesysutils/bionic

« back to all changes in this revision

Viewing changes to README

  • Committer: Mark Grant
  • Date: 2019-11-05 09:02:57 UTC
  • mfrom: (2.1.27)
  • Revision ID: m.grant.prg@gmail.com-20191105090257-fcrfivqxphls7efe
Merge new development release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
89
89
bootstrap.sh
90
90
------------
91
91
This misleadingly named script bootstraps the project build and provides other
92
 
useful features. The main options below are probably b, c, C, D and T.
 
92
useful features. The main options are probably b, c, C, D and T.
93
93
 
94
94
In AutoTools it is usually advisable to perform parallel builds. This means you
95
95
build somewhere other than the project root. This is because building creates
104
104
 
105
105
The last '..' points the way to project root.
106
106
 
107
 
The full list of arguments to bootstrap.sh are:-
108
 
 
109
 
        -a, --at-only
110
 
                during testing and for an AutoTools-only install, some build
111
 
                changes are required. e.g. You may reference an external Java
112
 
                jar in datadir but in AT builds and installations this may
113
 
                expand to /usr/local/share... So a substitution is required for
114
 
                this scenario.
115
 
 
116
 
        -b, --build
117
 
                make the project.
118
 
 
119
 
        -c, --config
120
 
                configure the project.
121
 
 
122
 
        -C, --distcheck
123
 
                perform a normal make distcheck.
124
 
 
125
 
        -d, --debug
126
 
                build with appropriate debug flags.
127
 
 
128
 
        -D, --dist
129
 
                perform a make dist.
130
 
 
131
 
        -F, --distcheckfake
132
 
                run a make distcheck using a fake AT standard directory as a
133
 
                substitute for an absolute path which distcheck does not
134
 
                support.
135
 
 
136
 
        -g, --gnulib
137
 
                run gnulib-tool --update. Checks for the existence of the cache
138
 
                file proj-root/m4/gnulib-cache.m4. If it does not exist the
139
 
                update is not run.
140
 
 
141
 
        -h, --help
142
 
                prints usage information.
143
 
 
144
 
        -H, --header-check
145
 
                show include stack depth
146
 
 
147
 
        -s, --sparse
148
 
                pass --enable-sparse=yes to configure.
149
 
 
150
 
        -t, --testing-hacks
151
 
                some build changes may be required for testing purposes. e.g. A
152
 
                script may invoke a project jar file which when installed will
153
 
                be somewhere under datadir, but during testing it is in the
154
 
                project tree.
155
 
 
156
 
        -T, --source-tarball
157
 
                perform a make srctarball to build a source tarball.
158
 
 
159
 
        -v, --verbose
160
 
                emit extra information
161
 
 
162
 
        -V, --version
163
 
                prints version information
164
 
 
165
 
Options b build, C distcheck, D dist, F distcheckfake and T source-tarball are
166
 
mutually exclusive.
167
 
 
168
 
Options a at-only, d debug, F distcheckfake, H header-check, s sparse,
169
 
t testing-hacks and v verbose  are enabled by configure so require option c
170
 
config.
 
107
For the full list of arguments to bootstrap.sh, please refer to the options
 
108
section of the acmbuild wiki, the options are identical:-
 
109
 
 
110
https://github.com/m-grant-prg/acmbuild/wiki
171
111
 
172
112
 
173
113
gen-gnulib.sh