blob: 7ba3a4b4158ecfe89a8a405e9bbb30fde09f465b (
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
Submitting patches
==================
Thank you for your interest in contributing to this project!
Please **do not** submit a pull request on GitHub. The repository
there is an automated mirror, and I don't develop using GitHub's
platform.
Instead, either
- publish a branch somewhere (a GitHub fork is fine), and e-mail
<spwhitton@spwhitton.name> asking me to merge your branch, possibly
using git-request-pull(1)
- prepare patches with git-format-patch(1), and send them to
<spwhitton@spwhitton.name>, probably using git-send-email(1)
You may find <https://git-send-email.io/> useful.
Reporting bugs
==============
Please use the CPAN bug tracker:
<https://rt.cpan.org/Public/Dist/Display.html?Name=Git-Annex>
Please read "How to Report Bugs Effectively" to ensure your bug report
constitutes a useful contribution to the project:
<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>
Signing off your commits
========================
Contributions are accepted upstream under the terms set out in the
file ``COPYING``. You must certify the contents of the file
``DEVELOPER-CERTIFICATE`` for your contribution. To do this, append a
``Signed-off-by`` line to end of your commit message. An easy way to
add this line is to pass the ``-s`` option to git-commit(1). Here is
an example of a ``Signed-off-by`` line:
::
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
Maintainance
============
Release process
---------------
1. Pull any updates to ``debian/`` from the Debian Perl Group's
repository on salsa.debian.org
2. Ensure that the test suite passes under autopkgtest, so we can
immediately upload the new release to Debian unstable:
``sbuild --dpkg-source-opts='-Zgzip -z1 --format=1.0 -sn'
--run-autopkgtest``
3. ``dzil release``
4. Now proceed to update Debian unstable:
1. ``git deborig``
2. If it's not already present, add a new ``debian/changelog``
entry with dch(1), or bump the version in an UNRELEASED entry
3. sbuild etc.
4. ``dgit push-source``
5. Push master branch and all tags to both git.spwhitton.name and
Debian Perl Team repo on salsa.debian.org.
Changelogs
----------
Be sure to record changes to the ``debian/`` directory in
``debian/changelog``, and changes to outside of the ``debian/``
directory in ``Changes``.
Git usage
---------
Avoid mixing changes to the ``debian/`` directory and changes to
outside of the ``debian/`` directory in the same commit.
|