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

Re: [PATCH] Documentation/git.txt: command re-classification

From
Jakub Narebski <jnareb@gmail.com>
Date
Jan 19, 2007, 22:18 UTC
Message-ID
<eorg2u$f1o$2@sea.gmane.org>
In-Reply-To
<Pine.LNX.4.64.0701191437450.3011@xanadu.home>
Nicolas Pitre wrote:
Show 8 quoted lines
>> +The interface (input, output, set of options and the semantics)
>> +to these low-level commands are meant to be a lot more stable
>> +than Porcelain level commands, because these commands are
>> +primarily for scripted use.  To put it another way, the
>> +interface to Plumbing commands are subject to change in order to
>> +improve the end user experience.
> 
> I think the "to put it another way" sentence is a bit confusing here.

I think it should read "To put it another way, Porcelain level commands are subject to change" instead of much less readable "To put it another way, the interface to Plumbing commands are subject to change".

-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git
Previous: Nicolas PitreNext: Junio C Hamano
Message 4 of 10 in “Documentation: revisit command qualification in git.txt”
  1. Documentation: revisit command qualification in git.txtNicolas Pitre, Jan 18, 2007
  2. Documentation/git.txt: command re-classificationJunio C Hamano, Jan 19, 2007
  3. Nicolas PitreJan 19, 2007
  4. Jakub NarebskiJan 19, 2007
  5. Junio C HamanoJan 19, 2007
  6. Nicolas PitreJan 19, 2007
  7. Jakub NarebskiJan 19, 2007
  8. J. Bruce FieldsJan 19, 2007
  9. Junio C HamanoJan 19, 2007
  10. Nicolas PitreJan 20, 2007

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.