Kiln » TortoiseHg » TortoiseHg
Clone URL:  
Pushed to one repository · View In Graph Contained in 2.0, 2.0.1, and 2.0.2

stable doc: it's -> its

Changeset 3209c7ced253…

Parent 913bd2e1614e…

by Steve Borho

Changes to one file · Browse files at 3209c7ced253 Showing diff from parent 913bd2e1614e Diff from another changeset...

Change 1 of 2 Show Changes Only doc/​source/​explorer.txt Stacked
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
 
128
129
130
131
132
133
134
135
136
137
138
139
140
 
141
142
143
144
145
146
147
148
149
150
151
152
153
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
 
127
128
129
130
131
132
133
134
135
136
137
138
139
 
140
141
142
143
144
145
146
147
148
149
150
151
152
153
 Windows Explorer Integration  ============================    .. module:: explorer   :synopsis: Windows explorer integration    Context Menus  -------------    TortoiseHg commands may be accessed via the context menu of Explorer  windows and other applications which use the standard File/Open dialogs.  Here is the context menu for a revisioned folder:    .. figure:: figures/cmenu-nofiles.png   :alt: Context menu     Context menu for a folder under Mercurial revision control    And here is the context menu for selected files or folders:    .. figure:: figures/cmenu-files.png   :alt: Context menu     Context menu for file or folder selection    TortoiseHg provides dialogs for the most regularly used Mercurial  commands. Less frequently used and newly added Mercurial commands  may be accessed from the CLI (command line interface) through  :file:`cmd.exe` on Windows.    Overlay Icons  -------------    TortoiseHg provides visual representation of the file status via overlay  icons in the MS-Explorer windows. This is similar to those that found on  other Tortoise client, such as TortoiseCVS and TortoiseSVN.    TortoiseHg shares the overlay icons with TortoiseSVN (version 1.5.x or  later) and the other "Tortoise" projects via the use of TortoiseOverlays  (another project created by TortoiseSVN team).    .. figure:: figures/overlayicons.png   :alt: Overlay icons     Overlay icons in Icons view (XP)    The context menu has an :guilabel:`Update Icons` option which forces  TortoiseHg to refresh the icons in the currently browsed repository or  directory of repositories. The taskbar icon will turn green and the  directory icons will turn into question marks while this refresh is in  progress.    Shell Configuration  -------------------    The overlay handler and context menus are configurable. From any folder  background (even the desktop), right click and select  :menuselection:`TortoiseHg --> Explorer Extension Settings`. This opens the  TortoiseHg Shell Configuration dialog.    On the tab "Context Menu" you can promote individual menu options to the  top level menu.    .. figure:: figures/shell-config-cmenu.png   :alt: Shell Configuration dialog, Context Menu tab     Shell Configuration Dialog, Context Menu tab    On the "Icons" tab you configure settings related to the overlay icons and the  icon of the "Overlay Icons Server" in the taskbar (in the notification area of  Windows).    .. figure:: figures/shell-config-icons.png   :alt: Shell Configuration dialog, Icons tab     Shell Configuration Dialog, Icons tab    :guilabel:`Enable overlays:`   If checked, overlay icons are shown on folders and files in the   working directory (woking copy) of Mercurial repositories.   (Default: checked)    :guilabel:`Local disks only:`   If checked, overlay icons are only shown for volumes on local disks, not   on network shares. Scanning for Mercurial repositories over the network   may result in high latency in the user interface of explorer. Check this   option if browsing network shares becomes too slow and/or you do not need   overlay icons on non-local volumes.   (Default: not checked)    :guilabel:`Enabled Overlay Handlers:`   These (per user) settings provide the possibility to disable overlay   icon handlers in the shared TortoiseOverlays component.   The TortoiseOverlays component is shared by all Tortoises (TortoiseHg,   TortoiseSVN, etc), with the goal to avoid registering too many icon slots,   by using a common set of icons slots for all Tortoises (thus using the   same set of icons for all Tortoises).   The total number of overlay slots available on Windows is fairly limited and   depends on the exact Windows version. For example, on a pristine install   of Windows 7, there are only 8 free overlay handler slots available.   This section allows to disable certain non-essential overlay   handlers, to reduce icon handler slot consumption by the TortoiseOverlays   component. Unchecking handlers in this section increases the chances that   important handlers like "Normal" (green checkmark) or "Modifed" (red   exclamation mark) will still get an icon slot, even if there are too many   handlers registered on a computer.   Unchecking handlers that are not used by TortoiseHg (that is: Locked,   Readonly, Ignored, Deleted) is highly recommended, if you know that no   other Tortoises (e.g. TortoiseSVN) uses them.   Make sure the "Added" and "Unversioned" handlers are enabled, as these   are used by TortoiseHg.   (Default: all checked)    .. warning::   The "Enabled Overlay Handlers" settings affect all Tortoises for a user.   A logoff/login is required to make changes in that section effective.    :guilabel:`Taskbar:`   Checkmark "Show Icon" to show the icon of the Overlay Icon Server in the   taskbar in the notification area. "Highlight Icon" highlights that icon   using a light green color while the icon server is busy updating cache files   in the repository (files :file:`.hg\\dirstate` and :file:`.hg\\thgstatus`).   (Default: both checked)    One can selectively disable overlay icons in a specific repository by  editing the :file:`.hg\\thgstatus` file inside the repository and -replacing it's contents with a single line containing:: +replacing its contents with a single line containing::     @@noicons    Nautilus  --------    TortoiseHg also provides shell integration with the GNOME desktop via a  nautilus-python plugin. If you have installed TortoiseHg from a  distribution package, the odds are that this extension is already  configured. If not, please consult our Wiki for instructions on how to  enable this feature.   -While the nautilus extension does not have it's own GUI for managing the +While the nautilus extension does not have its own GUI for managing the  overlays and context menus, it does support command promotion into the  top menu. It requires you to edit your :file:`~/.hgrc` file and add  lines like these::     [tortoisehg]   promoteditems = commit, log, synch    .. figure:: figures/nautilus.png   :alt: Nautilus screenshot     GNOME/Nautilus screenshot    .. vim: noet ts=4