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

docs and completion and dashless commands

From
Ddherring@ll.mit.edu <dherring@ll.mit.edu>
Date
Aug 22, 2008, 20:26 UTC
Message-ID
<alpine.LNX.0.999999.0808221550100.11892@mojave>
First off, I'm not too keen on these dashless commands.
- We now have `man git-X` but can't run `git-X`
- A separate completion script must be installed for bash
- Lose completion for all other shells
- History expansion is complicated (e.g. `!git-push` vs `!git push`)

I tracked down "Invoke git-repo-config directly" (March 06) and related threads; so I somewhat understand the logic. However the notions that moving bin/git-X to libexec/git-core/git-X somehow hides complexity for the user or fixes problems with PATH seem misguided. Maybe there were some other reasons I missed?

Anyway, could someone modify INSTALL to mention contrib/completion/git-completion.bash and putting `git --exec-path` in PATH for other shells? A man page about configuring shells for git would also be nice. These docs might also instruct users to call git-config and set their global username and email.

Also, with the dashless commands, it may be more appropriate to distribute a texinfo tree than flat manpages.

Thanks, Daniel

Next: Junio C Hamano
Message 1 of 2 in “docs and completion and dashless commands”
  1. dherring@ll.mit.eduAug 22, 2008
  2. Junio C HamanoAug 22, 2008

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.