https://github.com/sublimetext/sublimehg
Use Mercurial from Sublime Text.
https://github.com/sublimetext/sublimehg
Last synced: 9 months ago
JSON representation
Use Mercurial from Sublime Text.
- Host: GitHub
- URL: https://github.com/sublimetext/sublimehg
- Owner: SublimeText
- License: mit
- Created: 2011-07-11T05:58:35.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2013-01-20T20:55:37.000Z (about 13 years ago)
- Last Synced: 2025-03-29T12:11:13.480Z (10 months ago)
- Language: Python
- Homepage:
- Size: 582 KB
- Stars: 30
- Watchers: 7
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.txt
- License: LICENSE.txt
Awesome Lists containing this project
README
=========
SublimeHg
=========
Issue commands to Mercurial from Sublime Text.
Requirements
============
* Mercurial command server (Mercurial 1.9 or above)
Getting Started
===============
- `Download`_ and install SublimeHg. (See the `installation instructions`_ for *.sublime-package* files.)
.. _Download: https://bitbucket.org/guillermooo/sublimehg/downloads/SublimeHg.sublime-package
.. _installation instructions: http://docs.sublimetext.info/en/latest/extensibility/packages.html#installation-of-sublime-package-files
Configuration
=============
These options can be set in **Preferences | Settings - User**.
``packages.sublime_hg.hg_exe``
By default, the executable name for Mercurial is ``hg``. If you need to
use a different one, such as ``hg.bat``, change this option.
Example::
{
"packages.sublime_hg.hg_exe": "hg.bat"
}
``packages.sublime_hg.terminal``
Determines the terminal emulator to be used in Linux. Some commands, such
as *serve*, need this information to work.
``packages.sublime_hg.extensions``
A list of Mercurial extension names. Commands belonging to these extensions
will show up in the SublimeHg quick panel along with built-in Mercurial
commands.
How to Use
==========
SublimeHg can be used in two ways:
- Through a *menu* (``show_sublime_hg_menu`` command).
- Through a *command-line* interface (``show_sublime_hg_cli`` command).
Regardless of the method used, SublimeHg ultimately talks to the Mercurial
command server. The command-line interface is the more flexible option, but
some operations might be quicker through the menu.
By default, you have to follow these steps to use SublimeHg:
#. Open the Command Palette (``Ctrl+Shift+P``) and look for ``SublimeHg``.
#. Select option
#. Select Mercurial command (or type in command line)
It is however **recommended to assign** ``show_sublime_hg_cli`` and
``show_sublime_hg_menu`` their own **key bindings**.
For example::
{ "keys": ["ctrl+k", "ctrl+k"], "command": "show_sublime_hg_menu" },
{ "keys": ["ctrl+shift+k"], "command": "show_sublime_hg_cli" },
Restarting the Current Server
=============================
The Mercurial command server will not detect changes to the repository made
from the outside (perhaps from a command line) while it is running. To restart
the current server so that external changes are picked up, select
*Kill Current Server* from the command palette.
Tab Completion
==============
While in the command-line, top level commands will be autocompleted when you
press ``Tab``.
Quick Actions
=============
In some situations, you can perform quick actions.
Log
***
In a log report (``text.mercurial-log``), select two commit numbers (``keyword.other.changeset-ref.short.mercurial-log``)
and press *CTRL+ENTER* to **diff the two revisions** (``diff -rSMALLER_REV_NR:LARGER_REV_NR``).
If you want to **update to a revision number**, select a commit number and press *CTRL+SHIFT+ENTER* (``update REV_NR``).
Donations
=========
You can tip me through www.gittip.com: guillermooo_.
.. _guillermooo: http://www.gittip.com/guillermooo/