cornerstone-source 0.1.1

data/source/javascripts/_cornerstone/random.js.coffee

@@ -0,0 +1,86 @@
+( ->
+  ###*
+  @name Random
+  @namespace Some useful methods for generating random things.
+  ###
+  (exports ? this)["Random"] =
+    ###*
+    Returns a random angle, uniformly distributed, between 0 and 2pi.
+
+    @name angle
+    @methodOf Random
+    @returns {Number} A random angle between 0 and 2pi
+    ###
+    angle: ->
+      rand() * Math.TAU
+
+    ###*
+    Returns a random angle between the given angles.
+
+    @name angleBetween
+    @methodOf Random
+    @returns {Number} A random angle between the angles given.
+    ###
+    angleBetween: (min, max) ->
+      rand() * (max - min) + min
+
+    ###*
+    Returns a random color.
+
+    @name color
+    @methodOf Random
+    @returns {Color} A random color
+    ###
+    color: ->
+      Color.random()
+
+    ###*
+    Happens often.
+
+    @name often
+    @methodOf Random
+    ###
+    often: ->
+      return rand(3)
+
+    ###*
+    Happens sometimes.
+
+    @name sometimes
+    @methodOf Random
+    ###
+    sometimes: ->
+      !rand(3)
+
+  ###*
+  Returns random integers from [0, n) if n is given.
+  Otherwise returns random float between 0 and 1.
+
+  @name rand
+  @methodOf window
+  @param {Number} n
+  @returns {Number} A random integer from 0 to n - 1 if n is given. If n is not given, a random float between 0 and 1. 
+  ###
+  (exports ? this)["rand"] = (n) -> 
+    if n
+      Math.floor(n * Math.random())
+    else
+      Math.random()
+
+  ###*
+  Returns random float from [-n / 2, n / 2] if n is given.
+  Otherwise returns random float between -0.5 and 0.5.
+
+  @name signedRand
+  @methodOf window
+  @param {Number} n
+  @returns {Number} A random float from -n / 2 to n / 2 if n is given. If n is not given, a random float between -0.5 and 0.5. 
+  ###
+  (exports ? this)["signedRand"] = (n) ->
+    if n
+      (n * Math.random()) - (n / 2)
+    else
+      Math.random() - 0.5
+
+)()
+

data/source/javascripts/_cornerstone/rectangle.js.coffee

@@ -0,0 +1,35 @@
+(->
+  Rectangle = ({x, y, width, height}) ->
+
+    return {
+      __proto__: Rectangle::
+
+      x: x || 0
+      y: y || 0
+
+      width: width || 0
+      height: height || 0
+    } 
+
+  Rectangle:: =
+    center: ->
+      Point(@x + @width / 2, @y + @height / 2)
+
+    equal: (other) ->
+      @x == other.x && @y == other.y &&
+      @width == other.width && @height == other.height
+
+  Rectangle::__defineGetter__ 'left', ->
+    @x
+
+  Rectangle::__defineGetter__ 'right', ->
+    @x + @width
+
+  Rectangle::__defineGetter__ 'top', ->
+    @y
+
+  Rectangle::__defineGetter__ 'bottom', ->
+    @y + @height
+
+  (exports ? this)["Rectangle"] = Rectangle
+)()

data/source/javascripts/_cornerstone/string_extensions.js.coffee

@@ -0,0 +1,232 @@
+###*
+Returns true if this string only contains whitespace characters.
+
+    "".blank()
+    # => true
+    
+    "hello".blank()
+    # => false
+    
+    "   ".blank()
+    # => true
+
+@name blank
+@methodOf String#
+@returns {Boolean} Whether or not this string is blank.
+###
+String::blank = ->
+  /^\s*$/.test(this)
+
+###*
+Returns a new string that is a camelCase version.
+
+    "camel_case".camelize()
+    "camel-case".camelize()
+    "camel case".camelize()
+    
+    # => "camelCase"
+
+@name camelize
+@methodOf String#
+@returns {String} A new string. camelCase version of `this`. 
+###
+String::camelize = ->
+  this.trim().replace /(\-|_|\s)+(.)?/g, (match, separator, chr) ->
+    if chr then chr.toUpperCase() else ''
+
+###*
+Returns a new string with the first letter capitalized and the rest lower cased.
+
+    "capital".capitalize()
+    "cAPITAL".capitalize()
+    "cApItAl".capitalize()
+    "CAPITAL".capitalize()
+    
+    # => "Capital"
+
+@name capitalize
+@methodOf String#
+@returns {String} A new string. Capitalized version of `this`
+###
+String::capitalize = ->
+  this.charAt(0).toUpperCase() + this.substring(1).toLowerCase()
+
+###*
+Return the class or constant named in this string.
+
+    
+    "Constant".constantize()
+    # => Constant
+    # notice this isn't a string. Useful for calling methods on class with the same name as `this`.
+
+@name constantize
+@methodOf String#
+@returns {Object} The class or constant named in this string.
+###
+String::constantize = ->
+  target = exports ? window
+
+  target = target[item] for item in this.split '.'
+
+  return target
+
+###*
+Get the file extension of a string.
+
+    "README.md".extension() # => "md"
+    "README".extension() # => ""
+
+@name extension
+@methodOf String#
+@returns {String} File extension
+###
+String::extension = ->
+  if extension = this.match(/\.([^\.]*)$/, '')?.last()
+    extension
+  else
+    ''
+
+###*
+Returns a new string that is a more human readable version.
+
+    "player_id".humanize()
+    # => "Player"
+    
+    "player_ammo".humanize()
+    # => "Player ammo"
+
+@name humanize
+@methodOf String#
+@returns {String} A new string. Replaces _id and _ with "" and capitalizes the word.
+###
+String::humanize = ->
+  this.replace(/_id$/, "").replace(/_/g, " ").capitalize()
+
+###*
+Returns true.
+
+@name isString
+@methodOf String#
+@returns {Boolean} true
+###
+String::isString = ->
+  true
+
+###*
+Parse this string as though it is JSON and return the object it represents. If it
+is not valid JSON returns the string itself.
+
+    # this is valid json, so an object is returned
+    '{"a": 3}'.parse()
+    # => {a: 3}
+    
+    # double quoting instead isn't valid JSON so a string is returned
+    "{'a': 3}".parse()
+    # => "{'a': 3}"
+    
+
+@name parse
+@methodOf String#
+@returns {Object} Returns an object from the JSON this string contains. If it is not valid JSON returns the string itself.
+###
+String::parse = () ->
+  try
+    JSON.parse(this.toString())
+  catch e
+    this.toString()
+
+###*
+Returns true if this string starts with the given string.
+
+@name startsWith
+@methodOf String#
+@param {String} str The string to check.
+
+@returns {Boolean} True if this string starts with the given string, false otherwise.
+###
+String::startsWith = (str) ->
+  @lastIndexOf(str, 0) is 0
+
+###*
+Returns a new string in Title Case.
+
+    "title-case".titleize()
+    # => "Title Case"
+    
+    "title case".titleize()
+    # => "Title Case"
+
+@name titleize
+@methodOf String#
+@returns {String} A new string. Title Cased.
+###
+String::titleize = ->
+  this.split(/[- ]/).map (word) ->
+    word.capitalize()
+  .join(' ')
+
+###*
+Underscore a word, changing camelCased with under_scored.
+
+    "UNDERScore".underscore()
+    # => "under_score"
+    
+    "UNDER-SCORE".underscore()
+    # => "under_score"
+    
+    "UnDEr-SCorE".underscore()
+    # => "un_d_er_s_cor_e"
+
+@name underscore
+@methodOf String#
+@returns {String} A new string. Separated by _.
+###
+String::underscore = ->
+  this.replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
+    .replace(/([a-z\d])([A-Z])/g, '$1_$2')
+    .replace(/-/g, '_')
+    .toLowerCase()
+
+###*
+Assumes the string is something like a file name and returns the 
+contents of the string without the extension.
+
+    "neat.png".witouthExtension() 
+    # => "neat"
+
+@name withoutExtension
+@methodOf String#
+@returns {String} A new string without the extension name.
+###
+String::withoutExtension = ->
+  this.replace(/\.[^\.]*$/, '')
+
+String::parseHex = ->
+  hexString = @replace(/#/, '')
+
+  switch hexString.length
+    when 3, 4
+      if hexString.length == 4
+        alpha = ((parseInt(hexString.substr(3, 1), 16) * 0x11) / 255)
+      else
+        alpha = 1
+
+      rgb = (parseInt(hexString.substr(i, 1), 16) * 0x11 for i in [0..2])      
+      rgb.push(alpha)    
+
+      return rgb
+
+    when 6, 8
+      if hexString.length == 8
+        alpha = (parseInt(hexString.substr(6, 2), 16) / 255)
+      else
+        alpha = 1
+
+      rgb = (parseInt(hexString.substr(2 * i, 2), 16) for i in [0..2])          
+      rgb.push(alpha)
+
+      return rgb
+
+    else
+      return undefined
+

data/source/javascripts/_cornerstone/stubs.js.coffee

@@ -0,0 +1,1042 @@
+###*
+Returns a string representing the specified Boolean object.
+
+<code><em>bool</em>.toString()</code>
+
+@name toString
+@methodOf Boolean#
+###
+###*
+Returns the primitive value of a Boolean object.
+
+<code><em>bool</em>.valueOf()</code>
+
+@name valueOf
+@methodOf Boolean#
+###
+###*
+Returns a string representing the Number object in exponential notation
+
+<code><i>number</i>.toExponential( [<em>fractionDigits</em>] )</code>
+@param  fractionDigits
+An integer specifying the number of digits after the decimal point. Defaults
+to as many digits as necessary to specify the number.
+@name toExponential
+@methodOf Number#
+###
+###*
+Formats a number using fixed-point notation
+
+<code><i>number</i>.toFixed( [<em>digits</em>] )</code>
+@param  digits   The number of digits to appear after the decimal point; this
+may be a value between 0 and 20, inclusive, and implementations may optionally
+support a larger range of values. If this argument is omitted, it is treated as
+0.
+@name toFixed
+@methodOf Number#
+###
+###*
+number.toLocaleString();
+
+@name toLocaleString
+@methodOf Number#
+###
+###*
+Returns a string representing the Number object to the specified precision. 
+
+<code><em>number</em>.toPrecision( [ <em>precision</em> ] )</code>
+@param precision An integer specifying the number of significant digits.
+@name toPrecision
+@methodOf Number#
+###
+
+###*
+Returns a string representing the specified Number object
+
+<code><i>number</i>.toString( [<em>radix</em>] )</code>
+@param  radix
+An integer between 2 and 36 specifying the base to use for representing
+numeric values.
+@name toString
+@methodOf Number#
+###
+###*
+Returns the primitive value of a Number object.
+
+@name valueOf
+@methodOf Number#
+###
+###*
+Returns the specified character from a string.
+
+<code><em>string</em>.charAt(<em>index</em>)</code>
+@param index  An integer between 0 and 1 less than the length of the string.
+@name charAt
+@methodOf String#
+###
+###*
+Returns the numeric Unicode value of the character at the given index (except
+for unicode codepoints > 0x10000).
+
+
+@param index  An integer greater than 0 and less than the length of the string;
+if it is not a number, it defaults to 0.
+@name charCodeAt
+@methodOf String#
+###
+###*
+Combines the text of two or more strings and returns a new string.
+
+<code><em>string</em>.concat(<em>string2</em>, <em>string3</em>[, ..., <em>stringN</em>])</code>
+@param string2...stringN  Strings to concatenate to this string.
+@name concat
+@methodOf String#
+###
+###*
+Returns the index within the calling String object of the first occurrence of
+the specified value, starting the search at fromIndex,
+returns -1 if the value is not found.
+
+<code><em>string</em>.indexOf(<em>searchValue</em>[, <em>fromIndex</em>]</code>
+@param searchValue  A string representing the value to search for.
+@param fromIndex  The location within the calling string to start the search
+from. It can be any integer between 0 and the length of the string. The default
+value is 0.
+@name indexOf
+@methodOf String#
+###
+###*
+Returns the index within the calling String object of the last occurrence of the
+specified value, or -1 if not found. The calling string is searched backward,
+starting at fromIndex.
+
+<code><em>string</em>.lastIndexOf(<em>searchValue</em>[, <em>fromIndex</em>])</code>
+@param searchValue  A string representing the value to search for.
+@param fromIndex  The location within the calling string to start the search
+from, indexed from left to right. It can be any integer between 0 and the length
+of the string. The default value is the length of the string.
+@name lastIndexOf
+@methodOf String#
+###
+###*
+Returns a number indicating whether a reference string comes before or after or
+is the same as the given string in sort order.
+
+<code> localeCompare(compareString) </code>
+
+@name localeCompare
+@methodOf String#
+###
+###*
+Used to retrieve the matches when matching a string against a regular
+expression.
+
+<code><em>string</em>.match(<em>regexp</em>)</code>
+@param regexp A regular expression object. If a non-RegExp object obj is passed,
+it is implicitly converted to a RegExp by using new RegExp(obj).
+@name match
+@methodOf String#
+###
+
+###*
+Returns a new string with some or all matches of a pattern replaced by a
+replacement.  The pattern can be a string or a RegExp, and the replacement can
+be a string or a function to be called for each match.
+
+<code><em>str</em>.replace(<em>regexp|substr</em>, <em>newSubStr|function[</em>, </code><code><em>flags]</em>);</code>
+@param regexp  A RegExp object. The match is replaced by the return value of
+parameter #2.
+@param substr  A String that is to be replaced by newSubStr.
+@param newSubStr  The String that replaces the substring received from parameter
+#1. A number of special replacement patterns are supported; see the "Specifying
+a string as a parameter" section below.
+@param function  A function to be invoked to create the new substring (to put in
+place of the substring received from parameter #1). The arguments supplied to
+this function are described in the "Specifying a function as a parameter"
+section below.
+@param flags gimy 
+
+Non-standardThe use of the flags parameter in the String.replace method is
+non-standard. For cross-browser compatibility, use a RegExp object with
+corresponding flags.A string containing any combination of the RegExp flags: g
+global match i ignore case m match over multiple lines y Non-standard     
+sticky global matchignore casematch over multiple linesNon-standard     sticky
+@name replace
+@methodOf String#
+###
+###*
+Executes the search for a match between a regular expression and this String
+object.
+
+<code><em>string</em>.search(<em>regexp</em>)</code>
+@param regexp  A  regular expression object. If a non-RegExp object obj is
+passed, it is implicitly converted to a RegExp by using new RegExp(obj).
+@name search
+@methodOf String#
+###
+###*
+Extracts a section of a string and returns a new string.
+
+<code><em>string</em>.slice(<em>beginslice</em>[, <em>endSlice</em>])</code>
+@param beginSlice  The zero-based index at which to begin extraction.
+@param endSlice  The zero-based index at which to end extraction. If omitted,
+slice extracts to the end of the string.
+@name slice
+@methodOf String#
+###
+###*
+Splits a String object into an array of strings by separating the string into
+substrings.
+
+<code><em>string</em>.split([<em>separator</em>][, <em>limit</em>])</code>
+@param separator  Specifies the character to use for separating the string. The
+separator is treated as a string or a regular expression. If separator is
+omitted, the array returned contains one element consisting of the entire
+string.
+@param limit  Integer specifying a limit on the number of splits to be found.
+@name split
+@methodOf String#
+###
+###*
+Returns the characters in a string beginning at the specified location through
+the specified number of characters.
+
+<code><em>string</em>.substr(<em>start</em>[, <em>length</em>])</code>
+@param start  Location at which to begin extracting characters.
+@param length  The number of characters to extract.
+@name substr
+@methodOf String#
+###
+###*
+Returns a subset of a string between one index and another, or through the end
+of the string.
+
+<code><em>string</em>.substring(<em>indexA</em>[, <em>indexB</em>])</code>
+@param indexA  An integer between 0 and one less than the length of the string.
+@param indexB  (optional) An integer between 0 and the length of the string.
+@name substring
+@methodOf String#
+###
+###*
+Returns the calling string value converted to lower case, according to any
+locale-specific case mappings.
+
+<code> toLocaleLowerCase() </code>
+
+@name toLocaleLowerCase
+@methodOf String#
+###
+###*
+Returns the calling string value converted to upper case, according to any
+locale-specific case mappings.
+
+<code> toLocaleUpperCase() </code>
+
+@name toLocaleUpperCase
+@methodOf String#
+###
+###*
+Returns the calling string value converted to lowercase.
+
+<code><em>string</em>.toLowerCase()</code>
+
+@name toLowerCase
+@methodOf String#
+###
+
+###*
+Returns a string representing the specified object.
+
+<code><em>string</em>.toString()</code>
+
+@name toString
+@methodOf String#
+###
+###*
+Returns the calling string value converted to uppercase.
+
+<code><em>string</em>.toUpperCase()</code>
+
+@name toUpperCase
+@methodOf String#
+###
+###*
+Removes whitespace from both ends of the string.
+
+<code><em>string</em>.trim()</code>
+
+@name trim
+@methodOf String#
+###
+
+###*
+Returns the primitive value of a String object.
+
+<code><em>string</em>.valueOf()</code>
+
+@name valueOf
+@methodOf String#
+###
+###*
+Removes the last element from an array and returns that element.
+
+<code>
+<i>array</i>.pop()
+</code>
+
+@name pop
+@methodOf Array#
+###
+###*
+Mutates an array by appending the given elements and returning the new length of
+the array.
+
+<code><em>array</em>.push(<em>element1</em>, ..., <em>elementN</em>)</code>
+@param element1, ..., elementN The elements to add to the end of the array.
+@name push
+@methodOf Array#
+###
+###*
+Reverses an array in place.  The first array element becomes the last and the
+last becomes the first.
+
+<code><em>array</em>.reverse()</code>
+
+@name reverse
+@methodOf Array#
+###
+###*
+Removes the first element from an array and returns that element. This method
+changes the length of the array.
+
+<code><em>array</em>.shift()</code>
+
+@name shift
+@methodOf Array#
+###
+###*
+Sorts the elements of an array in place.
+
+<code><em>array</em>.sort([<em>compareFunction</em>])</code>
+@param compareFunction  Specifies a function that defines the sort order. If
+omitted, the array is sorted lexicographically (in dictionary order) according
+to the string conversion of each element.
+@name sort
+@methodOf Array#
+###
+###*
+Changes the content of an array, adding new elements while removing old
+elements.
+
+<code><em>array</em>.splice(<em>index</em>, <em>howMany</em>[, <em>element1</em>[, ...[, <em>elementN</em>]]])</code>
+@param index  Index at which to start changing the array. If negative, will
+begin that many elements from the end.
+@param howMany  An integer indicating the number of old array elements to
+remove. If howMany is 0, no elements are removed. In this case, you should
+specify at least one new element. If no howMany parameter is specified (second
+syntax above, which is a SpiderMonkey extension), all elements after index are
+removed.
+@param element1, ..., elementN  The elements to add to the array. If you don't
+specify any elements, splice simply removes elements from the array.
+@name splice
+@methodOf Array#
+###
+###*
+Adds one or more elements to the beginning of an array and returns the new
+length of the array.
+
+<code><em>arrayName</em>.unshift(<em>element1</em>, ..., <em>elementN</em>) </code>
+@param element1, ..., elementN The elements to add to the front of the array.
+@name unshift
+@methodOf Array#
+###
+###*
+Returns a new array comprised of this array joined with other array(s) and/or
+value(s).
+
+<code><em>array</em>.concat(<em>value1</em>, <em>value2</em>, ..., <em>valueN</em>)</code>
+@param valueN  Arrays and/or values to concatenate to the resulting array.
+@name concat
+@methodOf Array#
+###
+###*
+Joins all elements of an array into a string.
+
+<code><em>array</em>.join(<em>separator</em>)</code>
+@param separator  Specifies a string to separate each element of the array. The
+separator is converted to a string if necessary. If omitted, the array elements
+are separated with a comma.
+@name join
+@methodOf Array#
+###
+###*
+Returns a one-level deep copy of a portion of an array.
+
+<code><em>array</em>.slice(<em>begin</em>[, <em>end</em>])</code>
+@param begin  Zero-based index at which to begin extraction.As a negative index,
+start indicates an offset from the end of the sequence. slice(-2) extracts the
+second-to-last element and the last element in the sequence.
+@param end  Zero-based index at which to end extraction. slice extracts up to
+but not including end.slice(1,4) extracts the second element through the fourth
+element (elements indexed 1, 2, and 3).As a negative index, end indicates an
+offset from the end of the sequence. slice(2,-1) extracts the third element
+through the second-to-last element in the sequence.If end is omitted, slice
+extracts to the end of the sequence.
+@name slice
+@methodOf Array#
+###
+
+###*
+Returns a string representing the specified array and its elements.
+
+<code><em>array</em>.toString()</code>
+
+@name toString
+@methodOf Array#
+###
+###*
+Returns the first index at which a given element can be found in the array, or
+-1 if it is not present.
+
+<code><em>array</em>.indexOf(<em>searchElement</em>[, <em>fromIndex</em>])</code>
+@param searchElement fromIndex  Element to locate in the array.The index at
+which to begin the search. Defaults to 0, i.e. the whole array will be searched.
+If the index is greater than or equal to the length of the array, -1 is
+returned, i.e. the array will not be searched. If negative, it is taken as the
+offset from the end of the array. Note that even when the index is negative, the
+array is still searched from front to back. If the calculated index is less than
+0, the whole array will be searched.
+@name indexOf
+@methodOf Array#
+###
+###*
+Returns the last index at which a given element can be found in the array, or -1
+if it is not present. The array is searched backwards, starting at fromIndex.
+
+<code><em>array</em>.lastIndexOf(<em>searchElement</em>[, <em>fromIndex</em>])</code>
+@param searchElement fromIndex  Element to locate in the array.The index at
+which to start searching backwards. Defaults to the array's length, i.e. the
+whole array will be searched. If the index is greater than or equal to the
+length of the array, the whole array will be searched. If negative, it is taken
+as the offset from the end of the array. Note that even when the index is
+negative, the array is still searched from back to front. If the calculated
+index is less than 0, -1 is returned, i.e. the array will not be searched.
+@name lastIndexOf
+@methodOf Array#
+###
+###*
+Creates a new array with all elements that pass the test implemented by the
+provided function.
+
+<code><em>array</em>.filter(<em>callback</em>[, <em>thisObject</em>])</code>
+@param callback thisObject  Function to test each element of the array.Object to
+use as this when executing callback.
+@name filter
+@methodOf Array#
+###
+###*
+Executes a provided function once per array element.
+
+<code><em>array</em>.forEach(<em>callback</em>[, <em>thisObject</em>])</code>
+@param callback thisObject  Function to execute for each element.Object to use
+as this when executing callback.
+@name forEach
+@methodOf Array#
+###
+###*
+Tests whether all elements in the array pass the test implemented by the
+provided function.
+
+<code><em>array</em>.every(<em>callback</em>[, <em>thisObject</em>])</code>
+@param callbackthisObject Function to test for each element.Object to use as
+this when executing callback.
+@name every
+@methodOf Array#
+###
+###*
+Creates a new array with the results of calling a provided function on every
+element in this array.
+
+<code><em>array</em>.map(<em>callback</em>[, <em>thisObject</em>])</code>
+@param callbackthisObject Function that produces an element of the new Array
+from an element of the current one.Object to use as this when executing
+callback.
+@name map
+@methodOf Array#
+###
+###*
+Tests whether some element in the array passes the test implemented by the
+provided function.
+
+<code><em>array</em>.some(<em>callback</em>[, <em>thisObject</em>])</code>
+@param callback thisObject  Function to test for each element.Object to use as
+this when executing callback.
+@name some
+@methodOf Array#
+###
+###*
+Apply a function against an accumulator and each value of the array (from
+left-to-right) as to reduce it to a single value.
+
+<code><em>array</em>.reduce(<em>callback</em>[, <em>initialValue</em>])</code>
+@param callbackinitialValue Function to execute on each value in the
+array.Object to use as the first argument to the first call of the callback.
+@name reduce
+@methodOf Array#
+###
+###*
+Apply a function simultaneously against two values of the array (from
+right-to-left) as to reduce it to a single value.
+
+<code><em>array</em>.reduceRight(<em>callback</em>[, <em>initialValue</em>])</code>
+@param callback initialValue  Function to execute on each value in the
+array.Object to use as the first argument to the first call of the callback.
+@name reduceRight
+@methodOf Array#
+###
+###*
+Returns a boolean indicating whether the object has the specified property.
+
+<code><em>obj</em>.hasOwnProperty(<em>prop</em>)</code>
+@param prop The name of the property to test.
+@name hasOwnProperty
+@methodOf Object#
+###
+###*
+Calls a function with a given this value and arguments provided as an array.
+
+<code><em>fun</em>.apply(<em>thisArg</em>[, <em>argsArray</em>])</code>
+@param thisArg  Determines the value of this inside fun. If thisArg is null or
+undefined, this will be the global object. Otherwise, this will be equal to
+Object(thisArg) (which is thisArg if thisArg is already an object, or a String,
+Boolean, or Number if thisArg is a primitive value of the corresponding type).
+Therefore, it is always true that typeof this == "object" when the function
+executes.
+@param argsArray  An argument array for the object, specifying the arguments
+with which fun should be called, or null or undefined if no arguments should be
+provided to the function.
+@name apply
+@methodOf Function#
+###
+###*
+Creates a new function that, when called, itself calls this function in the
+context of the provided this value, with a given sequence of arguments preceding
+any provided when the new function was called.
+
+<code><em>fun</em>.bind(<em>thisArg</em>[, <em>arg1</em>[, <em>arg2</em>[, ...]]])</code>
+@param thisValuearg1, arg2, ... The value to be passed as the this parameter to
+the target function when the bound function is called.  The value is ignored if
+the bound function is constructed using the new operator.Arguments to prepend to
+arguments provided to the bound function when invoking the target function.
+@name bind
+@methodOf Function#
+###
+###*
+Calls a function with a given this value and arguments provided individually.
+
+<code><em>fun</em>.call(<em>thisArg</em>[, <em>arg1</em>[, <em>arg2</em>[, ...]]])</code>
+@param thisArg  Determines the value of this inside fun. If thisArg is null or
+undefined, this will be the global object. Otherwise, this will be equal to
+Object(thisArg) (which is thisArg if thisArg is already an object, or a String,
+Boolean, or Number if thisArg is a primitive value of the corresponding type).
+Therefore, it is always true that typeof this == "object" when the function
+executes.
+@param arg1, arg2, ...  Arguments for the object.
+@name call
+@methodOf Function#
+###
+
+###*
+Returns a string representing the source code of the function.
+
+<code><em>function</em>.toString(<em>indentation</em>)</code>
+@param indentation Non-standard     The amount of spaces to indent the string
+representation of the source code. If indentation is less than or equal to -1,
+most unnecessary spaces are removed.
+@name toString
+@methodOf Function#
+###
+###*
+Executes a search for a match in a specified string. Returns a result array, or
+null.
+
+
+@param regexp  The name of the regular expression. It can be a variable name or
+a literal.
+@param str  The string against which to match the regular expression.
+@name exec
+@methodOf RegExp#
+###
+###*
+Executes the search for a match between a regular expression and a specified
+string. Returns true or false.
+
+<code> <em>regexp</em>.test([<em>str</em>]) </code>
+@param regexp  The name of the regular expression. It can be a variable name or
+a literal.
+@param str  The string against which to match the regular expression.
+@name test
+@methodOf RegExp#
+###
+
+###*
+Returns a string representing the specified object.
+
+<code><i>regexp</i>.toString()</code>
+
+@name toString
+@methodOf RegExp#
+###
+###*
+Returns a reference to the Date function that created the instance's prototype.
+Note that the value of this property is a reference to the function itself, not
+a string containing the function's name.
+
+
+
+@name constructor
+@methodOf Date#
+###
+###*
+Returns the day of the month for the specified date according to local time.
+
+<code>
+getDate()
+</code>
+
+@name getDate
+@methodOf Date#
+###
+###*
+Returns the day of the week for the specified date according to local time.
+
+<code>
+getDay()
+</code>
+
+@name getDay
+@methodOf Date#
+###
+###*
+Returns the year of the specified date according to local time.
+
+<code>
+getFullYear()
+</code>
+
+@name getFullYear
+@methodOf Date#
+###
+###*
+Returns the hour for the specified date according to local time.
+
+<code>
+getHours()
+</code>
+
+@name getHours
+@methodOf Date#
+###
+###*
+Returns the milliseconds in the specified date according to local time.
+
+<code>
+getMilliseconds()
+</code>
+
+@name getMilliseconds
+@methodOf Date#
+###
+###*
+Returns the minutes in the specified date according to local time.
+
+<code>
+getMinutes()
+</code>
+
+@name getMinutes
+@methodOf Date#
+###
+###*
+Returns the month in the specified date according to local time.
+
+<code>
+getMonth()
+</code>
+
+@name getMonth
+@methodOf Date#
+###
+###*
+Returns the seconds in the specified date according to local time.
+
+<code>
+getSeconds()
+</code>
+
+@name getSeconds
+@methodOf Date#
+###
+###*
+Returns the numeric value corresponding to the time for the specified date
+according to universal time.
+
+<code> getTime() </code>
+
+@name getTime
+@methodOf Date#
+###
+###*
+Returns the time-zone offset from UTC, in minutes, for the current locale.
+
+<code> getTimezoneOffset() </code>
+
+@name getTimezoneOffset
+@methodOf Date#
+###
+###*
+Returns the day (date) of the month in the specified date according to universal
+time.
+
+<code>
+getUTCDate()
+</code>
+
+@name getUTCDate
+@methodOf Date#
+###
+###*
+Returns the day of the week in the specified date according to universal time.
+
+<code>
+getUTCDay()
+</code>
+
+@name getUTCDay
+@methodOf Date#
+###
+###*
+Returns the year in the specified date according to universal time.
+
+<code>
+getUTCFullYear()
+</code>
+
+@name getUTCFullYear
+@methodOf Date#
+###
+###*
+Returns the hours in the specified date according to universal time.
+
+<code>
+getUTCHours
+</code>
+
+@name getUTCHours
+@methodOf Date#
+###
+###*
+Returns the milliseconds in the specified date according to universal time.
+
+<code>
+getUTCMilliseconds()
+</code>
+
+@name getUTCMilliseconds
+@methodOf Date#
+###
+###*
+Returns the minutes in the specified date according to universal time.
+
+<code>
+getUTCMinutes()
+</code>
+
+@name getUTCMinutes
+@methodOf Date#
+###
+###*
+Returns the month of the specified date according to universal time.
+
+<code>
+getUTCMonth()
+</code>
+
+@name getUTCMonth
+@methodOf Date#
+###
+###*
+Returns the seconds in the specified date according to universal time.
+
+<code>
+getUTCSeconds()
+</code>
+
+@name getUTCSeconds
+@methodOf Date#
+###
+
+###*
+Sets the day of the month for a specified date according to local time.
+
+<code> setDate(<em>dayValue</em>) </code>
+@param dayValue  An integer from 1 to 31, representing the day of the month.
+@name setDate
+@methodOf Date#
+###
+###*
+Sets the full year for a specified date according to local time.
+
+<code>
+setFullYear(<i>yearValue</i>[, <i>monthValue</i>[, <em>dayValue</em>]])
+</code>
+@param  yearValue   An integer specifying the numeric value of the year, for
+example, 1995.
+@param  monthValue   An integer between 0 and 11 representing the months January
+through December.
+@param  dayValue   An integer between 1 and 31 representing the day of the
+month. If you specify the dayValue parameter, you must also specify the
+monthValue.
+@name setFullYear
+@methodOf Date#
+###
+###*
+Sets the hours for a specified date according to local time.
+
+<code>
+setHours(<i>hoursValue</i>[, <i>minutesValue</i>[, <i>secondsValue</i>[, <em>msValue</em>]]])
+</code>
+@param  hoursValue   An integer between 0 and 23, representing the hour. 
+@param  minutesValue   An integer between 0 and 59, representing the minutes. 
+@param  secondsValue   An integer between 0 and 59, representing the seconds. If
+you specify the secondsValue parameter, you must also specify the minutesValue.
+@param  msValue   A number between 0 and 999, representing the milliseconds. If
+you specify the msValue parameter, you must also specify the minutesValue and
+secondsValue.
+@name setHours
+@methodOf Date#
+###
+###*
+Sets the milliseconds for a specified date according to local time.
+
+<code>
+setMilliseconds(<i>millisecondsValue</i>)
+</code>
+@param  millisecondsValue   A number between 0 and 999, representing the
+milliseconds.
+@name setMilliseconds
+@methodOf Date#
+###
+###*
+Sets the minutes for a specified date according to local time.
+
+<code>
+setMinutes(<i>minutesValue</i>[, <i>secondsValue</i>[, <em>msValue</em>]])
+</code>
+@param  minutesValue   An integer between 0 and 59, representing the minutes. 
+@param  secondsValue   An integer between 0 and 59, representing the seconds. If
+you specify the secondsValue parameter, you must also specify the minutesValue.
+@param  msValue   A number between 0 and 999, representing the milliseconds. If
+you specify the msValue parameter, you must also specify the minutesValue and
+secondsValue.
+@name setMinutes
+@methodOf Date#
+###
+###*
+Set the month for a specified date according to local time.
+
+<code>
+setMonth(<i>monthValue</i>[, <em>dayValue</em>])
+</code>
+@param  monthValue   An integer between 0 and 11 (representing the months
+January through December).
+@param  dayValue   An integer from 1 to 31, representing the day of the month.
+@name setMonth
+@methodOf Date#
+###
+###*
+Sets the seconds for a specified date according to local time.
+
+<code>
+setSeconds(<i>secondsValue</i>[, <em>msValue</em>])
+</code>
+@param  secondsValue   An integer between 0 and 59. 
+@param  msValue   A number between 0 and 999, representing the milliseconds.
+@name setSeconds
+@methodOf Date#
+###
+###*
+Sets the Date object to the time represented by a number of milliseconds since
+January 1, 1970, 00:00:00 UTC.
+
+<code>
+setTime(<i>timeValue</i>)
+</code>
+@param  timeValue   An integer representing the number of milliseconds since 1
+January 1970, 00:00:00 UTC.
+@name setTime
+@methodOf Date#
+###
+###*
+Sets the day of the month for a specified date according to universal time.
+
+<code>
+setUTCDate(<i>dayValue</i>)
+</code>
+@param  dayValue   An integer from 1 to 31, representing the day of the month.
+@name setUTCDate
+@methodOf Date#
+###
+###*
+Sets the full year for a specified date according to universal time.
+
+<code>
+setUTCFullYear(<i>yearValue</i>[, <i>monthValue</i>[, <em>dayValue</em>]])
+</code>
+@param  yearValue   An integer specifying the numeric value of the year, for
+example, 1995.
+@param  monthValue   An integer between 0 and 11 representing the months January
+through December.
+@param  dayValue   An integer between 1 and 31 representing the day of the
+month. If you specify the dayValue parameter, you must also specify the
+monthValue.
+@name setUTCFullYear
+@methodOf Date#
+###
+###*
+Sets the hour for a specified date according to universal time.
+
+<code>
+setUTCHours(<i>hoursValue</i>[, <i>minutesValue</i>[, <i>secondsValue</i>[, <em>msValue</em>]]])
+</code>
+@param  hoursValue   An integer between 0 and 23, representing the hour. 
+@param  minutesValue   An integer between 0 and 59, representing the minutes. 
+@param  secondsValue   An integer between 0 and 59, representing the seconds. If
+you specify the secondsValue parameter, you must also specify the minutesValue.
+@param  msValue   A number between 0 and 999, representing the milliseconds. If
+you specify the msValue parameter, you must also specify the minutesValue and
+secondsValue.
+@name setUTCHours
+@methodOf Date#
+###
+###*
+Sets the milliseconds for a specified date according to universal time.
+
+<code>
+setUTCMilliseconds(<i>millisecondsValue</i>)
+</code>
+@param  millisecondsValue   A number between 0 and 999, representing the
+milliseconds.
+@name setUTCMilliseconds
+@methodOf Date#
+###
+###*
+Sets the minutes for a specified date according to universal time.
+
+<code>
+setUTCMinutes(<i>minutesValue</i>[, <i>secondsValue</i>[, <em>msValue</em>]])
+</code>
+@param  minutesValue   An integer between 0 and 59, representing the minutes. 
+@param  secondsValue   An integer between 0 and 59, representing the seconds. If
+you specify the secondsValue parameter, you must also specify the minutesValue.
+@param  msValue   A number between 0 and 999, representing the milliseconds. If
+you specify the msValue parameter, you must also specify the minutesValue and
+secondsValue.
+@name setUTCMinutes
+@methodOf Date#
+###
+###*
+Sets the month for a specified date according to universal time.
+
+<code>
+setUTCMonth(<i>monthValue</i>[, <em>dayValue</em>])
+</code>
+@param  monthValue   An integer between 0 and 11, representing the months
+January through December.
+@param  dayValue   An integer from 1 to 31, representing the day of the month.
+@name setUTCMonth
+@methodOf Date#
+###
+###*
+Sets the seconds for a specified date according to universal time.
+
+<code>
+setUTCSeconds(<i>secondsValue</i>[, <em>msValue</em>])
+</code>
+@param  secondsValue   An integer between 0 and 59. 
+@param  msValue   A number between 0 and 999, representing the milliseconds.
+@name setUTCSeconds
+@methodOf Date#
+###
+###*
+Returns the date portion of a Date object in human readable form in American
+English.
+
+<code><em>date</em>.toDateString()</code>
+
+@name toDateString
+@methodOf Date#
+###
+###*
+Returns a JSON representation of the Date object.
+
+<code><em>date</em>.prototype.toJSON()</code>
+
+@name toJSON
+@methodOf Date#
+###
+###*
+Converts a date to a string, returning the "date" portion using the operating
+system's locale's conventions.
+
+<code>
+toLocaleDateString()
+</code>
+
+@name toLocaleDateString
+@methodOf Date#
+###
+###*
+Converts a date to a string, using the operating system's locale's conventions.
+
+<code>
+toLocaleString()
+</code>
+
+@name toLocaleString
+@methodOf Date#
+###
+###*
+Converts a date to a string, returning the "time" portion using the current
+locale's conventions.
+
+<code> toLocaleTimeString() </code>
+
+@name toLocaleTimeString
+@methodOf Date#
+###
+###*
+Returns a string representing the specified Date object.
+
+<code> toString() </code>
+
+@name toString
+@methodOf Date#
+###
+###*
+Returns the time portion of a Date object in human readable form in American
+English.
+
+<code><em>date</em>.toTimeString()</code>
+
+@name toTimeString
+@methodOf Date#
+###
+###*
+Converts a date to a string, using the universal time convention.
+
+<code> toUTCString() </code>
+
+@name toUTCString
+@methodOf Date#
+###