[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[taler-docs] branch master updated: integrate Christian's idea about 're
From: |
gnunet |
Subject: |
[taler-docs] branch master updated: integrate Christian's idea about 'revision' field |
Date: |
Mon, 30 Mar 2020 12:28:57 +0200 |
This is an automated email from the git hooks/post-receive script.
dold pushed a commit to branch master
in repository docs.
The following commit(s) were added to refs/heads/master by this push:
new ba934cc integrate Christian's idea about 'revision' field
ba934cc is described below
commit ba934cc1ef9158bf0178f6d722bab2eb911583a5
Author: Florian Dold <address@hidden>
AuthorDate: Mon Mar 30 15:58:52 2020 +0530
integrate Christian's idea about 'revision' field
---
core/api-common.rst | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/core/api-common.rst b/core/api-common.rst
index 5fafacb..1721c42 100644
--- a/core/api-common.rst
+++ b/core/api-common.rst
@@ -133,9 +133,11 @@ version range they support. These version ranges are
written down in the
A protocol version is a positive, non-zero integer. A protocol version range
consists of three components:
1. The ``current`` version. This is the latest version of the protocol
supported by the client or service.
-2. The ``revision`` number. This value is not to be interpreted by the
client/server, but serves
+2. The ``revision`` number. This value should usually not be interpreted by
the client/server, but serves
purely as a comment. Each time a service/client for a protocol is updated
while supporting the same
set of protocol versions, the revision should be increased.
+ In rare cases, the revision number can be used to work around unintended
breakage in deployed
+ versions of a service. This is discouraged and should only be used in
exceptional situations.
3. The ``age`` number. This non-zero integer identifies with how many
previous protocol versions this
implementation is compatible. An ``age`` of 0 implies that the
implementation only supports
the ``current`` protocol version. The ``age`` must be less or equal than
the ``current`` protocol version.
--
To stop receiving notification emails like this one, please contact
address@hidden.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [taler-docs] branch master updated: integrate Christian's idea about 'revision' field,
gnunet <=