Clarify usage of 'parent' option in list files API
Document that the 'parent' option is only relevant when getting the
list of files for a merge commit, and when it is not specified the
files from the auto merge result are listed.
Change-Id: Ifcd81b8a55c380865cf08e7f7f3baae32cc2d5a7
diff --git a/Documentation/rest-api-changes.txt b/Documentation/rest-api-changes.txt
index 4f85d3a..4434c2e 100644
--- a/Documentation/rest-api-changes.txt
+++ b/Documentation/rest-api-changes.txt
@@ -4802,10 +4802,12 @@
finding a file by partial name. Clients that also need the FileInfo
should make two requests.
-The integer-valued request parameter `parent` changes the response to return a
-map of the files which are different in this commit compared to the given
-parent commit. This is useful for supporting review of merge commits. The value
-is the 1-based index of the parent's position in the commit object.
+For merge commits only, the integer-valued request parameter `parent`
+changes the response to return a map of the files which are different
+in this commit compared to the given parent commit. The value is the
+1-based index of the parent's position in the commit object. If not
+specified, the response contains a map of the files different in the
+auto merge result.
The request parameter `base` changes the response to return a map of the
files which are different in this commit compared to the given revision. The
