Skip to content

Commit

Permalink
Build a Vim package of Nvim-R
Browse files Browse the repository at this point in the history
  • Loading branch information
jalvesaq committed Aug 10, 2016
1 parent 6561feb commit c79fee2
Show file tree
Hide file tree
Showing 3 changed files with 85 additions and 36 deletions.
14 changes: 12 additions & 2 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
###########################################################

PLUGINHOME=`pwd`
PLUGINVERSION=0.9.5
PLUGINVERSION=0.9.6
PLUGINRELEASEDATE=`date +"%Y-%m-%d"`

ifeq (, $(shell which nvim))
Expand All @@ -14,13 +14,23 @@ else
VIMEXEC=nvim
endif

all: vimball zip

vimball:
# Update the version date in doc/Nvim-R.txt header and in the news
sed -i -e "s/^Version: [0-9].[0-9].[0-9] (development)/Version: $(PLUGINVERSION)/" doc/Nvim-R.txt
sed -i -e "s/^$(PLUGINVERSION) (201[0-9]-[0-9][0-9]-[0-9][0-9])$$/$(PLUGINVERSION) ($(PLUGINRELEASEDATE))/" doc/Nvim-R.txt
$(VIMEXEC) -c "%MkVimball Nvim-R ." -c "q" list_for_vimball
$(VIMEXEC) -c "packadd vimball" -c "%MkVimball Nvim-R ." -c "q" list_for_vimball
mv Nvim-R.vmb /tmp

zip:
rm -rf /tmp/NvimRvimpack
mkdir -p /tmp/NvimRvimpack/start/Nvim-R
tar -c -T list_for_vimball -f /tmp/nvimrpack.tar
tar -x -f /tmp/nvimrpack.tar -C /tmp/NvimRvimpack/start/Nvim-R
( cd /tmp/NvimRvimpack ; zip -r ../Nvim-R_$(PLUGINVERSION).zip start )
rm /tmp/nvimrpack.tar

clean:
rm -f R/nvimcom/src/nvimcom.o
rm -f R/nvimcom/src/nvimcom.so
Expand Down
28 changes: 9 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,25 +15,14 @@ packages to be loaded on R startup.
If you use a plugin manager, such as [vim-plug], [Vundle] or [Pathogen],
follow its instructions on how to install plugins from github.

To install a stable version of the plugin, download the Vimball file
`Nvim-R.vmb` from
[Nvim-R/releases](https://github.com/jalvesaq/Nvim-R/releases),
open it and do:</p>
To install a stable version of the plugin, either download the Vim package from
[Nvim-R/releases](https://github.com/jalvesaq/Nvim-R/releases)
or the Vimball from
[vim.org](http://www.vim.org/scripts/script.php?script_id=2628).

```
:so %
```

Then, press the space bar a few time to ensure the installation of all
files.

The Nvim-R source code includes the R package nvimcom, which has C code that
needs compilation. Nvim-R will build and install nvimcom automatically, and it
will also update it automatically whenever necessary. A C compiler (e.g. `gcc`
or `clang`) is necessary. On Windows, you have to install
[Rtools](https://cran.r-project.org/bin/windows/Rtools/).

Please, read the plugin's documentation for instructions on usage.
Please, read the section *Installation* from the
[plugin's documentation](https://raw.githubusercontent.com/jalvesaq/Nvim-R/master/doc/Nvim-R.txt)
for details.

Below is a sample `init.vim`:

Expand Down Expand Up @@ -72,7 +61,8 @@ vmap <Space> <Plug>RDSendSelection
nmap <Space> <Plug>RDSendLine
```

Please, read the file *doc/Nvim-R.txt* for usage details.
Please, read the plugin's documentation for instructions on usage.


## Screenshots

Expand Down
79 changes: 64 additions & 15 deletions doc/Nvim-R.txt
Original file line number Diff line number Diff line change
Expand Up @@ -87,18 +87,19 @@ Nvim-R (see |R_source|).
*Nvim-R-installation*
3. Installation~

The installation process is described in three sections:
The installation process is described in four sections:

1. Installation instructions
2. Troubleshooting
3. Optional steps
3.1. Installation of dependencies
3.2. Installation of the plugin
3.3. Troubleshooting
3.4. Optional steps

------------------------------------------------------------------------------
3.1. Installation instructions~
3.1. Installation of dependencies~

Before installing the plugin, you should install its dependencies:

Main dependencies:~
Main dependencies:~

Neovim >= 0.1.4:
https://github.com/neovim/neovim/releases
Expand Down Expand Up @@ -134,7 +135,7 @@ Before installing the plugin, you should install its dependencies:
not being well maintained.


Additional dependencies for editing Rnoweb documents:~
Additional dependencies for editing Rnoweb documents:~

latexmk: Automate the compilation of LaTeX documents.
See examples in |R_latexcmd|.
Expand All @@ -150,7 +151,7 @@ Before installing the plugin, you should install its dependencies:
(Not required on either Windows or OS X)


Additional suggestions for Unix (Linux, OS X, etc.):~
Additional suggestions for Unix (Linux, OS X, etc.):~

ncurses-term: http://invisible-island.net/ncurses
Might be necessary if you want support for 256 colors at the
Expand Down Expand Up @@ -186,13 +187,62 @@ set it):
<
Please, see |Nvim-R-vimrc-setup| for more suggestions of configuration.

Now, install Nvim-R:

------------------------------------------------------------------------------
3.2. Installation of the plugin~

Now, install Nvim-R. You have two options: Vimball and Vim Package.


Vimball~

If you want to install from the vimball, download the file Nvim-R.vmb from:

http://www.vim.org/scripts/script.php?script_id=2628

Then, open the file with either Vim or Neovim and do:
>
:packadd vimball
:so %
<
Finally, press the space bar a few time to ensure the installation of all
files.


Vim Package~

If you have a previous Vimball installation, you should uninstall it first:
>
:packadd vimball
:RmVimball Nvim-R
<
The Vim package is a zip file released at:

https://github.com/jalvesaq/Nvim-R/releases

If, for instance, it was saved in the `/tmp` directory, to install it on an
Unix system, you should do for Neovim:
>
mkdir -p ~/.local/share/nvim/site/pack/R
cd ~/.local/share/nvim/site/pack/R
unzip /tmp/Nvim-R_0.9.6.zip
<
The directory for Vim on Unix is `~/.vim/pack/R`.
For Neovim on Windows, it is `~/AppData/Local/nvim/pack/R`.
And, for Vim on Windows, it is `~/vimfiles/pack/R`.
The name of the last subdirectory does not need to be `R`; it might be
anything.

Finally, in Vim (or Neovim) run `:helptags` (adjust the path according to your
system):
>
:helptags ~/.local/share/nvim/site/pack/R/start/Nvim-R/doc
<
See |packages| for details.


------------------------------------------------------------------------------
3.2. Troubleshooting (if the plugin doesn't work)~
3.3. Troubleshooting (if the plugin doesn't work)~

Note: The <LocalLeader> is '\' by default.

Expand Down Expand Up @@ -231,16 +281,15 @@ loaded), or R was not started by Vim/Neovim.


------------------------------------------------------------------------------
3.3. Optional steps~
3.4. Optional steps~

3.3.1 Customize the plugin~
Customize the plugin~

Please, read the section |Nvim-R-options|. Emacs/ESS users should also read
|ft-r-indent|.


------------------------------------------------------------------------------
3.3.2 Install additional plugins~
Install additional plugins~

You may be interested in installing additional general plugins to get
functionality not provided by this file type plugin. Particularly interesting
Expand Down Expand Up @@ -2654,7 +2703,7 @@ step-by-step procedure to run Nvim-R remotely:
*Nvim-R-news*
10. News~

0.9.6 (2016-08-07)
0.9.6 (2016-08-10)

* New option: R_open_example.
* Change default value of R_source_args to "print.eval=TRUE".
Expand Down

0 comments on commit c79fee2

Please sign in to comment.