Method doc_comment

cranelift/srcgen/src/lib.rs:171–183

Add a (multi-line) documentation comment.

(&mut self, contents: impl AsRef<str>)

    /// Add a (multi-line) documentation comment.
    pub fn doc_comment(&mut self, contents: impl AsRef<str>) {
        assert!(matches!(self.lang, Language::Rust));
        parse_multiline(contents.as_ref())
            .iter()
            .map(|l| {
                if l.is_empty() {
                    "///".into()
                } else {
                    format!("/// {l}")
                }
            })
            .for_each(|s| self.line(s.as_str()));
    }

    /// Add a brace-delimited block that begins with `start`: i.e., `<start> {
    /// <f()> }`. This properly indents the contents of the block.