// Copyright (C) 2014 The Android Open Source Project
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.gerrit.extensions.client;

/* Current state within the basic workflow of the change **/
public enum ChangeStatus {

  /**
   * Change is open and pending review, or review is in progress.
   *
   * <p>
   * This is the default state assigned to a change when it is first created
   * in the database. A change stays in the NEW state throughout its review
   * cycle, until the change is submitted or abandoned.
   *
   * <p>
   * Changes in the NEW state can be moved to:
   * <ul>
   * <li>{@link #MERGED} - when the Submit Patch Set action is used;
   * <li>{@link #ABANDONED} - when the Abandon action is used.
   * </ul>
   */
  NEW,

  /**
   * Change is a draft change that only consists of draft patchsets.
   *
   * <p>
   * This is a change that is not meant to be submitted or reviewed yet. If
   * the uploader publishes the change, it becomes a NEW change.
   * Publishing is a one-way action, a change cannot return to DRAFT status.
   * Draft changes are only visible to the uploader and those explicitly
   * added as reviewers.
   *
   * <p>
   * Changes in the DRAFT state can be moved to:
   * <ul>
   * <li>{@link #NEW} - when the change is published, it becomes a new change;
   * </ul>
   */
  DRAFT,

  /**
   * Change is closed, and submitted to its destination branch.
   *
   * <p>
   * Once a change has been merged, it cannot be further modified by adding a
   * replacement patch set. Draft comments however may be published,
   * supporting a post-submit review.
   */
  MERGED,

  /**
   * Change is closed, but was not submitted to its destination branch.
   *
   * <p>
   * Once a change has been abandoned, it cannot be further modified by adding
   * a replacement patch set, and it cannot be merged. Draft comments however
   * may be published, permitting reviewers to send constructive feedback.
   */
  ABANDONED
}
@@ -1664,16 +1664,71 @@
 viewers.
+ Note that currently draft changes cannot be abandoned.
 %0A   *%0A  
@@ -1870,17 +1870,17 @@
 w change
-;
+.
 %0A   * %3C/
@@ -2509,16 +2509,161 @@
 edback.%0A
+   *%0A   * %3Cp%3E%0A   * Changes in the ABANDONED state can be moved to:%0A   * %3Cul%3E%0A   * %3Cli%3E%7B@link #NEW%7D - when the Restore action is used.%0A   * %3C/ul%3E%0A
    */%0A  
@@ -2673,8 +2673,9 @@
 NDONED%0A%7D
+%0A

Clarify that an ABANDONED change can be restored