global/git
1
0
Fork 0
mirror of https://github.com/git/git.git synced 2026-03-05 14:59:04 +01:00
Code Issues Packages Projects Releases Wiki Activity

doc: add information regarding external commands

Browse Source 
Git supports running external commands in the user's PATH as if they
were built-in commands (see execv_dashed_external in git.c).

This feature was not fully documented in Git's user-facing
documentation.

Add a short documentation to describe how PATH is used to find a custom
subcommand.

Signed-off-by: Omri Sarig <omri.sarig13@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Omri Sarig
2026-03-04 15:03:34 +00:00
committed by Junio C Hamano
parent 67ad42147a
commit 9c6569a895
1 changed files with 8 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
Documentation/git.adoc
View File

@@ -487,6 +487,14 @@ System
`$HOMEDRIVE$HOMEPATH` if both `$HOMEDRIVE` and `$HOMEPATH` exist;
otherwise `$USERPROFILE` if `$USERPROFILE` exists.
`PATH`::
When a user runs 'git <command>' that is not part of the core Git programs
(installed in GIT_EXEC_PATH), 'git-<command>' that is runnable by the user
in a directory on `$PATH` is invoked. Argument passed after the command
name are passed as-is to the program. To execute `git <foo>`, `git` finds
command `<foo>` (either a core Git program found in 'GIT_EXEC_PATH', or a
custom one in a directory on 'PATH'), before trying `foo` as an alias.
The Git Repository
~~~~~~~~~~~~~~~~~~
These environment variables apply to 'all' core Git commands. Nb: it