[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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: