Revert back to using RST

[etc/vim.git] / README.rst

diff --git a/README.rst b/README.rst
index d962240bf7719c52be4864cf4a4fcafa8f1acc47..917b40a255d0b9e5bc7968f1d98d107ad61abf17 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -2,20 +2,20 @@ vim-python-pep8-indent
 ======================
 
 .. image:: https://travis-ci.org/hynek/vim-python-pep8-indent.png?branch=travis
 ======================
 
 .. image:: https://travis-ci.org/hynek/vim-python-pep8-indent.png?branch=travis

-   :target: https://travis-ci.org/hynek/vim-python-pep8-indent
+:target: https://travis-ci.org/hynek/vim-python-pep8-indent

 
 This small script modifies vim_’s indentation behavior to comply with PEP8_ and
 
 This small script modifies vim_’s indentation behavior to comply with PEP8_ and

-my aesthetic preferences: ::
+my aesthetic preferences: :: python

 
 

-   foobar(foo,
-          bar)
+foobar(foo,
+       bar)

 
 

-and ::
+and :: python

 
 

-   foobar(
-      foo,
-      bar
-   )
+foobar(
+    foo,
+    bar
+)

 
 It was *not* originally written by me. I have found the script in vim’s `script
 repo`_, however the indentation was off by one character in the first case.
 
 It was *not* originally written by me. I have found the script in vim’s `script
 repo`_, however the indentation was off by one character in the first case.


@@ -24,33 +24,55 @@ I fixed it with the help of `Steve Losh`_ and am putting it out here so you
 don’t have to patch the original. The original patch is still available here_.
 
 While my Vimscript_ skills are still feeble, I intend to maintain it for now.
 don’t have to patch the original. The original patch is still available here_.
 
 While my Vimscript_ skills are still feeble, I intend to maintain it for now.

-So feel free to report bugs, I’ll try to address them as good as possible if
-they fit into the scope of this project.
+So feel free to report bugs, I’ll try to address them as well as I can,
+provided they fit into the scope of this project.

 
 Unfortunately, I wasn’t able to reach any of the original authors/maintainers:
 **David Bustos** and **Eric Mc Sween**. I’d like to thank them here for their
 
 Unfortunately, I wasn’t able to reach any of the original authors/maintainers:
 **David Bustos** and **Eric Mc Sween**. I’d like to thank them here for their

-work and release it hereby to the *Public Domain*. If anyone – who has a say in
-this – objects, please let me know.
+work and release it hereby to the *Public Domain*. If anyone with a say in this
+objects, please let me know.

 
 Installation
 ------------
 
 
 Installation
 ------------
 

-The easiest way is to use pathogen_ and do a ::
+Pathogen
+########
+Follow the instructions on installing Pathogen_ and then :: 

 
 

-   git clone https://github.com/hynek/vim-python-pep8-indent.git
+cd ~/.vim/bundle
+git clone https://github.com/hynek/vim-python-pep8-indent.git

 
 

-in your `~/.vim/bundle`. And you *should* use pathogen. Really.
+Vundle
+######

 
 

-Please note that Kirill Klenov’s python-mode_ ships an own version of this bundle.
-Therefore, if you want to use this version specifically, you’ll have to disable python-mode’s using: ::
+Follow the instructions on installing Vundle_ and add the appropriate
+plugin line: ::

 
 

-   let g:pymode_indent = 0
+Plugin 'hynek/vim-python-pep8-indent`
+
+NeoBundle
+#########
+
+Follow the instructions on installing NeoBundle_ and add the appropriate
+NeoBundle line: ::
+
+NeoBundle 'hynek/vim-python-pep8-indent`
+
+### Notes
+
+Please note that Kirill Klenov’s [python-mode][python_mode]ships its own version
+of this bundle.  Therefore, if you want to use this version specifically, 
+you’ll have to disable python-mode’s using ::
+
+let g:pymode_indent = 0

 
 .. _vim: http://www.vim.org/
 .. _PEP8: http://www.python.org/dev/peps/pep-0008/
 .. _`script repo`: http://www.vim.org/scripts/script.php?script_id=974
 .. _`Steve Losh`: http://stevelosh.com/
 .. _here: https://gist.github.com/2965846
 
 .. _vim: http://www.vim.org/
 .. _PEP8: http://www.python.org/dev/peps/pep-0008/
 .. _`script repo`: http://www.vim.org/scripts/script.php?script_id=974
 .. _`Steve Losh`: http://stevelosh.com/
 .. _here: https://gist.github.com/2965846

-.. _`Vimscript`: http://learnvimscriptthehardway.stevelosh.com/
-.. _pathogen: https://github.com/tpope/vim-pathogen
+.. _Neobundle: https://github.com/Shougo/neobundle.vim
+.. _Pathogen: https://github.com/tpope/vim-pathogen

 .. _python-mode: https://github.com/klen/python-mode
 .. _python-mode: https://github.com/klen/python-mode

+.. _`Vimscript`: http://learnvimscriptthehardway.stevelosh.com/
+.. _vundle: https://github.com/gmarik/Vundle.vim