Kiln » TortoiseHg » TortoiseHg
Clone URL:  
Pushed to one repository · View In Graph Contained in 0.9, 0.9.1, and 0.9.1.1

doc: further documentation updates

Changeset 7d225b291b28

Parent 61edf21219ab

by Steve Borho

Changes to 9 files · Browse files at 7d225b291b28 Showing diff from parent 61edf21219ab Diff from another changeset...

 
14
15
16
17
18
 
 
19
20
21
 
 
 
 
 
22
23
24
 
 
25
26
27
 
 
 
28
29
30
31
32
 
 
 
 
33
34
35
 
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
@@ -14,22 +14,27 @@
  Clone Dialog    :guilabel:`Source Path` - It is the path (or URL) of the repository that will be cloned. Use the :guilabel:`Browse...` to - choose a local folder. + It is the path (or URL) of the repository that will be cloned. Use + the :guilabel:`Browse...` to choose a local folder.  :guilabel:`Destination Path` - It is the path of destination directory, a folder with the same name of source repository will - be created within this directory. + It is the path of destination directory, a folder with the same name + of source repository will be created within this directory. + +Under the :guilabel:`Advanced options` expander you will find: +  :guilabel:`Clone To Revision` - You can limit the clone up to this revision. Even the tags created after this revision will not be - imported. + You can limit the clone up to this revision. Even the tags created + after this revision will not be imported.  :guilabel:`do not update the new working directory` - If checked, after the clone the working directory will be empty. It is useful when you have to clone - a repository with the purpose of central repository, or backup, where you have only, in the future, + If checked, after the clone the working directory will be empty. It + is useful when you have to clone a repository with the purpose of + central repository, or backup, where you have only, in the future,   to *push* and *pull*.  :guilabel:`use pull protocol to copy metadata` - When the source and destination are on the same filesystem, Mercurial tries to use hardlinks. Some - filesystems, such as AFS implement hardlink incorrectly, but do not report errors. Use this option - to avoid hardlinks. + When the source and destination are on the same filesystem, + Mercurial tries to use hardlinks. Some filesystems, such as AFS + implement hardlink incorrectly, but do not report errors. Use this + option to avoid hardlinks.  :guilabel:`use uncompressed transfer`   To use uncompressed transfer (fast over LAN).  :guilabel:`use proxy server`
 
132
133
134
135
136
 
 
 
 
 
 
 
 
 
 
 
 
 
137
138
139
 
152
153
154
155
156
157
158
 
 
 
 
159
160
161
162
 
163
164
165
 
132
133
134
 
 
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
 
163
164
165
 
 
 
 
166
167
168
169
170
171
172
 
173
174
175
176
@@ -132,8 +132,19 @@
 user includes such a file in a selection (explorer) or provides the file  name on the command line.   -To the right of the file list is the diff pane. New in release 0.9, the -diff pane is now tabbed. +.. figure:: figures/parentbar.png + :alt: Parent bar + + Parent bar in commit dialog + +Below both the file list and diff pane is a narrow +:guilabel:`Parents Bar`. This bar shows you the current working +directory parent(s), and gives you some warnings if a commit would +introduce a new head. The parents bar can be hidden by an option in the +:guilabel:`View` menu. + +To the right of the file list is the diff pane. The diff pane is newly +tabbed in the 0.9 release.     :guilabel:`Text Diff`   Shows the textual diffs in the currently selected file. @@ -152,14 +163,14 @@
  Only visible when the commit tool is in QRefresh mode. It   displays the current contents of the patch being refreshed.   -Below both the file list and diff pane is a narrow *Parents Bar*. This -bar shows you the current working directory parent(s), and gives you -some warnings if a commit would introduce a new head. The parents bar -can be hidden by an option in the :guilabel:`View` menu. +.. figure:: figures/advancedbar.png + :alt: Advanced bar + + Advanced bar in commit dialog    If the :guilabel:`Advanced Bar` is enabled in the :guilabel:`View` menu,  a bar is inserted between the toolbar and the message history bar. The -*advanced bar* contains: +advanced bar contains:     :guilabel:`Committer`   The username to use for this commit. This value is usually read
 
65
66
67
 
 
 
68
69
70
 
98
99
100
101
102
103
104
105
106
 
 
 
 
107
108
109
 
65
66
67
68
69
70
71
72
73
 
101
102
103
 
 
 
 
 
 
104
105
106
107
108
109
110
@@ -65,6 +65,9 @@
  open an annotation tab for this file at this revision   :guilabel:`file history`   open a changelog window with this file's revision history + :guilabel:`view file at revision` + open the current file at the specified revision in your favorite + text editor.      Annotate Tabs @@ -98,12 +101,10 @@
   The annotation data will automatically follow lines of code back through  copies and renames to find the initial changeset that introduced the -line. The graph log pane will not follow renames or copies -automtaically. Instead, when you click on a changeset in the revision -graph that involved a rename or copy event, a button will appear that -will allow you to follow the history graph back through the rename. -Clicking on the button will open a new tab with the older filename -annotated at the same changeset. +line. The graph log pane will also attempt to follow renames and +copies, so some lines in the graph may corrolate to different filenames +than the original annotated file path. Renames are indicated in the +graph by color changes within a column.    Configurables  ^^^^^^^^^^^^^
 
66
67
68
69
70
 
 
71
72
73
 
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
66
67
68
 
 
69
70
71
72
73
 
75
76
77
 
 
 
 
 
 
 
 
78
79
80
@@ -66,8 +66,8 @@
  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 +commands. Less frequently used and newly added Mercurial commands +must need be accessed on the CLI (command line interface) through  :file:`cmd.exe` windows.    The context menus are configurable via the taskbar menu. Simply click on @@ -75,14 +75,6 @@
 :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  --------  
Removed image
 
46
47
48
49
 
50
51
52
 
79
80
81
82
83
 
 
84
85
86
 
46
47
48
 
49
50
51
52
 
79
80
81
 
 
82
83
84
85
86
@@ -46,7 +46,7 @@
 .. 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. + uninstall can be initiated from the control panel or the start menu.    .. note::   If you have 0.8 or later already installed, the installer will close @@ -79,8 +79,8 @@
 On Linux and Mac  ----------------   -RPM packages for Fedora are available on the -`Download <http://bitbucket.org/tortoisehg/stable/downloads/>`_ +Debian DEB and RPM packages for Fedora are available on the +`download <http://bitbucket.org/tortoisehg/stable/wiki/download/>`_  page of the wiki.    Deb packages for Ubuntu can be found at
 
253
254
255
256
257
258
259
260
261
262
263
 
253
254
255
 
 
 
 
 
256
257
258
@@ -253,11 +253,6 @@
 .. note::   Merges can be safely restarted if necessary.   -.. figure:: figures/synchronize.png - :alt: Synchronize dialog - - Synchronize Dialog -  Mercurial makes collaboration easy, fast, and productive.  Learn more at Mercurial's `wiki <http://mercurial.selenic.com/wiki/>`_.  
 
65
66
67
68
69
70
71
72
 
 
 
 
 
 
 
73
74
75
 
65
66
67
 
 
 
 
 
68
69
70
71
72
73
74
75
76
77
@@ -65,11 +65,13 @@
 Tabs  ----   -The shelve tool has four tabs -1) Text Diff - shows diff of currently selected file -2) Hunk Selection - allows diff hunks of current file to be skipped -3) Shelf Preview - displays all selected changes. This previews the changes that will be removed from the working directory and stored in the shelf. -4) Shelf Contents - the current contents of the shelf. +The shelve tool diff pane has four tabs + 1) Text Diff - shows diff of currently selected file + 2) Hunk Selection - allows diff hunks of current file to be skipped + 3) Shelf Preview - displays all selected changes. This previews the + changes that will be removed from the working directory and + stored in the shelf. + 4) Shelf Contents - the current contents of the shelf.      Shelving Changes
 
31
32
33
 
 
 
 
34
35
36
 
64
65
66
67
 
 
68
69
70
71
72
 
 
 
73
74
75
 
31
32
33
34
35
36
37
38
39
40
 
68
69
70
 
71
72
73
 
 
 
 
74
75
76
77
78
79
@@ -31,6 +31,10 @@
  *tip* the new *tip* in the target repository   :guilabel:`Email`   send outgoing changesets (to target repository) as email + :guilabel:`Shelve` + launch the shelve tool to allow working changes to be + temporarily moved into the shelf, since some operations require + the working directory to be clean.   :guilabel:`Stop`   stop current operation   :guilabel:`Configure` @@ -64,12 +68,12 @@
  changes.   :guilabel:`Fetch`   Equivalent to hg fetch. See the fetch extension documentation for - it's behavior. + it's behavior. This feature is only available if the fetch + extension has been enabled by the user.   :guilabel:`Rebase` - Equivalent to pull --rebase. See the rebase extension documentation - for it's behavior. Rebase operations disable connections to any - changelog tools, since it is very destructive to any app which is - holding a repository object. + Equivalent to pull --rebase. See the rebase extension + documentation for it's behavior. This feature is only available + if the rebase extension has been enabled by the user.    The :guilabel:`use proxy` button is a quick way to disable your proxy  configuration for individual operations. The button is only sensitive