From bf2dfaf60eb4d6efabd1a22f8318ffb0c783129d Mon Sep 17 00:00:00 2001 From: Simon Sapin Date: Mon, 20 Jul 2015 09:24:29 +0200 Subject: [PATCH] Make doc comments not truncated again. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `rustdoc --passes "collapse-docs unindent-comments"` doesn’t work is intended. It still generate HTML files that look alright at a glance, but all doc-comments are truncated to their first line for some reason I don’t understand. See http://doc.servo.org/script/dom/index.html for example. The module documentation there is currently just “The implementation of the DOM.”, but clicking the [src] link shows a much larger doc-comment. https://github.com/rust-lang/rust/issues/15347#issuecomment-122785714 The correct invokation is to use `--passes` multiple times. --- etc/rustdoc-with-private | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/etc/rustdoc-with-private b/etc/rustdoc-with-private index 770469ac064..e038696375a 100755 --- a/etc/rustdoc-with-private +++ b/etc/rustdoc-with-private @@ -1,4 +1,4 @@ #!/bin/sh # Skip the strip-private and strip-hidden rustdoc passes # https://github.com/rust-lang/rust/issues/15347 -rustdoc --no-defaults --passes "collapse-docs unindent-comments" "$@" +rustdoc --no-defaults --passes collapse-docs --passes unindent-comments "$@"