annotate lib/filevercmp.h @ 17605:23cb5b2fd95b

relocatable-perl: like relocatable-script, but for Perl scripts * build-aux/relocatable.pl.in: Add. * doc/relocatable-maint.texi: Add documentation. * modules/relocatable-perl: Add.
author Reuben Thomas <rrt@sc3d.org>
date Thu, 09 Jan 2014 22:31:42 +0000
parents 344018b6e5d7
children 91226354878b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10573
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
1 /*
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
2 Copyright (C) 1995 Ian Jackson <iwj10@cus.cam.ac.uk>
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
3 Copyright (C) 2001 Anthony Towns <aj@azure.humbug.org.au>
17587
344018b6e5d7 maint: update copyright
Eric Blake <eblake@redhat.com>
parents: 17249
diff changeset
4 Copyright (C) 2008-2014 Free Software Foundation, Inc.
10573
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
5
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
6 This program is free software: you can redistribute it and/or modify
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
7 it under the terms of the GNU General Public License as published by
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
8 the Free Software Foundation, either version 3 of the License, or
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
9 (at your option) any later version.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
10
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
11 This program is distributed in the hope that it will be useful,
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
14 GNU General Public License for more details.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
15
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
18
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
19 #ifndef FILEVERCMP_H
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
20 #define FILEVERCMP_H
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
21
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
22 /* Compare version strings:
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
23
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
24 This function compares strings S1 and S2:
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
25 1) By PREFIX in the same way as strcmp.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
26 2) Then by VERSION (most similarly to version compare of Debian's dpkg).
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
27 Leading zeros in version numbers are ignored.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
28 3) If both (PREFIX and VERSION) are equal, strcmp function is used for
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
29 comparison. So this function can return 0 if (and only if) strings S1
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
30 and S2 are identical.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
31
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
32 It returns number >0 for S1 > S2, 0 for S1 == S2 and number <0 for S1 < S2.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
33
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
34 This function compares strings, in a way that if VER1 and VER2 are version
11429
a32a8b26323e filevercmp: handle simple~ and numbered.~3~ backup suffixes
Kamil Dudka <kdudka@redhat.com>
parents: 10573
diff changeset
35 numbers and PREFIX and SUFFIX (SUFFIX defined as (\.[A-Za-z~][A-Za-z0-9~]*)*)
10573
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
36 are strings then VER1 < VER2 implies filevercmp (PREFIX VER1 SUFFIX,
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
37 PREFIX VER2 SUFFIX) < 0.
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
38
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
39 This function is intended to be a replacement for strverscmp. */
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
40 int filevercmp (const char *s1, const char *s2);
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
41
39f73ea22045 filevercmp: new module
Kamil Dudka <kdudka@redhat.com>
parents:
diff changeset
42 #endif /* FILEVERCMP_H */