config.txt: move guitool.* to a separate file
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Nguyễn Thái Ngọc Duy committed
Oct 27, 2018 at 08:23 UTC
2c31a83037cd2df1f7ab3db8fbcf42501395179d
2 files changed
+51
-50
Documentation/config.txt
+1
-50
@@ -345,56 +345,7 @@ include::config/gpg.txt[]
345
346
include::config/gui.txt[]
347
348
-guitool.<name>.cmd::
349
- Specifies the shell command line to execute when the corresponding item
350
- of the linkgit:git-gui[1] `Tools` menu is invoked. This option is
351
- mandatory for every tool. The command is executed from the root of
352
- the working directory, and in the environment it receives the name of
353
- the tool as `GIT_GUITOOL`, the name of the currently selected file as
354
- 'FILENAME', and the name of the current branch as 'CUR_BRANCH' (if
355
- the head is detached, 'CUR_BRANCH' is empty).
356
-
357
-guitool.<name>.needsFile::
358
- Run the tool only if a diff is selected in the GUI. It guarantees
359
- that 'FILENAME' is not empty.
360
-
361
-guitool.<name>.noConsole::
362
- Run the command silently, without creating a window to display its
363
- output.
364
-
365
-guitool.<name>.noRescan::
366
- Don't rescan the working directory for changes after the tool
367
- finishes execution.
368
-
369
-guitool.<name>.confirm::
370
- Show a confirmation dialog before actually running the tool.
371
-
372
-guitool.<name>.argPrompt::
373
- Request a string argument from the user, and pass it to the tool
374
- through the `ARGS` environment variable. Since requesting an
375
- argument implies confirmation, the 'confirm' option has no effect
376
- if this is enabled. If the option is set to 'true', 'yes', or '1',
377
- the dialog uses a built-in generic prompt; otherwise the exact
378
- value of the variable is used.
379
-
380
-guitool.<name>.revPrompt::
381
- Request a single valid revision from the user, and set the
382
- `REVISION` environment variable. In other aspects this option
383
- is similar to 'argPrompt', and can be used together with it.
384
-
385
-guitool.<name>.revUnmerged::
386
- Show only unmerged branches in the 'revPrompt' subdialog.
387
- This is useful for tools similar to merge or rebase, but not
388
- for things like checkout or reset.
389
-
390
-guitool.<name>.title::
391
- Specifies the title to use for the prompt dialog. The default
392
- is the tool name.
393
-
394
-guitool.<name>.prompt::
395
- Specifies the general prompt string to display at the top of
396
- the dialog, before subsections for 'argPrompt' and 'revPrompt'.
397
- The default value includes the actual command.
348
+include::config/guitool.txt[]
349
350
help.browser::
351
Specify the browser that will be used to display help in the
Documentation/config/guitool.txt
new
+50
@@ -0,0 +1,50 @@
1
+guitool.<name>.cmd::
2
+ Specifies the shell command line to execute when the corresponding item
3
+ of the linkgit:git-gui[1] `Tools` menu is invoked. This option is
4
+ mandatory for every tool. The command is executed from the root of
5
+ the working directory, and in the environment it receives the name of
6
+ the tool as `GIT_GUITOOL`, the name of the currently selected file as
7
+ 'FILENAME', and the name of the current branch as 'CUR_BRANCH' (if
8
+ the head is detached, 'CUR_BRANCH' is empty).
9
+
10
+guitool.<name>.needsFile::
11
+ Run the tool only if a diff is selected in the GUI. It guarantees
12
+ that 'FILENAME' is not empty.
13
+
14
+guitool.<name>.noConsole::
15
+ Run the command silently, without creating a window to display its
16
+ output.
17
+
18
+guitool.<name>.noRescan::
19
+ Don't rescan the working directory for changes after the tool
20
+ finishes execution.
21
+
22
+guitool.<name>.confirm::
23
+ Show a confirmation dialog before actually running the tool.
24
+
25
+guitool.<name>.argPrompt::
26
+ Request a string argument from the user, and pass it to the tool
27
+ through the `ARGS` environment variable. Since requesting an
28
+ argument implies confirmation, the 'confirm' option has no effect
29
+ if this is enabled. If the option is set to 'true', 'yes', or '1',
30
+ the dialog uses a built-in generic prompt; otherwise the exact
31
+ value of the variable is used.
32
+
33
+guitool.<name>.revPrompt::
34
+ Request a single valid revision from the user, and set the
35
+ `REVISION` environment variable. In other aspects this option
36
+ is similar to 'argPrompt', and can be used together with it.
37
+
38
+guitool.<name>.revUnmerged::
39
+ Show only unmerged branches in the 'revPrompt' subdialog.
40
+ This is useful for tools similar to merge or rebase, but not
41
+ for things like checkout or reset.
42
+
43
+guitool.<name>.title::
44
+ Specifies the title to use for the prompt dialog. The default
45
+ is the tool name.
46
+
47
+guitool.<name>.prompt::
48
+ Specifies the general prompt string to display at the top of
49
+ the dialog, before subsections for 'argPrompt' and 'revPrompt'.
50
+ The default value includes the actual command.