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


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to