Merge branch 'stable-2.15' into stable-2.16 * stable-2.15: Add 'Move a Change' section to user guide Change-Id: Ia8992563f5cb9386fcc333dc7ba698e39d2fc074
diff --git a/Documentation/intro-user.txt b/Documentation/intro-user.txt index b566a02..74a1a44 100644 --- a/Documentation/intro-user.txt +++ b/Documentation/intro-user.txt
@@ -443,6 +443,23 @@ [NOTE] Never rebase commits that are already part of a central branch. +[[move]] +== Move a Change + +Changes can be link:rest-api-changes.html#move-change[moved] to a desired +destination branch in the same project. This is useful in cases where +development activity switches from one branch to another and there is a +need to move open changes on the inactive branch to the new active one. +Another useful case is to move changes from a newer branch back to an older +bugfix branch where an issue first appeared. + +Users can move a change only if they have link:access-control.html#category_abandon[ +abandon permission] on the change and link:access-control.html#category_push[ +push permission] on the destination branch. + +The move operation will not update the change's parent and users will have +to link:#rebase[rebase] the change. Also, merge commits cannot be moved. + [[abandon]] [[restore]] == Abandon/Restore a Change