Skip to content

unexpected backslashes in man pages

Jonathan Nieder git 1 version In review

Get series with b4
b4 am 20100820101902.GA10356@burratino

Versions newest first

  1. v1 Latest17 patches 4 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/17Documentation: tweak description of log.dateDocumentation/config.txt+5 -40 replies
2/17Documentation: quoting trouble in "git rm" discussionDocumentation/asciidoc.conf Documentation/git-rm.txt+3 -10 replies
3/17Documentation: unbreak regex in show-ref manualDocumentation/asciidoc.conf Documentation/git-show-ref.txt+3 -20 replies
4/17Documentation: clarify quoting in "git add" exampleDocumentation/git-add.txt+2 -20 replies
5/17Documentation: add missing quotes to "git grep" examplesDocumentation/git-grep.txt+2 -20 replies
6/17Documentation: clarify quoting in "git rm" exampleDocumentation/git-rm.txt+3 -30 replies
7/17Documentation: clarify quoting in gitignore docsDocumentation/gitignore.txt+2 -20 replies
8/17Documentation: remove backslashes in manpage synopsesDocumentation/git-checkout-index.txt Documentation/git-commit-tree.txt Documentation/git-for-each-ref.txt +4 more+10 -100 replies
9/17Documentation/technical: avoid stray backslash in parse-options API docsDocumentation/technical/api-parse-options.txt+4 -40 replies
10/17Documentation: remove stray backslash from "git bundle" manualDocumentation/git-bundle.txt+4 -40 replies
11/17Documentation: remove backslash before ~ in fast-import manualDocumentation/git-fast-export.txt+1 -10 replies
12/17Documentation: remove stray backslashes in rev-parse manualDocumentation/git-rev-parse.txt+5 -40 replies
13/17Documentation: remove stray backslash in show-branch discussionDocumentation/git-show-branch.txt+4 -43 replies
14/17Documentation: avoid stray backslashes in core tutorialDocumentation/gitcore-tutorial.txt+9 -90 replies
15/17Documentation: avoid stray backslash in user manualDocumentation/user-manual.txt+2 -20 replies
16/17Documentation: do not convert ... operator to ellipsesDocumentation/git-checkout.txt Documentation/git-push.txt Documentation/git-rebase.txt +1 more+4 -40 replies
17/17Documentation: remove stray backslashes from "Fighting regressions" articleDocumentation/git-bisect-lk2009.txt+1 -10 replies

Reviews trailers per patch

None of the 17 patches has a Reviewed-by or Acked-by of their own; the series has one for all of them.

PatchThomas Rast
SeriesA-b
1/17
2/17
3/17
4/17
5/17
6/17
7/17
8/17
9/17
10/17
11/17
12/17
13/17
14/17
15/17
16/17
17/17

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

Cover letter [RFC/PATCH 00/17] unexpected backslashes in man pages

(cc: interested parties and documentation experts)

Hi,

This series is longer than I would like, and I am not happy to impose the review burden. So if something does not look obviously correct at a glance, please let me know and I'll try to simplify it.

The topic: as Frédéric Brière noticed in
<http://bugs.debian.org/540001>, various man pages have collected backslashes where they don't belong.

Maybe we should forbid backslashes outside of

--------
literal
--------

sections. Well, I did not go that far.

Still, maybe the patches can be useful.

Jonathan Nieder (17):
Documentation: tweak description of log.date
Documentation: quoting trouble in "git rm" discussion
Documentation: unbreak regex in show-ref --exclude-existing
description
Documentation: clarify quoting in "git add" example
Documentation: add missing quotes to "git grep" examples
Documentation: clarify quoting in "git rm" example
Documentation: clarify quoting in gitignore docs
Documentation: remove backslashes in manpage synopses Documentation/technical: avoid stray backslash in parse-options API
docs
Documentation: remove stray backslash from "git bundle" manual
Documentation: remove backslash before ~ in fast-import manual
Documentation: remove stray backslashes in rev-parse manual
Documentation: remove stray backslash in show-branch discussion
Documentation: avoid stray backslashes in core tutorial
Documentation: avoid stray backslash in user manual
Documentation: do not convert ... operator to ellipses
Documentation: remove stray backslashes from "Fighting regressions"
article

 Documentation/asciidoc.conf                   |    2 ++
 Documentation/config.txt                      |    9 +++++----
 Documentation/git-add.txt                     |    4 ++--
 Documentation/git-bisect-lk2009.txt           |    2 +-
 Documentation/git-bundle.txt                  |    8 ++++----
 Documentation/git-checkout-index.txt          |    2 +-
 Documentation/git-checkout.txt                |    2 +-
 Documentation/git-commit-tree.txt             |    2 +-
 Documentation/git-fast-export.txt             |    2 +-
 Documentation/git-for-each-ref.txt            |    2 +-
 Documentation/git-grep.txt                    |    4 ++--
 Documentation/git-ls-files.txt                |    6 +++---
 Documentation/git-merge-index.txt             |    2 +-
 Documentation/git-push.txt                    |    2 +-
 Documentation/git-rebase.txt                  |    2 +-
 Documentation/git-relink.txt                  |    2 +-
 Documentation/git-rev-parse.txt               |    9 +++++----
 Documentation/git-rm.txt                      |    9 +++++----
 Documentation/git-show-branch.txt             |    2 +-
 Documentation/git-show-ref.txt                |    4 ++--
 Documentation/git-update-index.txt            |    4 ++--
 Documentation/gitcore-tutorial.txt            |   18 +++++++++---------
 Documentation/gitignore.txt                   |    4 ++--
 Documentation/rev-list-options.txt            |    2 +-
 Documentation/technical/api-parse-options.txt |    8 ++++----
 Documentation/user-manual.txt                 |    4 ++--
 26 files changed, 61 insertions(+), 56 deletions(-)
Signature · 1 line
1.7.2.2.536.g42dab.dirty