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

Re: [PATCH] documentation: send-email: use camel case consistently

From
DSDragan Simic <dsimic@manjaro.org>
Date
Feb 20, 2024, 06:41 UTC
Message-ID
<33abb630c1d089e39ff48f04e586b1c0@manjaro.org>
In-Reply-To
<xmqqv86kx8h0.fsf@gitster.g>
Hello Junio,
On 2024-02-20 01:52, Junio C Hamano wrote:
Show 12 quoted lines
> Dragan Simic <dsimic@manjaro.org> writes:
>> There's only one "Fixes" tag, while there should actually be a whole 
>> bunch
>> of them to cover all the patches that introduced the configuration 
>> parameter
>> names fixed by this patch.  I think we're fine with just one.
> 
> I suspect that we are even better off without any.  The only reason
> to have them is if we plan to cherry-pick this patch down to a
> separate maintenance track that the "culprit" was cherry-picked or
> merged to, but we typically do not do so, and if we want to do so,
> we'd need a much better coverage.
Agreed, will drop the single "Fixes" tag in v2.
Show 12 quoted lines
> Anyway, checking the output of
> 
>     $ git grep -n -e '^[a-z]*\.[a-z]*[A-Z][A-Z][a-zA-Z]*::'
> Documentation/config/
> 
> and comparing it with the output of
> 
>     $ git grep -n -e '^[a-z]*\.[a-z]*[A-Z][a-zA-Z]*::' 
> Documentation/config/
> 
> I think we should spell "SSL" (which is an acronym) full in capital,
> and possibly do the same for "CC", too.

Agreed about "SSL", which I also though about doing that way initially; will change in v2. There are already instances of "SSL" being used, such as in various http.proxySSL* configuration parameter names.

Though, "CC" should remain written as "Cc", because it's the way email headers are capitalized, which "Cc" refers to.

Previous: Junio C HamanoNext: Junio C Hamano
Message 3 of 10 in “documentation: send-email: use camel case consistently”
  1. documentation: send-email: use camel case consistentlyDragan Simic, Feb 16, 2024
  2. Junio C HamanoFeb 20, 2024
  3. Dragan SimicFeb 20, 2024
  4. Junio C HamanoFeb 20, 2024
  5. Dragan SimicFeb 20, 2024
  6. Dragan SimicFeb 20, 2024
  7. Junio C HamanoFeb 20, 2024
  8. Dragan SimicFeb 20, 2024
  9. Chris TorekFeb 21, 2024
  10. Dragan SimicFeb 21, 2024

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.