rust/tests/rustdoc/description.rs

#![crate_name = "foo"]
#![allow(rustdoc::redundant_explicit_links)]
//! # Description test crate
//!
//! This is the contents of the test crate docstring.
//! It should not show up in the description.

//@ has 'foo/index.html' '//meta[@name="description"]/@content' \
//   'Description test crate'
//@ !has - '//meta[@name="description"]/@content' 'should not show up'

//@ has 'foo/foo_mod/index.html' '//meta[@name="description"]/@content' \
//   'First paragraph description.'
//@ !has - '//meta[@name="description"]/@content' 'Second paragraph'
/// First paragraph description.
///
/// Second paragraph should not show up.
pub mod foo_mod {
    pub struct __Thing {}
}

//@ has 'foo/fn.foo_fn.html' '//meta[@name="description"]/@content' \
//   'Only paragraph.'
/// Only paragraph.
pub fn foo_fn() {}

//@ has 'foo/fn.bar_fn.html' '//meta[@name="description"]/@content' \
//   'Description with intra-doc link to foo_fn and [nonexistent_item] and foo_fn.'
#[allow(rustdoc::broken_intra_doc_links)]
/// Description with intra-doc link to [foo_fn] and [nonexistent_item] and [foo_fn](self::foo_fn).
pub fn bar_fn() {}