Differences between revisions 1 and 19 (spanning 18 versions)
Revision 1 as of 2010-04-14 18:39:15
Size: 409
Editor: PaulLambert
Comment:
Revision 19 as of 2010-04-16 11:16:37
Size: 2627
Editor: abuehl
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== Extension Name == == Cedit ==
Line 3: Line 3:
'''This extension is/is not distributed with Mercurial.''' '''This extension is not distributed with Mercurial.'''
Line 13: Line 13:
Command Line editor for Mercurial configuration files. Features both an interactive editor and an options parsing mode. Simplifies Mercurial configuration so that users never have to manually edit their hgrc / Mercurial.ini files, if they so choose.

Cedit does have a bootstrapping feature - you don't have to manually touch your configuration files to install this extension (unlike almost every other Mercurial extension). Simply run "python start.py" and you should be good to go.
Line 14: Line 18:
Configure your .hgrc to enable the extension by adding following lines:
If you have just installed mercurial, this will get you going:

{{{
hg clone http://bitbucket.org/paulitex/cedit/
cd cedit
python start.py
}}}

Now you should be able to run 'hg setuser' to set your username and 'hg cedit' to launch the interactive configuration editor.


NOTE TO WINDOWS USERS: To run the bootstrapping script it is required that you have Python installed and in your path. It is not sufficient to have Mercurial installed. If you have Mercurial installed but not Python, you can still use the extension by manually adding it to your Mercurial.ini file. Using something like
Line 18: Line 34:
... config = /path/to/cedit/directory/
Line 21: Line 37:
for example, mine is

{{{
[extensions]
config = /Users/paulrl/cedit
}}}

IMPORTANT: the extension should point to the extension's containing folder, not the .py (config.py) - unlike almost every other extension.

Again this is all only necessary if you don't have Python in your path, otherwise a simple "python start.py" will take care of all of this for you.

=== Usage ===
So you've just installed Mercurial, created a new repository, and are all ready to commit your first changes, but 'hg commit -m "Hello World!"' instead gives you something like 'abort: no username supplied (see "hg help config")'. You need to set your username.

You could do this by manually editing your configuration file, but new users may find it easier to use the [[CeditExtension]] that provides a 'hg setuser' command to do this. To set your username, navigate to a directory where you can store extensions and grab that extension like so (Make sure you have python installed and in your path. This is not the case by default in Windows):

{{{
hg clone http://bitbucket.org/paulitex/cedit/
cd cedit
python start.py
hg setuser
}}}

Now you should be able to commit without error.
Line 22: Line 63:
CategoryExtension CategoryExtensionsByOthers CategoryExtensionsByOthers

Cedit

This extension is not distributed with Mercurial.

Author: Paul Lambert

Download site: http://bitbucket.org/paulitex/cedit/

Tested with: Mercurial >= 1.4.3

Overview

Command Line editor for Mercurial configuration files. Features both an interactive editor and an options parsing mode. Simplifies Mercurial configuration so that users never have to manually edit their hgrc / Mercurial.ini files, if they so choose.

Cedit does have a bootstrapping feature - you don't have to manually touch your configuration files to install this extension (unlike almost every other Mercurial extension). Simply run "python start.py" and you should be good to go.

Configuration

If you have just installed mercurial, this will get you going:

hg clone http://bitbucket.org/paulitex/cedit/
cd cedit
python start.py

Now you should be able to run 'hg setuser' to set your username and 'hg cedit' to launch the interactive configuration editor.

NOTE TO WINDOWS USERS: To run the bootstrapping script it is required that you have Python installed and in your path. It is not sufficient to have Mercurial installed. If you have Mercurial installed but not Python, you can still use the extension by manually adding it to your Mercurial.ini file. Using something like

[extensions]
config = /path/to/cedit/directory/

for example, mine is

[extensions]
config = /Users/paulrl/cedit

IMPORTANT: the extension should point to the extension's containing folder, not the .py (config.py) - unlike almost every other extension.

Again this is all only necessary if you don't have Python in your path, otherwise a simple "python start.py" will take care of all of this for you.

Usage

So you've just installed Mercurial, created a new repository, and are all ready to commit your first changes, but 'hg commit -m "Hello World!"' instead gives you something like 'abort: no username supplied (see "hg help config")'. You need to set your username.

You could do this by manually editing your configuration file, but new users may find it easier to use the CeditExtension that provides a 'hg setuser' command to do this. To set your username, navigate to a directory where you can store extensions and grab that extension like so (Make sure you have python installed and in your path. This is not the case by default in Windows):

hg clone http://bitbucket.org/paulitex/cedit/
cd cedit
python start.py
hg setuser

Now you should be able to commit without error.


CategoryExtensionsByOthers

CeditExtension (last edited 2011-04-02 00:22:37 by GregWard)