aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md55
1 files changed, 31 insertions, 24 deletions
diff --git a/README.md b/README.md
index e3ca041283..23bc7af842 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,28 @@
# neovim ([bountysource fundraiser](https://www.bountysource.com/fundraisers/539-neovim-first-iteration))
[![Build Status](https://travis-ci.org/neovim/neovim.png?branch=master)](https://travis-ci.org/neovim/neovim)
+[![Stories in Ready](https://badge.waffle.io/neovim/neovim.png?label=ready)](https://waffle.io/neovim/neovim)
+
+* [Introduction](#introduction)
+* [Problem](#problem)
+* [Solution](#solution)
+ * [Migrate to a cmake-based build](#migrate-to-a-cmake-based-build)
+ * [Legacy support and compile-time features](#legacy-support-and-compile-time-features)
+ * [Platform-specific code](#platform-specific-code)
+ * [New plugin architecture](#new-plugin-architecture)
+ * [New GUI architecture](#new-gui-architecture)
+ * [Development on github](#development-on-github)
+* [Status](#status)
+* [Dependencies](#dependencies)
+ * [For Debian/Ubuntu](#for-debianubuntu)
+ * [For FreeBSD 10](#for-freebsd-10)
+ * [For OS X](#for-os-x)
+ * [For Arch Linux](#for-arch-linux)
+* [Building](#building)
+* [Community](#community)
+* [Contributing](#contributing)
+* [License](#license)
+
### Introduction
@@ -27,42 +49,31 @@ By achieving those goals new developers will soon join the community, consequent
It is important to emphasize that this is not a project to rewrite vim from scratch or transform it into an IDE (though the new features provided will enable IDE-like distributions of the editor). The changes implemented here should have little impact on vim's editing model or vimscript in general. Most vimscript plugins should continue to work normally.
-The following topics contain brief explanations of the major changes (and motivations) that will be performed in the first iteration:
-
-* <a href="#build"><b>Migrate to a cmake-based build</b></a>
-* <a href="#legacy"><b>Legacy support and compile-time features</b></a>
-* <a href="#platform"><b>Platform-specific code</b></a>
-* <a href="#plugins"><b>New plugin architecture</b></a>
-* <a href="#gui"><b>New GUI architecture</b></a>
-* <a href="#development"><b>Development on github</b></a>
+The following topics contain brief explanations of the major changes (and motivations) that will be performed in the first iteration.
-<a name="build"></a>
##### Migrate to a cmake-based build
The source tree has dozens (if not hundreds) of files dedicated to building vim with on various platforms with different configurations, and many of these files look abandoned or outdated. Most users don't care about selecting individual features and just compile using '--with-features=huge', which still generates an executable that is small enough even for lightweight systems by today's standards.
All those files will be removed and vim will be built using [cmake](http://www.cmake.org), a modern build system that generates build scripts for the most relevant platforms.
-<a name="legacy"></a>
##### Legacy support and compile-time features
Vim has a significant amount of code dedicated to supporting legacy systems and compilers. All that code increases the maintenance burden and will be removed.
-Most optional features will no longer be optional (see above), with the exception of some broken and useless features (eg: netbeans integration, sun workshop) which will be removed permanently. Vi emulation will also be removed (setting 'nocompatible' will be a no-op).
+Most optional features will no longer be optional (see above), with the exception of some broken and useless features (e.g., netbeans integration, sun workshop) which will be removed permanently. Vi emulation will also be removed (setting 'nocompatible' will be a no-op).
-These changes wont affect most users. Those that only have a C89 compiler installed or use vim on legacy systems such as Amiga, BeOS or MSDOS will have two options:
+These changes won't affect most users. Those that only have a C89 compiler installed or use vim on legacy systems such as Amiga, BeOS or MS-DOS will have two options:
- Upgrade their software
- Continue using vim
-<a name="platform"></a>
##### Platform-specific code
Most of the platform-specific code will be removed and [libuv](https://github.com/joyent/libuv) will be used to handle system differences.
libuv is a modern multi-platform library with functions to perform common system tasks, and supports most unixes and windows, so the vast majority of vim's community will be covered.
-<a name="plugins"></a>
##### New plugin architecture
All code supporting embedded scripting language interpreters will be replaced by a new plugin system that will support extensions written in any programming language.
@@ -184,17 +195,9 @@ and what is currently being worked on:
#### For OS X:
-* Install [Xcode](https://developer.apple.com/)
+* Install [Xcode](https://developer.apple.com/) and [Homebrew][http://brew.sh]
* Install sha1sum
- Via MacPorts:
-
- sudo port install md5sha1sum cmake libtool automake
-
- Via Homebrew:
-
- brew install md5sha1sum cmake libtool automake
-
If you run into wget certificate errors, you may be missing the root SSL
certificates or have not set them up correctly:
@@ -222,9 +225,13 @@ To build and run the tests:
make test
+Using Homebrew on Mac:
+
+ brew install neovim/neovim/neovim
+
### Community
-Join the community on IRC in #neovim on Freenode.
+Join the community on IRC in #neovim on Freenode or the [mailing list](https://groups.google.com/forum/#!forum/neovim)
### Contributing