You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by ro...@apache.org on 2023/02/23 14:04:50 UTC

[couchdb] 01/01: Unifying the notation of dynamic parameters in the docs 2

This is an automated email from the ASF dual-hosted git repository.

ronny pushed a commit to branch docs/replace-dollar-sign
in repository https://gitbox.apache.org/repos/asf/couchdb.git

commit 21c52225c36e6e0dc298c2342c4a44be87fe5461
Author: Ronny Berndt <ro...@apache.org>
AuthorDate: Thu Feb 23 15:02:20 2023 +0100

    Unifying the notation of dynamic parameters in the docs 2
    
    The pattern {var} has been established to clarify dynamic parameters in the documentation.
    Standardization and clarification of some not yet converted notation of parameters.
---
 src/docs/src/api/server/authn.rst  | 2 +-
 src/docs/src/cluster/purging.rst   | 2 +-
 src/docs/src/config/replicator.rst | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/docs/src/api/server/authn.rst b/src/docs/src/api/server/authn.rst
index 41f77e176..7744d12fd 100644
--- a/src/docs/src/api/server/authn.rst
+++ b/src/docs/src/api/server/authn.rst
@@ -457,7 +457,7 @@ surrounded by at least one space on each side. This might be useful in the
 character.
 
 JWT tokens that do not include a ``kid`` claim will be validated against the
-``$alg:_default`` key.
+``{alg}:_default`` key.
 
 It is mandatory to specify the algorithm associated with every key for security
 reasons (notably presenting a HMAC-signed token using an RSA or EC public key
diff --git a/src/docs/src/cluster/purging.rst b/src/docs/src/cluster/purging.rst
index d0704edb7..2d8f00ed5 100644
--- a/src/docs/src/cluster/purging.rst
+++ b/src/docs/src/cluster/purging.rst
@@ -65,7 +65,7 @@ Local Purge Checkpoint Documents
 ====================================
 Indexes and internal replications of the database with purges create and
 periodically update local checkpoint purge documents:
-``_local/purge-$type-$hash``. These documents report the last ``purge_seq``
+``_local/purge-{type}-{hash}``. These documents report the last ``purge_seq``
 processed by them and the timestamp of the last processing. An example of a
 local checkpoint purge document:
 
diff --git a/src/docs/src/config/replicator.rst b/src/docs/src/config/replicator.rst
index 63caca88e..dc89ecca3 100644
--- a/src/docs/src/config/replicator.rst
+++ b/src/docs/src/config/replicator.rst
@@ -329,7 +329,7 @@ Fair Share Replicator Share Allocation
 
 .. config:section:: replicator.shares :: Per-Database Fair Share Allocation
 
-    .. config:option:: $replicator_db :: Value for a replicator database
+    .. config:option:: {replicator_db} :: Value for a replicator database
 
         .. versionadded:: 3.2.0
 
@@ -338,7 +338,7 @@ Fair Share Replicator Share Allocation
         value is 100, minimum is 1 and maximum is 1000. The
         configuration may be set even if the database does not exist.
 
-        In this context the option ``$replicator_db`` acts as a placeholder
+        In this context the option ``{replicator_db}`` acts as a placeholder
         for your replicator database name. The default replicator database is
         ``_replicator``. Additional replicator databases can be created. To be
         recognized as such by the system, their database names should end with