| `<pattern>...`:: |
| If one or more _<pattern>_ parameters are given, only refs are shown that |
| match against at least one pattern, either using `fnmatch`(3) or |
| literally, in the latter case matching completely or from the |
| beginning up to a slash. |
| |
| `--stdin`:: |
| The list of patterns is read from standard input instead of from |
| the argument list. |
| |
| `--count=<count>`:: |
| Stop after showing _<count>_ refs. |
| |
| `--sort=<key>`:: |
| Sort on the field name _<key>_. Prefix `-` to sort in |
| descending order of the value. When unspecified, |
| `refname` is used. You may use the `--sort=<key>` option |
| multiple times, in which case the last key becomes the primary |
| key. |
| |
| `--format[=<format>]`:: |
| A string that interpolates `%(fieldname)` from a ref being shown and |
| the object it points at. In addition, the string literal `%%` |
| renders as `%` and `%xx` - where `xx` are hex digits - renders as |
| the character with hex code `xx`. For example, `%00` interpolates to |
| `\0` (_NUL_), `%09` to `\t` (_TAB_), and `%0a` to `\n` (_LF_). |
| |
| When unspecified, _<format>_ defaults to `%(objectname) SPC %(objecttype) |
| TAB %(refname)`. |
| |
| `--color[=<when>]`:: |
| Respect any colors specified in the `--format` option. The |
| _<when__ field must be one of `always`, `never`, or `auto` (if |
| `<when>` is absent, behave as if `always` was given). |
| |
| `--shell`:: |
| `--perl`:: |
| `--python`:: |
| `--tcl`:: |
| If given, strings that substitute `%(fieldname)` |
| placeholders are quoted as string literals suitable for |
| the specified host language. This is meant to produce |
| a scriptlet that can directly be "eval"ed. |
| |
| `--points-at=<object>`:: |
| Only list refs which points at the given object. |
| |
| `--merged[=<object>]`:: |
| Only list refs whose tips are reachable from the |
| specified commit (`HEAD` if not specified). |
| |
| `--no-merged[=<object>]`:: |
| Only list refs whose tips are not reachable from _<object>_(`HEAD` if not |
| specified). |
| |
| `--contains[=<object>]`:: |
| Only list refs which contain _<object>_(`HEAD` if not specified). |
| |
| `--no-contains[=<object>]`:: |
| Only list refs which don't contain _<object>_ (`HEAD` |
| if not specified). |
| |
| `--ignore-case`:: |
| Sorting and filtering refs are case insensitive. |
| |
| `--omit-empty`:: |
| Do not print a newline after formatted refs where the format expands |
| to the empty string. |
| |
| `--exclude=<excluded-pattern>`:: |
| If one or more `--exclude` options are given, only refs which do not |
| match any _<excluded-pattern>_ parameters are shown. Matching is done |
| using the same rules as _<pattern>_ above. |
| |
| `--include-root-refs`:: |
| List root refs (`HEAD` and pseudorefs) apart from regular refs. |
| |
| `--start-after=<marker>`:: |
| Allows paginating the output by skipping references up to and including the |
| specified marker. When paging, it should be noted that references may be |
| deleted, modified or added between invocations. Output will only yield those |
| references which follow the marker lexicographically. Output begins from the |
| first reference that would come after the marker alphabetically. Cannot be |
| used with `--sort=<key>` or `--stdin` options, or the _<pattern>_ argument(s) |
| to limit the refs. |
