]> git.lizzy.rs Git - rust.git/commitdiff
Add test for docs without examples
authorGuillaume Gomez <guillaume1.gomez@gmail.com>
Tue, 9 Oct 2018 14:46:29 +0000 (16:46 +0200)
committerGuillaume Gomez <guillaume1.gomez@gmail.com>
Tue, 9 Oct 2018 15:55:12 +0000 (17:55 +0200)
src/test/rustdoc-ui/doc-without-codeblock.rs [new file with mode: 0644]
src/test/rustdoc-ui/doc-without-codeblock.stderr [new file with mode: 0644]

diff --git a/src/test/rustdoc-ui/doc-without-codeblock.rs b/src/test/rustdoc-ui/doc-without-codeblock.rs
new file mode 100644 (file)
index 0000000..e047b27
--- /dev/null
@@ -0,0 +1,20 @@
+// Copyright 2018 The Rust Project Developers. See the COPYRIGHT
+// file at the top-level directory of this distribution and at
+// http://rust-lang.org/COPYRIGHT.
+//
+// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
+// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
+// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
+// option. This file may not be copied, modified, or distributed
+// except according to those terms.
+
+#![deny(missing_doc_code_examples)]
+
+/// Some docs.
+pub struct Foo;
+
+/// And then, the princess died.
+pub mod foo {
+    /// Or maybe not because she saved herself!
+    pub fn bar() {}
+}
diff --git a/src/test/rustdoc-ui/doc-without-codeblock.stderr b/src/test/rustdoc-ui/doc-without-codeblock.stderr
new file mode 100644 (file)
index 0000000..ba5bb7f
--- /dev/null
@@ -0,0 +1,26 @@
+error: Missing code example in this documentation
+   |
+note: lint level defined here
+  --> $DIR/doc-without-codeblock.rs:11:9
+   |
+LL | #![deny(missing_doc_code_examples)]
+   |         ^^^^^^^^^^^^^^^^^^^^^^^^^
+
+error: Missing code example in this documentation
+  --> $DIR/doc-without-codeblock.rs:13:1
+   |
+LL | /// Some docs.
+   | ^^^^^^^^^^^^^^
+
+error: Missing code example in this documentation
+  --> $DIR/doc-without-codeblock.rs:16:1
+   |
+LL | /// And then, the princess died.
+   | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+error: Missing code example in this documentation
+  --> $DIR/doc-without-codeblock.rs:18:5
+   |
+LL |     /// Or maybe not because she saved herself!
+   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+