gwh/slackbuilds
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Make magit's README file better

Browse source 
* Rewrite the intro, the old one wasn't really applicable anymore.

  * Use Markdown to its fullest, the old links were really confusing.

  * More links, link prominently to the manual, screencast and
    cheatsheet.
This commit is contained in:
Ævar Arnfjörð Bjarmason 2010-05-17 06:42:21 +08:00 committed by Phil Jakckson
parent 35dfceb3b5
commit ed6d791c61
1 changed files with 25 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

49
README.md
View file

@ -1,21 +1,19 @@
It's Magit! A Emacs mode for Git. It's Magit! A Emacs mode for Git.
================================== ==================================
[github pages](http://philjackson.github.com/magit) Magit is an interface to Git for Emacs. Unlike Emacs's native
[version control support][vc], Magit can take advantage of Git's
native features without breaking compatibility with other systems.
I started to write Magit to learn about Git and to figure out how I To get started see the [Magit User Manual][manual] or perhaps the
would be using Git in a 'natural' way. Magit will grow and hopefully [cheatsheet][cheatsheet] if you're in a hurry. There's also an
become more coherent as I learn more about Git and good ways to use excellent [Magit screencast][screencast] by Alex Vollmer which
it. Feedback is welcome! demonstrates some of the major features.
Magit is owned by Marius Vollmer and is currently maintained by Phil
Jackson. For a full list of contributors have a look at magit.el.
Installing Installing
---------- ----------
Download the latest tarball from Download the latest tarball from [the github download page][download].
[the github download page](http://github.com/philjackson/magit/downloads).
And then Magit can be installed with the popular recipe of: And then Magit can be installed with the popular recipe of:
@ -23,34 +21,37 @@ And then Magit can be installed with the popular recipe of:
$ ./configure $ ./configure
$ make install $ make install
This will put magit.el into /usr/local/share/emacs/site-lisp, where This will put magit.el into `/usr/local/share/emacs/site-lisp`, where
Emacs should be able to find it. Then add Emacs should be able to find it. Then add
(require 'magit) (require 'magit)
to your .emacs file. to your `.emacs` file.
Getting started Getting started
--------------- ---------------
To get started with Magit, open any file in a Git repository in Emacs To get started with Magit, open any file in a Git repository in Emacs
and run 'M-x magit-status'. Read the online help of magit-mode ('C-h and run `M-x magit-status`. Read the short help for magit-mode (`C-h
m' in the Magit buffer), make some changes to your files, and try to m` in the Magit buffer), make some changes to your files, and try to
commit them. commit them.
Learning more Learning more
------------- -------------
The Magit User Manual describes things with more words than the online The [Magit User Manual][manual] describes things with more words than
help. You can read it in Emacs with 'C-u C-h i magit.info' for the online help. You can read it in Emacs with `C-u C-h i
example, or on the web at magit.info`, or [on the web][manual].
[the manual](http://philjackson.github.com/magit/magit.html) If you have any questions, please use [the mailing list][google group]
at Google Groups.
If you have questions, please use the mailing list at Magit's website is currently hosted [on GitHub][website].
[google group](http://groups.google.com/group/magit/) [vc]: http://www.gnu.org/software/emacs/manual/html_node/emacs/Version-Control.html#Version-Control
[website]: http://philjackson.github.com/magit
Magit's web home is currently at [manual]: http://philjackson.github.com/magit/magit.html
[cheatsheet]: http://daemianmack.com/magit-cheatsheet.html
[github pages](http://philjackson.github.com/magit) [screencast]: http://vimeo.com/2871241
[download]: http://github.com/philjackson/magit/downloads
[google group]: http://groups.google.com/group/magit/