[debhelper-devel] [debhelper] 01/02: Document directory requirement for all debhelper tools

[Niels Thykier]

This is an automated email from the git hooks/post-receive script.

nthykier pushed a commit to branch master
in repository debhelper.

commit 2de2d4a357360b93c91d6dc6451ec26669ead801
Author: Niels Thykier <niels at thykier.net>
Date:   Sun Oct 22 08:06:28 2017 +0000

    Document directory requirement for all debhelper tools
    
    Signed-off-by: Niels Thykier <niels at thykier.net>
---
 debhelper.pod    | 5 +++++
 debian/changelog | 8 ++++++++
 dh               | 4 +++-
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/debhelper.pod b/debhelper.pod
index 634ba53..068eadb 100644
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -28,6 +28,11 @@ package, which contains a L<dh_make|dh_make(1)> command that partially
 automates the process. For a more gentle introduction, the B<maint-guide> Debian 
 package contains a tutorial about making your first package using debhelper.
 
+Except where tool explicitly denotes otherwise, all of the debhelper
+tools assumes that they run from root directory of an unpacked source
+package.  This is so they can locate find F<debian/control> and
+F<debian/compat> when needed.
+
 =head1 DEBHELPER COMMANDS
 
 Here is the list of debhelper commands you can use. See their man
diff --git a/debian/changelog b/debian/changelog
index 6853e75..6631221 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,11 @@
+debhelper (10.11) UNRELEASED; urgency=medium
+
+  * debhelper.pod: Document that all tools by default must be run
+    in the root of an unpacked source.
+  * dh: Clarify that --list can be run anywhere.
+
+ -- Niels Thykier <niels at thykier.net>  Sun, 22 Oct 2017 08:04:11 +0000
+
 debhelper (10.10) unstable; urgency=medium
 
   * dh_installsystemd: Improve error messages to include the actual
diff --git a/dh b/dh
index 721b842..f94b0ae 100755
--- a/dh
+++ b/dh
@@ -64,7 +64,9 @@ listed, separated by commas.
 
 List all available addons.
 
-This can be used without a F<debian/compat> file.
+When called only with this option, B<dh> can be called from any
+directory (i.e. it does not need access to files from a source
+package).
 
 =item B<--no-act>
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debhelper/debhelper.git