control: tag -1 +patch
Hello,
On Sat 04 Aug 2018 at 06:14AM +0100, Ian Jackson wrote:
> I think this is needed because some build systems look at
> /etc/{services,protocols} at build-time to (for example) bake into the
> program the default port number, or, in some cases, protocol numbers.
> The values in these files are largely fixed or conventional, so this
> is quite appropriate. Expecting programs to add explicit dependencies
> on netbase for this seems silly - there is little benefit, since the
> files are small and the implementation of the lookup where done via
> the libc) is part of the libc. And of course any notionally-missing
> dependencies on netbase would not be discovered.
Thanks. Seems reasonable.
> I suggest this text:
> [...]
Here is the complete patch, for which I am seeking seconds:
diff --git a/policy/ch-source.rst b/policy/ch-source.rst
index 9e7d79c..011893c 100644
--- a/policy/ch-source.rst
+++ b/policy/ch-source.rst
@@ -40,9 +40,25 @@ example, if building a package requires a certain compiler, then the
compiler should be specified as a build-time dependency.
It is not necessary to explicitly specify build-time relationships on a
-minimal set of packages that are always needed to compile, link and put
-in a Debian package a standard "Hello World!" program written in C or
-C++. The required packages are called *build-essential*, and an
+minimal set of packages that are always needed
+
+- to compile, link and put in a Debian package a standard "Hello
+ World!" program written in C or C++;
+
+- for the package build to resolve the system hostname to a
+ fully-qualified domain name using the C standard library; and
+
+- for the package build to look up longstanding and conventionally
+ available service and protocol names and numbers, either by directly
+ reading /etc/services and /etc/protocols, or by using the
+ corresponding functions from the C standard library. [#]_
+
+ (If the package needs to look up a more recent service or protocol,
+ and certainly if the service or protocol was not listed in these
+ files in the package's targeted Debian releases, an appropriate
+ versioned build-dependency is needed.)
+
+The required packages are called *build-essential*, and an
informational list can be found in
``/usr/share/doc/build-essential/list`` (which is contained in the
``build-essential`` package). [#]_
@@ -757,6 +773,10 @@ according to this convention, the C source code of an executable
``debian/missing-sources/checksum/util.c``.
.. [#]
+ The functionality described in these last two list items is
+ provided by the "netbase" package at the time of writing.
+
+.. [#]
Rationale:
- This allows maintaining the list separately from the policy
--
Sean Whitton
Attachment:
signature.asc
Description: PGP signature