{"thread":{"id":"16728","subject":"[PATCH] Documentation: Describe git-gui Tools menu configuration options.","startedAt":"2008-12-14T19:44:32Z","lastAt":"2008-12-15T00:43:16Z","messageCount":2,"participants":["Alexander Gavrilov","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"97892","messageId":"200812142244.32438.angavrilov@gmail.com","threadId":"16728","inReplyTo":null,"subject":"[PATCH] Documentation: Describe git-gui Tools menu configuration options.","fromName":"Alexander Gavrilov","fromEmail":"angavrilov@gmail.com","sentAt":"2008-12-14T19:44:32Z","receivedAt":"2008-12-14T19:44:32Z","isPatch":true,"sender":{"key":"angavrilov@gmail.com","avatar":"https://avatars.githubusercontent.com/u/42666?v=4"},"body":"Now git gui has a customizable Tools menu, so this adds\ninformation about variables that are used to configure it.\n\nSigned-off-by: Alexander Gavrilov <angavrilov@gmail.com>\n---\n Documentation/config.txt |   51 ++++++++++++++++++++++++++++++++++++++++++++++\n 1 files changed, 51 insertions(+), 0 deletions(-)\n\ndiff --git a/Documentation/config.txt b/Documentation/config.txt\nindex b233fe5..2a06a3c 100644\n--- a/Documentation/config.txt\n+++ b/Documentation/config.txt\n@@ -839,6 +839,57 @@ gui.blamehistoryctx::\n \tContext` menu item is invoked from 'git gui blame'. If this\n \tvariable is set to zero, the whole history is shown.\n \n+guitool.<name>.cmd::\n+\tSpecifies the shell command line to execute when the corresponding item\n+\tof the linkgit:git-gui[1] `Tools` menu is invoked. This option is\n+\tmandatory for every tool. The command is executed from the root of\n+\tthe working directory, and in the environment it receives the name of\n+\tthe tool as 'GIT_GUITOOL', the name of the currently selected file as\n+\t'FILENAME', and the name of the current branch as 'CUR_BRANCH' (if\n+\tthe head is detached, 'CUR_BRANCH' is empty).\n+\n+guitool.<name>.needsfile::\n+\tRun the tool only if a diff is selected in the GUI. It guarantees\n+\tthat 'FILENAME' is not empty.\n+\n+guitool.<name>.noconsole::\n+\tRun the command silently, without creating a window to display its\n+\toutput.\n+\n+guitool.<name>.norescan::\n+\tDon't rescan the working directory for changes after the tool\n+\tfinishes execution.\n+\n+guitool.<name>.confirm::\n+\tShow a confirmation dialog before actually running the tool.\n+\n+guitool.<name>.argprompt::\n+\tRequest a string argument from the user, and pass it to the tool\n+\tthrough the 'ARGS' environment variable. Since requesting an\n+\targument implies confirmation, the 'confirm' option has no effect\n+\tif this is enabled. If the option is set to 'true', 'yes', or '1',\n+\tthe dialog uses a built-in generic prompt; otherwise the exact\n+\tvalue of the variable is used.\n+\n+guitool.<name>.revprompt::\n+\tRequest a single valid revision from the user, and set the\n+\t'REVISION' environment variable. In other aspects this option\n+\tis similar to 'argprompt', and can be used together with it.\n+\n+guitool.<name>.revunmerged::\n+\tShow only unmerged branches in the 'revprompt' subdialog.\n+\tThis is useful for tools similar to merge or rebase, but not\n+\tfor things like checkout or reset.\n+\n+guitool.<name>.title::\n+\tSpecifies the title to use for the prompt dialog. The default\n+\tis the tool name.\n+\n+guitool.<name>.prompt::\n+\tSpecifies the general prompt string to display at the top of\n+\tthe dialog, before subsections for 'argprompt' and 'revprompt'.\n+\tThe default value includes the actual command.\n+\n help.browser::\n \tSpecify the browser that will be used to display help in the\n \t'web' format. See linkgit:git-help[1].\n-- \n1.6.0.4.30.gf4240\n"},{"id":"97910","messageId":"7vhc561d5n.fsf@gitster.siamese.dyndns.org","threadId":"16728","inReplyTo":"200812142244.32438.angavrilov@gmail.com","subject":"Re: [PATCH] Documentation: Describe git-gui Tools menu configuration options.","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-12-15T00:43:16Z","receivedAt":"2008-12-15T00:43:16Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Alexander Gavrilov <angavrilov@gmail.com> writes:\n\n> Now git gui has a customizable Tools menu, so this adds\n> information about variables that are used to configure it.\n\nI'll apply this as-is to include in -rc3; git-gui users please proofread\nand send in any updates/fixes if necessary.\n"}]}