#773388 debuild: Please add undocumented options to manpage

Package:
devscripts
Source:
devscripts
Description:
scripts to make the life of a Debian Package maintainer easier
Submitter:
Christoph Biedl
Date:
2014-12-18 07:39:08 UTC
Severity:
wishlist
#773388#5
Date:
2014-12-17 20:36:06 UTC
From:
To:
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
--- /etc/devscripts.conf ---
--- ~/.devscripts --- Not present
#773388#10
Date:
2014-12-17 20:56:21 UTC
From:
To:
Hi,

Le 17/12/2014 16:36, Christoph Biedl a écrit :

It’s not a debuild option, but a dpkg-buildpackage one (they are
documented as explicitly accepted in the SYNOPSIS section:
	debuild [debuild options] [dpkg-buildpackage options] …)

Not sure debuild tries to understand options it passes to
dpkg-buildpackage(1) that is already explicitly part of the SEE ALSO
section.

I don’t believe it would be a good idea to maintain in devscripts
documentation of dpkg options, that may quickly be outdated, inaccurate
and non-exhaustive.

Regards

David, not a devscript maintainer, but interested in documentation
maintenance.

#773388#15
Date:
2014-12-18 07:30:00 UTC
From:
To:
David Prévot wrote...
is forwarded to other programs. So it's possible to have a complete
list, and "outdated" will happen only as a result of sloppy
development. Inaccurancy is not a problem if the debuild manpage
just tells "The following options are forwarded to dpkg-...", followed
by the list.

This however was enough information to guide the curious who want to
understand what a specific option does.

Disclaimer: I might have misunderstood how debuild actually deals with
@ARGV.

    Christoph