← Back to branch summary

~m-grant-prg/acmbuild/buster

« back to all changes in this revision

Viewing changes to README

  • Committer: Mark Grant
  • Date: 2022-10-13 09:22:38 UTC
  • mto: (87.1.7 buster-trunk)
  • mto: This revision was merged to the branch mainline in revision 90.
  • Revision ID: m.grant.prg@gmail.com-20221013092238-nvf5o2uwjkiu1d91
Tags: upstream-1.4.4
Import upstream version 1.4.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
2
2
AutoConf and AutoMake Build Scripts
3
3
===================================
4
4
 
5
 
Author - Copyright (C) 2014-2020 Mark Grant
 
5
Author - Copyright (C) 2014-2021 Mark Grant
6
6
 
7
7
--------
8
8
Contents
47
47
The acmbuild.sh options come in two flavours; action options and enabling
48
48
options.
49
49
 
50
 
b, c, C, D, g, K and T are action options. -b, for instance will run make,
 
50
b, c, C, D, g, K, m and T are action options. -b, for instance will run make,
51
51
whereas -D will run make dist.
52
52
 
53
 
The rest, (apart from help and version), are enabling options. Invariably these are implemented merely by passing an enable argument to configure. For example
 
53
The rest, (apart from help and version), are enabling options. Invariably these
 
54
are implemented merely by passing an enable argument to configure. For example
54
55
 
55
56
        acmbuild.sh --config --debug ..
56
57
 
64
65
written code in configure to process this argument, configure will issue a
65
66
warning and then just ignore the option.
66
67
 
 
68
As an example of the simplification this script affords, the following
 
69
acmbuild.sh command
 
70
 
 
71
        acmbuild.sh -cb .
 
72
 
 
73
will run
 
74
 
 
75
        autoreconf -if .
 
76
        ./configure (plus options)
 
77
        make (plus options)
 
78
 
67
79
 
68
80
Implementation
69
81
--------------
119
131
        -K, --check
120
132
                run make check
121
133
 
 
134
        -m or --menu-config Invoke menu of configurable options
 
135
 
 
136
        -p[X] or --parallel-jobs[=X] number of jobs to pass to make as --jobs=
 
137
                If not specified make is sequential
 
138
                If no value X is given then defaults to nproc
 
139
 
122
140
        -s, --sparse
123
141
                pass --enable-sparse=yes to configure.
124
142