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

stable doc: improve readability, add content. Part 4

Changeset 2f3a44375698

Parent 2bae10a0b3b8

by Steve Borho

Changes to 6 files · Browse files at 2f3a44375698 Showing diff from parent 2bae10a0b3b8 Diff from another changeset...

 
2
3
4
5
 
6
7
8
 
15
16
17
18
 
19
20
21
 
2
3
4
 
5
6
7
8
 
15
16
17
 
18
19
20
21
@@ -2,7 +2,7 @@
 ========    .. module:: datamine.dialog - :synopsis: Dialog used to search in the history + :synopsis: Dialog used to search repository history    The datamine application is used to inspect the revision history of your  repository. It is a tabbed application that supports two tab types, @@ -15,7 +15,7 @@
 .. figure:: figures/search.png   :alt: Search dialog   - Search dialog + Search dialog    The search tab is used to search (*grep*) through your entire revision  history for keywords, variable names, functions, etc...
 
1
2
3
 
 
 
4
5
6
 
 
 
 
1
2
3
4
5
6
@@ -1,6 +1,6 @@
-************** -TortoiseHg FAQ -************** +************************** +Frequently Asked Questions +**************************      *What is TortoiseHg?*
 
1
2
 
 
 
3
4
5
 
7
8
9
10
 
11
12
13
 
 
 
1
2
3
4
5
6
 
8
9
10
 
11
12
13
14
@@ -1,5 +1,6 @@
-TortoiseHg Recovery -=================== +******** +Recovery +********    .. module:: recovery.dialog   :synopsis: Dialog used to perform recovery operations @@ -7,7 +8,7 @@
 .. figure:: figures/recover.png   :alt: Recovery dialog   -The buttons all equate to a single Mercurial command (save stop, obviously) +The toolbar buttons equate to a Mercurial command    :guilabel:`clean`   :command:`hg update --clean` - performs a clean checkout of the
 
1
2
 
 
3
4
5
 
12
13
14
15
16
 
17
18
19
 
 
 
 
 
 
 
 
20
21
22
 
 
 
 
23
24
25
26
27
28
29
30
 
 
31
32
33
 
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
 
 
 
1
2
3
4
5
 
12
13
14
 
 
15
16
 
 
17
18
19
20
21
22
23
24
25
 
 
26
27
28
29
30
 
 
 
 
 
 
 
31
32
33
34
35
 
43
44
45
 
 
 
46
47
48
49
50
51
52
53
 
54
55
56
57
 
58
59
 
60
61
 
 
 
 
 
 
 
 
 
 
 
62
63
64
@@ -1,5 +1,5 @@
-TortoiseHg Serve -================ +Serve +=====    .. module:: serve.dialog   :synopsis: Dialog used to start/stop the web server @@ -12,22 +12,24 @@
 repository(ies) or perform clone, pull, or even push operations (if you  configure your server to allow it).   -:guilabel:`Start` - start the web server +Toolbar buttons:   -:guilabel:`Stop` - stop the web server + :guilabel:`Start` + start the web server + :guilabel:`Stop` + stop the web server + :guilabel:`Browse` + open your default browser at the built-in web server + :guilabel:`Configure` + Configure repository web style, description, and access policies   -:guilabel:`Browse` - open your default browser at the built-in web server +When the settings dialog is launched via the :guilabel:`Configure` +button, it is run in the context of the current repository. Please +visit the Mercurial wiki for detailed descriptions of the various +web configurations.   -:guilabel:`Configure` - Configure repository web style, description, and access policies - -When the settings dialog is launched via the :guilabel:`Configure` button, it is -run in the context of the current repository. Please visit the -Mercurial wiki for detailed descriptions of what the various web -configurations are for. +Multiple Repositories +---------------------    If you wish to serve a many repositories with a single web server  instance, you can create an :file:`hgwebdir.conf` text file with the @@ -41,32 +43,22 @@
 can be found on your computer. Multiple entries are possible.    To use this file you must launch the TortoiseHg serve dialog from the -command line via: :command:`hgtk serve --webdir-conf=hgwebdir.conf`. In a -future release of TortoiseHg, we hope to make this launchable from the -shell context menu. +command line via: :command:`hgtk serve --webdir-conf=hgwebdir.conf`. +    From command line  -----------------    The server tool can be started from command line ::   - hgtk serve + hgtk serve [OPTION]...   + web server   -The syntax is :: + options:   - hgtk serve [OPTIONS] + --webdir-conf name of the webdir config file   -The valid [OPTIONS] are: - -``--webdir-conf`` - It specifies the name of the webdir config file. See above for details. - - -Changes since 0.7 ------------------ - -* Improved error handling -* i18n fixes + use "hgtk -v help serve" to show global options    .. vim: noet ts=4
 
1
2
3
 
 
 
4
5
6
 
360
361
362
363
364
 
 
365
366
367
 
375
376
377
378
 
 
379
380
 
 
 
 
1
2
3
4
5
6
 
360
361
362
 
 
363
364
365
366
367
 
375
376
377
 
378
379
380
381
@@ -1,6 +1,6 @@
-******************* -TortoiseHg Settings -******************* +******** +Settings +********    .. module:: settings.dialog   :synopsis: Dialog used to set preferences @@ -360,8 +360,8 @@
 :guilabel:`Ignore Blank Lines:`   Ignore changes whose lines are all blank.   Default: False. - - + +  From command line  =================   @@ -375,6 +375,7 @@
   for the user configuration (:file:`Mercurial.ini` file).   -The syntax is simple, no options or parameters are needed, except the global options. +The syntax is simple, no options or parameters are needed, except the global +options.    .. vim: noet ts=4
 
1
2
 
 
3
4
5
 
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
 
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
67
68
69
 
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
 
 
 
 
 
 
 
 
 
 
 
 
95
96
97
 
100
101
102
103
104
105
106
 
 
 
 
107
108
109
 
129
130
131
132
133
 
 
134
135
136
 
142
143
144
145
 
146
147
 
148
149
 
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
 
 
 
1
2
3
4
5
 
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
 
48
49
50
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
81
82
83
 
 
 
 
 
 
 
 
 
 
 
 
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
 
101
102
103
 
 
 
 
104
105
106
107
108
109
110
 
130
131
132
 
 
133
134
135
136
137
 
143
144
145
 
146
147
 
148
149
 
150
151
 
 
 
 
 
 
 
 
 
 
 
 
 
 
152
153
154
@@ -1,5 +1,5 @@
-TortoiseHg Synchronize -====================== +Synchronize +===========    .. module:: synchronize.dialog   :synopsis: Dialog used to perform synchronization operations @@ -10,32 +10,33 @@
  Synchronize dialog    The synchronize tool is used to transmit changesets between repositories -or optionally to email recipients. +or to email recipients.   -:guilabel:`Incoming` - show changesets that would be pulled from target repository, the changes - in the target repository that are not in local repository -:guilabel:`Pull` - pull incoming changesets from target repository -:guilabel:`Outgoing` - show changesets that would be pushed to target repository, the changes - in the local repository that are not in target repository -:guilabel:`Push` - push outgoing changesets to target repository, make the local *tip* - the new *tip* in the target repository -:guilabel:`Email` - send outgoing changesets (to target repository) as email -:guilabel:`Stop` - stop current operation -:guilabel:`Configure` - configure repository paths (aliases) + :guilabel:`Incoming` + show changesets that would be pulled from target repository, the + changes in the target repository that are not in local repository + :guilabel:`Pull` + pull incoming changesets from target repository + :guilabel:`Outgoing` + show changesets that would be pushed to target repository, the + changes in the local repository that are not in target + repository + :guilabel:`Push` + push outgoing changesets to target repository, make the local + *tip* the new *tip* in the target repository + :guilabel:`Email` + send outgoing changesets (to target repository) as email + :guilabel:`Stop` + stop current operation + :guilabel:`Configure` + configure repository paths (aliases)    Below the toolbar are two buttons and a text entry:   -:guilabel:`Repo:` - browse for a local repository to synchronize with -:guilabel:`Bundle:` - browse for a local bundle file to pull from + :guilabel:`Repo:` + browse for a local repository to synchronize with + :guilabel:`Bundle:` + browse for a local bundle file to pull from    The text entry/combo box is where you enter or select paths of target  repositories. The synchronize tool will seed the drop-down list with @@ -47,23 +48,23 @@
 default behavior for your user account and override that selection on a  per-repository basis.   -:guilabel:`Nothing` - No operations are performed after a pull. You will be allowed to - view the pulled changesets in the log viewer, and you will have the - option to update to the new tip if applicable. -:guilabel:`Update` - Automatically update to the new branch tip if, and only if, new - revisions were pulled into the local repository. This could trigger - a merge if the pulled changes conflict with local uncommitted - changes. -:guilabel:`Fetch` - Equivalent to hg fetch. See the fetch extension documentation for - it's behavior. -: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. + :guilabel:`Nothing` + No operations are performed after a pull. You will be allowed to + view the pulled changesets in the log viewer, and you will have the + option to update to the new tip if applicable. + :guilabel:`Update` + Automatically update to the new branch tip if, and only if, new + revisions were pulled into the local repository. This could trigger + a merge if the pulled changes conflict with local uncommitted + changes. + :guilabel:`Fetch` + Equivalent to hg fetch. See the fetch extension documentation for + it's behavior. + :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.    The :guilabel:`use proxy` button is a quick way to disable your proxy  configuration for individual operations. The button is only sensitive @@ -80,18 +81,18 @@
 Under the :guilabel:`Advanced Options` fold-up panel are a number of  configurables that are valid for most push/pull operations.   -:guilabel:`Force pull or push` - override warnings about multiple heads or unrelated repositories -:guilabel:`Target Revision` - to avoid sending all revisions -:guilabel:`Remote Command` - provides -e argument -:guilabel:`Show patches` - show diffs in incoming and outging changes -:guilabel:`Show Newest First` - reverse order that changesets are listed -:guilabel:`Show No Merges` - filter out merge changesets from output (does not affect push/pull) + :guilabel:`Force pull or push` + override warnings about multiple heads or unrelated repositories + :guilabel:`Target Revision` + to avoid sending all revisions + :guilabel:`Remote Command` + provides -e argument + :guilabel:`Show patches` + show diffs in incoming and outging changes + :guilabel:`Show Newest First` + reverse order that changesets are listed + :guilabel:`Show No Merges` + filter out merge changesets from output (does not affect push/pull)      After Pull @@ -100,10 +101,10 @@
 After changesets are pulled into your repository, two buttons may appear  at the bottom of the dialog:   -:guilabel:`View pulled changesets` - Open the changelog viewer and inspect pulled changesets -:guilabel:`Update to tip` - Update your working directory to the new tip + :guilabel:`View pulled changesets` + Open the changelog viewer and inspect pulled changesets + :guilabel:`Update to tip` + Update your working directory to the new tip    Either button may be hidden if it is not applicable.   @@ -129,8 +130,8 @@
 where you can configure your SMTP settings and set default  :guilabel:`To:` and :guilabel:`From:` addresses.   -:guilabel:`In-Reply-To:` can be used to get your patches properly -threaded in mailing lists. +:guilabel:`In-Reply-To:` is used to make your patches properly threaded +in mailing lists.    Please consult the Mercurial documentation for the differences between  plain patches, HG patches, Git patches, and bundles. @@ -142,26 +143,12 @@
    hgtk synch   -or :: + aliases: pull, push, incoming, outgoing, email   - hgtk pull + repository synchronization tool   -or :: + use "hgtk -v help synch" to show global options   - hgtk push - -or :: - - hgtk incoming - -or :: - - hgtk outcoming - -or :: - - hgtk email -  The syntax is simple, no options or parameters are needed, except the  global options. If the synchronize tool is started via push, outgoing,  or email command aliases, it will automatically select the