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(-)
Jean-Noël Avila <jn.avila@free.fr>