From 9da751425d92f0954f777a6934a825f74bcc8479 Mon Sep 17 00:00:00 2001
From: Charles McGarvey <chazmcgarvey@brokenzipper.com>
Date: Tue, 12 Nov 2019 21:53:15 -0700
Subject: [PATCH] Release App-Codeowners 0.42

  * Add "projects" command to list defined projects.
  * Add flags to filter matches with the "show" command.
  * Remove unused Text::Table suggested dependency.
  * Fix tests to skip if not git 1.8.5+ (thanks CPAN testers).
---
 Changes   |  8 +++++++-
 README.md | 31 ++++++++++++++++++++++++++-----
 2 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/Changes b/Changes
index 12dd0d1..ba057db 100644
--- a/Changes
+++ b/Changes
@@ -2,5 +2,11 @@ Revision history for App-Codeowners.
 
 {{$NEXT}}
 
+0.42      2019-11-12 21:52:12-07:00 MST7MDT
+  * Add "projects" command to list defined projects.
+  * Add flags to filter matches with the "show" command.
+  * Remove unused Text::Table suggested dependency.
+  * Fix tests to skip if not git 1.8.5+ (thanks CPAN testers).
+
 0.41      2019-11-09 17:45:16-07:00 MST7MDT
-  * First public release
+  * First public release.
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
-- 
2.45.2