Simon Michael <[email protected]> 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 <em...@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 <[email protected]>\n" ++ >> + " John Snagge <[email protected]>, snagge@, [email protected]\n" ++ >> + " [email protected] ("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 :-) _______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
