ragaskar-jsdoc_helper 0.0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.rdoc +64 -0
- data/bin/jsdoc_helper +8 -0
- data/ext/jsdoc-toolkit/README.txt +146 -0
- data/ext/jsdoc-toolkit/app/frame.js +33 -0
- data/ext/jsdoc-toolkit/app/frame/Chain.js +102 -0
- data/ext/jsdoc-toolkit/app/frame/Dumper.js +144 -0
- data/ext/jsdoc-toolkit/app/frame/Hash.js +84 -0
- data/ext/jsdoc-toolkit/app/frame/Link.js +148 -0
- data/ext/jsdoc-toolkit/app/frame/Namespace.js +10 -0
- data/ext/jsdoc-toolkit/app/frame/Opt.js +134 -0
- data/ext/jsdoc-toolkit/app/frame/Reflection.js +26 -0
- data/ext/jsdoc-toolkit/app/frame/String.js +93 -0
- data/ext/jsdoc-toolkit/app/frame/Testrun.js +129 -0
- data/ext/jsdoc-toolkit/app/handlers/FOODOC.js +26 -0
- data/ext/jsdoc-toolkit/app/handlers/XMLDOC.js +26 -0
- data/ext/jsdoc-toolkit/app/handlers/XMLDOC/DomReader.js +159 -0
- data/ext/jsdoc-toolkit/app/handlers/XMLDOC/XMLDoc.js +16 -0
- data/ext/jsdoc-toolkit/app/handlers/XMLDOC/XMLParse.js +292 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC.js +101 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/DocComment.js +200 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/DocTag.js +294 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/JsDoc.js +126 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/JsPlate.js +109 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/Lang.js +144 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/Parser.js +107 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/PluginManager.js +33 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/Symbol.js +643 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/SymbolSet.js +229 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/TextStream.js +41 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/Token.js +18 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/TokenReader.js +332 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/TokenStream.js +133 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/Util.js +32 -0
- data/ext/jsdoc-toolkit/app/lib/JSDOC/Walker.js +459 -0
- data/ext/jsdoc-toolkit/app/main.js +111 -0
- data/ext/jsdoc-toolkit/app/plugins/commentSrcJson.js +20 -0
- data/ext/jsdoc-toolkit/app/plugins/frameworkPrototype.js +16 -0
- data/ext/jsdoc-toolkit/app/plugins/functionCall.js +10 -0
- data/ext/jsdoc-toolkit/app/plugins/publishSrcHilite.js +62 -0
- data/ext/jsdoc-toolkit/app/plugins/symbolLink.js +9 -0
- data/ext/jsdoc-toolkit/app/plugins/tagParamConfig.js +31 -0
- data/ext/jsdoc-toolkit/app/plugins/tagSynonyms.js +43 -0
- data/ext/jsdoc-toolkit/app/run.js +348 -0
- data/ext/jsdoc-toolkit/app/t/TestDoc.js +144 -0
- data/ext/jsdoc-toolkit/app/t/runner.js +13 -0
- data/ext/jsdoc-toolkit/app/test.js +307 -0
- data/ext/jsdoc-toolkit/app/test/addon.js +24 -0
- data/ext/jsdoc-toolkit/app/test/anon_inner.js +14 -0
- data/ext/jsdoc-toolkit/app/test/augments.js +31 -0
- data/ext/jsdoc-toolkit/app/test/augments2.js +26 -0
- data/ext/jsdoc-toolkit/app/test/borrows.js +41 -0
- data/ext/jsdoc-toolkit/app/test/borrows2.js +23 -0
- data/ext/jsdoc-toolkit/app/test/config.js +22 -0
- data/ext/jsdoc-toolkit/app/test/constructs.js +18 -0
- data/ext/jsdoc-toolkit/app/test/encoding.js +10 -0
- data/ext/jsdoc-toolkit/app/test/encoding_other.js +12 -0
- data/ext/jsdoc-toolkit/app/test/event.js +54 -0
- data/ext/jsdoc-toolkit/app/test/functions_anon.js +39 -0
- data/ext/jsdoc-toolkit/app/test/functions_nested.js +33 -0
- data/ext/jsdoc-toolkit/app/test/global.js +13 -0
- data/ext/jsdoc-toolkit/app/test/globals.js +25 -0
- data/ext/jsdoc-toolkit/app/test/ignore.js +10 -0
- data/ext/jsdoc-toolkit/app/test/inner.js +16 -0
- data/ext/jsdoc-toolkit/app/test/jsdoc_test.js +477 -0
- data/ext/jsdoc-toolkit/app/test/lend.js +33 -0
- data/ext/jsdoc-toolkit/app/test/memberof.js +19 -0
- data/ext/jsdoc-toolkit/app/test/memberof_constructor.js +17 -0
- data/ext/jsdoc-toolkit/app/test/name.js +19 -0
- data/ext/jsdoc-toolkit/app/test/namespace_nested.js +23 -0
- data/ext/jsdoc-toolkit/app/test/nocode.js +13 -0
- data/ext/jsdoc-toolkit/app/test/oblit_anon.js +20 -0
- data/ext/jsdoc-toolkit/app/test/overview.js +20 -0
- data/ext/jsdoc-toolkit/app/test/param_inline.js +37 -0
- data/ext/jsdoc-toolkit/app/test/params_optional.js +8 -0
- data/ext/jsdoc-toolkit/app/test/prototype.js +17 -0
- data/ext/jsdoc-toolkit/app/test/prototype_nested.js +9 -0
- data/ext/jsdoc-toolkit/app/test/prototype_oblit.js +13 -0
- data/ext/jsdoc-toolkit/app/test/prototype_oblit_constructor.js +24 -0
- data/ext/jsdoc-toolkit/app/test/public.js +10 -0
- data/ext/jsdoc-toolkit/app/test/shared.js +42 -0
- data/ext/jsdoc-toolkit/app/test/shared2.js +2 -0
- data/ext/jsdoc-toolkit/app/test/shortcuts.js +22 -0
- data/ext/jsdoc-toolkit/app/test/static_this.js +13 -0
- data/ext/jsdoc-toolkit/app/test/synonyms.js +31 -0
- data/ext/jsdoc-toolkit/app/test/tosource.js +23 -0
- data/ext/jsdoc-toolkit/app/test/variable_redefine.js +14 -0
- data/ext/jsdoc-toolkit/changes.txt +75 -0
- data/ext/jsdoc-toolkit/conf/sample.conf +31 -0
- data/ext/jsdoc-toolkit/java/build.xml +36 -0
- data/ext/jsdoc-toolkit/java/build_1.4.xml +36 -0
- data/ext/jsdoc-toolkit/java/classes/js.jar +0 -0
- data/ext/jsdoc-toolkit/java/src/JsDebugRun.java +21 -0
- data/ext/jsdoc-toolkit/java/src/JsRun.java +21 -0
- data/ext/jsdoc-toolkit/jsdebug.jar +0 -0
- data/ext/jsdoc-toolkit/jsrun.jar +0 -0
- data/ext/jsdoc-toolkit/out/jsdoc/files.html +216 -0
- data/ext/jsdoc-toolkit/out/jsdoc/index.html +210 -0
- data/ext/jsdoc-toolkit/out/jsdoc/symbols/_global_.html +306 -0
- data/ext/jsdoc-toolkit/out/jsdoc/symbols/src/lib_test.js.html +13 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/allclasses.tmpl +17 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/allfiles.tmpl +56 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/class.tmpl +646 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/index.tmpl +39 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/publish.js +184 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/static/default.css +162 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/static/header.html +2 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/static/index.html +19 -0
- data/ext/jsdoc-toolkit/templates/jsdoc/symbol.tmpl +35 -0
- data/lib/jsdoc_helper.rb +50 -0
- data/lib/jsdoc_helper/rake/task.rb +43 -0
- data/lib/jsdoc_helper/rake/task/runner.rb +85 -0
- data/spec/jsdoc_helper/jsdoc_helper_spec.rb +4 -0
- data/spec/jsdoc_helper/rake/task/runner_spec.rb +45 -0
- data/spec/jsdoc_helper/support/file_helper_spec.rb +93 -0
- data/spec/spec_helper.rb +25 -0
- metadata +168 -0
@@ -0,0 +1,33 @@
|
|
1
|
+
/** @class */
|
2
|
+
var Person = Class.create(
|
3
|
+
/**
|
4
|
+
@lends Person.prototype
|
5
|
+
*/
|
6
|
+
{
|
7
|
+
initialize: function(name) {
|
8
|
+
this.name = name;
|
9
|
+
},
|
10
|
+
say: function(message) {
|
11
|
+
return this.name + ': ' + message;
|
12
|
+
}
|
13
|
+
}
|
14
|
+
);
|
15
|
+
|
16
|
+
/** @lends Person.prototype */
|
17
|
+
{
|
18
|
+
/** like say but more musical */
|
19
|
+
sing: function(song) {
|
20
|
+
}
|
21
|
+
}
|
22
|
+
|
23
|
+
/** @lends Person */
|
24
|
+
{
|
25
|
+
getCount: function() {
|
26
|
+
}
|
27
|
+
}
|
28
|
+
|
29
|
+
/** @lends Unknown.prototype */
|
30
|
+
{
|
31
|
+
notok: function() {
|
32
|
+
}
|
33
|
+
}
|
@@ -0,0 +1,19 @@
|
|
1
|
+
/** @constructor */
|
2
|
+
pack = function() {
|
3
|
+
this.init = function(){}
|
4
|
+
function config(){}
|
5
|
+
}
|
6
|
+
|
7
|
+
pack.build = function(task) {};
|
8
|
+
|
9
|
+
/** @memberOf pack */
|
10
|
+
pack.install = function() {}
|
11
|
+
|
12
|
+
/** @memberOf pack */
|
13
|
+
pack.install.overwrite = function() {}
|
14
|
+
|
15
|
+
/** @memberOf pack */
|
16
|
+
clean = function() {}
|
17
|
+
|
18
|
+
/** @memberOf pack-config */
|
19
|
+
install = function() {};
|
@@ -0,0 +1,17 @@
|
|
1
|
+
/** @constructor */
|
2
|
+
function Circle(){}
|
3
|
+
|
4
|
+
/**
|
5
|
+
@constructor
|
6
|
+
@memberOf Circle#
|
7
|
+
*/
|
8
|
+
Circle.prototype.Tangent = function(){};
|
9
|
+
|
10
|
+
// renaming Circle#Tangent to Circle#Circle#Tangent
|
11
|
+
|
12
|
+
/**
|
13
|
+
@memberOf Circle#Tangent#
|
14
|
+
*/
|
15
|
+
Circle.prototype.Tangent.prototype.getDiameter = function(){};
|
16
|
+
|
17
|
+
|
@@ -0,0 +1,19 @@
|
|
1
|
+
/**
|
2
|
+
@name Response
|
3
|
+
@class
|
4
|
+
*/
|
5
|
+
|
6
|
+
Response.prototype = {
|
7
|
+
/**
|
8
|
+
@name Response#text
|
9
|
+
@function
|
10
|
+
@description
|
11
|
+
Gets the body of the response as plain text
|
12
|
+
@returns {String}
|
13
|
+
Response as text
|
14
|
+
*/
|
15
|
+
|
16
|
+
text: function() {
|
17
|
+
return this.nativeResponse.responseText;
|
18
|
+
}
|
19
|
+
}
|
@@ -0,0 +1,23 @@
|
|
1
|
+
/**
|
2
|
+
@namespace This is the first namespace.
|
3
|
+
*/
|
4
|
+
ns1 = {};
|
5
|
+
|
6
|
+
/**
|
7
|
+
This is the second namespace.
|
8
|
+
@namespace
|
9
|
+
*/
|
10
|
+
ns1.ns2 = {};
|
11
|
+
|
12
|
+
/**
|
13
|
+
This part of ns1.ns2
|
14
|
+
@constructor
|
15
|
+
*/
|
16
|
+
ns1.ns2.Function1 = function() {
|
17
|
+
};
|
18
|
+
|
19
|
+
ns1.staticFunction = function() {
|
20
|
+
};
|
21
|
+
|
22
|
+
/** A static field in a namespace. */
|
23
|
+
ns1.ns2.staticField = 1;
|
@@ -0,0 +1,20 @@
|
|
1
|
+
/** the options */
|
2
|
+
opt = Opt.get(
|
3
|
+
arguments,
|
4
|
+
{
|
5
|
+
d: "directory",
|
6
|
+
c: "conf",
|
7
|
+
"D[]": "define"
|
8
|
+
}
|
9
|
+
);
|
10
|
+
|
11
|
+
/** configuration */
|
12
|
+
opt.conf = {
|
13
|
+
/** keep */
|
14
|
+
keep: true,
|
15
|
+
/** base */
|
16
|
+
base: getBase(this, {p: properties})
|
17
|
+
}
|
18
|
+
|
19
|
+
|
20
|
+
|
@@ -0,0 +1,20 @@
|
|
1
|
+
/**
|
2
|
+
* @overview This "library" contains a
|
3
|
+
* lot of classes and functions.
|
4
|
+
* @example
|
5
|
+
<pre>
|
6
|
+
var x (x < 1);
|
7
|
+
alert("This 'is' \"code\"");
|
8
|
+
</pre>
|
9
|
+
* @name My Cool Library
|
10
|
+
* @author Joe Smith jsmith@company.com
|
11
|
+
* @version 0.1
|
12
|
+
*/
|
13
|
+
|
14
|
+
/**
|
15
|
+
* Gets the current foo
|
16
|
+
* @param {String} fooId The unique identifier for the foo.
|
17
|
+
* @return {Object} Returns the current foo.
|
18
|
+
*/
|
19
|
+
function getFoo(fooID){
|
20
|
+
}
|
@@ -0,0 +1,37 @@
|
|
1
|
+
/**
|
2
|
+
@constructor
|
3
|
+
@param columns The number of columns.
|
4
|
+
*/
|
5
|
+
function Layout(/**int*/columns){
|
6
|
+
/**
|
7
|
+
@param [id] The id of the element.
|
8
|
+
@param elName The name of the element.
|
9
|
+
*/
|
10
|
+
this.getElement = function(
|
11
|
+
/** string */ elName,
|
12
|
+
/** number|string */ id
|
13
|
+
) {
|
14
|
+
};
|
15
|
+
|
16
|
+
/**
|
17
|
+
@constructor
|
18
|
+
*/
|
19
|
+
this.Canvas = function(top, left, /**int*/width, height) {
|
20
|
+
/** Is it initiated yet? */
|
21
|
+
this.initiated = true;
|
22
|
+
}
|
23
|
+
|
24
|
+
this.rotate = function(/**nothing*/) {
|
25
|
+
}
|
26
|
+
|
27
|
+
/**
|
28
|
+
@param x
|
29
|
+
@param y
|
30
|
+
@param {zoppler} z*/
|
31
|
+
this.init = function(x, y, /**abbler*/z) {
|
32
|
+
/** The xyz. */
|
33
|
+
this.xyz = x+y+z;
|
34
|
+
this.getXyz = function() {
|
35
|
+
}
|
36
|
+
}
|
37
|
+
}
|
@@ -0,0 +1,17 @@
|
|
1
|
+
/** @constructor */
|
2
|
+
function Article() {
|
3
|
+
}
|
4
|
+
|
5
|
+
Article.prototype.init = function(title) {
|
6
|
+
/** the instance title */
|
7
|
+
this.title = title;
|
8
|
+
|
9
|
+
/** the static counter */
|
10
|
+
Article.counter = 1;
|
11
|
+
}
|
12
|
+
|
13
|
+
a = new Article();
|
14
|
+
a.Init("my title");
|
15
|
+
|
16
|
+
print(a.title);
|
17
|
+
print(Article.counter);
|
@@ -0,0 +1,24 @@
|
|
1
|
+
/** @constructor */
|
2
|
+
function Article() {
|
3
|
+
}
|
4
|
+
|
5
|
+
Article.prototype = {
|
6
|
+
/** @constructor */
|
7
|
+
Title: function(title) {
|
8
|
+
/** the value of the Title instance */
|
9
|
+
this.title = title;
|
10
|
+
},
|
11
|
+
|
12
|
+
init: function(pages) {
|
13
|
+
/** the value of the pages of the Article instance */
|
14
|
+
this.pages = pages;
|
15
|
+
}
|
16
|
+
}
|
17
|
+
|
18
|
+
f = new Article();
|
19
|
+
f.init("one two three");
|
20
|
+
|
21
|
+
t = new f.Title("my title");
|
22
|
+
|
23
|
+
print(f.pages);
|
24
|
+
print(t.title);
|
@@ -0,0 +1,42 @@
|
|
1
|
+
|
2
|
+
/**
|
3
|
+
* Builtin object.
|
4
|
+
* @class
|
5
|
+
* @name Array
|
6
|
+
*/
|
7
|
+
|
8
|
+
/**#@+
|
9
|
+
* Extension to builtin array.
|
10
|
+
* @memberOf Array
|
11
|
+
* @method
|
12
|
+
*/
|
13
|
+
|
14
|
+
/**
|
15
|
+
* @returns Boolen if some array members...
|
16
|
+
*/
|
17
|
+
Array.prototype.some = function(){};
|
18
|
+
|
19
|
+
/**
|
20
|
+
* Change every element of an array.
|
21
|
+
* @returns Filtered array copy.
|
22
|
+
*/
|
23
|
+
Array.prototype.filter = function(){};
|
24
|
+
|
25
|
+
/**#@-*/
|
26
|
+
|
27
|
+
|
28
|
+
/**
|
29
|
+
* A first in, first out data structure.
|
30
|
+
* @constructor
|
31
|
+
*/
|
32
|
+
Queue = function(){};
|
33
|
+
|
34
|
+
/**#@+
|
35
|
+
* Extension to Queue.
|
36
|
+
* @memberOf Queue
|
37
|
+
*/
|
38
|
+
|
39
|
+
rewind = function(){
|
40
|
+
}
|
41
|
+
|
42
|
+
// should close automatically here.
|
@@ -0,0 +1,22 @@
|
|
1
|
+
// /**#=+
|
2
|
+
// * {
|
3
|
+
// * 'D': 'Date.prototype',
|
4
|
+
// * '$N': 'Number'
|
5
|
+
// * }
|
6
|
+
// */
|
7
|
+
// var D = Date.prototype,
|
8
|
+
// $N = Number;
|
9
|
+
//
|
10
|
+
// D.locale = function(){
|
11
|
+
// };
|
12
|
+
//
|
13
|
+
// /**
|
14
|
+
// @return {string} The cardinal number string.
|
15
|
+
// */
|
16
|
+
// $N.nth = function(n){
|
17
|
+
// };
|
18
|
+
//
|
19
|
+
// LOAD.file = function(){
|
20
|
+
// }
|
21
|
+
//
|
22
|
+
// /**#=-*/
|
@@ -0,0 +1,31 @@
|
|
1
|
+
/**
|
2
|
+
@class
|
3
|
+
@inherits Bar#zop as #my_zop
|
4
|
+
*/
|
5
|
+
function Foo() {
|
6
|
+
/** this is a zip. */
|
7
|
+
this.zip = function() {}
|
8
|
+
|
9
|
+
/** from Bar */
|
10
|
+
this.my_zop = new Bar().zop;
|
11
|
+
}
|
12
|
+
|
13
|
+
/**
|
14
|
+
@class
|
15
|
+
@borrows Foo#zip as this.my_zip
|
16
|
+
*/
|
17
|
+
function Bar() {
|
18
|
+
/** this is a zop. */
|
19
|
+
this.zop = function() {}
|
20
|
+
|
21
|
+
/** from Foo */
|
22
|
+
this.my_zip = new Foo().zip;
|
23
|
+
}
|
24
|
+
|
25
|
+
/** @namespace */
|
26
|
+
var myObject = {
|
27
|
+
/**
|
28
|
+
@type function
|
29
|
+
*/
|
30
|
+
myFunc: getFunction()
|
31
|
+
}
|
@@ -0,0 +1,23 @@
|
|
1
|
+
/**
|
2
|
+
* @param {Object} object
|
3
|
+
* @return {string}
|
4
|
+
*/
|
5
|
+
function valueOf(object) {}
|
6
|
+
|
7
|
+
/**
|
8
|
+
* @param {Object} object
|
9
|
+
* @return {string}
|
10
|
+
*/
|
11
|
+
function toString(object) {}
|
12
|
+
|
13
|
+
/**
|
14
|
+
* @param {Object} object
|
15
|
+
* @return {string}
|
16
|
+
*/
|
17
|
+
function toSource(object) {}
|
18
|
+
|
19
|
+
/**
|
20
|
+
* @param {Object} object
|
21
|
+
* @return {string}
|
22
|
+
*/
|
23
|
+
function constructor(object) {}
|