update documentation example
This commit is contained in:
parent
a071d541de
commit
d41e12de2f
1 changed files with 18 additions and 12 deletions
|
@ -68,8 +68,8 @@ My.favorites <object> ...
|
|||
regexp <r> My favorite regular expression
|
||||
string <s> My favorite string
|
||||
undefined <u> Undefined is an all-time favorite
|
||||
window <w> ...
|
||||
other <+> ...
|
||||
window <w> So is the DOM window
|
||||
other <+> And the document
|
||||
any <*> Favorite of the day
|
||||
# Events -------------------------------------------------------------------
|
||||
event <!> Fires when My.favorite['function'] is called
|
||||
|
@ -95,7 +95,9 @@ My.favorites = (function() {
|
|||
other: document
|
||||
},
|
||||
keys = Object.keys(favorites);
|
||||
favorites.any = favorites[keys[Math.floor(Math.random() * keys.length)]];
|
||||
favorites.any = favorites[
|
||||
keys[Math.floor(+new Date / 86400) * keys.length]
|
||||
];
|
||||
return favorites;
|
||||
}());
|
||||
|
||||
|
@ -103,7 +105,7 @@ My.favorites = (function() {
|
|||
Documentation can be nested. In other words, one can document the properties of
|
||||
a property (of a property...). Also, if all elements of an array are of a known
|
||||
type (in this case `string`), one can mark the type as `<[s]>` instead of just
|
||||
`<array>`.
|
||||
`<a>`.
|
||||
*/
|
||||
/*@
|
||||
My.HTMLUtils <o> HTML Utilities
|
||||
|
@ -153,9 +155,9 @@ function's signature, return value and arguments. Signature and return value are
|
|||
just a special case of `name <type> summary`, where `name` has the form
|
||||
`(arguments) ->`. If an item can be of more than one type (in this case `string`
|
||||
or `function`), this is documented as `<s|f>`. If it has a default value (in
|
||||
this case the string `'GET'`), this is documented as `<s|'GET'>`. In the case of
|
||||
a `function`-type argument (usually a callback function), there is no return
|
||||
value to document, only the arguments it gets passed.
|
||||
this case the string `'GET'`), this is documented as `<s|'GET'>`. For a
|
||||
`function`-type argument (usually a callback function), there is no return value
|
||||
to document, only the arguments it gets passed.
|
||||
*/
|
||||
/*@
|
||||
My.readURL <f> Asynchronously reads a remote resource
|
||||
|
@ -239,8 +241,8 @@ My.range = function() {
|
|||
};
|
||||
|
||||
/*
|
||||
In case a function has a property or method one wants to document, it gets
|
||||
prefixed with `.`, in order to differentiate it from an argument.
|
||||
In case a function has properties or methods that need documentation, they get
|
||||
prefixed with `.`, in order to differentiate them from arguments.
|
||||
*/
|
||||
/*@
|
||||
My.localStorage <f> Returns a localStorage handler for a given namespace
|
||||
|
@ -362,8 +364,14 @@ My.Box = function(options, self) {
|
|||
return that;
|
||||
};
|
||||
|
||||
/*
|
||||
If an object extends or inherits from another one, one can specify its "class"
|
||||
(i.e. the name of the constuctor of the object it inherits from). Here,
|
||||
`My.ExtendedBox` extends `My.Box`. All events and properties of the latter,
|
||||
unless redefined will, be present on the former
|
||||
*/
|
||||
/*@
|
||||
My.ExtendedBox <f> ...
|
||||
My.ExtendedBox <f> An extended box with random color
|
||||
options <o> Options
|
||||
height <n> Height in px
|
||||
width <n> Width in px
|
||||
|
@ -382,8 +390,6 @@ My.ExtendedBox = function(options, self) {
|
|||
if (key == 'width' || key == 'height') {
|
||||
setSize();
|
||||
}
|
||||
})
|
||||
.css({
|
||||
});
|
||||
randomize();
|
||||
setSize();
|
||||
|
|
Loading…
Reference in a new issue