changeset 49880:9ea66d166ec7

dirstate: update docstrings in idirstate from the current dirstate
author Anton Shestakov <av6@dwimlabs.net>
date Thu, 05 Jan 2023 19:50:33 +0400
parents dd804d83822c
children b3ae17037b54
files mercurial/interfaces/dirstate.py
diffstat 1 files changed, 9 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/mercurial/interfaces/dirstate.py	Wed Jan 04 13:47:10 2023 -0500
+++ b/mercurial/interfaces/dirstate.py	Thu Jan 05 19:50:33 2023 +0400
@@ -51,7 +51,13 @@
         pass
 
     def flagfunc(buildfallback):
-        pass
+        """build a callable that returns flags associated with a filename
+
+        The information is extracted from three possible layers:
+        1. the file system if it supports the information
+        2. the "fallback" information stored in the dirstate if any
+        3. a more expensive mechanism inferring the flags from the parents.
+        """
 
     def getcwd():
         """Return the path from which a canonical path is calculated.
@@ -96,7 +102,7 @@
     def setparents(p1, p2=None):
         """Set dirstate parents to p1 and p2.
 
-        When moving from two parents to one, 'm' merged entries a
+        When moving from two parents to one, "merged" entries a
         adjusted to normal and previous copy records discarded and
         returned by the call.
 
@@ -147,7 +153,7 @@
         pass
 
     def identity():
-        """Return identity of dirstate it to detect changing in storage
+        """Return identity of dirstate itself to detect changing in storage
 
         If identity of previous dirstate is equal to this, writing
         changes based on the former dirstate out can keep consistency.