GIT-QRENAME(1)

NAME
git-qrename - rename the current, or any specified patch

SYNOPSIS
git qrename [<old-name>] <new-name>
git qmv [<old-name>] <new-name>

DESCRIPTION
The git qrename command renames the existing Git-MQ patch which is specified by the <old-name> argument, assigning it the name specified by the <new-name> argument, and updates the series and status files as may be necessary, to reflect the change.

Patches may be renamed, irrespective of the state of any guards to which they may be subject.

The git qmv form is a simple alias for git rename; both behave identically.

When both <old-name> and <new-name> are specified, then the patch specified by <old-name> will be renamed, regardless of whether it has been applied, or not.

If the <old-name> argument is not specified, then the name of the topmost applied patch is implied; in this case, the command fails if no patches have been applied.

EXIT STATUS
On successful completion, git qrename reports an exit status code of 0. Any non-zero exit status code indicates that an error occurred.

COMPARISON WITH MERCURIAL QUEUES
Inspired by, and for the most part based on behavioural observation of Mercurial's MQ extension, the git qrename command exhibits fundamentally the same behaviour as its hg qrename counterpart.

AUTHOR
Copyright (C) 2019, 2022, by Keith Marshall

This man page was written by Keith Marshall <keith@users.osdn.me>, to accompany the Git-MQ program suite. It is published under the terms of the GNU Free Documentation Licence, version 1.3, (or any later version published by the Free Software Foundation), with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

The Git-MQ program suite itself is distibruted under the terms of the GNU General Public Licence, version 3, (or any later version published by the Free Software Foundation).

Copies of the GNU Free Documentation Licence, and of the GNU General Public Licence, are included within the Git-MQ source distribution, in the files FDL-1.3, and LICENCE, respectively.

SEE ALSO
git-qapplied(1), git-qguard(1), git-qselect(1), git-qseries(1), git-qtop(1)