{"push_id":1467157494,"size":1,"distinct_size":1,"ref":"refs/heads/master","head":"ba4468bb24f2e13b98e7b66b44203c20393b8ab8","before":"24c0c94128770be9034fb69518713d7f6aa1e041","commits":[{"sha":"ba4468bb24f2e13b98e7b66b44203c20393b8ab8","author":{"name":"Dongjoon Hyun","email":"1bf3a3c57610939bd1558dffb564906c959abecb@apache.org"},"message":"[SPARK-18923][DOC][BUILD] Support skipping R/Python API docs\n\n## What changes were proposed in this pull request?\n\nWe can build Python API docs by `cd ./python/docs && make html for Python` and R API docs by `cd ./R && sh create-docs.sh for R` separately. However, `jekyll` fails in some environments.\n\nThis PR aims to support `SKIP_PYTHONDOC` and `SKIP_RDOC` for documentation build in `docs` folder. Currently, we can use `SKIP_SCALADOC` or `SKIP_API`. The reason providing additional options is that the Spark documentation build uses a number of tools to build HTML docs and API docs in Scala, Python and R. Specifically, for Python and R,\n\n- Python API docs requires `sphinx`.\n- R API docs requires `R` installation and `knitr` (and more others libraries).\n\nIn other words, we cannot generate Python API docs without R installation. Also, we cannot generate R API docs without Python `sphinx` installation. If Spark provides `SKIP_PYTHONDOC` and `SKIP_RDOC` like `SKIP_SCALADOC`, it would be more convenient.\n\n## How was this patch tested?\n\nManual.\n\n**Skipping Scala/Java/Python API Doc Build**\n```bash\n$ cd docs\n$ SKIP_SCALADOC=1 SKIP_PYTHONDOC=1 jekyll build\n$ ls api\nDESCRIPTION R\n```\n\n**Skipping Scala/Java/R API Doc Build**\n```bash\n$ cd docs\n$ SKIP_SCALADOC=1 SKIP_RDOC=1 jekyll build\n$ ls api\npython\n```\n\nAuthor: Dongjoon Hyun <dongjoon@apache.org>\n\nCloses #16336 from dongjoon-hyun/SPARK-18923.","distinct":true,"url":"https://api.github.com/repos/dbtsai/spark/commits/ba4468bb24f2e13b98e7b66b44203c20393b8ab8"}]}
{"actor":{"display_login":"dbtsai-bot"}}