guitool

guitool.<name>.cmd
Specifies the shell command line to execute when the corresponding item of the linkgit:git-gui[1] Tools menu is invoked. This option is mandatory for every tool. The command is executed from the root of the working directory, and in the environment it receives the name of the tool as GIT_GUITOOL, the name of the currently selected file as ’FILENAME’, and the name of the current branch as ’CUR_BRANCH’ (if the head is detached, ’CUR_BRANCH’ is empty).

guitool.<name>.needsFile
Run the tool only if a diff is selected in the GUI. It guarantees that ’FILENAME’ is not empty.

guitool.<name>.noConsole
Run the command silently, without creating a window to display its output.

guitool.<name>.noRescan
Don’t rescan the working directory for changes after the tool finishes execution.

guitool.<name>.confirm
Show a confirmation dialog before actually running the tool.

guitool.<name>.argPrompt
Request a string argument from the user, and pass it to the tool through the ARGS environment variable. Since requesting an argument implies confirmation, the ’confirm’ option has no effect if this is enabled. If the option is set to ’true’, ’yes’, or ’1’, the dialog uses a built-in generic prompt; otherwise the exact value of the variable is used.

guitool.<name>.revPrompt
Request a single valid revision from the user, and set the REVISION environment variable. In other aspects this option is similar to ’argPrompt’, and can be used together with it.

guitool.<name>.revUnmerged
Show only unmerged branches in the ’revPrompt’ subdialog. This is useful for tools similar to merge or rebase, but not for things like checkout or reset.

guitool.<name>.title
Specifies the title to use for the prompt dialog. The default is the tool name.

guitool.<name>.prompt
Specifies the general prompt string to display at the top of the dialog, before subsections for ’argPrompt’ and ’revPrompt’. The default value includes the actual command.