You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Motivations for this change:
1. Listing a huge number of options is visually overwhelming when
opening a man page for an unfamiliar command. It makes it harder
to understand the command's core syntax, like `git add <filename>`
2. For options which can be passed independently of any other options,
including them in the SYNOPSIS does not add any information which you
can't already get from reading the OPTIONS section. `git add` has
some mutually exclusive options, namely:
[--[no-]all | -A | --[no-]ignore-removal | [--update | -u]]
but personally I already find that line so hard to parse that
removing it doesn't remove a lot of information
3. Some man pages already take this approach, like `git rebase` and
`git status`
0 commit comments