[darcs-users] darcs patch: Refactor "darcs show authors" help.
Trent W. Buck
trentbuck at gmail.com
Sun Mar 15 07:15:20 UTC 2009
Simon Michael <simon at joyful.com> writes:
>> + "An author's name or email address may change over time.
> Also, this is for tidying up the inevitable silly mispellings and
> inconsistencies that crop up due to unfamiliarity, unconfigured darcs,
> recording patches on strange machines etc.
I didn't want to mention that, because I think it sounds kinda
demeaning, and dealing with legitimate name changes provides an adequate
use case without saying "this is also useful for working around cock-ups
that you accidentally accepted into your repo."
>> + "when multiple author strings refer to the same individual, create an\n" ++
>> + "`.authorspellings' file in the root of the working tree. Each line in\n" ++
>> + "this file begins with an author's canonical name and address, and may\n" ++
>> + "be followed by a comma and zero or more extended regular expressions,\n" ++
> One or more, a comma and zero regexps wouldn't make sense.
>> + "Any patch with an author string that matches the canonical address or\n" ++
> Any patch with an author string that contains the email address
> extracted from the canonical address. That's why I recommend the Name
> <email> form, the canonical email won't be noticed if it's not in
> angle brackets.
Bah, before you were correcting me when I referred to the entire
name-addr as "address", and now you're parsing the new version that way!
My use of "address" above is supposed to be clearly just the addr-spec
part, because of "begins with [...] name and address".
I didn't want to say "Name <email>" because it's conventional to use
italics (which we don't have) or angle brackets to markup the
non-terminals "name" and "email", so it would transliterate to ASCII as
"<name> <<email>>", which is just confusing.
More information about the darcs-users