X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=README;h=c622ecd91569b8e677af6cb072898243a7c6ad31;hb=refs%2Fheads%2Fdist;hp=a5e5712b2790ec9ac9530476265e44cfb468ec85;hpb=0047d0a57e8ffe0d7cfde415fa6f50dae30201d1;p=chaz%2Fgit-codeowners diff --git a/README b/README index a5e5712..c622ecd 100644 --- a/README +++ b/README @@ -4,13 +4,15 @@ NAME VERSION - version 0.41 + version 0.50 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] @@ -90,7 +92,7 @@ OPTIONS --shell-completion - eval "$(lintany --shell-completion)" + eval "$(git-codeowners --shell-completion)" Print shell code to enable completion to STDOUT, and exit. @@ -100,18 +102,35 @@ COMMANDS 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] @@ -144,7 +163,7 @@ FORMAT * 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: @@ -177,7 +196,7 @@ FORMAT * 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 @@ -188,6 +207,10 @@ FORMAT The list of available modules is at "@BACKENDS" in Text::Table::Any. +CAVEATS + + * Some commands require git (at least version 1.8.5). + BUGS Please report any bugs or feature requests on the bugtracker website @@ -202,7 +225,7 @@ AUTHOR COPYRIGHT AND LICENSE - This software is copyright (c) 2019 by Charles McGarvey. + This software is copyright (c) 2021 by Charles McGarvey. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.