jsdoc 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Incandescent Software
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,17 @@
+= jsdoc-gem
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Incandescent Software. See LICENSE for details.

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/jsdoc

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'jsdoc'
+
+JsDoc.new.run *ARGV

data/jsdoc.gemspec

@@ -0,0 +1,162 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{jsdoc}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Aaron Hamid"]
+  s.date = %q{2010-11-19}
+  s.default_executable = %q{jsdoc}
+  s.description = %q{a wrapper around jsdoc}
+  s.email = %q{aaron@incandescentsoftware.com}
+  s.executables = ["jsdoc"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    "LICENSE",
+     "README.rdoc",
+     "VERSION",
+     "bin/jsdoc",
+     "jsdoc.gemspec",
+     "lib/jsdoc-toolkit-2.4.0/README.txt",
+     "lib/jsdoc-toolkit-2.4.0/app/frame.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Chain.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Dumper.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Hash.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Link.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Namespace.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Opt.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Reflection.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/String.js",
+     "lib/jsdoc-toolkit-2.4.0/app/frame/Testrun.js",
+     "lib/jsdoc-toolkit-2.4.0/app/handlers/FOODOC.js",
+     "lib/jsdoc-toolkit-2.4.0/app/handlers/XMLDOC.js",
+     "lib/jsdoc-toolkit-2.4.0/app/handlers/XMLDOC/DomReader.js",
+     "lib/jsdoc-toolkit-2.4.0/app/handlers/XMLDOC/XMLDoc.js",
+     "lib/jsdoc-toolkit-2.4.0/app/handlers/XMLDOC/XMLParse.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/DocComment.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/DocTag.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/JsDoc.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/JsPlate.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/Lang.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/Parser.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/PluginManager.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/Symbol.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/SymbolSet.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/TextStream.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/Token.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/TokenReader.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/TokenStream.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/Util.js",
+     "lib/jsdoc-toolkit-2.4.0/app/lib/JSDOC/Walker.js",
+     "lib/jsdoc-toolkit-2.4.0/app/main.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/commentSrcJson.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/frameworkPrototype.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/functionCall.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/publishSrcHilite.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/symbolLink.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/tagParamConfig.js",
+     "lib/jsdoc-toolkit-2.4.0/app/plugins/tagSynonyms.js",
+     "lib/jsdoc-toolkit-2.4.0/app/run.js",
+     "lib/jsdoc-toolkit-2.4.0/app/t/TestDoc.js",
+     "lib/jsdoc-toolkit-2.4.0/app/t/runner.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/addon.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/anon_inner.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/augments.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/augments2.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/borrows.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/borrows2.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/config.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/constructs.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/encoding.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/encoding_other.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/event.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/exports.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/functions_anon.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/functions_nested.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/global.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/globals.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/ignore.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/inner.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/jsdoc_test.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/lend.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/memberof.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/memberof2.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/memberof3.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/memberof_constructor.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/module.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/multi_methods.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/name.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/namespace_nested.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/nocode.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/oblit_anon.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/overview.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/param_inline.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/params_optional.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/prototype.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/prototype_nested.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/prototype_oblit.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/prototype_oblit_constructor.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/public.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/scripts/code.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/scripts/notcode.txt",
+     "lib/jsdoc-toolkit-2.4.0/app/test/shared.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/shared2.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/shortcuts.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/static_this.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/synonyms.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/tosource.js",
+     "lib/jsdoc-toolkit-2.4.0/app/test/variable_redefine.js",
+     "lib/jsdoc-toolkit-2.4.0/changes.txt",
+     "lib/jsdoc-toolkit-2.4.0/conf/sample.conf",
+     "lib/jsdoc-toolkit-2.4.0/java/build.xml",
+     "lib/jsdoc-toolkit-2.4.0/java/build_1.4.xml",
+     "lib/jsdoc-toolkit-2.4.0/java/classes/js.jar",
+     "lib/jsdoc-toolkit-2.4.0/java/src/JsDebugRun.java",
+     "lib/jsdoc-toolkit-2.4.0/java/src/JsRun.java",
+     "lib/jsdoc-toolkit-2.4.0/jsdebug.jar",
+     "lib/jsdoc-toolkit-2.4.0/jsrun.jar",
+     "lib/jsdoc-toolkit-2.4.0/jsrun.sh",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/allclasses.tmpl",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/allfiles.tmpl",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/class.tmpl",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/index.tmpl",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/publish.js",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/static/default.css",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/static/header.html",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/static/index.html",
+     "lib/jsdoc-toolkit-2.4.0/templates/jsdoc/symbol.tmpl",
+     "lib/jsdoc.rb"
+  ]
+  s.homepage = %q{http://github.com/incandescent/jsdoc-gem}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{a wrapper around jsdoc}
+  s.test_files = [
+    "test/test_jsdoc.rb",
+     "test/helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+  end
+end
+

data/lib/jsdoc-toolkit-2.4.0/README.txt

@@ -0,0 +1,183 @@
+======================================================================
+
+DESCRIPTION:
+
+This is the source code for JsDoc Toolkit, an automatic documentation
+generation tool for JavaScript. It is written in JavaScript and is run
+from a command line (or terminal) using Java and Mozilla's Rhino
+JavaScript runtime engine.
+
+Using this tool you can automatically turn JavaDoc-like comments in
+your JavaScript source code into published output files, such as HTML
+or XML.
+
+For more information, to report a bug, or to browse the technical
+documentation for this tool please visit the official JsDoc Toolkit
+project homepage at http://code.google.com/p/jsdoc-toolkit/
+
+For the most up-to-date documentation on JsDoc Toolkit see the 
+official wiki at http://code.google.com/p/jsdoc-toolkit/w/list
+
+======================================================================
+
+REQUIREMENTS:
+
+JsDoc Toolkit is known to work with:
+java version "1.6.0_03"
+Java(TM) SE Runtime Environment (build 1.6.0_03-b05)
+on Windows XP,
+and java version "1.5.0_19"
+Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_19-b02-304)
+on Mac OS X 10.5.
+
+Other versions of java may or may not work with JsDoc Toolkit.
+
+======================================================================
+
+USAGE:
+
+Running JsDoc Toolkit requires you to have Java installed on your
+computer. For more information see http://www.java.com/getjava/
+
+Before running the JsDoc Toolkit app you should change your current
+working directory to the jsdoc-toolkit folder. Then follow the
+examples below, or as shown on the project wiki.
+
+On a computer running Windows a valid command line to run JsDoc
+Toolkit might look like this:
+
+> java -jar jsrun.jar app\run.js -a -t=templates\jsdoc mycode.js
+
+On Mac OS X or Linux the same command would look like this:
+
+$ java -jar jsrun.jar app/run.js -a -t=templates/jsdoc mycode.js
+
+The above assumes your current working directory contains jsrun.jar,
+the "app" and "templates" subdirectories from the standard JsDoc
+Toolkit distribution and that the relative path to the code you wish
+to document is "mycode.js".
+
+The output documentation files will be saved to a new directory named
+"out" (by default) in the current directory, or if you specify a
+-d=somewhere_else option, to the somewhere_else directory.
+
+For help (usage notes) enter this on the command line:
+
+$ java -jar jsrun.jar app/run.js --help
+
+More information about the various command line options used by JsDoc
+Toolkit are available on the project wiki.
+
+======================================================================
+
+RUNNING VIA SHELL SCRIPT
+
+Avi Deitcher has contributed the file jsrun.sh with the following usage notes:
+
+A script to simplify running jsdoc from the command-line, especially when
+running from within a development or build environment such as ant.
+
+Normally, to run jsdoc, you need a command-line as the following:
+java -Djsdoc.dir=/some/long/dir/path/to/jsdoc -jar
+/some/long/dir/path/to/jsdoc/jsrun.jar /some/long/dir/path/to/jsdoc/app/run.js
+-t=template -r=4 /some/long/dir/path/to/my/src/code
+
+This can get tedious to redo time and again, and difficult to use from within a build environment.
+
+To simplify the process, jsrun.sh will automatically run this path, as well as passing through any arguments.
+
+Usage: jsrun.sh <run.js arguments>
+
+All <run.js arguments> will be passed through.
+Additionally, jsrun.sh will take the following actions:
+1) If the environment variable JSDOCDIR is set, it will add
+"-Djsdoc.dir=$JSDOCDIR" to the command-line
+2) If the environment variable JSDOCTEMPLATEDIR is set, it will add
+"-Djsdoc.template.dir=$JSDOCTEMPLATEDIR" to the command-line
+3) java with the appropriate path to jsrun.jar and run.js will be instantiated
+
+If not variables are set, it is assumed that the path to jsrun.jar and app/ is in the current working directory.
+
+Example:
+# jsrun.sh ./src/
+Assuming JSDOCDIR=/some/path/to/my/jsdoc will cause the following command to
+execute:
+java -Djsdoc.dir=/some/path/to/my/jsdoc -jar /some/path/to/my/jsdoc/jsrun.jar
+/some/path/to/my/jsdoc/app/run.js ./src/
+
+======================================================================
+
+TESTING:
+
+To run the suite of unit tests included with JsDoc Toolkit enter this
+on the command line:
+
+$ java -jar jsrun.jar app/run.js -T
+
+To see a dump of the internal data structure that JsDoc Toolkit has
+built from your source files use this command:
+
+$ java -jar jsrun.jar app/run.js mycode.js -Z
+
+======================================================================
+
+LICENSE:
+
+JSDoc.pm
+
+This project is based on the JSDoc.pm tool, created by Michael
+Mathews and Gabriel Reid. More information on JsDoc.pm can
+be found on the JSDoc.pm homepage: http://jsdoc.sourceforge.net/
+
+Complete documentation on JsDoc Toolkit can be found on the project
+wiki at http://code.google.com/p/jsdoc-toolkit/w/list
+
+Rhino
+
+Rhino (JavaScript in Java) is open source and licensed by Mozilla
+under the MPL 1.1 or later/GPL 2.0 or later licenses, the text of
+which is available at http://www.mozilla.org/MPL/
+
+You can obtain the source code for Rhino from the Mozilla web site at
+http://www.mozilla.org/rhino/download.html
+
+JsDoc Toolkit is a larger work that uses the Rhino JavaScript engine
+but is not derived from it in any way. The Rhino library is used 
+without modification and without any claims whatsoever.
+
+The Rhino Debugger
+
+You can obtain more information about the Rhino Debugger from the 
+Mozilla web site at http://www.mozilla.org/rhino/debugger.html
+
+JsDoc Toolkit is a larger work that uses the Rhino Debugger but
+is not derived from it in any way. The Rhino Debugger is used
+without modification and without any claims whatsoever.
+
+JsDoc Toolkit
+
+All code specific to JsDoc Toolkit are free, open source and licensed
+for use under the X11/MIT License.
+
+JsDoc Toolkit is Copyright (c)2009 Michael Mathews <micmath@gmail.com>
+
+This program is free software; you can redistribute it and/or
+modify it under the terms below.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions: The above copyright notice and this
+permission notice must be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/jsdoc-toolkit-2.4.0/app/frame.js

@@ -0,0 +1,33 @@
+IO.include("frame/Opt.js");
+IO.include("frame/Chain.js");
+IO.include("frame/Link.js");
+IO.include("frame/String.js");
+IO.include("frame/Hash.js");
+IO.include("frame/Namespace.js");
+//IO.include("frame/Reflection.js");
+
+/** A few helper functions to make life a little easier. */
+
+function defined(o) {
+	return (o !== undefined);
+}
+
+function copy(o) { // todo check for circular refs
+	if (o == null || typeof(o) != 'object') return o;
+	var c = new o.constructor();
+	for(var p in o)	c[p] = copy(o[p]);
+	return c;
+}
+
+function isUnique(arr) {
+	var l = arr.length;
+	for(var i = 0; i < l; i++ ) {
+		if (arr.lastIndexOf(arr[i]) > i) return false;
+	}
+	return true;
+}
+
+/** Returns the given string with all regex meta characters backslashed. */
+RegExp.escapeMeta = function(str) {
+	return str.replace(/([$^\\\/()|?+*\[\]{}.-])/g, "\\$1");
+}

data/lib/jsdoc-toolkit-2.4.0/app/frame/Chain.js

@@ -0,0 +1,102 @@
+/**@constructor*/
+function ChainNode(object, link) {
+	this.value = object;
+	this.link = link; // describes this node's relationship to the previous node
+}
+
+/**@constructor*/
+function Chain(valueLinks) {
+	this.nodes = [];
+	this.cursor = -1;
+	
+	if (valueLinks && valueLinks.length > 0) {
+		this.push(valueLinks[0], "//");
+		for (var i = 1, l = valueLinks.length; i < l; i+=2) {
+			this.push(valueLinks[i+1], valueLinks[i]);
+		}
+	}
+}
+
+Chain.prototype.push = function(o, link) {
+	if (this.nodes.length > 0 && link) this.nodes.push(new ChainNode(o, link));
+	else this.nodes.push(new ChainNode(o));
+}
+
+Chain.prototype.unshift = function(o, link) {
+	if (this.nodes.length > 0 && link) this.nodes[0].link = link;
+	this.nodes.unshift(new ChainNode(o));
+	this.cursor++;
+}
+
+Chain.prototype.get = function() {
+	if (this.cursor < 0 || this.cursor > this.nodes.length-1) return null;
+	return this.nodes[this.cursor];
+}
+
+Chain.prototype.first = function() {
+	this.cursor = 0;
+	return this.get();
+}
+
+Chain.prototype.last = function() {
+	this.cursor = this.nodes.length-1;
+	return this.get();
+}
+
+Chain.prototype.next = function() {
+	this.cursor++;
+	return this.get();
+}
+
+Chain.prototype.prev = function() {
+	this.cursor--;
+	return this.get();
+}
+
+Chain.prototype.toString = function() {
+	var string = "";
+	for (var i = 0, l = this.nodes.length; i < l; i++) {
+		if (this.nodes[i].link) string += " -("+this.nodes[i].link+")-> ";
+		string += this.nodes[i].value.toString();
+	}
+	return string;
+}
+
+Chain.prototype.joinLeft = function() {
+	var result = "";
+	for (var i = 0, l = this.cursor; i < l; i++) {
+		if (result && this.nodes[i].link) result += this.nodes[i].link;
+		result += this.nodes[i].value.toString();
+	}
+	return result;
+}
+
+
+/* USAGE:
+
+var path = "one/two/three.four/five-six";
+var pathChain = new Chain(path.split(/([\/.-])/));
+print(pathChain);
+
+var lineage = new Chain();
+lineage.push("Port");
+lineage.push("Les", "son");
+lineage.push("Dawn", "daughter");
+lineage.unshift("Purdie", "son");
+
+print(lineage);
+
+// walk left
+for (var node = lineage.last(); node !== null; node = lineage.prev()) {
+	print("< "+node.value);
+}
+
+// walk right
+var node = lineage.first()
+while (node !== null) {
+	print(node.value);
+	node = lineage.next();
+	if (node && node.link) print("had a "+node.link+" named");
+}
+
+*/