Upgrade to ExtJS 4.0.7 - Released 10/19/2011
[extjs.git] / src / toolbar / Toolbar-legacy.js
index a8b9e77..145339e 100644 (file)
@@ -12,57 +12,54 @@ This file may be used under the terms of the GNU General Public License version
 If you are unsure which license is appropriate for your use, please contact the sales department at http://www.sencha.com/contact.
 
 */
-/**
- * @ignore
- */
 // backwards compat
 Ext.toolbar.Toolbar.Button = Ext.extend(Ext.button.Button, {});
 Ext.toolbar.Toolbar.SplitButton = Ext.extend(Ext.button.Split, {});
 Ext.reg('tbbutton', Ext.toolbar.Toolbar.Button);
 Ext.reg('tbsplit', Ext.toolbar.Toolbar.SplitButton);
 
-/**
+/*
  * @ignore
  */
 Ext.toolbar.Toolbar.override({
-    /**
+    /*
      * Adds text to the toolbar
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
      * @param {String} text The text to add
-     * @return {Ext.Toolbar.Item} The element's item
+     * @return {Ext.toolbar.Item} The element's item
      */
     addText : function(text){
         return this.addItem(new Ext.Toolbar.TextItem(text));
     },
 
-    /**
-     * Adds a new element to the toolbar from the passed {@link Ext.core.DomHelper} config
+    /*
+     * Adds a new element to the toolbar from the passed {@link Ext.DomHelper} config
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
      * @param {Object} config
-     * @return {Ext.Toolbar.Item} The element's item
+     * @return {Ext.toolbar.Item} The element's item
      */
     addDom : function(config){
         return this.add(new Ext.Toolbar.Item({autoEl: config}));
     },
 
-    /**
+    /*
      * Adds a dynamically rendered Ext.form field (Text, ComboBox, etc). Note: the field should not have
      * been rendered yet. For a field that has already been rendered, use {@link #addElement}.
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
      * @param {Ext.form.field.Field} field
-     * @return {Ext.Toolbar.Item}
+     * @return {Ext.toolbar.Item}
      */
     addField : function(field){
         return this.add(field);
     },
 
-    /**
+    /*
      * Inserts any {@link Ext.toolbar.Item}/{@link Ext.button.Button} at the specified index.
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
      * @param {Number} index The index where the item is to be inserted
-     * @param {Object/Ext.Toolbar.Item/Ext.button.Button/Array} item The button, or button config object to be
+     * @param {Object/Ext.toolbar.Item/Ext.button.Button/Object[]} item The button, or button config object to be
      * inserted, or an array of buttons/configs.
-     * @return {Ext.button.Button/Item}
+     * @return {Ext.button.Button/Ext.toolbar.Item}
      */
     insertButton : function(index, item){
         if(Ext.isArray(item)){
@@ -75,7 +72,7 @@ Ext.toolbar.Toolbar.override({
         return Ext.toolbar.Toolbar.superclass.insert.call(this, index, item);
     },
 
-    /**
+    /*
      * Adds a separator
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
      * @return {Ext.toolbar.Item} The separator {@link Ext.toolbar.Item item}
@@ -84,16 +81,16 @@ Ext.toolbar.Toolbar.override({
         return this.add(new Ext.toolbar.Separator());
     },
 
-    /**
+    /*
      * Adds a spacer element
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
-     * @return {Ext.Toolbar.Spacer} The spacer item
+     * @return {Ext.toolbar.Spacer} The spacer item
      */
     addSpacer : function(){
         return this.add(new Ext.Toolbar.Spacer());
     },
 
-    /**
+    /*
      * Forces subsequent additions into the float:right toolbar
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
      */
@@ -101,31 +98,31 @@ Ext.toolbar.Toolbar.override({
         this.add(new Ext.Toolbar.Fill());
     },
 
-    /**
+    /*
      * Adds any standard HTML element to the toolbar
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
-     * @param {Mixed} el The element or id of the element to add
-     * @return {Ext.Toolbar.Item} The element's item
+     * @param {String/HTMLElement/Ext.Element} el The element or id of the element to add
+     * @return {Ext.toolbar.Item} The element's item
      */
     addElement : function(el){
         return this.addItem(new Ext.Toolbar.Item({el:el}));
     },
 
-    /**
+    /*
      * Adds any Toolbar.Item or subclass
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
-     * @param {Ext.Toolbar.Item} item
-     * @return {Ext.Toolbar.Item} The item
+     * @param {Ext.toolbar.Item} item
+     * @return {Ext.toolbar.Item} The item
      */
     addItem : function(item){
         return this.add.apply(this, arguments);
     },
 
-    /**
+    /*
      * Adds a button (or buttons). See {@link Ext.button.Button} for more info on the config.
      * <br><p><b>Note</b>: See the notes within {@link Ext.container.Container#add}.</p>
-     * @param {Object/Array} config A button config or array of configs
-     * @return {Ext.button.Button/Array}
+     * @param {Object/Object[]} config A button config or array of configs
+     * @return {Ext.button.Button/Ext.button.Button[]}
      */
     addButton : function(config){
         if(Ext.isArray(config)){