Noissue - Update R documentation

README.rst

Index: README.rst
===================================================================
--- a/README.rst
+++ b/README.rst
@@ -212,23 +212,33 @@
 ------------------------
 
 ``python-abp`` can be installed directly onto your system, or in a virtual
-environment. To install it directly onto your system::
+environment. To install it directly onto your system with pip::
 
     $ pip install --upgrade python-abp
 
-To install it in a virtual environment::
+Or install onto your system from source::

[Vasily Kuznetsov, 2019/03/06 17:18:19]

Perhaps we could make this a bit more comprehensive and also remove repetition
if we use the following structure:

- How to install from PyPI
- How to install from local source
- How to use a virtualenv:
  - Show both py2 and py3 way of creating a virtualenv, link to
https://virtualenv.pypa.io/en/latest/userguide/#usage and
https://docs.python.org/3/library/venv.html
  - Explain that we can use /path/to/venv/bin/pip to install packages into the
virtualenv.
- Show how to import stuff in R with and without a virtualenv, link to
https://rstudio.github.io/reticulate/articles/versions.html

[rhowell, 2019/03/07 03:59:07]

Seems like it's starting to get complicated trying to cover every installation
use case, but hopefully this is an improvement. Oh, and is this what you meant
by 'both py2 and py3 ways of creating a virtualenv'?

+
+    $ cd python-abp
+    $ pip install --upgrade .

[Vasily Kuznetsov, 2019/03/06 17:18:19]

A simpler version would be:

    $ pip install -U /path/to/python-abp

Changing into the directory is not really necessary.

[rhowell, 2019/03/07 03:59:07]

Done.

+
+To install ``python-abp`` in a virtual environment with pip::
 
     $ virtualenv venv
     $ venv/bin/pip install --upgrade python-abp
 
+Or install from source in a virtualenv::
+
+    $ cd python-abp
+    $ virtualenv venv
+    $ venv/bin/pip install --upgrade .
 
 Then import it with ``reticulate`` in R:
 
 .. code-block:: R
 
     > library(reticulate)
-    > use_virtualenv("~/python-abp/env", required=TRUE)  # If using virtualenv
+    > use_virtualenv("~/path/to/python-abp/venv", required=TRUE)  # If using virtualenv
     > abp <- import("abp.filters.rpy")
 
 Now you can use the functions with ``abp$functionname``, e.g.
-``abp.line2dict("@@||g.doubleclick.net/pagead/$subdocument,domain=hon30.org")``.
+``abp$line2dict("@@||g.doubleclick.net/pagead/$subdocument,domain=hon30.org")``.