Add JavaDoc for the ChangeEdits.delete method
Change-Id: I28b82daff2bbf19b9fa0c57b229e8e3a096134cb
Signed-off-by: Edwin Kempin <ekempin@google.com>
diff --git a/java/com/google/gerrit/server/restapi/change/ChangeEdits.java b/java/com/google/gerrit/server/restapi/change/ChangeEdits.java
index 37a1699..826c792 100644
--- a/java/com/google/gerrit/server/restapi/change/ChangeEdits.java
+++ b/java/com/google/gerrit/server/restapi/change/ChangeEdits.java
@@ -119,6 +119,12 @@
return post;
}
+ /**
+ * This method is invoked if a DELETE request on a non-existing member is done. For change edits
+ * this is the case if a DELETE request for a file in a change edit is done and the change edit
+ * doesn't exist yet (and hence the parse method returned ResourceNotFoundException). In this case
+ * we want to create the change edit on the fly and delete the file with the given id in it.
+ */
@Override
public DeleteFile delete(ChangeResource parent, IdString id) throws RestApiException {
// It's safe to assume that id can never be null, because
