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

[RFD] consider "git" wrapper semi-Porcelain

From
Junio C Hamano <junkio@cox.net>
Date
Jun 26, 2005, 01:02 UTC
Message-ID
<7vy88yvsjl.fsf_-_@assigned-by-dhcp.cox.net>
In-Reply-To
<7vmzpe4x08.fsf_-_@assigned-by-dhcp.cox.net>

Currently "git" wrapper suggests both low-level git-* commands and git-*-script commands as alternatives. Earlier I stated that git-*-script commands, like it or not, form a perfectly good set of barebone Porcelain, as opposed to all the other commands that do not end with "script" are low-level Plumbing. After reviewing the current set of commands and scripts again, I still think this view holds true [*1*, *2*].

I would propose the following, preferably before we go 1.0:
 (1) Do not suggest low-level Plumbing commands to "git" wrapper
     users, and do not call anything but git-*-script from "git"
     wrapper.  Once *-script Porcelain matures, hopefully
     everyday workflow would not require access to low-level
     Plumbing and can be done with git-*-script Porcelain.  When
     people know the GIT way, they can also work it around
     things that git-*-script Porcelain does not support well by
     writing their own git-*-script in terms of Plumbing-ish
     git-* commands, and if it is good enough for public
     consumption, propose it for inclusion upstream.
 (2) Make an alias git-whatchanged-script that just "exec"s
     git-whatchanged, to make things consistent.
 (3) Rename some git-*-script that are misnamed in the sense
     that they are not useful standalone scripts but more of
     Plumbing that happen to be written in shell [*3*].  I do
     not particularly like this proposal, because this breaks
     existing scripts.  However, if we go this route for
     consistency, I would further suggest renaming Porcelain-ish
     things git-*-cmd or something, call and suggest them from
     "git" wrapper, regardless of which language they are
     written in [*4*].
[Footnotes]
*1* One exception is git-whatchanged.

*2* That is the reason I did not name git-cherry "git-cherry-script". It is not useful standalone but meant to be useful in scripting environment.

*3* git-apply-patch-script (my fault) and git-merge-one-file-script fall into this category.

*4* Current naming and the proposal (1) above have a problem in that they muddy the definition of what is "script": the name "script" were originally used because they were written in shell, and all of the Porcelain-ish things happen to be "script". Writing Porcelain-ish things in shell should not be a requirement.

Previous: Junio C HamanoNext: Linus Torvalds
Message 16 of 19 in “D/F conflicts fixes.”
  1. 0/2 D/F conflicts fixes.Junio C Hamano, Jun 23, 2005
  2. 1/2 Add more tests for read-tree --emu23.Junio C Hamano, Jun 23, 2005
  3. 2/2 Fix oversimplified optimization for add_cache_entry().Junio C Hamano, Jun 24, 2005
  4. Linus TorvaldsJun 25, 2005
  5. Junio C HamanoJun 25, 2005
  6. 0/9 Fix oversimplified optimization for add_cache_entry().Junio C Hamano, Jun 25, 2005
  7. 1/9 fix date parsing for GIT raw commit timestamp format.Junio C Hamano, Jun 25, 2005
  8. 2/9 git-commit-script: get commit message from an existing one.Junio C Hamano, Jun 25, 2005
  9. 3/9 git-cherry: find commits not merged upstream.Junio C Hamano, Jun 25, 2005
  10. 4/9 git-rebase-script: rebase local commits to new upstream head.Junio C Hamano, Jun 25, 2005
  11. 5/9 Add more tests for read-tree --emu23.Junio C Hamano, Jun 25, 2005
  12. 6/9 git-merge-one-file-script: do not misinterpret rm failure.Junio C Hamano, Jun 25, 2005
  13. 7/9 Fix oversimplified optimization for add_cache_entry().Junio C Hamano, Jun 25, 2005
  14. 8/9 http-pull: documentation updates.Junio C Hamano, Jun 25, 2005
  15. 9/9 Add a bit of developer documentation to pull.hJunio C Hamano, Jun 25, 2005
  16. [RFD] consider "git" wrapper semi-PorcelainJunio C Hamano, Jun 26, 2005
  17. Linus TorvaldsJun 26, 2005
  18. Junio C HamanoJun 26, 2005
  19. Martijn KuipersJun 26, 2005

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.