Document that old change IDs are deprecated and will be removed

Change-Id: I7b23f87ed137ea83f774cf52844c3ae06699cead
This commit is contained in:
Patrick Hiesel 2017-12-21 14:02:05 +01:00
parent ca6384dd0a
commit 18da0453ef

View File

@ -5384,11 +5384,12 @@ request:
[[change-id]]
=== \{change-id\}
Identifier that uniquely identifies one change.
Identifier that uniquely identifies one change. It contains the URL-encoded
project name as well as the change number: "'$$<project>~<numericId>$$'"
This can be:
Depending on the server's configuration, Gerrit can still support the following
deprecated identifiers. These will be removed in a future release:
* an ID of the change in the format "'$$<project>~<numericId>$$'"
* an ID of the change in the format "'$$<project>~<branch>~<Change-Id>$$'",
where for the branch the `refs/heads/` prefix can be omitted
("$$myProject~master~I8473b95934b5732ac55d26311a706c9c2bde9940$$")
@ -5396,6 +5397,10 @@ This can be:
("I8473b95934b5732ac55d26311a706c9c2bde9940")
* a numeric change ID ("4247")
If you need more time to migrate off of old change IDs, please see
link:config-gerrit.html#change.api.allowedIdentifier[change.api.allowedIdentifier]
for more information on how to enable the use of deprecated identifiers.
[[comment-id]]
=== \{comment-id\}
UUID of a published comment.