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

Re: The git spring cleanup challenge completion

From
Felipe Contreras <felipe.contreras@gmail.com>
Date
Jul 6, 2021, 22:31 UTC
Message-ID
<60e4d9c07914e_1c42812081a@natae.notmuch>
In-Reply-To
<87wnq57q9n.fsf@evledraar.gmail.com>
Ævar Arnfjörð Bjarmason wrote:
> On Sun, Jul 04 2021, Felipe Contreras wrote:
Show 11 quoted lines
> > I think there's some value in that idea but that doesn't solve the same
> > problem my suggestion solves. Basically there's too many commands in
> > `man git`. Splitting the git binary would allow us to only put the
> > important commands in `man git`.
> >
> > I think having too many commands overwhelms many newcomers, because they
> > don't know which it's important for them to learn and which are
> > basically noise.
> 
> I'm very much for the idea of a cleanup of "man git", but I don't think
> we need to introduce a git-tool(1) for that.
Indeed, it's not *necessary*, but it would help tremendously.
Show 8 quoted lines
> E.g. "man perl" is a good example of where we should be
> headed. I.e. right off the bat in "man git" we have a long listing of
> command-line options to git itself, things like --exec-path and
> --no-optional-locks etc. are useful to almost no casual user.
> 
> We should really split everything except a passing mention of -p, -P, -c
> etc. into a "man gitrun" or something (just like perl has "man
> perlrun"), ditto the whole "ENVIRONMENT VARIABLES" section.
I like that. For the record zsh also splits man pages that way.

I would prefer `git-run` (or `git-core`) though, althought if somebody at some point wants to create such a built-in that would be problematic.

-- 
Felipe Contreras
Previous: Ævar Arnfjörð Bjarmason
Message 9 of 9 in “The git spring cleanup challenge completion”
  1. Felipe ContrerasJul 2, 2021
  2. Bagas SanjayaJul 3, 2021
  3. Felipe ContrerasJul 3, 2021
  4. Atharva RaykarJul 3, 2021
  5. Felipe ContrerasJul 3, 2021
  6. Theodore Ts'oJul 4, 2021
  7. Felipe ContrerasJul 4, 2021
  8. Ævar Arnfjörð BjarmasonJul 4, 2021
  9. Felipe ContrerasJul 6, 2021

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.