HG Plugin (Mercurial)/en
Introduction
The plugin provides the necessary commands for managing a test-suite via HG / Mercurial. Bookmarks, branches and heads can be used.
A general description of the functionality and commands of HG / Mercurial can be found for example on https://www.mercurial-scm.org/wiki/
Initialization
Clone
Clone a repository to a new local directory. The URL of the repository and the location of the local directory are requested.
Add and Commit
Add File
Adds the test-suite to the next version
hg add <testsuite>
Commit...
Commit the test-suite
hg commit
Commit (amend)...
Amend the parent of the working directory
hg commit --amend
Rollback Last Commit
roll back the last transaction (DANGEROUS). This command should be used with care. There is only one level of rollback, and there is no way to undo a rollback.
hg rollback
Revert Changes
Restore Testsuite to its checkout state
hg revert <testsuite>
Branches
Branch names are permanent and global. Create a light-weight bookmark instead
Create Local Branch...
Create a new branch
hg branch <new branch name>
Checkout Branch...
Set the current branch
hg branch <branch name>
Bookmarks
Create Bookmark
Create a bookmark at the current position
hg bookmark <name>
Delete Bookmark...
Delete a bookmark
hg bookmark -d <name>
Move Bookmark...
Move a bookmark to the current position
hg bookmark -f <name>
Push Bookmark...
The specified bookmarked revision, its ancestors, and the bookmark will be pushed to the remote repository.
hg push -B <name>
Checkout Bookmark...
Update the repository's working directory to the bookmark
hg checkout -r <name>
Show Bookmarks
List existing bookmarks
hg bookmarks
Heads
Checkout Head...
Update the repository's working directory to the head
hg checkout -r <head-rev>
Show Heads
List all heads or heads of a branch
Push / Update
Push
Push changesets/commits from the local repository
hg push
Update
Pull changes and updates the working directory
hg pull && hg update <current branch>
Pull / Merge
Pull
Pull changes
hg pull
Merge
Merge head.
If there is more than one head, the desired head can be selected in a dialog
Merge Branch...
Merge branch.
If there is more than one head, the desired head can be selected in a dialog.
Merge Commit
Commits the merge. Normally done automatically during the merge.
Merge Abort after Conflict
Abort the ongoing merge
hg merge --abort
Informations
Show Commit Log
List the commits
Show Log Tree
List the commits arranged graphically as tree (number limited to 100)
hg log -T "{node} {date} {branch} {bookmarks} {desc|firstline} {tags}" -G -l 100
Show Status
Show information with branch, status, phase and unresolved files
Troubleshooting
Log HG commands
To see which HG commands are sent, they can be output on the Transcript window.
You can activate this in the settings:
"Extras" → "Settings": "expecco Settings" → "Execution" → "Tracing": Select "Show External OS Commands on Transcript".
Open the Transcript window via "Extras" → "Tools" → "Transcript" in the expecco menu.