GitHub user cocoatomo opened a pull request:
https://github.com/apache/spark/pull/2766
[SPARK-3909][PySpark][Doc] A corrupted format in Sphinx documents and
building warnings
Sphinx documents contains a corrupted ReST format and have some warnings.
The purpose of this issue is same as
https://issues.apache.org/jira/browse/SPARK-3773.
commit: 0e8203f4fb721158fb27897680da476174d24c4b
output
```
$ cd ./python/docs
$ make clean html
rm -rf _build/*
sphinx-build -b html -d _build/doctrees . _build/html
Making output directory...
Running Sphinx v1.2.3
loading pickled environment... not yet created
building [html]: targets for 4 source files that are out of date
updating environment: 4 added, 0 changed, 0 removed
reading sources... [100%] pyspark.sql
/Users/<user>/MyRepos/Scala/spark/python/pyspark/mllib/feature.py:docstring
of pyspark.mllib.feature.Word2VecModel.findSynonyms:4: WARNING: Field list ends
without a blank line; unexpected unindent.
/Users/<user>/MyRepos/Scala/spark/python/pyspark/mllib/feature.py:docstring
of pyspark.mllib.feature.Word2VecModel.transform:3: WARNING: Field list ends
without a blank line; unexpected unindent.
/Users/<user>/MyRepos/Scala/spark/python/pyspark/sql.py:docstring of
pyspark.sql:4: WARNING: Bullet list ends without a blank line; unexpected
unindent.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] pyspark.sql
writing additional files... (12 module code pages) _modules/index search
copying static files... WARNING: html_static_path entry
u'/Users/<user>/MyRepos/Scala/spark/python/docs/_static' does not exist
done
copying extra files... done
dumping search index... done
dumping object inventory... done
build succeeded, 4 warnings.
Build finished. The HTML pages are in _build/html.
```
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/cocoatomo/spark
issues/3909-sphinx-build-warnings
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/spark/pull/2766.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #2766
----
commit 2c7faa8ca05820edd9936fdacc69e551059fc532
Author: cocoatomo <[email protected]>
Date: 2014-10-11T10:20:24Z
[SPARK-3909][PySpark][Doc] A corrupted format in Sphinx documents and
building warnings
----
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
