Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
GIT-REAUTHOR(1) 		   Git Extras			 GIT-REAUTHOR(1)

NAME
     git-reauthor - Rewrite history to change author's identity

SYNOPSIS
     git reauthor [<options>]

DESCRIPTION
     Lets  you	replace  the  author  and/or committer identities in commits and
     tags.

     The command goes through  all  existing  commits  and  tags  in  all  local
     branches to selectively modify the identities present in those objects. All
     the other information such as dates, messages,.. are preserved.

     You can rewrite all the identities in the commits and tags objects by using
     the  --all  flag,	or  only  replace the identities whose email matches the
     value of the --old-email option. It is also possible to limit  the  rewrite
     to a certain type of identity: the author or the committer identity. By de-
     fault, both of them are affected.
     For  each	of those identities to update, the command will replace the name
     and/or email with the new correct values as defined via the options. If the
     new identity name to set is not defined, the current one will be kept  (and
     vice-versa with the email).

     WARNING! This command rewrites history and as a result you will not able to
     push your branch to the remote without using the --force option.
     See more information with git help filter-branch.

OPTIONS
     -a, --all

	 Rewrite ALL identities in commits and tags.

     -c, --use-config

	 Define correct values from user Git config
	 Values of --correct-email and --correct-name options take precedence over the ones from the config if specified as well

     -e, --correct-email <email>

	 Define the correct email to set
	 Empty email '' is allowed

     -n, --correct-name <name>

	 Define the correct name to set
	 Empty name '' is not allowed

     -o, --old-email <email>

	 Rewrite identities matching old email in commits and tags
	 Empty email '' is allowed

     -t, --type <id>

	 Define the type of identities affected by the rewrite
	 Possible type identifiers are: author, committer, both (default)

EXAMPLES
     Replace the personal email and name of Jack to his work ones

	 $ git reauthor --old-email jack@perso.me --correct-email jack@work.com --correct-name 'Jack Foobar'

     Replace the email and name of Jack to the ones defined in the Git config

	 $ git reauthor --old-email jack@perso.me --use-config

     Replace only the email of Jack (keep the name already used)

	 $ git reauthor --old-email jack@perso --correct-email jack@perso.me

     Change  only  the	committer  email  of Jack (keep the author email already
     used)

	 $ git reauthor --old-email jack@perso.me --correct-email jack@work.com --type committer

     Change only the name and keep email to merge one user with multiple pseudo-
     nyms.

	 $ git reauthor --old-email jack@perso.me --correct-name Jack

     Set Jack's identity as the only one of the whole repository

	 $ git reauthor --all --correct-email jack@perso.me --correct-name Jack

     Set Jack as the only committer of the whole repository (keeps authors)

	 $ git reauthor --all --correct-email jack@perso.me --correct-name Jack --type committer

AUTHOR
     Written by Damien Tardy-Panis <damien@tardypad.me>

REPORTING BUGS
     <https://github.com/tj/git-extras/issues>

SEE ALSO
     <https://github.com/tj/git-extras>

				 September 2019 		 GIT-REAUTHOR(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=git-reauthor&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help