old_sql 1.12.0 → 1.13.0

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/Logging.rst

@@ -0,0 +1,348 @@
+.. title:: MochiKit.Logging - we're all tired of alert()
+
+Name
+====
+
+MochiKit.Logging - we're all tired of alert()
+
+
+Synopsis
+========
+
+::
+
+    log("INFO messages are so boring");
+    logDebug("DEBUG messages are even worse");
+    log("good thing I can pass", objects, "conveniently");
+
+
+Description
+===========
+
+MochiKit.Logging steals some ideas from Python's logging module [1]_,
+but completely forgot about the Java [2]_ inspiration. This is a KISS
+module for logging that provides enough flexibility to do just about
+anything via listeners, but without all the cruft.
+
+
+Dependencies
+============
+
+- :mochiref:`MochiKit.Base`
+
+
+Overview
+========
+
+Native Console Logging
+----------------------
+
+As of MochiKit 1.3, the default logger will log all messages to your
+browser's native console. This is currently supported in Safari, Opera
+9, and Firefox when the `FireBug`_ extension is installed. MochiKit
+1.4 adds support for the relevant APIs for Internet Explorer (the
+Debugger and the Atlas framework, see `here`__).
+
+.. __: http://www.nikhilk.net/Entry.aspx?id=93
+.. _`FireBug`: http://www.joehewitt.com/software/firebug/
+
+To disable this behavior::
+
+    MochiKit.Logging.logger.useNativeConsole = false;
+
+
+Bookmarklet Based Debugging
+---------------------------
+
+JavaScript is at a serious disadvantage without a standard console for
+"print" statements. Everything else has one. The closest thing that
+you get in a browser environment is the ``alert`` function, which is
+absolutely evil.
+
+This leaves you with one reasonable solution: do your logging in the
+page somehow. The problem here is that you don't want to clutter the
+page with debugging tools. The solution to that problem is what we
+call BBD, or Bookmarklet Based Debugging [3]_.
+
+Simply create a bookmarklet for
+`javascript:MochiKit.Logging.logger.debuggingBookmarklet()`__, and
+whack it whenever you want to see what's in the logger. Of course,
+this means you must drink the MochiKit.Logging kool-aid. It's tangy
+and sweet, don't worry.
+
+.. __: javascript:MochiKit.Logging.logger.debuggingBookmarklet()
+
+Currently this uses :mochiref:`MochiKit.LoggingPane` if loaded and
+otherwise falls back to ugly ``alert`` messages.
+
+
+API Reference
+=============
+
+Constructors
+------------
+
+:mochidef:`LogMessage(num, level, info)`:
+
+    Properties:
+
+        ``num``:
+            Identifier for the log message
+
+        ``level``:
+            Level of the log message (``"INFO"``, ``"WARN"``,
+            ``"DEBUG"``, etc.)
+
+        ``info``:
+            All other arguments passed to log function as an ``Array``
+
+        ``timestamp``:
+            ``Date`` object timestamping the log message
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger([maxSize])`:
+
+    A basic logger object that has a buffer of recent messages plus a
+    listener dispatch mechanism for "real-time" logging of important
+    messages.
+
+    ``maxSize`` is the maximum number of entries in the log.  If
+    ``maxSize >= 0``, then the log will not buffer more than that many
+    messages. So if you don't like logging at all, be sure to pass
+    ``0``.
+
+    There is a default logger available named "logger", and several of
+    its methods are also global functions:
+
+        ==================  =============
+        ``logger.log``      -> :mochiref:`log`
+        ``logger.debug``    -> :mochiref:`logDebug`
+        ``logger.warning``  -> :mochiref:`logWarning`
+        ``logger.error``    -> :mochiref:`logError`
+        ``logger.fatal``    -> :mochiref:`logFatal`
+        ==================  =============
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.addListener(ident, filter, listener)`:
+
+    Add a listener for log messages.
+
+    ``ident`` is a unique identifier that may be used to remove the
+    listener later on.
+
+    ``filter`` can be one of the following:
+
+        ``null``:
+            ``listener(msg)`` will be called for every log message
+            received.
+
+        ``string``:
+            :mochiref:`logLevelAtLeast(filter)` will be used as the
+            function (see below).
+
+        ``function``:
+            ``filter(msg)`` will be called for every msg, if it
+            returns true then ``listener(msg)`` will be called.
+
+    ``listener`` is a function that takes one argument, a log
+    message. A log message is an object (:mochiref:`LogMessage`
+    instance) that has at least these properties:
+
+        ``num``:
+            A counter that uniquely identifies a log message
+            (per-logger)
+
+        ``level``:
+            A string or number representing the log level. If string,
+            you may want to use ``LogLevel[level]`` for comparison.
+
+        ``info``:
+            An Array of objects passed as additional arguments to the
+            ``log`` function.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.baseLog(level, message[, ...])`:
+
+    The base functionality behind all of the log functions.  The first
+    argument is the log level as a string or number, and all other
+    arguments are used as the info list.
+
+    This function is available partially applied as:
+
+        ==============  =========
+        Logger.debug    'DEBUG'
+        Logger.log      'INFO'
+        Logger.error    'ERROR'
+        Logger.fatal    'FATAL'
+        Logger.warning  'WARNING'
+        ==============  =========
+
+    For the default logger, these are also available as global
+    functions, see the :mochiref:`Logger` constructor documentation
+    for more info.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.clear()`:
+
+    Clear all messages from the message buffer.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.debuggingBookmarklet()`:
+
+    Display the contents of the logger in a useful way for browsers.
+
+    Currently, if :mochiref:`MochiKit.LoggingPane` is loaded, then a
+    pop-up :mochiref:`MochiKit.LoggingPane.LoggingPane` will be
+    used. Otherwise, it will be an alert with
+    :mochiref:`Logger.prototype.getMessageText()`.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.dispatchListeners(msg)`:
+
+    Dispatch a log message to all listeners.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.getMessages([howMany])`:
+
+    Returns a list of messages from the message buffer, ordered
+    from the oldest to the newest message. If ``howMany`` is
+    specified, only the last ``howMany`` messages are returned.
+    Otherwise all messages in the buffer are returned.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.getMessageText([howMany])`:
+
+    Get a string representing up to the last ``howMany`` messages in
+    the message buffer. The default is ``30``.
+
+    The message looks like this::
+
+        LAST {messages.length} MESSAGES:
+          [{msg.num}] {msg.level}: {m.info.join(' ')}
+          [{msg.num}] {msg.level}: {m.info.join(' ')}
+          ...
+
+    If you want some other format, use
+    :mochiref:`Logger.prototype.getMessages` and do it yourself.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`Logger.prototype.removeListener(ident)`:
+
+    Remove a listener using the ident given to
+    :mochiref:`Logger.prototype.addListener`
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+Functions
+---------
+
+:mochidef:`alertListener(msg)`:
+
+    Ultra-obnoxious ``alert(...)`` listener
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`log(message[, info[, ...]])`:
+
+    Log an INFO message to the default logger
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`logDebug(message[, info[, ...]])`:
+
+    Log a DEBUG message to the default logger
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`logError(message[, info[, ...]])`:
+
+    Log an ERROR message to the default logger
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`logFatal(message[, info[, ...]])`:
+
+    Log a FATAL message to the default logger
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`logLevelAtLeast(minLevel)`:
+
+    Return a function that will match log messages whose level is at
+    least minLevel
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`logWarning(message[, info[, ...]])`:
+
+    Log a WARNING message to the default logger
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+See Also
+========
+
+.. [1] Python's logging module: http://docs.python.org/lib/module-logging.html
+.. [2] PEP 282, where they admit all of the Java influence: http://www.python.org/peps/pep-0282.html
+.. [3] Original Bookmarklet Based Debugging blather: http://bob.pythonmac.org/archives/2005/07/03/bookmarklet-based-debugging/
+
+
+Authors
+=======
+
+- Bob Ippolito <bob@redivi.com>
+
+
+Copyright
+=========
+
+Copyright 2005 Bob Ippolito <bob@redivi.com>. This program is
+dual-licensed free software; you can redistribute it and/or modify it
+under the terms of the `MIT License`_ or the `Academic Free License
+v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/LoggingPane.rst

@@ -0,0 +1,128 @@
+.. title:: MochiKit.LoggingPane - Interactive MochiKit.Logging pane
+
+Name
+====
+
+MochiKit.LoggingPane - Interactive MochiKit.Logging pane
+
+
+Synopsis
+========
+
+::
+
+    // open a pop-up window
+    createLoggingPane()
+    // use a div at the bottom of the document
+    createLoggingPane(true);
+
+
+Description
+===========
+
+MochiKit.Logging does not have any browser dependencies and is
+completely unobtrusive. MochiKit.LoggingPane is a browser-based
+colored viewing pane for your :mochiref:`MochiKit.Logging` output that
+can be used as a pop-up or inline.
+
+It also allows for regex and level filtering!  MochiKit.LoggingPane is
+used as the default
+:mochiref:`MochiKit.Logging.debuggingBookmarklet()` if it is loaded.
+
+
+Dependencies
+============
+
+- :mochiref:`MochiKit.Base`
+- :mochiref:`MochiKit.Logging`
+
+
+API Reference
+=============
+
+Constructors
+------------
+
+:mochidef:`LoggingPane(inline=false, logger=MochiKit.Logging.logger)`:
+
+    A listener for a :mochiref:`MochiKit.Logging` logger with an
+    interactive DOM representation.
+
+    If ``inline`` is ``true``, then the ``LoggingPane`` will be a
+    ``DIV`` at the bottom of the document. Otherwise, it will be in a
+    pop-up window with a name based on the calling page's URL. If
+    there is an element in the document with an id of
+    ``_MochiKit_LoggingPane``, it will be used instead of appending a
+    new ``DIV`` to the body.
+
+    ``logger`` is the reference to the
+    :mochiref:`MochiKit.Logging.Logger` to listen to. If not
+    specified, the global default logger is used.
+
+    Properties:
+
+        ``win``:
+            Reference to the pop-up window (``undefined`` if
+            ``inline``)
+
+        ``inline``:
+            ``true`` if the ``LoggingPane`` is inline
+
+        ``colorTable``:
+            An object with property->value mappings for each log level
+            and its color. May also be mutated on
+            ``LoggingPane.prototype`` to affect all instances. For
+            example::
+
+                MochiKit.LoggingPane.LoggingPane.prototype.colorTable = {
+                    DEBUG: "green",
+                    INFO: "black",
+                    WARNING: "blue",
+                    ERROR: "red",
+                    FATAL: "darkred"
+                };
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+:mochidef:`LoggingPane.prototype.closePane()`:
+
+    Close the :mochiref:`LoggingPane` (close the child window, or
+    remove the ``_MochiKit_LoggingPane`` ``DIV`` from the document).
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+Functions
+---------
+
+
+:mochidef:`createLoggingPane(inline=false)`:
+
+    Create or return an existing :mochiref:`LoggingPane` for this
+    document with the given inline setting. This is preferred over
+    using :mochiref:`LoggingPane` directly, as only one
+    :mochiref:`LoggingPane` should be present in a given document.
+
+    *Availability*:
+        Available in MochiKit 1.3.1+
+
+
+Authors
+=======
+
+- Bob Ippolito <bob@redivi.com>
+
+
+Copyright
+=========
+
+Copyright 2005 Bob Ippolito <bob@redivi.com>. This program is
+dual-licensed free software; you can redistribute it and/or modify it
+under the terms of the `MIT License`_ or the `Academic Free License
+v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/Position.rst

@@ -0,0 +1,26 @@
+.. title:: MochiKit.Position - DOM Position manipulation API
+
+Name
+====
+
+MochiKit.Position - DOM Position manipulation API
+
+
+Synopsis
+========
+
+This module is experimental and is present in MochiKit 1.4+ only. No
+functions are currently exported from this module. Documentation is
+forthcoming.
+
+
+Copyright
+=========
+
+Copyright 2005-2006 Bob Ippolito <bob@redivi.com>, and others. 
+This program is dual-licensed free
+software; you can redistribute it and/or modify it under the terms of
+the `MIT License`_ or the `Academic Free License v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php

data/public/javascripts/old_sql/MochiKit-1.4.2/doc/rst/MochiKit/Selector.rst

@@ -0,0 +1,203 @@
+.. title:: MochiKit.Selector - Selecting elements by CSS selector syntax
+
+Name
+====
+
+MochiKit.Selector - Selecting elements by CSS selector syntax
+
+
+Synopsis
+========
+
+::
+
+    MochiKit.Base.map(MochiKit.Visual.fade, $$('p.fademe'));
+
+
+Description
+===========
+
+MochiKit.Selector provides utilities to select elements by CSS
+selector syntax. In particular it provides the :mochiref:`$$`
+function.
+
+Dependencies
+============
+
+- :mochiref:`MochiKit.Base`
+- :mochiref:`MochiKit.DOM`
+- :mochiref:`MochiKit.Iter`
+
+
+Overview
+========
+
+This module provides facilities to select childs of a DOM node by
+using CSS selector syntax. In particular, it provides the 
+:mochiref:`$$` function, which performs such a selection on the
+current document.
+
+Many of CSS3 [1]_ selectors are supported:
+
+- Select by tag name (``A``)
+- Select by class (``.theclass``)
+- Select by id (``#someid``)
+- Combinators
+      - Descendant: ``E F``
+      - Child: ``E > F``
+      - Immediate following sibling: ``E + F``
+      - Following sibling: ``E ~ F`` 
+- Attribute selectors
+      - simple "has attribute" (without operator)
+      - ``=`` equal
+      - ``!=`` not equal (not in CSS std.)
+      - ``~=`` word containment
+      - ``^=`` starts-with
+      - ``$=`` ends-with
+      - ``*=`` substring containment
+      - ``|=`` first part of hyphen deleimited (eg. lang|="en" matches lang="en-US") 
+- Pseudo-classes
+      - ``:nth-child``, ``:nth-last-child``, ``:first-child``, ``:last-child``, ``:only-child``, ``:empty``, ``:enabled``, ``:disabled``, ``:checked``, ``:not(<any other selector>)`` 
+- Deprecated Pseudo-classes (to be removed in 1.5)
+      - ``:root``, ``:nth-of-type``, ``:nth-last-of-type``, ``:first-of-type``, ``:last-of-type``, ``:only-of-type``
+
+Multiple selectors can be concatenated, like this: ``P.quote[author~='Torvalds']``,
+in which case elements matching *all* the selectors are returned. Furthermore, such
+concatenations can be *combined* by joining them with spaces and combinators.
+This invokes the regular CSS behaviour of matching parts of the combination in
+sequence, starting off each part from the elements returned by the preceeding part.
+
+For the ``:nth-*`` pseudoclasses, the ``an+b`` syntax is partially
+supported, specifically a and b must be non-negative and only a is 
+optional (this differs from the CSS std.) Also, ``odd`` and ``even`` 
+are supported, e.g. ``table tr:nth-child(odd)`` gives you every 
+other row of table starting with the first one.
+
+For further documentation of CSS selectors, refer to the W3C CSS standard. [1]_
+
+The original version of this module was ported from Prototype.
+
+**Note:** This module is currently experimental and API stability cannot be
+fully guaranteed. The implementation is scheduled to be replaced with a new
+faster version (now in development) during the MochiKit 1.5 development
+cycle.
+
+**Note:** Due to how Internet Explorer handles node attributes, some attribute
+selectors may not work as expected. In particular ``a[title]`` will not work
+as all ``A`` elements in the Internet Explorer DOM model have a title attribute
+regardless of whether it's specified in the markup or not.
+
+
+API Reference
+=============
+
+Functions
+---------
+
+:mochidef:`findDocElements(expression[, ...])`:
+    
+    Performs a selection on the active document. Equivalent
+    to ``findChildElements(MochiKit.DOM.currentDocument(), [expression, ...])``
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+
+:mochidef:`findChildElements(element, expressions)`:
+
+    Traverses the child nodes of ``element`` and returns the subset
+    of those that match any of the selector expressions in ``expressions``.
+
+    Each expression can be a combination of simple expressions, by concatenating
+    them with spaces or combinators. In that case, normal CSS rules apply, each
+    simple expression is evaluated in turn and the results of that one is used
+    as the scope for the succeeding expression (see :mochiref:`Selector.findElements`).
+    Finally, the results of the last simple expression is returned as the search result.
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+:mochidef:`$$(expression[, ...])`:
+
+    An alias to ``findDocElements``.
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+Constructors
+-------------
+
+:mochidef:`Selector(simpleExpression)`:
+
+    An object storing the parsed version of a simple CSS selector expression
+    and providing functions for executing searches.
+
+    *Simple* means that the expression is not a combination of expressions,
+    i.e. it does not contain any spaces.
+    
+    Usually the user would not instantiate or use this object directly, but 
+    heres how::
+
+        var selector = new MochiKit.Selector.Selector('#someelementid');
+        var searchResults = selector.findElements(rootElement);
+
+    *Deprecated*:
+        Use :mochiref:`findChildElements` instead. The Selector class will be
+        removed in version 1.5.
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+:mochidef:`Selector.findElements(scope[, axis=""])`:
+
+    Performs a search on ``scope``. The value of axis controls what relatives
+    of ``scope`` are considered.
+
+    ``scope``:
+        A DOM node that acts as a starting point for the search.
+
+    ``axis``:
+        One of ``">"``, ``"+"``, ``"~"`` or the empty string (default).
+        If the empty string, all descendant nodes of ``scope`` are tested against
+        the expression. If ``>`` only direct child nodes of ``scope`` are tested,
+        if ``+`` only the next sibling (if any) of ``scope`` is tested and if
+        ``~`` all succeeding siblings of ``scope`` are tested.
+
+    *Deprecated*:
+        Use :mochiref:`findChildElements` instead. The Selector class will be
+        removed in version 1.5.
+
+    *Availability*:
+        Available in MochiKit 1.4+
+
+
+See Also
+========
+
+.. [1] CSS Selectors Level 3 (Last Call, oct. 2006):
+       http://www.w3.org/TR/2005/WD-css3-selectors-20051215/ 
+
+
+Authors
+=======
+
+- Arnar Birgisson <arnarbi@gmail.com>
+- Thomas Herve <therve@gmail.com>
+- Originally ported from Prototype <http://prototype.conio.net/>
+
+
+Copyright
+=========
+
+Copyright 2005 Bob Ippolito <bob@redivi.com>. This program is
+dual-licensed free software; you can redistribute it and/or modify it
+under the terms of the `MIT License`_ or the `Academic Free License
+v2.1`_.
+
+.. _`MIT License`: http://www.opensource.org/licenses/mit-license.php
+.. _`Academic Free License v2.1`: http://www.opensource.org/licenses/afl-2.1.php
+
+Based on Prototype, (c) 2005 Sam Stephenson, available under the `Prototype
+license`_
+
+.. _`Prototype license`: http://dev.rubyonrails.org/browser/spinoffs/prototype/LICENSE?rev=3362