Differences between revisions 4 and 19 (spanning 15 versions)
Revision 4 as of 2010-04-14 18:43:50
Size: 1250
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 3: Line 3:
'''This extension is/is not distributed with Mercurial.''' '''This extension is not distributed with Mercurial.'''
Line 17: Line 17:
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 by not Python, you can still use the extension by manually adding it to you Mercurial.ini file.
Line 24: Line 22:
hg clone https://paulitex@bitbucket.org/paulitex/cedit/ hg clone http://bitbucket.org/paulitex/cedit/
Line 29: Line 27:
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.
Line 30: 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)