rustdoc: Write blank lines after brief descriptions

This commit is contained in:
Brian Anderson 2012-01-17 23:29:23 -08:00
parent 971236e8f7
commit 0142e807dd
1 changed files with 23 additions and 2 deletions

View File

@ -94,6 +94,7 @@ fn write_fn(
alt doc.brief {
some(brief) {
ctxt.w.write_line(brief);
ctxt.w.write_line("");
}
none. { }
}
@ -145,7 +146,7 @@ mod tests {
let ast = parse::from_str(source);
let doc = extract::extract(ast, "belch");
let markdown = write_markdown_str(doc);
assert str::contains(markdown, "# Crate belch\n");
assert str::contains(markdown, "# Crate belch");
}
#[test]
@ -172,6 +173,26 @@ mod tests {
let ast = parse::from_str(source);
let doc = extract::extract(ast, "");
let markdown = write_markdown_str(doc);
assert str::contains(markdown, "Module `morp`\n");
assert str::contains(markdown, "Module `morp`\n\n");
}
#[test]
fn should_leave_blank_line_between_fn_header_and_brief() {
let source = "#[doc(brief = \"brief\")] fn a() { }";
let srv = astsrv::mk_srv_from_str(source);
let doc = extract::from_srv(srv, "");
let doc = attr_pass::mk_pass()(srv, doc);
let markdown = write_markdown_str(doc);
assert str::contains(markdown, "Function `a`\n\nbrief");
}
#[test]
fn should_leve_blank_line_after_brief() {
let source = "#[doc(brief = \"brief\")] fn a() { }";
let srv = astsrv::mk_srv_from_str(source);
let doc = extract::from_srv(srv, "");
let doc = attr_pass::mk_pass()(srv, doc);
let markdown = write_markdown_str(doc);
assert str::contains(markdown, "brief\n\n");
}
}