Merge pull request #21 from bexelbie/infinite_depth

Add infinite depth option

Author: fboender

README.md

@@ -1,7 +1,10 @@
 mgitstatus
 ==========
 
-Show uncommited, untracked and unpushed changes in multiple Git repositories.
+Show uncommited, untracked and unpushed changes in multiple Git
+repositories.  Scan for .git dirs up to **DEPTH** directories deep.
+The default is 2.  If **DEPTH** is 0, the scan is infinitely deep.
+mgitstatus shows:
 
 ![](https://raw.githubusercontent.com/fboender/mgitstatus/master/screenshot.png)
 
@@ -33,7 +36,9 @@ for that repo to `true`. (See "usage" below for an example).
 
     Usage: mgitstatus [--version] [-w] [-e] [-f] [--no-X] [DIR] [DEPTH=2]
 
-    Scan for .git dirs under DIR (up to DEPTH dirs deep) and show git status
+    Scan for .git dirs under DIR and show git status. The scan goes 2
+    directories deep by default or the number specified by DEPTH deep.
+    If DEPTH=0, the scan is infinitely deep.
 
       --version   Show version
       -w          Warn about dirs that are not Git repositories

mgitstatus

@@ -10,7 +10,9 @@ usage () {
     
 Usage: $0 [--version] [-w] [-e] [-f] [--no-X] [DIR] [DEPTH=2]
 
-Scan for .git dirs under DIR (up to DEPTH dirs deep) and show git status
+Scan for .git dirs under DIR and show git status. The scan goes 2
+directories deep by default or the number specified by DEPTH deep.
+If DEPTH=0, the scan is infinitely deep.
 
   --version  Show version
   -w         Warn about dirs that are not Git repositories
@@ -96,6 +98,8 @@ fi
 
 if [ -z "$2" ]; then
     DEPTH=2
+elif [ "$2" -eq 0 ]; then
+    DEPTH=""
 else
     DEPTH="$2"
 fi
@@ -121,7 +125,7 @@ C_UNTRACKED="$C_CYAN"
 C_STASHES="$C_YELLOW"
 
 # Find all .git dirs, up to DEPTH levels deep
-find -L "$ROOT_DIR" -maxdepth "$DEPTH" -type d | while read -r PROJ_DIR
+find -L "$ROOT_DIR" ${DEPTH:+"-maxdepth"} ${DEPTH:+"$DEPTH"} -type d | while read -r PROJ_DIR
 do
     GIT_DIR="$PROJ_DIR/.git"
     GIT_CONF="$PROJ_DIR/.git/config"

mgitstatus.1

@@ -1,4 +1,4 @@
-.\" Automatically generated by Pandoc 1.19.2.4
+.\" Automatically generated by Pandoc 2.2.1
 .\"
 .TH "MGITSTATUS" "1" "Jul 2019" "" ""
 .hy
@@ -8,12 +8,17 @@ mgitstatus \[en] Show uncommitted, untracked and unpushed changes for
 multiple Git repos.
 .SH SYNOPSIS
 .PP
-\f[B]mgitstatus\f[] [\f[B]\-\-version\f[]] [\f[B]\-w\f[]] [\f[B]\-e\f[]]
-[\f[B]\-f\f[]] [\f[B]\-\-no\-X\f[]] [\f[B]DIR\f[]] [\f[B]DEPTH=2\f[]]
+\f[B]mgitstatus\f[] [\f[B]\[en]version\f[]] [\f[B]\-w\f[]]
+[\f[B]\-e\f[]] [\f[B]\-f\f[]] [\f[B]\[en]no\-X\f[]] [\f[B]DIR\f[]]
+[\f[B]DEPTH=2\f[]]
 .SH DESCRIPTION
 .PP
 \f[B]mgitstatus\f[] shows uncommited, untracked and unpushed changes in
 multiple Git repositories.
+\f[B]mgitstatus\f[] scans for .git dirs up to \f[B]DEPTH\f[] directories
+deep.
+The default is 2.
+If \f[B]DEPTH\f[] is 0, the scan is infinitely deep.
 mgitstatus shows:
 .IP \[bu] 2
 \f[B]Uncommitted changes\f[] if there are unstaged or uncommitted
@@ -32,8 +37,7 @@ Changes in the branch may otherwise never be pushed or merged.
 \f[B]Needs pull (BRANCH)\f[] if the branch is tracking a (remote) branch
 which is ahead.
 This requires that the local git repo already knows about the remote
-changes (i.e.
-you\[aq]ve done a fetch), or that you specify the \-f option.
+changes (i.e.\ you've done a fetch), or that you specify the \-f option.
 mgitstatus does NOT contact the remote by default.
 .IP \[bu] 2
 \f[B]X stashes\f[] if there are stashes.
@@ -42,7 +46,7 @@ Since there are a lot of different states a git repository can be in,
 mgitstatus makes no guarantees that all states are taken into account.
 .SH OPTIONS
 .TP
-.B \f[B]\-\-version\f[]
+.B \f[B]\[en]version\f[]
 Show version
 .RS
 .RE
@@ -53,12 +57,12 @@ Warn about dirs that are not Git repositories
 .RE
 .TP
 .B \f[B]\-e\f[]
-Exclude repos that are \[aq]ok\[aq]
+Exclude repos that are `ok'
 .RS
 .RE
 .TP
 .B \f[B]\-f\f[]
-Do a \[aq]git fetch\[aq] on each repo (slow for many repos)
+Do a `git fetch' on each repo (slow for many repos)
 .RS
 .RE
 .TP
@@ -69,32 +73,32 @@ Force color output (preserve colors when using pipes)
 .PP
 You can limit output with the following options:
 .TP
-.B \f[B]\-\-no\-push\f[]
+.B \f[B]\[en]no\-push\f[]
 Do not show branches that need a push.
 .RS
 .RE
 .TP
-.B \f[B]\-\-no\-pull\f[]
+.B \f[B]\[en]no\-pull\f[]
 Do not show branches that need a pull.
 .RS
 .RE
 .TP
-.B \f[B]\-\-no\-upstream\f[]
+.B \f[B]\[en]no\-upstream\f[]
 Do not show branches that need an upstream.
 .RS
 .RE
 .TP
-.B \f[B]\-\-no\-uncommited\f[]
+.B \f[B]\[en]no\-uncommited\f[]
 Do not show branches that have unstaged or uncommitted changes.
 .RS
 .RE
 .TP
-.B \f[B]\-\-no\-untracked\f[]
+.B \f[B]\[en]no\-untracked\f[]
 Do not show branches that have untracked files.
 .RS
 .RE
 .TP
-.B \f[B]\-\-no\-stashes\f[]
+.B \f[B]\[en]no\-stashes\f[]
 Do now show stashes
 .RS
 .RE
@@ -121,7 +125,7 @@ $\ mgitstatus\ 3
 .fi
 .PP
 The following command scans three levels deep in \f[C]/opt/deploy/\f[]
-and hides repos that are \[aq]ok\[aq].
+and hides repos that are `ok'.
 It does not show stashes:
 .IP
 .nf

mgitstatus.1.md

@@ -13,7 +13,9 @@ mgitstatus – Show uncommitted, untracked and unpushed changes for multiple Git
 # DESCRIPTION
 
 **mgitstatus** shows uncommited, untracked and unpushed changes in multiple
-Git repositories. mgitstatus shows:
+Git repositories.  **mgitstatus** scans for .git dirs up to **DEPTH**
+directories deep.  The default is 2.  If **DEPTH** is 0, the scan is
+infinitely deep.  mgitstatus shows:
 
 - **Uncommitted changes** if there are unstaged or uncommitted changes on the
   checked out branch.