commit 38cb327bdb45362994c1b56df5899d5246b54424
from: Stefan Sperling <stsp@stsp.name>
date: Tue Nov 24 22:17:54 2020 UTC

document tog ref

commit - 6458efa5c16a7c2047493dd0b0ba8b6c2f7cf79e
commit + 38cb327bdb45362994c1b56df5899d5246b54424
blob - bba1d695475b78e770ce4a96eb79d9359c360c0e
blob + b9039109116c48628a65c69638b420af1b40844d
--- tog/tog.1
+++ tog/tog.1
@@ -50,6 +50,8 @@ Displays changes made in a particular commit.
 Displays the line-by-line history of a file.
 .It Tree view
 Displays the tree corresponding to a particular commit.
+.It Ref view
+Displays references in the repository.
 .El
 .Pp
 .Nm
@@ -144,6 +146,13 @@ Reload the log view and toggle display of merged commi
 The
 .Fl b
 option determines whether merged commits are displayed initially.
+.It Cm r
+Open a
+.Cm ref
+view listing all references in the repository.
+This can then be used to open a new
+.Cm log
+view for arbitrary branches and tags.
 .El
 .Pp
 The options for
@@ -365,6 +374,56 @@ Start traversing history at the specified
 The expected argument is the name of a branch or a commit ID SHA1 hash.
 An abbreviated hash argument will be expanded to a full SHA1 hash
 automatically, provided the abbreviation is unique.
+.It Fl r Ar repository-path
+Use the repository at the specified path.
+If not specified, assume the repository is located at or above the current
+working directory.
+If this directory is a
+.Xr got 1
+work tree, use the repository path associated with this work tree.
+.El
+.It Cm ref Oo Fl r Ar repository-path Oc
+Display references in the repository.
+.Pp
+The key bindings for
+.Cm tog ref
+are as follows:
+.Bl -tag -width Ds
+.It Cm Down-arrow, j
+Move the selection cursor down.
+.It Cm Up-arrow, k
+Move the selection cursor up.
+.It Cm Page-down, Ctrl+f
+Move the selection cursor down one page.
+.It Cm Page-up, Ctrl+b
+Move the selection cursor up one page.
+.It Cm Enter
+Open a log view which begins traversing history at the commit resolved via the
+currently selected reference.
+.It Cm i
+Show object IDs for all non-symbolic references displayed in the
+.Cm ref
+view.
+.It Cm /
+Prompt for a search pattern and start searching for matching references.
+The search pattern is an extended regular expression which is matched
+against absolute reference names.
+Regular expression syntax is documented in
+.Xr re_format 7 .
+.It Cm n
+Find the next reference which matches the current search pattern.
+.It Cm N
+Find the previous reference which matches the current search pattern.
+.It Cm Ctrl+l
+Reload the list of references displayed by the
+.Cm ref
+view.
+.El
+.Pp
+The options for
+.Cm tog ref
+are as follows:
+.Bl -tag -width Ds
 .It Fl r Ar repository-path
 Use the repository at the specified path.
 If not specified, assume the repository is located at or above the current
@@ -447,6 +506,27 @@ The color used to mark up date information.
 If not set, the default value
 .Dq yellow
 is used.
+.It Ev TOG_COLOR_REFS_HEADS
+The color used to mark up references in the
+.Dq refs/heads/
+namespace.
+If not set, the default value
+.Dq green
+is used.
+.It Ev TOG_COLOR_REFS_TAGS
+The color used to mark up references in the
+.Dq refs/tags/
+namespace.
+If not set, the default value
+.Dq magenta
+is used.
+.It Ev TOG_COLOR_REFS_REMOTES
+The color used to mark up references in the
+.Dq refs/remotes/
+namespace.
+If not set, the default value
+.Dq yellow
+is used.
 .El
 .Sh EXIT STATUS
 .Ex -std tog