# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 2019-10-08 05:46:57
# Node ID ce315b1fc9a7ef8d86fa4069984e6697a4a86ab9
# Parent  97f80dd21312bdfe245c476e1bd0d907493963f1

perf: document `perfdirstate`

diff --git a/contrib/perf.py b/contrib/perf.py
--- a/contrib/perf.py
+++ b/contrib/perf.py
@@ -1103,6 +1103,11 @@ def perfdirs(ui, repo, **opts):
 
 @command(b'perfdirstate', formatteropts)
 def perfdirstate(ui, repo, **opts):
+    """benchmap the time necessary to load a dirstate from scratch
+
+    The dirstate is loaded to the point were a "contains" request can be
+    answered.
+    """
     opts = _byteskwargs(opts)
     timer, fm = gettimer(ui, opts)
     b"a" in repo.dirstate
diff --git a/tests/test-contrib-perf.t b/tests/test-contrib-perf.t
--- a/tests/test-contrib-perf.t
+++ b/tests/test-contrib-perf.t
@@ -107,7 +107,7 @@ perfstatus
    perfdirfoldmap
                  (no help text available)
    perfdirs      (no help text available)
-   perfdirstate  (no help text available)
+   perfdirstate  benchmap the time necessary to load a dirstate from scratch
    perfdirstatedirs
                  (no help text available)
    perfdirstatefoldmap