Changeset 59979ef85be5…
Parent ef6a0a326d32…
by
Changes to 9 files · Browse files at 59979ef85be5 Showing diff from parent ef6a0a326d32 Diff from another changeset...
@@ -1,4 +1,3 @@ - ===========================
TortoiseHg Changelog Viewer
===========================
@@ -32,7 +31,7 @@This changelog browser offers much more.
Revision Graph Details
-======================
+----------------------
The graph column shows the child-parent relationships between revisions
in your repository history. This column auto-sizes for as many lines of
@@ -51,7 +50,7 @@ load all remaining revisions into the graph
Revision Context Menus
-======================
+----------------------
Right-clicking on a revision in the (top) graph pane will bring up the
revision context menu.
@@ -114,7 +113,7 @@
File List Context Menus
-=======================
+-----------------------
Right-clicking on filenames in the file list (bottom left) pane will
bring up a context menu for the selected file:
@@ -139,7 +138,7 @@
Changeset browser
-=================
+-----------------
The changelog and datamine tools can open the changeset browser to view
a single revision or the combined effect of a range of revisions. The
@@ -160,7 +159,7 @@accelerator to copy hightlighted diff hunks to the clipboard.
Configurables
-=============
+-------------
The changelog browser has a few configurable options that can be set in
the TortoiseHg Settings dialog on the Changelog tab.
@@ -192,7 +191,7 @@
From command line
-=================
+-----------------
The changelog viewer can be started from command line ::
|
|
|
@@ -1,4 +1,3 @@ - ======================
TortoiseHg Commit Tool
======================
@@ -24,7 +23,7 @@ Commit dialog
Features
-========
+--------
Walking across the toolbar, the buttons perform the following tasks:
@@ -81,7 +80,7 @@rename.
Change Selection (record)
-=========================
+-------------------------
So what does that mean when it says the commit button will commit the
selected diffs in checked files? Simple, the native TortoiseHg commit
@@ -92,7 +91,7 @@Mercurial's record extension will recognize this immediately.
When is this necessary?
------------------------
+^^^^^^^^^^^^^^^^^^^^^^^
Most often, it is when you have made more than a single coherent change
to your source code and you would like to commit your changes piecemeal.
@@ -102,7 +101,7 @@indespensable.
How does it work?
------------------
+^^^^^^^^^^^^^^^^^
By double-clicking on individual change hunks in the diff panel.
*Technically, any action which activates a change hunk row will toggle
@@ -119,7 +118,7 @@partially included, or excluded entirely.
What happens at commit time?
-----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The short answer is that the selected files and hunks are committed to
the repository and the unselected changes are left in your working
@@ -145,7 +144,7 @@
Keyboard navigation
-===================
+-------------------
:kbd:`Ctrl-Enter`
will trigger the commit
@@ -163,7 +162,7 @@
File Context Menus
-==================
+------------------
By right clicking on files in the file list, you will get a context menu
of commands that are applicable to the selected file. If you configure a
@@ -177,7 +176,7 @@
Merges
-======
+------
The commit tool has a special mode when it is opened in a repository
that is in a merged state (technically, this means the current working
@@ -203,7 +202,7 @@
Commit Message Format
-=====================
+---------------------
If your project has guidelines for commit message format, you can
configure those in the settings tool. Once configured, the commit tool
@@ -212,7 +211,7 @@on the commit message pane that will try to enforce your policy.
MQ patches
-==========
+----------
Many advanced Mercurial users use the MQ extension to manage a patch
queue. TortoiseHg does not offer much in the way of support for MQ, but
@@ -243,7 +242,7 @@patches and take advantage of our excellent change selection support.
QNew Mode
-=========
+---------
Newly added in 0.8, the commit tool can be used to create a new patch
for your patch queue. If you have the MQ extension enabled, a text
@@ -272,7 +271,7 @@
Configurables
-=============
+-------------
:menuselection:`Commit --> Username`
Sets username associated with your commits
@@ -290,7 +289,7 @@External tool configuration is deprecated and will be removed in 0.9
From command line
-=================
+-----------------
The commit tool can be started from command line ::
@@ -323,7 +322,7 @@
Changes since 0.7
-=================
+-----------------
* The :guilabel:`Show Diff` button has been removed. Diffs are always shown.
* The commit tool no longer shows all diffs at startup. Only the first
@@ -349,7 +348,7 @@
Changes since 0.6
-=================
+-----------------
Large changes were made to the commit tool in the 0.7 release. The
previous default tool, Qct, was unbundled and TortoiseHg's native commit
|
@@ -1,4 +1,3 @@ - ===============
Common Features
===============
@@ -9,7 +8,7 @@here just once.
Geometry Restore
-================
+----------------
Our primary applications like commit, changelog, and datamine will
restore their geometry and position from the last time they were run.
@@ -22,7 +21,7 @@window manager to place them where it wishes.
Keyboard Accelerators
-=====================
+---------------------
We define a few keyboard accelerators that all of the TortoiseHg tools support.
@@ -47,7 +46,7 @@access cut-paste functionality, for instance.
Visual Diffs
-============
+------------
0.8 introduced a visual diff dialog that solves four usability issues:
@@ -61,7 +60,7 @@dialog and :menuselection:`TortoiseHg --> Skip Diff Window`.
Treeview searches
-=================
+-----------------
Many TortoiseHg dialogs use treeviews to present lists of data to the
user. The file lists in the status, commit, shelve, and changelog tools
@@ -82,7 +81,7 @@ matching lines
HG command dialog
-=================
+-----------------
Many TortoiseHg tools use the *hgcmd* dialog to execute Mercurial
commands that could potentially be interactive. In release 0.8, the
|
@@ -1,4 +1,3 @@ - ===================
TortoiseHg Datamine
===================
@@ -11,7 +10,7 @@
Search Tabs
-===========
+-----------
.. figure:: figures/search.png
:alt: Search dialog
@@ -55,7 +54,7 @@sensitive when a search is in progress).
Matches
-=======
+-------
Each match will be a link to a changeset and will have a descriptive
tooltip (author, date/time, summary). Right clicking on a matched line
@@ -69,7 +68,7 @@ open a changelog window with this file's revision history
Annotate Tabs
-=============
+-------------
.. figure:: figures/annotate.png
:alt: Annotate tabs
@@ -94,7 +93,7 @@:guilabel:`filename` and :guilabel:`user`.
Following Renames
------------------
+^^^^^^^^^^^^^^^^^
The annotation data will automatically follow lines of code back through
copies and renames to find the initial changeset that introduced that
@@ -106,7 +105,7 @@annotated at the same changeset.
Configurables
--------------
+^^^^^^^^^^^^^
The annotate tabs support the following configurations defined primarily
for other tools:
@@ -117,7 +116,7 @@ Number of spaces to expand tabs in diffs and annotate output
From command line
-=================
+-----------------
The datamine tool can be started from command line ::
|
@@ -1,12 +1,11 @@ - ============================
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
@@ -35,7 +34,7 @@ @@noicons
Performance Issues
-==================
+------------------
When the repository being viewed contains a large number of folders or
files, the overlay icons may appear case a perceivable delay in
@@ -55,7 +54,7 @@local disks only.
Context Menus
-=============
+-------------
The TortoiseHg commands (GUI window & dialogs) may be accessed via the
context menu of Explorer windows. The TortoiseHg context menu is
|
|
- ================
TortoiseHg Serve
================
.. module:: serve.dialog
:synopsis: Dialog used to start/stop the web server
.. figure:: figures/serve.png
:alt: Web server dialog
The serve tool is a wrapper for Mercurial's built-in web server. Once
launched, any computer can attach to the http port and browse your
repository(ies) or perform clone, pull, or even push operations (if you
configure your server to allow it).
: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
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.
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
following contents: ::
[paths]
/ = /path/to/repositories/*
The first path '/' is where the repositories will appear in the context
of the web server and the second path describes here the repositories
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.
From command line
-=================
+-----------------
The server tool can be started from command line ::
hgtk serve
The syntax is ::
hgtk serve [OPTIONS]
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
.. vim: noet ts=4
|
@@ -1,4 +1,3 @@ - ======================
TortoiseHg Shelve Tool
======================
@@ -51,7 +50,7 @@clean, ignored}.
Shelving Changes
-================
+----------------
Just like the commit tool, this dialog uses TortoiseHg's integrated hunk
@@ -66,7 +65,7 @@to the working directory.
How is this different from record/commit?
------------------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Shelved changes are physically removed from the working directory until
you unshelve them. This means you can build your project and run tests
@@ -84,7 +83,7 @@changes made to your code after the shelving.
How is this different from MQ?
-------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A shelf is, in effect, a single unnamed MQ patch that is never converted
into a changeset. The shelve tool can be useful when you are
@@ -92,7 +91,7 @@re-apply them to another patch (or an entirely new patch).
How is this different from attic?
----------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The attic extension is a super-set of the shelve feature. In particular,
attic allows you to have several named *shelves* which can be saved and
@@ -101,7 +100,7 @@releases.
Keyboard navigation
-===================
+-------------------
:guilabel:`Ctrl-C`
in the diff panel will copy the currently highlighted (not selected,
@@ -116,13 +115,13 @@clipboard contents always be a valid patch.
Configurables
-=============
+-------------
* :menuselection:`TortoiseHg --> Bottom Diffs`
* :menuselection:`TortoiseHg --> Tab Width`
From command line
-=================
+-----------------
The shelve tool can be started from command line ::
|
@@ -1,4 +1,3 @@ - ======================
TortoiseHg Synchronize
======================
@@ -96,7 +95,7 @@
After Pull
-==========
+----------
After changesets are pulled into your repository, two buttons may appear
at the bottom of the dialog:
@@ -109,7 +108,7 @@Either button may be hidden if it is not applicable.
Email
-=====
+-----
.. figure:: figures//email.png
:alt: Email dialog
@@ -137,7 +136,7 @@plain patches, HG patches, Git patches, and bundles.
From command line
-=================
+-----------------
The synchronize tool can be started from command line ::
@@ -171,7 +170,7 @@path it finds.
Changes since 0.7
-=================
+-----------------
* Path drop-down list no longer includes most-recently-used paths. It
only includes configured repository paths.
|
Loading...