From ffde7b8cb46a25b16ca28cd39665489d83102456 Mon Sep 17 00:00:00 2001 From: daniel Date: Tue, 24 Sep 2019 19:18:08 +0200 Subject: [PATCH] Improve documentation of newRevisionsFromBatch() Document purpose and behavior of the $title parameter. Bug: T228988 Change-Id: I89966321ec3b4feb5a59e06b8a656d76c4bd9ef2 --- includes/Revision/RevisionStore.php | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/includes/Revision/RevisionStore.php b/includes/Revision/RevisionStore.php index 3ecef76fa0..a5cf8404cb 100644 --- a/includes/Revision/RevisionStore.php +++ b/includes/Revision/RevisionStore.php @@ -1907,7 +1907,11 @@ class RevisionStore * 'content'- whether the actual content of the slots should be * preloaded. * @param int $queryFlags - * @param Title|null $title + * @param Title|null $title The title to which all the revision rows belong, if there + * is such a title and the caller has it handy, so we don't have to look it up again. + * If this parameter is given and any of the rows has a rev_page_id that is different + * from $title->getArticleID(), an InvalidArgumentException is thrown. + * * @return StatusValue a status with a RevisionRecord[] of successfully fetched revisions * and an array of errors for the revisions failed to fetch. */ -- 2.20.1