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
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
Nothing is unusual about this package's source organization vis à vis Debian
Policy §4.14.
However this file does seem to be a good place to put the former
debian/checklist, as follows.
New upstream version checklist:
* Summarize new features in debian/changelog.
* Document any hugely noteworthy new features in debian/control.
* Ensure new upstream files are shipped, and files deleted upstream are no
longer shipped, as appropriate.
* Migrate patches.
* Run "debian/rules check-source". Update debian/copyright accordingly.
Debian Policy Compliance
========================
Here's a copy of material from
/usr/share/doc/debian-policy/upgrading-checklist.txt.gz, annotated with my
comments regarding each requirement's applicability to the xtrs package.
Unlike the Policy Manual's copy, this is in (forward, not reverse) chronological
order.
10.11. Version 3.9.8
====================
Released April, 2016.
9.6
The menu system is deprecated in favor of the FreeDesktop menu
standard. New requirements set for FreeDesktop menu entries.
[GBR] Not applicable. xtrs provides no icon, so cannot comply with the
FreeDesktop menu standard.
9.7
New instructions for registering media type handlers with the
FreeDesktop system, which automatically synchronizes with mailcap
and therefore replaces mailcap registration for packages using
desktop entries.
[GBR] Not applicable. xtrs provides no icon, so cannot comply with the
FreeDesktop menu standard. xtrs also provides no MIME file-type handler.
(If a virtual machine dump format for TRS-80 emulators is ever developed,
that may change.)
10.10. Version 4.0.0
====================
Released May, 2017.
4.3
"config.sub" and "config.guess" should be updated at build time or
replaced with the versions from autotools-dev.
[GBR] Not applicable. Perhaps incredibly, xtrs builds on all of Debian's
supported architectures (and a few others) without the use of Autoconf. :)
All build configuration options are found in Makefile.local, which is only
18 lines after blank and comment lines are stripped.
4.9
New "TARGET" set of "dpkg-architecture" variables and new
"DEB_*_ARCH_BITS" and "DEB_*_ARCH_ENDIAN" variables.
[GBR] Not (apparently) applicable; xtrs seems to build fine (see above) on
Debian hosts with varying machine word sizes and endiannesses.
4.9.1
New "DEB_BUILD_OPTIONS" tag, "nodoc", which says to suppress
documentation generation (but continue to build all binary
packages, even documentation packages, just let them be mostly
empty).
[GBR] Updated
debian/patches/make-plain-text-docs-from-html.patch
debian/patches/makefile-generate-pdf-manpages.patch
to respect this build option.
5.2
Automatically-generated debug packages do not need to have a
corresponding paragraph in "debian/control". (This is existing
practice; this Policy update is just clearer about it.)
[GBR] Already compliant.
5.6.12
Colons are not permitted in upstream version numbers.
[GBR] Not applicable; upstream doesn't use them.
7.7
New "Build-Depends-Arch" and "Build-Conflicts-Arch" fields are now
supported.
[GBR] Not applicable; no arch-independent packages are built.
8.4
The recommended package name for shared library development files
is now libraryname-dev or librarynameapiversion-dev, not
librarynamesoversion-dev.
[GBR] Not applicable; no libraries are built.
9.1.1
The stable release of Debian supports "/run", so packages may now
assume that it exists and do not need any special dependency on a
version of initscripts.
[GBR] Not applicable; no services are built.
9.3.2
New optional "try-restart" standard init script argument, which (if
supported) should restart the service if it is already running and
otherwise just report success.
[GBR] Not applicable; no services are built.
9.3.2
Support for the "status" init script argument is recommended.
[GBR] Not applicable; no services are built.
9.3.3.2
Packages must not call "/etc/init.d" scripts directly even as a
fallback, and instead must always use "invoke-rc.d" (which is
essential and shouldn’t require any conditional).
[GBR] Not applicable; no services are built.
9.11.1
Instructions for "upstart" integration removed since "upstart" is
no longer maintained in Debian.
[GBR] Not applicable; no services are built.
10.1
Packages may not install files in both "/path" and "/usr/path", and
must manage any backward-compatibility symlinks so that they don’t
break if "/path" and "/usr/path" are the same directory.
[GBR] Already compliant; everything goes into /usr.
10.6
Packages should assume device files in "/dev" are dynamically
managed and don’t have to be created by the package. Packages other
than those whose purpose is to manage "/dev" must not create or
remove files there when a dynamic management facility is in use.
Named pipes and device files outside of "/dev" should normally be
created on demand via init scripts, systemd units, or similar
mechanisms, but may be created and removed in maintainer scripts if
they must be created during package installation.
[GBR] Already compliant; the device files xtrs opens (/dev/dsp, /dev/fd[01],
/dev/tty[0S]0) are assumed to be present, and regard their management as
someone else's problem.
10.9
Checking with the base-passwd maintainer is no longer required (or
desirable) when creating a new dynamic user or group in a package.
[GBR] Not applicable; xtrs requires creation of no users or groups, and
doesn't even call any [GU]ID-related C library functions apart from ones I
disabled in debian/patches/add-ifdef-guards-around-setuid.patch.
12.3
Dependencies on *-doc packages should be at most Recommends
(Suggests if they only include documentation in supplemental
formats).
[GBR] Already compliant; no -doc dependencies of any strength present.
12.5
The Mozilla Public License 1.1 and 2.0 (MPL-1.1 and MPL-2.0) are
now included in "/usr/share/common-licenses" and do not need to be
copied verbatim in the package "copyright" file.
[GBR] Not applicable; those licenses are not used.
copyright-format
The "https" form of the copyright-format URL is now allowed and
preferred in the "Format" field.
[GBR] Not applicable; Tim doesn't support HTTPS at his site yet.
perl
The Perl search path now includes multiarch directories. The vendor
directory for architecture-specific modules is now versioned to
support multiarch.
[GBR] Not applicable; no aspect of xtrs is implemented in Perl.
virtual
New "adventure" virtual package for implementations of the classic
Colossal Cave Adventure game.
[GBR] Not applicable, but now I'm going to waste time finding out just how
many implementations of Colossal Cave are _in_ Debian...
virtual
New "httpd-wsgi3" virtual package for Python 3 WSGI-capable HTTP
servers. The existing "httpd-wsgi" virtual package is for Python 2
WSGI-capable HTTP servers.
[GBR] Not applicable; xtrs does not provide an HTTP server.
virtual
New "virtual-mysql-client", "virtual-mysql-client-core", "virtual-
mysql-server", "virtual-mysql-server-core", and "virtual-mysql-
testsuite" virtual packages for MySQL-compatible software.
[GBR] Not applicable; xtrs does not make or offer MySQL connections.
vim:set ai et ts=2 sw=2 tw=80:
|
