Debian Codegraph @

doc/programmers-guide/package-library-version.html

raw
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Package and library versions</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Database Independent Abstraction Layer for C"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="Library and Interface Versions"
14 HREF="versioning.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Library and Interface Versions"
17 HREF="versioning.html"><LINK
18 REL="NEXT"
19 TITLE="libdbi and libdbi-drivers versions"
20 HREF="libdbi-and-drivers-versions.html"></HEAD
21 ><BODY
22 CLASS="SECT1"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >Database Independent Abstraction Layer for C: libdbi Programmer's Guide</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="versioning.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 6. Library and Interface Versions</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="libdbi-and-drivers-versions.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECT1"
73 ><H1
74 CLASS="SECT1"
75 ><A
76 NAME="PACKAGE-LIBRARY-VERSION"
77 >6.1. Package and library versions</A
78 ></H1
79 ><P
80 >libdbi utilizes <A
81 HREF="http://www.gnu.org/software/libtool/"
82 TARGET="_top"
83 >libtool</A
84 > to manage the library in a platform-independent fashion. libtool uses an abstract library versioning scheme which consists of three numbers:</P
85 ><P
86 ></P
87 ><DIV
88 CLASS="VARIABLELIST"
89 ><DL
90 ><DT
91 >current</DT
92 ><DD
93 ><P
94 >This is the number of the current interface. The first "incarnation" is usually 0 (zero), the next version that adds or subtracts something from this interface would be 1 (think of new API functions or functions with altered parameter lists).</P
95 ></DD
96 ><DT
97 >revision</DT
98 ><DD
99 ><P
100 >This number counts the released changes of the interface which do not alter the interface (think of internal optimizations, bugfixes and so on)</P
101 ></DD
102 ><DT
103 >age</DT
104 ><DD
105 ><P
106 >This is the number of previous interfaces that the current version is backwards-compatible with. That is, if <CODE
107 CLASS="PARAMETER"
108 >current</CODE
109 > is "n", programs linked against "n", "n-1", and "n-2" will run with the current version.</P
110 ></DD
111 ></DL
112 ></DIV
113 ><P
114 >The package version number (major.minor.patch) is computed from the above numbers using the formulas:</P
115 ><P
116 ></P
117 ><UL
118 ><LI
119 ><P
120 >major = current - age</P
121 ></LI
122 ><LI
123 ><P
124 >minor = age + 8</P
125 ></LI
126 ><LI
127 ><P
128 >patch = revision</P
129 ></LI
130 ></UL
131 ><P
132 >The correction applied to <CODE
133 CLASS="VARNAME"
134 >minor</CODE
135 > is currently required to bring the package version in line with earlier releases which did not use proper libtool interface versioning. It will be dropped if <CODE
136 CLASS="VARNAME"
137 >major</CODE
138 > rises above zero.</P
139 ></DIV
140 ><DIV
141 CLASS="NAVFOOTER"
142 ><HR
143 ALIGN="LEFT"
144 WIDTH="100%"><TABLE
145 SUMMARY="Footer navigation table"
146 WIDTH="100%"
147 BORDER="0"
148 CELLPADDING="0"
149 CELLSPACING="0"
150 ><TR
151 ><TD
152 WIDTH="33%"
153 ALIGN="left"
154 VALIGN="top"
155 ><A
156 HREF="versioning.html"
157 ACCESSKEY="P"
158 >Prev</A
159 ></TD
160 ><TD
161 WIDTH="34%"
162 ALIGN="center"
163 VALIGN="top"
164 ><A
165 HREF="index.html"
166 ACCESSKEY="H"
167 >Home</A
168 ></TD
169 ><TD
170 WIDTH="33%"
171 ALIGN="right"
172 VALIGN="top"
173 ><A
174 HREF="libdbi-and-drivers-versions.html"
175 ACCESSKEY="N"
176 >Next</A
177 ></TD
178 ></TR
179 ><TR
180 ><TD
181 WIDTH="33%"
182 ALIGN="left"
183 VALIGN="top"
184 >Library and Interface Versions</TD
185 ><TD
186 WIDTH="34%"
187 ALIGN="center"
188 VALIGN="top"
189 ><A
190 HREF="versioning.html"
191 ACCESSKEY="U"
192 >Up</A
193 ></TD
194 ><TD
195 WIDTH="33%"
196 ALIGN="right"
197 VALIGN="top"
198 >libdbi and libdbi-drivers versions</TD
199 ></TR
200 ></TABLE
201 ></DIV
202 ></BODY
203 ></HTML
204 >