# HG changeset patch
# User Anton Shestakov <av6@dwimlabs.net>
# Date 1672933833 -14400
# Node ID 9ea66d166ec71ddeaf1b9225700e3681808417e1
# Parent  dd804d83822c1fd964fba302537c511cdbce1d33
dirstate: update docstrings in idirstate from the current dirstate

diff -r dd804d83822c -r 9ea66d166ec7 mercurial/interfaces/dirstate.py
--- 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.