diff options
author | hyukjinkwon <gurwls223@gmail.com> | 2016-11-29 13:50:24 +0000 |
---|---|---|
committer | Sean Owen <sowen@cloudera.com> | 2016-11-29 13:50:24 +0000 |
commit | 1a870090e4266df570c3f56c1e2ea12d090d03d1 (patch) | |
tree | a9fb06a37865beff9a77f805e5c3cd5ed1e40ec8 /licenses/LICENSE-py4j.txt | |
parent | f045d9dade66d44f5ca4768bfe6a484e9288ec8d (diff) | |
download | spark-1a870090e4266df570c3f56c1e2ea12d090d03d1.tar.gz spark-1a870090e4266df570c3f56c1e2ea12d090d03d1.tar.bz2 spark-1a870090e4266df570c3f56c1e2ea12d090d03d1.zip |
[SPARK-18615][DOCS] Switch to multi-line doc to avoid a genjavadoc bug for backticks
## What changes were proposed in this pull request?
Currently, single line comment does not mark down backticks to `<code>..</code>` but prints as they are (`` `..` ``). For example, the line below:
```scala
/** Return an RDD with the pairs from `this` whose keys are not in `other`. */
```
So, we could work around this as below:
```scala
/**
* Return an RDD with the pairs from `this` whose keys are not in `other`.
*/
```
- javadoc
- **Before**
![2016-11-29 10 39 14](https://cloud.githubusercontent.com/assets/6477701/20693606/e64c8f90-b622-11e6-8dfc-4a029216e23d.png)
- **After**
![2016-11-29 10 39 08](https://cloud.githubusercontent.com/assets/6477701/20693607/e7280d36-b622-11e6-8502-d2e21cd5556b.png)
- scaladoc (this one looks fine either way)
- **Before**
![2016-11-29 10 38 22](https://cloud.githubusercontent.com/assets/6477701/20693640/12c18aa8-b623-11e6-901a-693e2f6f8066.png)
- **After**
![2016-11-29 10 40 05](https://cloud.githubusercontent.com/assets/6477701/20693642/14eb043a-b623-11e6-82ac-7cd0000106d1.png)
I suspect this is related with SPARK-16153 and genjavadoc issue in ` typesafehub/genjavadoc#85`.
## How was this patch tested?
I found them via
```
grep -r "\/\*\*.*\`" . | grep .scala
````
and then checked if each is in the public API documentation with manually built docs (`jekyll build`) with Java 7.
Author: hyukjinkwon <gurwls223@gmail.com>
Closes #16050 from HyukjinKwon/javadoc-markdown.
Diffstat (limited to 'licenses/LICENSE-py4j.txt')
0 files changed, 0 insertions, 0 deletions