[jira] [Commented] (SPARK-23065) R API doc empty in Spark 2.3.0 RC1

["Sameer Agarwal (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/SPARK-23065?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16325068#comment-16325068 ] 

Sameer Agarwal commented on SPARK-23065:
----------------------------------------

Thanks for verifying this [~felixcheung]! While the build didn't fail in an obvious way, it seems like it only uploaded partially generated R docs. I tried running it manually and it turned out to be a roxygen version issue:

{code}
~/dev/spark/spark/docs SKIP_SCALADOC=1 SKIP_PYTHONDOC=1 SKIP_SQLDOC=1 jekyll build
Configuration file: /Users/sameer/dev/spark/spark/docs/_config.yml
       Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly.
Moving to R directory and building roxygen docs.
Using Scala 2.11
Using R_SCRIPT_PATH = /usr/local/bin
++++ dirname /Users/sameer/dev/spark/spark/R/install-dev.sh
+++ cd /Users/sameer/dev/spark/spark/R
+++ pwd
++ FWDIR=/Users/sameer/dev/spark/spark/R
++ LIB_DIR=/Users/sameer/dev/spark/spark/R/lib
++ mkdir -p /Users/sameer/dev/spark/spark/R/lib
++ pushd /Users/sameer/dev/spark/spark/R
++ . /Users/sameer/dev/spark/spark/R/find-r.sh
+++ '[' -z /usr/local/bin ']'
++ . /Users/sameer/dev/spark/spark/R/create-rd.sh
+++ set -o pipefail
+++ set -e
+++++ dirname /Users/sameer/dev/spark/spark/R/create-rd.sh
++++ cd /Users/sameer/dev/spark/spark/R
++++ pwd
+++ FWDIR=/Users/sameer/dev/spark/spark/R
+++ pushd /Users/sameer/dev/spark/spark/R
+++ . /Users/sameer/dev/spark/spark/R/find-r.sh
++++ '[' -z /usr/local/bin ']'
+++ /usr/local/bin/Rscript -e ' if("devtools" %in% rownames(installed.packages())) { library(devtools); devtools::document(pkg="./pkg", roclets=c("rd")) }'
Error: ‘roxygen2’ >= 5.0.0 must be installed for this functionality.
Execution halted
jekyll 3.7.0 | Error:  R doc generation failed
{code}

I've fixed this issue and updated the docs at https://dist.apache.org/repos/dist/dev/spark/v2.3.0-rc1-docs/_site/index.html. Can you please verify if everything looks okay now?

> R API doc empty in Spark 2.3.0 RC1
> ----------------------------------
>
>                 Key: SPARK-23065
>                 URL: https://issues.apache.org/jira/browse/SPARK-23065
>             Project: Spark
>          Issue Type: Bug
>          Components: SparkR
>    Affects Versions: 2.3.0
>            Reporter: Felix Cheung
>            Assignee: Sameer Agarwal
>            Priority: Blocker
>
> [~sameerag]
> https://dist.apache.org/repos/dist/dev/spark/v2.3.0-rc1-docs/_site/api/R/index.html
> Did it fail to build?



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@spark.apache.org
For additional commands, e-mail: issues-help@spark.apache.org