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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
# Contributing
## Pull Requests
We love pull requests from everyone.
By participating in this project,
you agree to abide by its [Code of Conduct][conduct].
1. Fork and clone the repo.
2. Build and make sure all tests pass:
```sh
$ ./autogen.sh
$ ./configure
$ make check
```
3. Make your changes.
Respect the existing formatting and indentation,
when in doubt consult [style(9)][style].
4. If your changes can be captured by a [test],
make sure to add one.
Changes that only concern the interface can be harder to test but feel free
to ask for help.
Again,
make sure all tests still pass.
5. If your changes for instance adds an option or key binding,
make sure to update the [manual].
6. Submit a pull request on GitHub.
This will in addition to sharing your work run it through our continuous
integration which performs both static and runtime analysis in order to catch
bugs early on.
7. At this point you're waiting on us.
## Release
Internal documentation on crafting a release.
1. Run Coverity Scan.
In the case of discovered defects,
perform a fix and redo this step until no further defects are detected.
```sh
$ git checkout coverity_scan
$ git rebase master
$ git push origin coverity_scan
```
2. Update `CHANGELOG.md` and commit the change:
```sh
$ git commit -m 'Update CHANGELOG'
```
3. Update the version in `configure.ac`:
```
AC_INIT([pick], [0.0.2], [pick-maintainers@calleerlandsson.com])
```
... and commit the change:
```sh
$ git commit -m 'Update version to 0.0.2'
```
4. Create and verify the tarball:
```sh
$ make distcheck
$ tar tvzf pick-0.0.2.tar.gz
```
5. Create and verify checksum:
```sh
$ sha256 pick-0.0.2.tar.gz >pick-0.0.2.sha256
$ sha256 -c pick-0.0.2.sha256
```
6. Tag and push:
```sh
$ git tag v0.0.2
$ git push --tags origin master
```
7. [Announce the release on GitHub][announce].
8. Contact package maintainers:
* Aggelos Avgerinos <evaggelos.avgerinos@gmail.com> (Debian & Ubuntu)
* Chunyang Xu <xuchunyang.me@gmail.com> (MacPorts)
* Fredrik Fornwall <fredrik@fornwall.net> (Homebrew)
* Neel Chauhan <neel@neelc.org> (FreeBSD)
* 6c37 team <camille@airmail.cc> (CRUX)
```
To: pick-maintainers@calleerlandsson.com
Bcc: evaggelos.avgerinos@gmail.com, xuchunyang.me@gmail.com,
fredrik@fornwall.net, neel@neelc.org, camille@airmail.cc
Subject: pick 0.0.2
```
[announce]: https://github.com/mptre/pick/releases/new
[conduct]: https://github.com/mptre/pick/blob/master/CODE_OF_CONDUCT.md
[manual]: https://github.com/mptre/pick/tree/master/pick.1
[style]: https://man.openbsd.org/style
[test]: https://github.com/mptre/pick/tree/master/tests#test-suite
|
