| `<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. |