From d01457702d1231f749ae512da027f33076e93d7a Mon Sep 17 00:00:00 2001
From: Marc-Antoine Parent <contact@marcantoineparent.com>
Date: Mon, 13 Mar 2017 16:21:29 -0400
Subject: [PATCH 1/3] Add multiple selection specification to docs

---
 docs/_includes/examples/tags.html | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/_includes/examples/tags.html b/docs/_includes/examples/tags.html
index 69733a38..d3fd2ee7 100644
--- a/docs/_includes/examples/tags.html
+++ b/docs/_includes/examples/tags.html
@@ -2,7 +2,8 @@
   <h1 id="tags">Tagging support</h1>
 
   <p>
-    Select2 can be used to quickly set up fields used for tagging.
+    Select2 can be used to quickly set up fields used for tagging. 
+    <code>multiple</code> have to be enabled on the field for tags support.
   </p>
 
   <p>

From e5fc98dda90651b38067a048ac292bb87b0df5a3 Mon Sep 17 00:00:00 2001
From: Marc-Antoine Parent <contact@marcantoineparent.com>
Date: Thu, 30 Mar 2017 14:04:10 -0400
Subject: [PATCH 2/3] Update tags.html

---
 docs/_includes/examples/tags.html | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/_includes/examples/tags.html b/docs/_includes/examples/tags.html
index d3fd2ee7..456677d6 100644
--- a/docs/_includes/examples/tags.html
+++ b/docs/_includes/examples/tags.html
@@ -3,13 +3,14 @@
 
   <p>
     Select2 can be used to quickly set up fields used for tagging. 
-    <code>multiple</code> have to be enabled on the field for tags support.
   </p>
 
   <p>
     Note that when tagging is enabled the user can select from pre-existing
     options or create a new tag by picking the first choice, which is what
     the user has typed into the search box so far.
+    To enable a multiple tags select, don't forget the <code>multiple</code>
+    attribute.
   </p>
 
   <div class="s2-example">

From a587e39288fd4c9f71aa2e15ce2cd6987d05c7a2 Mon Sep 17 00:00:00 2001
From: Marc-Antoine Parent <contact@marcantoineparent.com>
Date: Thu, 30 Mar 2017 16:07:50 -0400
Subject: [PATCH 3/3] Add example for single select element

---
 docs/_includes/examples/tags.html | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/docs/_includes/examples/tags.html b/docs/_includes/examples/tags.html
index 456677d6..d64a27f1 100644
--- a/docs/_includes/examples/tags.html
+++ b/docs/_includes/examples/tags.html
@@ -9,13 +9,11 @@
     Note that when tagging is enabled the user can select from pre-existing
     options or create a new tag by picking the first choice, which is what
     the user has typed into the search box so far.
-    To enable a multiple tags select, don't forget the <code>multiple</code>
-    attribute.
   </p>
 
   <div class="s2-example">
     <p>
-      <select class="js-example-tags form-control" multiple="multiple">
+      <select class="js-example-tags-multiple form-control" multiple="multiple">
         <option selected="selected">orange</option>
         <option>white</option>
         <option selected="selected">purple</option>
@@ -23,9 +21,31 @@
     </p>
   </div>
 
+{% highlight js linenos %}
+$(".js-example-tags-multiple").select2({
+  tags: true
+})
+{% endhighlight %}
+  
+  <p>
+    Tagging can also be used on a single select element. Simply remove the
+    <code>multiple="multiple"</code> attribute from your HTML markup.
+  </p>
+  
+  <div class="s2-example">
+    <p>
+      <select class="js-example-tags form-control">
+        <option selected="selected">orange</option>
+        <option>white</option>
+        <option>purple</option>
+      </select>
+    </p>
+  </div>
+
 {% highlight js linenos %}
 $(".js-example-tags").select2({
   tags: true
 })
 {% endhighlight %}
+  
 </section>