git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 1/2] Unification of user message strings

From
Vincent van Ravesteijn <vfr@lyx.org>
Date
Mar 19, 2012, 20:16 UTC
Message-ID
<4F679419.8020204@lyx.org>
In-Reply-To
<7v1uoobcsv.fsf@alter.siamese.dyndns.org>
Show 19 quoted lines
>> From: Vincent van Ravesteijn<vfr@lyx.org>
>>
>> Rewrite user messages to stick to a uniform style for all messages. From the surrounding code, the following guidelines were deduced:
>> - messages start with a capital,
>> - short messages do not end with a full stop,
>> - paths, filenames, and commands are quoted by single quotes (if not separated by the normal text by a ':'),
>> - 'could not' is used rather than 'cannot'.
>>
>>
>> @@ -56,7 +56,7 @@ int sign_buffer(struct strbuf *buffer, struct strbuf *signature, const char *sig
>>   	args[3] = NULL;
>>
>>   	if (start_command(&gpg))
>> -		return error(_("could not run gpg."));
>> +		return error(_("Could not run 'gpg'"));
> Ok with s/c/C/, but I am not sure about the 'gpg' bit.  The name of the
> program and path to it can be configured so the user may be expecting to
> run a program called gnupg, and unquoted gpg feels more like a generic
> term to refer to the program.  It might be worth using all-CAPS, though.
Yes, all-CAPS seems the better alternative.
Show 9 quoted lines
>> -		return error(_("cannot open %s: %s"), filename,
>> +		return error(_("Could not open '%s': %s"), filename,
> Honestly speaking, I would personally prefer "Cannot open" over "Could not
> open".  Yes, all the error messages report _after_ we attempted to do
> something and finding that we _couldn't_ do that thing, so "Could not" may
> be technically more correct, but still...
>
> But that is probably just me.
>

No it's not you, grep tells me "Cannot" is indeed the most occuring, except in sequencer.c (which I stumbled on first).

> Other than that, the patch looks good; let's hear from others, too.

Ok, let's hear other comments, and then I will send a reroll to fix up the things above.

Vincent
Previous: Junio C HamanoNext: Jeff King
Message 4 of 10 in “Unify the style of user messages”
  1. 0/2 Unify the style of user messagesVincent van Ravesteijn, Mar 19, 2012
  2. 1/2 Unification of user message stringsVincent van Ravesteijn, Mar 19, 2012
  3. Junio C HamanoMar 19, 2012
  4. Vincent van RavesteijnMar 19, 2012
  5. Jeff KingMar 19, 2012
  6. Junio C HamanoMar 19, 2012
  7. Vincent van RavesteijnMar 20, 2012
  8. Jakub NarebskiMar 20, 2012
  9. Vincent van RavesteijnMar 20, 2012
  10. 2/2 Make some strings translatableVincent van Ravesteijn, Mar 19, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.