Re: format of svn:author
From: Julian Foad <julianfoad_at_btopenworld.com>
Date: Thu, 5 Jan 2012 10:32:15 +0000 (GMT)
OK, let's say:
The "svn:author:authn-id" value is the primary key, and so is unique within a [Subversion repository | Subversion server ?]. The administrator must configure the Subversion server to perform a mapping from "svn:author" value to the primary key, typically the trivial "x -> x" mapping but another example could extract "1234" from "John Doe (1234)".
This specification does not require the values of any other extended author field to be unique.
The administrator may guarantee locally that a particular extended author field is unique in some scope. For example, a build-bot can update an issue tracker, and so needs to know the issue tracker user id for the author of a particular Subversion revision. The administrator configures Subversion to provide that id in the "author:tracker-uid" revision property. The issue tracker user id needs to be unique among all users of the tracker, of course, and so the administrator ensures that is true and then tells the build-bot which of Subversion's extended author fields holds the issue tracker user id: that is, "author:tracker-uid". Note that its values are unique among all users of that issue tracker, not necessarily the same as being unique across all users of a particular Subversion repository or all Subversion repositories.
> and how to select the property to be shown in log, blame, and the like.
That is briefly stated in the "CLIENT DESIGN" section -- basically, client-side configuration. (Client-side configuration is of course not ideal, but is a stepping stone to server-dictated configuration which is the subject of a separate and concurrent design effort.)
Mark Mielke wrote:
So, basically putting display information in svn:author may not cause a problem in that scenario alone but will cause a problem if and when other tools want the value to be a unique id.
>> 2. [This one is a guess.]
Actually I meant UC2 to be a client-side problem like you're describing, so we're both talking about the same thing.
To everything else you said: yes, sounds good.
This is an archived mail posted to the Subversion Dev mailing list.