Skip to content

Lay Java docs out the way their Javadoc's HTML has them - #39

Merged
bbatsov merged 1 commit into
mainfrom
javadoc-text
Oct 27, 2026
Merged

bbatsov merged 1 commit into
mainfrom
javadoc-text

Conversation

@bbatsov

@bbatsov bbatsov commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

The spaces orchard puts around entities only get taken out for cider-nrepl before 0.64.0, its prereleases included, since a fixed orchard sends a < b with spaces that belong there. That makes 0.64.0 the release that has to carry clojure-emacs/orchard#438.

cider-nrepl's doc fragments for a Java class or member mix text with
HTML, which neorepl stripped of its tags. Tables came out as runs of
blank lines, lists without their items, entities like \ as they
were, generics like Map<K, V> without <K, V>, a space before the
punctuation after each code span, and the lines after the first
without a docstring's indent.

The fragments now go through one walk that lays the HTML out about as a
browser would: paragraphs, list items and table rows on lines of their
own, cells between bars, code blocks indented, entities spelled out,
and the HTML's whitespace ignored next to the text, as orchard says it
should be.

orchard also puts a space between everything it joins in that HTML,
which splits words at entities, Fahrvergn&uuml;gen into
"Fahrvergn &uuml; gen" (orchard#438). neorepl takes those out for
cider-nrepl before 0.64.0, going by the version describe reports, which
the client now keeps.
@bbatsov
bbatsov merged commit cc3d48b into main Oct 27, 2026
18 checks passed
@bbatsov
bbatsov deleted the javadoc-text branch October 27, 2026 06:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant