Struct rustc_resolve::rustdoc::DocFragment

pub struct DocFragment {
    pub span: Span,
    pub item_id: Option<DefId>,
    pub doc: Symbol,
    pub kind: DocFragmentKind,
    pub indent: usize,
}

A portion of documentation, extracted from a #[doc] attribute.

Each variant contains the line number within the complete doc-comment where the fragment starts, as well as the Span where the corresponding doc comment or attribute is located.

Included files are kept separate from inline doc comments so that proper line-number information can be given when a doctest fails. Sugared doc comments and “raw” doc comments are kept separate because of issue #42760.

Fields

span: Span

item_id: Option<DefId>

The item this doc-comment came from. Used to determine the scope in which doc links in this fragment are resolved. Typically filled for reexport docs when they are merged into the docs of the original reexported item. If the id is not filled, which happens for the original reexported item, then it has to be taken from somewhere else during doc link resolution.

doc: Symbol

kind: DocFragmentKind

indent: usize

Trait Implementations

impl Clone for DocFragment

fn clone(&self) -> DocFragment

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DocFragment

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for DocFragment

fn eq(&self, other: &DocFragment) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DocFragment

impl StructuralPartialEq for DocFragment

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes