Kiln » TortoiseHg » TortoiseHg
Clone URL:  
/ doc/ source
explorer.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
Windows Explorer Integration ============================ .. module:: explorer :synopsis: Windows explorer integration 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. The new C++ shell extension is an order of magnitude faster than the Python extension used in previous releases, but we still make the overlays configurable via the taskbar menu. Simply click on the Mercurial (droplet) icon in the system tray and select :guilabel:`Options`. In the options dialog you can disable overlays globally, or enable them for local disks only. .. figure:: figures/taskbarui.jpg :alt: Taskbar options dialog Taskbar Options Dialog Release 0.8.1 introduced the ability to selectively disable overlay icons in specific repositories. This can be done be editing the :file:`.hg\\thgstatus` file inside the repository and replacing it's contents with a single line containing:: @@noicons Context Menus ------------- The TortoiseHg commands (GUI window & dialogs) may be accessed via the context menu of Explorer windows. The TortoiseHg context menu is context sensitive and which varies according to the current folder and file selection. Here is the context menu for a revisioned folder: .. figure:: figures/cmenu-nofiles.jpg :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.jpg :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 must need be accessed on the CLI (command line interface) through the :file:`cmd.exe` windows. The context menus are configurable via the taskbar menu. Simply click on the Mercurial (droplet) icon in the system tray and select :guilabel:`Options`. In the options dialog you can promote individual menu options to the top menu. This is the file rename/move dialog: .. figure:: figures/rename.jpg :alt: Rename file dialog File rename (or move) dialog 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 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