Repository navigation
Commit 4b04d8a
committed
Better clarify Submodule.branch_path documentation
This revisits the changes in 3813bfb and takes a different
approach, using the phrase "full repository-relative path" that is
used elsewhere in the documentation and seems clear in context.
Although this brings back the potential confusion around having the
terms "full" and "relative" used together to describe a path, this
may no longer be an issue now that the phrase "repository-relative"
is used here as it is elsewhere.
(In particular, see the SymbolicReference.to_full_path docstring.)1 parent 5cf5b60 commit 4b04d8a
1 file changed
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -134,7 +134,7 @@ def __init__( | |||
| 134 | 134 | The URL to the remote repository which is the submodule. | |
| 135 | 135 | ||
| 136 | 136 | :param branch_path: | |
| 137 | - Complete relative path to ref to checkout when cloning the remote | ||
| 137 | + Full repository-relative path to ref to checkout when cloning the remote | ||
| 138 | 138 | repository. | |
| 139 | 139 | """ | |
| 140 | 140 | super().__init__(repo, binsha, mode, path) | |
@@ -1473,8 +1473,8 @@ def branch(self) -> "Head": | |||
| 1473 | 1473 | def branch_path(self) -> PathLike: | |
| 1474 | 1474 | """ | |
| 1475 | 1475 | :return: | |
| 1476 | - Complete relative path as string to the branch we would checkout from the | ||
| 1477 | - remote and track | ||
| 1476 | + Full repository-relative path as string to the branch we would checkout from | ||
| 1477 | + the remote and track | ||
| 1478 | 1478 | """ | |
| 1479 | 1479 | return self._branch_path | |
| 1480 | 1480 | ||
0 commit comments