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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
====================================================
Debian source package for ‘jquery-throttle-debounce’
====================================================
:Author: Ben Finney <bignose@debian.org>
:Updated: 2022-02-12
Pristine upstream source contains non-DFSG-free files
=====================================================
The pristine upstream source contains obfuscated files, that are thereby not
appropriate for use as source files. This violates DFSG §2.
The ‘debian/watch’ configuration specifies that ‘uscan --download’ will re-pack
the pristine upstream tarball.
Package maintenance in VCS
==========================
The source for the Debian packaging is managed in the ‘main’ branch of the
Git repository.
Work on a release in VCS
------------------------
* Get the correct upstream source, using UScan::
$ uscan --download
* In the ‘main’ branch, create a new Debian changelog entry.
Because the release is not complete, many aspects have not been decided and
should not be recorded in the VCS:
* The target destination (in the header) is “UNRELEASED”.
* The person and timestamp of the release is undecided, so should be empty:
the signature line should have no content, just the “ --” leader.
* While working on the package, temporarily finalise the signature line for
testing the build.
This ephemeral state should not be part of the VCS history, though, so do not
commit that finalised changelog entry; revert it to the above state to
continue development.
Build the source package from VCS
---------------------------------
* Ensure the ‘main’ branch contains all the changes that are intended for the
release to Debian.
* Until the work is ready for release, do not commit a finalised Debian
changelog entry. The changelog entry should be in the state described in
“Work on a release in VCS”, above.
This correctly leaves the decision of which destination for the upload, who
uploads and when, to the point in time where that decision is made: the time
of finalising the release.
* Rebase a working branch, e.g. ‘wip/release/1.2+dfsg1-1’, from the HEAD of
‘main’.
* In this branch, finalise the ‘debian/changelog’:
* Declare a release name, e.g. “* The “Ananta Bijoy Das” release.”
* Set the target distribution, e.g. “unstable”.
* Set the signature line containing the correct person and timestamp,
e.g. “Ben Finney <bignose@debian.org> Tue, 09 Aug 2016 06:05:28 +1000”.
* Commit the finalised changelog with a commit message of the form
“Finalise release “1.2+dfsg1-1”.”
* Test the source package:
* Export the source package::
$ gbp buildpackage -S
* Test the source package by building it in a Sbuild or Pbuilder
environment, with all Lintian checks enabled.
* Only when the package builds satisfactorily from the source package:
* Switch to the ‘main’ branch.
* Pull the work-in-progress branch ‘wip/release/1.2+dfsg1-1’ to ‘main’.
* Create and sign a tag for the release, ‘release/1.2+dfsg1-1’ with
the commit message “Debian release “1.2+dfsg1-1.”::
$ git tag --sign \
--message "Debian release “1.2+dfsg1-1”." \
"release/1.2+dfsg1-1"
* Upload the successfully-built source package to Debian.
* Prepare the ‘main’ branch for ongoing work:
* Delete the work-in-progress branch ‘wip/release/1.2+dfsg1-1’.
* Optionally: Create a new work-in-progress for an upcoming release,
as described in “Work on a release in VCS”, above.
Omitted components
==================
Components that have been omitted from Debian because they do not
constitute the source form of the work:
* The compiled library.
Files: *.min.js
* The compiled documentation.
Files: docs/
Comment:
The files in this directory declare they were generated with
“Natural Docs”. The source documents are not part of the
distribution.
* Compiled files in the examples.
Files: examples/index.css
Comment:
The CSS file in this directory is evidently compiled from source
documents that are not part of the distribution.
* Bundled third-party libraries.
Files: shared/ba-debug.js
Comment:
Bundled copy of the JavaScript Debug library.
Files: shared/jquery-*.js
Comment:
Bundled copy of versions of the jQuery library.
Files: shared/qunit.js
Comment:
Bundled copy of the QUnit library.
Files: shared/SyntaxHighlighter/
Comment:
Bundled copy of the SyntaxHighlighter library.
-- Ben Finney <bignose@debian.org>, Fri, 1 Dec 2017 16:19:19 +1100
..
Copyright © 2016–2022 Ben Finney <bignose@debian.org>
This is free software: you may copy, modify, and/or distribute this work
under the terms of the GNU General Public License as published by the
Free Software Foundation; version 3 of that license or any later version.
No warranty expressed or implied.
..
Local variables:
coding: utf-8
mode: rst
mode: text
End:
vim: fileencoding=utf-8 filetype=rst :
|
