Bug#773388: debuild: Please add undocumented options to manpage

[Christoph Biedl]

Package: devscripts
Version: 2.14.11
Severity: wishlist

Dear Maintainer,

after I was told to use debuild's -v${previous_version} option, I
wanted to learn more about it - to find it's not mentioned anywhere in
the manpage. Please add a description for all options debuild
understands. Even if it's just passed to other programs like
dpkg-genchanges in that case.

Appearently this applies for other options, too. The block that
handles -v understands several more options I couldn't find in the
manpage, like -p, -s, -a, -Z, or -z.

    Christoph

-- Package-specific info:

--- /etc/devscripts.conf ---

--- ~/.devscripts ---
Not present

-- System Information:
Debian Release: 8.0
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 3.18.1-rc1 (SMP w/4 CPU cores; PREEMPT)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages devscripts depends on:
ii  dpkg-dev     1.17.21
ii  libc6        2.19-13
ii  perl         5.20.1-3
ii  python3      3.4.2-2
pn  python3:any  <none>

Versions of packages devscripts recommends:
pn  at                          <none>
pn  dctrl-tools                 <none>
pn  debian-keyring              <none>
pn  dput | dupload              <none>
pn  equivs                      <none>
ii  fakeroot                    1.20.2-1
ii  file                        1:5.20-2
ii  gnupg                       1.4.18-6
pn  libdistro-info-perl         <none>
ii  libencode-locale-perl       1.03-1
ii  libjson-perl                2.61-1
ii  liblwp-protocol-https-perl  6.06-2
ii  libparse-debcontrol-perl    2.005-4
pn  libsoap-lite-perl           <none>
ii  liburi-perl                 1.64-1
ii  libwww-perl                 6.08-1
ii  lintian                     2.5.30+deb8u3
ii  man-db                      2.7.0.2-4
ii  patch                       2.7.1-6
ii  patchutils                  0.3.3-1
pn  python3-debian              <none>
pn  python3-magic               <none>
ii  sensible-utils              0.0.9
ii  strace                      4.9-2
pn  unzip                       <none>
ii  wdiff                       1.2.2-1
ii  wget                        1.16-1
ii  xz-utils                    5.1.1alpha+20120614-2+b3

Versions of packages devscripts suggests:
pn  bsd-mailx | mailx            <none>
ii  build-essential              11.7
pn  cvs-buildpackage             <none>
pn  debbindiff                   <none>
pn  devscripts-el                <none>
pn  gnuplot                      <none>
ii  gpgv                         1.4.18-6
pn  libauthen-sasl-perl          <none>
pn  libfile-desktopentry-perl    <none>
ii  libnet-smtp-ssl-perl         1.01-3
pn  libterm-size-perl            <none>
ii  libtimedate-perl             2.3000-2
pn  libyaml-syck-perl            <none>
pn  mutt                         <none>
ii  openssh-client [ssh-client]  1:6.7p1-3
pn  svn-buildpackage             <none>
pn  w3m                          <none>

-- no debconf information

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/devscripts-devel/attachments/20141217/86626f19/attachment.sig>