[
https://issues.apache.org/jira/browse/SPARK-17095?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15423602#comment-15423602
]
Jakob Odersky commented on SPARK-17095:
---------------------------------------
Since this bug also occurs when there are no opening braces (}}} anywhere in
the doc is sufficient), I think this is an issue with scaladoc itself. I would
recommend creating a bug report on the scala tracker
https://issues.scala-lang.org/secure/Dashboard.jspa.
Ideally, code blocks could be delimited with an arbitrary number of opening
symbols followed by an arbitrary number of closing symbols (e.g. you could use
{{{{ (4 braces) }}}} to delimit code that itself contains }}} 3 braces.
> Latex and Scala doc do not play nicely
> --------------------------------------
>
> Key: SPARK-17095
> URL: https://issues.apache.org/jira/browse/SPARK-17095
> Project: Spark
> Issue Type: Improvement
> Components: Documentation
> Reporter: Seth Hendrickson
> Priority: Minor
> Labels: starter
>
> In Latex, it is common to find "}}}" when closing several expressions at
> once. [SPARK-16822|https://issues.apache.org/jira/browse/SPARK-16822] added
> Mathjax to render Latex equations in scaladoc. However, when scala doc sees
> "}}}" or "{{{" it treats it as a special character for code block. This
> results in some very strange output.
> A poor workaround is to use "}}\,}" in latex which inserts a small
> whitespace. This is not ideal, and we can hopefully find a better solution.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org
For additional commands, e-mail: issues-h...@spark.apache.org
