Changeset f64eb7b9f92b…
Parent f7594b2dd133…
by
Changes to 8 files · Browse files at f64eb7b9f92b Showing diff from parent f7594b2dd133 Diff from another changeset...
|
@@ -4,6 +4,30 @@ .. 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
-------------
@@ -26,15 +50,67 @@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`. In the settings
-dialog you can promote individual menu options to the top menu.
+:menuselection:`TortoiseHg --> Explorer Extension Settings`. This opens the
+TortoiseHg Shell Configuration dialog.
-.. figure:: figures/taskbarui.png
- :alt: Shell Configuration dialog
+On the tab "Context Menu" you can promote individual menu options to the
+top level menu.
- Shell Configuration Dialog
+.. 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 settings allow to enable/disable of overlay handlers in the
+ shared TortoiseOverlays component. The TortoiseOverlays component is shared
+ by all Tortoises (TortoiseHg, TortoiseSVN, etc), so that Windows overlay
+ icon slots can be shared. The total number of overlay slots available on
+ Windows is fairly limited and depends on the exact Windows version used
+ and on what other programs are installed. For example, on a pristine install
+ of Windows 7, there are only 8 free overlay handler slots available.
+ This section allows to individually disable certain non-essential overlay
+ handlers, so that they do not use up an overlay handler slot.
+ Note that these settings affect ALL Tortoises per user (login).
+ 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) are installed. Make sure the "Added"
+ and "Unversioned" handlers are enabled (these are used by TortoiseHg).
+ (Default: all checked)
+
+: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
@@ -42,30 +118,6 @@
@@noicons
-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.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
-may be accessed from the CLI (command line interface) through
-:file:`cmd.exe` on Windows.
-
Nautilus
--------
|
|
|
|
|
|
|
|
Loading...