X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;ds=sidebyside;f=includes%2FStorage%2FSlotRecord.php;h=c7eb735db37f71ce29b5ae1f5ee1220e7f524fce;hb=74d04edec385aa86ee01943b9a27475d79f74e78;hp=dff4b031d40c63ca5259132f6351aabdabb289cc;hpb=55aab97bb4b507911e24995ae870b78f86c17557;p=lhc%2Fweb%2Fwiklou.git

diff --git a/includes/Storage/SlotRecord.php b/includes/Storage/SlotRecord.php
index dff4b031d4..c7eb735db3 100644
--- a/includes/Storage/SlotRecord.php
+++ b/includes/Storage/SlotRecord.php
@@ -451,6 +451,16 @@ class SlotRecord {
 	 * content has been stored in the content table. While building a new revision,
 	 * SlotRecords will not have an ID associated.
 	 *
+	 * Also, during schema migration, hasContentId() may return false when encountering an
+	 * un-migrated database entry in SCHEMA_COMPAT_WRITE_BOTH mode.
+	 * It will however always return true for saved revisions on SCHEMA_COMPAT_READ_NEW mode,
+	 * or without SCHEMA_COMPAT_WRITE_NEW mode. In the latter case, an emulated content ID
+	 * is used, derived from the revision's text ID.
+	 *
+	 * Note that hasContentId() returning false while hasRevision() returns true always
+	 * indicates an unmigrated row in SCHEMA_COMPAT_WRITE_BOTH mode, as described above.
+	 * For an unsaved slot, both these methods would return false.
+	 *
 	 * @since 1.32
 	 *
 	 * @return bool
@@ -494,6 +504,9 @@ class SlotRecord {
 	 * This information should be irrelevant to application logic, it is here to allow
 	 * the construction of a full row for the revision table.
 	 *
+	 * Note that this method may return an emulated value during schema migration in
+	 * SCHEMA_COMPAT_WRITE_OLD mode. See RevisionStore::emulateContentId for more information.
+	 *
 	 * @return int
 	 */
 	public function getContentId() {