X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2Frgit.git;a=blobdiff_plain;f=README;h=90440a6bbb16b4ea4c0234062b4070bffd33382e;hp=bccfd0b92c7e9e6f82abff64890f0fd72c2c27d6;hb=HEAD;hpb=0c3a62e21d624c6076fc69dd2310bea0dd556ab8 diff --git a/README b/README index bccfd0b..90440a6 100644 --- a/README +++ b/README @@ -3,43 +3,48 @@ NAME directory tree. VERSION - Version 0.05 + Version 0.08 SYNOPSIS rgit [-K|-I|-D|-V] [GIT_OPTIONS] COMMAND [COMMAND_ARGS] DESCRIPTION - This utility recursively searches in the current directory (or in the - directory given by the "GIT_DIR" environment variable if it's set) for - all git repositories, sort this list by the repository path, "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 "GIT_DIR" environment variable) for all git repositories, sort + this list by the repository path, "chdir" into each of them, and + executes the specified git command. For efficiency reasons, repositories + located inside a bare repository or under the .git directory of a work + repository won't be searched for. - * "^n" with the current repository name. + Moreover, those formats are substituted in the arguments before running + the command : - * "^g" with the relative path to the current repository. + * %n with the current repository name. - * "^G" with the absolute path to the current repository. + * %g with the relative path (based from the root directory) to the + current repository. - * "^w" with the relative path to the current repository's working - directory. + * %G with the absolute path to the current repository. + + * %w with the relative path (based from the root directory) to the + current repository's working directory. - * "^W" with the absolute path to the current repository's working + * %W with the absolute path to the current repository's working directory. - * "^b" with a "bareified" relative path, i.e. "^g" if this is a bare - repository, and "^w.git" otherwise. + * %b with a "bareified" relative path, i.e. %g if this is a bare + repository, and "%w.git" otherwise. - * "^B" with an absolute version of the "bareified" path. + * %B with an absolute version of the "bareified" path. - * "^R" with the absolute path to the current root directory. + * %R with the absolute path to the root directory. - * "^^" with a bare "^". + * "%%" with a bare "%". There are actually a few commands that are only executed once in the - current directory : "daemon", "gui", "help", "init" and "version". For - any of those, no format substitution is done. + root directory : "daemon", "gui", "help", "init" and "version". For any + of those, no format substitution is done. You can specify which "git" executable to use with the "GIT_EXEC_PATH" environment variable. @@ -75,18 +80,16 @@ EXAMPLES Tag all the repositories with their name : - rgit tag ^n + rgit tag %n Add a remote to all repositories in "/foo/bar" to their bare counterpart in "qux" on host : - GIT_DIR="/foo/bar" rgit remote add host git://host/qux/^b + GIT_DIR="/foo/bar" rgit remote add host git://host/qux/%b DEPENDENCIES - The core modules Carp, Config, Cwd, Exporter, File::Find, - File::Spec::Functions and POSIX. - - Object::Tiny. + The core modules Carp, Config, Cwd, Exporter, File::Find, File::Spec and + POSIX. AUTHOR Vincent Pit, "", . @@ -109,7 +112,7 @@ SUPPORT . COPYRIGHT & LICENSE - Copyright 2008 Vincent Pit, all rights reserved. + Copyright 2008,2009,2010 Vincent Pit, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.