From c3f462efe526291fe4f4f2111b24d76a720754fd Mon Sep 17 00:00:00 2001
From: Yegor Bugayenko <yegor@tpc2.com>
Date: Sun, 19 Jan 2014 21:00:21 +0100
Subject: [PATCH] #12 options documented

---
 src/site/apt/example-options.apt.vm | 66 +++++++++++++++++++++++++++++
 src/site/site.xml                   |  1 +
 2 files changed, 67 insertions(+)
 create mode 100644 src/site/apt/example-options.apt.vm

diff --git a/src/site/apt/example-options.apt.vm b/src/site/apt/example-options.apt.vm
new file mode 100644
index 00000000..c7e3a8ad
--- /dev/null
+++ b/src/site/apt/example-options.apt.vm
@@ -0,0 +1,66 @@
+ ------
+ With MySQL configuration options
+ ------
+ Yegor Bugayenko
+ ------
+ 2013-09-19
+ ------
+
+~~
+~~ #set($sign="$")
+~~ Copyright (c) 2012-2013, JCabi.com
+~~ All rights reserved.
+~~
+~~ Redistribution and use in source and binary forms, with or without
+~~ modification, are permitted provided that the following conditions
+~~ are met: 1) Redistributions of source code must retain the above
+~~ copyright notice, this list of conditions and the following
+~~ disclaimer. 2) Redistributions in binary form must reproduce the above
+~~ copyright notice, this list of conditions and the following
+~~ disclaimer in the documentation and/or other materials provided
+~~ with the distribution. 3) Neither the name of the jcabi.com nor
+~~ the names of its contributors may be used to endorse or promote
+~~ products derived from this software without specific prior written
+~~ permission.
+~~
+~~ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+~~ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
+~~ NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+~~ FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
+~~ THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+~~ INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+~~ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+~~ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+~~ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+~~ STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+~~ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+~~ OF THE POSSIBILITY OF SUCH DAMAGE.
+~~
+
+With MySQL configuration options
+
+  You can specify MySQL options, as if you were starting
+  <<<mysqld>>> from command line, for example:
+
++--
+<project>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>com.jcabi</groupId>
+        <artifactId>jcabi-mysql-maven-plugin</artifactId>
+        <version>${project.version}</version>
+        <configuration>
+          <port>${sign}{mysql.port}</port>
+          <data>${sign}{project.build.directory}/mysql-data</data>
+          <options>
+            <option>default-time-zone=UTC</option>
+            <option>connect-timeout=60</option>
+          </options>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  [...]
+</project>
++--
diff --git a/src/site/site.xml b/src/site/site.xml
index f132f2b6..b8e76244 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -58,6 +58,7 @@
         </menu>
         <menu name="Examples">
             <item name="Integration Testing" href="example-it.html"/>
+            <item name="MySQL CLI Options" href="example-options.html"/>
         </menu>
         <menu ref="reports"/>
     </body>