Differences between revisions 10 and 20 (spanning 10 versions)
Revision 10 as of 2010-04-14 18:50:49
Size: 1817
Editor: PaulLambert
Comment:
Revision 20 as of 2011-04-02 00:22:37
Size: 2620
Editor: GregWard
Comment: standard link terminology
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
Download site: [[http://bitbucket.org/paulitex/cedit/]] Repository: http://bitbucket.org/paulitex/cedit/
Line 17: Line 17:
=== 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.

Line 21: Line 34:
config = [path to cedit folder/director] config = /path/to/cedit/directory/
Line 31: Line 44:
IMPORTANT: the extension should point the to parent file, not the .py (config.py) - unlike almost every other extension. IMPORTANT: the extension should point to the extension's containing folder, not the .py (config.py) - unlike almost every other extension.
Line 33: Line 46:
Again this is all only necessary if you don't have Python in your path, otherwise simple "python start.py" will take care of all that for you. 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.
Line 35: Line 48:
=== Configuration === === 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.
Line 37: Line 51:
If you have just installed mercurial, this will get you going: 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):
Line 40: Line 54:
hg clone https://paulitex@bitbucket.org/paulitex/cedit/ hg clone http://bitbucket.org/paulitex/cedit/
Line 43: Line 57:
hg setuser
Line 45: Line 60:
Now you should be able to run 'hg setuser' to set your username and 'hg cedit' to launch the interactive configuration editor. Now you should be able to commit without error.
Line 47: Line 63:
CategoryExtension CategoryExtensionsByOthers CategoryExtensionsByOthers

Cedit

This extension is not distributed with Mercurial.

Author: Paul Lambert

Repository: 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)