On 6/10/26 12:20 PM, Stuart Henderson wrote:
On 2026/06/09 23:13, Volker Schlecht wrote:
We may be able to reduce the risk of that happening by disabling the
hash. It's intended as a cache busting feature which doesn't make sense
for docs bundled with a package.
That doesn't even make sense for web-published files, because there's no
such hash in the filenames for .html.
Would it make sense to change the default for mdbook in ports to disable
the hash instead?
Personally I'm not a fan of changing defaults from those documented by the
developers of the application.
[...]
usual issue with sphinx, doxygen, etc too, especially when generating
html docs. FWIW I often disable these unless the generated docs really
add something useful to the port. (manpages: usually want them. html
library docs: often more trouble than they're worth).
The generated markdown looks pretty readable to me ...
Index: Makefile
===================================================================
RCS file: /cvs/ports/devel/rust-analyzer/Makefile,v
retrieving revision 1.8
diff -u -p -r1.8 Makefile
--- Makefile 9 Jun 2026 21:39:21 -0000 1.8
+++ Makefile 10 Jun 2026 17:19:58 -0000
@@ -4,7 +4,7 @@ CATEGORIES = devel
GH_ACCOUNT = rust-lang
GH_PROJECT = rust-analyzer
GH_TAGNAME = 2026-01-12
-REVISION = 1
+REVISION = 2
DISTNAME = ${GH_PROJECT}-${GH_TAGNAME:S/-//g}
@@ -36,7 +36,7 @@ MAKE_ENV += CFG_RELEASE=${GH_TAGNAME}
post-build:
${MODCARGO_CARGO_RUN} xtask codegen
-# generate HTML docs
+# generate docs
pre-install:
cd ${WRKSRC}/docs/book && ${SETENV} ${MAKE_ENV} \
${LOCALBASE}/bin/mdbook build
@@ -44,7 +44,7 @@ pre-install:
DOCDIR = ${PREFIX}/share/doc/rust-analyzer
post-install:
${INSTALL_DATA_DIR} ${DOCDIR}
- cd ${WRKSRC}/docs/book/book && pax -rw . ${DOCDIR}
+ cd ${WRKSRC}/docs/book/book/markdown && pax -rw . ${DOCDIR}
.include "crates.inc"
Index: patches/patch-docs_book_book_toml
===================================================================
RCS file: /cvs/ports/devel/rust-analyzer/patches/patch-docs_book_book_toml,v
retrieving revision 1.1
diff -u -p -r1.1 patch-docs_book_book_toml
--- patches/patch-docs_book_book_toml 9 Jun 2026 21:39:24 -0000 1.1
+++ patches/patch-docs_book_book_toml 10 Jun 2026 17:19:58 -0000
@@ -12,3 +12,9 @@ Index: docs/book/book.toml
[output.html.playground]
editable = true
+@@ -33,3 +34,5 @@ use-boolean-and = true
+ [output.html.fold]
+ enable = true
+ level = 3
++
++[output.markdown]
Index: pkg/PLIST
===================================================================
RCS file: /cvs/ports/devel/rust-analyzer/pkg/PLIST,v
retrieving revision 1.5
diff -u -p -r1.5 PLIST
--- pkg/PLIST 9 Jun 2026 21:39:27 -0000 1.5
+++ pkg/PLIST 10 Jun 2026 17:19:58 -0000
@@ -1,70 +1,28 @@
@bin bin/rust-analyzer
share/doc/rust-analyzer/
@comment share/doc/rust-analyzer/.nojekyll
-share/doc/rust-analyzer/404.html
-share/doc/rust-analyzer/ace.js
-share/doc/rust-analyzer/assists.html
-share/doc/rust-analyzer/ayu-highlight.css
-share/doc/rust-analyzer/book.js
-share/doc/rust-analyzer/clipboard.min.js
-share/doc/rust-analyzer/configuration.html
+share/doc/rust-analyzer/assists.md
+share/doc/rust-analyzer/configuration.md
share/doc/rust-analyzer/contributing/
-share/doc/rust-analyzer/contributing/architecture.html
-share/doc/rust-analyzer/contributing/debugging.html
-share/doc/rust-analyzer/contributing/guide.html
-share/doc/rust-analyzer/contributing/index.html
-share/doc/rust-analyzer/contributing/lsp-extensions.html
-share/doc/rust-analyzer/contributing/setup.html
-share/doc/rust-analyzer/contributing/style.html
-share/doc/rust-analyzer/contributing/syntax.html
-share/doc/rust-analyzer/contributing/testing.html
-share/doc/rust-analyzer/css/
-share/doc/rust-analyzer/css/chrome.css
-share/doc/rust-analyzer/css/general.css
-share/doc/rust-analyzer/css/print.css
-share/doc/rust-analyzer/css/variables.css
-share/doc/rust-analyzer/diagnostics.html
-share/doc/rust-analyzer/editor.js
-share/doc/rust-analyzer/editor_features.html
-share/doc/rust-analyzer/elasticlunr.min.js
-share/doc/rust-analyzer/faq.html
-share/doc/rust-analyzer/favicon.png
-share/doc/rust-analyzer/favicon.svg
-share/doc/rust-analyzer/features.html
-share/doc/rust-analyzer/fonts/
-share/doc/rust-analyzer/fonts/OPEN-SANS-LICENSE.txt
-share/doc/rust-analyzer/fonts/SOURCE-CODE-PRO-LICENSE.txt
-share/doc/rust-analyzer/fonts/fonts.css
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-300.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-300italic.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-600.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-600italic.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-700.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-700italic.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-800.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-800italic.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-italic.woff2
-share/doc/rust-analyzer/fonts/open-sans-v17-all-charsets-regular.woff2
-share/doc/rust-analyzer/fonts/source-code-pro-v11-all-charsets-500.woff2
-share/doc/rust-analyzer/highlight.css
-share/doc/rust-analyzer/highlight.js
-share/doc/rust-analyzer/index.html
-share/doc/rust-analyzer/installation.html
-share/doc/rust-analyzer/manual.html
-share/doc/rust-analyzer/mark.min.js
-share/doc/rust-analyzer/mode-rust.js
-share/doc/rust-analyzer/non_cargo_based_projects.html
-share/doc/rust-analyzer/other_editors.html
-share/doc/rust-analyzer/print.html
-share/doc/rust-analyzer/privacy.html
-share/doc/rust-analyzer/rust_analyzer_binary.html
-share/doc/rust-analyzer/searcher.js
-share/doc/rust-analyzer/searchindex.js
-share/doc/rust-analyzer/security.html
-share/doc/rust-analyzer/theme-dawn.js
-share/doc/rust-analyzer/theme-tomorrow_night.js
-share/doc/rust-analyzer/toc.html
-share/doc/rust-analyzer/toc.js
-share/doc/rust-analyzer/tomorrow-night.css
-share/doc/rust-analyzer/troubleshooting.html
-share/doc/rust-analyzer/vs_code.html
+share/doc/rust-analyzer/contributing/architecture.md
+share/doc/rust-analyzer/contributing/debugging.md
+share/doc/rust-analyzer/contributing/guide.md
+share/doc/rust-analyzer/contributing/index.md
+share/doc/rust-analyzer/contributing/lsp-extensions.md
+share/doc/rust-analyzer/contributing/setup.md
+share/doc/rust-analyzer/contributing/style.md
+share/doc/rust-analyzer/contributing/syntax.md
+share/doc/rust-analyzer/contributing/testing.md
+share/doc/rust-analyzer/diagnostics.md
+share/doc/rust-analyzer/editor_features.md
+share/doc/rust-analyzer/faq.md
+share/doc/rust-analyzer/features.md
+share/doc/rust-analyzer/index.md
+share/doc/rust-analyzer/installation.md
+share/doc/rust-analyzer/non_cargo_based_projects.md
+share/doc/rust-analyzer/other_editors.md
+share/doc/rust-analyzer/privacy.md
+share/doc/rust-analyzer/rust_analyzer_binary.md
+share/doc/rust-analyzer/security.md
+share/doc/rust-analyzer/troubleshooting.md
+share/doc/rust-analyzer/vs_code.md
