From bea2ed6ab64ec8c5972b82636b955ac204e5ff8f Mon Sep 17 00:00:00 2001
From: Jason Tibbitts <tibbs@math.uh.edu>
Date: Nov 02 2018 00:41:32 +0000
Subject: Add description of R macros.


---

diff --git a/README.rst b/README.rst
index b6a252e..691dd82 100644
--- a/README.rst
+++ b/README.rst
@@ -39,6 +39,56 @@ Note that RPM will in some cases re-parse macro output.  You must be careful
 when using percent signs in strings passed to macros which output text into the
 parse stream, because you may end up with recursive expansions.
 
+macros.R-extra
+``````````````
+
+Some additional macros for R.
+
+``%cran_source``
+   Simplifies specifying the source URL for a package on CRAN.
+
+``%cran_url``
+   Simple way to get the URL for a package's page on CRAN.
+
+The above two will also cause %packname to be defined automatically from Name:
+if it isn't already defined.
+
+``%r_prep``
+   The standard %prep boilerplate for an R package.
+   Use at the beginning of the %prep section.
+
+``%r_install``
+   The standard %install boilerplate for an R package.
+   Use at the beginning of the %install section.
+   Also includes code to generate a file list
+   in %packname.files which can if desired
+   be included in the %files directive.
+
+``%r_check``
+   The standard %check boilerplate for an R package.
+
+``%r_noarch_package``
+   Adds the basic dependencies and build dependenciesi
+   for a noarch R package.
+   Also defines %rlibdir for convenience.
+   Use anywhere before %prep.
+
+``%r_archful_package``
+   Adds the basic build dependencies for an archful R package.
+   Also defines %rlibdir appropriately for convenience.
+   Use anywhere before %prep.
+
+``%r_simple_archful_package``
+   Expands to %r_archful_package, plus complete
+   %prep, %install and %check sections
+   using %r_prep, %r_install and %r_check.
+   If a package uses only the boilerplate for those sections then this macro
+   can replace most of the package.
+
+These macros are under development and will change.
+
+The ``%r_simple_noarch_package`` macro is not yet written.
+
 macros.omit-patch
 `````````````````