Debian Codegraph @

doc/programmers-guide/versioning.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 >Library and Interface 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="PREVIOUS"
13 TITLE="Savepoints"
14 HREF="savepoints.html"><LINK
15 REL="NEXT"
16 TITLE="Package and library versions"
17 HREF="package-library-version.html"></HEAD
18 ><BODY
19 CLASS="CHAPTER"
20 BGCOLOR="#FFFFFF"
21 TEXT="#000000"
22 LINK="#0000FF"
23 VLINK="#840084"
24 ALINK="#0000FF"
25 ><DIV
26 CLASS="NAVHEADER"
27 ><TABLE
28 SUMMARY="Header navigation table"
29 WIDTH="100%"
30 BORDER="0"
31 CELLPADDING="0"
32 CELLSPACING="0"
33 ><TR
34 ><TH
35 COLSPAN="3"
36 ALIGN="center"
37 >Database Independent Abstraction Layer for C: libdbi Programmer's Guide</TH
38 ></TR
39 ><TR
40 ><TD
41 WIDTH="10%"
42 ALIGN="left"
43 VALIGN="bottom"
44 ><A
45 HREF="savepoints.html"
46 ACCESSKEY="P"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="package-library-version.html"
60 ACCESSKEY="N"
61 >Next</A
62 ></TD
63 ></TR
64 ></TABLE
65 ><HR
66 ALIGN="LEFT"
67 WIDTH="100%"></DIV
68 ><DIV
69 CLASS="CHAPTER"
70 ><H1
71 ><A
72 NAME="VERSIONING"
73 ></A
74 >Chapter 6. Library and Interface Versions</H1
75 ><DIV
76 CLASS="TOC"
77 ><DL
78 ><DT
79 ><B
80 >Table of Contents</B
81 ></DT
82 ><DT
83 >6.1. <A
84 HREF="package-library-version.html"
85 >Package and library versions</A
86 ></DT
87 ><DT
88 >6.2. <A
89 HREF="libdbi-and-drivers-versions.html"
90 >libdbi and libdbi-drivers versions</A
91 ></DT
92 ><DT
93 >6.3. <A
94 HREF="version-at-runtime.html"
95 >Determining the library version at runtime</A
96 ></DT
97 ></DL
98 ></DIV
99 ><P
100 >Libraries are no static entities, just as any other piece of software. Some parts evolve, some optimizations are made, new features are requested, and old features may be too cumbersome to support if no one uses them anyway. Any of these developments may result in a new release. This chapter briefly discusses the issues related to library and driver versions.</P
101 ><P
102 >The version issues with libdbi are a little more convoluted than with a run-of-the-mill library because we have to consider two application interfaces (APIs):</P
103 ><P
104 ></P
105 ><DIV
106 CLASS="VARIABLELIST"
107 ><DL
108 ><DT
109 >DBI API</DT
110 ><DD
111 ><P
112 >This is, as with any other library, the data structures and the functions that you, as a programmer of a software linked against libdbi, need to know about.</P
113 ></DD
114 ><DT
115 >DBD API</DT
116 ><DD
117 ><P
118 >This is the interface that matters to the authors of database engine drivers.</P
119 ></DD
120 ></DL
121 ></DIV
122 ><P
123 >Both interfaces may change independently, and both may affect the version number of the package as will be discussed shortly.</P
124 ></DIV
125 ><DIV
126 CLASS="NAVFOOTER"
127 ><HR
128 ALIGN="LEFT"
129 WIDTH="100%"><TABLE
130 SUMMARY="Footer navigation table"
131 WIDTH="100%"
132 BORDER="0"
133 CELLPADDING="0"
134 CELLSPACING="0"
135 ><TR
136 ><TD
137 WIDTH="33%"
138 ALIGN="left"
139 VALIGN="top"
140 ><A
141 HREF="savepoints.html"
142 ACCESSKEY="P"
143 >Prev</A
144 ></TD
145 ><TD
146 WIDTH="34%"
147 ALIGN="center"
148 VALIGN="top"
149 ><A
150 HREF="index.html"
151 ACCESSKEY="H"
152 >Home</A
153 ></TD
154 ><TD
155 WIDTH="33%"
156 ALIGN="right"
157 VALIGN="top"
158 ><A
159 HREF="package-library-version.html"
160 ACCESSKEY="N"
161 >Next</A
162 ></TD
163 ></TR
164 ><TR
165 ><TD
166 WIDTH="33%"
167 ALIGN="left"
168 VALIGN="top"
169 >Savepoints</TD
170 ><TD
171 WIDTH="34%"
172 ALIGN="center"
173 VALIGN="top"
174 >&nbsp;</TD
175 ><TD
176 WIDTH="33%"
177 ALIGN="right"
178 VALIGN="top"
179 >Package and library versions</TD
180 ></TR
181 ></TABLE
182 ></DIV
183 ></BODY
184 ></HTML
185 >