Diff for "HgkExtension"

Mercurial includes a tool called hgk that allows browsing the history of a repository in a GUI. It's a direct port of the gitk tool used with git. Hgk requires Tcl/Tk version 8.4 or later.

To use hgk, you'll want to install the hgk.py extension which adds a view command as well as other interfaces that hgk uses to communicate with Mercurial in a git-like manner.

hgk is found in the contrib directory. hgk.py is located in the hgext directory.

To load an extension, you add it to your .hgrc file (you have to use your global $HOME/.hgrc file, not one in a repository). You can specify an absolute path:

[extensions]
hgk=/usr/local/lib/hgk.py

Mercurial can also scan the default python library path for a file named 'hgk.py' if you set hgk empty:

[extensions]
hgk=

You would also need to add hgk to your search path, or specify the path to hgk in your .hgrc file:

[hgk]
path=/location/of/hgk

In version 0.7, this extension is named "hgit" (without the .py) and does not provide the view command. You must invoke hgk directly.

Now hg help will show the new commands provided by the hgk extension:

$ hg help
...
 status      show changed files in the working directory
 tag         add a tag for the current tip or a given revision
 tags        list repository tags
 tip         show the tip revision
 unbundle    apply a changegroup file
 undo        undo the last commit or pull
 update      update or merge working directory
 verify      verify the integrity of the repository
 version     output version and copyright information
 view        start interactive history viewer
$ hg view

Keyboard Accelerators

The following key combinations can be used to perform certain actions:

Ctrl+q                    quit
Ctrl+f                    find
Ctrl+= or Ctrl+<Keypad +> increase font size
Ctrl+- or Ctrl+<Keypad -> decrease font size
Ctrl+g, Return, or '/'    find next match
Ctrl+r or '?'             find previous match
Arrow-up                  select previous changeset
Arrow-down                select next changeset
Page-up or 'p'            scroll changeset list up one page
Page-down or 'n'          scroll changeset list down one page
Delete, Backspace or 'b'  scroll viewed changeset up one page
Space                     scroll viewed changeset down one page
'd'                       scroll viewed changeset down 18 lines
'u'                       scroll viewed changeset up 18 lines

Selected font size will be saved in ~/.gitk and reused in the next session.

CategoryExtension