X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Fgit-codeowners;a=blobdiff_plain;f=README.md;h=1c2acdf4f8409235487c76903955ebe9abf13d8e;hp=23a16ef24cb28cc77cce141b5cc47f72f031a1d1;hb=9da751425d92f0954f777a6934a825f74bcc8479;hpb=3c7ed3d762399efb2d01121392f7115104095788

diff --git a/README.md b/README.md
index 23a16ef..1c2acdf 100644
--- a/README.md
+++ b/README.md
@@ -4,13 +4,15 @@ git-codeowners - A tool for managing CODEOWNERS files
 
 # VERSION
 
-version 0.41
+version 0.42
 
 # SYNOPSIS
 
     git-codeowners [--version|--help|--manual]
 
-    git-codeowners [show] [--format FORMAT] [--[no-]project] [PATH...]
+    git-codeowners [show] [--format FORMAT] [--owner OWNER]...
+                   [--pattern PATTERN]... [--[no-]patterns]
+                   [--project PROJECT]... [--[no-]projects] [PATH...]
 
     git-codeowners owners [--format FORMAT] [--pattern PATTERN]
 
@@ -97,18 +99,33 @@ Does not yet support Zsh...
 
 ## show
 
-    git-codeowners [show] [--format FORMAT] [--[no-]project] [PATH...]
+    git-codeowners [show] [--format FORMAT] [--owner OWNER]...
+                   [--pattern PATTERN]... [--[no-]patterns]
+                   [--project PROJECT]... [--[no-]projects] [PATH...]
 
 Show owners of one or more files in a repo.
 
+If `--owner`, `--project`, `--pattern` are set, only show files with matching
+criteria. These can be repeated.
+
+Use `--patterns` to also show the matching pattern associated with each file.
+
+By default the output might show associated projects if the `CODEOWNERS` file
+defines them. You can control this by explicitly using `--projects` or
+`--no-projects` to always show or always hide defined projects, respectively.
+
 ## owners
 
     git-codeowners owners [--format FORMAT] [--pattern PATTERN]
 
+List all owners defined in the `CODEOWNERS` file.
+
 ## patterns
 
     git-codeowners patterns [--format FORMAT] [--owner OWNER]
 
+List all patterns defined in the `CODEOWNERS` file.
+
 ## create
 
     git-codeowners create [REPO_DIRPATH|CODEOWNERS_FILEPATH]
@@ -134,7 +151,7 @@ The `--format` argument can be one of:
 - `yaml` - YAML (requires [YAML](https://metacpan.org/pod/YAML))
 - `FORMAT` - Custom format (see below)
 
-## Custom
+## Format string
 
 You can specify a custom format using printf-like format sequences. These are the items that can be
 substituted:
@@ -159,7 +176,7 @@ Available filters:
 - `color:FFFFFF` - Colorize the replacement string (if color is ON).
 - `nocolor` - Do not colorize replacement string.
 
-## Table
+## Format table
 
 Table formatting can be done by one of several different modules, each with its own features and
 bugs. The default module is [Text::Table::Tiny](https://metacpan.org/pod/Text%3A%3ATable%3A%3ATiny), but this can be overridden using the
@@ -169,6 +186,10 @@ bugs. The default module is [Text::Table::Tiny](https://metacpan.org/pod/Text%3A
 
 The list of available modules is at ["@BACKENDS" in Text::Table::Any](https://metacpan.org/pod/Text%3A%3ATable%3A%3AAny#BACKENDS).
 
+# CAVEATS
+
+- Some commands require `git` (at least version 1.8.5).
+
 # BUGS
 
 Please report any bugs or feature requests on the bugtracker website