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
64
65
66
67
68
69
70
71
72
73
74
|
This documentation is shared by most Adacore packages.
Please replace PKG with florist.
Upstream use three versioning schemes.
* Commercial releases are numbered YY.MINOR,
where YY contains the two last digits of the year (since 2017).
* Builds between 17.2 and 12.3 are numbered 12.3w (as wavefront).
* Every year, a GPL release without the GCC Runtime Library Exception
is numbered as gpl-20YY.
There is no ordering implied between gpl-20YY and any YY.MINOR.
Upstream history is visible at https://github.com/AdaCore/PKG/network.
The version number is always visible in first line of ./configure.in.
Debian packages are based on GPL releases.
The (upstream part of) the source version is 20YY (for historical reasons).
ALI and SO binary package versions as described in the Debian Ada
policy are consecutive integers (since 2018).
They are almost unrelated with upstream releases.
When packaging a new version for Debian:
Download GPL release pristine archive from the Homepage URL field in
the control file. Tracking upstream releases automatically is of
little interest, and quite hard as the website is modified each year.
Repackage it without generated files.
# mk-origtargz --repack --compression=xz --version=YY ../PKG-gpl-YYYY-src.tar.gz
The monotone repository at www.ada-france.org once used to track GPL
versions from the public part of the upstream CVS repository in a
branch named com.adacore.PKG, and the repackaged sources in a
branch named com.adacore.PKG.debian, but this seems redundant with
the public git repository now.
Use of the version control system
---------------------------------
You may either create an empty Monotone database
# mtn -d $db db init
or use an existing one.
All work on this package is tracked in the
www.ada-france.org monotone repository.
# upstream_branch=com.adacore.florsist tracks AdaCore tarballs.
# debian_branch=org.debian.libflorist tracks the Debian packaging
Download the branches from the server to your database. The first
time you contact this server, monotone will show its key. You should
check that it matches f8a11727e8983cf9083c08c6a2acaa27e439dd39.
# server=www.ada-france.org
# mtn -d $db pull mtn://$server?$upstream_branch
# mtn -d $db pull mtn://$server?$debian_branch
Recreate the repackaged archive from a tag.
# mtn -d $db checkout -r t:florist-2014 florist-src
# tar caf libflorist_2014.orig.tar.gz florist-src --exclude=_MTN
# rm -fr florist-src
Inspect the unpatched source tree.
# tar xf libflorist_2014.orig.tar.xz
# cd florist-src
# mtn -d $db checkout -r h:$debian_branch .
Build the package
# debuild
Beware that:
- mtn status does not list all changes. Try "mtn list missing", "mtn
list unknown", "mtn list ignored" and "mtn status" to get the
equivalent of "git status".
- Monotone will detect changes outside debian/ caused by patches.
Always "quilt pop -a" when preparing a commit.
-- Nicolas Boulenguez <nicolas@debian.org>, Tue, 8 May 2018 14:55:42 +0200
|
