There are command expressions which do not follow the grammar syntax rules. According to the coding guidelines, the placeholders must: * be in small letters * enclosed in angle brackets * use hyphens as spaces They also must represent tokens' meaning as atomic entities. Some fixups for git-credential, git-ls-files, git-init and git-http-push. changes since v1: * split changes across simpler commits changes since v2: * remove back-quote formatting of placeholders from patches * revert renaming <bool> placeholder Jean-Noël Avila (9): doc: fix git credential synopsis doc: split placeholders as individual tokens doc: express grammar placeholders between angle brackets doc: use only hyphens as word separators in placeholders doc: git-ls-files: express options as optional alternatives doc: use three dots for indicating repetition instead of star doc: uniformize <URL> placeholders' case doc: git-http-push: describe the refs as pattern pairs doc: git-init: clarify file modes in octal. Junio C Hamano (1): init doc: --shared=0xxx does not give umask but perm bits Documentation/date-formats.txt | 6 +-- Documentation/git-archimport.txt | 14 +++---- Documentation/git-checkout.txt | 36 +++++++++--------- Documentation/git-cherry-pick.txt | 6 +-- Documentation/git-clone.txt | 8 ++-- Documentation/git-config.txt | 46 +++++++++++------------ Documentation/git-credential.txt | 2 +- Documentation/git-cvsexportcommit.txt | 4 +- Documentation/git-cvsimport.txt | 8 ++-- Documentation/git-diff-files.txt | 2 +- Documentation/git-diff-index.txt | 2 +- Documentation/git-diff-tree.txt | 2 +- Documentation/git-fsck.txt | 2 +- Documentation/git-gui.txt | 2 +- Documentation/git-help.txt | 6 +-- Documentation/git-http-fetch.txt | 2 +- Documentation/git-http-push.txt | 15 ++++---- Documentation/git-init-db.txt | 2 +- Documentation/git-init.txt | 27 ++++++++------ Documentation/git-log.txt | 8 ++-- Documentation/git-ls-files.txt | 6 +-- Documentation/git-merge-index.txt | 2 +- Documentation/git-p4.txt | 8 ++-- Documentation/git-pack-objects.txt | 4 +- Documentation/git-pack-redundant.txt | 2 +- Documentation/git-reflog.txt | 4 +- Documentation/git-remote.txt | 8 ++-- Documentation/git-request-pull.txt | 8 ++-- Documentation/git-shortlog.txt | 8 ++-- Documentation/git-sparse-checkout.txt | 2 +- Documentation/git-stage.txt | 2 +- Documentation/git-svn.txt | 2 +- Documentation/git-web--browse.txt | 2 +- Documentation/gitcredentials.txt | 4 +- Documentation/gitsubmodules.txt | 2 +- Documentation/gitworkflows.txt | 6 +-- Documentation/pretty-formats.txt | 54 +++++++++++++-------------- Documentation/urls-remotes.txt | 8 ++-- builtin/credential.c | 2 +- 39 files changed, 168 insertions(+), 166 deletions(-) -- 2.33.1