File: README.source

package info (click to toggle)
libgnatcoll 18-4
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 5,068 kB
  • sloc: ada: 40,393; python: 354; ansic: 310; makefile: 245; sh: 31
file content (62 lines) | stat: -rw-r--r-- 2,412 bytes parent folder | download
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
This documentation is shared by most Adacore packages.
Please replace PKG with gnatcoll-core.
The Debian package is named libgnatcoll.

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.

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

Use of the version control system
---------------------------------

You may either create an empty Monotone database
# mtn -d $db db init
or use an existing one.

A branch tracks the unpatched repackaged upstream archives, another
adds the debian/ subdirectory.
# upstream_branch=com.adacore.libgnatcoll
# debian_branch=org.debian.libgnatcoll

Download the two 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

Create a workspace with the head of debian branch.
# mtn -d $db checkout -r h:$debian_branch libgnatcoll
# cd libgnatcoll

Recreate the orig archive from a tag in upstream branch.
# mtn checkout -r t:libgnatcoll-1.6gpl2014 kilroy
# tar caf ../libgnatcoll_1.6gpl2014.orig.tar.xz kilroy --exclude=_MTN
# rm -fr kilroy

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>, Sat, 23 Jun 2018 00:31:41 +0200