File: flag-arguments

package info (click to toggle)
acr 2.2.4-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 712 kB
  • sloc: sh: 4,738; makefile: 41
file content (58 lines) | stat: -rw-r--r-- 1,858 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
ACR flag arguments
===================

Flag argument use in ACR are very simple. But also powerful :)

From the user view arguments are checked by the main argument parsing loop,
where the script checks for flags like '--prefix' '--host'. But the user
can add some new flags to allow some program specific options.

For example:
$ ./configure --report | grep FLAGS
FLAGS:     --enable-debug

$ ./configure --prefix=/usr --enable-debug


Types of arguments:
-------------------
There'r two type of argument flags in ACR. The boolean and the variable ones.


Boolean:
--------
Boolean flag arguments are just flags that allows a true or false values.
They are used to enable or disable some options of your program.

The '--with' and '--enable' ones have a default value of 0, giving a true
value to the variable when the user calls ./configure with this flag.

The '--without' and '--disable' are just the inverse of above.

Let's see an example of a boolean flag argument: Type this in your favorite
configure.acr file :)

----8<------------------------
ARG_ENABLE DEBUG debug  compiles the program with debugging features. ;
--------->8-------------------

This will add a --enable-debug flag in your ./configure script that sets
DEBUG=0 at the beginning of the script. And sets DEBUG=1 when the user
uses the --enable-debug flag.



Variable:
---------
Variable flag arguments are used to specify paths, strings or something
variable for the user. Let's see an example of use:

---8<------------------------
ARG_WITH WWWUSER=www wwwuser  sets the default user for http. ;
ARG_WITH WWWROOT=/home/www/ wwwroot sets the default root for http. ;
------->8--------------------

This will set WWWUSER to "www" allowing the user to change this value by
using the --with-wwwuser=VALUE. For example:

$ ./configure --with-wwwroot=/var/www --with-wwwuser=webmaster