2012-03-06 15:56:33 -06:00
|
|
|
#[doc = "
|
|
|
|
|
|
|
|
Divides the document tree into pages.
|
|
|
|
|
|
|
|
Each page corresponds is a logical section. There may be pages for individual
|
|
|
|
modules, pages for the crate, indexes, etc.
|
|
|
|
|
|
|
|
"];
|
|
|
|
|
|
|
|
export mk_pass;
|
|
|
|
|
|
|
|
fn mk_pass(output_style: config::output_style) -> pass {
|
|
|
|
{
|
|
|
|
name: "page",
|
|
|
|
f: fn~(srv: astsrv::srv, doc: doc::doc) -> doc::doc {
|
|
|
|
run(srv, doc, output_style)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fn run(
|
|
|
|
_srv: astsrv::srv,
|
|
|
|
doc: doc::doc,
|
|
|
|
output_style: config::output_style
|
|
|
|
) -> doc::doc {
|
|
|
|
|
|
|
|
if output_style == config::doc_per_crate {
|
|
|
|
ret doc;
|
|
|
|
}
|
|
|
|
|
|
|
|
let result_port = comm::port();
|
|
|
|
let result_chan = comm::chan(result_port);
|
|
|
|
let page_chan = task::spawn_listener {|page_port|
|
|
|
|
comm::send(result_chan, make_doc_from_pages(page_port));
|
|
|
|
};
|
|
|
|
|
|
|
|
find_pages(doc, page_chan);
|
|
|
|
comm::recv(result_port)
|
|
|
|
}
|
|
|
|
|
|
|
|
type page_port = comm::port<option<doc::page>>;
|
|
|
|
type page_chan = comm::chan<option<doc::page>>;
|
|
|
|
|
|
|
|
fn make_doc_from_pages(page_port: page_port) -> doc::doc {
|
|
|
|
let mut pages = [];
|
2012-03-09 18:11:56 -06:00
|
|
|
loop {
|
2012-03-06 15:56:33 -06:00
|
|
|
let val = comm::recv(page_port);
|
|
|
|
if option::is_some(val) {
|
|
|
|
pages += [option::unwrap(val)];
|
|
|
|
} else {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
{
|
|
|
|
pages: pages
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fn find_pages(doc: doc::doc, page_chan: page_chan) {
|
|
|
|
let fold = fold::fold({
|
|
|
|
fold_crate: fold_crate,
|
|
|
|
fold_mod: fold_mod
|
|
|
|
with *fold::default_any_fold(page_chan)
|
|
|
|
});
|
|
|
|
fold.fold_doc(fold, doc);
|
|
|
|
|
|
|
|
comm::send(page_chan, none);
|
|
|
|
}
|
|
|
|
|
|
|
|
fn fold_crate(
|
|
|
|
fold: fold::fold<page_chan>,
|
|
|
|
doc: doc::cratedoc
|
|
|
|
) -> doc::cratedoc {
|
|
|
|
|
|
|
|
let doc = fold::default_seq_fold_crate(fold, doc);
|
|
|
|
|
|
|
|
let page = doc::cratepage({
|
|
|
|
topmod: strip_mod(doc.topmod)
|
|
|
|
with doc
|
|
|
|
});
|
|
|
|
|
|
|
|
comm::send(fold.ctxt, some(page));
|
|
|
|
|
|
|
|
doc
|
|
|
|
}
|
|
|
|
|
|
|
|
fn fold_mod(
|
|
|
|
fold: fold::fold<page_chan>,
|
|
|
|
doc: doc::moddoc
|
|
|
|
) -> doc::moddoc {
|
|
|
|
|
|
|
|
let doc = fold::default_any_fold_mod(fold, doc);
|
|
|
|
|
|
|
|
if doc.id() != rustc::syntax::ast::crate_node_id {
|
|
|
|
|
|
|
|
let doc = strip_mod(doc);
|
|
|
|
let page = doc::itempage(doc::modtag(doc));
|
|
|
|
comm::send(fold.ctxt, some(page));
|
|
|
|
}
|
|
|
|
|
|
|
|
doc
|
|
|
|
}
|
|
|
|
|
|
|
|
fn strip_mod(doc: doc::moddoc) -> doc::moddoc {
|
|
|
|
{
|
|
|
|
items: vec::filter(doc.items) {|item|
|
|
|
|
alt item {
|
|
|
|
doc::modtag(_) { false }
|
|
|
|
_ { true }
|
|
|
|
}
|
|
|
|
}
|
|
|
|
with doc
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn should_not_split_the_doc_into_pages_for_doc_per_crate() {
|
|
|
|
let doc = test::mk_doc_(
|
|
|
|
config::doc_per_crate,
|
|
|
|
"mod a { } mod b { mod c { } }"
|
|
|
|
);
|
|
|
|
assert doc.pages.len() == 1u;
|
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn should_make_a_page_for_every_mod() {
|
|
|
|
let doc = test::mk_doc("mod a { }");
|
|
|
|
assert doc.pages.mods()[0].name() == "a";
|
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn should_remove_mods_from_containing_mods() {
|
|
|
|
let doc = test::mk_doc("mod a { }");
|
|
|
|
assert vec::is_empty(doc.cratemod().mods());
|
|
|
|
}
|
|
|
|
|
|
|
|
#[cfg(test)]
|
|
|
|
mod test {
|
|
|
|
fn mk_doc_(
|
|
|
|
output_style: config::output_style,
|
|
|
|
source: str
|
|
|
|
) -> doc::doc {
|
|
|
|
astsrv::from_str(source) {|srv|
|
|
|
|
let doc = extract::from_srv(srv, "");
|
|
|
|
run(srv, doc, output_style)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fn mk_doc(source: str) -> doc::doc {
|
|
|
|
mk_doc_(config::doc_per_mod, source)
|
|
|
|
}
|
|
|
|
}
|