commit - 543bec4ff9437a6e01b7e86770938007190e52df
commit + 7f5531cddb475a234ab659960efcb4f1aee3fb8d
blob - 918d723a3556ec33343925c453566d54da948b5f
blob + bfb448302ea698535fe6e4ac321cc6fcee5f640c
--- got/got.1
+++ got/got.1
the new version of the specified
.Ar branch
and the work tree is automatically switched to it.
+If author information is available via the
+.Ev GOT_AUTHOR
+environment variable,
+.Xr got.conf 5
+or Git's
+.Dv user.name
+and
+.Dv user.email
+configuration settings, this author information will be used to identify
+the
+.Dq committer
+of rebased commits.
.Pp
Old commits in their pre-rebase state are automatically backed up in the
.Dq refs/got/backup/rebase
.Dl Pq alias: Cm he
Edit commit history between the work tree's current base commit and
the tip commit of the work tree's current branch.
+.Pp
+The
+.Cm got histedit
+command requires the
+.Ev GOT_AUTHOR
+environment variable to be set,
+unless an author has been configured in
+.Xr got.conf 5
+or Git's
+.Dv user.name
+and
+.Dv user.email
+configuration settings can be obtained from the repository's
+.Pa .git/config
+file or from Git's global
+.Pa ~/.gitconfig
+configuration file.
.Pp
Before starting a
.Cm histedit
.Sh ENVIRONMENT
.Bl -tag -width GOT_AUTHOR
.It Ev GOT_AUTHOR
-The author's name and email address for
-.Cm got commit
-and
-.Cm got import ,
-for example:
+The author's name and email address, such as
.Dq An Flan Hacker Aq Mt flan_hacker@openbsd.org .
+Used by the
+.Cm got commit ,
+.Cm got import ,
+.Cm got rebase ,
+and
+.Cm got histedit
+commands.
Because
.Xr git 1
may fail to parse commits without an email address in author data,