Repository navigation
docs: say which richdoc-to-PDF paths already existed - #8
Merged
Merged
Conversation
The doc comment claimed to be "the direction that did not exist". It was not: go-richdoc/rst/pdf and go-richdoc/latex/pdf were already there, both taking a richdoc to a typeset PDF through a real TeX compile. The claim was wrong because the SEARCH was. I looked for functions named ToPDF; these are named Write. A capability is not found by guessing what its function is called -- the fifth time in one day that this inventory was wrong for consulting the wrong thing. What the comment says now is when to reach for which: this one for a pure-Go, CGO-free page that also builds for GOOS=js and keeps emphasis, links and tables; rst/pdf or latex/pdf when TeX typesetting is the point and six megabytes of engine and the loss of emphasis to go-tex/engine#590 are acceptable. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The doc comment claimed to be "the direction that did not exist". It was not.
⛔ The claim was wrong because the search was. I looked for functions named
ToPDF; these are namedWrite. A capability is not found by guessing what its function is called — the fifth time in one day this inventory was wrong for consulting the wrong thing, and the first time it put a false claim in shipped documentation.This one is still worth having, and the comment now says when to reach for which: this for a pure-Go, CGO-free page that also builds for
GOOS=jsand keeps emphasis, links and tables; rst/pdf or latex/pdf when TeX's typesetting is the point and a six-megabyte engine — and today's loss of emphasis to go-tex/engine#590 — are acceptable.🤖 Generated with Claude Code