# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1570511728 14400
# Node ID 97f80dd21312bdfe245c476e1bd0d907493963f1
# Parent  c9093ae8d6c45ca2c6290c249221bcf98a97a386
perf: document `perfstatus`

diff -r c9093ae8d6c4 -r 97f80dd21312 contrib/perf.py
--- a/contrib/perf.py	Wed Oct 09 15:24:14 2019 +0200
+++ b/contrib/perf.py	Tue Oct 08 01:15:28 2019 -0400
@@ -764,6 +764,13 @@
     + formatteropts,
 )
 def perfstatus(ui, repo, **opts):
+    """benchmark the performance of a single status call
+
+    The repository data are preserved between each call.
+
+    By default, only the status of the tracked file are requested. If
+    `--unknown` is passed, the "unknown" files are also tracked.
+    """
     opts = _byteskwargs(opts)
     # m = match.always(repo.root, repo.getcwd())
     # timer(lambda: sum(map(len, repo.dirstate.status(m, [], False, False,
diff -r c9093ae8d6c4 -r 97f80dd21312 tests/test-contrib-perf.t
--- a/tests/test-contrib-perf.t	Wed Oct 09 15:24:14 2019 +0200
+++ b/tests/test-contrib-perf.t	Tue Oct 08 01:15:28 2019 -0400
@@ -172,7 +172,7 @@
    perfrevrange  (no help text available)
    perfrevset    benchmark the execution time of a revset
    perfstartup   (no help text available)
-   perfstatus    (no help text available)
+   perfstatus    benchmark the performance of a single status call
    perftags      (no help text available)
    perftemplating
                  test the rendering time of a given template