describe new chainability and add ref to v2.3.0

Author: JohnRDOrazio

README.md

@@ -2,6 +2,7 @@ Turns a given dom element into a dynamic clock that updates every second, main a
 ```JavaScript
 $.clock.version; //will return the current version number, so you can be sure which version of the script you are using
 $.clock.options; //will return all possible options that can be passed to the jQuery clock plugin, with type description and accepted values
+$.clock.methods; //will return all possible methods that are exposed by the plugin
 ```
 
 # DEMOS
@@ -212,12 +213,42 @@ See an example of this in action here: **https://www.johnromanodorazio.com/jQuer
 
 It is also possible to use a timestamp from an NTP timeserver and start the clock with the ntp's timestamp, in order to have precise atomic time. An example of this can be found here: **https://www.johnromanodorazio.com/ntptest.php**. In the example the ntp timestamp is adjusted on the server to reflect the Europe/London timezone.
 
-## Destroy handler
+## Destroy, start and stop handlers
 
-Includes a handler so that each clock can be stopped, just pass "destroy".
+* Includes a handler so that each clock can be destroyed, just pass "destroy". This will effectively remove the html markup, data, and setTimeout which keeps the clock ticking.
 ```JavaScript
 $("div#clock").clock("destroy");
 ```
+* Includes a handler so that each clock can be stopped, just pass "stop". This will remove only the setTimeout which keeps the clock ticking, not the html markup or the data, allowing the clock to start ticking again in a later moment.
+```JavaScript
+$("div#clock").clock("stop");
+```
+* Includes a handler so that each clock can be (re-)started, just pass "start". This will insert the setTimeout which keeps the clock ticking. The clock will start up again without having lost time :simple_smile: !
+```JavaScript
+$("div#clock").clock("start");
+```
+
+## Destroy, start and stop handlers
+
+The chainability of the plugin passes an instance of the plugin itself, such that it's public methods can be invoked by the variable that might reference the first instantiation. The plugin includes a destroy(), a start() and a stop() method that are equivalent to the handlers of the same name.
+```JavaScript
+var $clocks = $("div.clock").clock(); //turn all divs with a "clock" class into jQuery Clocks
+$clocks.stop(); //will stop all jQuery Clocks on divs with a "clock" class
+$clocks.start(); //will start all jQuery Clocks on divs with a "clock" class
+$clocks.first().stop(); //will stop the jQuery Clock on the first div with a "clock" class
+
+$("#bigben").clock().stop(); //will initialize a jQuery Clock on the div with id = "bigben" and stop it in it's tracks...
+$("#bigben").clock().start(); //will (re-)start the already initialized jQuery Clock on the div with id = "bigben"
+```
+
+## Modifying parameters on initialized jQuery Clocks
+
+All and any parameters can be modified on an already initialized clock. Any modifications will be noticeable on the next tick of the clock.
+```JavaScript
+var $clocks = $("div.clock").clock(); //turn all divs with a "clock" class into jQuery Clocks
+$clocks.first().clock({langSet:"vi"}); //change the locale of the jQuery Clock on the first div with a "clock" class and set it to Vietnamese
+$clocks.clock({timeFormat:"H:i:s.v",rate:50}); //change the timeFormat on the jQuery Clocks on all divs with a "clock" class so that they display milliseconds, and update the tick rate of the clocks to 50 milliseconds
+```
 
 # Styling
 
@@ -315,3 +346,7 @@ Implements all PHP Style Format Characters except for "T" and "u". Adds a "**rat
 ## [v2.2.0](https://github.com/JohnRDOrazio/jQuery-Clock-Plugin/releases/tag/v2.2.0 "https://github.com/JohnRDOrazio/jQuery-Clock-Plugin/releases/tag/v2.2.0")
 
 Allows for escaped literals and for literal string sequences wrapped in '%' characters inside the **dateFormat** and **timeFormat** parameters.
+
+## [v2.3.0](https://github.com/JohnRDOrazio/jQuery-Clock-Plugin/releases/tag/v2.3.0 "https://github.com/JohnRDOrazio/jQuery-Clock-Plugin/releases/tag/v2.3.0")
+
+Returns an instance of the plugin itself along with the dom elements. Adds "start" and "stop" handlers. Adds "destroy()", "start()" and "stop()" methods which have the same effect as the handlers.