README: integrate various changes and suggestions from Rafael Villar Burke
authormpm@selenic.com
Tue, 31 May 2005 22:17:34 -0800
changeset 204 161cef501e8d
parent 203 0b486b5e0796
child 205 d255d99a7cbd
README: integrate various changes and suggestions from Rafael Villar Burke -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 README: integrate various changes and suggestions from Rafael Villar Burke manifest hash: ce1999b3ffc19c1dca582355e32e1ea9b8d108f0 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (GNU/Linux) iD8DBQFCnVL+ywK+sNU5EO8RAnfRAJ9eIlaxdzExbvQUlvaofk+aWMfzUgCfTmeb 4DfwOHsb8IreNXRs00jJtJI= =mt6J -----END PGP SIGNATURE-----
README
--- a/README	Tue May 31 21:33:27 2005 -0800
+++ b/README	Tue May 31 22:17:34 2005 -0800
@@ -1,14 +1,27 @@
-Setting up Mercurial in your home directory:
+Setting up Mercurial:
 
- Note: Debian fails to include bits of distutils, you'll need
- python-dev to install. Alternately, shove everything somewhere in
- your path.
+ Note: some distributions fails to include bits of distutils by
+ default, you'll need python-dev to install.
+
+ First, unpack the source:
 
  $ tar xvzf mercurial-<ver>.tar.gz
  $ cd mercurial-<ver>
- $ python2.3 setup.py install --home ~
+
+ Then to install:
+
+ $ python setup.py install   # change python to python2.3 if 2.2 is default
+
+ To install in your home directory (~/bin and ~/lib, actually), simply
+ run:
+
+ $ python2.3 setup.py install --home=~
  $ export PYTHONPATH=${HOME}/lib/python  # add this to your .bashrc
+ $ export PATH=${HOME}/bin:$PATH         # 
  $ export HGMERGE=tkmerge                # customize this
+
+ And finally:
+
  $ hg                                    # test installation, show help
 
  If you get complaints about missing modules, you probably haven't set
@@ -86,7 +99,12 @@
  foo$ cp hgweb.cgi ~/public_html/hg-linux/index.cgi
  foo$ emacs ~/public_html/hg-linux/index.cgi # adjust the defaults
 
- # Give symbolic names to repos
- foo$ echo "main http://selenic.com/hg/" >> ~/.hgpaths # one pair per line
+Symbolic repository names:
+
+ Mercurial uses an optional file called ~/.hgpaths to track repo
+ locations symbolically. Simply add a line with the name, a space, and
+ a URL:
+
+ foo$ echo "main http://selenic.com/hg/" >> ~/.hgpaths
  foo$ hg merge main
  foo$ hg co