[darcs-users] darcs patch: Refactor "darcs apply" short description. (and 6 more)

Trent W. Buck trentbuck at gmail.com
Sat Mar 14 22:37:44 UTC 2009


Simon Michael <simon at joyful.com> writes:

> It's not just for the email address, but to correct mispellings,
> missing character accents, missing full names etc. How about:

Hmm, when I say "email address" I mean the whole address, not just the
bit outside the parens or the bit inside angled brackets.  I will check
what terminology is used in RFC 2822.

> "Often, a repository contains multiple variations of an author's name
> or email address. If a file `.authorspellings' exists in the root of
> the working tree, Darcs will use it to recognize and convert these
> variants to a canonical name and email address, ensuring a single
> accurate entry in the `show authors' report (only; other commands are
> currently not affected)."
>
>> + "[verbose and pedantic version]"
>
> The original was concise and I like it a little better than the
> above. Instead, what do you think of:
>
> "The .authorspellings file is a sequence of lines (which currently
> must be separated by unix-style newline, not CRLF.) Each line defines
> the canonical spelling for an author, which will appear in the show
> authors report. Typically this is "Full Name <email at address>" without
> the quotes; it may not contain a comma. Following this, there may be a
> comma and one or more extended regular expressions, delimited by
> commas.

That paragraph suits me.

> If a patch's author string matches (a) the canonical email address..."
>
> oh frick I don't remember what the implementation does and I'm out of
> time here.
>
>> + "An example .authorspelling file is:\n" ++
>> + "\n" ++
>> + "    -- This is a comment.\n" ++
>> + "    Fred Nurk <fred at example.com>\n" ++
>> + "    John Snagge <j.snagge at bbc.co.uk>, snagge@, john at pobox.com\n" ++
>> + "    eccles at smithsonian.museum ("Mad" Dan Eccles), eccles@(si.edu|pobox.com)\n"
>
> The example is good. The third line indeed works but I would omit it
> and show only the "First Last <email>" convention, to keep things
> simple.

That last example is me grumbling about your favouritism for the
angle-brackets variant :-)



More information about the darcs-users mailing list