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

Re: More support on branch description?

From
Nguyen Thai Ngoc Duy <pclouds@gmail.com>
Date
Jan 20, 2012, 08:24 UTC
Message-ID
<CACsJy8CULRFOk0-LqL03gHD2jy39rb39MCdMnQ5r2bnTyDjBKw@mail.gmail.com>
In-Reply-To
<7v4nvrib7u.fsf@alter.siamese.dyndns.org>
On Fri, Jan 20, 2012 at 5:22 AM, Junio C Hamano <gitster@pobox.com> wrote:
> You however are misguided to say "Showing a short summary along...".
It should have been "short status".
Show 6 quoted lines
> The branch description support is to give users a place to record detailed
> explanation about a branch, similar in size to what you would normally
> place in a log message of a commit or a cover letter of a series.  There
> wasn't any convenient place to do so for a branch that is (1) inherently a
> moving target while it is being developed and (2) is not a good match for
> tags and notes.

I was thinking about that (and wondering if I abused branch.*.description), maybe we can have a similar convention for commit message, one short line, empty line, then more detail explanation. But branch.*.description is tied to format-patch/request-pull, maybe another config key.

> There already is a good place for a brief summary and it is called "branch
> name". Name your branches just like you name your functions.
Yes, but it's not suitable for current status of the branch.
-- 
Duy
Previous: Junio C Hamano
Message 5 of 5 in “More support on branch description?”
  1. Nguyen Thai Ngoc DuyJan 19, 2012
  2. Michael SchubertJan 19, 2012
  3. Nguyen Thai Ngoc DuyJan 19, 2012
  4. Junio C HamanoJan 19, 2012
  5. Nguyen Thai Ngoc DuyJan 20, 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.