Kiln » TortoiseHg » TortoiseHg
Clone URL:  
/ doc/ source
common.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
=============== Common Features =============== .. module:: common.dialog :synopsis: Common features to all the dialog These features are common to many TortoiseHg tools, so we document them here just once. Translations ============ The TortoiseHg tools use Python's `gettext <http://docs.python.org/library/gettext.html>`_ library to localize their text. To get localized dialogs, it is recommended that you set the LANGUAGE environment variable to your locale of choice. The Windows shell extension context menus get their translations from the Windows registry. Translations for many locales are available from the TortoiseHG `wiki <http://bitbucket.org/tortoisehg/stable/wiki/install>`_. Geometry Restore ================ Our primary applications like commit, changelog, and datamine will restore their geometry and position from the last time they were run. This includes maximization status. If the state to be restored does not fit within your current screen dimensions, the application will revert to factory default dimensions. The TortoiseHg dialogs which are more transitory in nature simply allow the window manager to place them where it wishes. Keyboard Accelerators ===================== We define a few keyboard accelerators that all of the TortoiseHg tools support. :kbd:`CTRL-Q` quit the application, including all open windows :kbd:`CTRL-W` close the current window (same as :kbd:`CTRL-Q` if only one window is open) :kbd:`CTRL-D` visual diff of currently selected file or changeset :kbd:`CTRL-ENTER` activation :kbd:`F5` refresh On `Mac OS X <http://bitbucket.org/tortoisehg/stable/wiki/MacOSX>`_, the apple (command) key is used as the modifier instead of :kbd:`CTRL`. However some keyboard accelerators are internal to GTK+ so you must use the control key to access cut-paste functionality, for instance. Visual Diffs ============ 0.8 introduced a visual diff dialog that solves four usability issues: 1) The ability to select visual diff tools for individual files 2) Allows you to use visual diff tools that fork backround processes 3) Allows you to use visual diff tools that do not support directory diffs 4) Provides feedback when no files were modified If you prefer the previous (<=0.7) behavior of directly launching your visual diff tool, you can recover that behavior via the user settings dialog and :menuselection:`TortoiseHg --> Skip Diff Window`. Treeview searches ================= Many TortoiseHg dialogs use treeviews to present lists of data to the user. The file lists in the status, commit, shelve, and changelog tools are treeviews. The changelog graph pane is a treeview. And even the annotate pane in the datamine tool is a treeview. Most of the TortoiseHg treeviews (as of release 0.8) are configured for live searches. Ensure that the treeview has focus (by clicking on a row), and begin typing a search phrase. A small entry window will appear containing the text you have typed, and the treeview will immediately jump to the first row that matches the text you have entered thus far. As you enter more characters, the search is refined. * :kbd:`CTRL-F` opens the search window explicitly * :kbd:`CTRL-G` advances the search to the next match * :kbd:`SHIFT-CTRL-G` searches backwards * The mouse scroll wheel will advance forwards and backwards through matching lines HG command dialog ================= Many TortoiseHg tools use the *hgcmd* dialog to execute Mercurial commands that could potentially be interactive. In release 0.8, this dialog was changed to draw all error messages in a dark red color to give it more contrast with normal output messages. The window also properly focuses its :guilabel:`close` button when the command has completed, so a simple :kbd:`Enter` is that that is required to close the window. *hgcmd* also responds appropriately to the global :kbd:`CTRL-W` and more drastic :kbd:`CTRL-Q` accelerators.