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
No comments:
Post a Comment