Documentation/git-worktree: consistently use term "linked working tree"
Sometimes linked working trees were called "linked working directories" or "linked worktrees". Always refer to them as "linked working trees" for consistency. [es: fix additional occurrences] Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
1eaca7a5bb
commit
bc483285b7
@ -3,7 +3,7 @@ git-worktree(1)
|
||||
|
||||
NAME
|
||||
----
|
||||
git-worktree - Manage multiple worktrees
|
||||
git-worktree - Manage multiple working trees
|
||||
|
||||
|
||||
SYNOPSIS
|
||||
@ -15,7 +15,7 @@ SYNOPSIS
|
||||
DESCRIPTION
|
||||
-----------
|
||||
|
||||
Manage multiple worktrees attached to the same repository.
|
||||
Manage multiple working trees attached to the same repository.
|
||||
|
||||
A git repository can support multiple working trees, allowing you to check
|
||||
out more than one branch at a time. With `git worktree add` a new working
|
||||
@ -31,9 +31,9 @@ The working tree's administrative files in the repository (see
|
||||
`git worktree prune` in the main or any linked working tree to
|
||||
clean up any stale administrative files.
|
||||
|
||||
If you move a linked working directory to another file system, or
|
||||
If you move a linked working tree to another file system, or
|
||||
within a file system that does not support hard links, you need to run
|
||||
at least one git command inside the linked working directory
|
||||
at least one git command inside the linked working tree
|
||||
(e.g. `git status`) in order to update its administrative files in the
|
||||
repository so that they do not get automatically pruned.
|
||||
|
||||
@ -64,22 +64,22 @@ OPTIONS
|
||||
|
||||
-f::
|
||||
--force::
|
||||
By default, `add` refuses to create a new worktree when `<branch>`
|
||||
is already checked out by another worktree. This option overrides
|
||||
By default, `add` refuses to create a new working tree when `<branch>`
|
||||
is already checked out by another working tree. This option overrides
|
||||
that safeguard.
|
||||
|
||||
-b <new-branch>::
|
||||
-B <new-branch>::
|
||||
With `add`, create a new branch named `<new-branch>` starting at
|
||||
`<branch>`, and check out `<new-branch>` into the new worktree.
|
||||
`<branch>`, and check out `<new-branch>` into the new working tree.
|
||||
If `<branch>` is omitted, it defaults to HEAD.
|
||||
By default, `-b` refuses to create a new branch if it already
|
||||
exists. `-B` overrides this safeguard, resetting `<new-branch>` to
|
||||
`<branch>`.
|
||||
|
||||
--detach::
|
||||
With `add`, detach HEAD in the new worktree. See "DETACHED HEAD" in
|
||||
linkgit:git-checkout[1].
|
||||
With `add`, detach HEAD in the new working tree. See "DETACHED HEAD"
|
||||
in linkgit:git-checkout[1].
|
||||
|
||||
-n::
|
||||
--dry-run::
|
||||
@ -91,7 +91,7 @@ OPTIONS
|
||||
With `prune`, report all removals.
|
||||
|
||||
--expire <time>::
|
||||
With `prune`, only expire unused worktrees older than <time>.
|
||||
With `prune`, only expire unused working trees older than <time>.
|
||||
|
||||
DETAILS
|
||||
-------
|
||||
@ -139,9 +139,9 @@ EXAMPLES
|
||||
You are in the middle of a refactoring session and your boss comes in and
|
||||
demands that you fix something immediately. You might typically use
|
||||
linkgit:git-stash[1] to store your changes away temporarily, however, your
|
||||
worktree is in such a state of disarray (with new, moved, and removed files,
|
||||
and other bits and pieces strewn around) that you don't want to risk
|
||||
disturbing any of it. Instead, you create a temporary linked worktree to
|
||||
working tree is in such a state of disarray (with new, moved, and removed
|
||||
files, and other bits and pieces strewn around) that you don't want to risk
|
||||
disturbing any of it. Instead, you create a temporary linked working tree to
|
||||
make the emergency fix, remove it when done, and then resume your earlier
|
||||
refactoring session.
|
||||
|
||||
@ -164,12 +164,12 @@ checkouts of a superproject.
|
||||
git-worktree could provide more automation for tasks currently
|
||||
performed manually, such as:
|
||||
|
||||
- `remove` to remove a linked worktree and its administrative files (and
|
||||
warn if the worktree is dirty)
|
||||
- `mv` to move or rename a worktree and update its administrative files
|
||||
- `list` to list linked worktrees
|
||||
- `remove` to remove a linked working tree and its administrative files (and
|
||||
warn if the working tree is dirty)
|
||||
- `mv` to move or rename a working tree and update its administrative files
|
||||
- `list` to list linked working trees
|
||||
- `lock` to prevent automatic pruning of administrative files (for instance,
|
||||
for a worktree on a portable device)
|
||||
for a working tree on a portable device)
|
||||
|
||||
GIT
|
||||
---
|
||||
|
@ -251,9 +251,9 @@ modules::
|
||||
Contains the git-repositories of the submodules.
|
||||
|
||||
worktrees::
|
||||
Contains worktree specific information of linked
|
||||
checkouts. Each subdirectory contains the worktree-related
|
||||
part of a linked checkout. This directory is ignored if
|
||||
Contains working tree specific information of linked
|
||||
working trees. Each subdirectory contains the working tree-related
|
||||
part of a linked working tree. This directory is ignored if
|
||||
$GIT_COMMON_DIR is set and "$GIT_COMMON_DIR/worktrees" will be
|
||||
used instead.
|
||||
|
||||
@ -265,9 +265,9 @@ worktrees/<id>/gitdir::
|
||||
updated every time the linked repository is accessed.
|
||||
|
||||
worktrees/<id>/locked::
|
||||
If this file exists, the linked repository may be on a
|
||||
If this file exists, the linked working tree may be on a
|
||||
portable device and not available. It does not mean that the
|
||||
linked repository is gone and `worktrees/<id>` could be
|
||||
linked working tree is gone and `worktrees/<id>` could be
|
||||
removed. The file's content contains a reason string on why
|
||||
the repository is locked.
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user