X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;ds=sidebyside;f=misc%2Fgsu%2Fsubcommand;fp=misc%2Fgsu%2Fsubcommand;h=a04b8dece11660f1b95946c8108f5f9ceacf8a76;hb=60d4f23ecb9efd3b8904ef40712906e63008c48a;hp=f1685aa1e416af8bf3ddb3d78a2a93ec1f9bacaa;hpb=64ebbbd2e3f5787ca4245f165507a882872b97c3;p=gsu.git

diff --git a/misc/gsu/subcommand b/misc/gsu/subcommand
index f1685aa..a04b8de 100644
--- a/misc/gsu/subcommand
+++ b/misc/gsu/subcommand
@@ -11,8 +11,16 @@ _gsu_usage()
 	gsu_short_msg "# Usage: $_gsu_self command [options]"
 }
 
-# Each line matching this is recognized as a subcommand. The name of the may be
-# given as $1. In any case the subcommand is the first subexpression.
+# Return an extended regular expression to match against $0.
+#
+# When called without argument, the expression matches all lines which define a
+# subcommand.
+#
+# If an argument is given, the returned expression matches only the subcommand
+# passed as $1. This is useful to tell if a string is a valid subcommand.
+#
+# Regardless of whether an argument is given, the returned expression contains
+# exactly one parenthesized subexpression for matching the command name.
 _gsu_get_command_regex()
 {
 	local cmd="${1:-[-a-zA-Z_0-9]+}"