=head1 DESCRIPTION
-This utility recursively searches in the current directory (or in the directory given by the C<GIT_DIR> environment variable if it's set) for all git repositories, sort this list by the repository path, C<chdir> into each of them, and executes the specified git command.
-Moreover, those formats are substuted in the arguments before running the command :
+This utility recursively searches in a root directory (which may be the current working directory or - if it has been set - the directory given by the C<GIT_DIR> environment variable) for all git repositories, sort this list by the repository path, C<chdir> into each of them, and executes the specified git command.
+Moreover, those formats are substituted in the arguments before running the command :
=over 4
=item *
-C<^g> with the relative path to the current repository.
+C<^g> with the relative path (based from the root directory) to the current repository.
=item *
=item *
-C<^w> with the relative path to the current repository's working directory.
+C<^w> with the relative path (based from the root directory) to the current repository's working directory.
=item *
=item *
-C<^R> with the absolute path to the current root directory.
+C<^R> with the absolute path to the root directory.
=item *
=back
-There are actually a few commands that are only executed once in the current directory : C<daemon>, C<gui>, C<help>, C<init> and C<version>.
+There are actually a few commands that are only executed once in the root directory : C<daemon>, C<gui>, C<help>, C<init> and C<version>.
For any of those, no format substitution is done.
You can specify which C<git> executable to use with the C<GIT_EXEC_PATH> environment variable.