correct documentation, use markdown

This commit is contained in:
rolux 2012-05-30 13:31:42 +02:00
parent ca05f24a6a
commit 1c98a3198a

View file

@ -20,7 +20,7 @@ Ox.doc <f> Generates documentation for annotated JavaScript
file <s> File name
line <n> Line number
name <s> Name of the item
order <[s]> Order of signature, arguments, properties
order <[s]> Order of returns, arguments, properties
Present if the type of the item is "function"
properties <[o]|u> Properties (array of doc objects)
Present if the <code>type</code> of the item is
@ -114,7 +114,7 @@ Ox.doc = (function() {
'\'"'.indexOf(matches[2].slice(-2, -1)) > -1
) ? Ox.extend(
parseName(matches[1]),
parseType(matches[2]),
parseTypes(matches[2]),
{summary: matches[3].trim()}
) : null;
}
@ -158,6 +158,10 @@ Ox.doc = (function() {
}
}
});
item.summary = Ox.parseMarkdown(item.summary);
if (item.description) {
item.description = Ox.parseMarkdown(item.description)
}
if (item.types[0] == 'function') {
item.order = Ox.unique(order);
}
@ -303,7 +307,7 @@ Ox.doc = (function() {
}
return node;
}
function parseType(string) {
function parseTypes(string) {
// returns {types: [""]}
// or {types: [""], default: ""}
// or {types: [""], super: ""}