Merge pull request #1732 from tgirardi/destroy

Rename "remove" to "destroy" and create alias

Author: acrobat

docs/methods.rst

@@ -8,13 +8,14 @@ Methods are called on a datepicker by calling the ``datepicker`` function with a
     $('.datepicker').datepicker('method', arg1, arg2);
 
 
-remove
+destroy
 ------
 
 Arguments: None
 
 Remove the datepicker.  Removes attached events, internal attached objects, and added HTML elements.
 
+*Alias: remove*
 
 show
 ----

js/bootstrap-datepicker.js

@@ -525,7 +525,7 @@
 			return this;
 		},
 
-		remove: function(){
+		destroy: function(){
 			this.hide();
 			this._detachEvents();
 			this._detachSecondaryEvents();
@@ -627,6 +627,7 @@
 
 		setDate: alias('setDates'),
 		setUTCDate: alias('setUTCDates'),
+		remove: alias('destroy'),
 
 		setValue: function(){
 			var formatted = this.getFormattedDate();

tests/suites/component.js

@@ -160,17 +160,27 @@ test('Selecting date resets viewDate and date', function(){
     equal(target.text(), '29'); // Should be Jan 29
 });
 
-test('"remove" removes associated HTML', function(){
+test('"destroy" removes associated HTML', function(){
     var datepickerDivSelector = '.datepicker';
 
     $('#datepicker').datepicker('show');
 
     //there should be one datepicker initiated so that means one hidden .datepicker div
     equal($(datepickerDivSelector).length, 1);
-    this.component.datepicker('remove');
+    this.component.datepicker('destroy');
     equal($(datepickerDivSelector).length, 0);//hidden HTML should be gone
 });
 
+test('"remove" is an alias for "destroy"', function(){
+    var called, originalDestroy = this.dp.destroy;
+    this.dp.destroy = function () {
+        called = true;
+        return originalDestroy.apply(this, arguments);
+    };
+    this.dp.remove();
+    ok(called);
+});
+
 test('Does not block events', function(){
     var clicks = 0;
     function handler(){