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

[PATCH 4/4] git-worktree.txt: make start of new sentence more obvious

From
Eric Sunshine <sunshine@sunshineco.com>
Date
Aug 3, 2020, 05:36 UTC
Message-ID
<20200803053612.50095-5-sunshine@sunshineco.com>
In-Reply-To
<20200803053612.50095-1-sunshine@sunshineco.com>

When reading the rendered description of `add`, it's easy to trip over and miss the end of one sentence and the start of the next, making it seem as if they are part of the same statement, separated only by a dash:

    ... specific files such as HEAD, index, etc. - may also be
    specified as <commit-ish>; it is synonymous with...

This can be particularly confusing since the thoughts expressed by the two sentences are unrelated. Reduce the likelihood of confusion by making it obvious that the two sentences are distinct.

Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
---
 Documentation/git-worktree.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-worktree.txt b/Documentation/git-worktree.txt
index 49422454d1..260bfe9105 100644
--- a/Documentation/git-worktree.txt
+++ b/Documentation/git-worktree.txt
@@ -48,8 +48,8 @@ add <path> [<commit-ish>]::
 
 Create `<path>` and checkout `<commit-ish>` into it. The new working directory
 is linked to the current repository, sharing everything except working
-directory specific files such as HEAD, index, etc. `-` may also be
-specified as `<commit-ish>`; it is synonymous with `@{-1}`.
+directory specific files such as HEAD, index, etc. As a convenience,
+`<commit-ish>` may be a bare "`-`", which is synonymous with `@{-1}`.
 +
 If `<commit-ish>` is a branch name (call it `<branch>`) and is not found,
 and neither `-b` nor `-B` nor `--detach` are used, but there does
-- 
2.28.0.236.gb10cc79966
Previous: Eric SunshineNext: Taylor Blau
Message 5 of 20 in “git-worktree documentation cleanups”
  1. 0/4 git-worktree documentation cleanupsEric Sunshine, Aug 3, 2020
  2. 2/4 git-worktree.txt: consistently use term "working tree"Eric Sunshine, Aug 3, 2020
  3. 1/4 git-worktree.txt: employ fixed-width typeface consistentlyEric Sunshine, Aug 3, 2020
  4. 3/4 git-worktree.txt: fix minor grammatical issuesEric Sunshine, Aug 3, 2020
  5. 4/4 git-worktree.txt: make start of new sentence more obviousEric Sunshine, Aug 3, 2020
  6. Taylor BlauAug 3, 2020
  7. Junio C HamanoAug 3, 2020
  8. Martin ÅgrenAug 3, 2020
  9. Eric SunshineAug 3, 2020
  10. Junio C HamanoAug 4, 2020
  11. 0/5 git-worktree documentation cleanupsEric Sunshine, Aug 4, 2020
  12. 3/5 git-worktree.txt: fix minor grammatical issuesEric Sunshine, Aug 4, 2020
  13. 1/5 git-worktree.txt: employ fixed-width typeface consistentlyEric Sunshine, Aug 4, 2020
  14. 4/5 git-worktree.txt: make start of new sentence more obviousEric Sunshine, Aug 4, 2020
  15. 5/5 git-wortkree.txt: link to man pages when citing other Git commandsEric Sunshine, Aug 4, 2020
  16. 2/5 git-worktree.txt: consistently use term "working tree"Eric Sunshine, Aug 4, 2020
  17. Taylor BlauAug 4, 2020
  18. Martin ÅgrenAug 4, 2020
  19. Eric SunshineAug 4, 2020
  20. Martin ÅgrenAug 4, 2020

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.