# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1625186167 -7200
# Node ID 084ed6a7c6fda8ca09226a7d53c147292490fdeb
# Parent  4a7df782f416017f6eb9f55772f426e51808c198
dirstate: document the dirstatetuple content

We are about to modify this, so let us document the existing code.

Differential Revision: https://phab.mercurial-scm.org/D10935

diff -r 4a7df782f416 -r 084ed6a7c6fd mercurial/pure/parsers.py
--- a/mercurial/pure/parsers.py	Fri Jul 02 02:17:31 2021 +0200
+++ b/mercurial/pure/parsers.py	Fri Jul 02 02:36:07 2021 +0200
@@ -35,6 +35,13 @@
 # Some code below makes tuples directly because it's more convenient. However,
 # code outside this module should always use dirstatetuple.
 def dirstatetuple(*x):
+    """the four items are:
+    - state (one of 'n', 'a', 'r', 'm')
+    - mode,
+    - size,
+    - mtime,
+    """
+
     # x is a tuple
     return x