aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorIan Wienand <iwienand@redhat.com>2024-05-27 10:30:47 +1000
committerJunio C Hamano <gitster@pobox.com>2024-05-27 10:44:07 -0700
commit174443ed3aa5adbc962d46c23e13dbd3794811fb (patch)
tree66b011cd17a47ed336e0f936f153b1964c8818a6
parent786a3e4b8d754d2b14b1208b98eeb0a554ef19a8 (diff)
downloadgit-174443ed3aa5adbc962d46c23e13dbd3794811fb.tar.gz
Documentation: alias: rework notes into points
There are a number of caveats when using aliases. Rather than stuffing them all together in a paragraph, let's separate them out into individual points to make it clearer what's going on. Signed-off-by: Ian Wienand <iwienand@redhat.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r--Documentation/config/alias.txt11
1 files changed, 6 insertions, 5 deletions
diff --git a/Documentation/config/alias.txt b/Documentation/config/alias.txt
index 01df96fab3..40851ef429 100644
--- a/Documentation/config/alias.txt
+++ b/Documentation/config/alias.txt
@@ -21,8 +21,9 @@ If the alias expansion is prefixed with an exclamation point,
it will be treated as a shell command. For example, defining
`alias.new = !gitk --all --not ORIG_HEAD`, the invocation
`git new` is equivalent to running the shell command
-`gitk --all --not ORIG_HEAD`. Note that shell commands will be
-executed from the top-level directory of a repository, which may
-not necessarily be the current directory.
-`GIT_PREFIX` is set as returned by running `git rev-parse --show-prefix`
-from the original current directory. See linkgit:git-rev-parse[1].
+`gitk --all --not ORIG_HEAD`. Note:
++
+* Shell commands will be executed from the top-level directory of a
+ repository, which may not necessarily be the current directory.
+* `GIT_PREFIX` is set as returned by running `git rev-parse --show-prefix`
+ from the original current directory. See linkgit:git-rev-parse[1].