From 62cf4f782cda29e3c7a8c3bfa868722b242c728a Mon Sep 17 00:00:00 2001 From: Andrew Sichevoi Date: Tue, 15 May 2018 12:45:16 +0300 Subject: [PATCH] doc: basic README added --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..006a3b7 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# git-purged +git-purged - a git sub command to list branches already removed on remote origin + +## Overview + +A tiny tool to list branches which are already purged from a remote origin. A cross-platform and easy-to-use alternative for grep'ing `git`'s output. The main purpose of the `git-purged` is to provide a convinient way for scripting deletion of obsolete git branches. + +## Build + +Since the tool was intentionally written with using no external dependencies, the following should be enough to a get a self-contained binary: + + make build + +will produce `git-purged` (`git-purged.exe` for MS Windows) binary in `build/` directory. + +## Usage + +The only requirement is `git` command availability through `${PATH}` (`%PATH%`) global environment variable. + +### List purged + +Run with not arguments. Default behavior. + +### List non-purged + + git-purged --inverse + +# License + +MIT + -- 2.20.1