summaryrefslogtreecommitdiff
path: root/mk/help
diff options
context:
space:
mode:
authorrillig <rillig@pkgsrc.org>2007-02-05 14:27:34 +0000
committerrillig <rillig@pkgsrc.org>2007-02-05 14:27:34 +0000
commit38cb040e39b9458321c6ab61ddf63e1c27b7b67c (patch)
tree89fc03f925921a7baf5510766c4717db88c5ef7d /mk/help
parente150b2832a1c6e6399511d2c5cef09b543c476b3 (diff)
downloadpkgsrc-38cb040e39b9458321c6ab61ddf63e1c27b7b67c.tar.gz
More documentation for debugging pkgsrc.
Diffstat (limited to 'mk/help')
-rw-r--r--mk/help/debug.help29
1 files changed, 29 insertions, 0 deletions
diff --git a/mk/help/debug.help b/mk/help/debug.help
new file mode 100644
index 00000000000..f75ea5ed71e
--- /dev/null
+++ b/mk/help/debug.help
@@ -0,0 +1,29 @@
+# $NetBSD: debug.help,v 1.1 2007/02/05 14:27:34 rillig Exp $
+#
+# Since pkgsrc is a quite large and complex software system, it
+# sometimes isn't obvious what it is doing exactly. For that reason,
+# there are some variables that control how much details are shown to
+# the pkgsrc user.
+#
+# User-settable variables:
+#
+# PKG_DEBUG_LEVEL
+# How verbose should pkgsrc be when running shell commands?
+#
+# * 0: don't show most shell commands.
+# * 1: print the complete shell command to stdout before running
+# it.
+# * 2: like 1, but in addition, set the "-x" option of /bin/sh,
+# so that every single command is printed to stderr before
+# running it.
+#
+# PKG_VERBOSE
+# When this variable is defined, pkgsrc gets a bit more verbose.
+# This variable is largely independent from PKG_DEBUG_LEVEL.
+#
+# Default value: (undefined)
+#
+# XXX: Why are there _two_ variables doing similar things?
+#
+# Keywords: debug verbose
+#