From 0c7355b3dc9d5c01aa3ed528bcaa19c01eedcf11 Mon Sep 17 00:00:00 2001
From: Mick Jordan <mick.jordan@oracle.com>
Date: Thu, 3 Nov 2016 16:35:10 -0700
Subject: [PATCH] mx_fastr_dists: add doc comment

---
 mx.fastr/mx_fastr_dists.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/mx.fastr/mx_fastr_dists.py b/mx.fastr/mx_fastr_dists.py
index 3540c599f7..43f7e81636 100644
--- a/mx.fastr/mx_fastr_dists.py
+++ b/mx.fastr/mx_fastr_dists.py
@@ -264,6 +264,13 @@ class ReleaseBuildTask(mx.NativeBuildTask):
         self._template(rscript_launcher, join(bin_dir, 'Rscript'), template_dict)
 
 class FastRNativeRecommendedProject(mx.NativeProject):
+    '''
+    This finesses an ordering problem on installing the recommended R packages.
+    These must be installed by FastR using bin/R CMD INSTALL. That will invoke a
+    nested 'mx R' invocation which requires the FASTR distribution to be available.
+    However, this dependency cannt be specified in the suite.py file so we achieve
+    it here by ensuring that it is built prior to the native.recommended project.
+    '''
     def __init__(self, suite, name, deps, workingSets, theLicense, **args):
         mx.NativeProject.__init__(self, suite, name, None, [], deps, workingSets, None, None, join(suite.dir, name), theLicense)
 
-- 
GitLab