Bug#759186: debian-policy: please consider adding "nodoc" as a possible value for DEB_BUILD_OPTIONS to policy
Package: debian-policy
Severity: wishlist
Hi,
please consider adding "nodoc" as a possible DEB_BUILD_OPTIONS value to
§ 4.9.1 [1].
The value "nodoc" or "nodocs" is currently used in 72 source packages
according to [2]. Documenting "nodoc" in policy would avoid the
confusion between the two. The singular should be preferred because
"nocheck" is written in singular as well and because *-doc packages have
the singular as a postfix.
When bootstrapping, a common approach is to do a build without documentation to
be able to drop the build dependencies on documentation building tools. This is
why the build profile name "nodoc" exists which, if enabled, allows
builds without documentation [3]. It would make sense to allow this
value in DEB_BUILD_OPTIONS as well as the build profile "nocheck" was
also borrowed from DEB_BUILD_OPTIONS.
Thanks!
cheers, josch
[1] https://www.debian.org/doc/debian-policy/ch-source.html#s-debianrules-options
[2] http://codesearch.debian.net/search?prev=&q=(nodoc.*DEB_BUILD_OPTIONS)+path%3Adebian%2Frules&skip=0
[3] https://wiki.debian.org/BuildProfileSpec
-- System Information:
Debian Release: jessie/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 3.14-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Reply to: