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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<title>
Autoconf Macro: ax_compare_version
</title>
<link rel="stylesheet" type="text/css" href="autoconf-archive.css">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body>
<table summary="web navigation" style="width:100%;">
<tbody>
<tr>
<td style="width:33%;" align="center" valign="top">
<a href="macros-by-category.html">Macros by Category</a>
</td>
<td style="width:33%;" align="center" valign="top">
<a href=
"http://git.cryp.to/autoconf-archive/history/master:/ax_compare_version.m4">
Revision History</a>
</td>
<td style="width:33%;" align="center" valign="top">
<form method="get" action="http://www.google.com/search">
<div>
<input name="sitesearch" value="autoconf-archive.cryp.to" type=
"hidden">Search: <input name="q" maxlength="255" type="text">
</div>
</form>
</td>
</tr>
</tbody>
</table>
<hr>
<h1>
ax_compare_version
</h1>
<h2>
SYNOPSIS
</h2>
<p class="indent" style="white-space:nowrap;">
<code>AX_COMPARE_VERSION(VERSION_A, OP, VERSION_B, [ACTION-IF-TRUE],
[ACTION-IF-FALSE])</code>
</p>
<h2>
DESCRIPTION
</h2>
<div class="indent">
<p>
This macro compares two version strings. Due to the various number of
minor-version numbers that can exist, and the fact that string comparisons
are not compatible with numeric comparisons, this is not necessarily
trivial to do in a autoconf script. This macro makes doing these
comparisons easy.
</p>
<p>
The six basic comparisons are available, as well as checking equality
limited to a certain number of minor-version levels.
</p>
<p>
The operator OP determines what type of comparison to do, and can be one
of:
</p>
<pre>
eq - equal (test A == B)
ne - not equal (test A != B)
le - less than or equal (test A <= B)
ge - greater than or equal (test A >= B)
lt - less than (test A < B)
gt - greater than (test A > B)
</pre>
<p>
Additionally, the eq and ne operator can have a number after it to limit
the test to that number of minor versions.
</p>
<pre>
eq0 - equal up to the length of the shorter version
ne0 - not equal up to the length of the shorter version
eqN - equal up to N sub-version levels
neN - not equal up to N sub-version levels
</pre>
<p>
When the condition is true, shell commands ACTION-IF-TRUE are run,
otherwise shell commands ACTION-IF-FALSE are run. The environment variable
'ax_compare_version' is always set to either 'true' or 'false' as well.
</p>
<p>
Examples:
</p>
<pre>
AX_COMPARE_VERSION([3.15.7],[lt],[3.15.8])
AX_COMPARE_VERSION([3.15],[lt],[3.15.8])
</pre>
<p>
would both be true.
</p>
<pre>
AX_COMPARE_VERSION([3.15.7],[eq],[3.15.8])
AX_COMPARE_VERSION([3.15],[gt],[3.15.8])
</pre>
<p>
would both be false.
</p>
<pre>
AX_COMPARE_VERSION([3.15.7],[eq2],[3.15.8])
</pre>
<p>
would be true because it is only comparing two minor versions.
</p>
<pre>
AX_COMPARE_VERSION([3.15.7],[eq0],[3.15])
</pre>
<p>
would be true because it is only comparing the lesser number of minor
versions of the two values.
</p>
<p>
Note: The characters that separate the version numbers do not matter. An
empty string is the same as version 0. OP is evaluated by autoconf, not
configure, so must be a string, not a variable.
</p>
<p>
The author would like to acknowledge Guido Draheim whose advice about the
m4_case and m4_ifvaln functions make this macro only include the portions
necessary to perform the specific comparison specified by the OP argument
in the final configure script.
</p>
</div>
<h2>
SOURCE CODE
</h2>
<p class="indent">
<a href=
"http://autoconf-archive.cryp.to/ax_compare_version.m4">http://autoconf-archive.cryp.to/ax_compare_version.m4</a>
</p>
<h2>
LICENSE
</h2>
<div class="indent">
<p style="white-space:nowrap;">
Copyright © 2008 Tim Toolan <toolan@ele.uri.edu>
</p>
<p>
Copying and distribution of this file, with or without modification, are
permitted in any medium without royalty provided the copyright notice and
this notice are preserved.
</p>
</div>
</body>
</html>
|
