Kiln » TortoiseHg » TortoiseHg
Clone URL:  
/ doc/ source
intro.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
************ Introduction ************ .. module:: introduction :synopsis: Introduce TortoiseHg and its various parts What is TortoiseHg? =================== TortoiseHg is a set of graphical tools and a shell extension for the `Mercurial <http://mercurial.selenic.com/wiki/>`_ distributed revision control system. On Windows, TortoiseHg consists of a shell extension, which provides overlay icons and context menus in your file explorer, and a command line program named :file:`hgtk.exe` which can launch the TortoiseHg tools. Binary packages of TortoiseHg for Windows come with Mercurial and a merge tool and are thus completely ready for use "Out of the Box". On Linux, TortoiseHg consists of a command line hgtk script, and a Nautilus extension which provides overlays and context menus in your file explorer. TortoiseHg is primarily written in Python and PyGtk (the Windows shell extension being a noticeable exception). The hgtk script and TortoiseHg dialogs can be used on any platform that supports PyGtk, including Mac OS X. Installing TortoiseHg ===================== On Windows ---------- TortoiseHg comes with an easy to use installer. Double click on the installer file and follow the instructions. The installer will take care of the rest. After installation a reboot is necessary. .. note:: If you have an older (<0.8) version already installed, the installer will ask that you to remove the previous version of TortoiseHg. The uninstall can be done from the control panel or the start menu. If no other applications are using TortoiseOverlays, it is recommended, but not strictly required, to uninstall them when you upgrade an earlier release. If you have 0.8 or later already installed, you must close all instances of the ThgTaskBar application before installation can proceed. Language settings ^^^^^^^^^^^^^^^^^ The TortoiseHg user interface has been translated into many languages. You don't need to download a language pack. All the available languages are shipped with the installer. Look in :file:`C:\\Program Files\\TortoiseHg\\locale` for the available languages. To enable a language just set the environment variable ``LANGUAGE`` to the desidered language, e.g. for italian ``set LANGUAGE=it``. .. note:: After setting LANGUAGE, if the standard GUI elements like :guilabel:`OK` and :guilabel:`Apply` still appear in English, it means the TortoiseHg installer did not include a translation of GTK+ for your locale. This means the translation of TortoiseHg for your locale was incomplete at release time. 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>`_. Once the desidered file is downloaded (rename it to :file:`.reg` if the extension is :file:`.txt`), double-click on it and confirm all the requests. On Linux and Mac ---------------- RPM packages for Fedora are available on the `Download <http://bitbucket.org/tortoisehg/stable/downloads/>`_ page of the wiki. Deb packages for Ubuntu can be found at `this <https://launchpad.net/~maxb/+archive/ppa>`_ or `that <https://launchpad.net/~tortoisehg-ppa>`_ location. For MacOSX, no packages are available but you can run hgtk and all the dialogs via the source install method. For details, see `MacOSX <http://bitbucket.org/tortoisehg/stable/wiki/MacOSX>`_. Language settings ^^^^^^^^^^^^^^^^^ 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. .. vim: noet ts=4