File: vers.xml

package info (click to toggle)
neon27 0.36.0-1
  • links: PTS
  • area: main
  • in suites: forky
  • size: 2,836 kB
  • sloc: ansic: 27,754; xml: 4,634; makefile: 629; sh: 328
file content (63 lines) | stat: -rw-r--r-- 1,706 bytes parent folder | download | duplicates (28)
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
<refentry id="refvers">

  <refmeta>
    <refentrytitle>ne_version_match</refentrytitle>
    <manvolnum>3</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>ne_version_match</refname>
    <refname>ne_version_string</refname>
    <refpurpose>library versioning</refpurpose>
  </refnamediv>
  
  <refsynopsisdiv>

    <funcsynopsis>

      <funcsynopsisinfo>#include &lt;ne_utils.h&gt;</funcsynopsisinfo>

      <funcprototype>
        <funcdef>int <function>ne_version_match</function></funcdef>
        <paramdef>int <parameter>major</parameter></paramdef>
        <paramdef>int <parameter>minor</parameter></paramdef>
      </funcprototype>

      <funcprototype>
        <funcdef>const char *<function>ne_version_string</function></funcdef>
	<void/>
      </funcprototype>

    </funcsynopsis>

  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para>The <function>ne_version_match</function> function returns
    non-zero if the library version is not of major version
    <parameter>major</parameter>, or the minor version is less than
    <parameter>minor</parameter>.  For &neon; versions 0.x, every
    minor version is assumed to be incompatible with every other minor
    version.</para>  <!-- TODO: remove that for 1.0 -->

    <para>The <function>ne_version_string</function> function returns
    a string giving the library version.</para>

  </refsect1>

  <refsect1>
    <title>Examples</title>

    <para>To require &neon; 1.x, version 1.2 or later:</para>

    <programlisting>if (ne_version_match(1, 2)) {
    printf("Library version out of date: 1.2 required, found %s.",
           ne_version_string());
    exit(1);
}</programlisting>

  </refsect1>

</refentry>