/**
    * @fileoverview Utilities for handling textareas.
    * @author kuth@google.com (Uthur Pendragon)
    */
                    
                  

                    
    /**
    * Moves to the next position in the selection.
    * Throws {@code goog.iter.StopIteration} when it
    * passes the end of the range.
    * @return {Node} The node at the next position.
    */                    
    goog.dom.RangeIterator.prototype.next = function() {
      // ...
    };
                    
                  

                    
    /** @const */ var MY_BEER = 'stout';

    /**
    * My namespace's favorite kind of beer.
    * @const {string}
    */                     
    mynamespace.MY_BEER = 'stout';

    /** @const */ MyClass.MY_BEER = 'stout';

    /**
    * Initializes the request.
    * @const
    */
    mynamespace.Request.prototype.initialize = function() {
      // This method cannot be overridden in a subclass.
    };
                    
                  

                    
    /**
    * A rectangle.
    * @constructor
    */
    function GM_Rect() {
      //...
    }    
                    
                  

                    
    /** @define {boolean} */
    var TR_FLAGS_ENABLE_DEBUG = true;

    /**
    * @define {boolean} Whether we know at compile-time that
    *     the browser is IE.
    */
                      goog.userAgent.ASSUME_IE = false;
                    
                  

                    
    /**
    * Determines whether a node is a field.
    * @return {boolean} True if the contents of
    *     the element are editable, but the element
    *     itself is not.
    * @deprecated Use isField().
    */
    BN_EditUtil.isTopEditableField = function(node) {
      // ...
    };
                    
                  

                    
    /**
    * @constructor
    * @dict
    */
    function Foo(x) {
      this['x'] = x;
    }
    var obj = new Foo(123);
    var num = obj.x;  // warning

    (/** @dict */ { x: 1 }).x = 123;  // warning    
                    
                  

                    
    /**
    * Enum for tri-state values.
    * @enum {number}
    */
    project.TriState = {
      TRUE: 1,
      FALSE: -1,
      MAYBE: 0
    };
                    
                  

                    
    /** @export */
    foo.MyPublicClass.prototype.myPublicMethod = function() {
      // ...
    };
                    
                  

                    
    goog.exportSymbol('foo.MyPublicClass.prototype.myPublicMethod',
        foo.MyPublicClass.prototype.myPublicMethod);
                    
                  

                    
    /** @expose */
    MyClass.prototype.exposedProperty = 3;
                    
                  

                    
    /**
    * Immutable empty node list.
    * @constructor
    * @extends goog.ds.BasicNodeList
    */
    goog.ds.EmptyNodeList = function() {
      ...
    };
                    
                  

                    
    /**
    * @fileoverview This is an externs file.
    * @externs
    */

    var document;
                    
                  

                    
    /**
    * @fileoverview Utilities for doing things that require this very long
    * but not indented comment.
    * @author kuth@google.com (Uthur Pendragon)
    */
                    
                  

                    
    /**
    * A shape.
    * @interface
    */
    function Shape() {};
    Shape.prototype.draw = function() {};

    /**
    * @constructor
    * @implements {Shape}
    */
    function Square() {};
    Square.prototype.draw = function() {
      ...
    };
                    
                  

                    
    /** @inheritDoc */
    project.SubClass.prototype.toString() {
      // ...
    };
                    
                  

                    
    /**
    * A shape.
    * @interface
    */
    function Shape() {};
    Shape.prototype.draw = function() {};

    /**
    * A polygon.
    * @interface
    * @extends {Shape}
    */
    function Polygon() {};
    Polygon.prototype.getSides = function() {};
                    
                  

                    
    goog.object.extend(
      Button.prototype,
      /** @lends {Button.prototype} */ {
        isButton: function() { return true; }
      });
                    
                  

                    
    /**
    * @preserve Copyright 2009 SomeThirdParty.
    * Here is the full license text and copyright
    * notice for this file. Note that the notice can span several
    * lines and is only terminated by the closing star and slash:
    */
                    
                  

                    
    /** @noalias */
    function Range() {}
                    
                  

                    
    /** @nocompile */

    // JavaScript code
                    
                  

                    
    /** @nosideeffects */
    function noSideEffectsFn1() {
      // ...
    }

    /** @nosideeffects */
    var noSideEffectsFn2 = function() {
      // ...
    };

    /** @nosideeffects */
    a.prototype.noSideEffectsFn3 = function() {
      // ...
    };
                    
                  

                    
    /**
    * @return {string} Human-readable representation of project.SubClass.
    * @override
    */
    project.SubClass.prototype.toString = function() {
      // ...
    };
                    
                  

                    
    /**
    * Queries a Baz for items.
    * @param {number} groupNum Subgroup id to query.
    * @param {string|number|null} term An itemName,
    *     or itemId, or null to search everything.
    */
    goog.Baz.prototype.query = function(groupNum, term) {
      // ...
    };
                    
                  

                    
    /**
    * Handlers that are listening to this logger.
    * @private {!Array.<Function>}
    */
    this.handlers_ = [];
                    
                  

                    
    /**
    * Sets the component's root element to the given element.
    * @param {Element} element Root element for the component.
    * @protected
    */
    goog.ui.Component.prototype.setElementInternal = function(element) {
      // ...
    };
                    
                  

                    
    /**
    * Whether to cancel the event in internal capture/bubble processing.
    * @public {boolean}
    * @suppress {visiblity} Referencing this outside this package is strongly
    * discouraged.
    */
                      goog.events.Event.prototype.propagationStopped_ = false;
                    
                  

                    
    /**
    * @return {string} The hex ID of the last item.
    */
    goog.Baz.prototype.getLastId = function() {
      // ...
      return id;
    };
                    
                  

                    
    /**
    * Adds a single item, recklessly.
    * @see #addSafely
    * @see goog.Collect
    * @see goog.RecklessAdder#add
    ...
                    
                  

                    
    /**
    * @constructor
    * @struct
    */
    function Foo(x) {
      this.x = x;
    }
    var obj = new Foo(123);
    var num = obj['x'];  // warning
    obj.y = "asdf";  // warning
                     
    Foo.prototype = /** @struct */ {
      method1: function() {}
    };
    Foo.prototype.method2 = function() {};  // warning
                    
                  

                    
    /**
    * @fileoverview Event Manager
    * Provides an abstracted interface to the
    * browsers' event systems.
    * @supported So far tested in IE6 and FF1.5
    */
                    
                  

                    
    /**
    * @suppress {deprecated}
    */
    function f() {
      deprecatedVersionOfF();
    }
                    
                  

                    
    /**
    * @param {function(this:T, ...)} fn
    * @param {T} thisObj
    * @param {...*} var_args
    * @template T
    */
    goog.bind = function(fn, thisObj, var_args) {
      ...
    };
                    
                  

                    
    pinto.chat.RosterWidget.extern('getRosterElement',
        /**
        * Returns the roster widget element.
        * @this pinto.chat.RosterWidget
        * @return {Element}
        */
        function() {
          return this.getWrappedComponent_().getElement();
        });
                    
                  

                    
    /**
    * The message hex ID.
    * @type {string}
    */
    var hexId = hexId;
                    
                  

                    
    /** @typedef {(string|number)} */
    goog.NumberLike;

    /** @param {goog.NumberLike} x A number or a string. */
    goog.readNumber = function(x) {
      ...
    }