aboutsummaryrefslogtreecommitdiffhomepage
path: root/notes/langver_per_apidef.txt
blob: ecd3c9a153940e16c80756b10cf3119c86672c97 (plain)
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

Specifying language version per \api_def
========================================

Syntax idea 1
-------------

For libraries:

    \slul
    \name somelib
    \type library
    \api_def 1.0 xxxxxxxxxxxxxxx langver 0.0.0
    \api_def 1.1 xxxxxxxxxxxxxxx
    \api_def 1.2 xxxxxxxxxxxxxxx langver 0.1.0


Syntax idea 2
-------------

For libraries:

    \slul 0.2.0 upto 0.3.0
    \langver 0.0.0 since 1.0
    \langver 0.1.0 since 1.2
    \name somelib
    \type library
    \api_def 1.0 xxxxxxxxxxxxxxx
    \api_def 1.1 xxxxxxxxxxxxxxx
    \api_def 1.2 xxxxxxxxxxxxxxx

It should be required to have at least one \langver for modules
with stable API.

For applications:

    \slul 0.2.0 upto 0.3.0
    \name myapp

Syntax idea 3
-------------

For libraries:

    \slul
    \langver 0.0.0 since 1.0
    \langver 0.1.0 since 1.2
    \langver impl 0.2.0 upto 0.3.0
    \name somelib
    \type library
    \api_def 1.0 xxxxxxxxxxxxxxx
    \api_def 1.1 xxxxxxxxxxxxxxx
    \api_def 1.2 xxxxxxxxxxxxxxx

For applications:

    \slul
    \langver 0.2.0 upto 0.3.0
    \name myapp