# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 2023-10-09 13:06:21
# Node ID d737bc8a36c96b3de3045aa23b5a9a0641a0ac82
# Parent  8f19833184556b0cf8a083753b441d59b6b0a078

usage: add a `usage.repository-role` config

This config will be used for behavior and performance adjustment depending of
the repository role.

diff --git a/mercurial/configitems.toml b/mercurial/configitems.toml
--- a/mercurial/configitems.toml
+++ b/mercurial/configitems.toml
@@ -2489,6 +2489,18 @@ name = "verbose"
 default = false
 
 [[items]]
+section = "usage"
+name = "repository-role"
+default = "default"
+documentation = """What this repository is used for.
+
+This is used to adjust behavior and performance to best fit the repository purpose.
+
+Currently recognised values are:
+- default: an all purpose repository
+"""
+
+[[items]]
 section = "verify"
 name = "skipflags"
 default = 0
diff --git a/mercurial/helptext/config.txt b/mercurial/helptext/config.txt
--- a/mercurial/helptext/config.txt
+++ b/mercurial/helptext/config.txt
@@ -2994,6 +2994,18 @@ User interface controls.
     Increase the amount of output printed. (default: False)
 
 
+``usage``
+---------
+
+``repository-role``
+    What this repository is used for.
+
+    This is used to adjust behavior and performance to best fit the repository purpose.
+
+    Currently recognised values are:
+    - default: an all purpose repository
+
+
 ``command-templates``
 ---------------------