changeset 42016:b900b392c1cc

perf: document perfparents
author Pierre-Yves David <pierre-yves.david@octobus.net>
date Mon, 25 Mar 2019 08:41:02 -0700
parents dbca2e5563c3
children 87066cf5ec0f
files contrib/perf.py tests/test-contrib-perf.t
diffstat 2 files changed, 8 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/contrib/perf.py	Mon Mar 25 13:43:40 2019 +0100
+++ b/contrib/perf.py	Mon Mar 25 08:41:02 2019 -0700
@@ -1164,6 +1164,13 @@
 
 @command(b'perfparents', formatteropts)
 def perfparents(ui, repo, **opts):
+    """benchmark the time necessary to fetch one changeset's parents.
+
+    The fetch is done using the `node identifier`, traversing all object layer
+    from the repository object. The N first revision will be used for this
+    benchmark. N is controlled by the ``perf.parentscount`` config option
+    (default: 1000).
+    """
     opts = _byteskwargs(opts)
     timer, fm = gettimer(ui, opts)
     # control the number of commits perfparents iterates over
--- a/tests/test-contrib-perf.t	Mon Mar 25 13:43:40 2019 +0100
+++ b/tests/test-contrib-perf.t	Mon Mar 25 08:41:02 2019 -0700
@@ -129,7 +129,7 @@
                  (no help text available)
    perfnodemap   benchmark the time necessary to look up revision from a cold
                  nodemap
-   perfparents   (no help text available)
+   perfparents   benchmark the time necessary to fetch one changeset's parents.
    perfpathcopies
                  benchmark the copy tracing logic
    perfphases    benchmark phasesets computation