rustdoc: Add impl doc node
This commit is contained in:
parent
56db37d4c7
commit
acb11f47dc
3 changed files with 43 additions and 5 deletions
|
@ -12,7 +12,8 @@ enum itemtag {
|
|||
fntag(fndoc),
|
||||
enumtag(enumdoc),
|
||||
restag(resdoc),
|
||||
ifacetag(ifacedoc)
|
||||
ifacetag(ifacedoc),
|
||||
impltag(impldoc)
|
||||
}
|
||||
|
||||
type moddoc = {
|
||||
|
@ -96,6 +97,16 @@ type methoddoc = {
|
|||
sig: option<str>
|
||||
};
|
||||
|
||||
type impldoc = {
|
||||
id: ast_id,
|
||||
name: str,
|
||||
brief: option<str>,
|
||||
desc: option<str>,
|
||||
iface_ty: option<str>,
|
||||
for_ty: option<str>,
|
||||
methods: [methoddoc]
|
||||
};
|
||||
|
||||
#[doc = "Some helper methods on moddoc, mostly for testing"]
|
||||
impl util for moddoc {
|
||||
|
||||
|
@ -152,6 +163,15 @@ impl util for moddoc {
|
|||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn impls() -> [impldoc] {
|
||||
vec::filter_map(*self.items) {|itemtag|
|
||||
alt itemtag {
|
||||
impltag(impldoc) { some(impldoc) }
|
||||
_ { none }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#[doc = "Helper methods on itemtag"]
|
||||
|
@ -164,6 +184,7 @@ impl util for itemtag {
|
|||
doc::enumtag({name, _}) { name }
|
||||
doc::restag({name, _}) { name }
|
||||
doc::ifacetag({name, _}) { name }
|
||||
_ { fail }
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
@ -11,6 +11,7 @@ export default_seq_fold_const;
|
|||
export default_seq_fold_enum;
|
||||
export default_seq_fold_res;
|
||||
export default_seq_fold_iface;
|
||||
export default_seq_fold_impl;
|
||||
|
||||
enum fold<T> = t<T>;
|
||||
|
||||
|
@ -21,6 +22,7 @@ type fold_const<T> = fn~(fold: fold<T>, doc: doc::constdoc) -> doc::constdoc;
|
|||
type fold_enum<T> = fn~(fold: fold<T>, doc: doc::enumdoc) -> doc::enumdoc;
|
||||
type fold_res<T> = fn~(fold: fold<T>, doc: doc::resdoc) -> doc::resdoc;
|
||||
type fold_iface<T> = fn~(fold: fold<T>, doc: doc::ifacedoc) -> doc::ifacedoc;
|
||||
type fold_impl<T> = fn~(fold: fold<T>, doc: doc::impldoc) -> doc::impldoc;
|
||||
|
||||
type t<T> = {
|
||||
ctxt: T,
|
||||
|
@ -30,7 +32,8 @@ type t<T> = {
|
|||
fold_const: fold_const<T>,
|
||||
fold_enum: fold_enum<T>,
|
||||
fold_res: fold_res<T>,
|
||||
fold_iface: fold_iface<T>
|
||||
fold_iface: fold_iface<T>,
|
||||
fold_impl: fold_impl<T>
|
||||
};
|
||||
|
||||
|
||||
|
@ -44,7 +47,8 @@ fn mk_fold<T:copy>(
|
|||
fold_const: fold_const<T>,
|
||||
fold_enum: fold_enum<T>,
|
||||
fold_res: fold_res<T>,
|
||||
fold_iface: fold_iface<T>
|
||||
fold_iface: fold_iface<T>,
|
||||
fold_impl: fold_impl<T>
|
||||
) -> fold<T> {
|
||||
fold({
|
||||
ctxt: ctxt,
|
||||
|
@ -54,7 +58,8 @@ fn mk_fold<T:copy>(
|
|||
fold_const: fold_const,
|
||||
fold_enum: fold_enum,
|
||||
fold_res: fold_res,
|
||||
fold_iface: fold_iface
|
||||
fold_iface: fold_iface,
|
||||
fold_impl: fold_impl
|
||||
})
|
||||
}
|
||||
|
||||
|
@ -67,7 +72,8 @@ fn default_seq_fold<T:copy>(ctxt: T) -> fold<T> {
|
|||
{|f, d| default_seq_fold_const(f, d)},
|
||||
{|f, d| default_seq_fold_enum(f, d)},
|
||||
{|f, d| default_seq_fold_res(f, d)},
|
||||
{|f, d| default_seq_fold_iface(f, d)}
|
||||
{|f, d| default_seq_fold_iface(f, d)},
|
||||
{|f, d| default_seq_fold_impl(f, d)}
|
||||
)
|
||||
}
|
||||
|
||||
|
@ -105,6 +111,9 @@ fn default_seq_fold_mod<T>(
|
|||
doc::ifacetag(ifacedoc) {
|
||||
doc::ifacetag(fold.fold_iface(fold, ifacedoc))
|
||||
}
|
||||
doc::impltag(impldoc) {
|
||||
doc::impltag(fold.fold_impl(fold, impldoc))
|
||||
}
|
||||
}
|
||||
}
|
||||
with doc
|
||||
|
@ -146,6 +155,13 @@ fn default_seq_fold_iface<T>(
|
|||
doc
|
||||
}
|
||||
|
||||
fn default_seq_fold_impl<T>(
|
||||
_fold: fold<T>,
|
||||
doc: doc::impldoc
|
||||
) -> doc::impldoc {
|
||||
doc
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn default_fold_should_produce_same_doc() {
|
||||
let source = "mod a { fn b() { } mod c { fn d() { } } }";
|
||||
|
|
|
@ -138,6 +138,7 @@ fn write_mod_contents(
|
|||
doc::enumtag(enumdoc) { write_enum(ctxt, enumdoc) }
|
||||
doc::restag(resdoc) { write_res(ctxt, resdoc) }
|
||||
doc::ifacetag(ifacedoc) { write_iface(ctxt, ifacedoc) }
|
||||
doc::impltag(impldoc) { fail }
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue