ragaskar-jsdoc_helper 0.0.2.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (116) hide show
  1. data/README.rdoc +64 -0
  2. data/bin/jsdoc_helper +8 -0
  3. data/ext/jsdoc-toolkit/README.txt +146 -0
  4. data/ext/jsdoc-toolkit/app/frame.js +33 -0
  5. data/ext/jsdoc-toolkit/app/frame/Chain.js +102 -0
  6. data/ext/jsdoc-toolkit/app/frame/Dumper.js +144 -0
  7. data/ext/jsdoc-toolkit/app/frame/Hash.js +84 -0
  8. data/ext/jsdoc-toolkit/app/frame/Link.js +148 -0
  9. data/ext/jsdoc-toolkit/app/frame/Namespace.js +10 -0
  10. data/ext/jsdoc-toolkit/app/frame/Opt.js +134 -0
  11. data/ext/jsdoc-toolkit/app/frame/Reflection.js +26 -0
  12. data/ext/jsdoc-toolkit/app/frame/String.js +93 -0
  13. data/ext/jsdoc-toolkit/app/frame/Testrun.js +129 -0
  14. data/ext/jsdoc-toolkit/app/handlers/FOODOC.js +26 -0
  15. data/ext/jsdoc-toolkit/app/handlers/XMLDOC.js +26 -0
  16. data/ext/jsdoc-toolkit/app/handlers/XMLDOC/DomReader.js +159 -0
  17. data/ext/jsdoc-toolkit/app/handlers/XMLDOC/XMLDoc.js +16 -0
  18. data/ext/jsdoc-toolkit/app/handlers/XMLDOC/XMLParse.js +292 -0
  19. data/ext/jsdoc-toolkit/app/lib/JSDOC.js +101 -0
  20. data/ext/jsdoc-toolkit/app/lib/JSDOC/DocComment.js +200 -0
  21. data/ext/jsdoc-toolkit/app/lib/JSDOC/DocTag.js +294 -0
  22. data/ext/jsdoc-toolkit/app/lib/JSDOC/JsDoc.js +126 -0
  23. data/ext/jsdoc-toolkit/app/lib/JSDOC/JsPlate.js +109 -0
  24. data/ext/jsdoc-toolkit/app/lib/JSDOC/Lang.js +144 -0
  25. data/ext/jsdoc-toolkit/app/lib/JSDOC/Parser.js +107 -0
  26. data/ext/jsdoc-toolkit/app/lib/JSDOC/PluginManager.js +33 -0
  27. data/ext/jsdoc-toolkit/app/lib/JSDOC/Symbol.js +643 -0
  28. data/ext/jsdoc-toolkit/app/lib/JSDOC/SymbolSet.js +229 -0
  29. data/ext/jsdoc-toolkit/app/lib/JSDOC/TextStream.js +41 -0
  30. data/ext/jsdoc-toolkit/app/lib/JSDOC/Token.js +18 -0
  31. data/ext/jsdoc-toolkit/app/lib/JSDOC/TokenReader.js +332 -0
  32. data/ext/jsdoc-toolkit/app/lib/JSDOC/TokenStream.js +133 -0
  33. data/ext/jsdoc-toolkit/app/lib/JSDOC/Util.js +32 -0
  34. data/ext/jsdoc-toolkit/app/lib/JSDOC/Walker.js +459 -0
  35. data/ext/jsdoc-toolkit/app/main.js +111 -0
  36. data/ext/jsdoc-toolkit/app/plugins/commentSrcJson.js +20 -0
  37. data/ext/jsdoc-toolkit/app/plugins/frameworkPrototype.js +16 -0
  38. data/ext/jsdoc-toolkit/app/plugins/functionCall.js +10 -0
  39. data/ext/jsdoc-toolkit/app/plugins/publishSrcHilite.js +62 -0
  40. data/ext/jsdoc-toolkit/app/plugins/symbolLink.js +9 -0
  41. data/ext/jsdoc-toolkit/app/plugins/tagParamConfig.js +31 -0
  42. data/ext/jsdoc-toolkit/app/plugins/tagSynonyms.js +43 -0
  43. data/ext/jsdoc-toolkit/app/run.js +348 -0
  44. data/ext/jsdoc-toolkit/app/t/TestDoc.js +144 -0
  45. data/ext/jsdoc-toolkit/app/t/runner.js +13 -0
  46. data/ext/jsdoc-toolkit/app/test.js +307 -0
  47. data/ext/jsdoc-toolkit/app/test/addon.js +24 -0
  48. data/ext/jsdoc-toolkit/app/test/anon_inner.js +14 -0
  49. data/ext/jsdoc-toolkit/app/test/augments.js +31 -0
  50. data/ext/jsdoc-toolkit/app/test/augments2.js +26 -0
  51. data/ext/jsdoc-toolkit/app/test/borrows.js +41 -0
  52. data/ext/jsdoc-toolkit/app/test/borrows2.js +23 -0
  53. data/ext/jsdoc-toolkit/app/test/config.js +22 -0
  54. data/ext/jsdoc-toolkit/app/test/constructs.js +18 -0
  55. data/ext/jsdoc-toolkit/app/test/encoding.js +10 -0
  56. data/ext/jsdoc-toolkit/app/test/encoding_other.js +12 -0
  57. data/ext/jsdoc-toolkit/app/test/event.js +54 -0
  58. data/ext/jsdoc-toolkit/app/test/functions_anon.js +39 -0
  59. data/ext/jsdoc-toolkit/app/test/functions_nested.js +33 -0
  60. data/ext/jsdoc-toolkit/app/test/global.js +13 -0
  61. data/ext/jsdoc-toolkit/app/test/globals.js +25 -0
  62. data/ext/jsdoc-toolkit/app/test/ignore.js +10 -0
  63. data/ext/jsdoc-toolkit/app/test/inner.js +16 -0
  64. data/ext/jsdoc-toolkit/app/test/jsdoc_test.js +477 -0
  65. data/ext/jsdoc-toolkit/app/test/lend.js +33 -0
  66. data/ext/jsdoc-toolkit/app/test/memberof.js +19 -0
  67. data/ext/jsdoc-toolkit/app/test/memberof_constructor.js +17 -0
  68. data/ext/jsdoc-toolkit/app/test/name.js +19 -0
  69. data/ext/jsdoc-toolkit/app/test/namespace_nested.js +23 -0
  70. data/ext/jsdoc-toolkit/app/test/nocode.js +13 -0
  71. data/ext/jsdoc-toolkit/app/test/oblit_anon.js +20 -0
  72. data/ext/jsdoc-toolkit/app/test/overview.js +20 -0
  73. data/ext/jsdoc-toolkit/app/test/param_inline.js +37 -0
  74. data/ext/jsdoc-toolkit/app/test/params_optional.js +8 -0
  75. data/ext/jsdoc-toolkit/app/test/prototype.js +17 -0
  76. data/ext/jsdoc-toolkit/app/test/prototype_nested.js +9 -0
  77. data/ext/jsdoc-toolkit/app/test/prototype_oblit.js +13 -0
  78. data/ext/jsdoc-toolkit/app/test/prototype_oblit_constructor.js +24 -0
  79. data/ext/jsdoc-toolkit/app/test/public.js +10 -0
  80. data/ext/jsdoc-toolkit/app/test/shared.js +42 -0
  81. data/ext/jsdoc-toolkit/app/test/shared2.js +2 -0
  82. data/ext/jsdoc-toolkit/app/test/shortcuts.js +22 -0
  83. data/ext/jsdoc-toolkit/app/test/static_this.js +13 -0
  84. data/ext/jsdoc-toolkit/app/test/synonyms.js +31 -0
  85. data/ext/jsdoc-toolkit/app/test/tosource.js +23 -0
  86. data/ext/jsdoc-toolkit/app/test/variable_redefine.js +14 -0
  87. data/ext/jsdoc-toolkit/changes.txt +75 -0
  88. data/ext/jsdoc-toolkit/conf/sample.conf +31 -0
  89. data/ext/jsdoc-toolkit/java/build.xml +36 -0
  90. data/ext/jsdoc-toolkit/java/build_1.4.xml +36 -0
  91. data/ext/jsdoc-toolkit/java/classes/js.jar +0 -0
  92. data/ext/jsdoc-toolkit/java/src/JsDebugRun.java +21 -0
  93. data/ext/jsdoc-toolkit/java/src/JsRun.java +21 -0
  94. data/ext/jsdoc-toolkit/jsdebug.jar +0 -0
  95. data/ext/jsdoc-toolkit/jsrun.jar +0 -0
  96. data/ext/jsdoc-toolkit/out/jsdoc/files.html +216 -0
  97. data/ext/jsdoc-toolkit/out/jsdoc/index.html +210 -0
  98. data/ext/jsdoc-toolkit/out/jsdoc/symbols/_global_.html +306 -0
  99. data/ext/jsdoc-toolkit/out/jsdoc/symbols/src/lib_test.js.html +13 -0
  100. data/ext/jsdoc-toolkit/templates/jsdoc/allclasses.tmpl +17 -0
  101. data/ext/jsdoc-toolkit/templates/jsdoc/allfiles.tmpl +56 -0
  102. data/ext/jsdoc-toolkit/templates/jsdoc/class.tmpl +646 -0
  103. data/ext/jsdoc-toolkit/templates/jsdoc/index.tmpl +39 -0
  104. data/ext/jsdoc-toolkit/templates/jsdoc/publish.js +184 -0
  105. data/ext/jsdoc-toolkit/templates/jsdoc/static/default.css +162 -0
  106. data/ext/jsdoc-toolkit/templates/jsdoc/static/header.html +2 -0
  107. data/ext/jsdoc-toolkit/templates/jsdoc/static/index.html +19 -0
  108. data/ext/jsdoc-toolkit/templates/jsdoc/symbol.tmpl +35 -0
  109. data/lib/jsdoc_helper.rb +50 -0
  110. data/lib/jsdoc_helper/rake/task.rb +43 -0
  111. data/lib/jsdoc_helper/rake/task/runner.rb +85 -0
  112. data/spec/jsdoc_helper/jsdoc_helper_spec.rb +4 -0
  113. data/spec/jsdoc_helper/rake/task/runner_spec.rb +45 -0
  114. data/spec/jsdoc_helper/support/file_helper_spec.rb +93 -0
  115. data/spec/spec_helper.rb +25 -0
  116. 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,13 @@
1
+ /**#nocode+*/
2
+ /**
3
+ @name star
4
+ @function
5
+ */
6
+ function blahblah() {
7
+
8
+ }
9
+ /**#nocode-*/
10
+
11
+ function yaddayadda() {
12
+
13
+ }
@@ -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,8 @@
1
+
2
+ /**
3
+ * @param {Page[]} pages
4
+ * @param {number} [id] Specifies the id, if applicable.
5
+ * @param {String} [title = This is untitled.] Specifies the title.
6
+ */
7
+ function Document(pages, id, title){
8
+ }
@@ -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,9 @@
1
+ /** @constructor */
2
+ function Word() {
3
+ }
4
+
5
+ Word.prototype.reverse = function() {
6
+ }
7
+
8
+ Word.prototype.reverse.utf8 = function() {
9
+ }
@@ -0,0 +1,13 @@
1
+ /** @constructor */
2
+ function Article() {
3
+ }
4
+
5
+ Article.prototype = {
6
+ /** instance get title */
7
+ getTitle: function(){
8
+ }
9
+ }
10
+
11
+ /** static get title */
12
+ Article.getTitle = function(){
13
+ }
@@ -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,10 @@
1
+ /**@constructor*/
2
+ function Foo() {
3
+ /**
4
+ @public
5
+ @static
6
+ @field
7
+ */
8
+ var bar = function(x) {
9
+ }
10
+ }
@@ -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,2 @@
1
+ startOver = function(){
2
+ }
@@ -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,13 @@
1
+ /** the parent */
2
+ var box = {};
3
+
4
+ /** @namespace */
5
+ box.holder = {}
6
+
7
+ box.holder.foo = function() {
8
+ /** the counter */
9
+ this.counter = 1;
10
+ }
11
+
12
+ box.holder.foo();
13
+ print(box.holder.counter);
@@ -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) {}