Mercurial > hg-website
annotate text/Main.txt @ 17:c4fd656d11fc
Restructure
author | David Soria Parra <dsp@php.net> |
---|---|
date | Fri, 13 Feb 2009 12:15:30 +0100 |
parents | Main.txt@bcd2e95a6c8e |
children | 7b2d898ec15a |
rev | line source |
---|---|
2
4464db954ebe
Added a file for the main page
Arne Babenhauserheide <bab@draketo.de>
parents:
diff
changeset
|
1 Main page |
4464db954ebe
Added a file for the main page
Arne Babenhauserheide <bab@draketo.de>
parents:
diff
changeset
|
2 ========= |
4464db954ebe
Added a file for the main page
Arne Babenhauserheide <bab@draketo.de>
parents:
diff
changeset
|
3 |
3 | 4 Mercurial is... |
5 --------------- | |
6 | |
10
e1520f56951c
about: Added an 'extensible' section. Also did some polishing.
Arne Babenhauserheide <bab@draketo.de>
parents:
9
diff
changeset
|
7 Mercurial is a free, distributed source control management tool. It offers you the power to efficiently handle projects of any size yet provides an easy, intuitive interface. |
4
ee901315cf85
Reworked Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
3
diff
changeset
|
8 |
10
e1520f56951c
about: Added an 'extensible' section. Also did some polishing.
Arne Babenhauserheide <bab@draketo.de>
parents:
9
diff
changeset
|
9 Every Mercurial clone is a full-fledged repository with complete history and revision tracking capabilities. It is independent of network access or a central server. Committing, branching and merging are fast and cheap. |
3 | 10 |
10
e1520f56951c
about: Added an 'extensible' section. Also did some polishing.
Arne Babenhauserheide <bab@draketo.de>
parents:
9
diff
changeset
|
11 Mercurial is used for version control of files, much like tools such as [Git](http://git-scm.org), [Bazaar](http://bazaar-vcs.org), [Subversion](http://subversion.tigris.org/) and [CVS](http://www.nongnu.org/cvs/). It is written in Python and available on many different platforms, including Microsoft Windows, Mac OS X, Linux, FreeBSD and OpenSolaris. |
3 | 12 |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
13 |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
14 Projects using Mercurial |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
15 ------------------------ |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
16 |
8
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
17 * [Mercurial](http://selenic.com/repo/hg) |
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
18 * [Mozilla](http://hg.mozilla.org/) |
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
19 * [Cython](http://hg.cython.org/) |
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
20 * [MoinMoin](http://hg.moinmo.in/) |
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
21 * [OpenJDK](http://hg.openjdk.java.net/) |
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
22 * [NetBeans](http://hg.netbeans.org/) |
16
bcd2e95a6c8e
Naming. It's OpenSolaris not Open Solaris
David Soria Parra <dsp@php.net>
parents:
15
diff
changeset
|
23 * [OpenSolaris](http://hg.genunix.org/) |
8
094be09b1c5d
Added 7 Projects which use Mercurial.
Arne Babenhauserheide <bab@draketo.de>
parents:
7
diff
changeset
|
24 |
9 | 25 [and many more](http://www.selenic.com/mercurial/wiki/index.cgi/ProjectsUsingMercurial) |
26 | |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
27 |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
28 How you can benefit from using Mercurial |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
29 ---------------------------------------- |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
30 |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
31 ### Power and speed |
12
f75b80086a75
Benefit: Power, ease, serve.
Arne Babenhauserheide <bab@draketo.de>
parents:
11
diff
changeset
|
32 Mercurial offers you the power and speed to efficiently handle projects of any size and kind. You can use a multitude of [workflows]() and enhance its functionality with [extensions](). |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
33 |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
34 ### Ease of use |
12
f75b80086a75
Benefit: Power, ease, serve.
Arne Babenhauserheide <bab@draketo.de>
parents:
11
diff
changeset
|
35 Mercurials consistent and intuitive interface makes it easy to learn and understand. You can simply start with the [bare basics]() and learn incrementally or print a copy of the [hgbook]() to understand the big picture in one go. |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
36 |
14
d6ddddb01053
Readded 'just works' to benefits.
Arne Babenhauserheide <bab@draketo.de>
parents:
13
diff
changeset
|
37 ### Just works |
d6ddddb01053
Readded 'just works' to benefits.
Arne Babenhauserheide <bab@draketo.de>
parents:
13
diff
changeset
|
38 Mercurial strives to deliver on each of its promises. If it looks like you could use it for a specific task, chances are that it will just work on the first try. (if it doesn't, that's most likely no feature but a [bug](http://selenic.com/mercurial/bugs/)) |
d6ddddb01053
Readded 'just works' to benefits.
Arne Babenhauserheide <bab@draketo.de>
parents:
13
diff
changeset
|
39 |
12
f75b80086a75
Benefit: Power, ease, serve.
Arne Babenhauserheide <bab@draketo.de>
parents:
11
diff
changeset
|
40 [bare basics]: Quick_Start - Learn to use Mercurial in 30 seconds (or similar). |
f75b80086a75
Benefit: Power, ease, serve.
Arne Babenhauserheide <bab@draketo.de>
parents:
11
diff
changeset
|
41 |
15
39d078a6e4ae
Moved hg serve as suggestion to quick start.
Arne Babenhauserheide <bab@draketo.de>
parents:
14
diff
changeset
|
42 (just works instead of webserver: webserver can far more easily be delivered by other projects, too. Just works better fits the "hg is powerful yet easy" theme -> Integrated webserver into quick start?) |
39d078a6e4ae
Moved hg serve as suggestion to quick start.
Arne Babenhauserheide <bab@draketo.de>
parents:
14
diff
changeset
|
43 |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
44 |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
45 Get Mercurial |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
46 ------------- |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
47 |
7 | 48 If you're using Windows, download TortoiseHG for full Explorer integration. ![TortoiseHG Logo]() |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
49 |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
50 GNU/Linux: Just [get it from your package manager](link to a simple guide for the different distros). |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
51 |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
52 MacOSX: Download (app). |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
53 |
12
f75b80086a75
Benefit: Power, ease, serve.
Arne Babenhauserheide <bab@draketo.de>
parents:
11
diff
changeset
|
54 -> A "news" link should be alongside the version. This makes the site itneresting to returning visitors. |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
55 |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
56 |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
57 Mercurial Quick Start |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
58 --------------------- |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
59 |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
60 Clone a project and create a patch |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
61 |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
62 $ hg clone http://bitbucket.org/ArneBab/hello_world |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
63 $ cd hello_world |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
64 $ (edit files) |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
65 $ hg add (new files) |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
66 $ hg commit -m 'My changes' |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
67 $ hg export > patch.diff |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
68 |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
69 Create a project and commit |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
70 |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
71 $ hg init (project-directory) |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
72 $ (add some files) |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
73 $ hg add |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
74 $ hg commit -m 'Initial commit' |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
75 |
11
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
76 -> [Workflows]() |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
77 |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
78 (maybe instead of "Take a look"; it would be great to be able to detect the OS of the visitor and show Windows users TortoiseHG while showing MacOSX and GNU/Linux users the Quick Start) |
66f237705694
Started with adapting the Main.txt to the design.
Arne Babenhauserheide <bab@draketo.de>
parents:
10
diff
changeset
|
79 |
15
39d078a6e4ae
Moved hg serve as suggestion to quick start.
Arne Babenhauserheide <bab@draketo.de>
parents:
14
diff
changeset
|
80 (### Integrated webserver |
39d078a6e4ae
Moved hg serve as suggestion to quick start.
Arne Babenhauserheide <bab@draketo.de>
parents:
14
diff
changeset
|
81 With the "serve" command, Mercurial offers you an integrated webserver as the fastest way to show and share your work.) |
9 | 82 |
5
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
83 Footer |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
84 ------ |
63915af14173
Main page: Added draft for Get Mercurial and Quick Start. Also did some reworking of Mercurial is...
Arne Babenhauserheide <bab@draketo.de>
parents:
4
diff
changeset
|
85 |