New Upstream Snapshot - soci

Ready changes

Summary

Merged new upstream version: 4.0.3+git20221201.0.80d4122 (was: 4.0.3+git20220922.1.72ac2e2).

Resulting package

Built on 2022-12-18T09:22 (took 11m3s)

The resulting binary packages can be installed (if you have the apt repository enabled) by running one of: 

apt install -t fresh-snapshots libsoci-core4.0-dbgsymapt install -t fresh-snapshots libsoci-core4.0apt install -t fresh-snapshots libsoci-devapt install -t fresh-snapshots libsoci-firebird4.0-dbgsymapt install -t fresh-snapshots libsoci-firebird4.0apt install -t fresh-snapshots libsoci-mysql4.0-dbgsymapt install -t fresh-snapshots libsoci-mysql4.0apt install -t fresh-snapshots libsoci-odbc4.0-dbgsymapt install -t fresh-snapshots libsoci-odbc4.0apt install -t fresh-snapshots libsoci-postgresql4.0-dbgsymapt install -t fresh-snapshots libsoci-postgresql4.0apt install -t fresh-snapshots libsoci-sqlite3-4.0-dbgsymapt install -t fresh-snapshots libsoci-sqlite3-4.0

Lintian Result

Diff

diff --git a/.circleci/config.yml b/.circleci/config.yml
new file mode 100644
index 0000000..02cb7f5
--- /dev/null
+++ b/.circleci/config.yml
@@ -0,0 +1,75 @@
+version: 2
+jobs:
+  lint-docs:
+    docker:
+      - image: circleci/ruby:2.4.1-node
+    steps:
+      - checkout
+      - run:
+          name: install markdownlint
+          command: |
+            sudo npm install -g markdownlint-cli@0.22.0
+            markdownlint --version
+      - run:
+          name: lint .md files
+          command: markdownlint --config .markdownlint.json .
+  deploy-docs:
+    docker:
+      - image: circleci/python:2.7
+    steps:
+      - checkout
+      - run:
+          name: install mkdocs
+          command: sudo pip install mkdocs
+      - run:
+          name: generate docs
+          command: mkdocs build --clean
+      - run:
+          name: install lftp
+          command: |
+            sudo apt-get update -q --allow-releaseinfo-change
+            sudo apt-get install -y lftp
+      - run:
+          name: deploy docs
+          command: lftp sftp://${DEPLOY_DOCS_USER}:${DEPLOY_DOCS_PASS}@${DEPLOY_DOCS_HOST} -e "set ftp:ssl-force true; set ftp:ssl-protect-data true; set ssl:verify-certificate no; set sftp:auto-confirm yes; mirror -v -R ./site ${DEPLOY_DOCS_BASE}/doc/${CIRCLE_BRANCH}; quit"
+  deploy-website:
+    docker:
+      - image: circleci/python:2.7
+    steps:
+      - checkout
+      - run:
+          name: install lftp
+          command: |
+            sudo apt-get update -q --allow-releaseinfo-change
+            sudo apt-get install -y lftp
+      - run:
+          name: deploy website
+          command: lftp sftp://${DEPLOY_DOCS_USER}:${DEPLOY_DOCS_PASS}@${DEPLOY_DOCS_HOST} -e "set ftp:ssl-force true; set ftp:ssl-protect-data true; set ssl:verify-certificate no; set sftp:auto-confirm yes; mirror -v -R ./www ${DEPLOY_DOCS_BASE}; quit"
+
+workflows:
+  version: 2
+  website-workflow:
+    jobs:
+      - lint-docs:
+          filters:
+            branches:
+              only:
+                - master
+                - /^release.*/
+      - deploy-docs:
+          requires:
+            - lint-docs
+          filters:
+            branches:
+              only:
+                - master
+                - /^release.*/
+      - deploy-website:
+          filters:
+            branches:
+              only:
+                - master
+
+notify:
+  webhooks:
+    - url: https://webhooks.gitter.im/e/9ff4be3a6f08f55106e2
diff --git a/.cirrus.yml b/.cirrus.yml
new file mode 100644
index 0000000..1e58003
--- /dev/null
+++ b/.cirrus.yml
@@ -0,0 +1,25 @@
+# Continuous integration tasks running on Cirrus CI.
+#
+# This is currently used for testing under FreeBSD, which is not available at
+# the other CI providers already used by SOCI.
+env:
+  SOCI_CI: true
+  SOCI_CI_BRANCH: ${CIRRUS_BRANCH}
+  SOCI_SOURCE_DIR: /tmp/cirrus-ci-build
+  # Using Boost results in tons of warnings under FreeBSD.
+  WITH_BOOST: OFF
+
+task:
+  matrix:
+    - name: Cirrus CI / Empty FreeBSD
+      env:
+        SOCI_CI_BACKEND: empty
+    - name: Cirrus CI / SQLite3 FreeBSD
+      env:
+        SOCI_CI_BACKEND: sqlite3
+  freebsd_instance:
+    image_family: freebsd-13-0
+  install_script: ./scripts/ci/install.sh
+  before_build_script: ./scripts/ci/before_build.sh
+  build_script: ./scripts/ci/build.sh
+  test_script: ./scripts/ci/test.sh
diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..aa40f19
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,32 @@
+# This is the EditorConfig (http://editorconfig.org/) coding style file for SOCI.
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+# CMake configuration files
+[{CMakeLists.txt,*.cmake}]
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# CI configuration files
+[{.github/workflows/*.yml,appveyor.yml,Vagrantfile}]
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# Windows shell scripts
+[*.{cmd,bat,ps1}]
+end_of_line = crlf
+indent_size = 4
+indent_style = space
+insert_final_newline = false
+trim_trailing_whitespace = true
diff --git a/.markdownlint.json b/.markdownlint.json
new file mode 100644
index 0000000..17aa124
--- /dev/null
+++ b/.markdownlint.json
@@ -0,0 +1,8 @@
+{
+    "default": true,
+    "MD013": false,
+    "MD026": false,
+    "MD024": false,
+    "MD029": {"style": "ordered"},
+    "MD034": false
+}
diff --git a/CHANGES b/CHANGES
index 601e3d4..2d4e59e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -3,7 +3,7 @@ This file contains the history of changes in the SOCI library.
 Latest version is v4.0.3 released on 2022-02-14.
 
 ---
-Version 4.0.3 (99e2d567) differs from 4.0.2 in the following ways:
+Version 4.0.3 differs from 4.0.2 in the following ways:
 
 Changes affecting all or multiple backends:
  - Fix opening sessions from pool (#891).
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 3b6f9ac..3801926 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -10,10 +10,15 @@
 ###############################################################################
 # General settings
 ###############################################################################
-cmake_minimum_required(VERSION 2.8 FATAL_ERROR)
+cmake_minimum_required(VERSION 2.8...3.20 FATAL_ERROR)
 
 project(SOCI)
 
+if(NOT DEFINED CMAKE_CXX_STANDARD OR CMAKE_CXX_STANDARD LESS 14)
+  set(CMAKE_CXX_STANDARD 14)
+endif()
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
 ###############################################################################
 # Build features and variants
 ##############################################################################
@@ -107,7 +112,6 @@ boost_report_value(SOCI_TESTS)
 boost_report_value(SOCI_ASAN)
 
 # from SociConfig.cmake
-boost_report_value(SOCI_CXX11)
 boost_report_value(LIB_SUFFIX)
 
 # Put the libaries and binaries that get built into directories at the
diff --git a/README.md b/README.md
index e6b66e1..21c1ce5 100644
--- a/README.md
+++ b/README.md
@@ -40,8 +40,8 @@ SOCI library is distributed under the terms of the [Boost Software License](http
 
 Core:
 
-* C++ compiler
-* Boost C++ Libraries (optional, headers and Boost.DateTime)
+* Compile with C++14 support (please use 4.0 series for C++98 support) or MSVS 2015 or later.
+* Optionally: Boost C++ Libraries (header-only and Boost.DateTime).
 
 Backend specific client libraries for:
 
diff --git a/RELEASING.md b/RELEASING.md
new file mode 100644
index 0000000..9483c6e
--- /dev/null
+++ b/RELEASING.md
@@ -0,0 +1,208 @@
+# Releasing
+
+The releasing guide for the SOCI maintainers.
+
+1. [Update CHANGES file](#update-changes-file)
+2. [Update version numbers](#update-version-numbers)
+3. [Add build status to README](#add-build-status-to-readme)
+4. [Update website content](#update-website-content)
+5. [Upload website content](#upload-website-content)
+6. [Create release branch](#create-release-branch)
+7. [Create source archive](#create-source-archive)
+8. [Publish release packages on SourceForge](#publish-release-packages-on-sourceforgenet)
+9. [Create annotated tag for final release and push to GitHub](create-annotated-tag-for-final-release-and-push-to-github)
+10. [Announce new release](#announce-new-release)
+
+**NOTICE:** The `4.0` and `4.0.0` version numbers are used below
+(e.g. as in `release/4.0`) to keep the instructions more concrete,
+but it is a placeholder similar to `X.Y` or `X.Y.Z`.
+It should be replaced with the version number of the new release.
+
+## Update CHANGES file
+
+Update the list of important changes in the [CHANGES](CHANGES) file.
+
+First, start new section with new line like this:
+
+> Version X.Y.Z differs from A.B.C in the following ways:
+
+optionally, you may also want to start with `X.Y.Z-rc1`, changing through
+`X.Y.Z-rc2`, `X.Y.Z-rc3`, etc. to `X.Y.Z` on the course of updates
+towards the final release. For example, like so
+
+> Version 4.0.2 differs from 4.0.1 in the following ways:
+
+Next, it is helpful to generate complete log of changes in Markdown format:
+
+```console
+git log v4.0.1..master --pretty=format:"1. [%h](http://github.com/soci/soci/commit/%H) - %s"
+```
+
+Then, filter it out from trivial changes keeping only the important ones.
+Next, group changes in sections for core and backends, sort within sections,
+edit and update if necessary. Finally, copy to the `CHANGES` file.
+
+Commit the updates to the `master` branch first.
+See [Create release branch](#create-release-branch).
+
+## Update AUTHORS file
+
+Use `git shortlog -s v4.0.1..` to get the list of contributors since the last
+release.
+
+## Update version numbers
+
+Update the version number of the new release in the following places:
+
+- [README.md](README.md) - version in badges, links to Git tag on GitHub and release
+- [include/soci/version.h](include/soci/version.h)
+- [mkdocs.yml](mkdocs.yml) - in `release/X.Y` branch (see [create release branch](#create-release-branch)) set `site_name` with **X.Y** and keep **master** in the `master` branch.
+- [docs/index.md](docs/index.md)
+- [appveyor.yml](appveyor.yml)
+
+Search through the source tree looking for other places
+that use current version number and may require an update.
+Depending on type of release, update major, minor and micro version numbers.
+
+The version number also has to be updated in number of places
+on the website, see [update website](#update-website) section.
+
+## Add build status to README
+
+Add row for `release/X.Y` to the CI build status table in [README.md](README.md).
+
+## Update website content
+
+Update version of the new release on the [www/index.html](www/index.html) page.
+
+Add date and version of the new release on the [www/events.html](www/events.html) page.
+
+Add link to the folder with documentation for the new release
+on the [www/doc/index.html](www/doc/index.html) page.
+
+## Upload website content
+
+### Continuous deployment
+
+There is [CircleCI workflow](https://circleci.com/gh/SOCI/workflows/soci)
+configured in [.circleci/config.yml](.circleci/config.yml)
+with dedicated jobs to deploy content website and documentation.
+
+For `master` and `release/X.Y` branches, the jobs do:
+
+- lint all Markdown files
+- run [MkDocs](https://www.mkdocs.org) to generate HTML pages from source in [doc/](doc)
+- upload generated HTML files to branch-specific documentation folder (e.g. [doc/release/4.0](http://soci.sourceforge.net/doc/release/4.0/))
+- upload static HTML files with website pages
+
+See [manual update](#manual-update) for details about SFTP connection.
+
+### Manual update
+
+The website is hosted on SourceForge.net at
+[soci.sourceforge.net](https://soci.sourceforge.net)
+and in order to upload updated files there, you will need:
+
+- Your SourceForge account credentials with administration rights for SOCI project (used for SFTP authentication)
+- [SFTP client to connect to SourceForge host](https://sourceforge.net/p/forge/documentation/SFTP/).
+
+For example, you can use `lftp` to upload website and documentation
+files similarly to our CircleCI workflow configured to generate and
+deploy documentation (see [.circleci/config.yml](.circleci/config.yml)):
+
+```console
+lftp sftp://${DEPLOY_DOCS_USER}:${DEPLOY_DOCS_PASS}@web.sourceforge.net -e "set ftp:ssl-force true; set ftp:ssl-protect-data true; set ssl:verify-certificate no; set sftp:auto-confirm yes; mirror -v -R <source> <target directory>; quit"
+```
+
+where `<source>` denotes a file or folder to be copied
+and `<target directory>` is a directory under Web content folder
+of SOCI on `web.sourceforge.net` i.e. `/home/project-web/soci/htdocs`.
+
+## Create release branch
+
+```console
+git checkout master
+git branch release/4.0
+```
+
+**NOTICE:**: All changes preparing the release or hotfixes should be
+committed to `master` branch first, then merged to `release/X.Y` branch
+that is being released. If it is a newly created `release/X.Y` branch,
+then prefer fast-forward merges from `master`. In other cases, e.g.
+if `release/X.Y` is an existing release branch and you are releasing a bugfix
+release, you may have to perform true merge.
+
+## Create source archive
+
+**NOTICE:** Run this step in Linux environment only.
+
+Run [scripts/release.sh](scripts/release.sh) script to build release archives
+with content from `release/X.Y` branch.
+
+```console
+cd soci
+./scripts/release.sh --help
+```
+
+First, you will want to build number of release candidates (typically 1-3, rarely 5-6):
+
+```console
+./scripts/release.sh --rc 1 release/4.0
+./scripts/release.sh --rc 2 release/4.0
+...
+```
+
+Eventually, once release candidates have been reviewed and verified,
+you will build packages ready for the final release:
+
+```console
+./scripts/release.sh release/4.0
+```
+
+This will output the release candidate packages:
+
+- `soci-4.0.0-rc1.zip`
+- `soci-4.0.0-rc1.tar.gz`
+
+or the final release packages:
+
+- `soci-4.0.0.zip`
+- `soci-4.0.0.tar.gz`
+
+where `4.0.0` is placeholder for the major, minor and micro version
+determined from the current value of the `SOCI_LIB_VERSION` macro
+in [include/soci/version.h](include/soci/version.h).
+
+## Publish release packages on SourceForge
+
+1. Sign in to SourceForge.net using your own credentials (you need SOCI Admin privileges).
+2. Go to https://sourceforge.net/projects/soci/files/soci/ page.
+3. Hit "Add Folder" and create `soci-X.Y.Z` if it does not exist yet (e.g. `soci-4.0.0`)
+4. Go to https://sourceforge.net/projects/soci/files/soci/soci-4.0.0/
+5. Hit "Add File" and upload source packages prepared for release, including release candidates.
+
+## Announce release candidates
+
+Post brief announcement about the issued release candidate to the project
+mailing lists: [soci-devel](https://sourceforge.net/p/soci/mailman/soci-devel/)
+and [soci-users](https://sourceforge.net/p/soci/mailman/soci-users/).
+
+## Create annotated tag for final release and push to GitHub
+
+Since we use SourceForge.net to publish release packages, we do not use
+GitHub releases, so there is no need to publish a new release via GitHub.
+Creating and pushing Git annotated tag is sufficient.
+
+```console
+git checkout release/4.0
+git tag -a v4.0.2 -m "Releasing SOCI 4.0.2"
+git push origin v4.0.2
+```
+
+## Announce final release
+
+Post the final release announcement to the project mailing lists:
+[soci-devel](https://sourceforge.net/p/soci/mailman/soci-devel/)
+and [soci-users](https://sourceforge.net/p/soci/mailman/soci-users/).
+
+The End.
diff --git a/TODO b/TODO
new file mode 100644
index 0000000..f19f03f
--- /dev/null
+++ b/TODO
@@ -0,0 +1,110 @@
+TODO
+
+This file contains a raw bunch of ideas for future releases.
+Not all of these ideas will necessarily make sense - they are here to get them together.
+
+---
+Source of many concepts
+http://lists.boost.org/Archives/boost/2006/12/113961.php
+
+---
+RAII for transactions.
+
+---
+Query construction utilities (kind of Ultimate++) - can be easily incorporated into SOCI by just making them streamable.
+
+---
+CLOB
+
+---
+Streaming interface for BLOB
+
+---
+Standard names for Session constructor.
+
+---
+wstring
+Unicode support
+
+---
+Handle locales in Session (so that operator<< is immune to strange global locale in the user program). It might even make sense to expose imbue(), so that users set up whatever locale they want.
+It might even make sense to expose the whole stream object.
+Alternatively, the backend should decide on the locale, because the backend will know best how to format numbers, dates, etc.
+
+---
+sql << "select...", into(x, default(7));
+
+Note: default is a reserved word.
+
+---
+Provide statement-wide flag for eNoData case (because actually it *is* statement-wide, not field-wide). With this, boost.optional would handle the eNull case and the indicators could be dropped.
+
+---
+
+query backend for supported featureset at runtime
+---
+
+Rowset<tuple>
+---
+
+Rowset<T>, including Rowset<tuple> - way to indicate nulls?
+Additional pair based val/indicator interface?
+
+---
+Consolidate iteration methods?
+most radical: do we still need Statement::fetch()? into()?
+(Rowset<Row> can currently be used for any query, supports indicators,
+defaults, and no need to check for eNodata)
+
+---
+ColumnProperties() more logically belongs to Rowset than to Row
+However Row::ColumnProperties() still needed if we support into(Row)
+
+---
+sql.prepare by default when constructing Rowsets and Statements?
+Rowset<int> rs = (sql << "select n from t";)
+
+---
+row[i].get<string>() instead of row.get<string>(i)
+row["col"].get<string>() instead of row.get<string>("col")
+
+---
+Make more member functions private
+
+---
+Values class should be reference counted
+
+---
+CSV backend
+
+Example:
+Session s("csv:///etc/protocols");
+rowset<string> rs = (s.prepare << "1:*");
+copy(rs.begin(), rs.end(), ...);
+
+where "1:*" is taken from the top of my head and would mean "first field
+from all rows"
+
+- joins are tricky
+
+---
+DBF backend, similar to CSV
+
+Session s("dbf:///table.dbf");
+rowset<string> rs = (s.prepare << "1:*") // first field from all rows
+rowset<string> rs = (s.prepare << "firstname:*") // 'firstname' field from all rows
+rowset<Row> rs = (s.prepare << "firstname='John'") // rows where 'firstname' value is 'John'
+
+Sub-concepts:
+
+- joins are tricky
+
+- boolean operators (<,>,=,<=,=> and <>) and WHERE-like clause support as a query
+
+rowset<Row> rs = (s.prepare << "age > 28") // rows where field 'age' is less than 28
+rowset<Row> rs = (s.prepare << "age <> 28") // rows where field 'age' is less or more than 28
+rowset<Row> rs = (s.prepare << "firstname='John' AND age > 28") // multi-fields combined queries
+
+- very simple home-made SQL parser or SQL-like queries support (see OGR utils from http://www.gdal.org)
+
+---
diff --git a/appveyor.yml b/appveyor.yml
new file mode 100644
index 0000000..9022623
--- /dev/null
+++ b/appveyor.yml
@@ -0,0 +1,119 @@
+version: 4.1.0.{build}
+
+skip_commits:
+  files:
+    - .github/workflows/
+
+configuration: Release
+
+environment:
+  matrix:
+    - G: "Visual Studio 17 2022"
+      BOOST_ROOT: C:\Libraries\boost_1_77_0
+      MSSQL_VER: 2019
+      POSTGRESQL_ROOT: C:\Program Files\PostgreSQL\13
+      MYSQL_DIR: C:\Program Files\MySql\MySQL Server 5.7
+      APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2022
+    - G: "Visual Studio 16 2019"
+      BOOST_ROOT: C:\Libraries\boost_1_73_0
+      MSSQL_VER: 2017
+      POSTGRESQL_ROOT: C:\Program Files\PostgreSQL\12
+      MYSQL_DIR: C:\Program Files\MySql\MySQL Server 5.7
+      APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+    - G: "Visual Studio 15 2017 Win64"
+      BOOST_ROOT: C:\Libraries\boost_1_69_0
+      MSSQL_VER: 2016
+      POSTGRESQL_ROOT: C:\Program Files\PostgreSQL\11
+      MYSQL_DIR: C:\Program Files\MySql\MySQL Server 5.7
+      APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
+    - G: "Visual Studio 14 2015 Win64"
+      BOOST_ROOT: C:\Libraries\boost_1_60_0
+      MSSQL_VER: 2014
+      POSTGRESQL_ROOT: C:\Program Files\PostgreSQL\10
+      MYSQL_DIR: C:\Program Files\MySql\MySQL Server 5.7
+      APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+    - G: "MinGW Makefiles"
+      MINGW_BIN: C:\mingw-w64\x86_64-8.1.0-posix-seh-rt_v6-rev0\mingw64\bin
+      MSSQL_VER: 2014
+      BOOST_ROOT: C:\Libraries\boost_1_60_0
+      POSTGRESQL_ROOT: C:\Program Files\PostgreSQL\9.4
+      MYSQL_DIR: C:\Program Files\MySql\MySQL Server 5.7
+      APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+
+services:
+  - mysql
+  - postgresql
+
+install:
+  # Start this one here as we can't specify the service name dynamically.
+  - net start mssql$SQL%MSSQL_VER%
+  - ps: |
+      Import-Module C:\projects\soci\scripts\windows\Get-ODBCList.ps1
+      $drivers_list = Get-ODBCList
+      Write-Output $drivers_list
+      if ($drivers_list -clike '*MySQL*') {
+        $env:SOCI_ODBC_TESTS = $env:SOCI_ODBC_TESTS + '|soci_odbc_test_mysql'
+      }
+      if ($drivers_list -clike '*PostgreSQL*') {
+        $env:SOCI_ODBC_TESTS = $env:SOCI_ODBC_TESTS + '|soci_odbc_test_postgresql'
+      }
+  - git clone https://github.com/snikulov/sqlite.cmake.build.git C:\projects\sqlite\src
+
+before_build:
+  - set SQLITE_ROOT=C:\projects\sqlite\sqlite
+  # dirty little hack - remove sh from Git to make generator happy
+  - ps: |
+      if ($env:G -eq "MinGW Makefiles")
+      {
+        $shellPath = (Get-Command sh.exe).definition
+        if ($shellPath)
+        {
+          if (Test-Path $shellPath)
+          {
+            Remove-Item $shellPath
+          }
+        }
+        $env:SQLITE3_LIBRARY = $env:SQLITE_ROOT + '/lib/libsqlite3-static.a'
+        $env:BUILD_TOOL_OPTIONS = '-j3'
+      }
+      else
+      {
+        $env:SQLITE3_LIBRARY = $env:SQLITE_ROOT + '/lib/sqlite3-static.lib'
+        $env:BUILD_TOOL_OPTIONS = '/m'
+      }
+  - cd C:\projects\sqlite\src
+  - mkdir build
+  - cd build
+  - set PATH=%MINGW_BIN%;%POSTGRESQL_ROOT%\bin;%MYSQL_DIR%\bin;%MYSQL_DIR%\lib;%PATH%
+  - echo %PATH%
+  - cmake --version
+  - set PGUSER=postgres
+  - set PGPASSWORD=Password12!
+  - createdb soci_test
+  - set MYSQL_PWD=Password12!
+  - set USER=root
+  - mysql -e "create database soci_test;" --user=root
+  - sqlcmd -U sa -P Password12! -S (local)\SQL%MSSQL_VER% -i C:\projects\soci\scripts\windows\mssql_db_create.sql
+  - cmake .. -G"%G%" -DSQLITE_BUILD_SHARED=OFF -DCMAKE_BUILD_TYPE=%CONFIGURATION% -DCMAKE_INSTALL_PREFIX=%SQLITE_ROOT%
+  - cmake --build . --config %CONFIGURATION% --target install
+
+build_script:
+  - cd C:\projects\soci
+  - mkdir build
+  - cd build
+  - cmake .. -G"%G%" -DCMAKE_BUILD_TYPE=%CONFIGURATION% -DCMAKE_VERBOSE_MAKEFILE=ON -DSOCI_ENABLE_WERROR=ON -DSQLITE3_INCLUDE_DIR=%SQLITE_ROOT%/include -DSQLITE3_LIBRARY=%SQLITE3_LIBRARY%
+  - cmake --build . --config %CONFIGURATION% -- %BUILD_TOOL_OPTIONS%
+
+test_script:
+  - ctest -V --timeout 300 --output-on-failure -R "soci_empty|soci_postgresql|soci_sqlite3|soci_odbc_test_mssql|soci_mysql%SOCI_ODBC_TESTS%"
+
+notifications:
+  - provider: Webhook
+    url: https://webhooks.gitter.im/e/2038138a652d952f9372
+    on_build_success: true
+    on_build_failure: true
+    on_build_status_changed: true
+
+# Uncomment this to wait for RDP connection after the build end.
+#on_finish:
+#  - ps: $blockRdp = $true; iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/appveyor/ci/master/scripts/enable-rdp.ps1'))
diff --git a/cmake/SociBackend.cmake b/cmake/SociBackend.cmake
index 5d4ef0d..0a66466 100644
--- a/cmake/SociBackend.cmake
+++ b/cmake/SociBackend.cmake
@@ -78,8 +78,6 @@ macro(soci_backend NAME)
 
   # Backend option available to user
   set(THIS_BACKEND_OPTION SOCI_${NAMEU})
-  option(${THIS_BACKEND_OPTION}
-    "Attempt to build ${PROJECT_NAME} backend for ${NAME}" ON)
 
   soci_backend_deps_found(${NAMEU} "${THIS_BACKEND_DEPENDS}" ${NAMEU}_DEPS_FOUND)
   if(NOT ${NAMEU}_DEPS_FOUND)
@@ -157,6 +155,7 @@ macro(soci_backend NAME)
           SHARED
           ${THIS_BACKEND_SOURCES}
           ${THIS_BACKEND_HEADERS})
+        add_library(Soci::${NAMEL} ALIAS ${THIS_BACKEND_TARGET})
 
         target_link_libraries(${THIS_BACKEND_TARGET}
           ${SOCI_CORE_TARGET}
@@ -194,6 +193,7 @@ macro(soci_backend NAME)
           STATIC
           ${THIS_BACKEND_SOURCES}
           ${THIS_BACKEND_HEADERS})
+        add_library(Soci::${NAMEL}_static ALIAS ${THIS_BACKEND_TARGET_STATIC})
 
         # Still need to link the libraries for tests to work
         target_link_libraries (${THIS_BACKEND_TARGET_STATIC}
@@ -230,7 +230,7 @@ macro(soci_backend NAME)
       endif()
 
     else()
-        colormsg(HIRED "${NAME}" RED "backend disabled, since")
+        colormsg(YELLOW "${NAME} backend explicitly disabled")
     endif()
 
   endif()
@@ -332,10 +332,6 @@ macro(soci_backend_test)
 
     if(NOT ${TEST_CONNSTR_VAR} AND THIS_TEST_CONNSTR)
       set(${TEST_CONNSTR_VAR} ${THIS_TEST_CONNSTR})
-      if(${TEST_CONNSTR_VAR} MATCHES ".dsn")
-        set(_dsnpath "${CMAKE_CURRENT_SOURCE_DIR}/${${TEST_CONNSTR_VAR}}")
-        set(${TEST_CONNSTR_VAR} "FILEDSN=${_dsnpath}")
-      endif()
     endif()
 
     boost_message_value(${TEST_CONNSTR_VAR})
diff --git a/cmake/SociConfig.cmake b/cmake/SociConfig.cmake
index 492e183..0ce5b34 100644
--- a/cmake/SociConfig.cmake
+++ b/cmake/SociConfig.cmake
@@ -32,19 +32,6 @@ if(NOT DEFINED LIB_SUFFIX)
   set(LIB_SUFFIX ${_lib_suffix} CACHE STRING "Specifies suffix for the lib directory")
 endif()
 
-#
-# C++11 Option
-#
-set(SOCI_CXX11 OFF CACHE BOOL "Build to the C++11 standard")
-
-if(CMAKE_CXX_STANDARD EQUAL 11 OR (CMAKE_CXX_STANDARD GREATER 11 AND NOT CMAKE_CXX_STANDARD EQUAL 98))
-  set(SOCI_CXX11 ON)
-endif()
-
-if(NOT DEFINED CMAKE_CXX_STANDARD AND SOCI_CXX11)
-  set(CMAKE_CXX_STANDARD 11)
-endif()
-
 #
 # Force compilation flags and set desired warnings level
 #
@@ -78,24 +65,13 @@ else()
     "-pedantic -Wno-error=parentheses -Wall -Wextra -Wpointer-arith -Wcast-align -Wcast-qual -Wfloat-equal -Woverloaded-virtual -Wredundant-decls -Wno-long-long")
 
 
-  if (SOCI_CXX11)
-    set(SOCI_CXX_VERSION_FLAGS "-std=c++11")
-  else()
-    set(SOCI_CXX_VERSION_FLAGS "-std=gnu++98")
-  endif()
-
   if("${CMAKE_CXX_COMPILER_ID}" MATCHES "Clang" OR "${CMAKE_CXX_COMPILER}" MATCHES "clang")
 
     if(NOT CMAKE_CXX_COMPILER_VERSION LESS 3.1 AND SOCI_ASAN)
       set(SOCI_GCC_CLANG_COMMON_FLAGS "${SOCI_GCC_CLANG_COMMON_FLAGS} -fsanitize=address")
     endif()
 
-    # enforce C++11 for Clang
-    set(SOCI_CXX11 ON)
-    set(SOCI_CXX_VERSION_FLAGS "-std=c++11")
-    add_definitions(-DCATCH_CONFIG_CPP11_NO_IS_ENUM)
-
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${SOCI_GCC_CLANG_COMMON_FLAGS} ${SOCI_CXX_VERSION_FLAGS}")
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${SOCI_GCC_CLANG_COMMON_FLAGS}")
 
   elseif(CMAKE_COMPILER_IS_GNUCC OR CMAKE_COMPILER_IS_GNUCXX)
 
@@ -103,7 +79,7 @@ else()
       set(SOCI_GCC_CLANG_COMMON_FLAGS "${SOCI_GCC_CLANG_COMMON_FLAGS} -fsanitize=address")
     endif()
 
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${SOCI_GCC_CLANG_COMMON_FLAGS} ${SOCI_CXX_VERSION_FLAGS} ")
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${SOCI_GCC_CLANG_COMMON_FLAGS} ")
     if (CMAKE_COMPILER_IS_GNUCXX)
         if (CMAKE_SYSTEM_NAME MATCHES "FreeBSD")
             set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
@@ -119,6 +95,3 @@ else()
 endif()
 
 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${SOCI_WERROR_OPTION}")
-
-# Set SOCI_HAVE_* variables for soci-config.h generator
-set(SOCI_HAVE_CXX11 ${SOCI_CXX11} CACHE INTERNAL "Enables C++11 support")
diff --git a/cmake/SociDependencies.cmake b/cmake/SociDependencies.cmake
index c097add..5f174a5 100644
--- a/cmake/SociDependencies.cmake
+++ b/cmake/SociDependencies.cmake
@@ -73,12 +73,29 @@ option(WITH_VALGRIND "Run tests under valgrind" OFF)
 #
 foreach(external ${SOCI_ALL_DEPENDENCIES})
   string(TOUPPER "${external}" EXTERNAL)
+
+  # For historical reasons we use both WITH_xxx and SOCI_xxx options, and
+  # setting either of them to e.g. OFF should disable the corresponding
+  # dependency.
   option(WITH_${EXTERNAL} "Attempt to find and configure ${external}" ON)
-  if(WITH_${EXTERNAL})
+  option(SOCI_${EXTERNAL} "Attempt to build ${external} backend" ON)
+
+  if(NOT WITH_${EXTERNAL})
+    set(disabled_var "WITH")
+  elseif(NOT SOCI_${EXTERNAL})
+    set(disabled_var "SOCI")
+  endif()
+
+  if(NOT DEFINED disabled_var)
     colormsg(HICYAN "${external}:")
     include(${CMAKE_CURRENT_SOURCE_DIR}/cmake/dependencies/${external}.cmake)
   else()
     set(${EXTERNAL}_FOUND FALSE CACHE BOOL "${external} found" FORCE)
-    colormsg(HIRED "${external}:" RED "disabled, since WITH_${EXTERNAL}=OFF")
+    colormsg(HICYAN "${external}:" YELLOW "disabled, since ${disabled_var}_${EXTERNAL}=OFF")
+    unset(disabled_var)
+  endif()
+
+  if(NOT ${EXTERNAL}_FOUND)
+    set(SOCI_${EXTERNAL} OFF)
   endif()
 endforeach()
diff --git a/cmake/dependencies/Oracle.cmake b/cmake/dependencies/Oracle.cmake
index c664520..32cc649 100644
--- a/cmake/dependencies/Oracle.cmake
+++ b/cmake/dependencies/Oracle.cmake
@@ -1,4 +1,4 @@
-set(ORACLE_FIND_QUIETLY TRUE)
+set(Oracle_FIND_QUIETLY TRUE)
 
 find_package(Oracle)
 
diff --git a/cmake/dependencies/SQLite3.cmake b/cmake/dependencies/SQLite3.cmake
index 0daa9a5..37f57f6 100644
--- a/cmake/dependencies/SQLite3.cmake
+++ b/cmake/dependencies/SQLite3.cmake
@@ -1,4 +1,4 @@
-set(SQLITE3_FIND_QUIETLY TRUE)
+set(SQLite3_FIND_QUIETLY TRUE)
 
 find_package(SQLite3)
 
diff --git a/cmake/modules/FindOracle.cmake b/cmake/modules/FindOracle.cmake
index 3555d65..37106f7 100644
--- a/cmake/modules/FindOracle.cmake
+++ b/cmake/modules/FindOracle.cmake
@@ -81,7 +81,7 @@ set(ORACLE_LIBRARIES ${ORACLE_LIBRARY})
 # Handle the QUIETLY and REQUIRED arguments and set ORACLE_FOUND to TRUE
 # if all listed variables are TRUE
 include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(ORACLE DEFAULT_MSG ORACLE_LIBRARY ORACLE_INCLUDE_DIR)
+find_package_handle_standard_args(Oracle DEFAULT_MSG ORACLE_LIBRARY ORACLE_INCLUDE_DIR)
 
 if(NOT ORACLE_FOUND)
 	message(STATUS "None of the supported Oracle versions (${ORACLE_VERSIONS}) could be found, consider updating ORACLE_VERSIONS if the version you use is not among them.")
diff --git a/cmake/modules/FindPostgreSQL.cmake b/cmake/modules/FindPostgreSQL.cmake
index e2e557b..e795f2e 100644
--- a/cmake/modules/FindPostgreSQL.cmake
+++ b/cmake/modules/FindPostgreSQL.cmake
@@ -27,7 +27,7 @@
 # In Windows the default installation of PostgreSQL uses that as part of the path.
 # E.g C:\Program Files\PostgreSQL\8.4.
 # Currently, the following version numbers are known to this module:
-# "9.6" "9.5" "9.4" "9.3" "9.2" "9.1" "9.0" "8.4" "8.3" "8.2" "8.1" "8.0"
+# "14" "13" "12" "11" "10" "9.6" "9.5" "9.4" "9.3" "9.2" "9.1" "9.0" "8.4" "8.3" "8.2" "8.1" "8.0"
 #
 # To use this variable just do something like this:
 # set(POSTGRESQL_ADDITIONAL_VERSIONS "9.2" "8.4.4")
@@ -71,7 +71,7 @@ set(POSTGRESQL_ROOT_DIR_MESSAGE "Set the POSTGRESQL_ROOT system variable to wher
 
 
 set(POSTGRESQL_KNOWN_VERSIONS ${POSTGRESQL_ADDITIONAL_VERSIONS}
-    "9.6" "9.5" "9.4" "9.3" "9.2" "9.1" "9.0" "8.4" "8.3" "8.2" "8.1" "8.0")
+    "14" "13" "12" "11" "10" "9.6" "9.5" "9.4" "9.3" "9.2" "9.1" "9.0" "8.4" "8.3" "8.2" "8.1" "8.0")
 
 # Define additional search paths for root directories.
 set( POSTGRESQL_ROOT_DIRECTORIES
@@ -96,6 +96,12 @@ foreach(suffix ${POSTGRESQL_KNOWN_VERSIONS})
         "postgresql/${suffix}/server"
         "pgsql-${suffix}/include/server")
   endif()
+  if(APPLE)
+    list(APPEND POSTGRESQL_LIBRARY_ADDITIONAL_SEARCH_SUFFIXES
+        "postgresql@${suffix}")
+    list(APPEND POSTGRESQL_INCLUDE_ADDITIONAL_SEARCH_SUFFIXES
+        "postgresql@${suffix}")
+  endif()
 endforeach()
 
 #
diff --git a/cmake/modules/FindSQLite3.cmake b/cmake/modules/FindSQLite3.cmake
index b06d949..885a656 100644
--- a/cmake/modules/FindSQLite3.cmake
+++ b/cmake/modules/FindSQLite3.cmake
@@ -54,7 +54,7 @@ set(SQLITE3_LIBRARIES
 # Handle the QUIETLY and REQUIRED arguments and set SQLITE3_FOUND to TRUE
 # if all listed variables are TRUE
 include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(SQLITE3
+find_package_handle_standard_args(SQLite3
   DEFAULT_MSG
   SQLITE3_LIBRARIES
   SQLITE3_INCLUDE_DIR)
diff --git a/cmake/modules/FindSoci.cmake b/cmake/modules/FindSoci.cmake
index f49b874..ece836e 100644
--- a/cmake/modules/FindSoci.cmake
+++ b/cmake/modules/FindSoci.cmake
@@ -1,23 +1,24 @@
 ###############################################################################
 # CMake module to search for SOCI library
 #
-# WARNING: This module is experimental work in progress.
-#
 # This module defines:
-#  SOCI_INCLUDE_DIRS        = include dirs to be used when using the soci library
-#  SOCI_LIBRARY             = full path to the soci library
-#  SOCI_VERSION             = the soci version found (not yet. soci does not provide that info.)
-#  SOCI_FOUND               = true if soci was found
+#  Soci_INCLUDE_DIRS        = include dirs to be used when using the soci library
+#  Soci_LIBRARY             = full path to the soci library
+#  Soci_VERSION             = the soci version found
+#  Soci_FOUND               = true if soci was found
 #
 # This module respects:
 #  LIB_SUFFIX         = (64|32|"") Specifies the suffix for the lib directory
 #
 # For each component you specify in find_package(), the following variables are set.
 #
-#  SOCI_${COMPONENT}_PLUGIN = full path to the soci plugin
-#  SOCI_${COMPONENT}_FOUND
+#  Soci_${COMPONENT}_PLUGIN = full path to the soci plugin (not set for the "core" component)
+#  Soci_${COMPONENT}_FOUND
+#
+# This module provides the following imported targets, if found:
 #
-# Copyright (c) 2011 Michael Jansen <info@michael-jansen.biz>
+#  Soci::core               = target for the core library and include directories
+#  Soci::${COMPONENT}       = target for each plugin
 #
 # Redistribution and use is allowed according to the terms of the BSD license.
 # For details see the accompanying COPYING-CMAKE-SCRIPTS file.
@@ -26,73 +27,114 @@
 #
 ### Global Configuration Section
 #
-SET(_SOCI_ALL_PLUGINS    mysql odbc postgresql sqlite3)
-SET(_SOCI_REQUIRED_VARS  SOCI_INCLUDE_DIR SOCI_LIBRARY)
+set(_SOCI_ALL_PLUGINS    mysql odbc postgresql sqlite3)
+set(_SOCI_REQUIRED_VARS  Soci_INCLUDE_DIR Soci_LIBRARY)
 
 #
 ### FIRST STEP: Find the soci headers.
 #
-FIND_PATH(
-    SOCI_INCLUDE_DIR soci.h
-    PATH "/usr/local"
+find_path(
+    Soci_INCLUDE_DIR soci.h
+    HINTS "/usr/local"
     PATH_SUFFIXES "" "soci"
     DOC "Soci (http://soci.sourceforge.net) include directory")
-MARK_AS_ADVANCED(SOCI_INCLUDE_DIR)
+mark_as_advanced(Soci_INCLUDE_DIR)
 
-SET(SOCI_INCLUDE_DIRS ${SOCI_INCLUDE_DIR})
+set(Soci_INCLUDE_DIRS ${Soci_INCLUDE_DIR} CACHE STRING "")
 
 #
 ### SECOND STEP: Find the soci core library. Respect LIB_SUFFIX
 #
-FIND_LIBRARY(
-    SOCI_LIBRARY
+find_library(
+    Soci_LIBRARY
     NAMES soci_core
-    HINTS ${SOCI_INCLUDE_DIR}/..
+    HINTS ${Soci_INCLUDE_DIR}/..
     PATH_SUFFIXES lib${LIB_SUFFIX})
-MARK_AS_ADVANCED(SOCI_LIBRARY)
+mark_as_advanced(Soci_LIBRARY)
 
-GET_FILENAME_COMPONENT(SOCI_LIBRARY_DIR ${SOCI_LIBRARY} PATH)
-MARK_AS_ADVANCED(SOCI_LIBRARY_DIR)
+get_filename_component(Soci_LIBRARY_DIR ${Soci_LIBRARY} PATH)
+mark_as_advanced(Soci_LIBRARY_DIR)
 
 #
 ### THIRD STEP: Find all installed plugins if the library was found
 #
-IF(SOCI_INCLUDE_DIR AND SOCI_LIBRARY)
+if(Soci_INCLUDE_DIR AND Soci_LIBRARY)
+    set(Soci_core_FOUND TRUE CACHE BOOL "")
 
-    MESSAGE(STATUS "Soci found: Looking for plugins")
-    FOREACH(plugin IN LISTS _SOCI_ALL_PLUGINS)
+    add_library(Soci::core UNKNOWN IMPORTED)
+    set_target_properties(
+        Soci::core
+        PROPERTIES IMPORTED_LOCATION "${Soci_LIBRARY}"
+        INTERFACE_INCLUDE_DIRECTORIES "${Soci_INCLUDE_DIR}"
+    )
 
-        FIND_LIBRARY(
-            SOCI_${plugin}_PLUGIN
-            NAMES soci_${plugin}
-            HINTS ${SOCI_INCLUDE_DIR}/..
-            PATH_SUFFIXES lib${LIB_SUFFIX})
-        MARK_AS_ADVANCED(SOCI_${plugin}_PLUGIN)
+    #
+    ### FOURTH STEP: Obtain SOCI version
+    #
+    set(Soci_VERSION_FILE "${Soci_INCLUDE_DIR}/version.h")
+    if(EXISTS "${Soci_VERSION_FILE}")
+        file(READ "${Soci_VERSION_FILE}" VERSION_CONTENT)
+        string(REGEX MATCH "#define[ \t]*SOCI_VERSION[ \t]*[0-9]+" VERSION_MATCH "${VERSION_CONTENT}")
+        string(REGEX REPLACE "#define[ \t]*SOCI_VERSION[ \t]*" "" VERSION_MATCH "${VERSION_MATCH}")
 
-        IF(SOCI_${plugin}_PLUGIN)
-            MESSAGE(STATUS "    * Plugin ${plugin} found ${SOCI_${plugin}_PLUGIN}.")
-            SET(SOCI_${plugin}_FOUND True)
-        ELSE()
-            MESSAGE(STATUS "    * Plugin ${plugin} not found.")
-            SET(SOCI_${plugin}_FOUND False)
-        ENDIF()
+        if(NOT VERSION_MATCH)
+            message(WARNING "Failed to extract SOCI version")
+        else()
+            math(EXPR MAJOR "${VERSION_MATCH} / 100000" OUTPUT_FORMAT DECIMAL)
+            math(EXPR MINOR "${VERSION_MATCH} / 100 % 1000" OUTPUT_FORMAT DECIMAL)
+            math(EXPR PATCH "${VERSION_MATCH} % 100" OUTPUT_FORMAT DECIMAL)
 
-    ENDFOREACH()
+            set(Soci_VERSION "${MAJOR}.${MINOR}.${PATCH}" CACHE STRING "")
+        endif()
+    else()
+        message(WARNING "Unable to check SOCI version")
+    endif()
 
-    #
-    ### FOURTH CHECK: Check if the required components were all found
-    #
-    FOREACH(component ${Soci_FIND_COMPONENTS})
-        IF(NOT SOCI_${component}_FOUND)
-            MESSAGE(SEND_ERROR "Required component ${component} not found.")
-        ENDIF()
-    ENDFOREACH()
+    foreach(plugin IN LISTS _SOCI_ALL_PLUGINS)
+
+        find_library(
+            Soci_${plugin}_PLUGIN
+            NAMES soci_${plugin}
+            HINTS ${Soci_INCLUDE_DIR}/..
+            PATH_SUFFIXES lib${LIB_SUFFIX})
+        mark_as_advanced(Soci_${plugin}_PLUGIN)
+
+        if(Soci_${plugin}_PLUGIN)
+            set(Soci_${plugin}_FOUND TRUE CACHE BOOL "")
+            add_library(Soci::${plugin} UNKNOWN IMPORTED)
+            set_target_properties(
+                Soci::${plugin}
+                PROPERTIES IMPORTED_LOCATION "${Soci_${plugin}_PLUGIN}"
+            )
+            target_link_libraries(Soci::${plugin} INTERFACE Soci::core)
+        else()
+            set(Soci_${plugin}_FOUND FALSE CACHE BOOL "")
+        endif()
 
-ENDIF()
+    endforeach()
+endif()
 
 #
 ### ADHERE TO STANDARDS
 #
 include(FindPackageHandleStandardArgs)
-FIND_PACKAGE_HANDLE_STANDARD_ARGS(Soci DEFAULT_MSG ${_SOCI_REQUIRED_VARS})
+find_package_handle_standard_args(Soci
+    REQUIRED_VARS ${_SOCI_REQUIRED_VARS}
+    VERSION_VAR Soci_VERSION
+    HANDLE_COMPONENTS
+)
 
+# For compatibility with previous versions of this script
+# DO NOT USE THESE VARIABLES IN NEW PROJECTS!
+set(SOCI_FOUND ${Soci_FOUND})
+set(SOCI_INCLUDE_DIRS ${Soci_INCLUDE_DIRS})
+set(SOCI_LIBRARY ${Soci_LIBRARY})
+set(SOCI_VERSION ${Soci_VERSION})
+set(SOCI_mysql_FOUND ${Soci_mysql_FOUND})
+set(SOCI_odbc_FOUND ${Soci_odbc_FOUND})
+set(SOCI_postgresql_FOUND ${Soci_postgresql_PLUGIN})
+set(SOCI_sqlite3_FOUND ${Soci_sqlite3_PLUGIN})
+set(SOCI_mysql_PLUGIN ${Soci_mysql_PLUGIN})
+set(SOCI_odbc_PLUGIN ${Soci_odbc_PLUGIN})
+set(SOCI_postgresql_PLUGIN ${Soci_postgresql_PLUGIN})
+set(SOCI_sqlite3_PLUGIN ${Soci_sqlite3_PLUGIN})
diff --git a/debian/changelog b/debian/changelog
index 82aa5e3..8691c8e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+soci (4.0.3+git20221201.0.80d4122-1) UNRELEASED; urgency=low
+
+  * New upstream snapshot.
+  * New upstream snapshot.
+
+ -- Debian Janitor <janitor@jelmer.uk>  Sun, 18 Dec 2022 09:16:44 -0000
+
 soci (4.0.3-1) unstable; urgency=medium
 
   * New upstream version 4.0.3.  Closes: 1017148
diff --git a/debian/patches/02-add-mysql-ddl-types.patch b/debian/patches/02-add-mysql-ddl-types.patch
index e92fb11..5196985 100644
--- a/debian/patches/02-add-mysql-ddl-types.patch
+++ b/debian/patches/02-add-mysql-ddl-types.patch
@@ -2,9 +2,11 @@ Description: Add two unusual column type entries to make liblinphone work
 Author: Dennis Filder <d.filder@web.de>
 Bug-Debian: https://bugs.debian.org/984534
 Last-Update: 2021-03-10
---- a/src/backends/sqlite3/statement.cpp
-+++ b/src/backends/sqlite3/statement.cpp
-@@ -440,6 +440,8 @@
+Index: soci.git/src/backends/sqlite3/statement.cpp
+===================================================================
+--- soci.git.orig/src/backends/sqlite3/statement.cpp
++++ soci.git/src/backends/sqlite3/statement.cpp
+@@ -440,6 +440,8 @@ static sqlite3_data_type_map get_data_ty
      m["mediumint"]          = dt_integer;
      m["smallint"]           = dt_integer;
      m["tinyint"]            = dt_integer;
diff --git a/docs/404.html b/docs/404.html
deleted file mode 100644
index 4c4c91f..0000000
--- a/docs/404.html
+++ /dev/null
@@ -1,318 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="/img/favicon.ico">
-        <title>SOCI (4.0.3)</title>
-        <link href="/css/bootstrap.min.css" rel="stylesheet">
-        <link href="/css/font-awesome.min.css" rel="stylesheet">
-        <link href="/css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="/js/jquery-1.10.2.min.js" defer></script>
-        <script src="/js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="/.">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="/." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="/quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="/installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="/structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="/license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="/faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="/connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="/queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="/binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="/indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="/types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="/lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="/statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="/transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="/procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="/errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="/logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="/interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="/backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="/backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="/backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="/backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="/backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="/backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="/backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="/backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="/beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="/multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="/boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="/utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="/vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="/api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="/api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="/languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="/languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="/languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="/languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/" class="nav-link"><i class="fa fa-github"></i> GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-
-    <div class="row-fluid">
-      <div id="main-content" class="span12">
-        <h1 id="404-page-not-found" style="text-align: center">404</h1>
-        <p style="text-align: center"><strong>Page not found</strong></p>
-      </div>
-    </div>
-
-
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "/",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="/js/base.js" defer></script>
-        <script src="/search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/api/backend.md b/docs/api/backend.md
new file mode 100644
index 0000000..bf99ad2
--- /dev/null
+++ b/docs/api/backend.md
@@ -0,0 +1,313 @@
+# Backends reference
+
+This part of the documentation is provided for those who want towrite (and contribute!) their
+own backends. It is anyway recommendedthat authors of new backend see the code of some existing
+backend forhints on how things are really done.
+
+The backend interface is a set of base classes that the actual backendsare supposed to specialize.
+The main SOCI interface uses only theinterface and respecting the protocol (for example,
+the order of function calls) described here.
+Note that both the interface and theprotocol were initially designed with the Oracle database in
+mind, which means that whereas it is quite natural with respect to the way Oracle API (OCI) works,
+it might impose some implementation burden on otherbackends, where things are done differently
+and therefore have to beadjusted, cached, converted, etc.
+
+The interface to the common SOCI interface is defined in the `core/soci-backend.h` header file.
+This file is dissected below.
+
+All names are defined in either `soci` or `soci::details` namespace.
+
+```cpp
+// data types, as seen by the user
+enum data_type
+{
+    dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long
+};
+
+// the enum type for indicator variables
+enum indicator { i_ok, i_null, i_truncated };
+
+// data types, as used to describe exchange format
+enum exchange_type
+{
+    x_char,
+    x_stdstring,
+    x_short,
+    x_integer,
+    x_long_long,
+    x_unsigned_long_long,
+    x_double,
+    x_stdtm,
+    x_statement,
+    x_rowid,
+    x_blob
+};
+
+struct cstring_descriptor
+{
+    cstring_descriptor(char * str, std::size_t bufSize)
+        : str_(str), bufSize_(bufSize) {}
+
+    char * str_;
+    std::size_t bufSize_;
+};
+
+// actually in error.h:
+class soci_error : public std::runtime_error
+{
+public:
+    soci_error(std::string const & msg);
+};
+```
+
+The `data_type` enumeration type defines all types that form the core type support for SOCI.
+The enum itself can be used by clients when dealing with dynamic rowset description.
+
+The `indicator` enumeration type defines all recognized *states* of data.
+The `i_truncated` state is provided for the case where the string is retrieved from the database
+into the char buffer that is not long enough to hold the whole value.
+
+The `exchange_type` enumeration type defines all possible types that can be used
+with the `into` and `use` elements.
+
+The `cstring_descriptor` is a helper class that allows to store the address of `char` buffer
+together with its size.
+The objects of this class are passed to the backend when the `x_cstring` type is involved.
+
+The `soci_error` class is an exception type used for database-related (and also usage-related) errors.
+The backends should throw exceptions of this or derived type only.
+
+```cpp
+class standard_into_type_backend
+{
+public:
+    standard_into_type_backend() {}
+    virtual ~standard_into_type_backend() {}
+
+    virtual void define_by_pos(int& position, void* data, exchange_type type) = 0;
+
+    virtual void pre_fetch() = 0;
+    virtual void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) = 0;
+
+    virtual void clean_up() = 0;
+};
+```
+
+The `standard_into_type_back_end` class implements the dynamic interactions with the simple
+(non-bulk) `into` elements.
+The objects of this class (or, rather, of the derived class implemented by the actual backend)
+are created by the `statement` object when the `into` element is bound - in terms of lifetime
+management, `statement` is the master of this class.
+
+* `define_by_pos` - Called when the `into` element is bound, once and before the statement is executed. The `data` pointer points to the variable used for `into` element (or to the `cstring_descriptor` object, which is artificially created when the plain `char` buffer is used for data exchange). The `position` parameter is a "column number", assigned by the library. The backend should increase this parameter, according to the number of fields actually taken (usually 1).
+* `pre_fetch` - Called before each row is fetched.
+* `post_fetch` - Called after each row is fetched. The `gotData` parameter is `true` if the fetch operation really retrievedsome data and `false` otherwise; `calledFromFetch` is `true` when the call is from the fetch operation and `false` if it is from the execute operation (this is also the case for simple, one-time queries). In particular, `(calledFromFetch && !gotData)` indicates that there is an end-of-rowset condition. `ind` points to the indicator provided by the user, or is `NULL`, if there is no indicator.
+* `clean_up` - Called once when the statement is destroyed.
+
+The intended use of `pre_fetch` and `post_fetch` functions is to manage any internal buffer and/or data conversion foreach value retrieved from the database.
+If the given server supportsbinary data transmission and the data format for the given type agreeswith what is used on the client machine, then these two functions neednot do anything; otherwise buffer management and data conversionsshould go there.
+
+```cpp
+class vector_into_type_backend
+{
+public:
+    vector_into_type_backend() {}
+    virtual ~vector_into_type_backend() {}
+
+    virtual void define_by_pos(int& position, void* data, exchange_type type) = 0;
+
+    virtual void pre_fetch() = 0;
+    virtual void post_fetch(bool gotData, indicator* ind) = 0;
+
+    virtual void resize(std::size_t sz) = 0;
+    virtual std::size_t size() = 0;
+
+    virtual void clean_up() = 0;
+};
+```
+
+The `vector_into_type_back_end` has similar structure and purpose as the previous one, but is used for vectors (bulk data retrieval).
+
+The `data` pointer points to the variable of type `std::vector<T>;` (and *not* to its internal buffer), `resize` is supposed to really resize the user-provided vector and `size` is supposed to return the current size of this vector.
+The important difference with regard to the previous class is that `ind` points (if not `NULL`) to the beginning of the *array* of indicators.
+The backend should fill this array according to the actual state of the retrieved data.
+
+* `bind_by_pos` - Called for each `use` element, once and before the statement is executed - for those `use` elements that do not provide explicit names for parameter binding. The meaning of parameters is same as in previous classes.
+* `bind_by_name` - Called for those `use` elements that provide the explicit name.
+* `pre_use` - Called before the data is transmitted to the server (this means before the statement is executed, which can happen many times for the prepared statement). `ind` points to the indicator provided by the user (or is `NULL`).
+* `post_use` - Called after statement execution. `gotData` and `ind` have the same meaning as in `standard_into_type_back_end::post_fetch`, and this can be used by those backends whose respective servers support two-way data exchange (like in/out parameters in stored procedures).
+
+The intended use for `pre_use` and `post_use` methods is to manage any internal buffers and/or data conversion.
+They can be called many times with the same statement.
+
+```cpp
+class vector_use_type_backend
+{
+public:
+    virtual ~vector_use_type_backend() {}
+
+    virtual void bind_by_pos(int& position,
+        void* data, exchange_type type) = 0;
+    virtual void bind_by_name(std::string const& name,
+        void* data, exchange_type type) = 0;
+
+    virtual void pre_use(indicator const* ind) = 0;
+
+    virtual std::size_t size() = 0;
+
+    virtual void clean_up() = 0;
+};
+```
+
+Objects of this type (or rather of type derived from this one) are used to implement interactions with user-provided vector (bulk) `use` elements and are managed by the `statement` object.
+The `data` pointer points to the whole vector object provided by the user (and *not* to its internal buffer); `ind` points to the beginning of the array of indicators (or is `NULL`).
+The meaning of this interface is analogous to those presented above.
+
+```cpp
+class statement_backend
+{
+public:
+    statement_backend() {}
+    virtual ~statement_backend() {}
+
+    virtual void alloc() = 0;
+    virtual void clean_up() = 0;
+
+    virtual void prepare(std::string const& query, statement_type eType) = 0;
+
+    enum exec_fetch_result
+    {
+        ef_success,
+        ef_no_data
+    };
+
+    virtual exec_fetch_result execute(int number) = 0;
+    virtual exec_fetch_result fetch(int number) = 0;
+
+    virtual long long get_affected_rows() = 0;
+    virtual int get_number_of_rows() = 0;
+
+    virtual std::string rewrite_for_procedure_call(std::string const& query) = 0;
+
+    virtual int prepare_for_describe() = 0;
+    virtual void describe_column(int colNum, data_type& dtype,
+        std::string& column_name) = 0;
+
+    virtual standard_into_type_backend* make_into_type_backend() = 0;
+    virtual standard_use_type_backend* make_use_type_backend() = 0;
+    virtual vector_into_type_backend* make_vector_into_type_backend() = 0;
+    virtual vector_use_type_backend* make_vector_use_type_backend() = 0;
+};
+```
+
+The `statement_backend` type implements the internals of the `statement` objects.
+The objects of this class are created by the `session` object.
+
+* `alloc` - Called once to allocate everything that is needed for the statement to work correctly.
+* `clean_up` - Supposed to clean up the resources, called once.
+* `prepare` - Called once with the text of the SQL query. For servers that support explicit query preparation, this is the place to do it.
+* `execute` - Called to execute the query; if number is zero, the intent is not to exchange data with the user-provided objects (`into` and `use` elements); positive values mean the number of rows to exchange (more than 1 is used only for bulk operations).
+* `fetch` - Called to fetch next bunch of rows; number is positive and determines the requested number of rows (more than 1 is used only for bulk operations).
+* `get_affected_rows` - Called to determine the actual number of rows affected by data modifying statement.
+* `get_number_of_rows` - Called to determine the actual number of rows retrieved by the previous call to `execute` or `fetch`.
+* `rewrite_for_procedure_call` - Used when the `procedure` is used instead of `statement`, to call the stored procedure. This function should rewrite the SQL query (if necessary) to the form that will allow to execute the given procedure.
+* `prepare_for_describe` - Called once when the `into` element is used with the `row` type, which means that dynamic rowset description should be performed. It is supposed to do whatever is needed to later describe the column properties and should return the number of columns.
+* `describe_column` - Called once for each column (column numbers - `colNum` - start from 1), should fill its parameters according to the column properties.
+* `make_into_type_backend`, `make_use_type_backend`, `make_vector_into_type_backend`, `make_vector_use_type_backend` - Called once for each `into` or `use` element, to create the objects of appropriate classes (described above).
+
+**Notes:**
+
+1. Whether the query is executed using the simple one-time syntax or is prepared, the `alloc`, `prepare` and `execute` functions are always called, in this order.
+2. All `into` and `use` elements are bound (their `define_by_pos` or `bind_by_pos`/`bind_by_name` functions are called) *between* statement preparation and execution.
+
+```cpp
+class rowid_backend
+{
+public:
+    virtual ~rowid_backend() {}
+};
+```
+
+The `rowid_backend` class is a hook for the backends to provide their own state for the row identifier. It has no functions, since the only portable interaction with the row identifier object is to use it with `into` and `use` elements.
+
+```cpp
+class blob_backend
+{
+public:
+    virtual ~blob_backend() {}
+
+    virtual std::size_t get_len() = 0;
+    virtual std::size_t read(std::size_t offset, char * buf,
+        std::size_t toRead) = 0;
+    virtual std::size_t write(std::size_t offset, char const * buf,
+        std::size_t toWrite) = 0;
+    virtual std::size_t append(char const * buf, std::size_t toWrite) = 0;
+    virtual void trim(std::size_t newLen) = 0;
+};
+```
+
+The `blob_backend` interface provides the entry points for the `blob` methods.
+
+```cpp
+class session_backend
+{
+public:
+    virtual ~session_backend() {}
+
+    virtual void begin() = 0;
+    virtual void commit() = 0;
+    virtual void rollback() = 0;
+
+    virtual bool get_next_sequence_value(session&, std::string const&, long long&);
+    virtual bool get_last_insert_id(session&, std::string const&, long long&);
+
+    virtual std::string get_backend_name() const = 0;
+
+    virtual statement_backend * make_statement_backend() = 0;
+    virtual rowid_backend * make_rowid_backend() = 0;
+    virtual blob_backend * make_blob_backend() = 0;
+};
+```
+
+The object of the class derived from `session_backend` implements the internals of the `session` object.
+
+* `begin`, `commit`, `rollback` - Forward-called when the same functions of `session` are called by user.
+* `get_next_sequence_value`, `get_last_insert_id` - Called to retrieve sequences or auto-generated values and every backend should define at least one of them to allow the code using auto-generated values to work.
+* `make_statement_backend`, `make_rowid_backend`, `make_blob_backend` - Called to create respective implementations for the `statement`, `rowid` and `blob` classes.
+
+```cpp
+struct backend_factory
+{
+    virtual ~backend_factory() {}
+
+    virtual details::session_backend * make_session(
+        std::string const& connectString) const = 0;
+};
+```
+
+The `backend_factory` is a base class for backend-provided factory class that is able to create valid sessions. The `connectString` parameter passed to `make_session` is provided here by the `session` constructor and contains only the backend-related parameters, without the backend name (if the dynamic backend loading is used).
+
+The actual backend factory object is supposed to be provided by the backend implementation and declared in its header file. In addition to this, the `factory_ABC` function with the "C" calling convention and returning the pointer to concrete factory object should be provided, where `ABC` is the backend name.
+
+The following example is taken from `soci-postgresql.h`, which declares entities of the PostgreSQL backend:
+
+```cpp
+struct postgresql_backend_factory : backend_factory
+{
+    virtual postgresql_session_backend* make_session(
+        std::string const& connectString) const;
+};
+extern postgresql_backend_factory const postgresql;
+
+extern "C"
+{
+
+// for dynamic backend loading
+backend_factory const * factory_postgresql();
+
+} // extern "C"
+```
+
+With the above declarations, it is enough to pass the `postgresql` factory name to the constructor of the `session` object, which will use this factory to create concrete implementations for any other objects that are needed, with the help of appropriate `make_XYZ` functions. Alternatively, the `factory_postgresql` function will be called automatically by the backend loader if the backend name is provided at run-time instead.
+
+Note that the backend source code is placed in the `backends/*name*` directory (for example, `backends/oracle`) and the test driver is in `backends/*name*/test`. There is also `backends/empty` directory provided as a skeleton for development of new backends and their tests. It is recommended that all backends respect naming conventions by just appending their name to the base-class names. The backend name used for the global factory object should clearly identify the given database engine, like `oracle`, `postgresql`, `mysql`, and so on.
diff --git a/docs/api/backend/index.html b/docs/api/backend/index.html
deleted file mode 100644
index 2464df6..0000000
--- a/docs/api/backend/index.html
+++ /dev/null
@@ -1,612 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>Backend API - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../client/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../../languages/ada/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/api/backend.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#backends-reference" class="nav-link">Backends reference</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="backends-reference">Backends reference</h1>
-<p>This part of the documentation is provided for those who want towrite (and contribute!) their
-own backends. It is anyway recommendedthat authors of new backend see the code of some existing
-backend forhints on how things are really done.</p>
-<p>The backend interface is a set of base classes that the actual backendsare supposed to specialize.
-The main SOCI interface uses only theinterface and respecting the protocol (for example,
-the order of function calls) described here.
-Note that both the interface and theprotocol were initially designed with the Oracle database in
-mind, which means that whereas it is quite natural with respect to the way Oracle API (OCI) works,
-it might impose some implementation burden on otherbackends, where things are done differently
-and therefore have to beadjusted, cached, converted, etc.</p>
-<p>The interface to the common SOCI interface is defined in the <code>core/soci-backend.h</code> header file.
-This file is dissected below.</p>
-<p>All names are defined in either <code>soci</code> or <code>soci::details</code> namespace.</p>
-<pre><code class="language-cpp">// data types, as seen by the user
-enum data_type
-{
-    dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long
-};
-
-// the enum type for indicator variables
-enum indicator { i_ok, i_null, i_truncated };
-
-// data types, as used to describe exchange format
-enum exchange_type
-{
-    x_char,
-    x_stdstring,
-    x_short,
-    x_integer,
-    x_long_long,
-    x_unsigned_long_long,
-    x_double,
-    x_stdtm,
-    x_statement,
-    x_rowid,
-    x_blob
-};
-
-struct cstring_descriptor
-{
-    cstring_descriptor(char * str, std::size_t bufSize)
-        : str_(str), bufSize_(bufSize) {}
-
-    char * str_;
-    std::size_t bufSize_;
-};
-
-// actually in error.h:
-class soci_error : public std::runtime_error
-{
-public:
-    soci_error(std::string const &amp; msg);
-};
-</code></pre>
-<p>The <code>data_type</code> enumeration type defines all types that form the core type support for SOCI.
-The enum itself can be used by clients when dealing with dynamic rowset description.</p>
-<p>The <code>indicator</code> enumeration type defines all recognized <em>states</em> of data.
-The <code>i_truncated</code> state is provided for the case where the string is retrieved from the database
-into the char buffer that is not long enough to hold the whole value.</p>
-<p>The <code>exchange_type</code> enumeration type defines all possible types that can be used
-with the <code>into</code> and <code>use</code> elements.</p>
-<p>The <code>cstring_descriptor</code> is a helper class that allows to store the address of <code>char</code> buffer
-together with its size.
-The objects of this class are passed to the backend when the <code>x_cstring</code> type is involved.</p>
-<p>The <code>soci_error</code> class is an exception type used for database-related (and also usage-related) errors.
-The backends should throw exceptions of this or derived type only.</p>
-<pre><code class="language-cpp">class standard_into_type_backend
-{
-public:
-    standard_into_type_backend() {}
-    virtual ~standard_into_type_backend() {}
-
-    virtual void define_by_pos(int&amp; position, void* data, exchange_type type) = 0;
-
-    virtual void pre_fetch() = 0;
-    virtual void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) = 0;
-
-    virtual void clean_up() = 0;
-};
-</code></pre>
-<p>The <code>standard_into_type_back_end</code> class implements the dynamic interactions with the simple
-(non-bulk) <code>into</code> elements.
-The objects of this class (or, rather, of the derived class implemented by the actual backend)
-are created by the <code>statement</code> object when the <code>into</code> element is bound - in terms of lifetime
-management, <code>statement</code> is the master of this class.</p>
-<ul>
-<li><code>define_by_pos</code> - Called when the <code>into</code> element is bound, once and before the statement is executed. The <code>data</code> pointer points to the variable used for <code>into</code> element (or to the <code>cstring_descriptor</code> object, which is artificially created when the plain <code>char</code> buffer is used for data exchange). The <code>position</code> parameter is a "column number", assigned by the library. The backend should increase this parameter, according to the number of fields actually taken (usually 1).</li>
-<li><code>pre_fetch</code> - Called before each row is fetched.</li>
-<li><code>post_fetch</code> - Called after each row is fetched. The <code>gotData</code> parameter is <code>true</code> if the fetch operation really retrievedsome data and <code>false</code> otherwise; <code>calledFromFetch</code> is <code>true</code> when the call is from the fetch operation and <code>false</code> if it is from the execute operation (this is also the case for simple, one-time queries). In particular, <code>(calledFromFetch &amp;&amp; !gotData)</code> indicates that there is an end-of-rowset condition. <code>ind</code> points to the indicator provided by the user, or is <code>NULL</code>, if there is no indicator.</li>
-<li><code>clean_up</code> - Called once when the statement is destroyed.</li>
-</ul>
-<p>The intended use of <code>pre_fetch</code> and <code>post_fetch</code> functions is to manage any internal buffer and/or data conversion foreach value retrieved from the database.
-If the given server supportsbinary data transmission and the data format for the given type agreeswith what is used on the client machine, then these two functions neednot do anything; otherwise buffer management and data conversionsshould go there.</p>
-<pre><code class="language-cpp">class vector_into_type_backend
-{
-public:
-    vector_into_type_backend() {}
-    virtual ~vector_into_type_backend() {}
-
-    virtual void define_by_pos(int&amp; position, void* data, exchange_type type) = 0;
-
-    virtual void pre_fetch() = 0;
-    virtual void post_fetch(bool gotData, indicator* ind) = 0;
-
-    virtual void resize(std::size_t sz) = 0;
-    virtual std::size_t size() = 0;
-
-    virtual void clean_up() = 0;
-};
-</code></pre>
-<p>The <code>vector_into_type_back_end</code> has similar structure and purpose as the previous one, but is used for vectors (bulk data retrieval).</p>
-<p>The <code>data</code> pointer points to the variable of type <code>std::vector&lt;T&gt;;</code> (and <em>not</em> to its internal buffer), <code>resize</code> is supposed to really resize the user-provided vector and <code>size</code> is supposed to return the current size of this vector.
-The important difference with regard to the previous class is that <code>ind</code> points (if not <code>NULL</code>) to the beginning of the <em>array</em> of indicators.
-The backend should fill this array according to the actual state of the retrieved data.</p>
-<ul>
-<li><code>bind_by_pos</code> - Called for each <code>use</code> element, once and before the statement is executed - for those <code>use</code> elements that do not provide explicit names for parameter binding. The meaning of parameters is same as in previous classes.</li>
-<li><code>bind_by_name</code> - Called for those <code>use</code> elements that provide the explicit name.</li>
-<li><code>pre_use</code> - Called before the data is transmitted to the server (this means before the statement is executed, which can happen many times for the prepared statement). <code>ind</code> points to the indicator provided by the user (or is <code>NULL</code>).</li>
-<li><code>post_use</code> - Called after statement execution. <code>gotData</code> and <code>ind</code> have the same meaning as in <code>standard_into_type_back_end::post_fetch</code>, and this can be used by those backends whose respective servers support two-way data exchange (like in/out parameters in stored procedures).</li>
-</ul>
-<p>The intended use for <code>pre_use</code> and <code>post_use</code> methods is to manage any internal buffers and/or data conversion.
-They can be called many times with the same statement.</p>
-<pre><code class="language-cpp">class vector_use_type_backend
-{
-public:
-    virtual ~vector_use_type_backend() {}
-
-    virtual void bind_by_pos(int&amp; position,
-        void* data, exchange_type type) = 0;
-    virtual void bind_by_name(std::string const&amp; name,
-        void* data, exchange_type type) = 0;
-
-    virtual void pre_use(indicator const* ind) = 0;
-
-    virtual std::size_t size() = 0;
-
-    virtual void clean_up() = 0;
-};
-</code></pre>
-<p>Objects of this type (or rather of type derived from this one) are used to implement interactions with user-provided vector (bulk) <code>use</code> elements and are managed by the <code>statement</code> object.
-The <code>data</code> pointer points to the whole vector object provided by the user (and <em>not</em> to its internal buffer); <code>ind</code> points to the beginning of the array of indicators (or is <code>NULL</code>).
-The meaning of this interface is analogous to those presented above.</p>
-<pre><code class="language-cpp">class statement_backend
-{
-public:
-    statement_backend() {}
-    virtual ~statement_backend() {}
-
-    virtual void alloc() = 0;
-    virtual void clean_up() = 0;
-
-    virtual void prepare(std::string const&amp; query, statement_type eType) = 0;
-
-    enum exec_fetch_result
-    {
-        ef_success,
-        ef_no_data
-    };
-
-    virtual exec_fetch_result execute(int number) = 0;
-    virtual exec_fetch_result fetch(int number) = 0;
-
-    virtual long long get_affected_rows() = 0;
-    virtual int get_number_of_rows() = 0;
-
-    virtual std::string rewrite_for_procedure_call(std::string const&amp; query) = 0;
-
-    virtual int prepare_for_describe() = 0;
-    virtual void describe_column(int colNum, data_type&amp; dtype,
-        std::string&amp; column_name) = 0;
-
-    virtual standard_into_type_backend* make_into_type_backend() = 0;
-    virtual standard_use_type_backend* make_use_type_backend() = 0;
-    virtual vector_into_type_backend* make_vector_into_type_backend() = 0;
-    virtual vector_use_type_backend* make_vector_use_type_backend() = 0;
-};
-</code></pre>
-<p>The <code>statement_backend</code> type implements the internals of the <code>statement</code> objects.
-The objects of this class are created by the <code>session</code> object.</p>
-<ul>
-<li><code>alloc</code> - Called once to allocate everything that is needed for the statement to work correctly.</li>
-<li><code>clean_up</code> - Supposed to clean up the resources, called once.</li>
-<li><code>prepare</code> - Called once with the text of the SQL query. For servers that support explicit query preparation, this is the place to do it.</li>
-<li><code>execute</code> - Called to execute the query; if number is zero, the intent is not to exchange data with the user-provided objects (<code>into</code> and <code>use</code> elements); positive values mean the number of rows to exchange (more than 1 is used only for bulk operations).</li>
-<li><code>fetch</code> - Called to fetch next bunch of rows; number is positive and determines the requested number of rows (more than 1 is used only for bulk operations).</li>
-<li><code>get_affected_rows</code> - Called to determine the actual number of rows affected by data modifying statement.</li>
-<li><code>get_number_of_rows</code> - Called to determine the actual number of rows retrieved by the previous call to <code>execute</code> or <code>fetch</code>.</li>
-<li><code>rewrite_for_procedure_call</code> - Used when the <code>procedure</code> is used instead of <code>statement</code>, to call the stored procedure. This function should rewrite the SQL query (if necessary) to the form that will allow to execute the given procedure.</li>
-<li><code>prepare_for_describe</code> - Called once when the <code>into</code> element is used with the <code>row</code> type, which means that dynamic rowset description should be performed. It is supposed to do whatever is needed to later describe the column properties and should return the number of columns.</li>
-<li><code>describe_column</code> - Called once for each column (column numbers - <code>colNum</code> - start from 1), should fill its parameters according to the column properties.</li>
-<li><code>make_into_type_backend</code>, <code>make_use_type_backend</code>, <code>make_vector_into_type_backend</code>, <code>make_vector_use_type_backend</code> - Called once for each <code>into</code> or <code>use</code> element, to create the objects of appropriate classes (described above).</li>
-</ul>
-<p><strong>Notes:</strong></p>
-<ol>
-<li>Whether the query is executed using the simple one-time syntax or is prepared, the <code>alloc</code>, <code>prepare</code> and <code>execute</code> functions are always called, in this order.</li>
-<li>All <code>into</code> and <code>use</code> elements are bound (their <code>define_by_pos</code> or <code>bind_by_pos</code>/<code>bind_by_name</code> functions are called) <em>between</em> statement preparation and execution.</li>
-</ol>
-<pre><code class="language-cpp">class rowid_backend
-{
-public:
-    virtual ~rowid_backend() {}
-};
-</code></pre>
-<p>The <code>rowid_backend</code> class is a hook for the backends to provide their own state for the row identifier. It has no functions, since the only portable interaction with the row identifier object is to use it with <code>into</code> and <code>use</code> elements.</p>
-<pre><code class="language-cpp">class blob_backend
-{
-public:
-    virtual ~blob_backend() {}
-
-    virtual std::size_t get_len() = 0;
-    virtual std::size_t read(std::size_t offset, char * buf,
-        std::size_t toRead) = 0;
-    virtual std::size_t write(std::size_t offset, char const * buf,
-        std::size_t toWrite) = 0;
-    virtual std::size_t append(char const * buf, std::size_t toWrite) = 0;
-    virtual void trim(std::size_t newLen) = 0;
-};
-</code></pre>
-<p>The <code>blob_backend</code> interface provides the entry points for the <code>blob</code> methods.</p>
-<pre><code class="language-cpp">class session_backend
-{
-public:
-    virtual ~session_backend() {}
-
-    virtual void begin() = 0;
-    virtual void commit() = 0;
-    virtual void rollback() = 0;
-
-    virtual bool get_next_sequence_value(session&amp;, std::string const&amp;, long long&amp;);
-    virtual bool get_last_insert_id(session&amp;, std::string const&amp;, long long&amp;);
-
-    virtual std::string get_backend_name() const = 0;
-
-    virtual statement_backend * make_statement_backend() = 0;
-    virtual rowid_backend * make_rowid_backend() = 0;
-    virtual blob_backend * make_blob_backend() = 0;
-};
-</code></pre>
-<p>The object of the class derived from <code>session_backend</code> implements the internals of the <code>session</code> object.</p>
-<ul>
-<li><code>begin</code>, <code>commit</code>, <code>rollback</code> - Forward-called when the same functions of <code>session</code> are called by user.</li>
-<li><code>get_next_sequence_value</code>, <code>get_last_insert_id</code> - Called to retrieve sequences or auto-generated values and every backend should define at least one of them to allow the code using auto-generated values to work.</li>
-<li><code>make_statement_backend</code>, <code>make_rowid_backend</code>, <code>make_blob_backend</code> - Called to create respective implementations for the <code>statement</code>, <code>rowid</code> and <code>blob</code> classes.</li>
-</ul>
-<pre><code class="language-cpp">struct backend_factory
-{
-    virtual ~backend_factory() {}
-
-    virtual details::session_backend * make_session(
-        std::string const&amp; connectString) const = 0;
-};
-</code></pre>
-<p>The <code>backend_factory</code> is a base class for backend-provided factory class that is able to create valid sessions. The <code>connectString</code> parameter passed to <code>make_session</code> is provided here by the <code>session</code> constructor and contains only the backend-related parameters, without the backend name (if the dynamic backend loading is used).</p>
-<p>The actual backend factory object is supposed to be provided by the backend implementation and declared in its header file. In addition to this, the <code>factory_ABC</code> function with the "C" calling convention and returning the pointer to concrete factory object should be provided, where <code>ABC</code> is the backend name.</p>
-<p>The following example is taken from <code>soci-postgresql.h</code>, which declares entities of the PostgreSQL backend:</p>
-<pre><code class="language-cpp">struct postgresql_backend_factory : backend_factory
-{
-    virtual postgresql_session_backend* make_session(
-        std::string const&amp; connectString) const;
-};
-extern postgresql_backend_factory const postgresql;
-
-extern &quot;C&quot;
-{
-
-// for dynamic backend loading
-backend_factory const * factory_postgresql();
-
-} // extern &quot;C&quot;
-</code></pre>
-<p>With the above declarations, it is enough to pass the <code>postgresql</code> factory name to the constructor of the <code>session</code> object, which will use this factory to create concrete implementations for any other objects that are needed, with the help of appropriate <code>make_XYZ</code> functions. Alternatively, the <code>factory_postgresql</code> function will be called automatically by the backend loader if the backend name is provided at run-time instead.</p>
-<p>Note that the backend source code is placed in the <code>backends/*name*</code> directory (for example, <code>backends/oracle</code>) and the test driver is in <code>backends/*name*/test</code>. There is also <code>backends/empty</code> directory provided as a skeleton for development of new backends and their tests. It is recommended that all backends respect naming conventions by just appending their name to the base-class names. The backend name used for the global factory object should clearly identify the given database engine, like <code>oracle</code>, <code>postgresql</code>, <code>mysql</code>, and so on.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/api/client.md b/docs/api/client.md
new file mode 100644
index 0000000..b149c04
--- /dev/null
+++ b/docs/api/client.md
@@ -0,0 +1,758 @@
+# API Reference
+
+The core client interface is a set of classes and free functions declared in the `soci.h` header file.
+All names are dbeclared in the `soci` namespace.
+
+There are also additional names declared in the `soci::details` namespace, but they are not supposed to be directly used by the users of the library and are therefore not documented here.
+When such types are used in the declarations that are part of the "public" interface, they are replaced by "IT", which means "internal type".
+Types related to the backend interface are named here.
+
+## Commonly used types
+
+The following types are commonly used in the rest of the interface:
+
+```cpp
+// data types, as seen by the user
+enum data_type { dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long };
+
+// the enum type for indicator variables
+enum indicator { i_ok, i_null, i_truncated };
+
+// the type used for reporting exceptions
+class soci_error : public std::runtime_error { /* ... */ };
+```
+
+The `data_type` type defines the basic SOCI data types. User provided data types need to be associated with one of these basic types.
+
+The `indicator` type defines the possible states of data.
+
+The `soci_error` type is used for error reporting.
+
+## class session
+
+The `session` class encapsulates the connection to the database.
+
+```cpp
+class session
+{
+public:
+    session();
+    explicit session(connection_parameters const & parameters);
+    session(backend_factory const & factory, std::string const & connectString);
+    session(std::string const & backendName, std::string const & connectString);
+    explicit session(std::string const & connectString);
+    explicit session(connection_pool & pool);
+
+    ~session();
+
+    void open(backend_factory const & factory, std::string const & connectString);
+    void open(std::string const & backendName, std::string const & connectString);
+    void open(std::string const & connectString);
+    void close();
+    void reconnect();
+
+    bool is_connected() const;
+
+    void begin();
+    void commit();
+    void rollback();
+
+    *IT* once;
+    *IT* prepare;
+
+    template <typename T> *IT* operator<<(T const & t);
+
+    bool got_data() const;
+
+    bool get_next_sequence_value(std::string const & sequence, long long & value);
+    bool get_last_insert_id(std::string const & table, long long & value);
+
+    std::ostringstream & get_query_stream();
+
+    void set_log_stream(std::ostream * s);
+    std::ostream * get_log_stream() const;
+
+    std::string get_last_query() const;
+
+    void uppercase_column_names(bool forceToUpper);
+
+    std::string get_dummy_from_table() const;
+    std::string get_dummy_from_clause() const;
+
+    details::session_backend * get_backend();
+
+    std::string get_backend_name() const;
+};
+```
+
+This class contains the following members:
+
+* Various constructors. The default one creates the session in the disconnected state. The others expect the backend factory object, or the backend name, or the URL-like composed connection string or the special parameters object containing both the backend and the connection string as well as possibly other connection options. The last constructor creates a session proxy associated with the session that is available in the given pool and releases it back to the pool  when its lifetime ends. Example:
+
+```cpp
+session sql(postgresql, "dbname=mydb");
+session sql("postgresql", "dbname=mydb");
+session sql("postgresql://dbname=mydb");
+```
+
+* The constructors that take backend name as string load the shared library (if not yet loaded) with name computed as `libsoci_ABC.so` (or `libsoci_ABC.dll` on Windows) where `ABC` is the given backend name.
+* `open`, `close` and `reconnect` functions for   reusing the same session object many times; the `reconnect` function attempts to establish the connection with the same parameters as most recently used with constructor or `open`. The arguments for `open` are treated in the same way as for constructors. `is_connected` can be used to check if there is an existing usable connection.
+* `begin`, `commit` and `rollback` functions for transaction control.
+* `once` member, which is used for performing *instant* queries that do not need to be separately prepared. Example:
+
+```cpp
+sql.once << "drop table persons";
+```
+
+* `prepare` member, which is used for statement preparation - the result of the statement preparation must be provided to the constructor of the `statement` class. Example:
+
+```cpp
+int i;
+statement st = (sql.prepare <<
+                "insert into numbers(value) values(:val)", use(i));
+```
+
+* `operator<<` that is a shortcut forwarder to the equivalent operator of the `once` member. Example:
+
+```cpp
+sql << "drop table persons";
+```
+
+* `got_data` returns true if the last executed query had non-empty result.
+* `get_next_sequence_value` returns true if the next value of   the sequence with the specified name was generated and returned in its second argument. Unless you can be sure that your program will use only   databases that support sequences, consider using this method in conjunction with `get_last_insert_id()` as explained in ["Working with sequences"](../beyond.md#sequences) section.
+* `get_last_insert_id` returns true if it could retrieve the last value automatically generated by the database for an auto-incremented field. Notice that although this method takes the table name, for some databases, such as Microsoft SQL Server and SQLite, this value is actually global, so you should attempt to retrieve it immediately after performing an insertion.
+* `get_query_stream` provides direct access to the stream object that is used to accumulate the query text and exists in particular to allow the user to imbue specific locale to this stream.
+* `set_log_stream` and `get_log_stream` functions for setting and getting the current stream object used for basic query logging. By default, it is `NULL`, which means no logging The string value that is actually logged into the stream is one-line verbatim copy of the query string provided by the user, without including any data from the `use` elements. The query is logged exactly once, before the preparation step.
+* `get_last_query` retrieves the text of the last used query.
+* `uppercase_column_names` allows to force all column names to uppercase in dynamic row description; this function is particularly useful for portability, since various database servers report column names differently (some preserve case, some change it).
+* `get_dummy_from_table` and `get_dummy_from_clause()`: helpers for writing portable DML statements, see [DML helpers](../utilities.md#dml) for more details.
+* `get_backend` returns the internal pointer to the concrete backend implementation of the session. This is provided for advanced users that need access to the functionality that is not otherwise available.
+* `get_backend_name` is a convenience forwarder to the same function of the backend object.
+
+See [connection](../connections.md) and [queries](../queries.md) for more examples.
+
+## class connection_parameters
+
+The `connection_parameters` class is a simple container for the backend pointer, connection string and any other connection options. It is used together with `session` constructor and `open()` method.
+
+```cpp
+class connection_parameters
+{
+public:
+    connection_parameters();
+    connection_parameters(backend_factory const & factory, std::string const & connectString);
+    connection_parameters(std::string const & backendName, std::string const & connectString);
+    explicit connection_parameters(std::string const & fullConnectString);
+
+    void set_option(const char * name, std::string const & value);
+    bool get_option(const char * name, std::string & value) const;
+
+    bool is_option_on(const char * name) const;
+};
+```
+
+The methods of this class are:
+
+* Default constructor is rarely used as it creates an uninitialized object and the only way to initialize it later is to assign another, valid, connection_parameters object to this one.
+* The other constructors correspond to the similar constructors of the `session` class and specify both the backend, either as a pointer to it or by name, and the connection string.
+* `set_option` can be used to set the value of an option with the given name. Currently all option values are strings, so if you need to set a numeric option you need to convert it to a string first. If an option with the given name had been already set before, its old value is overwritten.
+* `get_option` can be used to query the value of an option and returns `false` if there is no such option, while `is_option_on` simply checks if the option is specified with the value `soci::option_true` (which is a symbolic constant standing for the string `"1"`).
+
+## class connection_pool
+
+The `connection_pool` class encapsulates the thread-safe pool of connections and ensures that only one thread at a time has access to any connection that it manages.
+
+```cpp
+class connection_pool
+{
+public:
+    explicit connection_pool(std::size_t size);
+    ~connection_pool();
+
+    session & at(std::size_t pos);
+
+    std::size_t lease();
+    bool try_lease(std::size_t & pos, int timeout);
+    void give_back(std::size_t pos);
+};
+```
+
+The operations of the pool are:
+
+* Constructor that takes the intended size of the pool. After construction, the pool contains regular `session` objects in disconnected state.
+* `at` function that provides direct access to any given entryin the pool. This function is *non-synchronized*.
+* `lease` function waits until some entry is available (which means that it is not used) and returns the position of that entry in the pool, marking it as *locked*.
+* `try_lease` acts like `lease`, but allows to set up a time-out (relative, in milliseconds) on waiting. Negative time-out value means no time-out. Returns `true` if the entry was obtained, in which case its position is written to the `pos` parametr, and `false` if no entry was available before the time-out.
+* `give_back` should be called when the entry on the given position is no longer in use and can be passed to other requesting thread.
+
+## class transaction
+
+The class `transaction` can be used for associating the transaction with some code scope. It is a RAII wrapper for regular transaction operations that automatically rolls back in its destructor *if* the transaction was not explicitly committed before.
+
+```cpp
+class transaction
+{
+public:
+    explicit transaction(session & sql);
+
+    ~transaction();
+
+    void commit();
+    void rollback();
+
+private:
+    // ...
+};
+```
+
+Note that objects of this class are not notified of other transaction related operations that might be executed by user code explicitly or hidden inside SQL queries. It is not recommended to mix different ways of managing transactions.
+
+## function into
+
+The function `into` is used for binding local output data (in other words, it defines where the results of the query are stored).
+
+```cpp
+template <typename T>
+IT into(T & t);
+
+template <typename T, typename T1>
+IT into(T & t, T1 p1);
+
+template <typename T>
+IT into(T & t, indicator & ind);
+
+template <typename T, typename T1>
+IT into(T & t, indicator & ind, T1 p1);
+
+template <typename T>
+IT into(T & t, std::vector<indicator> & ind);
+```
+
+Example:
+
+```cpp
+int count;
+sql << "select count(*) from person", into(count);
+```
+
+See [Binding output data](../binding.md#binding-output-data-into) for more examples
+
+## function use
+
+The function `use` is used for binding local input data (in other words, it defines where the parameters of the query come from).
+
+```cpp
+template <typename T>
+*IT* use(T & t);
+
+template <typename T, typename T1>
+*IT* use(T & t, T1 p1);
+
+template <typename T>
+*IT* use(T & t, indicator & ind);
+
+template <typename T, typename T1>
+*IT* use(T & t, indicator & ind, T1 p1);
+
+template <typename T>
+*IT* use(T & t, std::vector<indicator> const & ind);
+
+template <typename T, typename T1>
+*IT* use(T & t, std::vector<indicator> const & ind, T1 p1);
+```
+
+Example:
+
+```cpp
+int val = 7;
+sql << "insert into numbers(val) values(:val)", use(val);
+```
+
+See [Binding input data](../binding.md#binding-input-data-use) for more examples.
+
+## class statement
+
+The `statement` class encapsulates the prepared statement.
+
+```cpp
+class statement
+{
+public:
+    statement(session & s);
+    statement(*IT* const & prep);
+    ~statement();
+
+    statement(statement const & other);
+    void operator=(statement const & other);
+
+    void alloc();
+    void bind(values & v);
+    void exchange(*IT* const & i);
+    void exchange(*IT* const & u);
+    void clean_up();
+    void bind_clean_up();
+
+    void prepare(std::string const & query);
+    void define_and_bind();
+
+    bool execute(bool withDataExchange = false);
+    long long get_affected_rows();
+    bool fetch();
+
+    bool got_data() const;
+
+    void describe();
+    void set_row(row * r);
+    void exchange_for_rowset(*IT* const & i);
+
+    details::statement_backend * get_backend();
+};
+```
+
+This class contains the following members:
+
+* Constructor accepting the `session` object. This can be used for later query preparation. Example:
+
+```cpp
+statement stmt(sql);
+```
+
+* Constructor accepting the result of using `prepare` on the `session` object, see example provided above for the `session` class.
+* Copy operations.
+* `alloc` function, which allocates necessary internal resources.
+* `bind` function, which is used to bind the `values` object - this is used in the object-relational mapping and normally called automatically.
+* exchange functions for registering the binding of local data - they expect the result of calling the `into` or `use` functions and are normally invoked automatically.
+* `clean_up` function for cleaning up resources, normally called automatically.
+* `bind_clean_up` function for cleaning up any bound references. It allows to keep statement in cache and reuse it later with new references by calling `exchange` for each new bind variable.
+* `prepare` function for preparing the statement for repeated execution.
+* `define_and_bind` function for actually executing the registered bindings, normally called automatically.
+* `execute` function for executing the statement. If its parameter is `false` then there is no data exchange with locally bound variables (this form should be used if later `fetch` of multiple rows is foreseen). Returns `true` if there was at least one row of data returned.
+* `get_affected_rows` function returns the number of rows affected by the last statement. Returns `-1` if it's not implemented by the backend being used.
+* `fetch` function for retrieving the next portion of the result. Returns `true` if there was new data.
+* `got_data` return `true` if the most recent execution returned any rows.
+* `describe` function for extracting the type information for the result (**Note:** no data is exchanged). This is normally called automatically and only when dynamic resultset binding is used.
+* `set_row` function for associating the `statement` and `row` objects, normally called automatically.
+* `exchange_for_rowset` as a special case for binding `rowset` objects.
+* `get_backend` function that returns the internal pointer to the concrete backend implementation of the statement object. This is provided for advanced users that need access to the functionality that is not otherwise available.
+
+See [Statement preparation and repeated execution](../statements.md) for example uses.
+
+Most of the functions from the `statement` class interface are called automatically, but can be also used explicitly. See [Interfaces](../interfaces.md) for the description of various way to use this interface.
+
+## class procedure
+
+The `procedure` class encapsulates the call to the stored procedure and is aimed for higher portability of the client code.
+
+```cpp
+class procedure
+{
+public:
+    procedure(*IT* const & prep);
+
+    bool execute(bool withDataExchange = false);
+    bool fetch();
+    bool got_data() const;
+};
+```
+
+The constructor expects the result of using `prepare` on the `session` object.
+
+See [Stored procedures](../procedures.md) for examples.
+
+## class type_conversion
+
+The `type_conversion` class is a traits class that is supposed to be provided (specialized) by the user for defining conversions to and from one of the basic SOCI types.
+
+```cpp
+template <typename T>
+struct type_conversion
+{
+    typedef T base_type;
+
+    static void from_base(base_type const & in, indicator ind, T & out);
+
+    static void to_base(T const & in, base_type & out, indicator & ind);
+};
+```
+
+Users are supposed to properly implement the `from_base` and `to_base` functions in their specializations of this template class.
+
+See [Extending SOCI to support custom (user-defined) C++ types](../types.md#user-defined-c-types).
+
+## class row
+
+The `row` class encapsulates the data and type information retrieved for the single row when the dynamic rowset binding is used.
+
+```cpp
+class row
+{
+public:
+    row();
+    ~row();
+
+    void uppercase_column_names(bool forceToUpper);
+
+    std::size_t size() const;
+
+    indicator get_indicator(std::size_t pos) const;
+    indicator get_indicator(std::string const & name) const;
+
+    column_properties const & get_properties (std::size_t pos) const;
+    column_properties const & get_properties (std::string const & name) const;
+
+    template <typename T>
+    T get(std::size_t pos) const;
+
+    template <typename T>
+    T get(std::size_t pos, T const & nullValue) const;
+
+    template <typename T>
+    T get(std::string const & name) const;
+
+    template <typename T>
+    T get(std::string const & name, T const & nullValue) const;
+
+    template <typename T>
+    row const & operator>>(T & value) const;
+
+    void skip(std::size_t num = 1) const;
+
+    void reset_get_counter() const
+};
+```
+
+This class contains the following members:
+
+* Default constructor that allows to declare a `row` variable.
+* `uppercase_column_names` - see the same function in the `session` class.
+* `size` function that returns the number of columns in the row.
+* `get_indicator` function that returns the indicator value for the given column (column is specified by position - starting from 0 - or by name).
+* `get_properties` function that returns the properties of the column given by position (starting from 0) or by name.
+* `get` functions that return the value of the column given by position or name. If the column contains null, then these functions either return the provided "default" `nullValue` or throw an exception.
+* `operator>>` for convenience stream-like extraction interface. Subsequent calls to this function are equivalent to calling `get` with increasing position parameter, starting from the beginning.
+* `skip` and `reset_get_counter` allow to change the order of data extraction for the above operator.
+
+See [Dynamic resultset binding](../types.md#dynamic-binding) for examples.
+
+## class column_properties
+
+The `column_properties` class provides the type and name information about the particular column in a rowset.
+
+```cpp
+class column_properties
+{
+public:
+    std::string get_name() const;
+    data_type get_data_type() const;
+};
+```
+
+This class contains the following members:
+
+* `get_name` function that returns the name of the column.
+* `get_data_type` that returns the type of the column.
+
+See [Dynamic resultset binding](../types.md#dynamic-binding) for examples.
+
+## class values
+
+The `values` class encapsulates the data and type information and is used for object-relational mapping.
+
+```cpp
+class values
+{
+public:
+    values();
+
+    void uppercase_column_names(bool forceToUpper);
+
+    indicator get_indicator(std::size_t pos) const;
+    indicator get_indicator(std::string const & name) const;
+
+    template <typename T>
+    T get(std::size_t pos) const;
+
+    template <typename T>
+    T get(std::size_t pos, T const & nullValue) const;
+
+    template <typename T>
+    T get(std::string const & name) const;
+
+    template <typename T>
+    T get(std::string const & name, T const & nullValue) const;
+
+    template <typename T>
+    values const & operator>>(T & value) const;
+
+    void skip(std::size_t num = 1) const;
+    void reset_get_counter() const;
+
+    template <typename T>
+    void set(std::string const & name, T const & value, indicator indic = i_ok);
+
+    template <typename T>
+    void set(const T & value, indicator indic = i_ok);
+
+    template <typename T>
+    values & operator<<(T const & value);
+};
+```
+
+This class contains the same members as the `row` class (with the same meaning) plus:
+
+* `set` function for storing values in named columns or in subsequent positions.
+* `operator<<` for convenience.
+
+See [Object-relational mapping](../types.md#object-relational-mapping) for examples.
+
+## class blob
+
+The `blob` class encapsulates the "large object" functionality.
+
+```cpp
+class blob
+{
+public:
+    explicit blob(session & s);
+    ~blob();
+
+    std::size_t getLen();
+    std::size_t read(std::size_t offset, char * buf, std::size_t toRead);
+    std::size_t write(std::size_t offset, char const * buf, std::size_t toWrite);
+    std::size_t append(char const * buf, std::size_t toWrite);
+    void trim(std::size_t newLen);
+
+    details::blob_backend * get_backend();
+};
+```
+
+This class contains the following members:
+
+* Constructor associating the `blob` object with the `session` object.
+* `get_len` function that returns the size of the BLOB object.
+* `read` function that reads the BLOB data into provided buffer.
+* `write` function that writes the BLOB data from provided buffer.
+* `append` function that appends to the existing BLOB data.
+* `trim` function that truncates the existing data to the new length.
+* `get_backend` function that returns the internal pointer to the concrete backend implementation of the BLOB object. This is provided for advanced users that need access to the functionality that is not otherwise available.
+
+See [Large objects (BLOBs)](../lobs.md) for more discussion.
+
+## class rowid
+
+The `rowid` class encapsulates the "row identifier" object.
+
+```cpp
+class rowid
+{
+public:
+    explicit rowid(Session & s);
+    ~rowid();
+
+    details::rowid_backend * get_backend();
+};
+```
+
+This class contains the following members:
+
+* Constructor associating the `rowid` object with the `session` object.
+* `get_backend` function that returns the internal pointer to the concrete backend implementation of the `rowid` object.
+
+## class backend_factory
+
+The `backend_factory` class provides the abstract interface for concrete backend factories.
+
+```cpp
+struct backend_factory
+{
+    virtual details::session_backend * make_session(
+        std::string const & connectString) const = 0;
+};
+```
+
+The only member of this class is the `make_session` function that is supposed to create concrete backend implementation of the session object.
+
+Objects of this type are declared by each backend and should be provided to the constructor of the `session` class. In simple programs users do not need to use this class directly, but the example use is:
+
+```cpp
+backend_factory & factory = postgresql;
+std::string connectionParameters = "dbname=mydb";
+
+session sql(factory, parameters);
+```
+
+## Simple Client Interface
+
+The simple client interface is provided with other languages in mind, to allow easy integration of the SOCI library with script interpreters and those languages that have the ability to link directly with object files using the "C" calling convention.
+
+The functionality of this interface is limited and in particular the dynamic rowset description and type conversions are not supported in this release. On the other hand, the important feature of this interface is that it does not require passing pointers to data managed by the user, because all data is handled at the SOCI side. This should make it easier to integrate SOCI with languages that have constrained ability to understand the C type system.
+
+Users of this interface need to explicitly `#include <soci-simple.h>`.
+
+```c
+typedef void * session_handle;
+session_handle soci_create_session(char const * connectionString);
+void soci_destroy_session(session_handle s);
+
+void soci_begin(session_handle s);
+void soci_commit(session_handle s);
+void soci_rollback(session_handle s);
+
+int soci_session_state(session_handle s);
+char const * soci_session_error_message(session_handle s);
+```
+
+The functions above provide the *session* abstraction with the help of opaque handle. The `soci_session_state` function returns `1` if there was no error during the most recently executed function and `0` otherwise, in which case the `soci_session_error_message` can be used to obtain a human-readable error description.
+
+Note that the only function that cannot report all errors this way is `soci_create_session`, which returns `NULL` if it was not possible to create an internal object representing the session. However, if the proxy object was created, but the connection could not be established for whatever reason, the error message can be obtained in the regular way.
+
+```c
+typedef void *blob_handle;
+blob_handle soci_create_blob(session_handle s);
+void soci_destroy_blob(blob_handle b);
+
+int soci_blob_get_len(blob_handle b);
+int soci_blob_read(blob_handle b, int offset, char *buf, int toRead);
+int soci_blob_write(blob_handle b, int offset, char const *buf, int toWrite);
+int soci_blob_append(blob_handle b, char const *buf, int toWrite);
+int soci_blob_trim(blob_handle b, int newLen);
+
+int soci_blob_state(blob_handle b);
+char const * soci_blob_error_message(blob_handle b);
+```
+
+The functions above provide the *blob* abstraction with the help of opaque handle. The `soci_blob_state` function returns `1` if there was no error during the most recently executed function and `0` otherwise, in which case the `soci_session_error_message` can be used to obtain a human-readable error description.
+
+For easy error testing, functions `soci_blob_read`, `soci_blob_write`, `soci_blob_append`, and `soci_blob_trim` return `-1` in case of error and `soci_session_error_message` can be used to obtain a human-readable error description.
+
+Note that the only function that cannot report all errors this way is `soci_create_blob`, which returns `NULL` if it was not possible to create an internal object representing the blob.
+
+```c
+typedef void * statement_handle;
+statement_handle soci_create_statement(session_handle s);
+void soci_destroy_statement(statement_handle st);
+
+int soci_statement_state(statement_handle s);
+char const * soci_statement_error_message(statement_handle s);
+```
+
+The functions above create and destroy the statement object. If the statement cannot be created by the `soci_create_statement` function, the error condition is set up in the related session object; for all other functions the error condition is set in the statement object itself.
+
+```c
+int soci_into_string   (statement_handle st);
+int soci_into_int      (statement_handle st);
+int soci_into_long_long(statement_handle st);
+int soci_into_double   (statement_handle st);
+int soci_into_date     (statement_handle st);
+int soci_into_blob     (statement_handle st);
+
+int soci_into_string_v   (statement_handle st);
+int soci_into_int_v      (statement_handle st);
+int soci_into_long_long_v(statement_handle st);
+int soci_into_double_v   (statement_handle st);
+int soci_into_date_v     (statement_handle st);
+```
+
+These functions create new data items for storing query results (*into elements*). These elements can be later identified by their position, which is counted from 0. For convenience, these function return the position of the currently added element. In case of error, `-1` is returned and the error condition is set in the statement object.
+
+The `_v` versions create a `vector` into elements, which can be used
+to retrieve whole arrays of results.
+
+```c
+int soci_get_into_state(statement_handle st, int position);
+int soci_get_into_state_v(statement_handle st, int position, int index);
+```
+
+This function returns `1` if the into element at the given position has non-null value and `0` otherwise. The `_v` version works with `vector` elements and expects an array index.
+
+```c
+char const * soci_get_into_string   (statement_handle st, int position);
+int          soci_get_into_int      (statement_handle st, int position);
+long long    soci_get_into_long_long(statement_handle st, int position);
+double       soci_get_into_double   (statement_handle st, int position);
+char const * soci_get_into_date     (statement_handle st, int position);
+blob_handle  soci_get_into_blob     (statement_handle st, int position);
+
+char const * soci_get_into_string_v   (statement_handle st, int position, int index);
+int          soci_get_into_int_v      (statement_handle st, int position, int index);
+long long    soci_get_into_long_long_v(statement_handle st, int position, int index);
+double       soci_get_into_double_v   (statement_handle st, int position, int index);
+char const * soci_get_into_date_v     (statement_handle st, int position, int index);
+```
+
+The functions above allow to retrieve the current value of the given into element.
+
+**Note:** The `date` function returns the date value in the "`YYYY MM DD HH mm ss`" string format.
+
+```c
+void soci_use_string   (statement_handle st, char const * name);
+void soci_use_int      (statement_handle st, char const * name);
+void soci_use_long_long(statement_handle st, char const * name);
+void soci_use_double   (statement_handle st, char const * name);
+void soci_use_date     (statement_handle st, char const * name);
+void soci_use_blob     (statement_handle st, char const * name);
+
+void soci_use_string_v   (statement_handle st, char const * name);
+void soci_use_int_v      (statement_handle st, char const * name);
+void soci_use_long_long_v(statement_handle st, char const * name);
+void soci_use_double_v   (statement_handle st, char const * name);
+void soci_use_date_v     (statement_handle st, char const * name);
+```
+
+The functions above allow to create new data elements that will be used to provide data to the query (*use elements*). The new elements can be later identified by given name, which must be unique for the given statement.
+
+```c
+void soci_set_use_state(statement_handle st, char const * name, int state);
+```
+
+The `soci_set_use_state` function allows to set the state of the given use element. If the `state` parameter is set to non-zero the use element is considered non-null (which is also the default state after creating the use element).
+
+```c
+int  soci_use_get_size_v(statement_handle st);
+void soci_use_resize_v  (statement_handle st, int new_size);
+```
+
+These functions get and set the size of vector use elements (see comments for vector into elements above).
+
+```c
+void soci_set_use_string   (statement_handle st, char const * name, char const * val);
+void soci_set_use_int      (statement_handle st, char const * name, int val);
+void soci_set_use_long_long(statement_handle st, char const * name, long long val);
+void soci_set_use_double   (statement_handle st, char const * name, double val);
+void soci_set_use_date     (statement_handle st, char const * name, char const * val);
+void soci_set_use_blob     (statement_handle st, char const * name, blob_handle blob);
+
+void soci_set_use_state_v    (statement_handle st, char const * name, int index, int state);
+void soci_set_use_string_v   (statement_handle st, char const * name, int index, char const * val);
+void soci_set_use_int_v      (statement_handle st, char const * name, int index, int val);
+void soci_set_use_long_long_v(statement_handle st, char const * name, int index, long long val);
+void soci_set_use_double_v   (statement_handle st, char const * name, int index, double val);
+void soci_set_use_date_v     (statement_handle st, char const * name, int index, char const * val);
+```
+
+The functions above set the value of the given use element, for both single and vector elements.
+
+**Note:** The expected format for the data values is "`YYYY MM DD HH mm ss`".
+
+```c
+int          soci_get_use_state    (statement_handle st, char const * name);
+char const * soci_get_use_string   (statement_handle st, char const * name);
+int          soci_get_use_int      (statement_handle st, char const * name);
+long long    soci_get_use_long_long(statement_handle st, char const * name);
+double       soci_get_use_double   (statement_handle st, char const * name);
+char const * soci_get_use_date     (statement_handle st, char const * name);
+blob_handle  soci_get_use_blob     (statement_handle st, char const * name);
+```
+
+These functions allow to inspect the state and value of named use elements.
+
+***Note:*** these functions are provide only for single use elements, not for vectors; the rationale for this is that modifiable use elements are not supported for bulk operations.
+
+```c
+void soci_prepare(statement_handle st, char const * query);
+int  soci_execute(statement_handle st, int withDataExchange);
+int  soci_fetch(statement_handle st);
+int  soci_got_data(statement_handle st);
+```
+
+The functions above provide the core execution functionality for the statement object and their meaning is equivalent to the respective functions in the core C++ interface described above.
diff --git a/docs/api/client/index.html b/docs/api/client/index.html
deleted file mode 100644
index fafd0a3..0000000
--- a/docs/api/client/index.html
+++ /dev/null
@@ -1,1020 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>Client API - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../../vagrant/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../backend/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/api/client.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#api-reference" class="nav-link">API Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#commonly-used-types" class="nav-link">Commonly used types</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-session" class="nav-link">class session</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-connection_parameters" class="nav-link">class connection_parameters</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-connection_pool" class="nav-link">class connection_pool</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-transaction" class="nav-link">class transaction</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#function-into" class="nav-link">function into</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#function-use" class="nav-link">function use</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-statement" class="nav-link">class statement</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-procedure" class="nav-link">class procedure</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-type_conversion" class="nav-link">class type_conversion</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-row" class="nav-link">class row</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-column_properties" class="nav-link">class column_properties</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-values" class="nav-link">class values</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-blob" class="nav-link">class blob</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-rowid" class="nav-link">class rowid</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#class-backend_factory" class="nav-link">class backend_factory</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#simple-client-interface" class="nav-link">Simple Client Interface</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="api-reference">API Reference</h1>
-<p>The core client interface is a set of classes and free functions declared in the <code>soci.h</code> header file.
-All names are dbeclared in the <code>soci</code> namespace.</p>
-<p>There are also additional names declared in the <code>soci::details</code> namespace, but they are not supposed to be directly used by the users of the library and are therefore not documented here.
-When such types are used in the declarations that are part of the "public" interface, they are replaced by "IT", which means "internal type".
-Types related to the backend interface are named here.</p>
-<h2 id="commonly-used-types">Commonly used types</h2>
-<p>The following types are commonly used in the rest of the interface:</p>
-<pre><code class="language-cpp">// data types, as seen by the user
-enum data_type { dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long };
-
-// the enum type for indicator variables
-enum indicator { i_ok, i_null, i_truncated };
-
-// the type used for reporting exceptions
-class soci_error : public std::runtime_error { /* ... */ };
-</code></pre>
-<p>The <code>data_type</code> type defines the basic SOCI data types. User provided data types need to be associated with one of these basic types.</p>
-<p>The <code>indicator</code> type defines the possible states of data.</p>
-<p>The <code>soci_error</code> type is used for error reporting.</p>
-<h2 id="class-session">class session</h2>
-<p>The <code>session</code> class encapsulates the connection to the database.</p>
-<pre><code class="language-cpp">class session
-{
-public:
-    session();
-    explicit session(connection_parameters const &amp; parameters);
-    session(backend_factory const &amp; factory, std::string const &amp; connectString);
-    session(std::string const &amp; backendName, std::string const &amp; connectString);
-    explicit session(std::string const &amp; connectString);
-    explicit session(connection_pool &amp; pool);
-
-    ~session();
-
-    void open(backend_factory const &amp; factory, std::string const &amp; connectString);
-    void open(std::string const &amp; backendName, std::string const &amp; connectString);
-    void open(std::string const &amp; connectString);
-    void close();
-    void reconnect();
-
-    bool is_connected() const;
-
-    void begin();
-    void commit();
-    void rollback();
-
-    *IT* once;
-    *IT* prepare;
-
-    template &lt;typename T&gt; *IT* operator&lt;&lt;(T const &amp; t);
-
-    bool got_data() const;
-
-    bool get_next_sequence_value(std::string const &amp; sequence, long long &amp; value);
-    bool get_last_insert_id(std::string const &amp; table, long long &amp; value);
-
-    std::ostringstream &amp; get_query_stream();
-
-    void set_log_stream(std::ostream * s);
-    std::ostream * get_log_stream() const;
-
-    std::string get_last_query() const;
-
-    void uppercase_column_names(bool forceToUpper);
-
-    std::string get_dummy_from_table() const;
-    std::string get_dummy_from_clause() const;
-
-    details::session_backend * get_backend();
-
-    std::string get_backend_name() const;
-};
-</code></pre>
-<p>This class contains the following members:</p>
-<ul>
-<li>Various constructors. The default one creates the session in the disconnected state. The others expect the backend factory object, or the backend name, or the URL-like composed connection string or the special parameters object containing both the backend and the connection string as well as possibly other connection options. The last constructor creates a session proxy associated with the session that is available in the given pool and releases it back to the pool  when its lifetime ends. Example:</li>
-</ul>
-<pre><code class="language-cpp">session sql(postgresql, &quot;dbname=mydb&quot;);
-session sql(&quot;postgresql&quot;, &quot;dbname=mydb&quot;);
-session sql(&quot;postgresql://dbname=mydb&quot;);
-</code></pre>
-<ul>
-<li>The constructors that take backend name as string load the shared library (if not yet loaded) with name computed as <code>libsoci_ABC.so</code> (or <code>libsoci_ABC.dll</code> on Windows) where <code>ABC</code> is the given backend name.</li>
-<li><code>open</code>, <code>close</code> and <code>reconnect</code> functions for   reusing the same session object many times; the <code>reconnect</code> function attempts to establish the connection with the same parameters as most recently used with constructor or <code>open</code>. The arguments for <code>open</code> are treated in the same way as for constructors. <code>is_connected</code> can be used to check if there is an existing usable connection.</li>
-<li><code>begin</code>, <code>commit</code> and <code>rollback</code> functions for transaction control.</li>
-<li><code>once</code> member, which is used for performing <em>instant</em> queries that do not need to be separately prepared. Example:</li>
-</ul>
-<pre><code class="language-cpp">sql.once &lt;&lt; &quot;drop table persons&quot;;
-</code></pre>
-<ul>
-<li><code>prepare</code> member, which is used for statement preparation - the result of the statement preparation must be provided to the constructor of the <code>statement</code> class. Example:</li>
-</ul>
-<pre><code class="language-cpp">int i;
-statement st = (sql.prepare &lt;&lt;
-                &quot;insert into numbers(value) values(:val)&quot;, use(i));
-</code></pre>
-<ul>
-<li><code>operator&lt;&lt;</code> that is a shortcut forwarder to the equivalent operator of the <code>once</code> member. Example:</li>
-</ul>
-<pre><code class="language-cpp">sql &lt;&lt; &quot;drop table persons&quot;;
-</code></pre>
-<ul>
-<li><code>got_data</code> returns true if the last executed query had non-empty result.</li>
-<li><code>get_next_sequence_value</code> returns true if the next value of   the sequence with the specified name was generated and returned in its second argument. Unless you can be sure that your program will use only   databases that support sequences, consider using this method in conjunction with <code>get_last_insert_id()</code> as explained in <a href="../../beyond/#sequences">"Working with sequences"</a> section.</li>
-<li><code>get_last_insert_id</code> returns true if it could retrieve the last value automatically generated by the database for an auto-incremented field. Notice that although this method takes the table name, for some databases, such as Microsoft SQL Server and SQLite, this value is actually global, so you should attempt to retrieve it immediately after performing an insertion.</li>
-<li><code>get_query_stream</code> provides direct access to the stream object that is used to accumulate the query text and exists in particular to allow the user to imbue specific locale to this stream.</li>
-<li><code>set_log_stream</code> and <code>get_log_stream</code> functions for setting and getting the current stream object used for basic query logging. By default, it is <code>NULL</code>, which means no logging The string value that is actually logged into the stream is one-line verbatim copy of the query string provided by the user, without including any data from the <code>use</code> elements. The query is logged exactly once, before the preparation step.</li>
-<li><code>get_last_query</code> retrieves the text of the last used query.</li>
-<li><code>uppercase_column_names</code> allows to force all column names to uppercase in dynamic row description; this function is particularly useful for portability, since various database servers report column names differently (some preserve case, some change it).</li>
-<li><code>get_dummy_from_table</code> and <code>get_dummy_from_clause()</code>: helpers for writing portable DML statements, see <a href="../../utilities/#dml">DML helpers</a> for more details.</li>
-<li><code>get_backend</code> returns the internal pointer to the concrete backend implementation of the session. This is provided for advanced users that need access to the functionality that is not otherwise available.</li>
-<li><code>get_backend_name</code> is a convenience forwarder to the same function of the backend object.</li>
-</ul>
-<p>See <a href="../../connections/">connection</a> and <a href="../../queries/">queries</a> for more examples.</p>
-<h2 id="class-connection_parameters">class connection_parameters</h2>
-<p>The <code>connection_parameters</code> class is a simple container for the backend pointer, connection string and any other connection options. It is used together with <code>session</code> constructor and <code>open()</code> method.</p>
-<pre><code class="language-cpp">class connection_parameters
-{
-public:
-    connection_parameters();
-    connection_parameters(backend_factory const &amp; factory, std::string const &amp; connectString);
-    connection_parameters(std::string const &amp; backendName, std::string const &amp; connectString);
-    explicit connection_parameters(std::string const &amp; fullConnectString);
-
-    void set_option(const char * name, std::string const &amp; value);
-    bool get_option(const char * name, std::string &amp; value) const;
-
-    bool is_option_on(const char * name) const;
-};
-</code></pre>
-<p>The methods of this class are:</p>
-<ul>
-<li>Default constructor is rarely used as it creates an uninitialized object and the only way to initialize it later is to assign another, valid, connection_parameters object to this one.</li>
-<li>The other constructors correspond to the similar constructors of the <code>session</code> class and specify both the backend, either as a pointer to it or by name, and the connection string.</li>
-<li><code>set_option</code> can be used to set the value of an option with the given name. Currently all option values are strings, so if you need to set a numeric option you need to convert it to a string first. If an option with the given name had been already set before, its old value is overwritten.</li>
-<li><code>get_option</code> can be used to query the value of an option and returns <code>false</code> if there is no such option, while <code>is_option_on</code> simply checks if the option is specified with the value <code>soci::option_true</code> (which is a symbolic constant standing for the string <code>"1"</code>).</li>
-</ul>
-<h2 id="class-connection_pool">class connection_pool</h2>
-<p>The <code>connection_pool</code> class encapsulates the thread-safe pool of connections and ensures that only one thread at a time has access to any connection that it manages.</p>
-<pre><code class="language-cpp">class connection_pool
-{
-public:
-    explicit connection_pool(std::size_t size);
-    ~connection_pool();
-
-    session &amp; at(std::size_t pos);
-
-    std::size_t lease();
-    bool try_lease(std::size_t &amp; pos, int timeout);
-    void give_back(std::size_t pos);
-};
-</code></pre>
-<p>The operations of the pool are:</p>
-<ul>
-<li>Constructor that takes the intended size of the pool. After construction, the pool contains regular <code>session</code> objects in disconnected state.</li>
-<li><code>at</code> function that provides direct access to any given entryin the pool. This function is <em>non-synchronized</em>.</li>
-<li><code>lease</code> function waits until some entry is available (which means that it is not used) and returns the position of that entry in the pool, marking it as <em>locked</em>.</li>
-<li><code>try_lease</code> acts like <code>lease</code>, but allows to set up a time-out (relative, in milliseconds) on waiting. Negative time-out value means no time-out. Returns <code>true</code> if the entry was obtained, in which case its position is written to the <code>pos</code> parametr, and <code>false</code> if no entry was available before the time-out.</li>
-<li><code>give_back</code> should be called when the entry on the given position is no longer in use and can be passed to other requesting thread.</li>
-</ul>
-<h2 id="class-transaction">class transaction</h2>
-<p>The class <code>transaction</code> can be used for associating the transaction with some code scope. It is a RAII wrapper for regular transaction operations that automatically rolls back in its destructor <em>if</em> the transaction was not explicitly committed before.</p>
-<pre><code class="language-cpp">class transaction
-{
-public:
-    explicit transaction(session &amp; sql);
-
-    ~transaction();
-
-    void commit();
-    void rollback();
-
-private:
-    // ...
-};
-</code></pre>
-<p>Note that objects of this class are not notified of other transaction related operations that might be executed by user code explicitly or hidden inside SQL queries. It is not recommended to mix different ways of managing transactions.</p>
-<h2 id="function-into">function into</h2>
-<p>The function <code>into</code> is used for binding local output data (in other words, it defines where the results of the query are stored).</p>
-<pre><code class="language-cpp">template &lt;typename T&gt;
-IT into(T &amp; t);
-
-template &lt;typename T, typename T1&gt;
-IT into(T &amp; t, T1 p1);
-
-template &lt;typename T&gt;
-IT into(T &amp; t, indicator &amp; ind);
-
-template &lt;typename T, typename T1&gt;
-IT into(T &amp; t, indicator &amp; ind, T1 p1);
-
-template &lt;typename T&gt;
-IT into(T &amp; t, std::vector&lt;indicator&gt; &amp; ind);
-</code></pre>
-<p>Example:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from person&quot;, into(count);
-</code></pre>
-<p>See <a href="../../binding/#binding-output-data-into">Binding output data</a> for more examples</p>
-<h2 id="function-use">function use</h2>
-<p>The function <code>use</code> is used for binding local input data (in other words, it defines where the parameters of the query come from).</p>
-<pre><code class="language-cpp">template &lt;typename T&gt;
-*IT* use(T &amp; t);
-
-template &lt;typename T, typename T1&gt;
-*IT* use(T &amp; t, T1 p1);
-
-template &lt;typename T&gt;
-*IT* use(T &amp; t, indicator &amp; ind);
-
-template &lt;typename T, typename T1&gt;
-*IT* use(T &amp; t, indicator &amp; ind, T1 p1);
-
-template &lt;typename T&gt;
-*IT* use(T &amp; t, std::vector&lt;indicator&gt; const &amp; ind);
-
-template &lt;typename T, typename T1&gt;
-*IT* use(T &amp; t, std::vector&lt;indicator&gt; const &amp; ind, T1 p1);
-</code></pre>
-<p>Example:</p>
-<pre><code class="language-cpp">int val = 7;
-sql &lt;&lt; &quot;insert into numbers(val) values(:val)&quot;, use(val);
-</code></pre>
-<p>See <a href="../../binding/#binding-input-data-use">Binding input data</a> for more examples.</p>
-<h2 id="class-statement">class statement</h2>
-<p>The <code>statement</code> class encapsulates the prepared statement.</p>
-<pre><code class="language-cpp">class statement
-{
-public:
-    statement(session &amp; s);
-    statement(*IT* const &amp; prep);
-    ~statement();
-
-    statement(statement const &amp; other);
-    void operator=(statement const &amp; other);
-
-    void alloc();
-    void bind(values &amp; v);
-    void exchange(*IT* const &amp; i);
-    void exchange(*IT* const &amp; u);
-    void clean_up();
-    void bind_clean_up();
-
-    void prepare(std::string const &amp; query);
-    void define_and_bind();
-
-    bool execute(bool withDataExchange = false);
-    long long get_affected_rows();
-    bool fetch();
-
-    bool got_data() const;
-
-    void describe();
-    void set_row(row * r);
-    void exchange_for_rowset(*IT* const &amp; i);
-
-    details::statement_backend * get_backend();
-};
-</code></pre>
-<p>This class contains the following members:</p>
-<ul>
-<li>Constructor accepting the <code>session</code> object. This can be used for later query preparation. Example:</li>
-</ul>
-<pre><code class="language-cpp">statement stmt(sql);
-</code></pre>
-<ul>
-<li>Constructor accepting the result of using <code>prepare</code> on the <code>session</code> object, see example provided above for the <code>session</code> class.</li>
-<li>Copy operations.</li>
-<li><code>alloc</code> function, which allocates necessary internal resources.</li>
-<li><code>bind</code> function, which is used to bind the <code>values</code> object - this is used in the object-relational mapping and normally called automatically.</li>
-<li>exchange functions for registering the binding of local data - they expect the result of calling the <code>into</code> or <code>use</code> functions and are normally invoked automatically.</li>
-<li><code>clean_up</code> function for cleaning up resources, normally called automatically.</li>
-<li><code>bind_clean_up</code> function for cleaning up any bound references. It allows to keep statement in cache and reuse it later with new references by calling <code>exchange</code> for each new bind variable.</li>
-<li><code>prepare</code> function for preparing the statement for repeated execution.</li>
-<li><code>define_and_bind</code> function for actually executing the registered bindings, normally called automatically.</li>
-<li><code>execute</code> function for executing the statement. If its parameter is <code>false</code> then there is no data exchange with locally bound variables (this form should be used if later <code>fetch</code> of multiple rows is foreseen). Returns <code>true</code> if there was at least one row of data returned.</li>
-<li><code>get_affected_rows</code> function returns the number of rows affected by the last statement. Returns <code>-1</code> if it's not implemented by the backend being used.</li>
-<li><code>fetch</code> function for retrieving the next portion of the result. Returns <code>true</code> if there was new data.</li>
-<li><code>got_data</code> return <code>true</code> if the most recent execution returned any rows.</li>
-<li><code>describe</code> function for extracting the type information for the result (<strong>Note:</strong> no data is exchanged). This is normally called automatically and only when dynamic resultset binding is used.</li>
-<li><code>set_row</code> function for associating the <code>statement</code> and <code>row</code> objects, normally called automatically.</li>
-<li><code>exchange_for_rowset</code> as a special case for binding <code>rowset</code> objects.</li>
-<li><code>get_backend</code> function that returns the internal pointer to the concrete backend implementation of the statement object. This is provided for advanced users that need access to the functionality that is not otherwise available.</li>
-</ul>
-<p>See <a href="../../statements/">Statement preparation and repeated execution</a> for example uses.</p>
-<p>Most of the functions from the <code>statement</code> class interface are called automatically, but can be also used explicitly. See <a href="../../interfaces/">Interfaces</a> for the description of various way to use this interface.</p>
-<h2 id="class-procedure">class procedure</h2>
-<p>The <code>procedure</code> class encapsulates the call to the stored procedure and is aimed for higher portability of the client code.</p>
-<pre><code class="language-cpp">class procedure
-{
-public:
-    procedure(*IT* const &amp; prep);
-
-    bool execute(bool withDataExchange = false);
-    bool fetch();
-    bool got_data() const;
-};
-</code></pre>
-<p>The constructor expects the result of using <code>prepare</code> on the <code>session</code> object.</p>
-<p>See <a href="../../procedures/">Stored procedures</a> for examples.</p>
-<h2 id="class-type_conversion">class type_conversion</h2>
-<p>The <code>type_conversion</code> class is a traits class that is supposed to be provided (specialized) by the user for defining conversions to and from one of the basic SOCI types.</p>
-<pre><code class="language-cpp">template &lt;typename T&gt;
-struct type_conversion
-{
-    typedef T base_type;
-
-    static void from_base(base_type const &amp; in, indicator ind, T &amp; out);
-
-    static void to_base(T const &amp; in, base_type &amp; out, indicator &amp; ind);
-};
-</code></pre>
-<p>Users are supposed to properly implement the <code>from_base</code> and <code>to_base</code> functions in their specializations of this template class.</p>
-<p>See <a href="../../types/#user-defined-c-types">Extending SOCI to support custom (user-defined) C++ types</a>.</p>
-<h2 id="class-row">class row</h2>
-<p>The <code>row</code> class encapsulates the data and type information retrieved for the single row when the dynamic rowset binding is used.</p>
-<pre><code class="language-cpp">class row
-{
-public:
-    row();
-    ~row();
-
-    void uppercase_column_names(bool forceToUpper);
-
-    std::size_t size() const;
-
-    indicator get_indicator(std::size_t pos) const;
-    indicator get_indicator(std::string const &amp; name) const;
-
-    column_properties const &amp; get_properties (std::size_t pos) const;
-    column_properties const &amp; get_properties (std::string const &amp; name) const;
-
-    template &lt;typename T&gt;
-    T get(std::size_t pos) const;
-
-    template &lt;typename T&gt;
-    T get(std::size_t pos, T const &amp; nullValue) const;
-
-    template &lt;typename T&gt;
-    T get(std::string const &amp; name) const;
-
-    template &lt;typename T&gt;
-    T get(std::string const &amp; name, T const &amp; nullValue) const;
-
-    template &lt;typename T&gt;
-    row const &amp; operator&gt;&gt;(T &amp; value) const;
-
-    void skip(std::size_t num = 1) const;
-
-    void reset_get_counter() const
-};
-</code></pre>
-<p>This class contains the following members:</p>
-<ul>
-<li>Default constructor that allows to declare a <code>row</code> variable.</li>
-<li><code>uppercase_column_names</code> - see the same function in the <code>session</code> class.</li>
-<li><code>size</code> function that returns the number of columns in the row.</li>
-<li><code>get_indicator</code> function that returns the indicator value for the given column (column is specified by position - starting from 0 - or by name).</li>
-<li><code>get_properties</code> function that returns the properties of the column given by position (starting from 0) or by name.</li>
-<li><code>get</code> functions that return the value of the column given by position or name. If the column contains null, then these functions either return the provided "default" <code>nullValue</code> or throw an exception.</li>
-<li><code>operator&gt;&gt;</code> for convenience stream-like extraction interface. Subsequent calls to this function are equivalent to calling <code>get</code> with increasing position parameter, starting from the beginning.</li>
-<li><code>skip</code> and <code>reset_get_counter</code> allow to change the order of data extraction for the above operator.</li>
-</ul>
-<p>See <a href="../../types/#dynamic-binding">Dynamic resultset binding</a> for examples.</p>
-<h2 id="class-column_properties">class column_properties</h2>
-<p>The <code>column_properties</code> class provides the type and name information about the particular column in a rowset.</p>
-<pre><code class="language-cpp">class column_properties
-{
-public:
-    std::string get_name() const;
-    data_type get_data_type() const;
-};
-</code></pre>
-<p>This class contains the following members:</p>
-<ul>
-<li><code>get_name</code> function that returns the name of the column.</li>
-<li><code>get_data_type</code> that returns the type of the column.</li>
-</ul>
-<p>See <a href="../../types/#dynamic-binding">Dynamic resultset binding</a> for examples.</p>
-<h2 id="class-values">class values</h2>
-<p>The <code>values</code> class encapsulates the data and type information and is used for object-relational mapping.</p>
-<pre><code class="language-cpp">class values
-{
-public:
-    values();
-
-    void uppercase_column_names(bool forceToUpper);
-
-    indicator get_indicator(std::size_t pos) const;
-    indicator get_indicator(std::string const &amp; name) const;
-
-    template &lt;typename T&gt;
-    T get(std::size_t pos) const;
-
-    template &lt;typename T&gt;
-    T get(std::size_t pos, T const &amp; nullValue) const;
-
-    template &lt;typename T&gt;
-    T get(std::string const &amp; name) const;
-
-    template &lt;typename T&gt;
-    T get(std::string const &amp; name, T const &amp; nullValue) const;
-
-    template &lt;typename T&gt;
-    values const &amp; operator&gt;&gt;(T &amp; value) const;
-
-    void skip(std::size_t num = 1) const;
-    void reset_get_counter() const;
-
-    template &lt;typename T&gt;
-    void set(std::string const &amp; name, T const &amp; value, indicator indic = i_ok);
-
-    template &lt;typename T&gt;
-    void set(const T &amp; value, indicator indic = i_ok);
-
-    template &lt;typename T&gt;
-    values &amp; operator&lt;&lt;(T const &amp; value);
-};
-</code></pre>
-<p>This class contains the same members as the <code>row</code> class (with the same meaning) plus:</p>
-<ul>
-<li><code>set</code> function for storing values in named columns or in subsequent positions.</li>
-<li><code>operator&lt;&lt;</code> for convenience.</li>
-</ul>
-<p>See <a href="../../types/#object-relational-mapping">Object-relational mapping</a> for examples.</p>
-<h2 id="class-blob">class blob</h2>
-<p>The <code>blob</code> class encapsulates the "large object" functionality.</p>
-<pre><code class="language-cpp">class blob
-{
-public:
-    explicit blob(session &amp; s);
-    ~blob();
-
-    std::size_t getLen();
-    std::size_t read(std::size_t offset, char * buf, std::size_t toRead);
-    std::size_t write(std::size_t offset, char const * buf, std::size_t toWrite);
-    std::size_t append(char const * buf, std::size_t toWrite);
-    void trim(std::size_t newLen);
-
-    details::blob_backend * get_backend();
-};
-</code></pre>
-<p>This class contains the following members:</p>
-<ul>
-<li>Constructor associating the <code>blob</code> object with the <code>session</code> object.</li>
-<li><code>get_len</code> function that returns the size of the BLOB object.</li>
-<li><code>read</code> function that reads the BLOB data into provided buffer.</li>
-<li><code>write</code> function that writes the BLOB data from provided buffer.</li>
-<li><code>append</code> function that appends to the existing BLOB data.</li>
-<li><code>trim</code> function that truncates the existing data to the new length.</li>
-<li><code>get_backend</code> function that returns the internal pointer to the concrete backend implementation of the BLOB object. This is provided for advanced users that need access to the functionality that is not otherwise available.</li>
-</ul>
-<p>See <a href="../../lobs/">Large objects (BLOBs)</a> for more discussion.</p>
-<h2 id="class-rowid">class rowid</h2>
-<p>The <code>rowid</code> class encapsulates the "row identifier" object.</p>
-<pre><code class="language-cpp">class rowid
-{
-public:
-    explicit rowid(Session &amp; s);
-    ~rowid();
-
-    details::rowid_backend * get_backend();
-};
-</code></pre>
-<p>This class contains the following members:</p>
-<ul>
-<li>Constructor associating the <code>rowid</code> object with the <code>session</code> object.</li>
-<li><code>get_backend</code> function that returns the internal pointer to the concrete backend implementation of the <code>rowid</code> object.</li>
-</ul>
-<h2 id="class-backend_factory">class backend_factory</h2>
-<p>The <code>backend_factory</code> class provides the abstract interface for concrete backend factories.</p>
-<pre><code class="language-cpp">struct backend_factory
-{
-    virtual details::session_backend * make_session(
-        std::string const &amp; connectString) const = 0;
-};
-</code></pre>
-<p>The only member of this class is the <code>make_session</code> function that is supposed to create concrete backend implementation of the session object.</p>
-<p>Objects of this type are declared by each backend and should be provided to the constructor of the <code>session</code> class. In simple programs users do not need to use this class directly, but the example use is:</p>
-<pre><code class="language-cpp">backend_factory &amp; factory = postgresql;
-std::string connectionParameters = &quot;dbname=mydb&quot;;
-
-session sql(factory, parameters);
-</code></pre>
-<h2 id="simple-client-interface">Simple Client Interface</h2>
-<p>The simple client interface is provided with other languages in mind, to allow easy integration of the SOCI library with script interpreters and those languages that have the ability to link directly with object files using the "C" calling convention.</p>
-<p>The functionality of this interface is limited and in particular the dynamic rowset description and type conversions are not supported in this release. On the other hand, the important feature of this interface is that it does not require passing pointers to data managed by the user, because all data is handled at the SOCI side. This should make it easier to integrate SOCI with languages that have constrained ability to understand the C type system.</p>
-<p>Users of this interface need to explicitly <code>#include &lt;soci-simple.h&gt;</code>.</p>
-<pre><code class="language-c">typedef void * session_handle;
-session_handle soci_create_session(char const * connectionString);
-void soci_destroy_session(session_handle s);
-
-void soci_begin(session_handle s);
-void soci_commit(session_handle s);
-void soci_rollback(session_handle s);
-
-int soci_session_state(session_handle s);
-char const * soci_session_error_message(session_handle s);
-</code></pre>
-<p>The functions above provide the <em>session</em> abstraction with the help of opaque handle. The <code>soci_session_state</code> function returns <code>1</code> if there was no error during the most recently executed function and <code>0</code> otherwise, in which case the <code>soci_session_error_message</code> can be used to obtain a human-readable error description.</p>
-<p>Note that the only function that cannot report all errors this way is <code>soci_create_session</code>, which returns <code>NULL</code> if it was not possible to create an internal object representing the session. However, if the proxy object was created, but the connection could not be established for whatever reason, the error message can be obtained in the regular way.</p>
-<pre><code class="language-c">typedef void *blob_handle;
-blob_handle soci_create_blob(session_handle s);
-void soci_destroy_blob(blob_handle b);
-
-int soci_blob_get_len(blob_handle b);
-int soci_blob_read(blob_handle b, int offset, char *buf, int toRead);
-int soci_blob_write(blob_handle b, int offset, char const *buf, int toWrite);
-int soci_blob_append(blob_handle b, char const *buf, int toWrite);
-int soci_blob_trim(blob_handle b, int newLen);
-
-int soci_blob_state(blob_handle b);
-char const * soci_blob_error_message(blob_handle b);
-</code></pre>
-<p>The functions above provide the <em>blob</em> abstraction with the help of opaque handle. The <code>soci_blob_state</code> function returns <code>1</code> if there was no error during the most recently executed function and <code>0</code> otherwise, in which case the <code>soci_session_error_message</code> can be used to obtain a human-readable error description.</p>
-<p>For easy error testing, functions <code>soci_blob_read</code>, <code>soci_blob_write</code>, <code>soci_blob_append</code>, and <code>soci_blob_trim</code> return <code>-1</code> in case of error and <code>soci_session_error_message</code> can be used to obtain a human-readable error description.</p>
-<p>Note that the only function that cannot report all errors this way is <code>soci_create_blob</code>, which returns <code>NULL</code> if it was not possible to create an internal object representing the blob.</p>
-<pre><code class="language-c">typedef void * statement_handle;
-statement_handle soci_create_statement(session_handle s);
-void soci_destroy_statement(statement_handle st);
-
-int soci_statement_state(statement_handle s);
-char const * soci_statement_error_message(statement_handle s);
-</code></pre>
-<p>The functions above create and destroy the statement object. If the statement cannot be created by the <code>soci_create_statement</code> function, the error condition is set up in the related session object; for all other functions the error condition is set in the statement object itself.</p>
-<pre><code class="language-c">int soci_into_string   (statement_handle st);
-int soci_into_int      (statement_handle st);
-int soci_into_long_long(statement_handle st);
-int soci_into_double   (statement_handle st);
-int soci_into_date     (statement_handle st);
-int soci_into_blob     (statement_handle st);
-
-int soci_into_string_v   (statement_handle st);
-int soci_into_int_v      (statement_handle st);
-int soci_into_long_long_v(statement_handle st);
-int soci_into_double_v   (statement_handle st);
-int soci_into_date_v     (statement_handle st);
-</code></pre>
-<p>These functions create new data items for storing query results (<em>into elements</em>). These elements can be later identified by their position, which is counted from 0. For convenience, these function return the position of the currently added element. In case of error, <code>-1</code> is returned and the error condition is set in the statement object.</p>
-<p>The <code>_v</code> versions create a <code>vector</code> into elements, which can be used
-to retrieve whole arrays of results.</p>
-<pre><code class="language-c">int soci_get_into_state(statement_handle st, int position);
-int soci_get_into_state_v(statement_handle st, int position, int index);
-</code></pre>
-<p>This function returns <code>1</code> if the into element at the given position has non-null value and <code>0</code> otherwise. The <code>_v</code> version works with <code>vector</code> elements and expects an array index.</p>
-<pre><code class="language-c">char const * soci_get_into_string   (statement_handle st, int position);
-int          soci_get_into_int      (statement_handle st, int position);
-long long    soci_get_into_long_long(statement_handle st, int position);
-double       soci_get_into_double   (statement_handle st, int position);
-char const * soci_get_into_date     (statement_handle st, int position);
-blob_handle  soci_get_into_blob     (statement_handle st, int position);
-
-char const * soci_get_into_string_v   (statement_handle st, int position, int index);
-int          soci_get_into_int_v      (statement_handle st, int position, int index);
-long long    soci_get_into_long_long_v(statement_handle st, int position, int index);
-double       soci_get_into_double_v   (statement_handle st, int position, int index);
-char const * soci_get_into_date_v     (statement_handle st, int position, int index);
-</code></pre>
-<p>The functions above allow to retrieve the current value of the given into element.</p>
-<p><strong>Note:</strong> The <code>date</code> function returns the date value in the "<code>YYYY MM DD HH mm ss</code>" string format.</p>
-<pre><code class="language-c">void soci_use_string   (statement_handle st, char const * name);
-void soci_use_int      (statement_handle st, char const * name);
-void soci_use_long_long(statement_handle st, char const * name);
-void soci_use_double   (statement_handle st, char const * name);
-void soci_use_date     (statement_handle st, char const * name);
-void soci_use_blob     (statement_handle st, char const * name);
-
-void soci_use_string_v   (statement_handle st, char const * name);
-void soci_use_int_v      (statement_handle st, char const * name);
-void soci_use_long_long_v(statement_handle st, char const * name);
-void soci_use_double_v   (statement_handle st, char const * name);
-void soci_use_date_v     (statement_handle st, char const * name);
-</code></pre>
-<p>The functions above allow to create new data elements that will be used to provide data to the query (<em>use elements</em>). The new elements can be later identified by given name, which must be unique for the given statement.</p>
-<pre><code class="language-c">void soci_set_use_state(statement_handle st, char const * name, int state);
-</code></pre>
-<p>The <code>soci_set_use_state</code> function allows to set the state of the given use element. If the <code>state</code> parameter is set to non-zero the use element is considered non-null (which is also the default state after creating the use element).</p>
-<pre><code class="language-c">int  soci_use_get_size_v(statement_handle st);
-void soci_use_resize_v  (statement_handle st, int new_size);
-</code></pre>
-<p>These functions get and set the size of vector use elements (see comments for vector into elements above).</p>
-<pre><code class="language-c">void soci_set_use_string   (statement_handle st, char const * name, char const * val);
-void soci_set_use_int      (statement_handle st, char const * name, int val);
-void soci_set_use_long_long(statement_handle st, char const * name, long long val);
-void soci_set_use_double   (statement_handle st, char const * name, double val);
-void soci_set_use_date     (statement_handle st, char const * name, char const * val);
-void soci_set_use_blob     (statement_handle st, char const * name, blob_handle blob);
-
-void soci_set_use_state_v    (statement_handle st, char const * name, int index, int state);
-void soci_set_use_string_v   (statement_handle st, char const * name, int index, char const * val);
-void soci_set_use_int_v      (statement_handle st, char const * name, int index, int val);
-void soci_set_use_long_long_v(statement_handle st, char const * name, int index, long long val);
-void soci_set_use_double_v   (statement_handle st, char const * name, int index, double val);
-void soci_set_use_date_v     (statement_handle st, char const * name, int index, char const * val);
-</code></pre>
-<p>The functions above set the value of the given use element, for both single and vector elements.</p>
-<p><strong>Note:</strong> The expected format for the data values is "<code>YYYY MM DD HH mm ss</code>".</p>
-<pre><code class="language-c">int          soci_get_use_state    (statement_handle st, char const * name);
-char const * soci_get_use_string   (statement_handle st, char const * name);
-int          soci_get_use_int      (statement_handle st, char const * name);
-long long    soci_get_use_long_long(statement_handle st, char const * name);
-double       soci_get_use_double   (statement_handle st, char const * name);
-char const * soci_get_use_date     (statement_handle st, char const * name);
-blob_handle  soci_get_use_blob     (statement_handle st, char const * name);
-</code></pre>
-<p>These functions allow to inspect the state and value of named use elements.</p>
-<p><strong><em>Note:</em></strong> these functions are provide only for single use elements, not for vectors; the rationale for this is that modifiable use elements are not supported for bulk operations.</p>
-<pre><code class="language-c">void soci_prepare(statement_handle st, char const * query);
-int  soci_execute(statement_handle st, int withDataExchange);
-int  soci_fetch(statement_handle st);
-int  soci_got_data(statement_handle st);
-</code></pre>
-<p>The functions above provide the core execution functionality for the statement object and their meaning is equivalent to the respective functions in the core C++ interface described above.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/db2.md b/docs/backends/db2.md
new file mode 100644
index 0000000..4fe7d27
--- /dev/null
+++ b/docs/backends/db2.md
@@ -0,0 +1,94 @@
+# DB2 Backend Reference
+
+SOCI backend for accessing IBM DB2 database.
+
+## Prerequisites
+
+### Supported Versions
+
+See [Tested Platforms](#tested-platforms).
+
+### Tested Platforms
+
+|DB2 |OS|Compiler|
+|--- |--- |--- |
+|-|Linux PPC64|GCC|
+|9.1|Linux|GCC|
+|9.5|Linux|GCC|
+|9.7|Linux|GCC|
+|10.1|Linux|GCC|
+|10.1|Windows 8|Visual Studio 2012|
+|10.5.0.5|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The SOCI DB2 backend requires client library from the [IBM Data Server Driver Package (DS Driver)](https://www-01.ibm.com/support/docview.wss?uid=swg21385217).
+
+## Connecting to the Database
+
+On Unix, before using the DB2 backend please make sure, that you have sourced DB2 profile into your environment:
+
+```console
+. ~/db2inst1/sqllib/db2profile
+```
+
+To establish a connection to the DB2 database, create a session object using the DB2
+backend factory together with the database file name:
+
+```cpp
+soci::session sql(soci::db2, "your DB2 connection string here");
+```
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+TODO
+
+### Bulk Operations
+
+Supported, but with caution as it hasn't been extensively tested.
+
+### Transactions
+
+Currently, not supported.
+
+### BLOB Data Type
+
+Currently, not supported.
+
+### Nested Statements
+
+Nesting statements are not processed by SOCI in any special way and they work as implemented
+by the DB2 database.
+
+### Stored Procedures
+
+Stored procedures are supported, with `CALL` statement.
+
+## Native API Access
+
+TODO
+
+## Backend-specific extensions
+
+None.
+
+## Configuration options
+
+This backend supports `db2_option_driver_complete` option which can be passed to it via
+`connection_parameters` class. The value of this option is passed to `SQLDriverConnect()`
+function as "driver completion" parameter and so must be one of `SQL_DRIVER_XXX` values,
+in the string form. The default value of this option is `SQL_DRIVER_PROMPT` meaning
+that the driver will query the user for the user name and/or the password if they are
+not stored together with the connection. If this is undesirable for some reason,
+you can use `SQL_DRIVER_NOPROMPT` value for this option to suppress showing the message box:
+
+```cpp
+connection_parameters parameters("db2", "DSN=sample");
+parameters.set_option(db2_option_driver_complete, "0" /* SQL_DRIVER_NOPROMPT */);
+session sql(parameters);
+```
+
+Note, `db2_option_driver_complete` controls driver completion specific to the IBM DB2 driver
+for ODBC and CLI.
diff --git a/docs/backends/db2/index.html b/docs/backends/db2/index.html
deleted file mode 100644
index 630078e..0000000
--- a/docs/backends/db2/index.html
+++ /dev/null
@@ -1,457 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>DB2 - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../firebird/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/db2.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#db2-backend-reference" class="nav-link">DB2 Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#connecting-to-the-database" class="nav-link">Connecting to the Database</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#configuration-options" class="nav-link">Configuration options</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="db2-backend-reference">DB2 Backend Reference</h1>
-<p>SOCI backend for accessing IBM DB2 database.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>See <a href="#tested-platforms">Tested Platforms</a>.</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>DB2</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>-</td>
-<td>Linux PPC64</td>
-<td>GCC</td>
-</tr>
-<tr>
-<td>9.1</td>
-<td>Linux</td>
-<td>GCC</td>
-</tr>
-<tr>
-<td>9.5</td>
-<td>Linux</td>
-<td>GCC</td>
-</tr>
-<tr>
-<td>9.7</td>
-<td>Linux</td>
-<td>GCC</td>
-</tr>
-<tr>
-<td>10.1</td>
-<td>Linux</td>
-<td>GCC</td>
-</tr>
-<tr>
-<td>10.1</td>
-<td>Windows 8</td>
-<td>Visual Studio 2012</td>
-</tr>
-<tr>
-<td>10.5.0.5</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The SOCI DB2 backend requires client library from the <a href="https://www-01.ibm.com/support/docview.wss?uid=swg21385217">IBM Data Server Driver Package (DS Driver)</a>.</p>
-<h2 id="connecting-to-the-database">Connecting to the Database</h2>
-<p>On Unix, before using the DB2 backend please make sure, that you have sourced DB2 profile into your environment:</p>
-<pre><code class="language-console">. ~/db2inst1/sqllib/db2profile
-</code></pre>
-<p>To establish a connection to the DB2 database, create a session object using the DB2
-backend factory together with the database file name:</p>
-<pre><code class="language-cpp">soci::session sql(soci::db2, &quot;your DB2 connection string here&quot;);
-</code></pre>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>TODO</p>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<p>Supported, but with caution as it hasn't been extensively tested.</p>
-<h3 id="transactions">Transactions</h3>
-<p>Currently, not supported.</p>
-<h3 id="blob-data-type">BLOB Data Type</h3>
-<p>Currently, not supported.</p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>Nesting statements are not processed by SOCI in any special way and they work as implemented
-by the DB2 database.</p>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>Stored procedures are supported, with <code>CALL</code> statement.</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>TODO</p>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<p>None.</p>
-<h2 id="configuration-options">Configuration options</h2>
-<p>This backend supports <code>db2_option_driver_complete</code> option which can be passed to it via
-<code>connection_parameters</code> class. The value of this option is passed to <code>SQLDriverConnect()</code>
-function as "driver completion" parameter and so must be one of <code>SQL_DRIVER_XXX</code> values,
-in the string form. The default value of this option is <code>SQL_DRIVER_PROMPT</code> meaning
-that the driver will query the user for the user name and/or the password if they are
-not stored together with the connection. If this is undesirable for some reason,
-you can use <code>SQL_DRIVER_NOPROMPT</code> value for this option to suppress showing the message box:</p>
-<pre><code class="language-cpp">connection_parameters parameters(&quot;db2&quot;, &quot;DSN=sample&quot;);
-parameters.set_option(db2_option_driver_complete, &quot;0&quot; /* SQL_DRIVER_NOPROMPT */);
-session sql(parameters);
-</code></pre>
-<p>Note, <code>db2_option_driver_complete</code> controls driver completion specific to the IBM DB2 driver
-for ODBC and CLI.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/firebird.md b/docs/backends/firebird.md
new file mode 100644
index 0000000..24e2611
--- /dev/null
+++ b/docs/backends/firebird.md
@@ -0,0 +1,157 @@
+# Firebird Backend Reference
+
+SOCI backend for accessing Firebird database.
+
+## Prerequisites
+
+### Supported Versions
+
+The SOCI Firebird backend supports versions of Firebird from 1.5 to 2.5 and can be used with
+either the client-server or embedded Firebird libraries.
+The former is the default, to select the latter set `SOCI_FIREBIRD_EMBEDDED` CMake option to `ON`
+value when building.
+
+### Tested Platforms
+
+|Firebird |OS|Compiler|
+|--- |--- |--- |
+|1.5.2.4731|SunOS 5.10|g++ 3.4.3|
+|1.5.2.4731|Windows XP|Visual C++ 8.0|
+|1.5.3.4870|Windows XP|Visual C++ 8.0 Professional|
+|2.5.2.26540|Debian GNU/Linux 7|g++ 4.7.2|
+|2.5.8.27089|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The Firebird backend requires Firebird's `libfbclient` client library.
+For example, on Ubuntu Linux, for example, `firebird-dev` package and its dependencies are required.
+
+## Connecting to the Database
+
+To establish a connection to a Firebird database, create a Session object using the firebird
+backend factory together with a connection string:
+
+```cpp
+BackEndFactory const &backEnd = firebird;
+session sql(backEnd, "service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey");
+```
+
+or simply:
+
+```cpp
+session sql(firebird, "service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey");
+```
+
+The set of parameters used in the connection string for Firebird is:
+
+* service
+* user
+* password
+* role
+* charset
+
+The following parameters have to be provided as part of the connection string : *service*, *user*,
+*password*. Role and charset parameters are optional.
+
+Once you have created a `session` object as shown above, you can use it to access the database, for example:
+
+```cpp
+int count;
+sql << "select count(*) from user_tables", into(count);
+```
+
+(See the [connection](../connections.md) and [data binding](../binding.md) documentation
+for general information on using the `session` class.)
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+The Firebird backend supports the use of the SOCI `row` class, which facilitates retrieval of data whose
+type is not known at compile time.
+
+When calling `row::get<T>()`, the type you should pass as T depends upon the underlying database type.
+For the Firebird backend, this type mapping is:
+
+|Firebird Data Type|SOCI Data Type|`row::get<T>` specializations|
+|--- |--- |--- |
+|numeric, decimal (where scale > 0)|dt_double|double|
+|numeric, decimal [^1] (where scale = 0)|dt_integer, dt_double|int, double|
+|double precision, float|dt_double|double|
+|smallint, integer|dt_integer|int|
+|char, varchar|dt_string|std::string|
+|date, time, timestamp|dt_date|std::tm|
+
+[^1] There is also 64bit integer type for larger values which is
+currently not supported.
+
+(See the [dynamic resultset binding](../types.md#dynamic-binding) documentation for general information
+on using the `Row` class.)
+
+### Binding by Name
+
+In addition to [binding by position](../binding.md#binding-by-position), the Firebird backend supports
+[binding by name](../binding.md#binding-by-name), via an overload of the `use()` function:
+
+```cpp
+int id = 7;
+sql << "select name from person where id = :id", use(id, "id")
+```
+
+It should be noted that parameter binding by name is supported only by means of emulation,
+since the underlying API used by the backend doesn't provide this feature.
+
+### Bulk Operations
+
+The Firebird backend has full support for SOCI [bulk operations](../binding.md#bulk-operations) interface.
+This feature is also supported by emulation.
+
+### Transactions
+
+[Transactions](../transactions.md) are also fully supported by the Firebird backend.
+In fact, an implicit transaction is always started when using this backend if one hadn't been
+started by explicitly calling `begin()` before. The current transaction is automatically
+committed in `session` destructor.
+
+### BLOB Data Type
+
+The Firebird backend supports working with data stored in columns of type Blob,
+via SOCI [BLOB](../lobs.md) class.
+
+It should by noted, that entire Blob data is fetched from database to allow random read and write access.
+This is because Firebird itself allows only writing to a new Blob or reading from existing one -
+modifications of existing Blob means creating a new one.
+Firebird backend hides those details from user.
+
+### RowID Data Type
+
+This feature is not supported by Firebird backend.
+
+### Nested Statements
+
+This feature is not supported by Firebird backend.
+
+### Stored Procedures
+
+Firebird stored procedures can be executed by using SOCI [Procedure](../procedures.md) class.
+
+## Native API Access
+
+SOCI provides access to underlying datbabase APIs via several `get_backend()` functions,
+as described in the [Beyond SOCI](../beyond.md) documentation.
+
+The Firebird backend provides the following concrete classes for navite API access:
+
+|Accessor Function|Concrete Class|
+|--- |--- |
+|session_backend * session::get_backend()|firebird_session_backend|
+|statement_backend * statement::get_backend()|firebird_statement_backend|
+|blob_backend * blob::get_backend()|firebird_blob_backend|
+|rowid_backend * rowid::get_backend()|
+
+## Backend-specific extensions
+
+### firebird_soci_error
+
+The Firebird backend can throw instances of class `firebird_soci_error`, which is publicly derived
+from `soci_error` and has an additional public `status_` member containing the Firebird status vector.
diff --git a/docs/backends/firebird/index.html b/docs/backends/firebird/index.html
deleted file mode 100644
index b03d17e..0000000
--- a/docs/backends/firebird/index.html
+++ /dev/null
@@ -1,546 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>Firebird - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../db2/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../mysql/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/firebird.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#firebird-backend-reference" class="nav-link">Firebird Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#connecting-to-the-database" class="nav-link">Connecting to the Database</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="firebird-backend-reference">Firebird Backend Reference</h1>
-<p>SOCI backend for accessing Firebird database.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>The SOCI Firebird backend supports versions of Firebird from 1.5 to 2.5 and can be used with
-either the client-server or embedded Firebird libraries.
-The former is the default, to select the latter set <code>SOCI_FIREBIRD_EMBEDDED</code> CMake option to <code>ON</code>
-value when building.</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>Firebird</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>1.5.2.4731</td>
-<td>SunOS 5.10</td>
-<td>g++ 3.4.3</td>
-</tr>
-<tr>
-<td>1.5.2.4731</td>
-<td>Windows XP</td>
-<td>Visual C++ 8.0</td>
-</tr>
-<tr>
-<td>1.5.3.4870</td>
-<td>Windows XP</td>
-<td>Visual C++ 8.0 Professional</td>
-</tr>
-<tr>
-<td>2.5.2.26540</td>
-<td>Debian GNU/Linux 7</td>
-<td>g++ 4.7.2</td>
-</tr>
-<tr>
-<td>2.5.8.27089</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The Firebird backend requires Firebird's <code>libfbclient</code> client library.
-For example, on Ubuntu Linux, for example, <code>firebird-dev</code> package and its dependencies are required.</p>
-<h2 id="connecting-to-the-database">Connecting to the Database</h2>
-<p>To establish a connection to a Firebird database, create a Session object using the firebird
-backend factory together with a connection string:</p>
-<pre><code class="language-cpp">BackEndFactory const &amp;backEnd = firebird;
-session sql(backEnd, &quot;service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey&quot;);
-</code></pre>
-<p>or simply:</p>
-<pre><code class="language-cpp">session sql(firebird, &quot;service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey&quot;);
-</code></pre>
-<p>The set of parameters used in the connection string for Firebird is:</p>
-<ul>
-<li>service</li>
-<li>user</li>
-<li>password</li>
-<li>role</li>
-<li>charset</li>
-</ul>
-<p>The following parameters have to be provided as part of the connection string : <em>service</em>, <em>user</em>,
-<em>password</em>. Role and charset parameters are optional.</p>
-<p>Once you have created a <code>session</code> object as shown above, you can use it to access the database, for example:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from user_tables&quot;, into(count);
-</code></pre>
-<p>(See the <a href="../../connections/">connection</a> and <a href="../../binding/">data binding</a> documentation
-for general information on using the <code>session</code> class.)</p>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>The Firebird backend supports the use of the SOCI <code>row</code> class, which facilitates retrieval of data whose
-type is not known at compile time.</p>
-<p>When calling <code>row::get&lt;T&gt;()</code>, the type you should pass as T depends upon the underlying database type.
-For the Firebird backend, this type mapping is:</p>
-<table>
-<thead>
-<tr>
-<th>Firebird Data Type</th>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specializations</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>numeric, decimal (where scale &gt; 0)</td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td>numeric, decimal [^1] (where scale = 0)</td>
-<td>dt_integer, dt_double</td>
-<td>int, double</td>
-</tr>
-<tr>
-<td>double precision, float</td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td>smallint, integer</td>
-<td>dt_integer</td>
-<td>int</td>
-</tr>
-<tr>
-<td>char, varchar</td>
-<td>dt_string</td>
-<td>std::string</td>
-</tr>
-<tr>
-<td>date, time, timestamp</td>
-<td>dt_date</td>
-<td>std::tm</td>
-</tr>
-</tbody>
-</table>
-<p>[^1] There is also 64bit integer type for larger values which is
-currently not supported.</p>
-<p>(See the <a href="../../types/#dynamic-binding">dynamic resultset binding</a> documentation for general information
-on using the <code>Row</code> class.)</p>
-<h3 id="binding-by-name">Binding by Name</h3>
-<p>In addition to <a href="../../binding/#binding-by-position">binding by position</a>, the Firebird backend supports
-<a href="../../binding/#binding-by-name">binding by name</a>, via an overload of the <code>use()</code> function:</p>
-<pre><code class="language-cpp">int id = 7;
-sql &lt;&lt; &quot;select name from person where id = :id&quot;, use(id, &quot;id&quot;)
-</code></pre>
-<p>It should be noted that parameter binding by name is supported only by means of emulation,
-since the underlying API used by the backend doesn't provide this feature.</p>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<p>The Firebird backend has full support for SOCI <a href="../../binding/#bulk-operations">bulk operations</a> interface.
-This feature is also supported by emulation.</p>
-<h3 id="transactions">Transactions</h3>
-<p><a href="../../transactions/">Transactions</a> are also fully supported by the Firebird backend.
-In fact, an implicit transaction is always started when using this backend if one hadn't been
-started by explicitly calling <code>begin()</code> before. The current transaction is automatically
-committed in <code>session</code> destructor.</p>
-<h3 id="blob-data-type">BLOB Data Type</h3>
-<p>The Firebird backend supports working with data stored in columns of type Blob,
-via SOCI <a href="../../lobs/">BLOB</a> class.</p>
-<p>It should by noted, that entire Blob data is fetched from database to allow random read and write access.
-This is because Firebird itself allows only writing to a new Blob or reading from existing one -
-modifications of existing Blob means creating a new one.
-Firebird backend hides those details from user.</p>
-<h3 id="rowid-data-type">RowID Data Type</h3>
-<p>This feature is not supported by Firebird backend.</p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>This feature is not supported by Firebird backend.</p>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>Firebird stored procedures can be executed by using SOCI <a href="../../procedures/">Procedure</a> class.</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>SOCI provides access to underlying datbabase APIs via several <code>get_backend()</code> functions,
-as described in the <a href="../../beyond/">Beyond SOCI</a> documentation.</p>
-<p>The Firebird backend provides the following concrete classes for navite API access:</p>
-<table>
-<thead>
-<tr>
-<th>Accessor Function</th>
-<th>Concrete Class</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>session_backend * session::get_backend()</td>
-<td>firebird_session_backend</td>
-</tr>
-<tr>
-<td>statement_backend * statement::get_backend()</td>
-<td>firebird_statement_backend</td>
-</tr>
-<tr>
-<td>blob_backend * blob::get_backend()</td>
-<td>firebird_blob_backend</td>
-</tr>
-<tr>
-<td>rowid_backend * rowid::get_backend()</td>
-<td></td>
-</tr>
-</tbody>
-</table>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<h3 id="firebird_soci_error">firebird_soci_error</h3>
-<p>The Firebird backend can throw instances of class <code>firebird_soci_error</code>, which is publicly derived
-from <code>soci_error</code> and has an additional public <code>status_</code> member containing the Firebird status vector.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/index.html b/docs/backends/index.html
deleted file mode 100644
index a7f1d55..0000000
--- a/docs/backends/index.html
+++ /dev/null
@@ -1,437 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Features - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Features</a>
-</li>
-                                    
-<li>
-    <a href="db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../interfaces/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="db2/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/index.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#supported-backends-and-features" class="nav-link">Supported Backends and Features</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="supported-backends-and-features">Supported Backends and Features</h1>
-<p>Follow the links to learn more about each backend and detailed supported features.</p>
-<table>
-<thead>
-<tr>
-<th></th>
-<th><a href="oracle/">Oracle</a></th>
-<th><a href="postgresql/">PostgreSQL</a></th>
-<th><a href="mysql/">MySQL</a></th>
-<th><a href="sqlite3/">SQLite3</a></th>
-<th><a href="firebird/">Firebird</a></th>
-<th><a href="odbc/">ODBC</a></th>
-<th><a href="db2/">DB2</a></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Binding by Name</td>
-<td>YES</td>
-<td>YES (&ge;8.0)</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-</tr>
-<tr>
-<td>Dynamic Binding</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td></td>
-</tr>
-<tr>
-<td>Bulk Operations</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-</tr>
-<tr>
-<td>Transactions</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES (&ge;4.0)</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES</td>
-</tr>
-<tr>
-<td>BLOB Data Type</td>
-<td>YES</td>
-<td>YES</td>
-<td>YES (mapped to <code>std::string</code>)</td>
-<td>YES</td>
-<td>YES</td>
-<td>NO</td>
-<td>NO</td>
-</tr>
-<tr>
-<td>RowID Data Type</td>
-<td>YES</td>
-<td>YES</td>
-<td>NO</td>
-<td>NO</td>
-<td>NO</td>
-<td>NO</td>
-<td>NO</td>
-</tr>
-<tr>
-<td>Nested Statements</td>
-<td>YES</td>
-<td>NO</td>
-<td>NO</td>
-<td>NO</td>
-<td>NO</td>
-<td>NO</td>
-<td>YES</td>
-</tr>
-<tr>
-<td>Stored Procedures</td>
-<td>YES</td>
-<td>YES</td>
-<td>NO (but stored functions, YES)</td>
-<td>NO</td>
-<td>YES</td>
-<td>NO</td>
-<td>YES</td>
-</tr>
-</tbody>
-</table></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/index.md b/docs/backends/index.md
new file mode 100644
index 0000000..65d1096
--- /dev/null
+++ b/docs/backends/index.md
@@ -0,0 +1,14 @@
+# Supported Backends and Features
+
+Follow the links to learn more about each backend and detailed supported features.
+
+||[Oracle](oracle.md)|[PostgreSQL](postgresql.md)|[MySQL](mysql.md)|[SQLite3](sqlite3.md)|[Firebird](firebird.md)|[ODBC](odbc.md)|[DB2](db2.md)|
+|--- |--- |--- |--- |--- |--- |--- |--- |
+|Binding by Name|YES|YES (&ge;8.0)|YES|YES|YES|YES|YES|
+|Dynamic Binding|YES|YES|YES|YES|YES|YES|
+|Bulk Operations|YES|YES|YES|YES|YES|YES|YES|
+|Transactions|YES|YES|YES (&ge;4.0)|YES|YES|YES|YES|
+|BLOB Data Type|YES|YES|YES (mapped to `std::string`)|YES|YES|NO|NO|
+|RowID Data Type|YES|YES|NO|NO|NO|NO|NO|
+|Nested Statements|YES|NO|NO|NO|NO|NO|YES|
+|Stored Procedures|YES|YES|NO (but stored functions, YES)|NO|YES|NO|YES|
diff --git a/docs/backends/mysql.md b/docs/backends/mysql.md
new file mode 100644
index 0000000..7589718
--- /dev/null
+++ b/docs/backends/mysql.md
@@ -0,0 +1,139 @@
+# MySQL Backend Reference
+
+SOCI backend for accessing MySQL database.
+
+## Prerequisites
+
+### Supported Versions
+
+The SOCI MySQL backend should in principle work with every version of MySQL 5.x.
+Some of the features (transactions, stored functions) are not available when MySQL server doesn't support them.
+
+### Tested Platforms
+
+|MySQL|OS|Compiler|
+|--- |--- |--- |
+|8.0.1|Windows 10|Visual Studio 2017 (15.3.3)|
+|5.5.28|OS X 10.8.2|Apple LLVM version 4.2 (clang-425.0.24)|
+|5.0.96|Ubuntu 8.04.4 LTS (Hardy Heron)|g++ (GCC) 4.2.4 (Ubuntu 4.2.4-1ubuntu4)|
+|5.7.22|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The SOCI MySQL backend requires MySQL's `libmysqlclient` client library from the [MySQL Connector/C](https://dev.mysql.com/downloads/connector/c/).
+
+Note that the SOCI library itself depends also on `libdl`, so the minimum set of libraries needed to compile a basic client program is:
+
+    -lsoci_core -lsoci_mysql -ldl -lmysqlclient
+
+## Connecting to the Database
+
+To establish a connection to a MySQL server, create a `session` object using the `mysql` backend factory together with a connection string:
+
+    session sql(mysql, "db=test user=root password='Ala ma kota'");
+
+    // or:
+    session sql("mysql", "db=test user=root password='Ala ma kota'");
+
+    // or:
+    session sql("mysql://db=test user=root password='Ala ma kota'");
+
+The set of parameters used in the connection string for MySQL is:
+
+* `dbname` or `db` or `service` (required)
+* `user`
+* `password` or `pass`
+* `host`
+* `port`
+* `unix_socket`
+* `sslca`
+* `sslcert`
+* `local_infile` - should be `0` or `1`, `1` means `MYSQL_OPT_LOCAL_INFILE` will be set.
+* `charset`
+* `reconnect` - if set to 1, set `MYSQL_OPT_RECONNECT` to reconnect on connection loss.
+* `connect_timeout` - should be positive integer value that means seconds corresponding to `MYSQL_OPT_CONNECT_TIMEOUT`.
+* `read_timeout` - should be positive integer value that means seconds corresponding to `MYSQL_OPT_READ_TIMEOUT`.
+* `write_timeout` - should be positive integer value that means seconds corresponding to `MYSQL_OPT_WRITE_TIMEOUT`.
+
+Once you have created a `session` object as shown above, you can use it to access the database, for example:
+
+    int count;
+    sql << "select count(*) from invoices", into(count);
+
+(See the [connection](../connections.md) and [data binding](../binding.md) documentation
+for general information on using the `session` class.)
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+The MySQL backend supports the use of the SOCI `row` class, which facilitates retrieval of data which type is not known at compile time.
+
+When calling `row::get<T>()`, the type you should pass as `T` depends upon the underlying database type.
+For the MySQL backend, this type mapping is:
+
+|MySQL Data Type|SOCI Data Type|`row::get<T>` specializations|
+|--- |--- |--- |
+|FLOAT, DOUBLE, DECIMAL and synonyms|dt_double|double|
+|TINYINT, TINYINT UNSIGNED, SMALLINT, SMALLINT UNSIGNED, INT|dt_integer|int|
+|INT UNSIGNED|dt_long_long|long long or unsigned|
+|BIGINT|dt_long_long|long long|
+|BIGINT UNSIGNED|dt_unsigned_long_long|unsigned long long|
+|CHAR, VARCHAR, BINARY, VARBINARY, TINYBLOB, MEDIUMBLOB, BLOB,LONGBLOB, TINYTEXT, MEDIUMTEXT, TEXT, LONGTEXT, ENUM|dt_string|std::string|
+|TIMESTAMP (works only with MySQL >= 5.0), DATE, TIME, DATETIME|dt_date|std::tm|
+
+(See the [dynamic resultset binding](../types.md#dynamic-binding) documentation for general information
+on using the `Row` class.)
+
+### Binding by Name
+
+In addition to [binding by position](../binding.md#binding-by-position), the MySQL backend supports
+[binding by name](../binding.md#binding-by-name), via an overload of the `use()` function:
+
+    int id = 7;
+    sql << "select name from person where id = :id", use(id, "id")
+
+It should be noted that parameter binding of any kind is supported only by means of emulation, since the underlying API used by the backend doesn't provide this feature.
+
+### Bulk Operations
+
+### Transactions
+
+[Transactions](../transactions.md) are also supported by the MySQL backend. Please note, however, that transactions can only be used when the MySQL server supports them (it depends on options used during the compilation of the server; typically, but not always, servers >=4.0 support transactions and earlier versions do not) and only with appropriate table types.
+
+### BLOB Data Type
+
+SOCI `blob` interface is not supported by the MySQL backend.
+
+Note that this does not mean you cannot use MySQL's `BLOB` types.  They can be selected using the usual SQL syntax and read into `std::string` on the C++ side, so no special interface is required.
+
+### RowID Data Type
+
+The `rowid` functionality is not supported by the MySQL backend.
+
+### Nested Statements
+
+Nested statements are not supported by the MySQL backend.
+
+### Stored Procedures
+
+MySQL version 5.0 and later supports two kinds of stored routines: stored procedures and stored functions (for details, please consult the [Defining Stored Programs](https://dev.mysql.com/doc/refman/5.5/en/stored-programs-defining.html)). Stored functions can be executed by using SOCI's [procedure class](../procedures.md). There is currently no support for stored procedures.
+
+## Native API Access
+
+SOCI provides access to underlying datbabase APIs via several `get_backend()` functions, as described in the [Beyond SOCI](../beyond.md) documentation.
+
+The MySQL backend provides the following concrete classes for native API access:
+
+|Accessor Function|Concrete Class|
+|--- |--- |
+|session_backend * session::get_backend()|mysql_session_backend|
+|statement_backend * statement::get_backend()|mysql_statement_backend|
+
+## Backend-specific extensions
+
+None.
+
+## Configuration options
+
+None.
diff --git a/docs/backends/mysql/index.html b/docs/backends/mysql/index.html
deleted file mode 100644
index 05b647d..0000000
--- a/docs/backends/mysql/index.html
+++ /dev/null
@@ -1,536 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>MySQL - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../firebird/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../odbc/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/mysql.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#mysql-backend-reference" class="nav-link">MySQL Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#connecting-to-the-database" class="nav-link">Connecting to the Database</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#configuration-options" class="nav-link">Configuration options</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="mysql-backend-reference">MySQL Backend Reference</h1>
-<p>SOCI backend for accessing MySQL database.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>The SOCI MySQL backend should in principle work with every version of MySQL 5.x.
-Some of the features (transactions, stored functions) are not available when MySQL server doesn't support them.</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>MySQL</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>8.0.1</td>
-<td>Windows 10</td>
-<td>Visual Studio 2017 (15.3.3)</td>
-</tr>
-<tr>
-<td>5.5.28</td>
-<td>OS X 10.8.2</td>
-<td>Apple LLVM version 4.2 (clang-425.0.24)</td>
-</tr>
-<tr>
-<td>5.0.96</td>
-<td>Ubuntu 8.04.4 LTS (Hardy Heron)</td>
-<td>g++ (GCC) 4.2.4 (Ubuntu 4.2.4-1ubuntu4)</td>
-</tr>
-<tr>
-<td>5.7.22</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The SOCI MySQL backend requires MySQL's <code>libmysqlclient</code> client library from the <a href="https://dev.mysql.com/downloads/connector/c/">MySQL Connector/C</a>.</p>
-<p>Note that the SOCI library itself depends also on <code>libdl</code>, so the minimum set of libraries needed to compile a basic client program is:</p>
-<pre><code>-lsoci_core -lsoci_mysql -ldl -lmysqlclient
-</code></pre>
-<h2 id="connecting-to-the-database">Connecting to the Database</h2>
-<p>To establish a connection to a MySQL server, create a <code>session</code> object using the <code>mysql</code> backend factory together with a connection string:</p>
-<pre><code>session sql(mysql, "db=test user=root password='Ala ma kota'");
-
-// or:
-session sql("mysql", "db=test user=root password='Ala ma kota'");
-
-// or:
-session sql("mysql://db=test user=root password='Ala ma kota'");
-</code></pre>
-<p>The set of parameters used in the connection string for MySQL is:</p>
-<ul>
-<li><code>dbname</code> or <code>db</code> or <code>service</code> (required)</li>
-<li><code>user</code></li>
-<li><code>password</code> or <code>pass</code></li>
-<li><code>host</code></li>
-<li><code>port</code></li>
-<li><code>unix_socket</code></li>
-<li><code>sslca</code></li>
-<li><code>sslcert</code></li>
-<li><code>local_infile</code> - should be <code>0</code> or <code>1</code>, <code>1</code> means <code>MYSQL_OPT_LOCAL_INFILE</code> will be set.</li>
-<li><code>charset</code></li>
-<li><code>reconnect</code> - if set to 1, set <code>MYSQL_OPT_RECONNECT</code> to reconnect on connection loss.</li>
-<li><code>connect_timeout</code> - should be positive integer value that means seconds corresponding to <code>MYSQL_OPT_CONNECT_TIMEOUT</code>.</li>
-<li><code>read_timeout</code> - should be positive integer value that means seconds corresponding to <code>MYSQL_OPT_READ_TIMEOUT</code>.</li>
-<li><code>write_timeout</code> - should be positive integer value that means seconds corresponding to <code>MYSQL_OPT_WRITE_TIMEOUT</code>.</li>
-</ul>
-<p>Once you have created a <code>session</code> object as shown above, you can use it to access the database, for example:</p>
-<pre><code>int count;
-sql &lt;&lt; "select count(*) from invoices", into(count);
-</code></pre>
-<p>(See the <a href="../../connections/">connection</a> and <a href="../../binding/">data binding</a> documentation
-for general information on using the <code>session</code> class.)</p>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>The MySQL backend supports the use of the SOCI <code>row</code> class, which facilitates retrieval of data which type is not known at compile time.</p>
-<p>When calling <code>row::get&lt;T&gt;()</code>, the type you should pass as <code>T</code> depends upon the underlying database type.
-For the MySQL backend, this type mapping is:</p>
-<table>
-<thead>
-<tr>
-<th>MySQL Data Type</th>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specializations</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>FLOAT, DOUBLE, DECIMAL and synonyms</td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td>TINYINT, TINYINT UNSIGNED, SMALLINT, SMALLINT UNSIGNED, INT</td>
-<td>dt_integer</td>
-<td>int</td>
-</tr>
-<tr>
-<td>INT UNSIGNED</td>
-<td>dt_long_long</td>
-<td>long long or unsigned</td>
-</tr>
-<tr>
-<td>BIGINT</td>
-<td>dt_long_long</td>
-<td>long long</td>
-</tr>
-<tr>
-<td>BIGINT UNSIGNED</td>
-<td>dt_unsigned_long_long</td>
-<td>unsigned long long</td>
-</tr>
-<tr>
-<td>CHAR, VARCHAR, BINARY, VARBINARY, TINYBLOB, MEDIUMBLOB, BLOB,LONGBLOB, TINYTEXT, MEDIUMTEXT, TEXT, LONGTEXT, ENUM</td>
-<td>dt_string</td>
-<td>std::string</td>
-</tr>
-<tr>
-<td>TIMESTAMP (works only with MySQL &gt;= 5.0), DATE, TIME, DATETIME</td>
-<td>dt_date</td>
-<td>std::tm</td>
-</tr>
-</tbody>
-</table>
-<p>(See the <a href="../../types/#dynamic-binding">dynamic resultset binding</a> documentation for general information
-on using the <code>Row</code> class.)</p>
-<h3 id="binding-by-name">Binding by Name</h3>
-<p>In addition to <a href="../../binding/#binding-by-position">binding by position</a>, the MySQL backend supports
-<a href="../../binding/#binding-by-name">binding by name</a>, via an overload of the <code>use()</code> function:</p>
-<pre><code>int id = 7;
-sql &lt;&lt; "select name from person where id = :id", use(id, "id")
-</code></pre>
-<p>It should be noted that parameter binding of any kind is supported only by means of emulation, since the underlying API used by the backend doesn't provide this feature.</p>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<h3 id="transactions">Transactions</h3>
-<p><a href="../../transactions/">Transactions</a> are also supported by the MySQL backend. Please note, however, that transactions can only be used when the MySQL server supports them (it depends on options used during the compilation of the server; typically, but not always, servers &gt;=4.0 support transactions and earlier versions do not) and only with appropriate table types.</p>
-<h3 id="blob-data-type">BLOB Data Type</h3>
-<p>SOCI <code>blob</code> interface is not supported by the MySQL backend.</p>
-<p>Note that this does not mean you cannot use MySQL's <code>BLOB</code> types.  They can be selected using the usual SQL syntax and read into <code>std::string</code> on the C++ side, so no special interface is required.</p>
-<h3 id="rowid-data-type">RowID Data Type</h3>
-<p>The <code>rowid</code> functionality is not supported by the MySQL backend.</p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>Nested statements are not supported by the MySQL backend.</p>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>MySQL version 5.0 and later supports two kinds of stored routines: stored procedures and stored functions (for details, please consult the <a href="https://dev.mysql.com/doc/refman/5.5/en/stored-programs-defining.html">Defining Stored Programs</a>). Stored functions can be executed by using SOCI's <a href="../../procedures/">procedure class</a>. There is currently no support for stored procedures.</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>SOCI provides access to underlying datbabase APIs via several <code>get_backend()</code> functions, as described in the <a href="../../beyond/">Beyond SOCI</a> documentation.</p>
-<p>The MySQL backend provides the following concrete classes for native API access:</p>
-<table>
-<thead>
-<tr>
-<th>Accessor Function</th>
-<th>Concrete Class</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>session_backend * session::get_backend()</td>
-<td>mysql_session_backend</td>
-</tr>
-<tr>
-<td>statement_backend * statement::get_backend()</td>
-<td>mysql_statement_backend</td>
-</tr>
-</tbody>
-</table>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<p>None.</p>
-<h2 id="configuration-options">Configuration options</h2>
-<p>None.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/odbc.md b/docs/backends/odbc.md
new file mode 100644
index 0000000..84bcd38
--- /dev/null
+++ b/docs/backends/odbc.md
@@ -0,0 +1,174 @@
+# ODBC Backend Reference
+
+SOCI backend for accessing variety of databases via ODBC API.
+
+## Prerequisites
+
+### Supported Versions
+
+The SOCI ODBC backend is supported for use with ODBC 3.
+
+### Tested Platforms
+
+|ODBC|OS|Compiler|
+|--- |--- |--- |
+|3|Linux (Ubuntu 12.04)|g++ 4.6.3|
+|3|Linux (Ubuntu 12.04)|clang 3.2|
+|3.8|Windows 8|Visual Studio 2012|
+|3|Windows 7|Visual Studio 2010|
+|3|Windows XP|Visual Studio 2005 (express)|
+|3|Windows XP|Visual C++ 8.0 Professional|
+|3|Windows XP|g++ 3.3.4 (Cygwin)|
+|3 (unixodbc 2.3.6)|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The SOCI ODBC backend requires the ODBC client library.
+
+## Connecting to the Database
+
+To establish a connection to the ODBC database, create a Session object using the `ODBC` backend factory together with a connection string:
+
+```cpp
+backend_factory const&amp; backEnd = odbc;
+session sql(backEnd, "filedsn=c:\\my.dsn");
+```
+
+or simply:
+
+```cpp
+session sql(odbc, "filedsn=c:\\my.dsn");
+```
+
+The set of parameters used in the connection string for ODBC is the same as accepted by the [SQLDriverConnect](http://msdn.microsoft.com/library/default.asp?url=/library/en-us/odbcsql/od_odbc_d_4x4k.asp) function from the ODBC library.
+
+Once you have created a `session` object as shown above, you can use it to access the database, for example:
+
+```cpp
+int count;
+sql << "select count(*) from invoices", into(count);
+```
+
+(See the [connection](../connections.md) and [data binding](../binding.md) documentation for general information on using the `session` class.)
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+The ODBC backend supports the use of the SOCI `row` class, which facilitates retrieval of data whose type is not known at compile time.
+
+When calling `row::get<T>()`, the type you should pass as T depends upon the underlying database type.
+For the ODBC backend, this type mapping is:
+
+|ODBC Data Type|SOCI Data Type|`row::get<T>` specializations|
+|--- |--- |--- |
+|SQL_DOUBLE, SQL_DECIMAL, SQL_REAL, SQL_FLOAT, SQL_NUMERIC|dt_double|double|
+|SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT|dt_integer|int|
+|SQL_CHAR, SQL_VARCHAR|dt_string|std::string|
+|SQL_TYPE_DATE, SQL_TYPE_TIME, SQL_TYPE_TIMESTAMP|dt_date|std::tm|
+
+Not all ODBC drivers support all datatypes.
+
+(See the [dynamic resultset binding](../types.md#dynamic-binding) documentation for general information on using the `row` class.)
+
+### Binding by Name
+
+In addition to [binding by position](../binding.md#binding-by-position), the ODBC backend supports [binding by name](../binding.md#binding-by-name), via an overload of the `use()` function:
+
+```cpp
+int id = 7;
+sql << "select name from person where id = :id", use(id, "id")
+```
+
+Apart from the portable "colon-name" syntax above, which is achieved by rewriting the query string, the backend also supports the ODBC ? syntax:
+
+```cpp
+int i = 7;
+int j = 8;
+sql << "insert into t(x, y) values(?, ?)", use(i), use(j);
+```
+
+### Bulk Operations
+
+The ODBC backend has support for SOCI's [bulk operations](../binding.md#bulk-operations) interface.  Not all ODBC drivers support bulk operations, the following is a list of some tested backends:
+
+|ODBC Driver|Bulk Read|Bulk Insert|
+|--- |--- |--- |
+|MS SQL Server 2005|YES|YES|
+|MS Access 2003|YES|NO|
+|PostgresQL 8.1|YES|YES|
+|MySQL 4.1|NO|NO|
+
+### Transactions
+
+[Transactions](../transactions.md) are also fully supported by the ODBC backend, provided that they are supported by the underlying database.
+
+### BLOB Data Type
+
+Not currently supported.
+
+### RowID Data Type
+
+Not currently supported.
+
+### Nested Statements
+
+Not currently supported.
+
+### Stored Procedures
+
+Not currently supported.
+
+## Native API Access
+
+SOCI provides access to underlying datbabase APIs via several getBackEnd() functions, as described in the [beyond SOCI](../beyond.md) documentation.
+
+The ODBC backend provides the following concrete classes for navite API access:
+
+|Accessor Function|Concrete Class|
+|--- |--- |
+|session_backend* session::get_backend()|odbc_session_backend|
+|statement_backend* statement::get_backend()|odbc_statement_backend|
+|rowid_backend* rowid::get_backend()|odbc_rowid_backend|
+
+## Backend-specific extensions
+
+### odbc_soci_error
+
+The ODBC backend can throw instances of class `odbc_soci_error`, which is publicly derived from `soci_error` and has additional public members containing the ODBC error code, the Native database error code, and the message returned from ODBC:
+
+```cpp
+int main()
+{
+    try
+    {
+        // regular code
+    }
+    catch (soci::odbc_soci_error const&amp; e)
+    {
+        cerr << "ODBC Error Code: " << e.odbc_error_code() << endl
+                << "Native Error Code: " << e.native_error_code() << endl
+                << "SOCI Message: " << e.what() << std::endl
+                << "ODBC Message: " << e.odbc_error_message() << endl;
+    }
+    catch (exception const &amp;e)
+    {
+        cerr << "Some other error: " << e.what() << endl;
+    }
+}
+```
+
+### get_connection_string()
+
+The `odbc_session_backend` class provides `std::string get_connection_string() const` method
+that returns fully expanded connection string as returned by the `SQLDriverConnect` function.
+
+## Configuration options
+
+This backend supports `odbc_option_driver_complete` option which can be passed to it via `connection_parameters` class. The value of this option is passed to `SQLDriverConnect()` function as "driver completion" parameter and so must be one of `SQL_DRIVER_XXX` values, in the string form. The default value of this option is `SQL_DRIVER_PROMPT` meaning that the driver will query the user for the user name and/or the password if they are not stored together with the connection. If this is undesirable for some reason, you can use `SQL_DRIVER_NOPROMPT` value for this option to suppress showing the message box:
+
+```cpp
+connection_parameters parameters("odbc", "DSN=mydb");
+parameters.set_option(odbc_option_driver_complete, "0" /* SQL_DRIVER_NOPROMPT */);
+session sql(parameters);
+```
diff --git a/docs/backends/odbc/index.html b/docs/backends/odbc/index.html
deleted file mode 100644
index 8bde733..0000000
--- a/docs/backends/odbc/index.html
+++ /dev/null
@@ -1,583 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>ODBC - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../mysql/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../oracle/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/odbc.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#odbc-backend-reference" class="nav-link">ODBC Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#connecting-to-the-database" class="nav-link">Connecting to the Database</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#configuration-options" class="nav-link">Configuration options</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="odbc-backend-reference">ODBC Backend Reference</h1>
-<p>SOCI backend for accessing variety of databases via ODBC API.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>The SOCI ODBC backend is supported for use with ODBC 3.</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>ODBC</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>3</td>
-<td>Linux (Ubuntu 12.04)</td>
-<td>g++ 4.6.3</td>
-</tr>
-<tr>
-<td>3</td>
-<td>Linux (Ubuntu 12.04)</td>
-<td>clang 3.2</td>
-</tr>
-<tr>
-<td>3.8</td>
-<td>Windows 8</td>
-<td>Visual Studio 2012</td>
-</tr>
-<tr>
-<td>3</td>
-<td>Windows 7</td>
-<td>Visual Studio 2010</td>
-</tr>
-<tr>
-<td>3</td>
-<td>Windows XP</td>
-<td>Visual Studio 2005 (express)</td>
-</tr>
-<tr>
-<td>3</td>
-<td>Windows XP</td>
-<td>Visual C++ 8.0 Professional</td>
-</tr>
-<tr>
-<td>3</td>
-<td>Windows XP</td>
-<td>g++ 3.3.4 (Cygwin)</td>
-</tr>
-<tr>
-<td>3 (unixodbc 2.3.6)</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The SOCI ODBC backend requires the ODBC client library.</p>
-<h2 id="connecting-to-the-database">Connecting to the Database</h2>
-<p>To establish a connection to the ODBC database, create a Session object using the <code>ODBC</code> backend factory together with a connection string:</p>
-<pre><code class="language-cpp">backend_factory const&amp;amp; backEnd = odbc;
-session sql(backEnd, &quot;filedsn=c:\\my.dsn&quot;);
-</code></pre>
-<p>or simply:</p>
-<pre><code class="language-cpp">session sql(odbc, &quot;filedsn=c:\\my.dsn&quot;);
-</code></pre>
-<p>The set of parameters used in the connection string for ODBC is the same as accepted by the <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/odbcsql/od_odbc_d_4x4k.asp">SQLDriverConnect</a> function from the ODBC library.</p>
-<p>Once you have created a <code>session</code> object as shown above, you can use it to access the database, for example:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from invoices&quot;, into(count);
-</code></pre>
-<p>(See the <a href="../../connections/">connection</a> and <a href="../../binding/">data binding</a> documentation for general information on using the <code>session</code> class.)</p>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>The ODBC backend supports the use of the SOCI <code>row</code> class, which facilitates retrieval of data whose type is not known at compile time.</p>
-<p>When calling <code>row::get&lt;T&gt;()</code>, the type you should pass as T depends upon the underlying database type.
-For the ODBC backend, this type mapping is:</p>
-<table>
-<thead>
-<tr>
-<th>ODBC Data Type</th>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specializations</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>SQL_DOUBLE, SQL_DECIMAL, SQL_REAL, SQL_FLOAT, SQL_NUMERIC</td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td>SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT</td>
-<td>dt_integer</td>
-<td>int</td>
-</tr>
-<tr>
-<td>SQL_CHAR, SQL_VARCHAR</td>
-<td>dt_string</td>
-<td>std::string</td>
-</tr>
-<tr>
-<td>SQL_TYPE_DATE, SQL_TYPE_TIME, SQL_TYPE_TIMESTAMP</td>
-<td>dt_date</td>
-<td>std::tm</td>
-</tr>
-</tbody>
-</table>
-<p>Not all ODBC drivers support all datatypes.</p>
-<p>(See the <a href="../../types/#dynamic-binding">dynamic resultset binding</a> documentation for general information on using the <code>row</code> class.)</p>
-<h3 id="binding-by-name">Binding by Name</h3>
-<p>In addition to <a href="../../binding/#binding-by-position">binding by position</a>, the ODBC backend supports <a href="../../binding/#binding-by-name">binding by name</a>, via an overload of the <code>use()</code> function:</p>
-<pre><code class="language-cpp">int id = 7;
-sql &lt;&lt; &quot;select name from person where id = :id&quot;, use(id, &quot;id&quot;)
-</code></pre>
-<p>Apart from the portable "colon-name" syntax above, which is achieved by rewriting the query string, the backend also supports the ODBC ? syntax:</p>
-<pre><code class="language-cpp">int i = 7;
-int j = 8;
-sql &lt;&lt; &quot;insert into t(x, y) values(?, ?)&quot;, use(i), use(j);
-</code></pre>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<p>The ODBC backend has support for SOCI's <a href="../../binding/#bulk-operations">bulk operations</a> interface.  Not all ODBC drivers support bulk operations, the following is a list of some tested backends:</p>
-<table>
-<thead>
-<tr>
-<th>ODBC Driver</th>
-<th>Bulk Read</th>
-<th>Bulk Insert</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>MS SQL Server 2005</td>
-<td>YES</td>
-<td>YES</td>
-</tr>
-<tr>
-<td>MS Access 2003</td>
-<td>YES</td>
-<td>NO</td>
-</tr>
-<tr>
-<td>PostgresQL 8.1</td>
-<td>YES</td>
-<td>YES</td>
-</tr>
-<tr>
-<td>MySQL 4.1</td>
-<td>NO</td>
-<td>NO</td>
-</tr>
-</tbody>
-</table>
-<h3 id="transactions">Transactions</h3>
-<p><a href="../../transactions/">Transactions</a> are also fully supported by the ODBC backend, provided that they are supported by the underlying database.</p>
-<h3 id="blob-data-type">BLOB Data Type</h3>
-<p>Not currently supported.</p>
-<h3 id="rowid-data-type">RowID Data Type</h3>
-<p>Not currently supported.</p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>Not currently supported.</p>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>Not currently supported.</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>SOCI provides access to underlying datbabase APIs via several getBackEnd() functions, as described in the <a href="../../beyond/">beyond SOCI</a> documentation.</p>
-<p>The ODBC backend provides the following concrete classes for navite API access:</p>
-<table>
-<thead>
-<tr>
-<th>Accessor Function</th>
-<th>Concrete Class</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>session_backend* session::get_backend()</td>
-<td>odbc_session_backend</td>
-</tr>
-<tr>
-<td>statement_backend* statement::get_backend()</td>
-<td>odbc_statement_backend</td>
-</tr>
-<tr>
-<td>rowid_backend* rowid::get_backend()</td>
-<td>odbc_rowid_backend</td>
-</tr>
-</tbody>
-</table>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<h3 id="odbc_soci_error">odbc_soci_error</h3>
-<p>The ODBC backend can throw instances of class <code>odbc_soci_error</code>, which is publicly derived from <code>soci_error</code> and has additional public members containing the ODBC error code, the Native database error code, and the message returned from ODBC:</p>
-<pre><code class="language-cpp">int main()
-{
-    try
-    {
-        // regular code
-    }
-    catch (soci::odbc_soci_error const&amp;amp; e)
-    {
-        cerr &lt;&lt; &quot;ODBC Error Code: &quot; &lt;&lt; e.odbc_error_code() &lt;&lt; endl
-                &lt;&lt; &quot;Native Error Code: &quot; &lt;&lt; e.native_error_code() &lt;&lt; endl
-                &lt;&lt; &quot;SOCI Message: &quot; &lt;&lt; e.what() &lt;&lt; std::endl
-                &lt;&lt; &quot;ODBC Message: &quot; &lt;&lt; e.odbc_error_message() &lt;&lt; endl;
-    }
-    catch (exception const &amp;amp;e)
-    {
-        cerr &lt;&lt; &quot;Some other error: &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-}
-</code></pre>
-<h3 id="get_connection_string">get_connection_string()</h3>
-<p>The <code>odbc_session_backend</code> class provides <code>std::string get_connection_string() const</code> method
-that returns fully expanded connection string as returned by the <code>SQLDriverConnect</code> function.</p>
-<h2 id="configuration-options">Configuration options</h2>
-<p>This backend supports <code>odbc_option_driver_complete</code> option which can be passed to it via <code>connection_parameters</code> class. The value of this option is passed to <code>SQLDriverConnect()</code> function as "driver completion" parameter and so must be one of <code>SQL_DRIVER_XXX</code> values, in the string form. The default value of this option is <code>SQL_DRIVER_PROMPT</code> meaning that the driver will query the user for the user name and/or the password if they are not stored together with the connection. If this is undesirable for some reason, you can use <code>SQL_DRIVER_NOPROMPT</code> value for this option to suppress showing the message box:</p>
-<pre><code class="language-cpp">connection_parameters parameters(&quot;odbc&quot;, &quot;DSN=mydb&quot;);
-parameters.set_option(odbc_option_driver_complete, &quot;0&quot; /* SQL_DRIVER_NOPROMPT */);
-session sql(parameters);
-</code></pre></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/oracle.md b/docs/backends/oracle.md
new file mode 100644
index 0000000..4e5eae4
--- /dev/null
+++ b/docs/backends/oracle.md
@@ -0,0 +1,174 @@
+# Oracle Backend Reference
+
+SOCI backend for accessing Oracle database.
+
+## Prerequisites
+
+### Supported Versions
+
+The SOCI Oracle backend is currently supported for use with Oracle 10 or later.
+Older versions of Oracle may work as well, but they have not been tested by the SOCI team.
+
+### Tested Platforms
+
+|Oracle|OS|Compiler|
+|--- |--- |--- |
+|10.2.0 (XE)|RedHat 5|g++ 4.3|
+|11.2.0 (XE)|Ubuntu 12.04|g++ 4.6.3|
+|12.2.0.1|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The SOCI Oracle backend requires Oracle's `libclntsh` client library. Depending on the particular system, the `libnnz10` library might be needed as well.
+
+Note that the SOCI library itself depends also on `libdl`, so the minimum set of libraries needed to compile a basic client program is:
+
+```console
+-lsoci_core -lsoci_oracle -ldl -lclntsh -lnnz10
+```
+
+### Connecting to the Database
+
+To establish a connection to an Oracle database, create a `session` object using the oracle backend factory together with a connection string:
+
+```cpp
+session sql(oracle, "service=orcl user=scott password=tiger");
+
+// or:
+session sql("oracle", "service=orcl user=scott password=tiger");
+
+// or:
+session sql("oracle://service=orcl user=scott password=tiger");
+
+// or:
+session sql(oracle, "service=//your_host:1521/your_sid  user=scott password=tiger");
+```
+
+The set of parameters used in the connection string for Oracle is:
+
+* `service`
+* `user`
+* `password`
+* `mode` (optional; valid values are `sysdba`, `sysoper` and `default`)
+* `charset` and `ncharset` (optional; valid values are `utf8`, `utf16`, `we8mswin1252` and `win1252`)
+
+If both `user` and `password` are provided, the session will authenticate using the database credentials, whereas if none of them is set, then external Oracle credentials will be used - this allows integration with so called Oracle wallet authentication.
+
+Once you have created a `session` object as shown above, you can use it to access the database, for example:
+
+```cpp
+int count;
+sql << "select count(*) from user_tables", into(count);
+```
+
+(See the [connection](../connections.md) and [data binding](../binding.md) documentation for general information on using the `session` class.)
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+The Oracle backend supports the use of the SOCI `row` class, which facilitates retrieval of data which type is not known at compile time.
+
+When calling `row::get<T>()`, the type you should pass as `T` depends upon the underlying database type. For the Oracle backend, this type mapping is:
+
+|Oracle Data Type|SOCI Data Type|`row::get<T>` specializations|
+|--- |--- |--- |
+|number (where scale > 0)|dt_double|double|
+|number(where scale = 0 and precision ≤ `std::numeric_limits<int>::digits10`)|dt_integer|int|
+|number|dt_long_long|long long|
+|char, varchar, varchar2|dt_string|std::string|
+|date|dt_date|std::tm|
+
+(See the [dynamic resultset binding](../types.md#dynamic-binding) documentation for general information on using the `row` class.)
+
+### Binding by Name
+
+In addition to [binding by position](../binding.md#binding-by-position), the Oracle backend supports [binding by name](../binding.md#binding-by-name), via an overload of the `use()` function:
+
+```cpp
+int id = 7;
+sql << "select name from person where id = :id", use(id, "id")
+```
+
+SOCI's use of ':' to indicate a value to be bound within a SQL string is
+consistent with the underlying Oracle client library syntax.
+
+### Bulk Operations
+
+The Oracle backend has full support for SOCI's [bulk operations](../binding.md#bulk-operations) interface.
+
+### Transactions
+
+[Transactions](../statements.md#transactions) are also fully supported by
+the Oracle backend, although transactions with non-default isolation levels
+have to be managed by explicit SQL statements.
+
+### blob Data Type
+
+The Oracle backend supports working with data stored in columns of type Blob, via SOCI's [blob](../lobs.md) class.
+
+### rowid Data Type
+
+Oracle rowid's are accessible via SOCI's [rowid](../api/client.md#class-rowid) class.
+
+### Nested Statements
+
+The Oracle backend supports selecting into objects of type `statement`, so that you may work with nested sql statements and PL/SQL cursors:
+
+```cpp
+statement stInner(sql);
+statement stOuter = (sql.prepare <<
+    "select cursor(select name from person order by id)"
+    " from person where id = 1",
+    into(stInner));
+stInner.exchange(into(name));
+stOuter.execute();
+stOuter.fetch();
+
+while (stInner.fetch())
+{
+    std::cout << name << '\n';
+}
+```
+
+### Stored Procedures
+
+Oracle stored procedures can be executed by using SOCI's [procedure](../procedures.md) class.
+
+## Native API Access
+
+SOCI provides access to underlying datbabase APIs via several `get_backend()` functions, as described in the [Beyond SOCI](../beyond.md) documentation.
+
+The Oracle backend provides the following concrete classes for navite API access:
+
+|Accessor Function|Concrete Class|
+|--- |--- |
+|session_backend * session::get_backend()|oracle_session_backend|
+|statement_backend * statement::get_backend()|oracle_statement_backend|
+|blob_backend * blob::get_backend()|oracle_blob_backend|
+|rowid_backend * rowid::get_backend()|oracle_rowid_backend|
+
+## Backend-specific extensions
+
+### oracle_soci_error
+
+The Oracle backend can throw instances of class `oracle_soci_error`, which is publicly derived from `soci_error` and has an additional public `err_num_` member containing the Oracle error code:
+
+```cpp
+int main()
+{
+    try
+    {
+        // regular code
+    }
+    catch (oracle_soci_error const & e)
+    {
+        cerr << "Oracle error: " << e.err_num_
+            << " " << e.what() << endl;
+    }
+    catch (exception const & e)
+    {
+        cerr << "Some other error: "<< e.what() << endl;
+    }
+}
+```
diff --git a/docs/backends/oracle/index.html b/docs/backends/oracle/index.html
deleted file mode 100644
index 12e497e..0000000
--- a/docs/backends/oracle/index.html
+++ /dev/null
@@ -1,545 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>Oracle - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../odbc/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../postgresql/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/oracle.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#oracle-backend-reference" class="nav-link">Oracle Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="oracle-backend-reference">Oracle Backend Reference</h1>
-<p>SOCI backend for accessing Oracle database.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>The SOCI Oracle backend is currently supported for use with Oracle 10 or later.
-Older versions of Oracle may work as well, but they have not been tested by the SOCI team.</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>Oracle</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>10.2.0 (XE)</td>
-<td>RedHat 5</td>
-<td>g++ 4.3</td>
-</tr>
-<tr>
-<td>11.2.0 (XE)</td>
-<td>Ubuntu 12.04</td>
-<td>g++ 4.6.3</td>
-</tr>
-<tr>
-<td>12.2.0.1</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The SOCI Oracle backend requires Oracle's <code>libclntsh</code> client library. Depending on the particular system, the <code>libnnz10</code> library might be needed as well.</p>
-<p>Note that the SOCI library itself depends also on <code>libdl</code>, so the minimum set of libraries needed to compile a basic client program is:</p>
-<pre><code class="language-console">-lsoci_core -lsoci_oracle -ldl -lclntsh -lnnz10
-</code></pre>
-<h3 id="connecting-to-the-database">Connecting to the Database</h3>
-<p>To establish a connection to an Oracle database, create a <code>session</code> object using the oracle backend factory together with a connection string:</p>
-<pre><code class="language-cpp">session sql(oracle, &quot;service=orcl user=scott password=tiger&quot;);
-
-// or:
-session sql(&quot;oracle&quot;, &quot;service=orcl user=scott password=tiger&quot;);
-
-// or:
-session sql(&quot;oracle://service=orcl user=scott password=tiger&quot;);
-
-// or:
-session sql(oracle, &quot;service=//your_host:1521/your_sid  user=scott password=tiger&quot;);
-</code></pre>
-<p>The set of parameters used in the connection string for Oracle is:</p>
-<ul>
-<li><code>service</code></li>
-<li><code>user</code></li>
-<li><code>password</code></li>
-<li><code>mode</code> (optional; valid values are <code>sysdba</code>, <code>sysoper</code> and <code>default</code>)</li>
-<li><code>charset</code> and <code>ncharset</code> (optional; valid values are <code>utf8</code>, <code>utf16</code>, <code>we8mswin1252</code> and <code>win1252</code>)</li>
-</ul>
-<p>If both <code>user</code> and <code>password</code> are provided, the session will authenticate using the database credentials, whereas if none of them is set, then external Oracle credentials will be used - this allows integration with so called Oracle wallet authentication.</p>
-<p>Once you have created a <code>session</code> object as shown above, you can use it to access the database, for example:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from user_tables&quot;, into(count);
-</code></pre>
-<p>(See the <a href="../../connections/">connection</a> and <a href="../../binding/">data binding</a> documentation for general information on using the <code>session</code> class.)</p>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>The Oracle backend supports the use of the SOCI <code>row</code> class, which facilitates retrieval of data which type is not known at compile time.</p>
-<p>When calling <code>row::get&lt;T&gt;()</code>, the type you should pass as <code>T</code> depends upon the underlying database type. For the Oracle backend, this type mapping is:</p>
-<table>
-<thead>
-<tr>
-<th>Oracle Data Type</th>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specializations</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>number (where scale &gt; 0)</td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td>number(where scale = 0 and precision ≤ <code>std::numeric_limits&lt;int&gt;::digits10</code>)</td>
-<td>dt_integer</td>
-<td>int</td>
-</tr>
-<tr>
-<td>number</td>
-<td>dt_long_long</td>
-<td>long long</td>
-</tr>
-<tr>
-<td>char, varchar, varchar2</td>
-<td>dt_string</td>
-<td>std::string</td>
-</tr>
-<tr>
-<td>date</td>
-<td>dt_date</td>
-<td>std::tm</td>
-</tr>
-</tbody>
-</table>
-<p>(See the <a href="../../types/#dynamic-binding">dynamic resultset binding</a> documentation for general information on using the <code>row</code> class.)</p>
-<h3 id="binding-by-name">Binding by Name</h3>
-<p>In addition to <a href="../../binding/#binding-by-position">binding by position</a>, the Oracle backend supports <a href="../../binding/#binding-by-name">binding by name</a>, via an overload of the <code>use()</code> function:</p>
-<pre><code class="language-cpp">int id = 7;
-sql &lt;&lt; &quot;select name from person where id = :id&quot;, use(id, &quot;id&quot;)
-</code></pre>
-<p>SOCI's use of ':' to indicate a value to be bound within a SQL string is
-consistent with the underlying Oracle client library syntax.</p>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<p>The Oracle backend has full support for SOCI's <a href="../../binding/#bulk-operations">bulk operations</a> interface.</p>
-<h3 id="transactions">Transactions</h3>
-<p><a href="../../statements/#transactions">Transactions</a> are also fully supported by
-the Oracle backend, although transactions with non-default isolation levels
-have to be managed by explicit SQL statements.</p>
-<h3 id="blob-data-type">blob Data Type</h3>
-<p>The Oracle backend supports working with data stored in columns of type Blob, via SOCI's <a href="../../lobs/">blob</a> class.</p>
-<h3 id="rowid-data-type">rowid Data Type</h3>
-<p>Oracle rowid's are accessible via SOCI's <a href="../../api/client/#class-rowid">rowid</a> class.</p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>The Oracle backend supports selecting into objects of type <code>statement</code>, so that you may work with nested sql statements and PL/SQL cursors:</p>
-<pre><code class="language-cpp">statement stInner(sql);
-statement stOuter = (sql.prepare &lt;&lt;
-    &quot;select cursor(select name from person order by id)&quot;
-    &quot; from person where id = 1&quot;,
-    into(stInner));
-stInner.exchange(into(name));
-stOuter.execute();
-stOuter.fetch();
-
-while (stInner.fetch())
-{
-    std::cout &lt;&lt; name &lt;&lt; '\n';
-}
-</code></pre>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>Oracle stored procedures can be executed by using SOCI's <a href="../../procedures/">procedure</a> class.</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>SOCI provides access to underlying datbabase APIs via several <code>get_backend()</code> functions, as described in the <a href="../../beyond/">Beyond SOCI</a> documentation.</p>
-<p>The Oracle backend provides the following concrete classes for navite API access:</p>
-<table>
-<thead>
-<tr>
-<th>Accessor Function</th>
-<th>Concrete Class</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>session_backend * session::get_backend()</td>
-<td>oracle_session_backend</td>
-</tr>
-<tr>
-<td>statement_backend * statement::get_backend()</td>
-<td>oracle_statement_backend</td>
-</tr>
-<tr>
-<td>blob_backend * blob::get_backend()</td>
-<td>oracle_blob_backend</td>
-</tr>
-<tr>
-<td>rowid_backend * rowid::get_backend()</td>
-<td>oracle_rowid_backend</td>
-</tr>
-</tbody>
-</table>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<h3 id="oracle_soci_error">oracle_soci_error</h3>
-<p>The Oracle backend can throw instances of class <code>oracle_soci_error</code>, which is publicly derived from <code>soci_error</code> and has an additional public <code>err_num_</code> member containing the Oracle error code:</p>
-<pre><code class="language-cpp">int main()
-{
-    try
-    {
-        // regular code
-    }
-    catch (oracle_soci_error const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Oracle error: &quot; &lt;&lt; e.err_num_
-            &lt;&lt; &quot; &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-    catch (exception const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Some other error: &quot;&lt;&lt; e.what() &lt;&lt; endl;
-    }
-}
-</code></pre></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/postgresql.md b/docs/backends/postgresql.md
new file mode 100644
index 0000000..66a1e11
--- /dev/null
+++ b/docs/backends/postgresql.md
@@ -0,0 +1,159 @@
+# PostgreSQL Backend Reference
+
+SOCI backend for accessing PostgreSQL database.
+
+## Prerequisites
+
+### Supported Versions
+
+The SOCI PostgreSQL backend is supported for use with PostgreSQL >= 7.3, although versions older than 8.0 will suffer from limited feature support. See below for details.
+
+### Tested Platforms
+
+|PostgreSQL|OS|Compiler|
+|--- |--- |--- |
+|9.6|Windows Server 2016|MSVC++ 14.1|
+|9.4|Windows Server 2012 R2|MSVC++ 14.0|
+|9.4|Windows Server 2012 R2|MSVC++ 12.0|
+|9.4|Windows Server 2012 R2|MSVC++ 11.0|
+|9.4|Windows Server 2012 R2|Mingw-w64/GCC 4.8|
+|9.3|Ubuntu 12.04|g++ 4.6.3|
+|9.0|Mac OS X 10.6.6|g++ 4.2|
+|8.4|FreeBSD 8.2|g++ 4.1|
+|8.4|Debian 6|g++ 4.3|
+|8.4|RedHat 5|g++ 4.3|
+|10.03|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The SOCI PostgreSQL backend requires PostgreSQL's `libpq` client library.
+
+Note that the SOCI library itself depends also on `libdl`, so the minimum set of libraries needed to compile a basic client program is:
+
+```console
+-lsoci_core -lsoci_postgresql -ldl -lpq
+```
+
+### Connecting to the Database
+
+To establish a connection to the PostgreSQL database, create a `session` object using the `postgresql` backend factory together with a connection string:
+
+```cpp
+session sql(postgresql, "dbname=mydatabase");
+
+// or:
+session sql("postgresql", "dbname=mydatabase");
+
+// or:
+session sql("postgresql://dbname=mydatabase");
+```
+
+The set of parameters used in the connection string for PostgreSQL is the same as accepted by the [PQconnectdb](http://www.postgresql.org/docs/8.3/interactive/libpq.html#LIBPQ-CONNECT) function from the `libpq` library.
+
+In addition to standard PostgreSQL connection parameters, the following can be set:
+
+* `singlerow` or `singlerows`
+
+For example:
+
+```cpp
+session sql(postgresql, "dbname=mydatabase singlerows=true");
+```
+
+If the `singlerows` parameter is set to `true` or `yes`, then queries will be executed in the single-row mode, which prevents the client library from loading full query result set into memory and instead fetches rows one by one, as they are requested by the statement's fetch() function. This mode can be of interest to those users who want to make their client applications more responsive (with more fine-grained operation) by avoiding potentially long blocking times when complete query results are loaded to client's memory.
+Note that in the single-row operation:
+
+* bulk queries are not supported, and
+* in order to fulfill the expectations of the underlying client library, the complete rowset has to be exhausted before executing further queries on the same session.
+
+Also please note that single rows mode requires PostgreSQL 9 or later, both at
+compile- and run-time. If you need to support earlier versions of PostgreSQL,
+you can define `SOCI_POSTGRESQL_NOSINGLEROWMODE` when building the library to
+disable it.
+
+Once you have created a `session` object as shown above, you can use it to access the database, for example:
+
+```cpp
+int count;
+sql << "select count(*) from invoices", into(count);
+```
+
+(See the [connection](../connections.md) and [data binding](../binding.md) documentation for general information on using the `session` class.)
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+The PostgreSQL backend supports the use of the SOCI `row` class, which facilitates retrieval of data whose type is not known at compile time.
+
+When calling `row::get<T>()`, the type you should pass as `T` depends upon the underlying database type. For the PostgreSQL backend, this type mapping is:
+
+|PostgreSQL Data Type|SOCI Data Type|`row::get<T>` specializations|
+|--- |--- |--- |
+|numeric, real, double|dt_double|double|
+|boolean, smallint, integer|dt_integer|int|
+|int8|dt_long_long|long long|
+|oid|dt_integer|unsigned long|
+|char, varchar, text, cstring, bpchar|dt_string|std::string|
+|abstime, reltime, date, time, timestamp, timestamptz, timetz|dt_date|std::tm|
+
+(See the [dynamic resultset binding](../types.md#dynamic-binding) documentation for general information on using the `row` class.)
+
+### Binding by Name
+
+In addition to [binding by position](../binding.md#binding-by-position), the PostgreSQL backend supports [binding by name](../binding.md#binding-by-name), via an overload of the `use()` function:
+
+```cpp
+int id = 7;
+sql << "select name from person where id = :id", use(id, "id")
+```
+
+### Bulk Operations
+
+The PostgreSQL backend has full support for SOCI's [bulk operations](../binding.md#bulk-operations) interface.
+
+### Transactions
+
+[Transactions](../transactions.md) are also fully supported by the PostgreSQL backend.
+
+### blob Data Type
+
+The PostgreSQL backend supports working with data stored in columns of type Blob, via SOCI's [blob](../lobs.md) class with the exception that trimming is not supported.
+
+### rowid Data Type
+
+The concept of row identifier (OID in PostgreSQL) is supported via SOCI's [rowid](../api/client.md#class-rowid) class.
+
+### Nested Statements
+
+Nested statements are not supported by PostgreSQL backend.
+
+### Stored Procedures
+
+PostgreSQL stored procedures can be executed by using SOCI's [procedure](../procedures.md) class.
+
+## Native API Access
+
+SOCI provides access to underlying datbabase APIs via several `get_backend()` functions, as described in the [beyond SOCI](../beyond.md) documentation.
+
+The PostgreSQL backend provides the following concrete classes for navite API access:
+
+|Accessor Function|Concrete Class|
+|--- |--- |
+|session_backend * session::get_backend()|postgresql_session_backend|
+|statement_backend * statement::get_backend()|postgresql_statement_backend|
+|blob_backend * blob::get_backend()|postgresql_blob_backend|
+|rowid_backend * rowid::get_backend()|postgresql_rowid_backend|
+
+## Backend-specific extensions
+
+### uuid Data Type
+
+The PostgreSQL backend supports working with data stored in columns of type UUID via simple string operations. All string representations of UUID supported by PostgreSQL are accepted on input, the backend will return the standard
+format of UUID on output. See the test `test_uuid_column_type_support` for usage examples.
+
+## Configuration options
+
+To support older PostgreSQL versions, the following configuration macros are recognized:
+
+* `SOCI_POSTGRESQL_NOSINLGEROWMODE` - disable single mode retrieving query results row-by-row. It is necessary for PostgreSQL prior to version 9.
diff --git a/docs/backends/postgresql/index.html b/docs/backends/postgresql/index.html
deleted file mode 100644
index e4775cb..0000000
--- a/docs/backends/postgresql/index.html
+++ /dev/null
@@ -1,570 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>PostgreSQL - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../oracle/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../sqlite3/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/postgresql.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#postgresql-backend-reference" class="nav-link">PostgreSQL Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#configuration-options" class="nav-link">Configuration options</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="postgresql-backend-reference">PostgreSQL Backend Reference</h1>
-<p>SOCI backend for accessing PostgreSQL database.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>The SOCI PostgreSQL backend is supported for use with PostgreSQL &gt;= 7.3, although versions older than 8.0 will suffer from limited feature support. See below for details.</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>PostgreSQL</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>9.6</td>
-<td>Windows Server 2016</td>
-<td>MSVC++ 14.1</td>
-</tr>
-<tr>
-<td>9.4</td>
-<td>Windows Server 2012 R2</td>
-<td>MSVC++ 14.0</td>
-</tr>
-<tr>
-<td>9.4</td>
-<td>Windows Server 2012 R2</td>
-<td>MSVC++ 12.0</td>
-</tr>
-<tr>
-<td>9.4</td>
-<td>Windows Server 2012 R2</td>
-<td>MSVC++ 11.0</td>
-</tr>
-<tr>
-<td>9.4</td>
-<td>Windows Server 2012 R2</td>
-<td>Mingw-w64/GCC 4.8</td>
-</tr>
-<tr>
-<td>9.3</td>
-<td>Ubuntu 12.04</td>
-<td>g++ 4.6.3</td>
-</tr>
-<tr>
-<td>9.0</td>
-<td>Mac OS X 10.6.6</td>
-<td>g++ 4.2</td>
-</tr>
-<tr>
-<td>8.4</td>
-<td>FreeBSD 8.2</td>
-<td>g++ 4.1</td>
-</tr>
-<tr>
-<td>8.4</td>
-<td>Debian 6</td>
-<td>g++ 4.3</td>
-</tr>
-<tr>
-<td>8.4</td>
-<td>RedHat 5</td>
-<td>g++ 4.3</td>
-</tr>
-<tr>
-<td>10.03</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The SOCI PostgreSQL backend requires PostgreSQL's <code>libpq</code> client library.</p>
-<p>Note that the SOCI library itself depends also on <code>libdl</code>, so the minimum set of libraries needed to compile a basic client program is:</p>
-<pre><code class="language-console">-lsoci_core -lsoci_postgresql -ldl -lpq
-</code></pre>
-<h3 id="connecting-to-the-database">Connecting to the Database</h3>
-<p>To establish a connection to the PostgreSQL database, create a <code>session</code> object using the <code>postgresql</code> backend factory together with a connection string:</p>
-<pre><code class="language-cpp">session sql(postgresql, &quot;dbname=mydatabase&quot;);
-
-// or:
-session sql(&quot;postgresql&quot;, &quot;dbname=mydatabase&quot;);
-
-// or:
-session sql(&quot;postgresql://dbname=mydatabase&quot;);
-</code></pre>
-<p>The set of parameters used in the connection string for PostgreSQL is the same as accepted by the <a href="http://www.postgresql.org/docs/8.3/interactive/libpq.html#LIBPQ-CONNECT">PQconnectdb</a> function from the <code>libpq</code> library.</p>
-<p>In addition to standard PostgreSQL connection parameters, the following can be set:</p>
-<ul>
-<li><code>singlerow</code> or <code>singlerows</code></li>
-</ul>
-<p>For example:</p>
-<pre><code class="language-cpp">session sql(postgresql, &quot;dbname=mydatabase singlerows=true&quot;);
-</code></pre>
-<p>If the <code>singlerows</code> parameter is set to <code>true</code> or <code>yes</code>, then queries will be executed in the single-row mode, which prevents the client library from loading full query result set into memory and instead fetches rows one by one, as they are requested by the statement's fetch() function. This mode can be of interest to those users who want to make their client applications more responsive (with more fine-grained operation) by avoiding potentially long blocking times when complete query results are loaded to client's memory.
-Note that in the single-row operation:</p>
-<ul>
-<li>bulk queries are not supported, and</li>
-<li>in order to fulfill the expectations of the underlying client library, the complete rowset has to be exhausted before executing further queries on the same session.</li>
-</ul>
-<p>Also please note that single rows mode requires PostgreSQL 9 or later, both at
-compile- and run-time. If you need to support earlier versions of PostgreSQL,
-you can define <code>SOCI_POSTGRESQL_NOSINGLEROWMODE</code> when building the library to
-disable it.</p>
-<p>Once you have created a <code>session</code> object as shown above, you can use it to access the database, for example:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from invoices&quot;, into(count);
-</code></pre>
-<p>(See the <a href="../../connections/">connection</a> and <a href="../../binding/">data binding</a> documentation for general information on using the <code>session</code> class.)</p>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>The PostgreSQL backend supports the use of the SOCI <code>row</code> class, which facilitates retrieval of data whose type is not known at compile time.</p>
-<p>When calling <code>row::get&lt;T&gt;()</code>, the type you should pass as <code>T</code> depends upon the underlying database type. For the PostgreSQL backend, this type mapping is:</p>
-<table>
-<thead>
-<tr>
-<th>PostgreSQL Data Type</th>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specializations</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>numeric, real, double</td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td>boolean, smallint, integer</td>
-<td>dt_integer</td>
-<td>int</td>
-</tr>
-<tr>
-<td>int8</td>
-<td>dt_long_long</td>
-<td>long long</td>
-</tr>
-<tr>
-<td>oid</td>
-<td>dt_integer</td>
-<td>unsigned long</td>
-</tr>
-<tr>
-<td>char, varchar, text, cstring, bpchar</td>
-<td>dt_string</td>
-<td>std::string</td>
-</tr>
-<tr>
-<td>abstime, reltime, date, time, timestamp, timestamptz, timetz</td>
-<td>dt_date</td>
-<td>std::tm</td>
-</tr>
-</tbody>
-</table>
-<p>(See the <a href="../../types/#dynamic-binding">dynamic resultset binding</a> documentation for general information on using the <code>row</code> class.)</p>
-<h3 id="binding-by-name">Binding by Name</h3>
-<p>In addition to <a href="../../binding/#binding-by-position">binding by position</a>, the PostgreSQL backend supports <a href="../../binding/#binding-by-name">binding by name</a>, via an overload of the <code>use()</code> function:</p>
-<pre><code class="language-cpp">int id = 7;
-sql &lt;&lt; &quot;select name from person where id = :id&quot;, use(id, &quot;id&quot;)
-</code></pre>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<p>The PostgreSQL backend has full support for SOCI's <a href="../../binding/#bulk-operations">bulk operations</a> interface.</p>
-<h3 id="transactions">Transactions</h3>
-<p><a href="../../transactions/">Transactions</a> are also fully supported by the PostgreSQL backend.</p>
-<h3 id="blob-data-type">blob Data Type</h3>
-<p>The PostgreSQL backend supports working with data stored in columns of type Blob, via SOCI's <a href="../../lobs/">blob</a> class with the exception that trimming is not supported.</p>
-<h3 id="rowid-data-type">rowid Data Type</h3>
-<p>The concept of row identifier (OID in PostgreSQL) is supported via SOCI's <a href="../../api/client/#class-rowid">rowid</a> class.</p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>Nested statements are not supported by PostgreSQL backend.</p>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>PostgreSQL stored procedures can be executed by using SOCI's <a href="../../procedures/">procedure</a> class.</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>SOCI provides access to underlying datbabase APIs via several <code>get_backend()</code> functions, as described in the <a href="../../beyond/">beyond SOCI</a> documentation.</p>
-<p>The PostgreSQL backend provides the following concrete classes for navite API access:</p>
-<table>
-<thead>
-<tr>
-<th>Accessor Function</th>
-<th>Concrete Class</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>session_backend * session::get_backend()</td>
-<td>postgresql_session_backend</td>
-</tr>
-<tr>
-<td>statement_backend * statement::get_backend()</td>
-<td>postgresql_statement_backend</td>
-</tr>
-<tr>
-<td>blob_backend * blob::get_backend()</td>
-<td>postgresql_blob_backend</td>
-</tr>
-<tr>
-<td>rowid_backend * rowid::get_backend()</td>
-<td>postgresql_rowid_backend</td>
-</tr>
-</tbody>
-</table>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<h3 id="uuid-data-type">uuid Data Type</h3>
-<p>The PostgreSQL backend supports working with data stored in columns of type UUID via simple string operations. All string representations of UUID supported by PostgreSQL are accepted on input, the backend will return the standard
-format of UUID on output. See the test <code>test_uuid_column_type_support</code> for usage examples.</p>
-<h2 id="configuration-options">Configuration options</h2>
-<p>To support older PostgreSQL versions, the following configuration macros are recognized:</p>
-<ul>
-<li><code>SOCI_POSTGRESQL_NOSINLGEROWMODE</code> - disable single mode retrieving query results row-by-row. It is necessary for PostgreSQL prior to version 9.</li>
-</ul></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/backends/sqlite3.md b/docs/backends/sqlite3.md
new file mode 100644
index 0000000..4d449d0
--- /dev/null
+++ b/docs/backends/sqlite3.md
@@ -0,0 +1,152 @@
+# SQLite3 Backend Reference
+
+SOCI backend for accessing SQLite 3 database.
+
+## Prerequisites
+
+### Supported Versions
+
+The SOCI SQLite3 backend is supported for use with SQLite3 >= 3.1
+
+### Tested Platforms
+
+|SQLite3|OS|Compiler|
+|--- |--- |--- |
+|3.12.1|Windows Server 2016|MSVC++ 14.1|
+|3.12.1|Windows Server 2012 R2|MSVC++ 14.0|
+|3.12.1|Windows Server 2012 R2|MSVC++ 12.0|
+|3.12.1|Windows Server 2012 R2|MSVC++ 11.0|
+|3.12.1|Windows Server 2012 R2|Mingw-w64/GCC 4.8|
+|3.7.9|Ubuntu 12.04|g++ 4.6.3|
+|3.4.0|Windows XP|(cygwin) g++ 3.4.4|
+|3.4.0|Windows XP|Visual C++ 2005 Express Edition|
+|3.3.8|Windows XP|Visual C++ 2005 Professional|
+|3.5.2|Mac OS X 10.5|g++ 4.0.1|
+|3.3.4|Ubuntu 5.1|g++ 4.0.2|
+|3.3.4|Windows XP|(cygwin) g++ 3.3.4|
+|3.3.4|Windows XP|Visual C++ 2005 Express Edition|
+|3.2.1|Linux i686 2.6.10-gentoo-r6|g++ 3.4.5|
+|3.1.3|Mac OS X 10.4|g++ 4.0.1|
+|3.24.0|macOS High Sierra 10.13.5|AppleClang 9.1.0.9020039|
+
+### Required Client Libraries
+
+The SOCI SQLite3 backend requires SQLite3's `libsqlite3` client library.
+
+### Connecting to the Database
+
+To establish a connection to the SQLite3 database, create a Session object using the `SQLite3` backend factory together with the database file name:
+
+```cpp
+session sql(sqlite3, "database_filename");
+
+// or:
+
+session sql("sqlite3", "db=db.sqlite timeout=2 shared_cache=true");
+```
+
+The set of parameters used in the connection string for SQLite is:
+
+* `dbname` or `db`
+* `timeout` - set sqlite busy timeout (in seconds) ([link](http://www.sqlite.org/c3ref/busy_timeout.html))
+* `readonly` - open database in read-only mode instead of the default read-write (note that the database file must already exist in this case, see [the documentation](https://www.sqlite.org/c3ref/open.html))
+* `nocreate` - open an existing database without creating a new one if it doesn't already exist (by default, a new database file is created).
+* `synchronous` - set the pragma synchronous flag ([link](http://www.sqlite.org/pragma.html#pragma_synchronous))
+* `shared_cache` - should be `true` ([link](http://www.sqlite.org/c3ref/enable_shared_cache.html))
+* `vfs` - set the SQLite VFS used to as OS interface. The VFS should be registered before opening the connection, see [the documenation](https://www.sqlite.org/vfs.html)
+* `foreign_keys` - set the pragma foreign_keys flag ([link](https://www.sqlite.org/pragma.html#pragma_foreign_keys)).
+
+Once you have created a `session` object as shown above, you can use it to access the database, for example:
+
+```cpp
+int count;
+sql << "select count(*) from invoices", into(count);
+```
+
+(See the [connection](../connections.md) and [data binding](../binding.md) documentation for general information on using the `session` class.)
+
+## SOCI Feature Support
+
+### Dynamic Binding
+
+The SQLite3 backend supports the use of the SOCI `row` class, which facilitates retrieval of data whose type is not known at compile time.
+
+When calling `row::get<T>()`, the type you should pass as T depends upon the underlying database type.
+
+For the SQLite3 backend, this type mapping is complicated by the fact the SQLite3 does not enforce [types][INTEGER_PRIMARY_KEY] and makes no attempt to validate the type names used in table creation or alteration statements. SQLite3 will return the type as a string, SOCI will recognize the following strings and match them the corresponding SOCI types:
+
+|SQLite3 Data Type|SOCI Data Type|`row::get<T>` specializations|
+|--- |--- |--- |
+|*float*, *double*|dt_double|double|
+|*int8*, *bigint*|dt_long_long|long long|
+|*unsigned big int*|dt_unsigned_long_long|unsigned long long|
+|*int*, *boolean*|dt_integer|int|
+|*text, *char*|dt_string|std::string|
+|*date*, *time*|dt_date|std::tm|
+
+[INTEGER_PRIMARY_KEY] : There is one case where SQLite3 enforces type. If a column is declared as "integer primary key", then SQLite3 uses that as an alias to the internal ROWID column that exists for every table.  Only integers are allowed in this column.
+
+(See the [dynamic resultset binding](../types.md#dynamic-binding) documentation for general information on using the `row` class.)
+
+### Binding by Name
+
+In addition to [binding by position](../binding.md#binding-by-position), the SQLite3 backend supports [binding by name](../binding.md#binding-by-name), via an overload of the `use()` function:
+
+```cpp
+int id = 7;
+sql << "select name from person where id = :id", use(id, "id")
+```
+
+The backend also supports the SQLite3 native numbered syntax, "one or more literals can be replace by a parameter "?" or ":AAA" or "@AAA" or "$VVV" where AAA is an alphanumeric identifier and VVV is a variable name according to the syntax rules of the TCL programming language." [[1]](http://www.sqlite.org/capi3ref.html#sqlite3_bind_int):
+
+```cpp
+int i = 7;
+int j = 8;
+sql << "insert into t(x, y) values(?, ?)", use(i), use(j);
+```
+
+### Bulk Operations
+
+The SQLite3 backend has full support for SOCI's [bulk operations](../binding.md#bulk-operations) interface.  However, this support is emulated and is not native.
+
+### Transactions
+
+[Transactions](../transactions.md) are also fully supported by the SQLite3 backend.
+
+### BLOB Data Type
+
+The SQLite3 backend supports working with data stored in columns of type Blob, via SOCI's [BLOB](../lobs.md) class. Because of SQLite3 general typelessness the column does not have to be declared any particular type.
+
+### RowID Data Type
+
+In SQLite3 RowID is an integer. "Each entry in an SQLite table has a unique integer key called the "rowid". The rowid is always available as an undeclared column named ROWID, OID, or _ROWID_. If the table has a column of type INTEGER PRIMARY KEY then that column is another an alias for the rowid."[[2]](http://www.sqlite.org/capi3ref.html#sqlite3_last_insert_rowid)
+
+### Nested Statements
+
+Nested statements are not supported by SQLite3 backend.
+
+### Stored Procedures
+
+Stored procedures are not supported by SQLite3 backend
+
+## Native API Access
+
+SOCI provides access to underlying datbabase APIs via several `get_backend()` functions, as described in the [beyond SOCI](../beyond.md) documentation.
+
+The SQLite3 backend provides the following concrete classes for navite API access:
+
+|Accessor Function|Concrete Class|
+|--- |--- |
+|session_backend* session::get_backend()|sqlie3_session_backend|
+|statement_backend* statement::get_backend()|sqlite3_statement_backend|
+|rowid_backend* rowid::get_backend()|sqlite3_rowid_backend|
+
+## Backend-specific extensions
+
+### SQLite3 result code support
+
+SQLite3 result code is provided via the backend specific `sqlite3_soci_error` class. Catching the backend specific error yields the value of SQLite3 result code via the `result()` method.
+
+## Configuration options
+
+None
diff --git a/docs/backends/sqlite3/index.html b/docs/backends/sqlite3/index.html
deleted file mode 100644
index 4fe98f1..0000000
--- a/docs/backends/sqlite3/index.html
+++ /dev/null
@@ -1,580 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>SQLite3 - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../postgresql/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../../beyond/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/backends/sqlite3.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#sqlite3-backend-reference" class="nav-link">SQLite3 Backend Reference</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#soci-feature-support" class="nav-link">SOCI Feature Support</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#native-api-access" class="nav-link">Native API Access</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#backend-specific-extensions" class="nav-link">Backend-specific extensions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#configuration-options" class="nav-link">Configuration options</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="sqlite3-backend-reference">SQLite3 Backend Reference</h1>
-<p>SOCI backend for accessing SQLite 3 database.</p>
-<h2 id="prerequisites">Prerequisites</h2>
-<h3 id="supported-versions">Supported Versions</h3>
-<p>The SOCI SQLite3 backend is supported for use with SQLite3 &gt;= 3.1</p>
-<h3 id="tested-platforms">Tested Platforms</h3>
-<table>
-<thead>
-<tr>
-<th>SQLite3</th>
-<th>OS</th>
-<th>Compiler</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>3.12.1</td>
-<td>Windows Server 2016</td>
-<td>MSVC++ 14.1</td>
-</tr>
-<tr>
-<td>3.12.1</td>
-<td>Windows Server 2012 R2</td>
-<td>MSVC++ 14.0</td>
-</tr>
-<tr>
-<td>3.12.1</td>
-<td>Windows Server 2012 R2</td>
-<td>MSVC++ 12.0</td>
-</tr>
-<tr>
-<td>3.12.1</td>
-<td>Windows Server 2012 R2</td>
-<td>MSVC++ 11.0</td>
-</tr>
-<tr>
-<td>3.12.1</td>
-<td>Windows Server 2012 R2</td>
-<td>Mingw-w64/GCC 4.8</td>
-</tr>
-<tr>
-<td>3.7.9</td>
-<td>Ubuntu 12.04</td>
-<td>g++ 4.6.3</td>
-</tr>
-<tr>
-<td>3.4.0</td>
-<td>Windows XP</td>
-<td>(cygwin) g++ 3.4.4</td>
-</tr>
-<tr>
-<td>3.4.0</td>
-<td>Windows XP</td>
-<td>Visual C++ 2005 Express Edition</td>
-</tr>
-<tr>
-<td>3.3.8</td>
-<td>Windows XP</td>
-<td>Visual C++ 2005 Professional</td>
-</tr>
-<tr>
-<td>3.5.2</td>
-<td>Mac OS X 10.5</td>
-<td>g++ 4.0.1</td>
-</tr>
-<tr>
-<td>3.3.4</td>
-<td>Ubuntu 5.1</td>
-<td>g++ 4.0.2</td>
-</tr>
-<tr>
-<td>3.3.4</td>
-<td>Windows XP</td>
-<td>(cygwin) g++ 3.3.4</td>
-</tr>
-<tr>
-<td>3.3.4</td>
-<td>Windows XP</td>
-<td>Visual C++ 2005 Express Edition</td>
-</tr>
-<tr>
-<td>3.2.1</td>
-<td>Linux i686 2.6.10-gentoo-r6</td>
-<td>g++ 3.4.5</td>
-</tr>
-<tr>
-<td>3.1.3</td>
-<td>Mac OS X 10.4</td>
-<td>g++ 4.0.1</td>
-</tr>
-<tr>
-<td>3.24.0</td>
-<td>macOS High Sierra 10.13.5</td>
-<td>AppleClang 9.1.0.9020039</td>
-</tr>
-</tbody>
-</table>
-<h3 id="required-client-libraries">Required Client Libraries</h3>
-<p>The SOCI SQLite3 backend requires SQLite3's <code>libsqlite3</code> client library.</p>
-<h3 id="connecting-to-the-database">Connecting to the Database</h3>
-<p>To establish a connection to the SQLite3 database, create a Session object using the <code>SQLite3</code> backend factory together with the database file name:</p>
-<pre><code class="language-cpp">session sql(sqlite3, &quot;database_filename&quot;);
-
-// or:
-
-session sql(&quot;sqlite3&quot;, &quot;db=db.sqlite timeout=2 shared_cache=true&quot;);
-</code></pre>
-<p>The set of parameters used in the connection string for SQLite is:</p>
-<ul>
-<li><code>dbname</code> or <code>db</code></li>
-<li><code>timeout</code> - set sqlite busy timeout (in seconds) (<a href="http://www.sqlite.org/c3ref/busy_timeout.html">link</a>)</li>
-<li><code>readonly</code> - open database in read-only mode instead of the default read-write (note that the database file must already exist in this case, see <a href="https://www.sqlite.org/c3ref/open.html">the documentation</a>)</li>
-<li><code>synchronous</code> - set the pragma synchronous flag (<a href="http://www.sqlite.org/pragma.html#pragma_synchronous">link</a>)</li>
-<li><code>shared_cache</code> - should be <code>true</code> (<a href="http://www.sqlite.org/c3ref/enable_shared_cache.html">link</a>)</li>
-<li><code>vfs</code> - set the SQLite VFS used to as OS interface. The VFS should be registered before opening the connection, see <a href="https://www.sqlite.org/vfs.html">the documenation</a></li>
-</ul>
-<p>Once you have created a <code>session</code> object as shown above, you can use it to access the database, for example:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from invoices&quot;, into(count);
-</code></pre>
-<p>(See the <a href="../../connections/">connection</a> and <a href="../../binding/">data binding</a> documentation for general information on using the <code>session</code> class.)</p>
-<h2 id="soci-feature-support">SOCI Feature Support</h2>
-<h3 id="dynamic-binding">Dynamic Binding</h3>
-<p>The SQLite3 backend supports the use of the SOCI <code>row</code> class, which facilitates retrieval of data whose type is not known at compile time.</p>
-<p>When calling <code>row::get&lt;T&gt;()</code>, the type you should pass as T depends upon the underlying database type.</p>
-<p>For the SQLite3 backend, this type mapping is complicated by the fact the SQLite3 does not enforce [types][INTEGER_PRIMARY_KEY] and makes no attempt to validate the type names used in table creation or alteration statements. SQLite3 will return the type as a string, SOCI will recognize the following strings and match them the corresponding SOCI types:</p>
-<table>
-<thead>
-<tr>
-<th>SQLite3 Data Type</th>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specializations</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><em>float</em>, <em>double</em></td>
-<td>dt_double</td>
-<td>double</td>
-</tr>
-<tr>
-<td><em>int8</em>, <em>bigint</em></td>
-<td>dt_long_long</td>
-<td>long long</td>
-</tr>
-<tr>
-<td><em>unsigned big int</em></td>
-<td>dt_unsigned_long_long</td>
-<td>unsigned long long</td>
-</tr>
-<tr>
-<td><em>int</em>, <em>boolean</em></td>
-<td>dt_integer</td>
-<td>int</td>
-</tr>
-<tr>
-<td><em>text, </em>char*</td>
-<td>dt_string</td>
-<td>std::string</td>
-</tr>
-<tr>
-<td><em>date</em>, <em>time</em></td>
-<td>dt_date</td>
-<td>std::tm</td>
-</tr>
-</tbody>
-</table>
-<p>[INTEGER_PRIMARY_KEY] : There is one case where SQLite3 enforces type. If a column is declared as "integer primary key", then SQLite3 uses that as an alias to the internal ROWID column that exists for every table.  Only integers are allowed in this column.</p>
-<p>(See the <a href="../../types/#dynamic-binding">dynamic resultset binding</a> documentation for general information on using the <code>row</code> class.)</p>
-<h3 id="binding-by-name">Binding by Name</h3>
-<p>In addition to <a href="../../binding/#binding-by-position">binding by position</a>, the SQLite3 backend supports <a href="../../binding/#binding-by-name">binding by name</a>, via an overload of the <code>use()</code> function:</p>
-<pre><code class="language-cpp">int id = 7;
-sql &lt;&lt; &quot;select name from person where id = :id&quot;, use(id, &quot;id&quot;)
-</code></pre>
-<p>The backend also supports the SQLite3 native numbered syntax, "one or more literals can be replace by a parameter "?" or ":AAA" or "@AAA" or "$VVV" where AAA is an alphanumeric identifier and VVV is a variable name according to the syntax rules of the TCL programming language." <a href="http://www.sqlite.org/capi3ref.html#sqlite3_bind_int">[1]</a>:</p>
-<pre><code class="language-cpp">int i = 7;
-int j = 8;
-sql &lt;&lt; &quot;insert into t(x, y) values(?, ?)&quot;, use(i), use(j);
-</code></pre>
-<h3 id="bulk-operations">Bulk Operations</h3>
-<p>The SQLite3 backend has full support for SOCI's <a href="../../binding/#bulk-operations">bulk operations</a> interface.  However, this support is emulated and is not native.</p>
-<h3 id="transactions">Transactions</h3>
-<p><a href="../../transactions/">Transactions</a> are also fully supported by the SQLite3 backend.</p>
-<h3 id="blob-data-type">BLOB Data Type</h3>
-<p>The SQLite3 backend supports working with data stored in columns of type Blob, via SOCI's <a href="../../lobs/">BLOB</a> class. Because of SQLite3 general typelessness the column does not have to be declared any particular type.</p>
-<h3 id="rowid-data-type">RowID Data Type</h3>
-<p>In SQLite3 RowID is an integer. "Each entry in an SQLite table has a unique integer key called the "rowid". The rowid is always available as an undeclared column named ROWID, OID, or <em>ROWID</em>. If the table has a column of type INTEGER PRIMARY KEY then that column is another an alias for the rowid."<a href="http://www.sqlite.org/capi3ref.html#sqlite3_last_insert_rowid">[2]</a></p>
-<h3 id="nested-statements">Nested Statements</h3>
-<p>Nested statements are not supported by SQLite3 backend.</p>
-<h3 id="stored-procedures">Stored Procedures</h3>
-<p>Stored procedures are not supported by SQLite3 backend</p>
-<h2 id="native-api-access">Native API Access</h2>
-<p>SOCI provides access to underlying datbabase APIs via several <code>get_backend()</code> functions, as described in the <a href="../../beyond/">beyond SOCI</a> documentation.</p>
-<p>The SQLite3 backend provides the following concrete classes for navite API access:</p>
-<table>
-<thead>
-<tr>
-<th>Accessor Function</th>
-<th>Concrete Class</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>session_backend* session::get_backend()</td>
-<td>sqlie3_session_backend</td>
-</tr>
-<tr>
-<td>statement_backend* statement::get_backend()</td>
-<td>sqlite3_statement_backend</td>
-</tr>
-<tr>
-<td>rowid_backend* rowid::get_backend()</td>
-<td>sqlite3_rowid_backend</td>
-</tr>
-</tbody>
-</table>
-<h2 id="backend-specific-extensions">Backend-specific extensions</h2>
-<h3 id="sqlite3-result-code-support">SQLite3 result code support</h3>
-<p>SQLite3 result code is provided via the backend specific <code>sqlite3_soci_error</code> class. Catching the backend specific error yields the value of SQLite3 result code via the <code>result()</code> method.</p>
-<h2 id="configuration-options">Configuration options</h2>
-<p>None</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/beyond.md b/docs/beyond.md
new file mode 100644
index 0000000..5eb4061
--- /dev/null
+++ b/docs/beyond.md
@@ -0,0 +1,91 @@
+# Beyond standard SQL
+
+Sometimes the standard SQL is not enough and database-specific syntax needs to be used.
+When possible and practical, SOCI provides wrappers hiding the differences between the backends and this section describes these wrappers.
+And, if this is still not enough, you can use the backend-specific methods directly as described below.
+
+## Affected rows
+
+It can be useful to know how many rows were affected by the last SQL statement, most often when using `INSERT`, `UPDATE` or `DELETE`.
+SOCI provides `statement::get_affected_rows()` method allowing to do this:
+
+```cpp
+statement st = (sql.prepare << "update some_table ...");
+st.execute(true);
+
+if ( !st.get_affected_rows() )
+{
+    ... investigate why no rows were modified ...
+}
+```
+
+### Portability note
+
+This method behaviour in case of partially executed update, i.e. when some records were updated or inserted while some other have failed to be updated or inserted, depends on the exact backend and, in the case of ODBC backend, on the exact ODBC driver used.
+It can return `-1`, meaning that the number of rows is unknown, the number of rows actually updated or the total number of affected rows.
+
+## Sequences
+
+It is common to have auto-incrementing database fields or fields whose value come from a sequence.
+In the latter case you need to retrieve the value of the field for a new row before inserting it into the database.
+In the former case, this is unnecessary but you may still want to know the value generated by the database, e.g. to use it as a foreign key in another table.
+So it would be useful to have a way to obtain the value of such a field.
+But, of course, to make life of database programmers more interesting, different products usually support either autoincrement fields or sequences but not both -- and they use different syntaxes for them, too.
+SOCI tries to help to deal with this unfortunate situation by providing two functions: `session::get_next_sequence_value()` and `session::get_last_insert_id`.
+
+If you know which kind of database you use, you may use only one of them: when working with sequences, the first one allows to generate the next value in a sequence and when working with autoincrement fields, the second one retrieves the last value generated for such a field for the given table.
+
+However if you use multiple SOCI backends or even just a single ODBC backend but support connecting to databases of different types, you actually must use both of them in the following way to insert a row:
+
+```cpp
+long long id;
+statement st;
+if ( sql.get_next_sequence_value("table_sequence", id) )
+{
+    st << "insert into table(id, f1, f2) values(:id, :f1, :f2)",
+        use(id), use(f1), use(f2);
+}
+else
+{
+    // We're not using sequences, so don't specify the value,
+    // it will be automatically generated by the database on insert.
+    st << "insert into table(f1, f2) value(:f1, :f2)",
+        use(f1), use(f2);
+
+    // If the ID used for the above row is needed later, get it:
+    if ( !sql.get_last_insert_id("table", id) )
+        ... unexpected error, handle appropriately ...
+}
+```
+
+Please note that, generally speaking, with the backends implementing `get_last_insert_id()`, it is impossible to predict the next auto-generated value before the row is actually inserted due to the possibility of concurrent access to the database from another client. However if the application has exclusive access to the database, it can be assumed that the next value will be equal to the sum of the last insert ID and the increment used for the column (in most cases the increment will be 1 and some databases only support using 1 as the increment, but others, e.g. Microsoft SQL Server with its `IDENTITY(start, increment)` columns, can use arbitrary values). In particular, calling `get_last_insert_id()` for the just created, and still empty, table returns 0 (or `start - increment` in the SQL Server case), so that adding the increment value to it still corresponds to the next value that will be used.
+
+### Portability note
+
+These methods are currently only implemented in Firebird, MySQL, ODBC, PostgreSQL and SQLite3 backends.
+
+## Beyond SOCI API
+
+As the original name of the library (Simple Oracle Call Interface) clearly stated, SOCI is intended to be a *simple* library, targeting the majority of needs in regular C++ application.
+We do not claim that *everything* can be done with SOCI and it was never the intent of the library.
+What is important, though, is that the simplicity of the
+library does *not* prevent the client applications from reaching into the low-level specifics of each database backend in order to achieve special configuration or performance goals.
+
+Most of the SOCI classes have the `getBackEnd` method, which returns the pointer to the actual backend object that implements the given functionality.
+The knowledge of the actual backend allows the client application to get access to all low-level details that are involved.
+
+```cpp
+blob b(sql);
+
+oracle_session_back_end * sessionBackEnd = static_cast<oracle_session_back_end *>(sql.get_back_end());
+oracle_blob_back_end * blobBackEnd = static_cast<oracle_blob_back_end *>(b.get_back_end());
+
+OCILobDisableBuffering(sessionBackEnd->svchp_, sessionBackEnd->errhp_, blobBackEnd->lobp_);
+```
+
+The above example retrieves the `rowid` ("something" that identifies the row in the table) from the table and uses the `get_back_end` function to extract the actual object that implements this functionality.
+Assuming that it is the `"postgresql"` backend which is in use, the downcast is performed to use the `postgresql_rowid_back_end` interface to get the actual OID value that is a physical, low-level implementation of row identifier on PostgreSQL databases.
+
+In order for any of the above to compile, you have to explicitly `#include` the appropriate backend's header file.
+
+Please see the header file related to the given backend to learn what low-level handles and descriptors are available.
diff --git a/docs/beyond/index.html b/docs/beyond/index.html
deleted file mode 100644
index 4cb6cc5..0000000
--- a/docs/beyond/index.html
+++ /dev/null
@@ -1,418 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Beyond SQL - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../backends/sqlite3/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../multithreading/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/beyond.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#beyond-standard-sql" class="nav-link">Beyond standard SQL</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#affected-rows" class="nav-link">Affected rows</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#sequences" class="nav-link">Sequences</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#beyond-soci-api" class="nav-link">Beyond SOCI API</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="beyond-standard-sql">Beyond standard SQL</h1>
-<p>Sometimes the standard SQL is not enough and database-specific syntax needs to be used.
-When possible and practical, SOCI provides wrappers hiding the differences between the backends and this section describes these wrappers.
-And, if this is still not enough, you can use the backend-specific methods directly as described below.</p>
-<h2 id="affected-rows">Affected rows</h2>
-<p>It can be useful to know how many rows were affected by the last SQL statement, most often when using <code>INSERT</code>, <code>UPDATE</code> or <code>DELETE</code>.
-SOCI provides <code>statement::get_affected_rows()</code> method allowing to do this:</p>
-<pre><code class="language-cpp">statement st = (sql.prepare &lt;&lt; &quot;update some_table ...&quot;);
-st.execute(true);
-
-if ( !st.get_affected_rows() )
-{
-    ... investigate why no rows were modified ...
-}
-</code></pre>
-<h3 id="portability-note">Portability note</h3>
-<p>This method behaviour in case of partially executed update, i.e. when some records were updated or inserted while some other have failed to be updated or inserted, depends on the exact backend and, in the case of ODBC backend, on the exact ODBC driver used.
-It can return <code>-1</code>, meaning that the number of rows is unknown, the number of rows actually updated or the total number of affected rows.</p>
-<h2 id="sequences">Sequences</h2>
-<p>It is common to have auto-incrementing database fields or fields whose value come from a sequence.
-In the latter case you need to retrieve the value of the field for a new row before inserting it into the database.
-In the former case, this is unnecessary but you may still want to know the value generated by the database, e.g. to use it as a foreign key in another table.
-So it would be useful to have a way to obtain the value of such a field.
-But, of course, to make life of database programmers more interesting, different products usually support either autoincrement fields or sequences but not both -- and they use different syntaxes for them, too.
-SOCI tries to help to deal with this unfortunate situation by providing two functions: <code>session::get_next_sequence_value()</code> and <code>session::get_last_insert_id</code>.</p>
-<p>If you know which kind of database you use, you may use only one of them: when working with sequences, the first one allows to generate the next value in a sequence and when working with autoincrement fields, the second one retrieves the last value generated for such a field for the given table.</p>
-<p>However if you use multiple SOCI backends or even just a single ODBC backend but support connecting to databases of different types, you actually must use both of them in the following way to insert a row:</p>
-<pre><code class="language-cpp">long long id;
-statement st;
-if ( sql.get_next_sequence_value(&quot;table_sequence&quot;, id) )
-{
-    st &lt;&lt; &quot;insert into table(id, f1, f2) values(:id, :f1, :f2)&quot;,
-        use(id), use(f1), use(f2);
-}
-else
-{
-    // We're not using sequences, so don't specify the value,
-    // it will be automatically generated by the database on insert.
-    st &lt;&lt; &quot;insert into table(f1, f2) value(:f1, :f2)&quot;,
-        use(f1), use(f2);
-
-    // If the ID used for the above row is needed later, get it:
-    if ( !sql.get_last_insert_id(&quot;table&quot;, id) )
-        ... unexpected error, handle appropriately ...
-}
-</code></pre>
-<p>Please note that, generally speaking, with the backends implementing <code>get_last_insert_id()</code>, it is impossible to predict the next auto-generated value before the row is actually inserted due to the possibility of concurrent access to the database from another client. However if the application has exclusive access to the database, it can be assumed that the next value will be equal to the sum of the last insert ID and the increment used for the column (in most cases the increment will be 1 and some databases only support using 1 as the increment, but others, e.g. Microsoft SQL Server with its <code>IDENTITY(start, increment)</code> columns, can use arbitrary values). In particular, calling <code>get_last_insert_id()</code> for the just created, and still empty, table returns 0 (or <code>start - increment</code> in the SQL Server case), so that adding the increment value to it still corresponds to the next value that will be used.</p>
-<h3 id="portability-note_1">Portability note</h3>
-<p>These methods are currently only implemented in Firebird, MySQL, ODBC, PostgreSQL and SQLite3 backends.</p>
-<h2 id="beyond-soci-api">Beyond SOCI API</h2>
-<p>As the original name of the library (Simple Oracle Call Interface) clearly stated, SOCI is intended to be a <em>simple</em> library, targeting the majority of needs in regular C++ application.
-We do not claim that <em>everything</em> can be done with SOCI and it was never the intent of the library.
-What is important, though, is that the simplicity of the
-library does <em>not</em> prevent the client applications from reaching into the low-level specifics of each database backend in order to achieve special configuration or performance goals.</p>
-<p>Most of the SOCI classes have the <code>getBackEnd</code> method, which returns the pointer to the actual backend object that implements the given functionality.
-The knowledge of the actual backend allows the client application to get access to all low-level details that are involved.</p>
-<pre><code class="language-cpp">blob b(sql);
-
-oracle_session_back_end * sessionBackEnd = static_cast&lt;oracle_session_back_end *&gt;(sql.get_back_end());
-oracle_blob_back_end * blobBackEnd = static_cast&lt;oracle_blob_back_end *&gt;(b.get_back_end());
-
-OCILobDisableBuffering(sessionBackEnd-&gt;svchp_, sessionBackEnd-&gt;errhp_, blobBackEnd-&gt;lobp_);
-</code></pre>
-<p>The above example retrieves the <code>rowid</code> ("something" that identifies the row in the table) from the table and uses the <code>get_back_end</code> function to extract the actual object that implements this functionality.
-Assuming that it is the <code>"postgresql"</code> backend which is in use, the downcast is performed to use the <code>postgresql_rowid_back_end</code> interface to get the actual OID value that is a physical, low-level implementation of row identifier on PostgreSQL databases.</p>
-<p>In order for any of the above to compile, you have to explicitly <code>#include</code> the appropriate backend's header file.</p>
-<p>Please see the header file related to the given backend to learn what low-level handles and descriptors are available.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/binding.md b/docs/binding.md
new file mode 100644
index 0000000..5007520
--- /dev/null
+++ b/docs/binding.md
@@ -0,0 +1,168 @@
+# Data Binding
+
+SOCI provides mechanisms to bind local buffers for input and output data.
+
+**Note:** The Oracle documentation uses two terms: *defining* (for instructing the library where the *output* data should go) and *binding* (for the *input* data and *input/output* PL/SQL parameters). For the sake of simplicity, SOCI uses the term *binding* for both of these.
+
+## Binding output data (into)
+
+The `into` expression is used to add binding information to
+the statement:
+
+```cpp
+int count;
+sql << "select count(*) from person", into(count);
+
+string name;
+sql << "select name from person where id = 7", into(name);
+```
+
+In the above examples, some data is retrieved from the database and transmitted *into* the given local variable.
+
+There should be as many `into` elements as there are expected columns in the result (see [dynamic resultset binding](types.md#dynamic-binding) for the exception to this rule).
+
+## Binding input data (use)
+
+The `use` expression associates the SQL placeholder (written with colon) with the local data:
+
+```cpp
+int val = 7;
+sql << "insert into numbers(val) values(:val)", use(val);
+```
+
+In the above statement, the first "val" is a column name (assuming that there is appropriate table `numbers` with this column), the second "val" (with colon) is a placeholder and its name is ignored here, and the third "val" is a name of local variable.
+
+To better understand the meaning of each "val" above, consider also:
+
+```cpp
+int number = 7;
+sql << "insert into numbers(val) values(:blabla)", use(number);
+```
+
+Both examples above will insert the value of some local variable into the table `numbers` - we say that the local variable is *used* in the SQL statement.
+
+There should be as many `use` elements as there are parameters used in the SQL query.
+
+### Object lifetime and immutability
+
+SOCI assumes that local variables provided as `use` elements live at least as long at it takes to execute the whole statement.
+In short statement forms like above, the statement is executed *sometime* at the end of the full expression and the whole process is driven by the invisible temporary object handled by the library.
+If the data provided by user comes from another temporary variable, it might be possible for the compiler to arrange them in a way that the user data will be destroyed *before* the statement will have its chance to execute, referencing objects that no longer exist:
+
+```cpp
+// Dangerous code!
+
+string getNameFromSomewhere();
+
+sql << "insert into person(name) values(:n)", use(getNameFromSomewhere());
+```
+
+In the above example, the data passed to the database comes from the temporary variable that is a result of call to `getNameFromSomewhere` - this should be avoided and named variables should be used to ensure safe lifetime relations:
+
+```cpp
+// Safe code
+
+string getNameFromSomewhere();
+
+string name = getNameFromSomewhere();
+sql << "insert into person(name) values(:n)", use(name);
+```
+
+It is still possible to provide `const` data for use elements.
+
+Note that some database servers, like Oracle, allow PL/SQL procedures to modify their in/out parameters - this is detected by the SOCI library and an error is reported if the database attempts to modify the `use` element that holds `const` data.
+
+The above example can be ultimately written in the following way:
+
+```cpp
+// Safe and efficient code
+
+string getNameFromSomewhere();
+
+string const& name = getNameFromSomewhere();
+sql << "insert into person(name) values(:n)", use(name);
+```
+
+## Binding by position
+
+If there is more output or input "holes" in the single statement, it is possible to use many `into` and `use` expressions, separated by commas, where each expression will be responsible for the consecutive "hole" in the statement:
+
+```cpp
+string firstName = "John", lastName = "Smith";
+int personId = 7;
+
+sql << "insert into person(id, firstname, lastname) values(:id, :fn, :ln)",
+        use(personId), use(firstName), use(lastName);
+
+sql << "select firstname, lastname from person where id = :id",
+        into(firstName), into(lastName), use(personId);
+```
+
+In the code above, the order of "holes" in the SQL statement and the order of `into` and `use` expression should match.
+
+## Binding by name
+
+The SQL placeholders that have their names (with colon) can be bound by name to clearly associate the local variable with the given placeholder.
+
+This explicit naming allows to use different order of elements:
+
+```cpp
+string firstName = "John", lastName = "Smith";
+int personId = 7;
+sql << "insert into person(id, firstname, lastname) values(:id, :fn, :ln)",
+    use(firstName, "fn"), use(lastName, "ln"), use(personId, "id");
+```
+
+or bind the same local data to many "holes" at the same time:
+
+```cpp
+string addr = "...";
+sql << "update person"
+        " set mainaddress = :addr, contactaddress = :addr"
+        " where id = 7",
+        use(addr, "addr");
+```
+
+## Bulk operations
+
+Bulk operations allow the user to bind, as into or use element, whole vectors of objects.
+This allows the database backend to optimize access and data transfer and benefit from the fact that `std::vector` stores data in contiguous memory blocks (the actual optimization depends on the backend and the capability of the underlying data base server).
+
+It is possible to `use` the vector as a data source:
+
+```cpp
+std::vector<int> v;
+// ...
+sql << "insert into t ...", use(v);
+```
+
+as well as a destination:
+
+```cpp
+std::vector<int> v;
+v.resize(100);
+sql << "select ...", into(v);
+```
+
+In the latter case the initial size of the vector defines the maximum number of data elements that the user is willing to accept and after executing the query the vector will be automatically resized to reflect that actual number of rows that were read and transmitted.
+That is, the vector will be automatically shrunk if the amount of data that was available was smaller than requested.
+
+It is also possible to operate on the chosen sub-range of the vector:
+
+```cpp
+std::vector<int> v;
+// ...
+std::size_t begin = ...;
+std::size_t end = ...;
+sql << "insert into t ...", use(v, begin, end);
+
+// or:
+
+sql << "select ...", into(v, begin, end);
+```
+
+Above, only the sub-range of the vector is used for data transfer and in the case of `into` operation, the `end` variable will be automatically adjusted to reflect the amount of data that was actually transmitted, but the vector object as a whole will retain its initial size.
+
+Bulk operations can also involve indicators, see below.
+
+Bulk operations support user-defined data types, if they have appropriate conversion routines defined.
diff --git a/docs/binding/index.html b/docs/binding/index.html
deleted file mode 100644
index 65e2e7e..0000000
--- a/docs/binding/index.html
+++ /dev/null
@@ -1,469 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Data Binding - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../queries/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../indicators/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/binding.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#data-binding" class="nav-link">Data Binding</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#binding-output-data-into" class="nav-link">Binding output data (into)</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#binding-input-data-use" class="nav-link">Binding input data (use)</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#binding-by-position" class="nav-link">Binding by position</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#binding-by-name" class="nav-link">Binding by name</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#bulk-operations" class="nav-link">Bulk operations</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="data-binding">Data Binding</h1>
-<p>SOCI provides mechanisms to bind local buffers for input and output data.</p>
-<p><strong>Note:</strong> The Oracle documentation uses two terms: <em>defining</em> (for instructing the library where the <em>output</em> data should go) and <em>binding</em> (for the <em>input</em> data and <em>input/output</em> PL/SQL parameters). For the sake of simplicity, SOCI uses the term <em>binding</em> for both of these.</p>
-<h2 id="binding-output-data-into">Binding output data (into)</h2>
-<p>The <code>into</code> expression is used to add binding information to
-the statement:</p>
-<pre><code class="language-cpp">int count;
-sql &lt;&lt; &quot;select count(*) from person&quot;, into(count);
-
-string name;
-sql &lt;&lt; &quot;select name from person where id = 7&quot;, into(name);
-</code></pre>
-<p>In the above examples, some data is retrieved from the database and transmitted <em>into</em> the given local variable.</p>
-<p>There should be as many <code>into</code> elements as there are expected columns in the result (see <a href="../types/#dynamic-binding">dynamic resultset binding</a> for the exception to this rule).</p>
-<h2 id="binding-input-data-use">Binding input data (use)</h2>
-<p>The <code>use</code> expression associates the SQL placeholder (written with colon) with the local data:</p>
-<pre><code class="language-cpp">int val = 7;
-sql &lt;&lt; &quot;insert into numbers(val) values(:val)&quot;, use(val);
-</code></pre>
-<p>In the above statement, the first "val" is a column name (assuming that there is appropriate table <code>numbers</code> with this column), the second "val" (with colon) is a placeholder and its name is ignored here, and the third "val" is a name of local variable.</p>
-<p>To better understand the meaning of each "val" above, consider also:</p>
-<pre><code class="language-cpp">int number = 7;
-sql &lt;&lt; &quot;insert into numbers(val) values(:blabla)&quot;, use(number);
-</code></pre>
-<p>Both examples above will insert the value of some local variable into the table <code>numbers</code> - we say that the local variable is <em>used</em> in the SQL statement.</p>
-<p>There should be as many <code>use</code> elements as there are parameters used in the SQL query.</p>
-<h3 id="object-lifetime-and-immutability">Object lifetime and immutability</h3>
-<p>SOCI assumes that local variables provided as <code>use</code> elements live at least as long at it takes to execute the whole statement.
-In short statement forms like above, the statement is executed <em>sometime</em> at the end of the full expression and the whole process is driven by the invisible temporary object handled by the library.
-If the data provided by user comes from another temporary variable, it might be possible for the compiler to arrange them in a way that the user data will be destroyed <em>before</em> the statement will have its chance to execute, referencing objects that no longer exist:</p>
-<pre><code class="language-cpp">// Dangerous code!
-
-string getNameFromSomewhere();
-
-sql &lt;&lt; &quot;insert into person(name) values(:n)&quot;, use(getNameFromSomewhere());
-</code></pre>
-<p>In the above example, the data passed to the database comes from the temporary variable that is a result of call to <code>getNameFromSomewhere</code> - this should be avoided and named variables should be used to ensure safe lifetime relations:</p>
-<pre><code class="language-cpp">// Safe code
-
-string getNameFromSomewhere();
-
-string name = getNameFromSomewhere();
-sql &lt;&lt; &quot;insert into person(name) values(:n)&quot;, use(name);
-</code></pre>
-<p>It is still possible to provide <code>const</code> data for use elements.</p>
-<p>Note that some database servers, like Oracle, allow PL/SQL procedures to modify their in/out parameters - this is detected by the SOCI library and an error is reported if the database attempts to modify the <code>use</code> element that holds <code>const</code> data.</p>
-<p>The above example can be ultimately written in the following way:</p>
-<pre><code class="language-cpp">// Safe and efficient code
-
-string getNameFromSomewhere();
-
-string const&amp; name = getNameFromSomewhere();
-sql &lt;&lt; &quot;insert into person(name) values(:n)&quot;, use(name);
-</code></pre>
-<h2 id="binding-by-position">Binding by position</h2>
-<p>If there is more output or input "holes" in the single statement, it is possible to use many <code>into</code> and <code>use</code> expressions, separated by commas, where each expression will be responsible for the consecutive "hole" in the statement:</p>
-<pre><code class="language-cpp">string firstName = &quot;John&quot;, lastName = &quot;Smith&quot;;
-int personId = 7;
-
-sql &lt;&lt; &quot;insert into person(id, firstname, lastname) values(:id, :fn, :ln)&quot;,
-        use(personId), use(firstName), use(lastName);
-
-sql &lt;&lt; &quot;select firstname, lastname from person where id = :id&quot;,
-        into(firstName), into(lastName), use(personId);
-</code></pre>
-<p>In the code above, the order of "holes" in the SQL statement and the order of <code>into</code> and <code>use</code> expression should match.</p>
-<h2 id="binding-by-name">Binding by name</h2>
-<p>The SQL placeholders that have their names (with colon) can be bound by name to clearly associate the local variable with the given placeholder.</p>
-<p>This explicit naming allows to use different order of elements:</p>
-<pre><code class="language-cpp">string firstName = &quot;John&quot;, lastName = &quot;Smith&quot;;
-int personId = 7;
-sql &lt;&lt; &quot;insert into person(id, firstname, lastname) values(:id, :fn, :ln)&quot;,
-    use(firstName, &quot;fn&quot;), use(lastName, &quot;ln&quot;), use(personId, &quot;id&quot;);
-</code></pre>
-<p>or bind the same local data to many "holes" at the same time:</p>
-<pre><code class="language-cpp">string addr = &quot;...&quot;;
-sql &lt;&lt; &quot;update person&quot;
-        &quot; set mainaddress = :addr, contactaddress = :addr&quot;
-        &quot; where id = 7&quot;,
-        use(addr, &quot;addr&quot;);
-</code></pre>
-<h2 id="bulk-operations">Bulk operations</h2>
-<p>Bulk operations allow the user to bind, as into or use element, whole vectors of objects.
-This allows the database backend to optimize access and data transfer and benefit from the fact that <code>std::vector</code> stores data in contiguous memory blocks (the actual optimization depends on the backend and the capability of the underlying data base server).</p>
-<p>It is possible to <code>use</code> the vector as a data source:</p>
-<pre><code class="language-cpp">std::vector&lt;int&gt; v;
-// ...
-sql &lt;&lt; &quot;insert into t ...&quot;, use(v);
-</code></pre>
-<p>as well as a destination:</p>
-<pre><code class="language-cpp">std::vector&lt;int&gt; v;
-v.resize(100);
-sql &lt;&lt; &quot;select ...&quot;, into(v);
-</code></pre>
-<p>In the latter case the initial size of the vector defines the maximum number of data elements that the user is willing to accept and after executing the query the vector will be automatically resized to reflect that actual number of rows that were read and transmitted.
-That is, the vector will be automatically shrunk if the amount of data that was available was smaller than requested.</p>
-<p>It is also possible to operate on the chosen sub-range of the vector:</p>
-<pre><code class="language-cpp">std::vector&lt;int&gt; v;
-// ...
-std::size_t begin = ...;
-std::size_t end = ...;
-sql &lt;&lt; &quot;insert into t ...&quot;, use(v, begin, end);
-
-// or:
-
-sql &lt;&lt; &quot;select ...&quot;, into(v, begin, end);
-</code></pre>
-<p>Above, only the sub-range of the vector is used for data transfer and in the case of <code>into</code> operation, the <code>end</code> variable will be automatically adjusted to reflect the amount of data that was actually transmitted, but the vector object as a whole will retain its initial size.</p>
-<p>Bulk operations can also involve indicators, see below.</p>
-<p>Bulk operations support user-defined data types, if they have appropriate conversion routines defined.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/boost.md b/docs/boost.md
new file mode 100644
index 0000000..d0511e4
--- /dev/null
+++ b/docs/boost.md
@@ -0,0 +1,83 @@
+# Boost Integration
+
+The SOCI user code can be easily integrated with the [Boost library](http://www.boost.org/) thanks to the very flexible type conversion facility.
+
+The integration with Boost types is optional and is *not* enabled by default, which means that SOCI can also be compiled and used without any dependency on Boost.
+
+In order to enable the support for any of the above types, the user needs to either include one of these headers:
+
+```cpp
+#include <boost-optional.h>
+#include <boost-tuple.h>
+#include <boost-fusion.h>
+#include <boost-gregorian-date.h>
+```
+
+or to define the `SOCI_USE_BOOST` macro before including the `soci.h` main header file.
+
+## Boost.Optional
+
+`boost::optional<T>` provides an alternative way to support the null data condition and as such relieves the user from necessity to handle separate indicator values.
+
+The `boost::optional<T>` objects can be used everywhere where the regular user provided values are expected.
+
+Example:
+
+```cpp
+boost::optional<string> name;
+sql << "select name from person where id = 7", into(name);
+
+if (name.is_initialized())
+{
+    // OK, the name was retrieved and is not-null
+    cout << "The name is " << name.get();
+}
+else
+{
+    // the name is null
+}
+```
+
+The `boost::optional<T>` objects are fully supported for both `into` and `use` elements, in both single and vector forms. They can be also used for user-defined data types.
+
+## Boost.Tuple
+
+`boost::tuple<T1, ...>` allows to work with whole rows of information and in some cases can be more convenient to use than the more dynamically-oriented `row` type.
+
+```cpp
+boost::tuple<string, string, int> person;
+
+sql << "select name, phone, salary from persons where ...",
+        into(person);
+```
+
+Tuples are supported for both `into` and `use` elements.
+They can be used with `rowset` as well.
+
+Tuples can be also composed with `boost::optional<T>`
+
+```cpp
+boost::tuple<string, boost::optional<string>, int> person;
+
+sql << "select name, phone, salary from persons where ...",
+        into(person);
+
+if (person.get<1>().is_initialized())
+{
+    // the given person has a phone number
+}
+else
+{
+    // this person does not have a phone number
+}
+```
+
+## Boost.Fusion
+
+The `boost::fusion::vector` types are supported in the same way as tuples.
+
+**Note:** Support for `boost::fusion::vector` is enabled only if the detected Boost version is at least 1.35.
+
+## Boost.DateTime
+
+The `boost::gregorian::date` is provided as a conversion for base type `std::tm` and can be used as a replacement for it.
diff --git a/docs/boost/index.html b/docs/boost/index.html
deleted file mode 100644
index d926f9f..0000000
--- a/docs/boost/index.html
+++ /dev/null
@@ -1,412 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Boost - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../multithreading/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../utilities/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/boost.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#boost-integration" class="nav-link">Boost Integration</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#boostoptional" class="nav-link">Boost.Optional</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#boosttuple" class="nav-link">Boost.Tuple</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#boostfusion" class="nav-link">Boost.Fusion</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#boostdatetime" class="nav-link">Boost.DateTime</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="boost-integration">Boost Integration</h1>
-<p>The SOCI user code can be easily integrated with the <a href="http://www.boost.org/">Boost library</a> thanks to the very flexible type conversion facility.</p>
-<p>The integration with Boost types is optional and is <em>not</em> enabled by default, which means that SOCI can also be compiled and used without any dependency on Boost.</p>
-<p>In order to enable the support for any of the above types, the user needs to either include one of these headers:</p>
-<pre><code class="language-cpp">#include &lt;boost-optional.h&gt;
-#include &lt;boost-tuple.h&gt;
-#include &lt;boost-fusion.h&gt;
-#include &lt;boost-gregorian-date.h&gt;
-</code></pre>
-<p>or to define the <code>SOCI_USE_BOOST</code> macro before including the <code>soci.h</code> main header file.</p>
-<h2 id="boostoptional">Boost.Optional</h2>
-<p><code>boost::optional&lt;T&gt;</code> provides an alternative way to support the null data condition and as such relieves the user from necessity to handle separate indicator values.</p>
-<p>The <code>boost::optional&lt;T&gt;</code> objects can be used everywhere where the regular user provided values are expected.</p>
-<p>Example:</p>
-<pre><code class="language-cpp">boost::optional&lt;string&gt; name;
-sql &lt;&lt; &quot;select name from person where id = 7&quot;, into(name);
-
-if (name.is_initialized())
-{
-    // OK, the name was retrieved and is not-null
-    cout &lt;&lt; &quot;The name is &quot; &lt;&lt; name.get();
-}
-else
-{
-    // the name is null
-}
-</code></pre>
-<p>The <code>boost::optional&lt;T&gt;</code> objects are fully supported for both <code>into</code> and <code>use</code> elements, in both single and vector forms. They can be also used for user-defined data types.</p>
-<h2 id="boosttuple">Boost.Tuple</h2>
-<p><code>boost::tuple&lt;T1, ...&gt;</code> allows to work with whole rows of information and in some cases can be more convenient to use than the more dynamically-oriented <code>row</code> type.</p>
-<pre><code class="language-cpp">boost::tuple&lt;string, string, int&gt; person;
-
-sql &lt;&lt; &quot;select name, phone, salary from persons where ...&quot;,
-        into(person);
-</code></pre>
-<p>Tuples are supported for both <code>into</code> and <code>use</code> elements.
-They can be used with <code>rowset</code> as well.</p>
-<p>Tuples can be also composed with <code>boost::optional&lt;T&gt;</code></p>
-<pre><code class="language-cpp">boost::tuple&lt;string, boost::optional&lt;string&gt;, int&gt; person;
-
-sql &lt;&lt; &quot;select name, phone, salary from persons where ...&quot;,
-        into(person);
-
-if (person.get&lt;1&gt;().is_initialized())
-{
-    // the given person has a phone number
-}
-else
-{
-    // this person does not have a phone number
-}
-</code></pre>
-<h2 id="boostfusion">Boost.Fusion</h2>
-<p>The <code>boost::fusion::vector</code> types are supported in the same way as tuples.</p>
-<p><strong>Note:</strong> Support for <code>boost::fusion::vector</code> is enabled only if the detected Boost version is at least 1.35.</p>
-<h2 id="boostdatetime">Boost.DateTime</h2>
-<p>The <code>boost::gregorian::date</code> is provided as a conversion for base type <code>std::tm</code> and can be used as a replacement for it.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/connections.md b/docs/connections.md
new file mode 100644
index 0000000..789b993
--- /dev/null
+++ b/docs/connections.md
@@ -0,0 +1,163 @@
+# Connections
+
+The `session` class encapsulates the database connection and other backend-related details, which are common to all the statements that will be later executed. It has a couple of overloaded constructors.
+
+## Using backend factory
+
+The most basic one expects two parameters: the requested backend factory object and the generic connection string,
+which meaning is backend-dependent.
+
+Example:
+
+```cpp
+session sql(oracle, "service=orcl user=scott password=tiger");
+```
+
+Another example might be:
+
+```cpp
+session sql(postgresql, "dbname=mydb");
+```
+
+Above, the `sql` object is a local (automatic) object that encapsulates the connection.
+
+This `session` constructor either connects successfully, or throws an exception.
+
+### Portability note
+
+In case of SOCI linked against DLLs on Windows, the factory objects are not exported from the DLLs.
+In order to avoid linker errors, access factory objects via dedicated backend functions
+provided (eg. `factory_postgresql()`).
+
+## Using loadable backends
+
+Dynamically loadable backends are compiled as shared libraries and allow to select backends at run-time by name.
+
+The usage is similar to the above, but instead of providing the factory object, the backend name is expected:
+
+```cpp
+session sql("postgresql", "dbname=mydb");
+```
+
+For convenience, the URL-like form that combines both the backend name with connection parameters is supported as well:
+
+```cpp
+session sql("postgresql://dbname=mydb");
+```
+
+The last two constructors described above try to locate the shared library with the name `libsoci_ABC.so` (or `libsoci_ABC.dll` on Windows), where ABC is the backend name.
+In the above examples, the expected library name will be `libsoci_postgresql.so` for Unix-like systems.
+
+The most general form of the constructor takes a single object of `connection_parameters` type which contains a pointer to the backend to use, the connection string and also any connection options.
+Using this constructor is the only way to pass any non-default options to the backend.
+
+For example, to suppress any interactive prompts when using ODBC backend you could do:
+
+```cpp
+connection_parameters parameters("odbc", "DSN=mydb");
+parameters.set_option(odbc_option_driver_complete, "0" /* SQL_DRIVER_NOPROMPT */);
+session sql(parameters);
+```
+
+Notice that you need to `#include<soci-odbc.h>` to obtain the option name declaration.
+The existing options are described in the backend-specific part of the documentation.
+
+IBM DB2 driver for ODBC and CLI also support the driver completion requests.
+So, the DB2 backend provides similar option `db2_option_driver_complete` with `#include <soci-db2.h>` required to obtain the option name.
+
+### Environment configuration
+
+The `SOCI_BACKENDS_PATH` environment variable defines the set of paths where the shared libraries will be searched for.
+There can be many paths, separated by colons, and they are used from left to right until the library with the appropriate name is found. If this variable is not set or is empty, the current directory is used as a default path for dynamically loaded backends.
+
+## Using registered backends
+
+The run-time selection of backends is also supported with libraries linked statically.
+
+Each backend provides a separate function of the form `register_factory_*name*`, where `*name*` is a backend name. Thus:
+
+```cpp
+extern "C" void register_factory_postgresql();
+// ...
+register_factory_postgresql();
+session sql("postgresql://dbname=mydb");
+```
+
+The above example registers the backend for PostgreSQL and later creates the session object for that backend.
+This form is provided for those projects that prefer static linking but still wish to benefit from run-time backend selection.
+
+An alternative way to set up the session is to create it in the disconnected state and connect later:
+
+```cpp
+session sql;
+
+// some time later:
+sql.open(postgresql, "dbname=mydb");
+
+// or:
+sql.open("postgresql://dbname=mydb");
+
+// or also:
+connection_parameters parameters("postgresql", "dbname=mydb");
+sql.open(parameters);
+```
+
+The rules for backend naming are the same as with the constructors described above.
+
+The session can be also explicitly `close`d and `reconnect`ed, which can help with basic session error recovery, e.g. the application could check if `is_connected` still returns true after getting an error and attempt to call `reconnect` if it doesn't.
+The `reconnect` function has no parameters and attempts to use the same values as those provided with earlier constructor or `open` calls.
+
+See also the page devoted to [multithreading](multithreading.md) for a detailed description of connection pools.
+
+It is possible to have many active `session`s at the same time, even using different backends.
+
+### Portability note
+
+The following backend factories are currently (as of 3.1.0 release) available:
+
+* [mysql](backends/mysql.md) (requires `#include "soci-mysql.h"`)
+* [oracle](backends/oracle.md) (requires `#include "soci-oracle.h"`)
+* [postgresql](backends/postgresql.md) (requires `#include "soci-postgresql.h"`)
+
+The following backends are also available, with various levels of completeness:
+
+* [sqlite3](backends/sqlite3.md) (requires `#include "soci-sqlite3.h"`)
+* [odbc](backends/odbc.md) (requires `#include "soci-odbc.h"`)
+* [firebird](backends/firebird.md) (requires `#include "soci-firebird.h"`)
+* [db2](backends/db2.md) (requires `#include "soci-db2.h"`)
+
+## Connection failover
+
+The `failover_callback` interface can be used as a callback channel for notifications of events that are automatically processed when the session is forcibly closed due to connectivity problems. The user can override the following methods:
+
+```cpp
+// Called when the failover operation has started,
+// after discovering connectivity problems.
+virtual void started();
+
+// Called after successful failover and creating a new connection;
+// the sql parameter denotes the new connection and allows the user
+// to replay any initial sequence of commands (like session configuration).
+virtual void finished(session & sql);
+
+// Called when the attempt to reconnect failed,
+// if the user code sets the retry parameter to true,
+// then new connection will be attempted;
+// the newTarget connection string is a hint that can be ignored
+// by external means.
+virtual void failed(bool & retry, std::string & newTarget);
+
+// Called when there was a failure that prevents further failover attempts.
+virtual void aborted();
+```
+
+The user-provided callback implementation can be installed (or reset) with:
+
+```cpp
+sql.set_failover_callback(myCallback);
+```
+
+### Portability note
+
+The `failover_callback` functionality is currently supported only by PostgreSQL and Oracle backends (in the latter case the failover mechanism is governed by the Oracle-specific cluster configuration settings).
+Other backends allow the callback object to be installed, but will ignore it and will not generate notification calls.
diff --git a/docs/connections/index.html b/docs/connections/index.html
deleted file mode 100644
index 32988b0..0000000
--- a/docs/connections/index.html
+++ /dev/null
@@ -1,465 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Connections - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../faq/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../queries/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/connections.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#connections" class="nav-link">Connections</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#using-backend-factory" class="nav-link">Using backend factory</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#using-loadable-backends" class="nav-link">Using loadable backends</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#using-registered-backends" class="nav-link">Using registered backends</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#connection-failover" class="nav-link">Connection failover</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="connections">Connections</h1>
-<p>The <code>session</code> class encapsulates the database connection and other backend-related details, which are common to all the statements that will be later executed. It has a couple of overloaded constructors.</p>
-<h2 id="using-backend-factory">Using backend factory</h2>
-<p>The most basic one expects two parameters: the requested backend factory object and the generic connection string,
-which meaning is backend-dependent.</p>
-<p>Example:</p>
-<pre><code class="language-cpp">session sql(oracle, &quot;service=orcl user=scott password=tiger&quot;);
-</code></pre>
-<p>Another example might be:</p>
-<pre><code class="language-cpp">session sql(postgresql, &quot;dbname=mydb&quot;);
-</code></pre>
-<p>Above, the <code>sql</code> object is a local (automatic) object that encapsulates the connection.</p>
-<p>This <code>session</code> constructor either connects successfully, or throws an exception.</p>
-<h3 id="portability-note">Portability note</h3>
-<p>In case of SOCI linked against DLLs on Windows, the factory objects are not exported from the DLLs.
-In order to avoid linker errors, access factory objects via dedicated backend functions
-provided (eg. <code>factory_postgresql()</code>).</p>
-<h2 id="using-loadable-backends">Using loadable backends</h2>
-<p>Dynamically loadable backends are compiled as shared libraries and allow to select backends at run-time by name.</p>
-<p>The usage is similar to the above, but instead of providing the factory object, the backend name is expected:</p>
-<pre><code class="language-cpp">session sql(&quot;postgresql&quot;, &quot;dbname=mydb&quot;);
-</code></pre>
-<p>For convenience, the URL-like form that combines both the backend name with connection parameters is supported as well:</p>
-<pre><code class="language-cpp">session sql(&quot;postgresql://dbname=mydb&quot;);
-</code></pre>
-<p>The last two constructors described above try to locate the shared library with the name <code>libsoci_ABC.so</code> (or <code>libsoci_ABC.dll</code> on Windows), where ABC is the backend name.
-In the above examples, the expected library name will be <code>libsoci_postgresql.so</code> for Unix-like systems.</p>
-<p>The most general form of the constructor takes a single object of <code>connection_parameters</code> type which contains a pointer to the backend to use, the connection string and also any connection options.
-Using this constructor is the only way to pass any non-default options to the backend.</p>
-<p>For example, to suppress any interactive prompts when using ODBC backend you could do:</p>
-<pre><code class="language-cpp">connection_parameters parameters(&quot;odbc&quot;, &quot;DSN=mydb&quot;);
-parameters.set_option(odbc_option_driver_complete, &quot;0&quot; /* SQL_DRIVER_NOPROMPT */);
-session sql(parameters);
-</code></pre>
-<p>Notice that you need to <code>#include&lt;soci-odbc.h&gt;</code> to obtain the option name declaration.
-The existing options are described in the backend-specific part of the documentation.</p>
-<p>IBM DB2 driver for ODBC and CLI also support the driver completion requests.
-So, the DB2 backend provides similar option <code>db2_option_driver_complete</code> with <code>#include &lt;soci-db2.h&gt;</code> required to obtain the option name.</p>
-<h3 id="environment-configuration">Environment configuration</h3>
-<p>The <code>SOCI_BACKENDS_PATH</code> environment variable defines the set of paths where the shared libraries will be searched for.
-There can be many paths, separated by colons, and they are used from left to right until the library with the appropriate name is found. If this variable is not set or is empty, the current directory is used as a default path for dynamically loaded backends.</p>
-<h2 id="using-registered-backends">Using registered backends</h2>
-<p>The run-time selection of backends is also supported with libraries linked statically.</p>
-<p>Each backend provides a separate function of the form <code>register_factory_*name*</code>, where <code>*name*</code> is a backend name. Thus:</p>
-<pre><code class="language-cpp">extern &quot;C&quot; void register_factory_postgresql();
-// ...
-register_factory_postgresql();
-session sql(&quot;postgresql://dbname=mydb&quot;);
-</code></pre>
-<p>The above example registers the backend for PostgreSQL and later creates the session object for that backend.
-This form is provided for those projects that prefer static linking but still wish to benefit from run-time backend selection.</p>
-<p>An alternative way to set up the session is to create it in the disconnected state and connect later:</p>
-<pre><code class="language-cpp">session sql;
-
-// some time later:
-sql.open(postgresql, &quot;dbname=mydb&quot;);
-
-// or:
-sql.open(&quot;postgresql://dbname=mydb&quot;);
-
-// or also:
-connection_parameters parameters(&quot;postgresql&quot;, &quot;dbname=mydb&quot;);
-sql.open(parameters);
-</code></pre>
-<p>The rules for backend naming are the same as with the constructors described above.</p>
-<p>The session can be also explicitly <code>close</code>d and <code>reconnect</code>ed, which can help with basic session error recovery, e.g. the application could check if <code>is_connected</code> still returns true after getting an error and attempt to call <code>reconnect</code> if it doesn't.
-The <code>reconnect</code> function has no parameters and attempts to use the same values as those provided with earlier constructor or <code>open</code> calls.</p>
-<p>See also the page devoted to <a href="../multithreading/">multithreading</a> for a detailed description of connection pools.</p>
-<p>It is possible to have many active <code>session</code>s at the same time, even using different backends.</p>
-<h3 id="portability-note_1">Portability note</h3>
-<p>The following backend factories are currently (as of 3.1.0 release) available:</p>
-<ul>
-<li><a href="../backends/mysql/">mysql</a> (requires <code>#include "soci-mysql.h"</code>)</li>
-<li><a href="../backends/oracle/">oracle</a> (requires <code>#include "soci-oracle.h"</code>)</li>
-<li><a href="../backends/postgresql/">postgresql</a> (requires <code>#include "soci-postgresql.h"</code>)</li>
-</ul>
-<p>The following backends are also available, with various levels of completeness:</p>
-<ul>
-<li><a href="../backends/sqlite3/">sqlite3</a> (requires <code>#include "soci-sqlite3.h"</code>)</li>
-<li><a href="../backends/odbc/">odbc</a> (requires <code>#include "soci-odbc.h"</code>)</li>
-<li><a href="../backends/firebird/">firebird</a> (requires <code>#include "soci-firebird.h"</code>)</li>
-<li><a href="../backends/db2/">db2</a> (requires <code>#include "soci-db2.h"</code>)</li>
-</ul>
-<h2 id="connection-failover">Connection failover</h2>
-<p>The <code>failover_callback</code> interface can be used as a callback channel for notifications of events that are automatically processed when the session is forcibly closed due to connectivity problems. The user can override the following methods:</p>
-<pre><code class="language-cpp">// Called when the failover operation has started,
-// after discovering connectivity problems.
-virtual void started();
-
-// Called after successful failover and creating a new connection;
-// the sql parameter denotes the new connection and allows the user
-// to replay any initial sequence of commands (like session configuration).
-virtual void finished(session &amp; sql);
-
-// Called when the attempt to reconnect failed,
-// if the user code sets the retry parameter to true,
-// then new connection will be attempted;
-// the newTarget connection string is a hint that can be ignored
-// by external means.
-virtual void failed(bool &amp; retry, std::string &amp; newTarget);
-
-// Called when there was a failure that prevents further failover attempts.
-virtual void aborted();
-</code></pre>
-<p>The user-provided callback implementation can be installed (or reset) with:</p>
-<pre><code class="language-cpp">sql.set_failover_callback(myCallback);
-</code></pre>
-<h3 id="portability-note_2">Portability note</h3>
-<p>The <code>failover_callback</code> functionality is currently supported only by PostgreSQL and Oracle backends (in the latter case the failover mechanism is governed by the Oracle-specific cluster configuration settings).
-Other backends allow the callback object to be installed, but will ignore it and will not generate notification calls.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/css/base.css b/docs/css/base.css
deleted file mode 100644
index 13f6c91..0000000
--- a/docs/css/base.css
+++ /dev/null
@@ -1,318 +0,0 @@
-html {
-    /* csslint ignore:start */
-    /* The nav header is 3.5rem high, plus 20px for the margin-top of the
-       main container. */
-    scroll-padding-top: calc(3.5rem + 20px);
-    /* csslint ignore:end */
-}
-
-/* Replacement for `body { background-attachment: fixed; }`, which has
-   performance issues when scrolling on large displays. See #1394. */
-body::before {
-    content: ' ';
-    position: fixed;
-    width: 100%;
-    height: 100%;
-    top: 0;
-    left: 0;
-    background-color: #f8f8f8;
-    background: url(../img/grid.png) repeat-x;
-    will-change: transform;
-    z-index: -1;
-}
-
-body > .container {
-    margin-top: 20px;
-    min-height: 400px;
-}
-
-.navbar.fixed-top { /* csslint allow: adjoining-classes */
-    /* csslint ignore:start */
-    position: -webkit-sticky;
-    position: sticky;
-    /* csslint ignore:end */
-}
-
-.source-links {
-    float: right;
-}
-
-.col-md-9 img {
-    max-width: 100%;
-    display: inline-block;
-    padding: 4px;
-    line-height: 1.428571429;
-    background-color: #fff;
-    border: 1px solid #ddd;
-    border-radius: 4px;
-    margin: 20px auto 30px auto;
-}
-
-h1 {
-    color: #444;
-    font-weight: 400;
-    font-size: 42px;
-}
-
-h2, h3, h4, h5, h6 {
-    color: #444;
-    font-weight: 300;
-}
-
-hr {
-    border-top: 1px solid #aaa;
-}
-
-pre, .rst-content tt {
-    max-width: 100%;
-    background: #fff;
-    border: solid 1px #e1e4e5;
-    color: #333;
-    overflow-x: auto;
-}
-
-code.code-large, .rst-content tt.code-large {
-    font-size: 90%;
-}
-
-code {
-    padding: 2px 5px;
-    background: #fff;
-    border: solid 1px #e1e4e5;
-    color: #333;
-    white-space: pre-wrap;
-    word-wrap: break-word;
-}
-
-pre code {
-    display: block;
-    background: transparent;
-    border: none;
-    white-space: pre;
-    word-wrap: normal;
-    font-family: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
-    font-size: 12px;
-}
-
-kbd {
-    padding: 2px 4px;
-    font-size: 90%;
-    color: #fff;
-    background-color: #333;
-    border-radius: 3px;
-    -webkit-box-shadow: inset 0 -1px 0 rgba(0,0,0,.25);
-    box-shadow: inset 0 -1px 0 rgba(0,0,0,.25);
-}
-
-a code {
-    color: #2FA4E7;
-}
-
-a:hover code, a:focus code {
-    color: #157AB5;
-}
-
-footer {
-    margin-top: 30px;
-    margin-bottom: 10px;
-    text-align: center;
-    font-weight: 200;
-}
-
-.modal-dialog {
-    margin-top: 60px;
-}
-
-/*
- * Side navigation
- *
- * Scrollspy and affixed enhanced navigation to highlight sections and secondary
- * sections of docs content.
- */
-
-.bs-sidebar.affix { /* csslint allow: adjoining-classes */
-    /* csslint ignore:start */
-    position: -webkit-sticky;
-    position: sticky;
-    /* csslint ignore:end */
-    /* The nav header is 3.5rem high, plus 20px for the margin-top of the
-       main container. */
-    top: calc(3.5rem + 20px);
-}
-
-.bs-sidebar.card { /* csslint allow: adjoining-classes */
-    padding: 0;
-    max-height: 90%;
-    overflow-y: auto;
-}
-
-/* Toggle (vertically flip) sidebar collapse icon */
-.bs-sidebar .navbar-toggler span {
-    -moz-transform: scale(1, -1);
-    -webkit-transform: scale(1, -1);
-    -o-transform: scale(1, -1);
-    -ms-transform: scale(1, -1);
-    transform: scale(1, -1);
-}
-
-.bs-sidebar .navbar-toggler.collapsed span { /* csslint allow: adjoining-classes */
-    -moz-transform: scale(1, 1);
-    -webkit-transform: scale(1, 1);
-    -o-transform: scale(1, 1);
-    -ms-transform: scale(1, 1);
-    transform: scale(1, 1);
-}
-
-/* First level of nav */
-.bs-sidebar > .navbar-collapse > .nav {
-    padding-top:    10px;
-    padding-bottom: 10px;
-    border-radius: 5px;
-    width: 100%;
-}
-
-/* All levels of nav */
-.bs-sidebar .nav > li > a {
-    display: block;
-    padding: 5px 20px;
-    z-index: 1;
-}
-.bs-sidebar .nav > li > a:hover,
-.bs-sidebar .nav > li > a:focus {
-    text-decoration: none;
-    border-right: 1px solid;
-}
-.bs-sidebar .nav > li > a.active,
-.bs-sidebar .nav > li > a.active:hover,
-.bs-sidebar .nav > li > a.active:focus {
-    font-weight: bold;
-    background-color: transparent;
-    border-right: 1px solid;
-}
-
-.bs-sidebar .nav .nav .nav {
-    margin-left: 1em;
-}
-
-.bs-sidebar .nav > li > a {
-    font-weight: bold;
-}
-
-.bs-sidebar .nav .nav > li > a {
-    font-weight: normal;
-}
-
-.headerlink {
-    font-family: FontAwesome;
-    font-size: 14px;
-    display: none;
-    padding-left: .5em;
-}
-
-h1:hover .headerlink, h2:hover .headerlink, h3:hover .headerlink, h4:hover .headerlink, h5:hover .headerlink, h6:hover .headerlink{
-    display:inline-block;
-}
-
-
-
-.admonition {
-    padding: 15px;
-    margin-bottom: 20px;
-    border: 1px solid transparent;
-    border-radius: 4px;
-    text-align: left;
-}
-
-.admonition.note { /* csslint allow: adjoining-classes */
-    color: #3a87ad;
-    background-color: #d9edf7;
-    border-color: #bce8f1;
-}
-
-.admonition.warning { /* csslint allow: adjoining-classes */
-    color: #c09853;
-    background-color: #fcf8e3;
-    border-color: #fbeed5;
-}
-
-.admonition.danger { /* csslint allow: adjoining-classes */
-    color: #b94a48;
-    background-color: #f2dede;
-    border-color: #eed3d7;
-}
-
-.admonition-title {
-    font-weight: bold;
-    text-align: left;
-}
-
-@media (max-width: 991.98px) {
-    .navbar-collapse.show { /* csslint allow: adjoining-classes */
-        overflow-y: auto;
-        max-height: calc(100vh - 3.5rem);
-    }
-}
-
-.dropdown-item.open { /* csslint allow: adjoining-classes */
-    color: #fff;
-    background-color: #2FA4E7;
-}
-
-.dropdown-submenu > .dropdown-menu {
-    margin: 0 0 0 1.5rem;
-    padding: 0;
-    border-width: 0;
-}
-
-.dropdown-submenu > a::after {
-    display: block;
-    content: " ";
-    float: right;
-    width: 0;
-    height: 0;
-    border-color: transparent;
-    border-style: solid;
-    border-width: 5px 0 5px 5px;
-    border-left-color: #ccc;
-    margin-top: 5px;
-    margin-right: -10px;
-}
-
-.dropdown-submenu:hover > a::after {
-    border-left-color: #fff;
-}
-
-@media (min-width: 992px) {
-    .dropdown-menu {
-        overflow-y: auto;
-        max-height: calc(100vh - 3.5rem);
-    }
-
-    .dropdown-submenu {
-        position: relative;
-    }
-
-    .dropdown-submenu > .dropdown-menu {
-        /* csslint ignore:start */
-        position: fixed !important;
-        /* csslint ignore:end */
-        margin-top: -9px;
-        margin-left: -2px;
-        border-width: 1px;
-        padding: 0.5rem 0;
-    }
-
-    .dropdown-submenu.pull-left { /* csslint allow: adjoining-classes */
-        float: none;
-    }
-
-    .dropdown-submenu.pull-left > .dropdown-menu { /* csslint allow: adjoining-classes */
-        left: -100%;
-        margin-left: 10px;
-    }
-}
-
-@media print {
-    /* Remove sidebar when print */
-    .col-md-3 { display: none; }
-}
diff --git a/docs/css/bootstrap.min.css b/docs/css/bootstrap.min.css
deleted file mode 100644
index 4ce503d..0000000
--- a/docs/css/bootstrap.min.css
+++ /dev/null
@@ -1,12 +0,0 @@
-/*!
- * Bootswatch v4.1.3
- * Homepage: https://bootswatch.com
- * Copyright 2012-2018 Thomas Park
- * Licensed under MIT
- * Based on Bootstrap
-*//*!
- * Bootstrap v4.1.3 (https://getbootstrap.com/)
- * Copyright 2011-2018 The Bootstrap Authors
- * Copyright 2011-2018 Twitter, Inc.
- * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
- */:root{--blue:#033C73;--indigo:#6610f2;--purple:#6f42c1;--pink:#e83e8c;--red:#C71C22;--orange:#fd7e14;--yellow:#DD5600;--green:#73A839;--teal:#20c997;--cyan:#2FA4E7;--white:#fff;--gray:#868e96;--gray-dark:#343a40;--primary:#2FA4E7;--secondary:#e9ecef;--success:#73A839;--info:#033C73;--warning:#DD5600;--danger:#C71C22;--light:#f8f9fa;--dark:#343a40;--breakpoint-xs:0;--breakpoint-sm:576px;--breakpoint-md:768px;--breakpoint-lg:992px;--breakpoint-xl:1200px;--font-family-sans-serif:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-family-monospace:SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}*,*::before,*::after{-webkit-box-sizing:border-box;box-sizing:border-box}html{font-family:sans-serif;line-height:1.15;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%;-ms-overflow-style:scrollbar;-webkit-tap-highlight-color:transparent}@-ms-viewport{width:device-width}article,aside,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}body{margin:0;font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";font-size:1rem;font-weight:400;line-height:1.5;color:#495057;text-align:left;background-color:#fff}[tabindex="-1"]:focus{outline:0 !important}hr{-webkit-box-sizing:content-box;box-sizing:content-box;height:0;overflow:visible}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:0.5rem}p{margin-top:0;margin-bottom:1rem}abbr[title],abbr[data-original-title]{text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;border-bottom:0}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul,dl{margin-top:0;margin-bottom:1rem}ol ol,ul ul,ol ul,ul ol{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}dfn{font-style:italic}b,strong{font-weight:bolder}small{font-size:80%}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#2FA4E7;text-decoration:none;background-color:transparent;-webkit-text-decoration-skip:objects}a:hover{color:#157ab5;text-decoration:underline}a:not([href]):not([tabindex]){color:inherit;text-decoration:none}a:not([href]):not([tabindex]):hover,a:not([href]):not([tabindex]):focus{color:inherit;text-decoration:none}a:not([href]):not([tabindex]):focus{outline:0}pre,code,kbd,samp{font-family:SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;font-size:1em}pre{margin-top:0;margin-bottom:1rem;overflow:auto;-ms-overflow-style:scrollbar}figure{margin:0 0 1rem}img{vertical-align:middle;border-style:none}svg{overflow:hidden;vertical-align:middle}table{border-collapse:collapse}caption{padding-top:0.75rem;padding-bottom:0.75rem;color:#868e96;text-align:left;caption-side:bottom}th{text-align:inherit}label{display:inline-block;margin-bottom:0.5rem}button{border-radius:0}button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}input,button,select,optgroup,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,input{overflow:visible}button,select{text-transform:none}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{padding:0;border-style:none}input[type="radio"],input[type="checkbox"]{-webkit-box-sizing:border-box;box-sizing:border-box;padding:0}input[type="date"],input[type="time"],input[type="datetime-local"],input[type="month"]{-webkit-appearance:listbox}textarea{overflow:auto;resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{display:block;width:100%;max-width:100%;padding:0;margin-bottom:.5rem;font-size:1.5rem;line-height:inherit;color:inherit;white-space:normal}progress{vertical-align:baseline}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{outline-offset:-2px;-webkit-appearance:none}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}summary{display:list-item;cursor:pointer}template{display:none}[hidden]{display:none !important}h1,h2,h3,h4,h5,h6,.h1,.h2,.h3,.h4,.h5,.h6{margin-bottom:0.5rem;font-family:inherit;font-weight:500;line-height:1.2;color:#2FA4E7}h1,.h1{font-size:2.5rem}h2,.h2{font-size:2rem}h3,.h3{font-size:1.75rem}h4,.h4{font-size:1.5rem}h5,.h5{font-size:1.25rem}h6,.h6{font-size:1rem}.lead{font-size:1.25rem;font-weight:300}.display-1{font-size:6rem;font-weight:300;line-height:1.2}.display-2{font-size:5.5rem;font-weight:300;line-height:1.2}.display-3{font-size:4.5rem;font-weight:300;line-height:1.2}.display-4{font-size:3.5rem;font-weight:300;line-height:1.2}hr{margin-top:1rem;margin-bottom:1rem;border:0;border-top:1px solid rgba(0,0,0,0.1)}small,.small{font-size:80%;font-weight:400}mark,.mark{padding:0.2em;background-color:#fcf8e3}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:0.5rem}.initialism{font-size:90%;text-transform:uppercase}.blockquote{margin-bottom:1rem;font-size:1.25rem}.blockquote-footer{display:block;font-size:80%;color:#868e96}.blockquote-footer::before{content:"\2014 \00A0"}.img-fluid{max-width:100%;height:auto}.img-thumbnail{padding:0.25rem;background-color:#fff;border:1px solid #dee2e6;border-radius:0.25rem;max-width:100%;height:auto}.figure{display:inline-block}.figure-img{margin-bottom:0.5rem;line-height:1}.figure-caption{font-size:90%;color:#868e96}code{font-size:87.5%;color:#e83e8c;word-break:break-word}a>code{color:inherit}kbd{padding:0.2rem 0.4rem;font-size:87.5%;color:#fff;background-color:#212529;border-radius:0.2rem}kbd kbd{padding:0;font-size:100%;font-weight:700}pre{display:block;font-size:87.5%;color:#212529}pre code{font-size:inherit;color:inherit;word-break:normal}.pre-scrollable{max-height:340px;overflow-y:scroll}.container{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}@media (min-width: 576px){.container{max-width:540px}}@media (min-width: 768px){.container{max-width:720px}}@media (min-width: 992px){.container{max-width:960px}}@media (min-width: 1200px){.container{max-width:1140px}}.container-fluid{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}.row{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-15px;margin-left:-15px}.no-gutters{margin-right:0;margin-left:0}.no-gutters>.col,.no-gutters>[class*="col-"]{padding-right:0;padding-left:0}.col-1,.col-2,.col-3,.col-4,.col-5,.col-6,.col-7,.col-8,.col-9,.col-10,.col-11,.col-12,.col,.col-auto,.col-sm-1,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm,.col-sm-auto,.col-md-1,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-10,.col-md-11,.col-md-12,.col-md,.col-md-auto,.col-lg-1,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg,.col-lg-auto,.col-xl-1,.col-xl-2,.col-xl-3,.col-xl-4,.col-xl-5,.col-xl-6,.col-xl-7,.col-xl-8,.col-xl-9,.col-xl-10,.col-xl-11,.col-xl-12,.col-xl,.col-xl-auto{position:relative;width:100%;min-height:1px;padding-right:15px;padding-left:15px}.col{-ms-flex-preferred-size:0;flex-basis:0;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-auto{-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:none}.col-1{-webkit-box-flex:0;-ms-flex:0 0 8.3333333333%;flex:0 0 8.3333333333%;max-width:8.3333333333%}.col-2{-webkit-box-flex:0;-ms-flex:0 0 16.6666666667%;flex:0 0 16.6666666667%;max-width:16.6666666667%}.col-3{-webkit-box-flex:0;-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-4{-webkit-box-flex:0;-ms-flex:0 0 33.3333333333%;flex:0 0 33.3333333333%;max-width:33.3333333333%}.col-5{-webkit-box-flex:0;-ms-flex:0 0 41.6666666667%;flex:0 0 41.6666666667%;max-width:41.6666666667%}.col-6{-webkit-box-flex:0;-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-7{-webkit-box-flex:0;-ms-flex:0 0 58.3333333333%;flex:0 0 58.3333333333%;max-width:58.3333333333%}.col-8{-webkit-box-flex:0;-ms-flex:0 0 66.6666666667%;flex:0 0 66.6666666667%;max-width:66.6666666667%}.col-9{-webkit-box-flex:0;-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-10{-webkit-box-flex:0;-ms-flex:0 0 83.3333333333%;flex:0 0 83.3333333333%;max-width:83.3333333333%}.col-11{-webkit-box-flex:0;-ms-flex:0 0 91.6666666667%;flex:0 0 91.6666666667%;max-width:91.6666666667%}.col-12{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-first{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.order-last{-webkit-box-ordinal-group:14;-ms-flex-order:13;order:13}.order-0{-webkit-box-ordinal-group:1;-ms-flex-order:0;order:0}.order-1{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}.order-2{-webkit-box-ordinal-group:3;-ms-flex-order:2;order:2}.order-3{-webkit-box-ordinal-group:4;-ms-flex-order:3;order:3}.order-4{-webkit-box-ordinal-group:5;-ms-flex-order:4;order:4}.order-5{-webkit-box-ordinal-group:6;-ms-flex-order:5;order:5}.order-6{-webkit-box-ordinal-group:7;-ms-flex-order:6;order:6}.order-7{-webkit-box-ordinal-group:8;-ms-flex-order:7;order:7}.order-8{-webkit-box-ordinal-group:9;-ms-flex-order:8;order:8}.order-9{-webkit-box-ordinal-group:10;-ms-flex-order:9;order:9}.order-10{-webkit-box-ordinal-group:11;-ms-flex-order:10;order:10}.order-11{-webkit-box-ordinal-group:12;-ms-flex-order:11;order:11}.order-12{-webkit-box-ordinal-group:13;-ms-flex-order:12;order:12}.offset-1{margin-left:8.3333333333%}.offset-2{margin-left:16.6666666667%}.offset-3{margin-left:25%}.offset-4{margin-left:33.3333333333%}.offset-5{margin-left:41.6666666667%}.offset-6{margin-left:50%}.offset-7{margin-left:58.3333333333%}.offset-8{margin-left:66.6666666667%}.offset-9{margin-left:75%}.offset-10{margin-left:83.3333333333%}.offset-11{margin-left:91.6666666667%}@media (min-width: 576px){.col-sm{-ms-flex-preferred-size:0;flex-basis:0;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-sm-auto{-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:none}.col-sm-1{-webkit-box-flex:0;-ms-flex:0 0 8.3333333333%;flex:0 0 8.3333333333%;max-width:8.3333333333%}.col-sm-2{-webkit-box-flex:0;-ms-flex:0 0 16.6666666667%;flex:0 0 16.6666666667%;max-width:16.6666666667%}.col-sm-3{-webkit-box-flex:0;-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-sm-4{-webkit-box-flex:0;-ms-flex:0 0 33.3333333333%;flex:0 0 33.3333333333%;max-width:33.3333333333%}.col-sm-5{-webkit-box-flex:0;-ms-flex:0 0 41.6666666667%;flex:0 0 41.6666666667%;max-width:41.6666666667%}.col-sm-6{-webkit-box-flex:0;-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-sm-7{-webkit-box-flex:0;-ms-flex:0 0 58.3333333333%;flex:0 0 58.3333333333%;max-width:58.3333333333%}.col-sm-8{-webkit-box-flex:0;-ms-flex:0 0 66.6666666667%;flex:0 0 66.6666666667%;max-width:66.6666666667%}.col-sm-9{-webkit-box-flex:0;-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-sm-10{-webkit-box-flex:0;-ms-flex:0 0 83.3333333333%;flex:0 0 83.3333333333%;max-width:83.3333333333%}.col-sm-11{-webkit-box-flex:0;-ms-flex:0 0 91.6666666667%;flex:0 0 91.6666666667%;max-width:91.6666666667%}.col-sm-12{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-sm-first{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.order-sm-last{-webkit-box-ordinal-group:14;-ms-flex-order:13;order:13}.order-sm-0{-webkit-box-ordinal-group:1;-ms-flex-order:0;order:0}.order-sm-1{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}.order-sm-2{-webkit-box-ordinal-group:3;-ms-flex-order:2;order:2}.order-sm-3{-webkit-box-ordinal-group:4;-ms-flex-order:3;order:3}.order-sm-4{-webkit-box-ordinal-group:5;-ms-flex-order:4;order:4}.order-sm-5{-webkit-box-ordinal-group:6;-ms-flex-order:5;order:5}.order-sm-6{-webkit-box-ordinal-group:7;-ms-flex-order:6;order:6}.order-sm-7{-webkit-box-ordinal-group:8;-ms-flex-order:7;order:7}.order-sm-8{-webkit-box-ordinal-group:9;-ms-flex-order:8;order:8}.order-sm-9{-webkit-box-ordinal-group:10;-ms-flex-order:9;order:9}.order-sm-10{-webkit-box-ordinal-group:11;-ms-flex-order:10;order:10}.order-sm-11{-webkit-box-ordinal-group:12;-ms-flex-order:11;order:11}.order-sm-12{-webkit-box-ordinal-group:13;-ms-flex-order:12;order:12}.offset-sm-0{margin-left:0}.offset-sm-1{margin-left:8.3333333333%}.offset-sm-2{margin-left:16.6666666667%}.offset-sm-3{margin-left:25%}.offset-sm-4{margin-left:33.3333333333%}.offset-sm-5{margin-left:41.6666666667%}.offset-sm-6{margin-left:50%}.offset-sm-7{margin-left:58.3333333333%}.offset-sm-8{margin-left:66.6666666667%}.offset-sm-9{margin-left:75%}.offset-sm-10{margin-left:83.3333333333%}.offset-sm-11{margin-left:91.6666666667%}}@media (min-width: 768px){.col-md{-ms-flex-preferred-size:0;flex-basis:0;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-md-auto{-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:none}.col-md-1{-webkit-box-flex:0;-ms-flex:0 0 8.3333333333%;flex:0 0 8.3333333333%;max-width:8.3333333333%}.col-md-2{-webkit-box-flex:0;-ms-flex:0 0 16.6666666667%;flex:0 0 16.6666666667%;max-width:16.6666666667%}.col-md-3{-webkit-box-flex:0;-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-md-4{-webkit-box-flex:0;-ms-flex:0 0 33.3333333333%;flex:0 0 33.3333333333%;max-width:33.3333333333%}.col-md-5{-webkit-box-flex:0;-ms-flex:0 0 41.6666666667%;flex:0 0 41.6666666667%;max-width:41.6666666667%}.col-md-6{-webkit-box-flex:0;-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-md-7{-webkit-box-flex:0;-ms-flex:0 0 58.3333333333%;flex:0 0 58.3333333333%;max-width:58.3333333333%}.col-md-8{-webkit-box-flex:0;-ms-flex:0 0 66.6666666667%;flex:0 0 66.6666666667%;max-width:66.6666666667%}.col-md-9{-webkit-box-flex:0;-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-md-10{-webkit-box-flex:0;-ms-flex:0 0 83.3333333333%;flex:0 0 83.3333333333%;max-width:83.3333333333%}.col-md-11{-webkit-box-flex:0;-ms-flex:0 0 91.6666666667%;flex:0 0 91.6666666667%;max-width:91.6666666667%}.col-md-12{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-md-first{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.order-md-last{-webkit-box-ordinal-group:14;-ms-flex-order:13;order:13}.order-md-0{-webkit-box-ordinal-group:1;-ms-flex-order:0;order:0}.order-md-1{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}.order-md-2{-webkit-box-ordinal-group:3;-ms-flex-order:2;order:2}.order-md-3{-webkit-box-ordinal-group:4;-ms-flex-order:3;order:3}.order-md-4{-webkit-box-ordinal-group:5;-ms-flex-order:4;order:4}.order-md-5{-webkit-box-ordinal-group:6;-ms-flex-order:5;order:5}.order-md-6{-webkit-box-ordinal-group:7;-ms-flex-order:6;order:6}.order-md-7{-webkit-box-ordinal-group:8;-ms-flex-order:7;order:7}.order-md-8{-webkit-box-ordinal-group:9;-ms-flex-order:8;order:8}.order-md-9{-webkit-box-ordinal-group:10;-ms-flex-order:9;order:9}.order-md-10{-webkit-box-ordinal-group:11;-ms-flex-order:10;order:10}.order-md-11{-webkit-box-ordinal-group:12;-ms-flex-order:11;order:11}.order-md-12{-webkit-box-ordinal-group:13;-ms-flex-order:12;order:12}.offset-md-0{margin-left:0}.offset-md-1{margin-left:8.3333333333%}.offset-md-2{margin-left:16.6666666667%}.offset-md-3{margin-left:25%}.offset-md-4{margin-left:33.3333333333%}.offset-md-5{margin-left:41.6666666667%}.offset-md-6{margin-left:50%}.offset-md-7{margin-left:58.3333333333%}.offset-md-8{margin-left:66.6666666667%}.offset-md-9{margin-left:75%}.offset-md-10{margin-left:83.3333333333%}.offset-md-11{margin-left:91.6666666667%}}@media (min-width: 992px){.col-lg{-ms-flex-preferred-size:0;flex-basis:0;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-lg-auto{-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:none}.col-lg-1{-webkit-box-flex:0;-ms-flex:0 0 8.3333333333%;flex:0 0 8.3333333333%;max-width:8.3333333333%}.col-lg-2{-webkit-box-flex:0;-ms-flex:0 0 16.6666666667%;flex:0 0 16.6666666667%;max-width:16.6666666667%}.col-lg-3{-webkit-box-flex:0;-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-lg-4{-webkit-box-flex:0;-ms-flex:0 0 33.3333333333%;flex:0 0 33.3333333333%;max-width:33.3333333333%}.col-lg-5{-webkit-box-flex:0;-ms-flex:0 0 41.6666666667%;flex:0 0 41.6666666667%;max-width:41.6666666667%}.col-lg-6{-webkit-box-flex:0;-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-lg-7{-webkit-box-flex:0;-ms-flex:0 0 58.3333333333%;flex:0 0 58.3333333333%;max-width:58.3333333333%}.col-lg-8{-webkit-box-flex:0;-ms-flex:0 0 66.6666666667%;flex:0 0 66.6666666667%;max-width:66.6666666667%}.col-lg-9{-webkit-box-flex:0;-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-lg-10{-webkit-box-flex:0;-ms-flex:0 0 83.3333333333%;flex:0 0 83.3333333333%;max-width:83.3333333333%}.col-lg-11{-webkit-box-flex:0;-ms-flex:0 0 91.6666666667%;flex:0 0 91.6666666667%;max-width:91.6666666667%}.col-lg-12{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-lg-first{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.order-lg-last{-webkit-box-ordinal-group:14;-ms-flex-order:13;order:13}.order-lg-0{-webkit-box-ordinal-group:1;-ms-flex-order:0;order:0}.order-lg-1{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}.order-lg-2{-webkit-box-ordinal-group:3;-ms-flex-order:2;order:2}.order-lg-3{-webkit-box-ordinal-group:4;-ms-flex-order:3;order:3}.order-lg-4{-webkit-box-ordinal-group:5;-ms-flex-order:4;order:4}.order-lg-5{-webkit-box-ordinal-group:6;-ms-flex-order:5;order:5}.order-lg-6{-webkit-box-ordinal-group:7;-ms-flex-order:6;order:6}.order-lg-7{-webkit-box-ordinal-group:8;-ms-flex-order:7;order:7}.order-lg-8{-webkit-box-ordinal-group:9;-ms-flex-order:8;order:8}.order-lg-9{-webkit-box-ordinal-group:10;-ms-flex-order:9;order:9}.order-lg-10{-webkit-box-ordinal-group:11;-ms-flex-order:10;order:10}.order-lg-11{-webkit-box-ordinal-group:12;-ms-flex-order:11;order:11}.order-lg-12{-webkit-box-ordinal-group:13;-ms-flex-order:12;order:12}.offset-lg-0{margin-left:0}.offset-lg-1{margin-left:8.3333333333%}.offset-lg-2{margin-left:16.6666666667%}.offset-lg-3{margin-left:25%}.offset-lg-4{margin-left:33.3333333333%}.offset-lg-5{margin-left:41.6666666667%}.offset-lg-6{margin-left:50%}.offset-lg-7{margin-left:58.3333333333%}.offset-lg-8{margin-left:66.6666666667%}.offset-lg-9{margin-left:75%}.offset-lg-10{margin-left:83.3333333333%}.offset-lg-11{margin-left:91.6666666667%}}@media (min-width: 1200px){.col-xl{-ms-flex-preferred-size:0;flex-basis:0;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-xl-auto{-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:none}.col-xl-1{-webkit-box-flex:0;-ms-flex:0 0 8.3333333333%;flex:0 0 8.3333333333%;max-width:8.3333333333%}.col-xl-2{-webkit-box-flex:0;-ms-flex:0 0 16.6666666667%;flex:0 0 16.6666666667%;max-width:16.6666666667%}.col-xl-3{-webkit-box-flex:0;-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-xl-4{-webkit-box-flex:0;-ms-flex:0 0 33.3333333333%;flex:0 0 33.3333333333%;max-width:33.3333333333%}.col-xl-5{-webkit-box-flex:0;-ms-flex:0 0 41.6666666667%;flex:0 0 41.6666666667%;max-width:41.6666666667%}.col-xl-6{-webkit-box-flex:0;-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-xl-7{-webkit-box-flex:0;-ms-flex:0 0 58.3333333333%;flex:0 0 58.3333333333%;max-width:58.3333333333%}.col-xl-8{-webkit-box-flex:0;-ms-flex:0 0 66.6666666667%;flex:0 0 66.6666666667%;max-width:66.6666666667%}.col-xl-9{-webkit-box-flex:0;-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-xl-10{-webkit-box-flex:0;-ms-flex:0 0 83.3333333333%;flex:0 0 83.3333333333%;max-width:83.3333333333%}.col-xl-11{-webkit-box-flex:0;-ms-flex:0 0 91.6666666667%;flex:0 0 91.6666666667%;max-width:91.6666666667%}.col-xl-12{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-xl-first{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.order-xl-last{-webkit-box-ordinal-group:14;-ms-flex-order:13;order:13}.order-xl-0{-webkit-box-ordinal-group:1;-ms-flex-order:0;order:0}.order-xl-1{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}.order-xl-2{-webkit-box-ordinal-group:3;-ms-flex-order:2;order:2}.order-xl-3{-webkit-box-ordinal-group:4;-ms-flex-order:3;order:3}.order-xl-4{-webkit-box-ordinal-group:5;-ms-flex-order:4;order:4}.order-xl-5{-webkit-box-ordinal-group:6;-ms-flex-order:5;order:5}.order-xl-6{-webkit-box-ordinal-group:7;-ms-flex-order:6;order:6}.order-xl-7{-webkit-box-ordinal-group:8;-ms-flex-order:7;order:7}.order-xl-8{-webkit-box-ordinal-group:9;-ms-flex-order:8;order:8}.order-xl-9{-webkit-box-ordinal-group:10;-ms-flex-order:9;order:9}.order-xl-10{-webkit-box-ordinal-group:11;-ms-flex-order:10;order:10}.order-xl-11{-webkit-box-ordinal-group:12;-ms-flex-order:11;order:11}.order-xl-12{-webkit-box-ordinal-group:13;-ms-flex-order:12;order:12}.offset-xl-0{margin-left:0}.offset-xl-1{margin-left:8.3333333333%}.offset-xl-2{margin-left:16.6666666667%}.offset-xl-3{margin-left:25%}.offset-xl-4{margin-left:33.3333333333%}.offset-xl-5{margin-left:41.6666666667%}.offset-xl-6{margin-left:50%}.offset-xl-7{margin-left:58.3333333333%}.offset-xl-8{margin-left:66.6666666667%}.offset-xl-9{margin-left:75%}.offset-xl-10{margin-left:83.3333333333%}.offset-xl-11{margin-left:91.6666666667%}}.table{width:100%;margin-bottom:1rem;background-color:transparent}.table th,.table td{padding:0.75rem;vertical-align:top;border-top:1px solid #dee2e6}.table thead th{vertical-align:bottom;border-bottom:2px solid #dee2e6}.table tbody+tbody{border-top:2px solid #dee2e6}.table .table{background-color:#fff}.table-sm th,.table-sm td{padding:0.3rem}.table-bordered{border:1px solid #dee2e6}.table-bordered th,.table-bordered td{border:1px solid #dee2e6}.table-bordered thead th,.table-bordered thead td{border-bottom-width:2px}.table-borderless th,.table-borderless td,.table-borderless thead th,.table-borderless tbody+tbody{border:0}.table-striped tbody tr:nth-of-type(odd){background-color:rgba(0,0,0,0.05)}.table-hover tbody tr:hover{background-color:rgba(0,0,0,0.075)}.table-primary,.table-primary>th,.table-primary>td{background-color:#c5e6f8}.table-hover .table-primary:hover{background-color:#aedcf5}.table-hover .table-primary:hover>td,.table-hover .table-primary:hover>th{background-color:#aedcf5}.table-secondary,.table-secondary>th,.table-secondary>td{background-color:#f9fafb}.table-hover .table-secondary:hover{background-color:#eaedf1}.table-hover .table-secondary:hover>td,.table-hover .table-secondary:hover>th{background-color:#eaedf1}.table-success,.table-success>th,.table-success>td{background-color:#d8e7c8}.table-hover .table-success:hover{background-color:#cbdfb6}.table-hover .table-success:hover>td,.table-hover .table-success:hover>th{background-color:#cbdfb6}.table-info,.table-info>th,.table-info>td{background-color:#b8c8d8}.table-hover .table-info:hover{background-color:#a8bbcf}.table-hover .table-info:hover>td,.table-hover .table-info:hover>th{background-color:#a8bbcf}.table-warning,.table-warning>th,.table-warning>td{background-color:#f5d0b8}.table-hover .table-warning:hover{background-color:#f2c1a2}.table-hover .table-warning:hover>td,.table-hover .table-warning:hover>th{background-color:#f2c1a2}.table-danger,.table-danger>th,.table-danger>td{background-color:#efbfc1}.table-hover .table-danger:hover{background-color:#eaabad}.table-hover .table-danger:hover>td,.table-hover .table-danger:hover>th{background-color:#eaabad}.table-light,.table-light>th,.table-light>td{background-color:#fdfdfe}.table-hover .table-light:hover{background-color:#ececf6}.table-hover .table-light:hover>td,.table-hover .table-light:hover>th{background-color:#ececf6}.table-dark,.table-dark>th,.table-dark>td{background-color:#c6c8ca}.table-hover .table-dark:hover{background-color:#b9bbbe}.table-hover .table-dark:hover>td,.table-hover .table-dark:hover>th{background-color:#b9bbbe}.table-active,.table-active>th,.table-active>td{background-color:rgba(0,0,0,0.075)}.table-hover .table-active:hover{background-color:rgba(0,0,0,0.075)}.table-hover .table-active:hover>td,.table-hover .table-active:hover>th{background-color:rgba(0,0,0,0.075)}.table .thead-dark th{color:#fff;background-color:#212529;border-color:#32383e}.table .thead-light th{color:#495057;background-color:#e9ecef;border-color:#dee2e6}.table-dark{color:#fff;background-color:#212529}.table-dark th,.table-dark td,.table-dark thead th{border-color:#32383e}.table-dark.table-bordered{border:0}.table-dark.table-striped tbody tr:nth-of-type(odd){background-color:rgba(255,255,255,0.05)}.table-dark.table-hover tbody tr:hover{background-color:rgba(255,255,255,0.075)}@media (max-width: 575.98px){.table-responsive-sm{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch;-ms-overflow-style:-ms-autohiding-scrollbar}.table-responsive-sm>.table-bordered{border:0}}@media (max-width: 767.98px){.table-responsive-md{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch;-ms-overflow-style:-ms-autohiding-scrollbar}.table-responsive-md>.table-bordered{border:0}}@media (max-width: 991.98px){.table-responsive-lg{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch;-ms-overflow-style:-ms-autohiding-scrollbar}.table-responsive-lg>.table-bordered{border:0}}@media (max-width: 1199.98px){.table-responsive-xl{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch;-ms-overflow-style:-ms-autohiding-scrollbar}.table-responsive-xl>.table-bordered{border:0}}.table-responsive{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch;-ms-overflow-style:-ms-autohiding-scrollbar}.table-responsive>.table-bordered{border:0}.form-control{display:block;width:100%;height:calc(2.25rem + 2px);padding:0.375rem 0.75rem;font-size:1rem;line-height:1.5;color:#495057;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;border-radius:0.25rem;-webkit-transition:border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;transition:border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out}@media screen and (prefers-reduced-motion: reduce){.form-control{-webkit-transition:none;transition:none}}.form-control::-ms-expand{background-color:transparent;border:0}.form-control:focus{color:#495057;background-color:#fff;border-color:#a1d6f4;outline:0;-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25)}.form-control::-webkit-input-placeholder{color:#868e96;opacity:1}.form-control:-ms-input-placeholder{color:#868e96;opacity:1}.form-control::-ms-input-placeholder{color:#868e96;opacity:1}.form-control::placeholder{color:#868e96;opacity:1}.form-control:disabled,.form-control[readonly]{background-color:#e9ecef;opacity:1}select.form-control:focus::-ms-value{color:#495057;background-color:#fff}.form-control-file,.form-control-range{display:block;width:100%}.col-form-label{padding-top:calc(0.375rem + 1px);padding-bottom:calc(0.375rem + 1px);margin-bottom:0;font-size:inherit;line-height:1.5}.col-form-label-lg{padding-top:calc(0.5rem + 1px);padding-bottom:calc(0.5rem + 1px);font-size:1.25rem;line-height:1.5}.col-form-label-sm{padding-top:calc(0.25rem + 1px);padding-bottom:calc(0.25rem + 1px);font-size:0.875rem;line-height:1.5}.form-control-plaintext{display:block;width:100%;padding-top:0.375rem;padding-bottom:0.375rem;margin-bottom:0;line-height:1.5;color:#495057;background-color:transparent;border:solid transparent;border-width:1px 0}.form-control-plaintext.form-control-sm,.form-control-plaintext.form-control-lg{padding-right:0;padding-left:0}.form-control-sm{height:calc(1.8125rem + 2px);padding:0.25rem 0.5rem;font-size:0.875rem;line-height:1.5;border-radius:0.2rem}.form-control-lg{height:calc(2.875rem + 2px);padding:0.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:0.3rem}select.form-control[size],select.form-control[multiple]{height:auto}textarea.form-control{height:auto}.form-group{margin-bottom:1rem}.form-text{display:block;margin-top:0.25rem}.form-row{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-5px;margin-left:-5px}.form-row>.col,.form-row>[class*="col-"]{padding-right:5px;padding-left:5px}.form-check{position:relative;display:block;padding-left:1.25rem}.form-check-input{position:absolute;margin-top:0.3rem;margin-left:-1.25rem}.form-check-input:disabled ~ .form-check-label{color:#868e96}.form-check-label{margin-bottom:0}.form-check-inline{display:-webkit-inline-box;display:-ms-inline-flexbox;display:inline-flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;padding-left:0;margin-right:0.75rem}.form-check-inline .form-check-input{position:static;margin-top:0;margin-right:0.3125rem;margin-left:0}.valid-feedback{display:none;width:100%;margin-top:0.25rem;font-size:80%;color:#73A839}.valid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:0.25rem 0.5rem;margin-top:.1rem;font-size:0.875rem;line-height:1.5;color:#fff;background-color:rgba(115,168,57,0.9);border-radius:0.25rem}.was-validated .form-control:valid,.form-control.is-valid,.was-validated .custom-select:valid,.custom-select.is-valid{border-color:#73A839}.was-validated .form-control:valid:focus,.form-control.is-valid:focus,.was-validated .custom-select:valid:focus,.custom-select.is-valid:focus{border-color:#73A839;-webkit-box-shadow:0 0 0 0.2rem rgba(115,168,57,0.25);box-shadow:0 0 0 0.2rem rgba(115,168,57,0.25)}.was-validated .form-control:valid ~ .valid-feedback,.was-validated .form-control:valid ~ .valid-tooltip,.form-control.is-valid ~ .valid-feedback,.form-control.is-valid ~ .valid-tooltip,.was-validated .custom-select:valid ~ .valid-feedback,.was-validated .custom-select:valid ~ .valid-tooltip,.custom-select.is-valid ~ .valid-feedback,.custom-select.is-valid ~ .valid-tooltip{display:block}.was-validated .form-control-file:valid ~ .valid-feedback,.was-validated .form-control-file:valid ~ .valid-tooltip,.form-control-file.is-valid ~ .valid-feedback,.form-control-file.is-valid ~ .valid-tooltip{display:block}.was-validated .form-check-input:valid ~ .form-check-label,.form-check-input.is-valid ~ .form-check-label{color:#73A839}.was-validated .form-check-input:valid ~ .valid-feedback,.was-validated .form-check-input:valid ~ .valid-tooltip,.form-check-input.is-valid ~ .valid-feedback,.form-check-input.is-valid ~ .valid-tooltip{display:block}.was-validated .custom-control-input:valid ~ .custom-control-label,.custom-control-input.is-valid ~ .custom-control-label{color:#73A839}.was-validated .custom-control-input:valid ~ .custom-control-label::before,.custom-control-input.is-valid ~ .custom-control-label::before{background-color:#b2d789}.was-validated .custom-control-input:valid ~ .valid-feedback,.was-validated .custom-control-input:valid ~ .valid-tooltip,.custom-control-input.is-valid ~ .valid-feedback,.custom-control-input.is-valid ~ .valid-tooltip{display:block}.was-validated .custom-control-input:valid:checked ~ .custom-control-label::before,.custom-control-input.is-valid:checked ~ .custom-control-label::before{background-color:#8dc450}.was-validated .custom-control-input:valid:focus ~ .custom-control-label::before,.custom-control-input.is-valid:focus ~ .custom-control-label::before{-webkit-box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(115,168,57,0.25);box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(115,168,57,0.25)}.was-validated .custom-file-input:valid ~ .custom-file-label,.custom-file-input.is-valid ~ .custom-file-label{border-color:#73A839}.was-validated .custom-file-input:valid ~ .custom-file-label::after,.custom-file-input.is-valid ~ .custom-file-label::after{border-color:inherit}.was-validated .custom-file-input:valid ~ .valid-feedback,.was-validated .custom-file-input:valid ~ .valid-tooltip,.custom-file-input.is-valid ~ .valid-feedback,.custom-file-input.is-valid ~ .valid-tooltip{display:block}.was-validated .custom-file-input:valid:focus ~ .custom-file-label,.custom-file-input.is-valid:focus ~ .custom-file-label{-webkit-box-shadow:0 0 0 0.2rem rgba(115,168,57,0.25);box-shadow:0 0 0 0.2rem rgba(115,168,57,0.25)}.invalid-feedback{display:none;width:100%;margin-top:0.25rem;font-size:80%;color:#C71C22}.invalid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:0.25rem 0.5rem;margin-top:.1rem;font-size:0.875rem;line-height:1.5;color:#fff;background-color:rgba(199,28,34,0.9);border-radius:0.25rem}.was-validated .form-control:invalid,.form-control.is-invalid,.was-validated .custom-select:invalid,.custom-select.is-invalid{border-color:#C71C22}.was-validated .form-control:invalid:focus,.form-control.is-invalid:focus,.was-validated .custom-select:invalid:focus,.custom-select.is-invalid:focus{border-color:#C71C22;-webkit-box-shadow:0 0 0 0.2rem rgba(199,28,34,0.25);box-shadow:0 0 0 0.2rem rgba(199,28,34,0.25)}.was-validated .form-control:invalid ~ .invalid-feedback,.was-validated .form-control:invalid ~ .invalid-tooltip,.form-control.is-invalid ~ .invalid-feedback,.form-control.is-invalid ~ .invalid-tooltip,.was-validated .custom-select:invalid ~ .invalid-feedback,.was-validated .custom-select:invalid ~ .invalid-tooltip,.custom-select.is-invalid ~ .invalid-feedback,.custom-select.is-invalid ~ .invalid-tooltip{display:block}.was-validated .form-control-file:invalid ~ .invalid-feedback,.was-validated .form-control-file:invalid ~ .invalid-tooltip,.form-control-file.is-invalid ~ .invalid-feedback,.form-control-file.is-invalid ~ .invalid-tooltip{display:block}.was-validated .form-check-input:invalid ~ .form-check-label,.form-check-input.is-invalid ~ .form-check-label{color:#C71C22}.was-validated .form-check-input:invalid ~ .invalid-feedback,.was-validated .form-check-input:invalid ~ .invalid-tooltip,.form-check-input.is-invalid ~ .invalid-feedback,.form-check-input.is-invalid ~ .invalid-tooltip{display:block}.was-validated .custom-control-input:invalid ~ .custom-control-label,.custom-control-input.is-invalid ~ .custom-control-label{color:#C71C22}.was-validated .custom-control-input:invalid ~ .custom-control-label::before,.custom-control-input.is-invalid ~ .custom-control-label::before{background-color:#ec777b}.was-validated .custom-control-input:invalid ~ .invalid-feedback,.was-validated .custom-control-input:invalid ~ .invalid-tooltip,.custom-control-input.is-invalid ~ .invalid-feedback,.custom-control-input.is-invalid ~ .invalid-tooltip{display:block}.was-validated .custom-control-input:invalid:checked ~ .custom-control-label::before,.custom-control-input.is-invalid:checked ~ .custom-control-label::before{background-color:#e2343a}.was-validated .custom-control-input:invalid:focus ~ .custom-control-label::before,.custom-control-input.is-invalid:focus ~ .custom-control-label::before{-webkit-box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(199,28,34,0.25);box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(199,28,34,0.25)}.was-validated .custom-file-input:invalid ~ .custom-file-label,.custom-file-input.is-invalid ~ .custom-file-label{border-color:#C71C22}.was-validated .custom-file-input:invalid ~ .custom-file-label::after,.custom-file-input.is-invalid ~ .custom-file-label::after{border-color:inherit}.was-validated .custom-file-input:invalid ~ .invalid-feedback,.was-validated .custom-file-input:invalid ~ .invalid-tooltip,.custom-file-input.is-invalid ~ .invalid-feedback,.custom-file-input.is-invalid ~ .invalid-tooltip{display:block}.was-validated .custom-file-input:invalid:focus ~ .custom-file-label,.custom-file-input.is-invalid:focus ~ .custom-file-label{-webkit-box-shadow:0 0 0 0.2rem rgba(199,28,34,0.25);box-shadow:0 0 0 0.2rem rgba(199,28,34,0.25)}.form-inline{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row wrap;flex-flow:row wrap;-webkit-box-align:center;-ms-flex-align:center;align-items:center}.form-inline .form-check{width:100%}@media (min-width: 576px){.form-inline label{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;margin-bottom:0}.form-inline .form-group{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row wrap;flex-flow:row wrap;-webkit-box-align:center;-ms-flex-align:center;align-items:center;margin-bottom:0}.form-inline .form-control{display:inline-block;width:auto;vertical-align:middle}.form-inline .form-control-plaintext{display:inline-block}.form-inline .input-group,.form-inline .custom-select{width:auto}.form-inline .form-check{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;width:auto;padding-left:0}.form-inline .form-check-input{position:relative;margin-top:0;margin-right:0.25rem;margin-left:0}.form-inline .custom-control{-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center}.form-inline .custom-control-label{margin-bottom:0}}.btn{display:inline-block;font-weight:400;text-align:center;white-space:nowrap;vertical-align:middle;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;border:1px solid transparent;padding:0.375rem 0.75rem;font-size:1rem;line-height:1.5;border-radius:0.25rem;-webkit-transition:color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;transition:color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out}@media screen and (prefers-reduced-motion: reduce){.btn{-webkit-transition:none;transition:none}}.btn:hover,.btn:focus{text-decoration:none}.btn:focus,.btn.focus{outline:0;-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25)}.btn.disabled,.btn:disabled{opacity:0.65}.btn:not(:disabled):not(.disabled){cursor:pointer}a.btn.disabled,fieldset:disabled a.btn{pointer-events:none}.btn-primary{color:#fff;background-color:#2FA4E7;border-color:#2FA4E7}.btn-primary:hover{color:#fff;background-color:#1992d7;border-color:#178acc}.btn-primary:focus,.btn-primary.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5)}.btn-primary.disabled,.btn-primary:disabled{color:#fff;background-color:#2FA4E7;border-color:#2FA4E7}.btn-primary:not(:disabled):not(.disabled):active,.btn-primary:not(:disabled):not(.disabled).active,.show>.btn-primary.dropdown-toggle{color:#fff;background-color:#178acc;border-color:#1682c0}.btn-primary:not(:disabled):not(.disabled):active:focus,.btn-primary:not(:disabled):not(.disabled).active:focus,.show>.btn-primary.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5)}.btn-secondary{color:#212529;background-color:#e9ecef;border-color:#e9ecef}.btn-secondary:hover{color:#212529;background-color:#d3d9df;border-color:#cbd3da}.btn-secondary:focus,.btn-secondary.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5);box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5)}.btn-secondary.disabled,.btn-secondary:disabled{color:#212529;background-color:#e9ecef;border-color:#e9ecef}.btn-secondary:not(:disabled):not(.disabled):active,.btn-secondary:not(:disabled):not(.disabled).active,.show>.btn-secondary.dropdown-toggle{color:#212529;background-color:#cbd3da;border-color:#c4ccd4}.btn-secondary:not(:disabled):not(.disabled):active:focus,.btn-secondary:not(:disabled):not(.disabled).active:focus,.show>.btn-secondary.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5);box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5)}.btn-success{color:#fff;background-color:#73A839;border-color:#73A839}.btn-success:hover{color:#fff;background-color:#5f8b2f;border-color:#59822c}.btn-success:focus,.btn-success.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5);box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5)}.btn-success.disabled,.btn-success:disabled{color:#fff;background-color:#73A839;border-color:#73A839}.btn-success:not(:disabled):not(.disabled):active,.btn-success:not(:disabled):not(.disabled).active,.show>.btn-success.dropdown-toggle{color:#fff;background-color:#59822c;border-color:#527829}.btn-success:not(:disabled):not(.disabled):active:focus,.btn-success:not(:disabled):not(.disabled).active:focus,.show>.btn-success.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5);box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5)}.btn-info{color:#fff;background-color:#033C73;border-color:#033C73}.btn-info:hover{color:#fff;background-color:#02294e;border-color:#022241}.btn-info:focus,.btn-info.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5);box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5)}.btn-info.disabled,.btn-info:disabled{color:#fff;background-color:#033C73;border-color:#033C73}.btn-info:not(:disabled):not(.disabled):active,.btn-info:not(:disabled):not(.disabled).active,.show>.btn-info.dropdown-toggle{color:#fff;background-color:#022241;border-color:#011c35}.btn-info:not(:disabled):not(.disabled):active:focus,.btn-info:not(:disabled):not(.disabled).active:focus,.show>.btn-info.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5);box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5)}.btn-warning{color:#fff;background-color:#DD5600;border-color:#DD5600}.btn-warning:hover{color:#fff;background-color:#b74700;border-color:#aa4200}.btn-warning:focus,.btn-warning.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5);box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5)}.btn-warning.disabled,.btn-warning:disabled{color:#fff;background-color:#DD5600;border-color:#DD5600}.btn-warning:not(:disabled):not(.disabled):active,.btn-warning:not(:disabled):not(.disabled).active,.show>.btn-warning.dropdown-toggle{color:#fff;background-color:#aa4200;border-color:#9d3d00}.btn-warning:not(:disabled):not(.disabled):active:focus,.btn-warning:not(:disabled):not(.disabled).active:focus,.show>.btn-warning.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5);box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5)}.btn-danger{color:#fff;background-color:#C71C22;border-color:#C71C22}.btn-danger:hover{color:#fff;background-color:#a5171c;border-color:#9a161a}.btn-danger:focus,.btn-danger.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5);box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5)}.btn-danger.disabled,.btn-danger:disabled{color:#fff;background-color:#C71C22;border-color:#C71C22}.btn-danger:not(:disabled):not(.disabled):active,.btn-danger:not(:disabled):not(.disabled).active,.show>.btn-danger.dropdown-toggle{color:#fff;background-color:#9a161a;border-color:#8f1418}.btn-danger:not(:disabled):not(.disabled):active:focus,.btn-danger:not(:disabled):not(.disabled).active:focus,.show>.btn-danger.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5);box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5)}.btn-light{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:hover{color:#212529;background-color:#e2e6ea;border-color:#dae0e5}.btn-light:focus,.btn-light.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5);box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5)}.btn-light.disabled,.btn-light:disabled{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:not(:disabled):not(.disabled):active,.btn-light:not(:disabled):not(.disabled).active,.show>.btn-light.dropdown-toggle{color:#212529;background-color:#dae0e5;border-color:#d3d9df}.btn-light:not(:disabled):not(.disabled):active:focus,.btn-light:not(:disabled):not(.disabled).active:focus,.show>.btn-light.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5);box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5)}.btn-dark{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:hover{color:#fff;background-color:#23272b;border-color:#1d2124}.btn-dark:focus,.btn-dark.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5);box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5)}.btn-dark.disabled,.btn-dark:disabled{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:not(:disabled):not(.disabled):active,.btn-dark:not(:disabled):not(.disabled).active,.show>.btn-dark.dropdown-toggle{color:#fff;background-color:#1d2124;border-color:#171a1d}.btn-dark:not(:disabled):not(.disabled):active:focus,.btn-dark:not(:disabled):not(.disabled).active:focus,.show>.btn-dark.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5);box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5)}.btn-outline-primary{color:#2FA4E7;background-color:transparent;background-image:none;border-color:#2FA4E7}.btn-outline-primary:hover{color:#fff;background-color:#2FA4E7;border-color:#2FA4E7}.btn-outline-primary:focus,.btn-outline-primary.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5)}.btn-outline-primary.disabled,.btn-outline-primary:disabled{color:#2FA4E7;background-color:transparent}.btn-outline-primary:not(:disabled):not(.disabled):active,.btn-outline-primary:not(:disabled):not(.disabled).active,.show>.btn-outline-primary.dropdown-toggle{color:#fff;background-color:#2FA4E7;border-color:#2FA4E7}.btn-outline-primary:not(:disabled):not(.disabled):active:focus,.btn-outline-primary:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-primary.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.5)}.btn-outline-secondary{color:#e9ecef;background-color:transparent;background-image:none;border-color:#e9ecef}.btn-outline-secondary:hover{color:#212529;background-color:#e9ecef;border-color:#e9ecef}.btn-outline-secondary:focus,.btn-outline-secondary.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5);box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5)}.btn-outline-secondary.disabled,.btn-outline-secondary:disabled{color:#e9ecef;background-color:transparent}.btn-outline-secondary:not(:disabled):not(.disabled):active,.btn-outline-secondary:not(:disabled):not(.disabled).active,.show>.btn-outline-secondary.dropdown-toggle{color:#212529;background-color:#e9ecef;border-color:#e9ecef}.btn-outline-secondary:not(:disabled):not(.disabled):active:focus,.btn-outline-secondary:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-secondary.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5);box-shadow:0 0 0 0.2rem rgba(233,236,239,0.5)}.btn-outline-success{color:#73A839;background-color:transparent;background-image:none;border-color:#73A839}.btn-outline-success:hover{color:#fff;background-color:#73A839;border-color:#73A839}.btn-outline-success:focus,.btn-outline-success.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5);box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5)}.btn-outline-success.disabled,.btn-outline-success:disabled{color:#73A839;background-color:transparent}.btn-outline-success:not(:disabled):not(.disabled):active,.btn-outline-success:not(:disabled):not(.disabled).active,.show>.btn-outline-success.dropdown-toggle{color:#fff;background-color:#73A839;border-color:#73A839}.btn-outline-success:not(:disabled):not(.disabled):active:focus,.btn-outline-success:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-success.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5);box-shadow:0 0 0 0.2rem rgba(115,168,57,0.5)}.btn-outline-info{color:#033C73;background-color:transparent;background-image:none;border-color:#033C73}.btn-outline-info:hover{color:#fff;background-color:#033C73;border-color:#033C73}.btn-outline-info:focus,.btn-outline-info.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5);box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5)}.btn-outline-info.disabled,.btn-outline-info:disabled{color:#033C73;background-color:transparent}.btn-outline-info:not(:disabled):not(.disabled):active,.btn-outline-info:not(:disabled):not(.disabled).active,.show>.btn-outline-info.dropdown-toggle{color:#fff;background-color:#033C73;border-color:#033C73}.btn-outline-info:not(:disabled):not(.disabled):active:focus,.btn-outline-info:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-info.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5);box-shadow:0 0 0 0.2rem rgba(3,60,115,0.5)}.btn-outline-warning{color:#DD5600;background-color:transparent;background-image:none;border-color:#DD5600}.btn-outline-warning:hover{color:#fff;background-color:#DD5600;border-color:#DD5600}.btn-outline-warning:focus,.btn-outline-warning.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5);box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5)}.btn-outline-warning.disabled,.btn-outline-warning:disabled{color:#DD5600;background-color:transparent}.btn-outline-warning:not(:disabled):not(.disabled):active,.btn-outline-warning:not(:disabled):not(.disabled).active,.show>.btn-outline-warning.dropdown-toggle{color:#fff;background-color:#DD5600;border-color:#DD5600}.btn-outline-warning:not(:disabled):not(.disabled):active:focus,.btn-outline-warning:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-warning.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5);box-shadow:0 0 0 0.2rem rgba(221,86,0,0.5)}.btn-outline-danger{color:#C71C22;background-color:transparent;background-image:none;border-color:#C71C22}.btn-outline-danger:hover{color:#fff;background-color:#C71C22;border-color:#C71C22}.btn-outline-danger:focus,.btn-outline-danger.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5);box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5)}.btn-outline-danger.disabled,.btn-outline-danger:disabled{color:#C71C22;background-color:transparent}.btn-outline-danger:not(:disabled):not(.disabled):active,.btn-outline-danger:not(:disabled):not(.disabled).active,.show>.btn-outline-danger.dropdown-toggle{color:#fff;background-color:#C71C22;border-color:#C71C22}.btn-outline-danger:not(:disabled):not(.disabled):active:focus,.btn-outline-danger:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-danger.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5);box-shadow:0 0 0 0.2rem rgba(199,28,34,0.5)}.btn-outline-light{color:#f8f9fa;background-color:transparent;background-image:none;border-color:#f8f9fa}.btn-outline-light:hover{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:focus,.btn-outline-light.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5);box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5)}.btn-outline-light.disabled,.btn-outline-light:disabled{color:#f8f9fa;background-color:transparent}.btn-outline-light:not(:disabled):not(.disabled):active,.btn-outline-light:not(:disabled):not(.disabled).active,.show>.btn-outline-light.dropdown-toggle{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:not(:disabled):not(.disabled):active:focus,.btn-outline-light:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-light.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5);box-shadow:0 0 0 0.2rem rgba(248,249,250,0.5)}.btn-outline-dark{color:#343a40;background-color:transparent;background-image:none;border-color:#343a40}.btn-outline-dark:hover{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark:focus,.btn-outline-dark.focus{-webkit-box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5);box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5)}.btn-outline-dark.disabled,.btn-outline-dark:disabled{color:#343a40;background-color:transparent}.btn-outline-dark:not(:disabled):not(.disabled):active,.btn-outline-dark:not(:disabled):not(.disabled).active,.show>.btn-outline-dark.dropdown-toggle{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark:not(:disabled):not(.disabled):active:focus,.btn-outline-dark:not(:disabled):not(.disabled).active:focus,.show>.btn-outline-dark.dropdown-toggle:focus{-webkit-box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5);box-shadow:0 0 0 0.2rem rgba(52,58,64,0.5)}.btn-link{font-weight:400;color:#2FA4E7;background-color:transparent}.btn-link:hover{color:#157ab5;text-decoration:underline;background-color:transparent;border-color:transparent}.btn-link:focus,.btn-link.focus{text-decoration:underline;border-color:transparent;-webkit-box-shadow:none;box-shadow:none}.btn-link:disabled,.btn-link.disabled{color:#868e96;pointer-events:none}.btn-lg,.btn-group-lg>.btn{padding:0.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:0.3rem}.btn-sm,.btn-group-sm>.btn{padding:0.25rem 0.5rem;font-size:0.875rem;line-height:1.5;border-radius:0.2rem}.btn-block{display:block;width:100%}.btn-block+.btn-block{margin-top:0.5rem}input[type="submit"].btn-block,input[type="reset"].btn-block,input[type="button"].btn-block{width:100%}.fade{-webkit-transition:opacity 0.15s linear;transition:opacity 0.15s linear}@media screen and (prefers-reduced-motion: reduce){.fade{-webkit-transition:none;transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.collapsing{position:relative;height:0;overflow:hidden;-webkit-transition:height 0.35s ease;transition:height 0.35s ease}@media screen and (prefers-reduced-motion: reduce){.collapsing{-webkit-transition:none;transition:none}}.dropup,.dropright,.dropdown,.dropleft{position:relative}.dropdown-toggle::after{display:inline-block;width:0;height:0;margin-left:0.255em;vertical-align:0.255em;content:"";border-top:0.3em solid;border-right:0.3em solid transparent;border-bottom:0;border-left:0.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;display:none;float:left;min-width:10rem;padding:0.5rem 0;margin:0.125rem 0 0;font-size:1rem;color:#495057;text-align:left;list-style:none;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,0.15);border-radius:0.25rem}.dropdown-menu-right{right:0;left:auto}.dropup .dropdown-menu{top:auto;bottom:100%;margin-top:0;margin-bottom:0.125rem}.dropup .dropdown-toggle::after{display:inline-block;width:0;height:0;margin-left:0.255em;vertical-align:0.255em;content:"";border-top:0;border-right:0.3em solid transparent;border-bottom:0.3em solid;border-left:0.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropright .dropdown-menu{top:0;right:auto;left:100%;margin-top:0;margin-left:0.125rem}.dropright .dropdown-toggle::after{display:inline-block;width:0;height:0;margin-left:0.255em;vertical-align:0.255em;content:"";border-top:0.3em solid transparent;border-right:0;border-bottom:0.3em solid transparent;border-left:0.3em solid}.dropright .dropdown-toggle:empty::after{margin-left:0}.dropright .dropdown-toggle::after{vertical-align:0}.dropleft .dropdown-menu{top:0;right:100%;left:auto;margin-top:0;margin-right:0.125rem}.dropleft .dropdown-toggle::after{display:inline-block;width:0;height:0;margin-left:0.255em;vertical-align:0.255em;content:""}.dropleft .dropdown-toggle::after{display:none}.dropleft .dropdown-toggle::before{display:inline-block;width:0;height:0;margin-right:0.255em;vertical-align:0.255em;content:"";border-top:0.3em solid transparent;border-right:0.3em solid;border-bottom:0.3em solid transparent}.dropleft .dropdown-toggle:empty::after{margin-left:0}.dropleft .dropdown-toggle::before{vertical-align:0}.dropdown-menu[x-placement^="top"],.dropdown-menu[x-placement^="right"],.dropdown-menu[x-placement^="bottom"],.dropdown-menu[x-placement^="left"]{right:auto;bottom:auto}.dropdown-divider{height:0;margin:0.5rem 0;overflow:hidden;border-top:1px solid #e9ecef}.dropdown-item{display:block;width:100%;padding:0.25rem 1.5rem;clear:both;font-weight:400;color:#495057;text-align:inherit;white-space:nowrap;background-color:transparent;border:0}.dropdown-item:hover,.dropdown-item:focus{color:#fff;text-decoration:none;background-color:#2FA4E7}.dropdown-item.active,.dropdown-item:active{color:#fff;text-decoration:none;background-color:#2FA4E7}.dropdown-item.disabled,.dropdown-item:disabled{color:#868e96;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:0.5rem 1.5rem;margin-bottom:0;font-size:0.875rem;color:#868e96;white-space:nowrap}.dropdown-item-text{display:block;padding:0.25rem 1.5rem;color:#495057}.btn-group,.btn-group-vertical{position:relative;display:-webkit-inline-box;display:-ms-inline-flexbox;display:inline-flex;vertical-align:middle}.btn-group>.btn,.btn-group-vertical>.btn{position:relative;-webkit-box-flex:0;-ms-flex:0 1 auto;flex:0 1 auto}.btn-group>.btn:hover,.btn-group-vertical>.btn:hover{z-index:1}.btn-group>.btn:focus,.btn-group>.btn:active,.btn-group>.btn.active,.btn-group-vertical>.btn:focus,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn.active{z-index:1}.btn-group .btn+.btn,.btn-group .btn+.btn-group,.btn-group .btn-group+.btn,.btn-group .btn-group+.btn-group,.btn-group-vertical .btn+.btn,.btn-group-vertical .btn+.btn-group,.btn-group-vertical .btn-group+.btn,.btn-group-vertical .btn-group+.btn-group{margin-left:-1px}.btn-toolbar{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start}.btn-toolbar .input-group{width:auto}.btn-group>.btn:first-child{margin-left:0}.btn-group>.btn:not(:last-child):not(.dropdown-toggle),.btn-group>.btn-group:not(:last-child)>.btn{border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn:not(:first-child),.btn-group>.btn-group:not(:first-child)>.btn{border-top-left-radius:0;border-bottom-left-radius:0}.dropdown-toggle-split{padding-right:0.5625rem;padding-left:0.5625rem}.dropdown-toggle-split::after,.dropup .dropdown-toggle-split::after,.dropright .dropdown-toggle-split::after{margin-left:0}.dropleft .dropdown-toggle-split::before{margin-right:0}.btn-sm+.dropdown-toggle-split,.btn-group-sm>.btn+.dropdown-toggle-split{padding-right:0.375rem;padding-left:0.375rem}.btn-lg+.dropdown-toggle-split,.btn-group-lg>.btn+.dropdown-toggle-split{padding-right:0.75rem;padding-left:0.75rem}.btn-group-vertical{-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center}.btn-group-vertical .btn,.btn-group-vertical .btn-group{width:100%}.btn-group-vertical>.btn+.btn,.btn-group-vertical>.btn+.btn-group,.btn-group-vertical>.btn-group+.btn,.btn-group-vertical>.btn-group+.btn-group{margin-top:-1px;margin-left:0}.btn-group-vertical>.btn:not(:last-child):not(.dropdown-toggle),.btn-group-vertical>.btn-group:not(:last-child)>.btn{border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn:not(:first-child),.btn-group-vertical>.btn-group:not(:first-child)>.btn{border-top-left-radius:0;border-top-right-radius:0}.btn-group-toggle>.btn,.btn-group-toggle>.btn-group>.btn{margin-bottom:0}.btn-group-toggle>.btn input[type="radio"],.btn-group-toggle>.btn input[type="checkbox"],.btn-group-toggle>.btn-group>.btn input[type="radio"],.btn-group-toggle>.btn-group>.btn input[type="checkbox"]{position:absolute;clip:rect(0, 0, 0, 0);pointer-events:none}.input-group{position:relative;display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;width:100%}.input-group>.form-control,.input-group>.custom-select,.input-group>.custom-file{position:relative;-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto;width:1%;margin-bottom:0}.input-group>.form-control+.form-control,.input-group>.form-control+.custom-select,.input-group>.form-control+.custom-file,.input-group>.custom-select+.form-control,.input-group>.custom-select+.custom-select,.input-group>.custom-select+.custom-file,.input-group>.custom-file+.form-control,.input-group>.custom-file+.custom-select,.input-group>.custom-file+.custom-file{margin-left:-1px}.input-group>.form-control:focus,.input-group>.custom-select:focus,.input-group>.custom-file .custom-file-input:focus ~ .custom-file-label{z-index:3}.input-group>.custom-file .custom-file-input:focus{z-index:4}.input-group>.form-control:not(:last-child),.input-group>.custom-select:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.form-control:not(:first-child),.input-group>.custom-select:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.input-group>.custom-file{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center}.input-group>.custom-file:not(:last-child) .custom-file-label,.input-group>.custom-file:not(:last-child) .custom-file-label::after{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.custom-file:not(:first-child) .custom-file-label{border-top-left-radius:0;border-bottom-left-radius:0}.input-group-prepend,.input-group-append{display:-webkit-box;display:-ms-flexbox;display:flex}.input-group-prepend .btn,.input-group-append .btn{position:relative;z-index:2}.input-group-prepend .btn+.btn,.input-group-prepend .btn+.input-group-text,.input-group-prepend .input-group-text+.input-group-text,.input-group-prepend .input-group-text+.btn,.input-group-append .btn+.btn,.input-group-append .btn+.input-group-text,.input-group-append .input-group-text+.input-group-text,.input-group-append .input-group-text+.btn{margin-left:-1px}.input-group-prepend{margin-right:-1px}.input-group-append{margin-left:-1px}.input-group-text{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;padding:0.375rem 0.75rem;margin-bottom:0;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;text-align:center;white-space:nowrap;background-color:#e9ecef;border:1px solid #ced4da;border-radius:0.25rem}.input-group-text input[type="radio"],.input-group-text input[type="checkbox"]{margin-top:0}.input-group-lg>.form-control,.input-group-lg>.input-group-prepend>.input-group-text,.input-group-lg>.input-group-append>.input-group-text,.input-group-lg>.input-group-prepend>.btn,.input-group-lg>.input-group-append>.btn{height:calc(2.875rem + 2px);padding:0.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:0.3rem}.input-group-sm>.form-control,.input-group-sm>.input-group-prepend>.input-group-text,.input-group-sm>.input-group-append>.input-group-text,.input-group-sm>.input-group-prepend>.btn,.input-group-sm>.input-group-append>.btn{height:calc(1.8125rem + 2px);padding:0.25rem 0.5rem;font-size:0.875rem;line-height:1.5;border-radius:0.2rem}.input-group>.input-group-prepend>.btn,.input-group>.input-group-prepend>.input-group-text,.input-group>.input-group-append:not(:last-child)>.btn,.input-group>.input-group-append:not(:last-child)>.input-group-text,.input-group>.input-group-append:last-child>.btn:not(:last-child):not(.dropdown-toggle),.input-group>.input-group-append:last-child>.input-group-text:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.input-group-append>.btn,.input-group>.input-group-append>.input-group-text,.input-group>.input-group-prepend:not(:first-child)>.btn,.input-group>.input-group-prepend:not(:first-child)>.input-group-text,.input-group>.input-group-prepend:first-child>.btn:not(:first-child),.input-group>.input-group-prepend:first-child>.input-group-text:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.custom-control{position:relative;display:block;min-height:1.5rem;padding-left:1.5rem}.custom-control-inline{display:-webkit-inline-box;display:-ms-inline-flexbox;display:inline-flex;margin-right:1rem}.custom-control-input{position:absolute;z-index:-1;opacity:0}.custom-control-input:checked ~ .custom-control-label::before{color:#fff;background-color:#2FA4E7}.custom-control-input:focus ~ .custom-control-label::before{-webkit-box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(47,164,231,0.25);box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(47,164,231,0.25)}.custom-control-input:active ~ .custom-control-label::before{color:#fff;background-color:#cfeaf9}.custom-control-input:disabled ~ .custom-control-label{color:#868e96}.custom-control-input:disabled ~ .custom-control-label::before{background-color:#e9ecef}.custom-control-label{position:relative;margin-bottom:0}.custom-control-label::before{position:absolute;top:0.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;pointer-events:none;content:"";-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;background-color:#dee2e6}.custom-control-label::after{position:absolute;top:0.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;content:"";background-repeat:no-repeat;background-position:center center;background-size:50% 50%}.custom-checkbox .custom-control-label::before{border-radius:0.25rem}.custom-checkbox .custom-control-input:checked ~ .custom-control-label::before{background-color:#2FA4E7}.custom-checkbox .custom-control-input:checked ~ .custom-control-label::after{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3E%3Cpath fill='%23fff' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26 2.974 7.25 8 2.193z'/%3E%3C/svg%3E")}.custom-checkbox .custom-control-input:indeterminate ~ .custom-control-label::before{background-color:#2FA4E7}.custom-checkbox .custom-control-input:indeterminate ~ .custom-control-label::after{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 4'%3E%3Cpath stroke='%23fff' d='M0 2h4'/%3E%3C/svg%3E")}.custom-checkbox .custom-control-input:disabled:checked ~ .custom-control-label::before{background-color:rgba(47,164,231,0.5)}.custom-checkbox .custom-control-input:disabled:indeterminate ~ .custom-control-label::before{background-color:rgba(47,164,231,0.5)}.custom-radio .custom-control-label::before{border-radius:50%}.custom-radio .custom-control-input:checked ~ .custom-control-label::before{background-color:#2FA4E7}.custom-radio .custom-control-input:checked ~ .custom-control-label::after{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3E%3Ccircle r='3' fill='%23fff'/%3E%3C/svg%3E")}.custom-radio .custom-control-input:disabled:checked ~ .custom-control-label::before{background-color:rgba(47,164,231,0.5)}.custom-select{display:inline-block;width:100%;height:calc(2.25rem + 2px);padding:0.375rem 1.75rem 0.375rem 0.75rem;line-height:1.5;color:#495057;vertical-align:middle;background:#fff url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3E%3Cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3E%3C/svg%3E") no-repeat right 0.75rem center;background-size:8px 10px;border:1px solid #ced4da;border-radius:0.25rem;-webkit-appearance:none;-moz-appearance:none;appearance:none}.custom-select:focus{border-color:#a1d6f4;outline:0;-webkit-box-shadow:0 0 0 0.2rem rgba(161,214,244,0.5);box-shadow:0 0 0 0.2rem rgba(161,214,244,0.5)}.custom-select:focus::-ms-value{color:#495057;background-color:#fff}.custom-select[multiple],.custom-select[size]:not([size="1"]){height:auto;padding-right:0.75rem;background-image:none}.custom-select:disabled{color:#868e96;background-color:#e9ecef}.custom-select::-ms-expand{opacity:0}.custom-select-sm{height:calc(1.8125rem + 2px);padding-top:0.375rem;padding-bottom:0.375rem;font-size:75%}.custom-select-lg{height:calc(2.875rem + 2px);padding-top:0.375rem;padding-bottom:0.375rem;font-size:125%}.custom-file{position:relative;display:inline-block;width:100%;height:calc(2.25rem + 2px);margin-bottom:0}.custom-file-input{position:relative;z-index:2;width:100%;height:calc(2.25rem + 2px);margin:0;opacity:0}.custom-file-input:focus ~ .custom-file-label{border-color:#a1d6f4;-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25)}.custom-file-input:focus ~ .custom-file-label::after{border-color:#a1d6f4}.custom-file-input:disabled ~ .custom-file-label{background-color:#e9ecef}.custom-file-input:lang(en) ~ .custom-file-label::after{content:"Browse"}.custom-file-label{position:absolute;top:0;right:0;left:0;z-index:1;height:calc(2.25rem + 2px);padding:0.375rem 0.75rem;line-height:1.5;color:#495057;background-color:#fff;border:1px solid #ced4da;border-radius:0.25rem}.custom-file-label::after{position:absolute;top:0;right:0;bottom:0;z-index:3;display:block;height:2.25rem;padding:0.375rem 0.75rem;line-height:1.5;color:#495057;content:"Browse";background-color:#e9ecef;border-left:1px solid #ced4da;border-radius:0 0.25rem 0.25rem 0}.custom-range{width:100%;padding-left:0;background-color:transparent;-webkit-appearance:none;-moz-appearance:none;appearance:none}.custom-range:focus{outline:none}.custom-range:focus::-webkit-slider-thumb{-webkit-box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(47,164,231,0.25);box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(47,164,231,0.25)}.custom-range:focus::-moz-range-thumb{box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(47,164,231,0.25)}.custom-range:focus::-ms-thumb{box-shadow:0 0 0 1px #fff,0 0 0 0.2rem rgba(47,164,231,0.25)}.custom-range::-moz-focus-outer{border:0}.custom-range::-webkit-slider-thumb{width:1rem;height:1rem;margin-top:-0.25rem;background-color:#2FA4E7;border:0;border-radius:1rem;-webkit-transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;-webkit-appearance:none;appearance:none}@media screen and (prefers-reduced-motion: reduce){.custom-range::-webkit-slider-thumb{-webkit-transition:none;transition:none}}.custom-range::-webkit-slider-thumb:active{background-color:#cfeaf9}.custom-range::-webkit-slider-runnable-track{width:100%;height:0.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-moz-range-thumb{width:1rem;height:1rem;background-color:#2FA4E7;border:0;border-radius:1rem;-webkit-transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;-moz-appearance:none;appearance:none}@media screen and (prefers-reduced-motion: reduce){.custom-range::-moz-range-thumb{-webkit-transition:none;transition:none}}.custom-range::-moz-range-thumb:active{background-color:#cfeaf9}.custom-range::-moz-range-track{width:100%;height:0.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-ms-thumb{width:1rem;height:1rem;margin-top:0;margin-right:0.2rem;margin-left:0.2rem;background-color:#2FA4E7;border:0;border-radius:1rem;-webkit-transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;appearance:none}@media screen and (prefers-reduced-motion: reduce){.custom-range::-ms-thumb{-webkit-transition:none;transition:none}}.custom-range::-ms-thumb:active{background-color:#cfeaf9}.custom-range::-ms-track{width:100%;height:0.5rem;color:transparent;cursor:pointer;background-color:transparent;border-color:transparent;border-width:0.5rem}.custom-range::-ms-fill-lower{background-color:#dee2e6;border-radius:1rem}.custom-range::-ms-fill-upper{margin-right:15px;background-color:#dee2e6;border-radius:1rem}.custom-control-label::before,.custom-file-label,.custom-select{-webkit-transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;transition:background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out}@media screen and (prefers-reduced-motion: reduce){.custom-control-label::before,.custom-file-label,.custom-select{-webkit-transition:none;transition:none}}.nav{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:0.5rem 1rem}.nav-link:hover,.nav-link:focus{text-decoration:none}.nav-link.disabled{color:#868e96}.nav-tabs{border-bottom:1px solid #dee2e6}.nav-tabs .nav-item{margin-bottom:-1px}.nav-tabs .nav-link{border:1px solid transparent;border-top-left-radius:0.25rem;border-top-right-radius:0.25rem}.nav-tabs .nav-link:hover,.nav-tabs .nav-link:focus{border-color:#e9ecef #e9ecef #dee2e6}.nav-tabs .nav-link.disabled{color:#868e96;background-color:transparent;border-color:transparent}.nav-tabs .nav-link.active,.nav-tabs .nav-item.show .nav-link{color:#495057;background-color:#fff;border-color:#dee2e6 #dee2e6 #fff}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-left-radius:0;border-top-right-radius:0}.nav-pills .nav-link{border-radius:0.25rem}.nav-pills .nav-link.active,.nav-pills .show>.nav-link{color:#fff;background-color:#2FA4E7}.nav-fill .nav-item{-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto;text-align:center}.nav-justified .nav-item{-ms-flex-preferred-size:0;flex-basis:0;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;text-align:center}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{position:relative;display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;padding:0.5rem 1rem}.navbar>.container,.navbar>.container-fluid{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.navbar-brand{display:inline-block;padding-top:0.3125rem;padding-bottom:0.3125rem;margin-right:1rem;font-size:1.25rem;line-height:inherit;white-space:nowrap}.navbar-brand:hover,.navbar-brand:focus{text-decoration:none}.navbar-nav{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link{padding-right:0;padding-left:0}.navbar-nav .dropdown-menu{position:static;float:none}.navbar-text{display:inline-block;padding-top:0.5rem;padding-bottom:0.5rem}.navbar-collapse{-ms-flex-preferred-size:100%;flex-basis:100%;-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-webkit-box-align:center;-ms-flex-align:center;align-items:center}.navbar-toggler{padding:0.25rem 0.75rem;font-size:1.25rem;line-height:1;background-color:transparent;border:1px solid transparent;border-radius:0.25rem}.navbar-toggler:hover,.navbar-toggler:focus{text-decoration:none}.navbar-toggler:not(:disabled):not(.disabled){cursor:pointer}.navbar-toggler-icon{display:inline-block;width:1.5em;height:1.5em;vertical-align:middle;content:"";background:no-repeat center center;background-size:100% 100%}@media (max-width: 575.98px){.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid{padding-right:0;padding-left:0}}@media (min-width: 576px){.navbar-expand-sm{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row nowrap;flex-flow:row nowrap;-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-sm .navbar-nav{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row}.navbar-expand-sm .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-sm .navbar-nav .nav-link{padding-right:0.5rem;padding-left:0.5rem}.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-sm .navbar-collapse{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-sm .navbar-toggler{display:none}}@media (max-width: 767.98px){.navbar-expand-md>.container,.navbar-expand-md>.container-fluid{padding-right:0;padding-left:0}}@media (min-width: 768px){.navbar-expand-md{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row nowrap;flex-flow:row nowrap;-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-md .navbar-nav{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row}.navbar-expand-md .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-md .navbar-nav .nav-link{padding-right:0.5rem;padding-left:0.5rem}.navbar-expand-md>.container,.navbar-expand-md>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-md .navbar-collapse{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-md .navbar-toggler{display:none}}@media (max-width: 991.98px){.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid{padding-right:0;padding-left:0}}@media (min-width: 992px){.navbar-expand-lg{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row nowrap;flex-flow:row nowrap;-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-lg .navbar-nav{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:0.5rem;padding-left:0.5rem}.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-lg .navbar-collapse{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-lg .navbar-toggler{display:none}}@media (max-width: 1199.98px){.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid{padding-right:0;padding-left:0}}@media (min-width: 1200px){.navbar-expand-xl{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row nowrap;flex-flow:row nowrap;-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-xl .navbar-nav{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row}.navbar-expand-xl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xl .navbar-nav .nav-link{padding-right:0.5rem;padding-left:0.5rem}.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-xl .navbar-collapse{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-xl .navbar-toggler{display:none}}.navbar-expand{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row nowrap;flex-flow:row nowrap;-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand>.container,.navbar-expand>.container-fluid{padding-right:0;padding-left:0}.navbar-expand .navbar-nav{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row}.navbar-expand .navbar-nav .dropdown-menu{position:absolute}.navbar-expand .navbar-nav .nav-link{padding-right:0.5rem;padding-left:0.5rem}.navbar-expand>.container,.navbar-expand>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand .navbar-collapse{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand .navbar-toggler{display:none}.navbar-light .navbar-brand{color:rgba(0,0,0,0.9)}.navbar-light .navbar-brand:hover,.navbar-light .navbar-brand:focus{color:rgba(0,0,0,0.9)}.navbar-light .navbar-nav .nav-link{color:rgba(0,0,0,0.5)}.navbar-light .navbar-nav .nav-link:hover,.navbar-light .navbar-nav .nav-link:focus{color:rgba(0,0,0,0.7)}.navbar-light .navbar-nav .nav-link.disabled{color:rgba(0,0,0,0.3)}.navbar-light .navbar-nav .show>.nav-link,.navbar-light .navbar-nav .active>.nav-link,.navbar-light .navbar-nav .nav-link.show,.navbar-light .navbar-nav .nav-link.active{color:rgba(0,0,0,0.9)}.navbar-light .navbar-toggler{color:rgba(0,0,0,0.5);border-color:rgba(0,0,0,0.1)}.navbar-light .navbar-toggler-icon{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath stroke='rgba(0, 0, 0, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3E%3C/svg%3E")}.navbar-light .navbar-text{color:rgba(0,0,0,0.5)}.navbar-light .navbar-text a{color:rgba(0,0,0,0.9)}.navbar-light .navbar-text a:hover,.navbar-light .navbar-text a:focus{color:rgba(0,0,0,0.9)}.navbar-dark .navbar-brand{color:#fff}.navbar-dark .navbar-brand:hover,.navbar-dark .navbar-brand:focus{color:#fff}.navbar-dark .navbar-nav .nav-link{color:rgba(255,255,255,0.8)}.navbar-dark .navbar-nav .nav-link:hover,.navbar-dark .navbar-nav .nav-link:focus{color:#fff}.navbar-dark .navbar-nav .nav-link.disabled{color:rgba(255,255,255,0.25)}.navbar-dark .navbar-nav .show>.nav-link,.navbar-dark .navbar-nav .active>.nav-link,.navbar-dark .navbar-nav .nav-link.show,.navbar-dark .navbar-nav .nav-link.active{color:#fff}.navbar-dark .navbar-toggler{color:rgba(255,255,255,0.8);border-color:rgba(255,255,255,0.1)}.navbar-dark .navbar-toggler-icon{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath stroke='rgba(255, 255, 255, 0.8)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3E%3C/svg%3E")}.navbar-dark .navbar-text{color:rgba(255,255,255,0.8)}.navbar-dark .navbar-text a{color:#fff}.navbar-dark .navbar-text a:hover,.navbar-dark .navbar-text a:focus{color:#fff}.card{position:relative;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;min-width:0;word-wrap:break-word;background-color:#fff;background-clip:border-box;border:1px solid rgba(0,0,0,0.125);border-radius:0.25rem}.card>hr{margin-right:0;margin-left:0}.card>.list-group:first-child .list-group-item:first-child{border-top-left-radius:0.25rem;border-top-right-radius:0.25rem}.card>.list-group:last-child .list-group-item:last-child{border-bottom-right-radius:0.25rem;border-bottom-left-radius:0.25rem}.card-body{-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto;padding:1.25rem}.card-title{margin-bottom:0.75rem}.card-subtitle{margin-top:-0.375rem;margin-bottom:0}.card-text:last-child{margin-bottom:0}.card-link:hover{text-decoration:none}.card-link+.card-link{margin-left:1.25rem}.card-header{padding:0.75rem 1.25rem;margin-bottom:0;background-color:rgba(0,0,0,0.03);border-bottom:1px solid rgba(0,0,0,0.125)}.card-header:first-child{border-radius:calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0}.card-header+.list-group .list-group-item:first-child{border-top:0}.card-footer{padding:0.75rem 1.25rem;background-color:rgba(0,0,0,0.03);border-top:1px solid rgba(0,0,0,0.125)}.card-footer:last-child{border-radius:0 0 calc(0.25rem - 1px) calc(0.25rem - 1px)}.card-header-tabs{margin-right:-0.625rem;margin-bottom:-0.75rem;margin-left:-0.625rem;border-bottom:0}.card-header-pills{margin-right:-0.625rem;margin-left:-0.625rem}.card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1.25rem}.card-img{width:100%;border-radius:calc(0.25rem - 1px)}.card-img-top{width:100%;border-top-left-radius:calc(0.25rem - 1px);border-top-right-radius:calc(0.25rem - 1px)}.card-img-bottom{width:100%;border-bottom-right-radius:calc(0.25rem - 1px);border-bottom-left-radius:calc(0.25rem - 1px)}.card-deck{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column}.card-deck .card{margin-bottom:15px}@media (min-width: 576px){.card-deck{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row wrap;flex-flow:row wrap;margin-right:-15px;margin-left:-15px}.card-deck .card{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:1;-ms-flex:1 0 0%;flex:1 0 0%;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;margin-right:15px;margin-bottom:0;margin-left:15px}}.card-group{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column}.card-group>.card{margin-bottom:15px}@media (min-width: 576px){.card-group{-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-flow:row wrap;flex-flow:row wrap}.card-group>.card{-webkit-box-flex:1;-ms-flex:1 0 0%;flex:1 0 0%;margin-bottom:0}.card-group>.card+.card{margin-left:0;border-left:0}.card-group>.card:first-child{border-top-right-radius:0;border-bottom-right-radius:0}.card-group>.card:first-child .card-img-top,.card-group>.card:first-child .card-header{border-top-right-radius:0}.card-group>.card:first-child .card-img-bottom,.card-group>.card:first-child .card-footer{border-bottom-right-radius:0}.card-group>.card:last-child{border-top-left-radius:0;border-bottom-left-radius:0}.card-group>.card:last-child .card-img-top,.card-group>.card:last-child .card-header{border-top-left-radius:0}.card-group>.card:last-child .card-img-bottom,.card-group>.card:last-child .card-footer{border-bottom-left-radius:0}.card-group>.card:only-child{border-radius:0.25rem}.card-group>.card:only-child .card-img-top,.card-group>.card:only-child .card-header{border-top-left-radius:0.25rem;border-top-right-radius:0.25rem}.card-group>.card:only-child .card-img-bottom,.card-group>.card:only-child .card-footer{border-bottom-right-radius:0.25rem;border-bottom-left-radius:0.25rem}.card-group>.card:not(:first-child):not(:last-child):not(:only-child){border-radius:0}.card-group>.card:not(:first-child):not(:last-child):not(:only-child) .card-img-top,.card-group>.card:not(:first-child):not(:last-child):not(:only-child) .card-img-bottom,.card-group>.card:not(:first-child):not(:last-child):not(:only-child) .card-header,.card-group>.card:not(:first-child):not(:last-child):not(:only-child) .card-footer{border-radius:0}}.card-columns .card{margin-bottom:0.75rem}@media (min-width: 576px){.card-columns{-webkit-column-count:3;column-count:3;-webkit-column-gap:1.25rem;column-gap:1.25rem;orphans:1;widows:1}.card-columns .card{display:inline-block;width:100%}}.accordion .card:not(:first-of-type):not(:last-of-type){border-bottom:0;border-radius:0}.accordion .card:not(:first-of-type) .card-header:first-child{border-radius:0}.accordion .card:first-of-type{border-bottom:0;border-bottom-right-radius:0;border-bottom-left-radius:0}.accordion .card:last-of-type{border-top-left-radius:0;border-top-right-radius:0}.breadcrumb{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;padding:0.75rem 1rem;margin-bottom:1rem;list-style:none;background-color:#e9ecef;border-radius:0.25rem}.breadcrumb-item+.breadcrumb-item{padding-left:0.5rem}.breadcrumb-item+.breadcrumb-item::before{display:inline-block;padding-right:0.5rem;color:#868e96;content:"/"}.breadcrumb-item+.breadcrumb-item:hover::before{text-decoration:underline}.breadcrumb-item+.breadcrumb-item:hover::before{text-decoration:none}.breadcrumb-item.active{color:#868e96}.pagination{display:-webkit-box;display:-ms-flexbox;display:flex;padding-left:0;list-style:none;border-radius:0.25rem}.page-link{position:relative;display:block;padding:0.5rem 0.75rem;margin-left:-1px;line-height:1.25;color:#2FA4E7;background-color:#fff;border:1px solid #dee2e6}.page-link:hover{z-index:2;color:#157ab5;text-decoration:none;background-color:#e9ecef;border-color:#dee2e6}.page-link:focus{z-index:2;outline:0;-webkit-box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25);box-shadow:0 0 0 0.2rem rgba(47,164,231,0.25)}.page-link:not(:disabled):not(.disabled){cursor:pointer}.page-item:first-child .page-link{margin-left:0;border-top-left-radius:0.25rem;border-bottom-left-radius:0.25rem}.page-item:last-child .page-link{border-top-right-radius:0.25rem;border-bottom-right-radius:0.25rem}.page-item.active .page-link{z-index:1;color:#fff;background-color:#2FA4E7;border-color:#2FA4E7}.page-item.disabled .page-link{color:#868e96;pointer-events:none;cursor:auto;background-color:#fff;border-color:#dee2e6}.pagination-lg .page-link{padding:0.75rem 1.5rem;font-size:1.25rem;line-height:1.5}.pagination-lg .page-item:first-child .page-link{border-top-left-radius:0.3rem;border-bottom-left-radius:0.3rem}.pagination-lg .page-item:last-child .page-link{border-top-right-radius:0.3rem;border-bottom-right-radius:0.3rem}.pagination-sm .page-link{padding:0.25rem 0.5rem;font-size:0.875rem;line-height:1.5}.pagination-sm .page-item:first-child .page-link{border-top-left-radius:0.2rem;border-bottom-left-radius:0.2rem}.pagination-sm .page-item:last-child .page-link{border-top-right-radius:0.2rem;border-bottom-right-radius:0.2rem}.badge{display:inline-block;padding:0.25em 0.4em;font-size:75%;font-weight:700;line-height:1;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:0.25rem}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.badge-pill{padding-right:0.6em;padding-left:0.6em;border-radius:10rem}.badge-primary{color:#fff;background-color:#2FA4E7}.badge-primary[href]:hover,.badge-primary[href]:focus{color:#fff;text-decoration:none;background-color:#178acc}.badge-secondary{color:#212529;background-color:#e9ecef}.badge-secondary[href]:hover,.badge-secondary[href]:focus{color:#212529;text-decoration:none;background-color:#cbd3da}.badge-success{color:#fff;background-color:#73A839}.badge-success[href]:hover,.badge-success[href]:focus{color:#fff;text-decoration:none;background-color:#59822c}.badge-info{color:#fff;background-color:#033C73}.badge-info[href]:hover,.badge-info[href]:focus{color:#fff;text-decoration:none;background-color:#022241}.badge-warning{color:#fff;background-color:#DD5600}.badge-warning[href]:hover,.badge-warning[href]:focus{color:#fff;text-decoration:none;background-color:#aa4200}.badge-danger{color:#fff;background-color:#C71C22}.badge-danger[href]:hover,.badge-danger[href]:focus{color:#fff;text-decoration:none;background-color:#9a161a}.badge-light{color:#212529;background-color:#f8f9fa}.badge-light[href]:hover,.badge-light[href]:focus{color:#212529;text-decoration:none;background-color:#dae0e5}.badge-dark{color:#fff;background-color:#343a40}.badge-dark[href]:hover,.badge-dark[href]:focus{color:#fff;text-decoration:none;background-color:#1d2124}.jumbotron{padding:2rem 1rem;margin-bottom:2rem;background-color:#e9ecef;border-radius:0.3rem}@media (min-width: 576px){.jumbotron{padding:4rem 2rem}}.jumbotron-fluid{padding-right:0;padding-left:0;border-radius:0}.alert{position:relative;padding:0.75rem 1.25rem;margin-bottom:1rem;border:1px solid transparent;border-radius:0.25rem}.alert-heading{color:inherit}.alert-link{font-weight:700}.alert-dismissible{padding-right:4rem}.alert-dismissible .close{position:absolute;top:0;right:0;padding:0.75rem 1.25rem;color:inherit}.alert-primary{color:#185578;background-color:#d5edfa;border-color:#c5e6f8}.alert-primary hr{border-top-color:#aedcf5}.alert-primary .alert-link{color:#10374e}.alert-secondary{color:#797b7c;background-color:#fbfbfc;border-color:#f9fafb}.alert-secondary hr{border-top-color:#eaedf1}.alert-secondary .alert-link{color:#606162}.alert-success{color:#3c571e;background-color:#e3eed7;border-color:#d8e7c8}.alert-success hr{border-top-color:#cbdfb6}.alert-success .alert-link{color:#223111}.alert-info{color:#021f3c;background-color:#cdd8e3;border-color:#b8c8d8}.alert-info hr{border-top-color:#a8bbcf}.alert-info .alert-link{color:#00060b}.alert-warning{color:#732d00;background-color:#f8ddcc;border-color:#f5d0b8}.alert-warning hr{border-top-color:#f2c1a2}.alert-warning .alert-link{color:#401900}.alert-danger{color:#670f12;background-color:#f4d2d3;border-color:#efbfc1}.alert-danger hr{border-top-color:#eaabad}.alert-danger .alert-link{color:#3a090a}.alert-light{color:#818182;background-color:#fefefe;border-color:#fdfdfe}.alert-light hr{border-top-color:#ececf6}.alert-light .alert-link{color:#686868}.alert-dark{color:#1b1e21;background-color:#d6d8d9;border-color:#c6c8ca}.alert-dark hr{border-top-color:#b9bbbe}.alert-dark .alert-link{color:#040505}@-webkit-keyframes progress-bar-stripes{from{background-position:1rem 0}to{background-position:0 0}}@keyframes progress-bar-stripes{from{background-position:1rem 0}to{background-position:0 0}}.progress{display:-webkit-box;display:-ms-flexbox;display:flex;height:1rem;overflow:hidden;font-size:0.75rem;background-color:#e9ecef;border-radius:0.25rem}.progress-bar{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;color:#fff;text-align:center;white-space:nowrap;background-color:#2FA4E7;-webkit-transition:width 0.6s ease;transition:width 0.6s ease}@media screen and (prefers-reduced-motion: reduce){.progress-bar{-webkit-transition:none;transition:none}}.progress-bar-striped{background-image:linear-gradient(45deg, rgba(255,255,255,0.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,0.15) 50%, rgba(255,255,255,0.15) 75%, transparent 75%, transparent);background-size:1rem 1rem}.progress-bar-animated{-webkit-animation:progress-bar-stripes 1s linear infinite;animation:progress-bar-stripes 1s linear infinite}.media{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.media-body{-webkit-box-flex:1;-ms-flex:1;flex:1}.list-group{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;padding-left:0;margin-bottom:0}.list-group-item-action{width:100%;color:#495057;text-align:inherit}.list-group-item-action:hover,.list-group-item-action:focus{color:#495057;text-decoration:none;background-color:#f8f9fa}.list-group-item-action:active{color:#495057;background-color:#e9ecef}.list-group-item{position:relative;display:block;padding:0.75rem 1.25rem;margin-bottom:-1px;background-color:#fff;border:1px solid rgba(0,0,0,0.125)}.list-group-item:first-child{border-top-left-radius:0.25rem;border-top-right-radius:0.25rem}.list-group-item:last-child{margin-bottom:0;border-bottom-right-radius:0.25rem;border-bottom-left-radius:0.25rem}.list-group-item:hover,.list-group-item:focus{z-index:1;text-decoration:none}.list-group-item.disabled,.list-group-item:disabled{color:#868e96;background-color:#fff}.list-group-item.active{z-index:2;color:#fff;background-color:#2FA4E7;border-color:#2FA4E7}.list-group-flush .list-group-item{border-right:0;border-left:0;border-radius:0}.list-group-flush:first-child .list-group-item:first-child{border-top:0}.list-group-flush:last-child .list-group-item:last-child{border-bottom:0}.list-group-item-primary{color:#185578;background-color:#c5e6f8}.list-group-item-primary.list-group-item-action:hover,.list-group-item-primary.list-group-item-action:focus{color:#185578;background-color:#aedcf5}.list-group-item-primary.list-group-item-action.active{color:#fff;background-color:#185578;border-color:#185578}.list-group-item-secondary{color:#797b7c;background-color:#f9fafb}.list-group-item-secondary.list-group-item-action:hover,.list-group-item-secondary.list-group-item-action:focus{color:#797b7c;background-color:#eaedf1}.list-group-item-secondary.list-group-item-action.active{color:#fff;background-color:#797b7c;border-color:#797b7c}.list-group-item-success{color:#3c571e;background-color:#d8e7c8}.list-group-item-success.list-group-item-action:hover,.list-group-item-success.list-group-item-action:focus{color:#3c571e;background-color:#cbdfb6}.list-group-item-success.list-group-item-action.active{color:#fff;background-color:#3c571e;border-color:#3c571e}.list-group-item-info{color:#021f3c;background-color:#b8c8d8}.list-group-item-info.list-group-item-action:hover,.list-group-item-info.list-group-item-action:focus{color:#021f3c;background-color:#a8bbcf}.list-group-item-info.list-group-item-action.active{color:#fff;background-color:#021f3c;border-color:#021f3c}.list-group-item-warning{color:#732d00;background-color:#f5d0b8}.list-group-item-warning.list-group-item-action:hover,.list-group-item-warning.list-group-item-action:focus{color:#732d00;background-color:#f2c1a2}.list-group-item-warning.list-group-item-action.active{color:#fff;background-color:#732d00;border-color:#732d00}.list-group-item-danger{color:#670f12;background-color:#efbfc1}.list-group-item-danger.list-group-item-action:hover,.list-group-item-danger.list-group-item-action:focus{color:#670f12;background-color:#eaabad}.list-group-item-danger.list-group-item-action.active{color:#fff;background-color:#670f12;border-color:#670f12}.list-group-item-light{color:#818182;background-color:#fdfdfe}.list-group-item-light.list-group-item-action:hover,.list-group-item-light.list-group-item-action:focus{color:#818182;background-color:#ececf6}.list-group-item-light.list-group-item-action.active{color:#fff;background-color:#818182;border-color:#818182}.list-group-item-dark{color:#1b1e21;background-color:#c6c8ca}.list-group-item-dark.list-group-item-action:hover,.list-group-item-dark.list-group-item-action:focus{color:#1b1e21;background-color:#b9bbbe}.list-group-item-dark.list-group-item-action.active{color:#fff;background-color:#1b1e21;border-color:#1b1e21}.close{float:right;font-size:1.5rem;font-weight:700;line-height:1;color:#000;text-shadow:0 1px 0 #fff;opacity:.5}.close:not(:disabled):not(.disabled){cursor:pointer}.close:not(:disabled):not(.disabled):hover,.close:not(:disabled):not(.disabled):focus{color:#000;text-decoration:none;opacity:.75}button.close{padding:0;background-color:transparent;border:0;-webkit-appearance:none}.modal-open{overflow:hidden}.modal-open .modal{overflow-x:hidden;overflow-y:auto}.modal{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1050;display:none;overflow:hidden;outline:0}.modal-dialog{position:relative;width:auto;margin:0.5rem;pointer-events:none}.modal.fade .modal-dialog{-webkit-transition:-webkit-transform 0.3s ease-out;transition:-webkit-transform 0.3s ease-out;transition:transform 0.3s ease-out;transition:transform 0.3s ease-out, -webkit-transform 0.3s ease-out;-webkit-transform:translate(0, -25%);transform:translate(0, -25%)}@media screen and (prefers-reduced-motion: reduce){.modal.fade .modal-dialog{-webkit-transition:none;transition:none}}.modal.show .modal-dialog{-webkit-transform:translate(0, 0);transform:translate(0, 0)}.modal-dialog-centered{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;min-height:calc(100% - (0.5rem * 2))}.modal-dialog-centered::before{display:block;height:calc(100vh - (0.5rem * 2));content:""}.modal-content{position:relative;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;width:100%;pointer-events:auto;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,0.2);border-radius:0.3rem;outline:0}.modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1040;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:0.5}.modal-header{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;padding:1rem;border-bottom:1px solid #e9ecef;border-top-left-radius:0.3rem;border-top-right-radius:0.3rem}.modal-header .close{padding:1rem;margin:-1rem -1rem -1rem auto}.modal-title{margin-bottom:0;line-height:1.5}.modal-body{position:relative;-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto;padding:1rem}.modal-footer{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;padding:1rem;border-top:1px solid #e9ecef}.modal-footer>:not(:first-child){margin-left:.25rem}.modal-footer>:not(:last-child){margin-right:.25rem}.modal-scrollbar-measure{position:absolute;top:-9999px;width:50px;height:50px;overflow:scroll}@media (min-width: 576px){.modal-dialog{max-width:500px;margin:1.75rem auto}.modal-dialog-centered{min-height:calc(100% - (1.75rem * 2))}.modal-dialog-centered::before{height:calc(100vh - (1.75rem * 2))}.modal-sm{max-width:300px}}@media (min-width: 992px){.modal-lg{max-width:800px}}.tooltip{position:absolute;z-index:1070;display:block;margin:0;font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:0.875rem;word-wrap:break-word;opacity:0}.tooltip.show{opacity:0.9}.tooltip .arrow{position:absolute;display:block;width:0.8rem;height:0.4rem}.tooltip .arrow::before{position:absolute;content:"";border-color:transparent;border-style:solid}.bs-tooltip-top,.bs-tooltip-auto[x-placement^="top"]{padding:0.4rem 0}.bs-tooltip-top .arrow,.bs-tooltip-auto[x-placement^="top"] .arrow{bottom:0}.bs-tooltip-top .arrow::before,.bs-tooltip-auto[x-placement^="top"] .arrow::before{top:0;border-width:0.4rem 0.4rem 0;border-top-color:#000}.bs-tooltip-right,.bs-tooltip-auto[x-placement^="right"]{padding:0 0.4rem}.bs-tooltip-right .arrow,.bs-tooltip-auto[x-placement^="right"] .arrow{left:0;width:0.4rem;height:0.8rem}.bs-tooltip-right .arrow::before,.bs-tooltip-auto[x-placement^="right"] .arrow::before{right:0;border-width:0.4rem 0.4rem 0.4rem 0;border-right-color:#000}.bs-tooltip-bottom,.bs-tooltip-auto[x-placement^="bottom"]{padding:0.4rem 0}.bs-tooltip-bottom .arrow,.bs-tooltip-auto[x-placement^="bottom"] .arrow{top:0}.bs-tooltip-bottom .arrow::before,.bs-tooltip-auto[x-placement^="bottom"] .arrow::before{bottom:0;border-width:0 0.4rem 0.4rem;border-bottom-color:#000}.bs-tooltip-left,.bs-tooltip-auto[x-placement^="left"]{padding:0 0.4rem}.bs-tooltip-left .arrow,.bs-tooltip-auto[x-placement^="left"] .arrow{right:0;width:0.4rem;height:0.8rem}.bs-tooltip-left .arrow::before,.bs-tooltip-auto[x-placement^="left"] .arrow::before{left:0;border-width:0.4rem 0 0.4rem 0.4rem;border-left-color:#000}.tooltip-inner{max-width:200px;padding:0.25rem 0.5rem;color:#fff;text-align:center;background-color:#000;border-radius:0.25rem}.popover{position:absolute;top:0;left:0;z-index:1060;display:block;max-width:276px;font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:0.875rem;word-wrap:break-word;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,0.2);border-radius:0.3rem}.popover .arrow{position:absolute;display:block;width:1rem;height:0.5rem;margin:0 0.3rem}.popover .arrow::before,.popover .arrow::after{position:absolute;display:block;content:"";border-color:transparent;border-style:solid}.bs-popover-top,.bs-popover-auto[x-placement^="top"]{margin-bottom:0.5rem}.bs-popover-top .arrow,.bs-popover-auto[x-placement^="top"] .arrow{bottom:calc((0.5rem + 1px) * -1)}.bs-popover-top .arrow::before,.bs-popover-auto[x-placement^="top"] .arrow::before,.bs-popover-top .arrow::after,.bs-popover-auto[x-placement^="top"] .arrow::after{border-width:0.5rem 0.5rem 0}.bs-popover-top .arrow::before,.bs-popover-auto[x-placement^="top"] .arrow::before{bottom:0;border-top-color:rgba(0,0,0,0.25)}.bs-popover-top .arrow::after,.bs-popover-auto[x-placement^="top"] .arrow::after{bottom:1px;border-top-color:#fff}.bs-popover-right,.bs-popover-auto[x-placement^="right"]{margin-left:0.5rem}.bs-popover-right .arrow,.bs-popover-auto[x-placement^="right"] .arrow{left:calc((0.5rem + 1px) * -1);width:0.5rem;height:1rem;margin:0.3rem 0}.bs-popover-right .arrow::before,.bs-popover-auto[x-placement^="right"] .arrow::before,.bs-popover-right .arrow::after,.bs-popover-auto[x-placement^="right"] .arrow::after{border-width:0.5rem 0.5rem 0.5rem 0}.bs-popover-right .arrow::before,.bs-popover-auto[x-placement^="right"] .arrow::before{left:0;border-right-color:rgba(0,0,0,0.25)}.bs-popover-right .arrow::after,.bs-popover-auto[x-placement^="right"] .arrow::after{left:1px;border-right-color:#fff}.bs-popover-bottom,.bs-popover-auto[x-placement^="bottom"]{margin-top:0.5rem}.bs-popover-bottom .arrow,.bs-popover-auto[x-placement^="bottom"] .arrow{top:calc((0.5rem + 1px) * -1)}.bs-popover-bottom .arrow::before,.bs-popover-auto[x-placement^="bottom"] .arrow::before,.bs-popover-bottom .arrow::after,.bs-popover-auto[x-placement^="bottom"] .arrow::after{border-width:0 0.5rem 0.5rem 0.5rem}.bs-popover-bottom .arrow::before,.bs-popover-auto[x-placement^="bottom"] .arrow::before{top:0;border-bottom-color:rgba(0,0,0,0.25)}.bs-popover-bottom .arrow::after,.bs-popover-auto[x-placement^="bottom"] .arrow::after{top:1px;border-bottom-color:#fff}.bs-popover-bottom .popover-header::before,.bs-popover-auto[x-placement^="bottom"] .popover-header::before{position:absolute;top:0;left:50%;display:block;width:1rem;margin-left:-0.5rem;content:"";border-bottom:1px solid #f7f7f7}.bs-popover-left,.bs-popover-auto[x-placement^="left"]{margin-right:0.5rem}.bs-popover-left .arrow,.bs-popover-auto[x-placement^="left"] .arrow{right:calc((0.5rem + 1px) * -1);width:0.5rem;height:1rem;margin:0.3rem 0}.bs-popover-left .arrow::before,.bs-popover-auto[x-placement^="left"] .arrow::before,.bs-popover-left .arrow::after,.bs-popover-auto[x-placement^="left"] .arrow::after{border-width:0.5rem 0 0.5rem 0.5rem}.bs-popover-left .arrow::before,.bs-popover-auto[x-placement^="left"] .arrow::before{right:0;border-left-color:rgba(0,0,0,0.25)}.bs-popover-left .arrow::after,.bs-popover-auto[x-placement^="left"] .arrow::after{right:1px;border-left-color:#fff}.popover-header{padding:0.5rem 0.75rem;margin-bottom:0;font-size:1rem;color:#2FA4E7;background-color:#f7f7f7;border-bottom:1px solid #ebebeb;border-top-left-radius:calc(0.3rem - 1px);border-top-right-radius:calc(0.3rem - 1px)}.popover-header:empty{display:none}.popover-body{padding:0.5rem 0.75rem;color:#495057}.carousel{position:relative}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-item{position:relative;display:none;-webkit-box-align:center;-ms-flex-align:center;align-items:center;width:100%;-webkit-backface-visibility:hidden;backface-visibility:hidden;-webkit-perspective:1000px;perspective:1000px}.carousel-item.active,.carousel-item-next,.carousel-item-prev{display:block;-webkit-transition:-webkit-transform 0.6s ease;transition:-webkit-transform 0.6s ease;transition:transform 0.6s ease;transition:transform 0.6s ease, -webkit-transform 0.6s ease}@media screen and (prefers-reduced-motion: reduce){.carousel-item.active,.carousel-item-next,.carousel-item-prev{-webkit-transition:none;transition:none}}.carousel-item-next,.carousel-item-prev{position:absolute;top:0}.carousel-item-next.carousel-item-left,.carousel-item-prev.carousel-item-right{-webkit-transform:translateX(0);transform:translateX(0)}@supports (-webkit-transform-style: preserve-3d) or (transform-style: preserve-3d){.carousel-item-next.carousel-item-left,.carousel-item-prev.carousel-item-right{-webkit-transform:translate3d(0, 0, 0);transform:translate3d(0, 0, 0)}}.carousel-item-next,.active.carousel-item-right{-webkit-transform:translateX(100%);transform:translateX(100%)}@supports (-webkit-transform-style: preserve-3d) or (transform-style: preserve-3d){.carousel-item-next,.active.carousel-item-right{-webkit-transform:translate3d(100%, 0, 0);transform:translate3d(100%, 0, 0)}}.carousel-item-prev,.active.carousel-item-left{-webkit-transform:translateX(-100%);transform:translateX(-100%)}@supports (-webkit-transform-style: preserve-3d) or (transform-style: preserve-3d){.carousel-item-prev,.active.carousel-item-left{-webkit-transform:translate3d(-100%, 0, 0);transform:translate3d(-100%, 0, 0)}}.carousel-fade .carousel-item{opacity:0;-webkit-transition-duration:.6s;transition-duration:.6s;-webkit-transition-property:opacity;transition-property:opacity}.carousel-fade .carousel-item.active,.carousel-fade .carousel-item-next.carousel-item-left,.carousel-fade .carousel-item-prev.carousel-item-right{opacity:1}.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{opacity:0}.carousel-fade .carousel-item-next,.carousel-fade .carousel-item-prev,.carousel-fade .carousel-item.active,.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-prev{-webkit-transform:translateX(0);transform:translateX(0)}@supports (-webkit-transform-style: preserve-3d) or (transform-style: preserve-3d){.carousel-fade .carousel-item-next,.carousel-fade .carousel-item-prev,.carousel-fade .carousel-item.active,.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-prev{-webkit-transform:translate3d(0, 0, 0);transform:translate3d(0, 0, 0)}}.carousel-control-prev,.carousel-control-next{position:absolute;top:0;bottom:0;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;width:15%;color:#fff;text-align:center;opacity:0.5}.carousel-control-prev:hover,.carousel-control-prev:focus,.carousel-control-next:hover,.carousel-control-next:focus{color:#fff;text-decoration:none;outline:0;opacity:.9}.carousel-control-prev{left:0}.carousel-control-next{right:0}.carousel-control-prev-icon,.carousel-control-next-icon{display:inline-block;width:20px;height:20px;background:transparent no-repeat center center;background-size:100% 100%}.carousel-control-prev-icon{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3E%3Cpath d='M5.25 0l-4 4 4 4 1.5-1.5-2.5-2.5 2.5-2.5-1.5-1.5z'/%3E%3C/svg%3E")}.carousel-control-next-icon{background-image:url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3E%3Cpath d='M2.75 0l-1.5 1.5 2.5 2.5-2.5 2.5 1.5 1.5 4-4-4-4z'/%3E%3C/svg%3E")}.carousel-indicators{position:absolute;right:0;bottom:10px;left:0;z-index:15;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;padding-left:0;margin-right:15%;margin-left:15%;list-style:none}.carousel-indicators li{position:relative;-webkit-box-flex:0;-ms-flex:0 1 auto;flex:0 1 auto;width:30px;height:3px;margin-right:3px;margin-left:3px;text-indent:-999px;cursor:pointer;background-color:rgba(255,255,255,0.5)}.carousel-indicators li::before{position:absolute;top:-10px;left:0;display:inline-block;width:100%;height:10px;content:""}.carousel-indicators li::after{position:absolute;bottom:-10px;left:0;display:inline-block;width:100%;height:10px;content:""}.carousel-indicators .active{background-color:#fff}.carousel-caption{position:absolute;right:15%;bottom:20px;left:15%;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center}.align-baseline{vertical-align:baseline !important}.align-top{vertical-align:top !important}.align-middle{vertical-align:middle !important}.align-bottom{vertical-align:bottom !important}.align-text-bottom{vertical-align:text-bottom !important}.align-text-top{vertical-align:text-top !important}.bg-primary{background-color:#2FA4E7 !important}a.bg-primary:hover,a.bg-primary:focus,button.bg-primary:hover,button.bg-primary:focus{background-color:#178acc !important}.bg-secondary{background-color:#e9ecef !important}a.bg-secondary:hover,a.bg-secondary:focus,button.bg-secondary:hover,button.bg-secondary:focus{background-color:#cbd3da !important}.bg-success{background-color:#73A839 !important}a.bg-success:hover,a.bg-success:focus,button.bg-success:hover,button.bg-success:focus{background-color:#59822c !important}.bg-info{background-color:#033C73 !important}a.bg-info:hover,a.bg-info:focus,button.bg-info:hover,button.bg-info:focus{background-color:#022241 !important}.bg-warning{background-color:#DD5600 !important}a.bg-warning:hover,a.bg-warning:focus,button.bg-warning:hover,button.bg-warning:focus{background-color:#aa4200 !important}.bg-danger{background-color:#C71C22 !important}a.bg-danger:hover,a.bg-danger:focus,button.bg-danger:hover,button.bg-danger:focus{background-color:#9a161a !important}.bg-light{background-color:#f8f9fa !important}a.bg-light:hover,a.bg-light:focus,button.bg-light:hover,button.bg-light:focus{background-color:#dae0e5 !important}.bg-dark{background-color:#343a40 !important}a.bg-dark:hover,a.bg-dark:focus,button.bg-dark:hover,button.bg-dark:focus{background-color:#1d2124 !important}.bg-white{background-color:#fff !important}.bg-transparent{background-color:transparent !important}.border{border:1px solid #dee2e6 !important}.border-top{border-top:1px solid #dee2e6 !important}.border-right{border-right:1px solid #dee2e6 !important}.border-bottom{border-bottom:1px solid #dee2e6 !important}.border-left{border-left:1px solid #dee2e6 !important}.border-0{border:0 !important}.border-top-0{border-top:0 !important}.border-right-0{border-right:0 !important}.border-bottom-0{border-bottom:0 !important}.border-left-0{border-left:0 !important}.border-primary{border-color:#2FA4E7 !important}.border-secondary{border-color:#e9ecef !important}.border-success{border-color:#73A839 !important}.border-info{border-color:#033C73 !important}.border-warning{border-color:#DD5600 !important}.border-danger{border-color:#C71C22 !important}.border-light{border-color:#f8f9fa !important}.border-dark{border-color:#343a40 !important}.border-white{border-color:#fff !important}.rounded{border-radius:0.25rem !important}.rounded-top{border-top-left-radius:0.25rem !important;border-top-right-radius:0.25rem !important}.rounded-right{border-top-right-radius:0.25rem !important;border-bottom-right-radius:0.25rem !important}.rounded-bottom{border-bottom-right-radius:0.25rem !important;border-bottom-left-radius:0.25rem !important}.rounded-left{border-top-left-radius:0.25rem !important;border-bottom-left-radius:0.25rem !important}.rounded-circle{border-radius:50% !important}.rounded-0{border-radius:0 !important}.clearfix::after{display:block;clear:both;content:""}.d-none{display:none !important}.d-inline{display:inline !important}.d-inline-block{display:inline-block !important}.d-block{display:block !important}.d-table{display:table !important}.d-table-row{display:table-row !important}.d-table-cell{display:table-cell !important}.d-flex{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important}.d-inline-flex{display:-webkit-inline-box !important;display:-ms-inline-flexbox !important;display:inline-flex !important}@media (min-width: 576px){.d-sm-none{display:none !important}.d-sm-inline{display:inline !important}.d-sm-inline-block{display:inline-block !important}.d-sm-block{display:block !important}.d-sm-table{display:table !important}.d-sm-table-row{display:table-row !important}.d-sm-table-cell{display:table-cell !important}.d-sm-flex{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important}.d-sm-inline-flex{display:-webkit-inline-box !important;display:-ms-inline-flexbox !important;display:inline-flex !important}}@media (min-width: 768px){.d-md-none{display:none !important}.d-md-inline{display:inline !important}.d-md-inline-block{display:inline-block !important}.d-md-block{display:block !important}.d-md-table{display:table !important}.d-md-table-row{display:table-row !important}.d-md-table-cell{display:table-cell !important}.d-md-flex{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important}.d-md-inline-flex{display:-webkit-inline-box !important;display:-ms-inline-flexbox !important;display:inline-flex !important}}@media (min-width: 992px){.d-lg-none{display:none !important}.d-lg-inline{display:inline !important}.d-lg-inline-block{display:inline-block !important}.d-lg-block{display:block !important}.d-lg-table{display:table !important}.d-lg-table-row{display:table-row !important}.d-lg-table-cell{display:table-cell !important}.d-lg-flex{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important}.d-lg-inline-flex{display:-webkit-inline-box !important;display:-ms-inline-flexbox !important;display:inline-flex !important}}@media (min-width: 1200px){.d-xl-none{display:none !important}.d-xl-inline{display:inline !important}.d-xl-inline-block{display:inline-block !important}.d-xl-block{display:block !important}.d-xl-table{display:table !important}.d-xl-table-row{display:table-row !important}.d-xl-table-cell{display:table-cell !important}.d-xl-flex{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important}.d-xl-inline-flex{display:-webkit-inline-box !important;display:-ms-inline-flexbox !important;display:inline-flex !important}}@media print{.d-print-none{display:none !important}.d-print-inline{display:inline !important}.d-print-inline-block{display:inline-block !important}.d-print-block{display:block !important}.d-print-table{display:table !important}.d-print-table-row{display:table-row !important}.d-print-table-cell{display:table-cell !important}.d-print-flex{display:-webkit-box !important;display:-ms-flexbox !important;display:flex !important}.d-print-inline-flex{display:-webkit-inline-box !important;display:-ms-inline-flexbox !important;display:inline-flex !important}}.embed-responsive{position:relative;display:block;width:100%;padding:0;overflow:hidden}.embed-responsive::before{display:block;content:""}.embed-responsive .embed-responsive-item,.embed-responsive iframe,.embed-responsive embed,.embed-responsive object,.embed-responsive video{position:absolute;top:0;bottom:0;left:0;width:100%;height:100%;border:0}.embed-responsive-21by9::before{padding-top:42.8571428571%}.embed-responsive-16by9::before{padding-top:56.25%}.embed-responsive-4by3::before{padding-top:75%}.embed-responsive-1by1::before{padding-top:100%}.flex-row{-webkit-box-orient:horizontal !important;-webkit-box-direction:normal !important;-ms-flex-direction:row !important;flex-direction:row !important}.flex-column{-webkit-box-orient:vertical !important;-webkit-box-direction:normal !important;-ms-flex-direction:column !important;flex-direction:column !important}.flex-row-reverse{-webkit-box-orient:horizontal !important;-webkit-box-direction:reverse !important;-ms-flex-direction:row-reverse !important;flex-direction:row-reverse !important}.flex-column-reverse{-webkit-box-orient:vertical !important;-webkit-box-direction:reverse !important;-ms-flex-direction:column-reverse !important;flex-direction:column-reverse !important}.flex-wrap{-ms-flex-wrap:wrap !important;flex-wrap:wrap !important}.flex-nowrap{-ms-flex-wrap:nowrap !important;flex-wrap:nowrap !important}.flex-wrap-reverse{-ms-flex-wrap:wrap-reverse !important;flex-wrap:wrap-reverse !important}.flex-fill{-webkit-box-flex:1 !important;-ms-flex:1 1 auto !important;flex:1 1 auto !important}.flex-grow-0{-webkit-box-flex:0 !important;-ms-flex-positive:0 !important;flex-grow:0 !important}.flex-grow-1{-webkit-box-flex:1 !important;-ms-flex-positive:1 !important;flex-grow:1 !important}.flex-shrink-0{-ms-flex-negative:0 !important;flex-shrink:0 !important}.flex-shrink-1{-ms-flex-negative:1 !important;flex-shrink:1 !important}.justify-content-start{-webkit-box-pack:start !important;-ms-flex-pack:start !important;justify-content:flex-start !important}.justify-content-end{-webkit-box-pack:end !important;-ms-flex-pack:end !important;justify-content:flex-end !important}.justify-content-center{-webkit-box-pack:center !important;-ms-flex-pack:center !important;justify-content:center !important}.justify-content-between{-webkit-box-pack:justify !important;-ms-flex-pack:justify !important;justify-content:space-between !important}.justify-content-around{-ms-flex-pack:distribute !important;justify-content:space-around !important}.align-items-start{-webkit-box-align:start !important;-ms-flex-align:start !important;align-items:flex-start !important}.align-items-end{-webkit-box-align:end !important;-ms-flex-align:end !important;align-items:flex-end !important}.align-items-center{-webkit-box-align:center !important;-ms-flex-align:center !important;align-items:center !important}.align-items-baseline{-webkit-box-align:baseline !important;-ms-flex-align:baseline !important;align-items:baseline !important}.align-items-stretch{-webkit-box-align:stretch !important;-ms-flex-align:stretch !important;align-items:stretch !important}.align-content-start{-ms-flex-line-pack:start !important;align-content:flex-start !important}.align-content-end{-ms-flex-line-pack:end !important;align-content:flex-end !important}.align-content-center{-ms-flex-line-pack:center !important;align-content:center !important}.align-content-between{-ms-flex-line-pack:justify !important;align-content:space-between !important}.align-content-around{-ms-flex-line-pack:distribute !important;align-content:space-around !important}.align-content-stretch{-ms-flex-line-pack:stretch !important;align-content:stretch !important}.align-self-auto{-ms-flex-item-align:auto !important;align-self:auto !important}.align-self-start{-ms-flex-item-align:start !important;align-self:flex-start !important}.align-self-end{-ms-flex-item-align:end !important;align-self:flex-end !important}.align-self-center{-ms-flex-item-align:center !important;align-self:center !important}.align-self-baseline{-ms-flex-item-align:baseline !important;align-self:baseline !important}.align-self-stretch{-ms-flex-item-align:stretch !important;align-self:stretch !important}@media (min-width: 576px){.flex-sm-row{-webkit-box-orient:horizontal !important;-webkit-box-direction:normal !important;-ms-flex-direction:row !important;flex-direction:row !important}.flex-sm-column{-webkit-box-orient:vertical !important;-webkit-box-direction:normal !important;-ms-flex-direction:column !important;flex-direction:column !important}.flex-sm-row-reverse{-webkit-box-orient:horizontal !important;-webkit-box-direction:reverse !important;-ms-flex-direction:row-reverse !important;flex-direction:row-reverse !important}.flex-sm-column-reverse{-webkit-box-orient:vertical !important;-webkit-box-direction:reverse !important;-ms-flex-direction:column-reverse !important;flex-direction:column-reverse !important}.flex-sm-wrap{-ms-flex-wrap:wrap !important;flex-wrap:wrap !important}.flex-sm-nowrap{-ms-flex-wrap:nowrap !important;flex-wrap:nowrap !important}.flex-sm-wrap-reverse{-ms-flex-wrap:wrap-reverse !important;flex-wrap:wrap-reverse !important}.flex-sm-fill{-webkit-box-flex:1 !important;-ms-flex:1 1 auto !important;flex:1 1 auto !important}.flex-sm-grow-0{-webkit-box-flex:0 !important;-ms-flex-positive:0 !important;flex-grow:0 !important}.flex-sm-grow-1{-webkit-box-flex:1 !important;-ms-flex-positive:1 !important;flex-grow:1 !important}.flex-sm-shrink-0{-ms-flex-negative:0 !important;flex-shrink:0 !important}.flex-sm-shrink-1{-ms-flex-negative:1 !important;flex-shrink:1 !important}.justify-content-sm-start{-webkit-box-pack:start !important;-ms-flex-pack:start !important;justify-content:flex-start !important}.justify-content-sm-end{-webkit-box-pack:end !important;-ms-flex-pack:end !important;justify-content:flex-end !important}.justify-content-sm-center{-webkit-box-pack:center !important;-ms-flex-pack:center !important;justify-content:center !important}.justify-content-sm-between{-webkit-box-pack:justify !important;-ms-flex-pack:justify !important;justify-content:space-between !important}.justify-content-sm-around{-ms-flex-pack:distribute !important;justify-content:space-around !important}.align-items-sm-start{-webkit-box-align:start !important;-ms-flex-align:start !important;align-items:flex-start !important}.align-items-sm-end{-webkit-box-align:end !important;-ms-flex-align:end !important;align-items:flex-end !important}.align-items-sm-center{-webkit-box-align:center !important;-ms-flex-align:center !important;align-items:center !important}.align-items-sm-baseline{-webkit-box-align:baseline !important;-ms-flex-align:baseline !important;align-items:baseline !important}.align-items-sm-stretch{-webkit-box-align:stretch !important;-ms-flex-align:stretch !important;align-items:stretch !important}.align-content-sm-start{-ms-flex-line-pack:start !important;align-content:flex-start !important}.align-content-sm-end{-ms-flex-line-pack:end !important;align-content:flex-end !important}.align-content-sm-center{-ms-flex-line-pack:center !important;align-content:center !important}.align-content-sm-between{-ms-flex-line-pack:justify !important;align-content:space-between !important}.align-content-sm-around{-ms-flex-line-pack:distribute !important;align-content:space-around !important}.align-content-sm-stretch{-ms-flex-line-pack:stretch !important;align-content:stretch !important}.align-self-sm-auto{-ms-flex-item-align:auto !important;align-self:auto !important}.align-self-sm-start{-ms-flex-item-align:start !important;align-self:flex-start !important}.align-self-sm-end{-ms-flex-item-align:end !important;align-self:flex-end !important}.align-self-sm-center{-ms-flex-item-align:center !important;align-self:center !important}.align-self-sm-baseline{-ms-flex-item-align:baseline !important;align-self:baseline !important}.align-self-sm-stretch{-ms-flex-item-align:stretch !important;align-self:stretch !important}}@media (min-width: 768px){.flex-md-row{-webkit-box-orient:horizontal !important;-webkit-box-direction:normal !important;-ms-flex-direction:row !important;flex-direction:row !important}.flex-md-column{-webkit-box-orient:vertical !important;-webkit-box-direction:normal !important;-ms-flex-direction:column !important;flex-direction:column !important}.flex-md-row-reverse{-webkit-box-orient:horizontal !important;-webkit-box-direction:reverse !important;-ms-flex-direction:row-reverse !important;flex-direction:row-reverse !important}.flex-md-column-reverse{-webkit-box-orient:vertical !important;-webkit-box-direction:reverse !important;-ms-flex-direction:column-reverse !important;flex-direction:column-reverse !important}.flex-md-wrap{-ms-flex-wrap:wrap !important;flex-wrap:wrap !important}.flex-md-nowrap{-ms-flex-wrap:nowrap !important;flex-wrap:nowrap !important}.flex-md-wrap-reverse{-ms-flex-wrap:wrap-reverse !important;flex-wrap:wrap-reverse !important}.flex-md-fill{-webkit-box-flex:1 !important;-ms-flex:1 1 auto !important;flex:1 1 auto !important}.flex-md-grow-0{-webkit-box-flex:0 !important;-ms-flex-positive:0 !important;flex-grow:0 !important}.flex-md-grow-1{-webkit-box-flex:1 !important;-ms-flex-positive:1 !important;flex-grow:1 !important}.flex-md-shrink-0{-ms-flex-negative:0 !important;flex-shrink:0 !important}.flex-md-shrink-1{-ms-flex-negative:1 !important;flex-shrink:1 !important}.justify-content-md-start{-webkit-box-pack:start !important;-ms-flex-pack:start !important;justify-content:flex-start !important}.justify-content-md-end{-webkit-box-pack:end !important;-ms-flex-pack:end !important;justify-content:flex-end !important}.justify-content-md-center{-webkit-box-pack:center !important;-ms-flex-pack:center !important;justify-content:center !important}.justify-content-md-between{-webkit-box-pack:justify !important;-ms-flex-pack:justify !important;justify-content:space-between !important}.justify-content-md-around{-ms-flex-pack:distribute !important;justify-content:space-around !important}.align-items-md-start{-webkit-box-align:start !important;-ms-flex-align:start !important;align-items:flex-start !important}.align-items-md-end{-webkit-box-align:end !important;-ms-flex-align:end !important;align-items:flex-end !important}.align-items-md-center{-webkit-box-align:center !important;-ms-flex-align:center !important;align-items:center !important}.align-items-md-baseline{-webkit-box-align:baseline !important;-ms-flex-align:baseline !important;align-items:baseline !important}.align-items-md-stretch{-webkit-box-align:stretch !important;-ms-flex-align:stretch !important;align-items:stretch !important}.align-content-md-start{-ms-flex-line-pack:start !important;align-content:flex-start !important}.align-content-md-end{-ms-flex-line-pack:end !important;align-content:flex-end !important}.align-content-md-center{-ms-flex-line-pack:center !important;align-content:center !important}.align-content-md-between{-ms-flex-line-pack:justify !important;align-content:space-between !important}.align-content-md-around{-ms-flex-line-pack:distribute !important;align-content:space-around !important}.align-content-md-stretch{-ms-flex-line-pack:stretch !important;align-content:stretch !important}.align-self-md-auto{-ms-flex-item-align:auto !important;align-self:auto !important}.align-self-md-start{-ms-flex-item-align:start !important;align-self:flex-start !important}.align-self-md-end{-ms-flex-item-align:end !important;align-self:flex-end !important}.align-self-md-center{-ms-flex-item-align:center !important;align-self:center !important}.align-self-md-baseline{-ms-flex-item-align:baseline !important;align-self:baseline !important}.align-self-md-stretch{-ms-flex-item-align:stretch !important;align-self:stretch !important}}@media (min-width: 992px){.flex-lg-row{-webkit-box-orient:horizontal !important;-webkit-box-direction:normal !important;-ms-flex-direction:row !important;flex-direction:row !important}.flex-lg-column{-webkit-box-orient:vertical !important;-webkit-box-direction:normal !important;-ms-flex-direction:column !important;flex-direction:column !important}.flex-lg-row-reverse{-webkit-box-orient:horizontal !important;-webkit-box-direction:reverse !important;-ms-flex-direction:row-reverse !important;flex-direction:row-reverse !important}.flex-lg-column-reverse{-webkit-box-orient:vertical !important;-webkit-box-direction:reverse !important;-ms-flex-direction:column-reverse !important;flex-direction:column-reverse !important}.flex-lg-wrap{-ms-flex-wrap:wrap !important;flex-wrap:wrap !important}.flex-lg-nowrap{-ms-flex-wrap:nowrap !important;flex-wrap:nowrap !important}.flex-lg-wrap-reverse{-ms-flex-wrap:wrap-reverse !important;flex-wrap:wrap-reverse !important}.flex-lg-fill{-webkit-box-flex:1 !important;-ms-flex:1 1 auto !important;flex:1 1 auto !important}.flex-lg-grow-0{-webkit-box-flex:0 !important;-ms-flex-positive:0 !important;flex-grow:0 !important}.flex-lg-grow-1{-webkit-box-flex:1 !important;-ms-flex-positive:1 !important;flex-grow:1 !important}.flex-lg-shrink-0{-ms-flex-negative:0 !important;flex-shrink:0 !important}.flex-lg-shrink-1{-ms-flex-negative:1 !important;flex-shrink:1 !important}.justify-content-lg-start{-webkit-box-pack:start !important;-ms-flex-pack:start !important;justify-content:flex-start !important}.justify-content-lg-end{-webkit-box-pack:end !important;-ms-flex-pack:end !important;justify-content:flex-end !important}.justify-content-lg-center{-webkit-box-pack:center !important;-ms-flex-pack:center !important;justify-content:center !important}.justify-content-lg-between{-webkit-box-pack:justify !important;-ms-flex-pack:justify !important;justify-content:space-between !important}.justify-content-lg-around{-ms-flex-pack:distribute !important;justify-content:space-around !important}.align-items-lg-start{-webkit-box-align:start !important;-ms-flex-align:start !important;align-items:flex-start !important}.align-items-lg-end{-webkit-box-align:end !important;-ms-flex-align:end !important;align-items:flex-end !important}.align-items-lg-center{-webkit-box-align:center !important;-ms-flex-align:center !important;align-items:center !important}.align-items-lg-baseline{-webkit-box-align:baseline !important;-ms-flex-align:baseline !important;align-items:baseline !important}.align-items-lg-stretch{-webkit-box-align:stretch !important;-ms-flex-align:stretch !important;align-items:stretch !important}.align-content-lg-start{-ms-flex-line-pack:start !important;align-content:flex-start !important}.align-content-lg-end{-ms-flex-line-pack:end !important;align-content:flex-end !important}.align-content-lg-center{-ms-flex-line-pack:center !important;align-content:center !important}.align-content-lg-between{-ms-flex-line-pack:justify !important;align-content:space-between !important}.align-content-lg-around{-ms-flex-line-pack:distribute !important;align-content:space-around !important}.align-content-lg-stretch{-ms-flex-line-pack:stretch !important;align-content:stretch !important}.align-self-lg-auto{-ms-flex-item-align:auto !important;align-self:auto !important}.align-self-lg-start{-ms-flex-item-align:start !important;align-self:flex-start !important}.align-self-lg-end{-ms-flex-item-align:end !important;align-self:flex-end !important}.align-self-lg-center{-ms-flex-item-align:center !important;align-self:center !important}.align-self-lg-baseline{-ms-flex-item-align:baseline !important;align-self:baseline !important}.align-self-lg-stretch{-ms-flex-item-align:stretch !important;align-self:stretch !important}}@media (min-width: 1200px){.flex-xl-row{-webkit-box-orient:horizontal !important;-webkit-box-direction:normal !important;-ms-flex-direction:row !important;flex-direction:row !important}.flex-xl-column{-webkit-box-orient:vertical !important;-webkit-box-direction:normal !important;-ms-flex-direction:column !important;flex-direction:column !important}.flex-xl-row-reverse{-webkit-box-orient:horizontal !important;-webkit-box-direction:reverse !important;-ms-flex-direction:row-reverse !important;flex-direction:row-reverse !important}.flex-xl-column-reverse{-webkit-box-orient:vertical !important;-webkit-box-direction:reverse !important;-ms-flex-direction:column-reverse !important;flex-direction:column-reverse !important}.flex-xl-wrap{-ms-flex-wrap:wrap !important;flex-wrap:wrap !important}.flex-xl-nowrap{-ms-flex-wrap:nowrap !important;flex-wrap:nowrap !important}.flex-xl-wrap-reverse{-ms-flex-wrap:wrap-reverse !important;flex-wrap:wrap-reverse !important}.flex-xl-fill{-webkit-box-flex:1 !important;-ms-flex:1 1 auto !important;flex:1 1 auto !important}.flex-xl-grow-0{-webkit-box-flex:0 !important;-ms-flex-positive:0 !important;flex-grow:0 !important}.flex-xl-grow-1{-webkit-box-flex:1 !important;-ms-flex-positive:1 !important;flex-grow:1 !important}.flex-xl-shrink-0{-ms-flex-negative:0 !important;flex-shrink:0 !important}.flex-xl-shrink-1{-ms-flex-negative:1 !important;flex-shrink:1 !important}.justify-content-xl-start{-webkit-box-pack:start !important;-ms-flex-pack:start !important;justify-content:flex-start !important}.justify-content-xl-end{-webkit-box-pack:end !important;-ms-flex-pack:end !important;justify-content:flex-end !important}.justify-content-xl-center{-webkit-box-pack:center !important;-ms-flex-pack:center !important;justify-content:center !important}.justify-content-xl-between{-webkit-box-pack:justify !important;-ms-flex-pack:justify !important;justify-content:space-between !important}.justify-content-xl-around{-ms-flex-pack:distribute !important;justify-content:space-around !important}.align-items-xl-start{-webkit-box-align:start !important;-ms-flex-align:start !important;align-items:flex-start !important}.align-items-xl-end{-webkit-box-align:end !important;-ms-flex-align:end !important;align-items:flex-end !important}.align-items-xl-center{-webkit-box-align:center !important;-ms-flex-align:center !important;align-items:center !important}.align-items-xl-baseline{-webkit-box-align:baseline !important;-ms-flex-align:baseline !important;align-items:baseline !important}.align-items-xl-stretch{-webkit-box-align:stretch !important;-ms-flex-align:stretch !important;align-items:stretch !important}.align-content-xl-start{-ms-flex-line-pack:start !important;align-content:flex-start !important}.align-content-xl-end{-ms-flex-line-pack:end !important;align-content:flex-end !important}.align-content-xl-center{-ms-flex-line-pack:center !important;align-content:center !important}.align-content-xl-between{-ms-flex-line-pack:justify !important;align-content:space-between !important}.align-content-xl-around{-ms-flex-line-pack:distribute !important;align-content:space-around !important}.align-content-xl-stretch{-ms-flex-line-pack:stretch !important;align-content:stretch !important}.align-self-xl-auto{-ms-flex-item-align:auto !important;align-self:auto !important}.align-self-xl-start{-ms-flex-item-align:start !important;align-self:flex-start !important}.align-self-xl-end{-ms-flex-item-align:end !important;align-self:flex-end !important}.align-self-xl-center{-ms-flex-item-align:center !important;align-self:center !important}.align-self-xl-baseline{-ms-flex-item-align:baseline !important;align-self:baseline !important}.align-self-xl-stretch{-ms-flex-item-align:stretch !important;align-self:stretch !important}}.float-left{float:left !important}.float-right{float:right !important}.float-none{float:none !important}@media (min-width: 576px){.float-sm-left{float:left !important}.float-sm-right{float:right !important}.float-sm-none{float:none !important}}@media (min-width: 768px){.float-md-left{float:left !important}.float-md-right{float:right !important}.float-md-none{float:none !important}}@media (min-width: 992px){.float-lg-left{float:left !important}.float-lg-right{float:right !important}.float-lg-none{float:none !important}}@media (min-width: 1200px){.float-xl-left{float:left !important}.float-xl-right{float:right !important}.float-xl-none{float:none !important}}.position-static{position:static !important}.position-relative{position:relative !important}.position-absolute{position:absolute !important}.position-fixed{position:fixed !important}.position-sticky{position:-webkit-sticky !important;position:sticky !important}.fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030}.fixed-bottom{position:fixed;right:0;bottom:0;left:0;z-index:1030}@supports (position: -webkit-sticky) or (position: sticky){.sticky-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}.sr-only{position:absolute;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;overflow:visible;clip:auto;white-space:normal}.shadow-sm{-webkit-box-shadow:0 0.125rem 0.25rem rgba(0,0,0,0.075) !important;box-shadow:0 0.125rem 0.25rem rgba(0,0,0,0.075) !important}.shadow{-webkit-box-shadow:0 0.5rem 1rem rgba(0,0,0,0.15) !important;box-shadow:0 0.5rem 1rem rgba(0,0,0,0.15) !important}.shadow-lg{-webkit-box-shadow:0 1rem 3rem rgba(0,0,0,0.175) !important;box-shadow:0 1rem 3rem rgba(0,0,0,0.175) !important}.shadow-none{-webkit-box-shadow:none !important;box-shadow:none !important}.w-25{width:25% !important}.w-50{width:50% !important}.w-75{width:75% !important}.w-100{width:100% !important}.w-auto{width:auto !important}.h-25{height:25% !important}.h-50{height:50% !important}.h-75{height:75% !important}.h-100{height:100% !important}.h-auto{height:auto !important}.mw-100{max-width:100% !important}.mh-100{max-height:100% !important}.m-0{margin:0 !important}.mt-0,.my-0{margin-top:0 !important}.mr-0,.mx-0{margin-right:0 !important}.mb-0,.my-0{margin-bottom:0 !important}.ml-0,.mx-0{margin-left:0 !important}.m-1{margin:0.25rem !important}.mt-1,.my-1{margin-top:0.25rem !important}.mr-1,.mx-1{margin-right:0.25rem !important}.mb-1,.my-1{margin-bottom:0.25rem !important}.ml-1,.mx-1{margin-left:0.25rem !important}.m-2{margin:0.5rem !important}.mt-2,.my-2{margin-top:0.5rem !important}.mr-2,.mx-2{margin-right:0.5rem !important}.mb-2,.my-2{margin-bottom:0.5rem !important}.ml-2,.mx-2{margin-left:0.5rem !important}.m-3{margin:1rem !important}.mt-3,.my-3{margin-top:1rem !important}.mr-3,.mx-3{margin-right:1rem !important}.mb-3,.my-3{margin-bottom:1rem !important}.ml-3,.mx-3{margin-left:1rem !important}.m-4{margin:1.5rem !important}.mt-4,.my-4{margin-top:1.5rem !important}.mr-4,.mx-4{margin-right:1.5rem !important}.mb-4,.my-4{margin-bottom:1.5rem !important}.ml-4,.mx-4{margin-left:1.5rem !important}.m-5{margin:3rem !important}.mt-5,.my-5{margin-top:3rem !important}.mr-5,.mx-5{margin-right:3rem !important}.mb-5,.my-5{margin-bottom:3rem !important}.ml-5,.mx-5{margin-left:3rem !important}.p-0{padding:0 !important}.pt-0,.py-0{padding-top:0 !important}.pr-0,.px-0{padding-right:0 !important}.pb-0,.py-0{padding-bottom:0 !important}.pl-0,.px-0{padding-left:0 !important}.p-1{padding:0.25rem !important}.pt-1,.py-1{padding-top:0.25rem !important}.pr-1,.px-1{padding-right:0.25rem !important}.pb-1,.py-1{padding-bottom:0.25rem !important}.pl-1,.px-1{padding-left:0.25rem !important}.p-2{padding:0.5rem !important}.pt-2,.py-2{padding-top:0.5rem !important}.pr-2,.px-2{padding-right:0.5rem !important}.pb-2,.py-2{padding-bottom:0.5rem !important}.pl-2,.px-2{padding-left:0.5rem !important}.p-3{padding:1rem !important}.pt-3,.py-3{padding-top:1rem !important}.pr-3,.px-3{padding-right:1rem !important}.pb-3,.py-3{padding-bottom:1rem !important}.pl-3,.px-3{padding-left:1rem !important}.p-4{padding:1.5rem !important}.pt-4,.py-4{padding-top:1.5rem !important}.pr-4,.px-4{padding-right:1.5rem !important}.pb-4,.py-4{padding-bottom:1.5rem !important}.pl-4,.px-4{padding-left:1.5rem !important}.p-5{padding:3rem !important}.pt-5,.py-5{padding-top:3rem !important}.pr-5,.px-5{padding-right:3rem !important}.pb-5,.py-5{padding-bottom:3rem !important}.pl-5,.px-5{padding-left:3rem !important}.m-auto{margin:auto !important}.mt-auto,.my-auto{margin-top:auto !important}.mr-auto,.mx-auto{margin-right:auto !important}.mb-auto,.my-auto{margin-bottom:auto !important}.ml-auto,.mx-auto{margin-left:auto !important}@media (min-width: 576px){.m-sm-0{margin:0 !important}.mt-sm-0,.my-sm-0{margin-top:0 !important}.mr-sm-0,.mx-sm-0{margin-right:0 !important}.mb-sm-0,.my-sm-0{margin-bottom:0 !important}.ml-sm-0,.mx-sm-0{margin-left:0 !important}.m-sm-1{margin:0.25rem !important}.mt-sm-1,.my-sm-1{margin-top:0.25rem !important}.mr-sm-1,.mx-sm-1{margin-right:0.25rem !important}.mb-sm-1,.my-sm-1{margin-bottom:0.25rem !important}.ml-sm-1,.mx-sm-1{margin-left:0.25rem !important}.m-sm-2{margin:0.5rem !important}.mt-sm-2,.my-sm-2{margin-top:0.5rem !important}.mr-sm-2,.mx-sm-2{margin-right:0.5rem !important}.mb-sm-2,.my-sm-2{margin-bottom:0.5rem !important}.ml-sm-2,.mx-sm-2{margin-left:0.5rem !important}.m-sm-3{margin:1rem !important}.mt-sm-3,.my-sm-3{margin-top:1rem !important}.mr-sm-3,.mx-sm-3{margin-right:1rem !important}.mb-sm-3,.my-sm-3{margin-bottom:1rem !important}.ml-sm-3,.mx-sm-3{margin-left:1rem !important}.m-sm-4{margin:1.5rem !important}.mt-sm-4,.my-sm-4{margin-top:1.5rem !important}.mr-sm-4,.mx-sm-4{margin-right:1.5rem !important}.mb-sm-4,.my-sm-4{margin-bottom:1.5rem !important}.ml-sm-4,.mx-sm-4{margin-left:1.5rem !important}.m-sm-5{margin:3rem !important}.mt-sm-5,.my-sm-5{margin-top:3rem !important}.mr-sm-5,.mx-sm-5{margin-right:3rem !important}.mb-sm-5,.my-sm-5{margin-bottom:3rem !important}.ml-sm-5,.mx-sm-5{margin-left:3rem !important}.p-sm-0{padding:0 !important}.pt-sm-0,.py-sm-0{padding-top:0 !important}.pr-sm-0,.px-sm-0{padding-right:0 !important}.pb-sm-0,.py-sm-0{padding-bottom:0 !important}.pl-sm-0,.px-sm-0{padding-left:0 !important}.p-sm-1{padding:0.25rem !important}.pt-sm-1,.py-sm-1{padding-top:0.25rem !important}.pr-sm-1,.px-sm-1{padding-right:0.25rem !important}.pb-sm-1,.py-sm-1{padding-bottom:0.25rem !important}.pl-sm-1,.px-sm-1{padding-left:0.25rem !important}.p-sm-2{padding:0.5rem !important}.pt-sm-2,.py-sm-2{padding-top:0.5rem !important}.pr-sm-2,.px-sm-2{padding-right:0.5rem !important}.pb-sm-2,.py-sm-2{padding-bottom:0.5rem !important}.pl-sm-2,.px-sm-2{padding-left:0.5rem !important}.p-sm-3{padding:1rem !important}.pt-sm-3,.py-sm-3{padding-top:1rem !important}.pr-sm-3,.px-sm-3{padding-right:1rem !important}.pb-sm-3,.py-sm-3{padding-bottom:1rem !important}.pl-sm-3,.px-sm-3{padding-left:1rem !important}.p-sm-4{padding:1.5rem !important}.pt-sm-4,.py-sm-4{padding-top:1.5rem !important}.pr-sm-4,.px-sm-4{padding-right:1.5rem !important}.pb-sm-4,.py-sm-4{padding-bottom:1.5rem !important}.pl-sm-4,.px-sm-4{padding-left:1.5rem !important}.p-sm-5{padding:3rem !important}.pt-sm-5,.py-sm-5{padding-top:3rem !important}.pr-sm-5,.px-sm-5{padding-right:3rem !important}.pb-sm-5,.py-sm-5{padding-bottom:3rem !important}.pl-sm-5,.px-sm-5{padding-left:3rem !important}.m-sm-auto{margin:auto !important}.mt-sm-auto,.my-sm-auto{margin-top:auto !important}.mr-sm-auto,.mx-sm-auto{margin-right:auto !important}.mb-sm-auto,.my-sm-auto{margin-bottom:auto !important}.ml-sm-auto,.mx-sm-auto{margin-left:auto !important}}@media (min-width: 768px){.m-md-0{margin:0 !important}.mt-md-0,.my-md-0{margin-top:0 !important}.mr-md-0,.mx-md-0{margin-right:0 !important}.mb-md-0,.my-md-0{margin-bottom:0 !important}.ml-md-0,.mx-md-0{margin-left:0 !important}.m-md-1{margin:0.25rem !important}.mt-md-1,.my-md-1{margin-top:0.25rem !important}.mr-md-1,.mx-md-1{margin-right:0.25rem !important}.mb-md-1,.my-md-1{margin-bottom:0.25rem !important}.ml-md-1,.mx-md-1{margin-left:0.25rem !important}.m-md-2{margin:0.5rem !important}.mt-md-2,.my-md-2{margin-top:0.5rem !important}.mr-md-2,.mx-md-2{margin-right:0.5rem !important}.mb-md-2,.my-md-2{margin-bottom:0.5rem !important}.ml-md-2,.mx-md-2{margin-left:0.5rem !important}.m-md-3{margin:1rem !important}.mt-md-3,.my-md-3{margin-top:1rem !important}.mr-md-3,.mx-md-3{margin-right:1rem !important}.mb-md-3,.my-md-3{margin-bottom:1rem !important}.ml-md-3,.mx-md-3{margin-left:1rem !important}.m-md-4{margin:1.5rem !important}.mt-md-4,.my-md-4{margin-top:1.5rem !important}.mr-md-4,.mx-md-4{margin-right:1.5rem !important}.mb-md-4,.my-md-4{margin-bottom:1.5rem !important}.ml-md-4,.mx-md-4{margin-left:1.5rem !important}.m-md-5{margin:3rem !important}.mt-md-5,.my-md-5{margin-top:3rem !important}.mr-md-5,.mx-md-5{margin-right:3rem !important}.mb-md-5,.my-md-5{margin-bottom:3rem !important}.ml-md-5,.mx-md-5{margin-left:3rem !important}.p-md-0{padding:0 !important}.pt-md-0,.py-md-0{padding-top:0 !important}.pr-md-0,.px-md-0{padding-right:0 !important}.pb-md-0,.py-md-0{padding-bottom:0 !important}.pl-md-0,.px-md-0{padding-left:0 !important}.p-md-1{padding:0.25rem !important}.pt-md-1,.py-md-1{padding-top:0.25rem !important}.pr-md-1,.px-md-1{padding-right:0.25rem !important}.pb-md-1,.py-md-1{padding-bottom:0.25rem !important}.pl-md-1,.px-md-1{padding-left:0.25rem !important}.p-md-2{padding:0.5rem !important}.pt-md-2,.py-md-2{padding-top:0.5rem !important}.pr-md-2,.px-md-2{padding-right:0.5rem !important}.pb-md-2,.py-md-2{padding-bottom:0.5rem !important}.pl-md-2,.px-md-2{padding-left:0.5rem !important}.p-md-3{padding:1rem !important}.pt-md-3,.py-md-3{padding-top:1rem !important}.pr-md-3,.px-md-3{padding-right:1rem !important}.pb-md-3,.py-md-3{padding-bottom:1rem !important}.pl-md-3,.px-md-3{padding-left:1rem !important}.p-md-4{padding:1.5rem !important}.pt-md-4,.py-md-4{padding-top:1.5rem !important}.pr-md-4,.px-md-4{padding-right:1.5rem !important}.pb-md-4,.py-md-4{padding-bottom:1.5rem !important}.pl-md-4,.px-md-4{padding-left:1.5rem !important}.p-md-5{padding:3rem !important}.pt-md-5,.py-md-5{padding-top:3rem !important}.pr-md-5,.px-md-5{padding-right:3rem !important}.pb-md-5,.py-md-5{padding-bottom:3rem !important}.pl-md-5,.px-md-5{padding-left:3rem !important}.m-md-auto{margin:auto !important}.mt-md-auto,.my-md-auto{margin-top:auto !important}.mr-md-auto,.mx-md-auto{margin-right:auto !important}.mb-md-auto,.my-md-auto{margin-bottom:auto !important}.ml-md-auto,.mx-md-auto{margin-left:auto !important}}@media (min-width: 992px){.m-lg-0{margin:0 !important}.mt-lg-0,.my-lg-0{margin-top:0 !important}.mr-lg-0,.mx-lg-0{margin-right:0 !important}.mb-lg-0,.my-lg-0{margin-bottom:0 !important}.ml-lg-0,.mx-lg-0{margin-left:0 !important}.m-lg-1{margin:0.25rem !important}.mt-lg-1,.my-lg-1{margin-top:0.25rem !important}.mr-lg-1,.mx-lg-1{margin-right:0.25rem !important}.mb-lg-1,.my-lg-1{margin-bottom:0.25rem !important}.ml-lg-1,.mx-lg-1{margin-left:0.25rem !important}.m-lg-2{margin:0.5rem !important}.mt-lg-2,.my-lg-2{margin-top:0.5rem !important}.mr-lg-2,.mx-lg-2{margin-right:0.5rem !important}.mb-lg-2,.my-lg-2{margin-bottom:0.5rem !important}.ml-lg-2,.mx-lg-2{margin-left:0.5rem !important}.m-lg-3{margin:1rem !important}.mt-lg-3,.my-lg-3{margin-top:1rem !important}.mr-lg-3,.mx-lg-3{margin-right:1rem !important}.mb-lg-3,.my-lg-3{margin-bottom:1rem !important}.ml-lg-3,.mx-lg-3{margin-left:1rem !important}.m-lg-4{margin:1.5rem !important}.mt-lg-4,.my-lg-4{margin-top:1.5rem !important}.mr-lg-4,.mx-lg-4{margin-right:1.5rem !important}.mb-lg-4,.my-lg-4{margin-bottom:1.5rem !important}.ml-lg-4,.mx-lg-4{margin-left:1.5rem !important}.m-lg-5{margin:3rem !important}.mt-lg-5,.my-lg-5{margin-top:3rem !important}.mr-lg-5,.mx-lg-5{margin-right:3rem !important}.mb-lg-5,.my-lg-5{margin-bottom:3rem !important}.ml-lg-5,.mx-lg-5{margin-left:3rem !important}.p-lg-0{padding:0 !important}.pt-lg-0,.py-lg-0{padding-top:0 !important}.pr-lg-0,.px-lg-0{padding-right:0 !important}.pb-lg-0,.py-lg-0{padding-bottom:0 !important}.pl-lg-0,.px-lg-0{padding-left:0 !important}.p-lg-1{padding:0.25rem !important}.pt-lg-1,.py-lg-1{padding-top:0.25rem !important}.pr-lg-1,.px-lg-1{padding-right:0.25rem !important}.pb-lg-1,.py-lg-1{padding-bottom:0.25rem !important}.pl-lg-1,.px-lg-1{padding-left:0.25rem !important}.p-lg-2{padding:0.5rem !important}.pt-lg-2,.py-lg-2{padding-top:0.5rem !important}.pr-lg-2,.px-lg-2{padding-right:0.5rem !important}.pb-lg-2,.py-lg-2{padding-bottom:0.5rem !important}.pl-lg-2,.px-lg-2{padding-left:0.5rem !important}.p-lg-3{padding:1rem !important}.pt-lg-3,.py-lg-3{padding-top:1rem !important}.pr-lg-3,.px-lg-3{padding-right:1rem !important}.pb-lg-3,.py-lg-3{padding-bottom:1rem !important}.pl-lg-3,.px-lg-3{padding-left:1rem !important}.p-lg-4{padding:1.5rem !important}.pt-lg-4,.py-lg-4{padding-top:1.5rem !important}.pr-lg-4,.px-lg-4{padding-right:1.5rem !important}.pb-lg-4,.py-lg-4{padding-bottom:1.5rem !important}.pl-lg-4,.px-lg-4{padding-left:1.5rem !important}.p-lg-5{padding:3rem !important}.pt-lg-5,.py-lg-5{padding-top:3rem !important}.pr-lg-5,.px-lg-5{padding-right:3rem !important}.pb-lg-5,.py-lg-5{padding-bottom:3rem !important}.pl-lg-5,.px-lg-5{padding-left:3rem !important}.m-lg-auto{margin:auto !important}.mt-lg-auto,.my-lg-auto{margin-top:auto !important}.mr-lg-auto,.mx-lg-auto{margin-right:auto !important}.mb-lg-auto,.my-lg-auto{margin-bottom:auto !important}.ml-lg-auto,.mx-lg-auto{margin-left:auto !important}}@media (min-width: 1200px){.m-xl-0{margin:0 !important}.mt-xl-0,.my-xl-0{margin-top:0 !important}.mr-xl-0,.mx-xl-0{margin-right:0 !important}.mb-xl-0,.my-xl-0{margin-bottom:0 !important}.ml-xl-0,.mx-xl-0{margin-left:0 !important}.m-xl-1{margin:0.25rem !important}.mt-xl-1,.my-xl-1{margin-top:0.25rem !important}.mr-xl-1,.mx-xl-1{margin-right:0.25rem !important}.mb-xl-1,.my-xl-1{margin-bottom:0.25rem !important}.ml-xl-1,.mx-xl-1{margin-left:0.25rem !important}.m-xl-2{margin:0.5rem !important}.mt-xl-2,.my-xl-2{margin-top:0.5rem !important}.mr-xl-2,.mx-xl-2{margin-right:0.5rem !important}.mb-xl-2,.my-xl-2{margin-bottom:0.5rem !important}.ml-xl-2,.mx-xl-2{margin-left:0.5rem !important}.m-xl-3{margin:1rem !important}.mt-xl-3,.my-xl-3{margin-top:1rem !important}.mr-xl-3,.mx-xl-3{margin-right:1rem !important}.mb-xl-3,.my-xl-3{margin-bottom:1rem !important}.ml-xl-3,.mx-xl-3{margin-left:1rem !important}.m-xl-4{margin:1.5rem !important}.mt-xl-4,.my-xl-4{margin-top:1.5rem !important}.mr-xl-4,.mx-xl-4{margin-right:1.5rem !important}.mb-xl-4,.my-xl-4{margin-bottom:1.5rem !important}.ml-xl-4,.mx-xl-4{margin-left:1.5rem !important}.m-xl-5{margin:3rem !important}.mt-xl-5,.my-xl-5{margin-top:3rem !important}.mr-xl-5,.mx-xl-5{margin-right:3rem !important}.mb-xl-5,.my-xl-5{margin-bottom:3rem !important}.ml-xl-5,.mx-xl-5{margin-left:3rem !important}.p-xl-0{padding:0 !important}.pt-xl-0,.py-xl-0{padding-top:0 !important}.pr-xl-0,.px-xl-0{padding-right:0 !important}.pb-xl-0,.py-xl-0{padding-bottom:0 !important}.pl-xl-0,.px-xl-0{padding-left:0 !important}.p-xl-1{padding:0.25rem !important}.pt-xl-1,.py-xl-1{padding-top:0.25rem !important}.pr-xl-1,.px-xl-1{padding-right:0.25rem !important}.pb-xl-1,.py-xl-1{padding-bottom:0.25rem !important}.pl-xl-1,.px-xl-1{padding-left:0.25rem !important}.p-xl-2{padding:0.5rem !important}.pt-xl-2,.py-xl-2{padding-top:0.5rem !important}.pr-xl-2,.px-xl-2{padding-right:0.5rem !important}.pb-xl-2,.py-xl-2{padding-bottom:0.5rem !important}.pl-xl-2,.px-xl-2{padding-left:0.5rem !important}.p-xl-3{padding:1rem !important}.pt-xl-3,.py-xl-3{padding-top:1rem !important}.pr-xl-3,.px-xl-3{padding-right:1rem !important}.pb-xl-3,.py-xl-3{padding-bottom:1rem !important}.pl-xl-3,.px-xl-3{padding-left:1rem !important}.p-xl-4{padding:1.5rem !important}.pt-xl-4,.py-xl-4{padding-top:1.5rem !important}.pr-xl-4,.px-xl-4{padding-right:1.5rem !important}.pb-xl-4,.py-xl-4{padding-bottom:1.5rem !important}.pl-xl-4,.px-xl-4{padding-left:1.5rem !important}.p-xl-5{padding:3rem !important}.pt-xl-5,.py-xl-5{padding-top:3rem !important}.pr-xl-5,.px-xl-5{padding-right:3rem !important}.pb-xl-5,.py-xl-5{padding-bottom:3rem !important}.pl-xl-5,.px-xl-5{padding-left:3rem !important}.m-xl-auto{margin:auto !important}.mt-xl-auto,.my-xl-auto{margin-top:auto !important}.mr-xl-auto,.mx-xl-auto{margin-right:auto !important}.mb-xl-auto,.my-xl-auto{margin-bottom:auto !important}.ml-xl-auto,.mx-xl-auto{margin-left:auto !important}}.text-monospace{font-family:SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}.text-justify{text-align:justify !important}.text-nowrap{white-space:nowrap !important}.text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}@media (min-width: 576px){.text-sm-left{text-align:left !important}.text-sm-right{text-align:right !important}.text-sm-center{text-align:center !important}}@media (min-width: 768px){.text-md-left{text-align:left !important}.text-md-right{text-align:right !important}.text-md-center{text-align:center !important}}@media (min-width: 992px){.text-lg-left{text-align:left !important}.text-lg-right{text-align:right !important}.text-lg-center{text-align:center !important}}@media (min-width: 1200px){.text-xl-left{text-align:left !important}.text-xl-right{text-align:right !important}.text-xl-center{text-align:center !important}}.text-lowercase{text-transform:lowercase !important}.text-uppercase{text-transform:uppercase !important}.text-capitalize{text-transform:capitalize !important}.font-weight-light{font-weight:300 !important}.font-weight-normal{font-weight:400 !important}.font-weight-bold{font-weight:700 !important}.font-italic{font-style:italic !important}.text-white{color:#fff !important}.text-primary{color:#2FA4E7 !important}a.text-primary:hover,a.text-primary:focus{color:#178acc !important}.text-secondary{color:#e9ecef !important}a.text-secondary:hover,a.text-secondary:focus{color:#cbd3da !important}.text-success{color:#73A839 !important}a.text-success:hover,a.text-success:focus{color:#59822c !important}.text-info{color:#033C73 !important}a.text-info:hover,a.text-info:focus{color:#022241 !important}.text-warning{color:#DD5600 !important}a.text-warning:hover,a.text-warning:focus{color:#aa4200 !important}.text-danger{color:#C71C22 !important}a.text-danger:hover,a.text-danger:focus{color:#9a161a !important}.text-light{color:#f8f9fa !important}a.text-light:hover,a.text-light:focus{color:#dae0e5 !important}.text-dark{color:#343a40 !important}a.text-dark:hover,a.text-dark:focus{color:#1d2124 !important}.text-body{color:#495057 !important}.text-muted{color:#868e96 !important}.text-black-50{color:rgba(0,0,0,0.5) !important}.text-white-50{color:rgba(255,255,255,0.5) !important}.text-hide{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.visible{visibility:visible !important}.invisible{visibility:hidden !important}@media print{*,*::before,*::after{text-shadow:none !important;-webkit-box-shadow:none !important;box-shadow:none !important}a:not(.btn){text-decoration:underline}abbr[title]::after{content:" (" attr(title) ")"}pre{white-space:pre-wrap !important}pre,blockquote{border:1px solid #adb5bd;page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}p,h2,h3{orphans:3;widows:3}h2,h3{page-break-after:avoid}@page{size:a3}body{min-width:992px !important}.container{min-width:992px !important}.navbar{display:none}.badge{border:1px solid #000}.table{border-collapse:collapse !important}.table td,.table th{background-color:#fff !important}.table-bordered th,.table-bordered td{border:1px solid #dee2e6 !important}.table-dark{color:inherit}.table-dark th,.table-dark td,.table-dark thead th,.table-dark tbody+tbody{border-color:#dee2e6}.table .thead-dark th{color:inherit;border-color:#dee2e6}}.bg-primary{background-image:-webkit-gradient(linear, left top, left bottom, from(#54b4eb), color-stop(60%, #2FA4E7), to(#1d9ce5));background-image:linear-gradient(#54b4eb, #2FA4E7 60%, #1d9ce5);background-repeat:no-repeat}.bg-dark{background-image:-webkit-gradient(linear, left top, left bottom, from(#04519b), color-stop(60%, #033C73), to(#02325f));background-image:linear-gradient(#04519b, #033C73 60%, #02325f);background-repeat:no-repeat}.bg-light{background-image:-webkit-gradient(linear, left top, left bottom, from(white), color-stop(60%, #e9ecef), to(#e3e7eb));background-image:linear-gradient(white, #e9ecef 60%, #e3e7eb);background-repeat:no-repeat}.navbar-brand,.nav-link{text-shadow:0 1px 0 rgba(0,0,0,0.05)}.btn{text-shadow:0 1px 0 rgba(0,0,0,0.05)}.btn-primary{background-image:-webkit-gradient(linear, left top, left bottom, from(#54b4eb), color-stop(60%, #2FA4E7), to(#1d9ce5));background-image:linear-gradient(#54b4eb, #2FA4E7 60%, #1d9ce5);background-repeat:no-repeat}.btn-secondary{background-image:-webkit-gradient(linear, left top, left bottom, from(white), color-stop(60%, #e9ecef), to(#dde2e6));background-image:linear-gradient(white, #e9ecef 60%, #dde2e6);background-repeat:no-repeat;color:#495057}.btn-success{background-image:-webkit-gradient(linear, left top, left bottom, from(#88c149), color-stop(60%, #73A839), to(#699934));background-image:linear-gradient(#88c149, #73A839 60%, #699934);background-repeat:no-repeat}.btn-info{background-image:-webkit-gradient(linear, left top, left bottom, from(#04519b), color-stop(60%, #033C73), to(#02325f));background-image:linear-gradient(#04519b, #033C73 60%, #02325f);background-repeat:no-repeat}.btn-warning{background-image:-webkit-gradient(linear, left top, left bottom, from(#ff6707), color-stop(60%, #DD5600), to(#c94e00));background-image:linear-gradient(#ff6707, #DD5600 60%, #c94e00);background-repeat:no-repeat}.btn-danger{background-image:-webkit-gradient(linear, left top, left bottom, from(#e12b31), color-stop(60%, #C71C22), to(#b5191f));background-image:linear-gradient(#e12b31, #C71C22 60%, #b5191f);background-repeat:no-repeat}.btn-light{background-image:-webkit-gradient(linear, left top, left bottom, from(white), color-stop(60%, #f8f9fa), to(#eceff2));background-image:linear-gradient(white, #f8f9fa 60%, #eceff2);background-repeat:no-repeat}.btn-dark{background-image:-webkit-gradient(linear, left top, left bottom, from(#464e57), color-stop(60%, #343a40), to(#2b3035));background-image:linear-gradient(#464e57, #343a40 60%, #2b3035);background-repeat:no-repeat}.bg-primary h1,.bg-primary h2,.bg-primary h3,.bg-primary h4,.bg-primary h5,.bg-primary h6,.bg-success h1,.bg-success h2,.bg-success h3,.bg-success h4,.bg-success h5,.bg-success h6,.bg-info h1,.bg-info h2,.bg-info h3,.bg-info h4,.bg-info h5,.bg-info h6,.bg-warning h1,.bg-warning h2,.bg-warning h3,.bg-warning h4,.bg-warning h5,.bg-warning h6,.bg-danger h1,.bg-danger h2,.bg-danger h3,.bg-danger h4,.bg-danger h5,.bg-danger h6,.bg-dark h1,.bg-dark h2,.bg-dark h3,.bg-dark h4,.bg-dark h5,.bg-dark h6{color:#fff}.dropdown-menu .dropdown-header{color:#868e96}
diff --git a/docs/css/font-awesome.min.css b/docs/css/font-awesome.min.css
deleted file mode 100644
index 540440c..0000000
--- a/docs/css/font-awesome.min.css
+++ /dev/null
@@ -1,4 +0,0 @@
-/*!
- *  Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
- *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
- */@font-face{font-family:'FontAwesome';src:url('../fonts/fontawesome-webfont.eot?v=4.7.0');src:url('../fonts/fontawesome-webfont.eot?#iefix&v=4.7.0') format('embedded-opentype'),url('../fonts/fontawesome-webfont.woff2?v=4.7.0') format('woff2'),url('../fonts/fontawesome-webfont.woff?v=4.7.0') format('woff'),url('../fonts/fontawesome-webfont.ttf?v=4.7.0') format('truetype'),url('../fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular') format('svg');font-weight:normal;font-style:normal}.fa{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571429em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14285714em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14285714em;width:2.14285714em;top:.14285714em;text-align:center}.fa-li.fa-lg{left:-1.85714286em}.fa-border{padding:.2em .25em .15em;border:solid .08em #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa.fa-pull-left{margin-right:.3em}.fa.fa-pull-right{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left{margin-right:.3em}.fa.pull-right{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s infinite linear;animation:fa-spin 2s infinite linear}.fa-pulse{-webkit-animation:fa-spin 1s infinite steps(8);animation:fa-spin 1s infinite steps(8)}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scale(-1, 1);-ms-transform:scale(-1, 1);transform:scale(-1, 1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scale(1, -1);-ms-transform:scale(1, -1);transform:scale(1, -1)}:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270,:root .fa-flip-horizontal,:root .fa-flip-vertical{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:"\f000"}.fa-music:before{content:"\f001"}.fa-search:before{content:"\f002"}.fa-envelope-o:before{content:"\f003"}.fa-heart:before{content:"\f004"}.fa-star:before{content:"\f005"}.fa-star-o:before{content:"\f006"}.fa-user:before{content:"\f007"}.fa-film:before{content:"\f008"}.fa-th-large:before{content:"\f009"}.fa-th:before{content:"\f00a"}.fa-th-list:before{content:"\f00b"}.fa-check:before{content:"\f00c"}.fa-remove:before,.fa-close:before,.fa-times:before{content:"\f00d"}.fa-search-plus:before{content:"\f00e"}.fa-search-minus:before{content:"\f010"}.fa-power-off:before{content:"\f011"}.fa-signal:before{content:"\f012"}.fa-gear:before,.fa-cog:before{content:"\f013"}.fa-trash-o:before{content:"\f014"}.fa-home:before{content:"\f015"}.fa-file-o:before{content:"\f016"}.fa-clock-o:before{content:"\f017"}.fa-road:before{content:"\f018"}.fa-download:before{content:"\f019"}.fa-arrow-circle-o-down:before{content:"\f01a"}.fa-arrow-circle-o-up:before{content:"\f01b"}.fa-inbox:before{content:"\f01c"}.fa-play-circle-o:before{content:"\f01d"}.fa-rotate-right:before,.fa-repeat:before{content:"\f01e"}.fa-refresh:before{content:"\f021"}.fa-list-alt:before{content:"\f022"}.fa-lock:before{content:"\f023"}.fa-flag:before{content:"\f024"}.fa-headphones:before{content:"\f025"}.fa-volume-off:before{content:"\f026"}.fa-volume-down:before{content:"\f027"}.fa-volume-up:before{content:"\f028"}.fa-qrcode:before{content:"\f029"}.fa-barcode:before{content:"\f02a"}.fa-tag:before{content:"\f02b"}.fa-tags:before{content:"\f02c"}.fa-book:before{content:"\f02d"}.fa-bookmark:before{content:"\f02e"}.fa-print:before{content:"\f02f"}.fa-camera:before{content:"\f030"}.fa-font:before{content:"\f031"}.fa-bold:before{content:"\f032"}.fa-italic:before{content:"\f033"}.fa-text-height:before{content:"\f034"}.fa-text-width:before{content:"\f035"}.fa-align-left:before{content:"\f036"}.fa-align-center:before{content:"\f037"}.fa-align-right:before{content:"\f038"}.fa-align-justify:before{content:"\f039"}.fa-list:before{content:"\f03a"}.fa-dedent:before,.fa-outdent:before{content:"\f03b"}.fa-indent:before{content:"\f03c"}.fa-video-camera:before{content:"\f03d"}.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:"\f03e"}.fa-pencil:before{content:"\f040"}.fa-map-marker:before{content:"\f041"}.fa-adjust:before{content:"\f042"}.fa-tint:before{content:"\f043"}.fa-edit:before,.fa-pencil-square-o:before{content:"\f044"}.fa-share-square-o:before{content:"\f045"}.fa-check-square-o:before{content:"\f046"}.fa-arrows:before{content:"\f047"}.fa-step-backward:before{content:"\f048"}.fa-fast-backward:before{content:"\f049"}.fa-backward:before{content:"\f04a"}.fa-play:before{content:"\f04b"}.fa-pause:before{content:"\f04c"}.fa-stop:before{content:"\f04d"}.fa-forward:before{content:"\f04e"}.fa-fast-forward:before{content:"\f050"}.fa-step-forward:before{content:"\f051"}.fa-eject:before{content:"\f052"}.fa-chevron-left:before{content:"\f053"}.fa-chevron-right:before{content:"\f054"}.fa-plus-circle:before{content:"\f055"}.fa-minus-circle:before{content:"\f056"}.fa-times-circle:before{content:"\f057"}.fa-check-circle:before{content:"\f058"}.fa-question-circle:before{content:"\f059"}.fa-info-circle:before{content:"\f05a"}.fa-crosshairs:before{content:"\f05b"}.fa-times-circle-o:before{content:"\f05c"}.fa-check-circle-o:before{content:"\f05d"}.fa-ban:before{content:"\f05e"}.fa-arrow-left:before{content:"\f060"}.fa-arrow-right:before{content:"\f061"}.fa-arrow-up:before{content:"\f062"}.fa-arrow-down:before{content:"\f063"}.fa-mail-forward:before,.fa-share:before{content:"\f064"}.fa-expand:before{content:"\f065"}.fa-compress:before{content:"\f066"}.fa-plus:before{content:"\f067"}.fa-minus:before{content:"\f068"}.fa-asterisk:before{content:"\f069"}.fa-exclamation-circle:before{content:"\f06a"}.fa-gift:before{content:"\f06b"}.fa-leaf:before{content:"\f06c"}.fa-fire:before{content:"\f06d"}.fa-eye:before{content:"\f06e"}.fa-eye-slash:before{content:"\f070"}.fa-warning:before,.fa-exclamation-triangle:before{content:"\f071"}.fa-plane:before{content:"\f072"}.fa-calendar:before{content:"\f073"}.fa-random:before{content:"\f074"}.fa-comment:before{content:"\f075"}.fa-magnet:before{content:"\f076"}.fa-chevron-up:before{content:"\f077"}.fa-chevron-down:before{content:"\f078"}.fa-retweet:before{content:"\f079"}.fa-shopping-cart:before{content:"\f07a"}.fa-folder:before{content:"\f07b"}.fa-folder-open:before{content:"\f07c"}.fa-arrows-v:before{content:"\f07d"}.fa-arrows-h:before{content:"\f07e"}.fa-bar-chart-o:before,.fa-bar-chart:before{content:"\f080"}.fa-twitter-square:before{content:"\f081"}.fa-facebook-square:before{content:"\f082"}.fa-camera-retro:before{content:"\f083"}.fa-key:before{content:"\f084"}.fa-gears:before,.fa-cogs:before{content:"\f085"}.fa-comments:before{content:"\f086"}.fa-thumbs-o-up:before{content:"\f087"}.fa-thumbs-o-down:before{content:"\f088"}.fa-star-half:before{content:"\f089"}.fa-heart-o:before{content:"\f08a"}.fa-sign-out:before{content:"\f08b"}.fa-linkedin-square:before{content:"\f08c"}.fa-thumb-tack:before{content:"\f08d"}.fa-external-link:before{content:"\f08e"}.fa-sign-in:before{content:"\f090"}.fa-trophy:before{content:"\f091"}.fa-github-square:before{content:"\f092"}.fa-upload:before{content:"\f093"}.fa-lemon-o:before{content:"\f094"}.fa-phone:before{content:"\f095"}.fa-square-o:before{content:"\f096"}.fa-bookmark-o:before{content:"\f097"}.fa-phone-square:before{content:"\f098"}.fa-twitter:before{content:"\f099"}.fa-facebook-f:before,.fa-facebook:before{content:"\f09a"}.fa-github:before{content:"\f09b"}.fa-unlock:before{content:"\f09c"}.fa-credit-card:before{content:"\f09d"}.fa-feed:before,.fa-rss:before{content:"\f09e"}.fa-hdd-o:before{content:"\f0a0"}.fa-bullhorn:before{content:"\f0a1"}.fa-bell:before{content:"\f0f3"}.fa-certificate:before{content:"\f0a3"}.fa-hand-o-right:before{content:"\f0a4"}.fa-hand-o-left:before{content:"\f0a5"}.fa-hand-o-up:before{content:"\f0a6"}.fa-hand-o-down:before{content:"\f0a7"}.fa-arrow-circle-left:before{content:"\f0a8"}.fa-arrow-circle-right:before{content:"\f0a9"}.fa-arrow-circle-up:before{content:"\f0aa"}.fa-arrow-circle-down:before{content:"\f0ab"}.fa-globe:before{content:"\f0ac"}.fa-wrench:before{content:"\f0ad"}.fa-tasks:before{content:"\f0ae"}.fa-filter:before{content:"\f0b0"}.fa-briefcase:before{content:"\f0b1"}.fa-arrows-alt:before{content:"\f0b2"}.fa-group:before,.fa-users:before{content:"\f0c0"}.fa-chain:before,.fa-link:before{content:"\f0c1"}.fa-cloud:before{content:"\f0c2"}.fa-flask:before{content:"\f0c3"}.fa-cut:before,.fa-scissors:before{content:"\f0c4"}.fa-copy:before,.fa-files-o:before{content:"\f0c5"}.fa-paperclip:before{content:"\f0c6"}.fa-save:before,.fa-floppy-o:before{content:"\f0c7"}.fa-square:before{content:"\f0c8"}.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:"\f0c9"}.fa-list-ul:before{content:"\f0ca"}.fa-list-ol:before{content:"\f0cb"}.fa-strikethrough:before{content:"\f0cc"}.fa-underline:before{content:"\f0cd"}.fa-table:before{content:"\f0ce"}.fa-magic:before{content:"\f0d0"}.fa-truck:before{content:"\f0d1"}.fa-pinterest:before{content:"\f0d2"}.fa-pinterest-square:before{content:"\f0d3"}.fa-google-plus-square:before{content:"\f0d4"}.fa-google-plus:before{content:"\f0d5"}.fa-money:before{content:"\f0d6"}.fa-caret-down:before{content:"\f0d7"}.fa-caret-up:before{content:"\f0d8"}.fa-caret-left:before{content:"\f0d9"}.fa-caret-right:before{content:"\f0da"}.fa-columns:before{content:"\f0db"}.fa-unsorted:before,.fa-sort:before{content:"\f0dc"}.fa-sort-down:before,.fa-sort-desc:before{content:"\f0dd"}.fa-sort-up:before,.fa-sort-asc:before{content:"\f0de"}.fa-envelope:before{content:"\f0e0"}.fa-linkedin:before{content:"\f0e1"}.fa-rotate-left:before,.fa-undo:before{content:"\f0e2"}.fa-legal:before,.fa-gavel:before{content:"\f0e3"}.fa-dashboard:before,.fa-tachometer:before{content:"\f0e4"}.fa-comment-o:before{content:"\f0e5"}.fa-comments-o:before{content:"\f0e6"}.fa-flash:before,.fa-bolt:before{content:"\f0e7"}.fa-sitemap:before{content:"\f0e8"}.fa-umbrella:before{content:"\f0e9"}.fa-paste:before,.fa-clipboard:before{content:"\f0ea"}.fa-lightbulb-o:before{content:"\f0eb"}.fa-exchange:before{content:"\f0ec"}.fa-cloud-download:before{content:"\f0ed"}.fa-cloud-upload:before{content:"\f0ee"}.fa-user-md:before{content:"\f0f0"}.fa-stethoscope:before{content:"\f0f1"}.fa-suitcase:before{content:"\f0f2"}.fa-bell-o:before{content:"\f0a2"}.fa-coffee:before{content:"\f0f4"}.fa-cutlery:before{content:"\f0f5"}.fa-file-text-o:before{content:"\f0f6"}.fa-building-o:before{content:"\f0f7"}.fa-hospital-o:before{content:"\f0f8"}.fa-ambulance:before{content:"\f0f9"}.fa-medkit:before{content:"\f0fa"}.fa-fighter-jet:before{content:"\f0fb"}.fa-beer:before{content:"\f0fc"}.fa-h-square:before{content:"\f0fd"}.fa-plus-square:before{content:"\f0fe"}.fa-angle-double-left:before{content:"\f100"}.fa-angle-double-right:before{content:"\f101"}.fa-angle-double-up:before{content:"\f102"}.fa-angle-double-down:before{content:"\f103"}.fa-angle-left:before{content:"\f104"}.fa-angle-right:before{content:"\f105"}.fa-angle-up:before{content:"\f106"}.fa-angle-down:before{content:"\f107"}.fa-desktop:before{content:"\f108"}.fa-laptop:before{content:"\f109"}.fa-tablet:before{content:"\f10a"}.fa-mobile-phone:before,.fa-mobile:before{content:"\f10b"}.fa-circle-o:before{content:"\f10c"}.fa-quote-left:before{content:"\f10d"}.fa-quote-right:before{content:"\f10e"}.fa-spinner:before{content:"\f110"}.fa-circle:before{content:"\f111"}.fa-mail-reply:before,.fa-reply:before{content:"\f112"}.fa-github-alt:before{content:"\f113"}.fa-folder-o:before{content:"\f114"}.fa-folder-open-o:before{content:"\f115"}.fa-smile-o:before{content:"\f118"}.fa-frown-o:before{content:"\f119"}.fa-meh-o:before{content:"\f11a"}.fa-gamepad:before{content:"\f11b"}.fa-keyboard-o:before{content:"\f11c"}.fa-flag-o:before{content:"\f11d"}.fa-flag-checkered:before{content:"\f11e"}.fa-terminal:before{content:"\f120"}.fa-code:before{content:"\f121"}.fa-mail-reply-all:before,.fa-reply-all:before{content:"\f122"}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:"\f123"}.fa-location-arrow:before{content:"\f124"}.fa-crop:before{content:"\f125"}.fa-code-fork:before{content:"\f126"}.fa-unlink:before,.fa-chain-broken:before{content:"\f127"}.fa-question:before{content:"\f128"}.fa-info:before{content:"\f129"}.fa-exclamation:before{content:"\f12a"}.fa-superscript:before{content:"\f12b"}.fa-subscript:before{content:"\f12c"}.fa-eraser:before{content:"\f12d"}.fa-puzzle-piece:before{content:"\f12e"}.fa-microphone:before{content:"\f130"}.fa-microphone-slash:before{content:"\f131"}.fa-shield:before{content:"\f132"}.fa-calendar-o:before{content:"\f133"}.fa-fire-extinguisher:before{content:"\f134"}.fa-rocket:before{content:"\f135"}.fa-maxcdn:before{content:"\f136"}.fa-chevron-circle-left:before{content:"\f137"}.fa-chevron-circle-right:before{content:"\f138"}.fa-chevron-circle-up:before{content:"\f139"}.fa-chevron-circle-down:before{content:"\f13a"}.fa-html5:before{content:"\f13b"}.fa-css3:before{content:"\f13c"}.fa-anchor:before{content:"\f13d"}.fa-unlock-alt:before{content:"\f13e"}.fa-bullseye:before{content:"\f140"}.fa-ellipsis-h:before{content:"\f141"}.fa-ellipsis-v:before{content:"\f142"}.fa-rss-square:before{content:"\f143"}.fa-play-circle:before{content:"\f144"}.fa-ticket:before{content:"\f145"}.fa-minus-square:before{content:"\f146"}.fa-minus-square-o:before{content:"\f147"}.fa-level-up:before{content:"\f148"}.fa-level-down:before{content:"\f149"}.fa-check-square:before{content:"\f14a"}.fa-pencil-square:before{content:"\f14b"}.fa-external-link-square:before{content:"\f14c"}.fa-share-square:before{content:"\f14d"}.fa-compass:before{content:"\f14e"}.fa-toggle-down:before,.fa-caret-square-o-down:before{content:"\f150"}.fa-toggle-up:before,.fa-caret-square-o-up:before{content:"\f151"}.fa-toggle-right:before,.fa-caret-square-o-right:before{content:"\f152"}.fa-euro:before,.fa-eur:before{content:"\f153"}.fa-gbp:before{content:"\f154"}.fa-dollar:before,.fa-usd:before{content:"\f155"}.fa-rupee:before,.fa-inr:before{content:"\f156"}.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:"\f157"}.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:"\f158"}.fa-won:before,.fa-krw:before{content:"\f159"}.fa-bitcoin:before,.fa-btc:before{content:"\f15a"}.fa-file:before{content:"\f15b"}.fa-file-text:before{content:"\f15c"}.fa-sort-alpha-asc:before{content:"\f15d"}.fa-sort-alpha-desc:before{content:"\f15e"}.fa-sort-amount-asc:before{content:"\f160"}.fa-sort-amount-desc:before{content:"\f161"}.fa-sort-numeric-asc:before{content:"\f162"}.fa-sort-numeric-desc:before{content:"\f163"}.fa-thumbs-up:before{content:"\f164"}.fa-thumbs-down:before{content:"\f165"}.fa-youtube-square:before{content:"\f166"}.fa-youtube:before{content:"\f167"}.fa-xing:before{content:"\f168"}.fa-xing-square:before{content:"\f169"}.fa-youtube-play:before{content:"\f16a"}.fa-dropbox:before{content:"\f16b"}.fa-stack-overflow:before{content:"\f16c"}.fa-instagram:before{content:"\f16d"}.fa-flickr:before{content:"\f16e"}.fa-adn:before{content:"\f170"}.fa-bitbucket:before{content:"\f171"}.fa-bitbucket-square:before{content:"\f172"}.fa-tumblr:before{content:"\f173"}.fa-tumblr-square:before{content:"\f174"}.fa-long-arrow-down:before{content:"\f175"}.fa-long-arrow-up:before{content:"\f176"}.fa-long-arrow-left:before{content:"\f177"}.fa-long-arrow-right:before{content:"\f178"}.fa-apple:before{content:"\f179"}.fa-windows:before{content:"\f17a"}.fa-android:before{content:"\f17b"}.fa-linux:before{content:"\f17c"}.fa-dribbble:before{content:"\f17d"}.fa-skype:before{content:"\f17e"}.fa-foursquare:before{content:"\f180"}.fa-trello:before{content:"\f181"}.fa-female:before{content:"\f182"}.fa-male:before{content:"\f183"}.fa-gittip:before,.fa-gratipay:before{content:"\f184"}.fa-sun-o:before{content:"\f185"}.fa-moon-o:before{content:"\f186"}.fa-archive:before{content:"\f187"}.fa-bug:before{content:"\f188"}.fa-vk:before{content:"\f189"}.fa-weibo:before{content:"\f18a"}.fa-renren:before{content:"\f18b"}.fa-pagelines:before{content:"\f18c"}.fa-stack-exchange:before{content:"\f18d"}.fa-arrow-circle-o-right:before{content:"\f18e"}.fa-arrow-circle-o-left:before{content:"\f190"}.fa-toggle-left:before,.fa-caret-square-o-left:before{content:"\f191"}.fa-dot-circle-o:before{content:"\f192"}.fa-wheelchair:before{content:"\f193"}.fa-vimeo-square:before{content:"\f194"}.fa-turkish-lira:before,.fa-try:before{content:"\f195"}.fa-plus-square-o:before{content:"\f196"}.fa-space-shuttle:before{content:"\f197"}.fa-slack:before{content:"\f198"}.fa-envelope-square:before{content:"\f199"}.fa-wordpress:before{content:"\f19a"}.fa-openid:before{content:"\f19b"}.fa-institution:before,.fa-bank:before,.fa-university:before{content:"\f19c"}.fa-mortar-board:before,.fa-graduation-cap:before{content:"\f19d"}.fa-yahoo:before{content:"\f19e"}.fa-google:before{content:"\f1a0"}.fa-reddit:before{content:"\f1a1"}.fa-reddit-square:before{content:"\f1a2"}.fa-stumbleupon-circle:before{content:"\f1a3"}.fa-stumbleupon:before{content:"\f1a4"}.fa-delicious:before{content:"\f1a5"}.fa-digg:before{content:"\f1a6"}.fa-pied-piper-pp:before{content:"\f1a7"}.fa-pied-piper-alt:before{content:"\f1a8"}.fa-drupal:before{content:"\f1a9"}.fa-joomla:before{content:"\f1aa"}.fa-language:before{content:"\f1ab"}.fa-fax:before{content:"\f1ac"}.fa-building:before{content:"\f1ad"}.fa-child:before{content:"\f1ae"}.fa-paw:before{content:"\f1b0"}.fa-spoon:before{content:"\f1b1"}.fa-cube:before{content:"\f1b2"}.fa-cubes:before{content:"\f1b3"}.fa-behance:before{content:"\f1b4"}.fa-behance-square:before{content:"\f1b5"}.fa-steam:before{content:"\f1b6"}.fa-steam-square:before{content:"\f1b7"}.fa-recycle:before{content:"\f1b8"}.fa-automobile:before,.fa-car:before{content:"\f1b9"}.fa-cab:before,.fa-taxi:before{content:"\f1ba"}.fa-tree:before{content:"\f1bb"}.fa-spotify:before{content:"\f1bc"}.fa-deviantart:before{content:"\f1bd"}.fa-soundcloud:before{content:"\f1be"}.fa-database:before{content:"\f1c0"}.fa-file-pdf-o:before{content:"\f1c1"}.fa-file-word-o:before{content:"\f1c2"}.fa-file-excel-o:before{content:"\f1c3"}.fa-file-powerpoint-o:before{content:"\f1c4"}.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:"\f1c5"}.fa-file-zip-o:before,.fa-file-archive-o:before{content:"\f1c6"}.fa-file-sound-o:before,.fa-file-audio-o:before{content:"\f1c7"}.fa-file-movie-o:before,.fa-file-video-o:before{content:"\f1c8"}.fa-file-code-o:before{content:"\f1c9"}.fa-vine:before{content:"\f1ca"}.fa-codepen:before{content:"\f1cb"}.fa-jsfiddle:before{content:"\f1cc"}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:"\f1cd"}.fa-circle-o-notch:before{content:"\f1ce"}.fa-ra:before,.fa-resistance:before,.fa-rebel:before{content:"\f1d0"}.fa-ge:before,.fa-empire:before{content:"\f1d1"}.fa-git-square:before{content:"\f1d2"}.fa-git:before{content:"\f1d3"}.fa-y-combinator-square:before,.fa-yc-square:before,.fa-hacker-news:before{content:"\f1d4"}.fa-tencent-weibo:before{content:"\f1d5"}.fa-qq:before{content:"\f1d6"}.fa-wechat:before,.fa-weixin:before{content:"\f1d7"}.fa-send:before,.fa-paper-plane:before{content:"\f1d8"}.fa-send-o:before,.fa-paper-plane-o:before{content:"\f1d9"}.fa-history:before{content:"\f1da"}.fa-circle-thin:before{content:"\f1db"}.fa-header:before{content:"\f1dc"}.fa-paragraph:before{content:"\f1dd"}.fa-sliders:before{content:"\f1de"}.fa-share-alt:before{content:"\f1e0"}.fa-share-alt-square:before{content:"\f1e1"}.fa-bomb:before{content:"\f1e2"}.fa-soccer-ball-o:before,.fa-futbol-o:before{content:"\f1e3"}.fa-tty:before{content:"\f1e4"}.fa-binoculars:before{content:"\f1e5"}.fa-plug:before{content:"\f1e6"}.fa-slideshare:before{content:"\f1e7"}.fa-twitch:before{content:"\f1e8"}.fa-yelp:before{content:"\f1e9"}.fa-newspaper-o:before{content:"\f1ea"}.fa-wifi:before{content:"\f1eb"}.fa-calculator:before{content:"\f1ec"}.fa-paypal:before{content:"\f1ed"}.fa-google-wallet:before{content:"\f1ee"}.fa-cc-visa:before{content:"\f1f0"}.fa-cc-mastercard:before{content:"\f1f1"}.fa-cc-discover:before{content:"\f1f2"}.fa-cc-amex:before{content:"\f1f3"}.fa-cc-paypal:before{content:"\f1f4"}.fa-cc-stripe:before{content:"\f1f5"}.fa-bell-slash:before{content:"\f1f6"}.fa-bell-slash-o:before{content:"\f1f7"}.fa-trash:before{content:"\f1f8"}.fa-copyright:before{content:"\f1f9"}.fa-at:before{content:"\f1fa"}.fa-eyedropper:before{content:"\f1fb"}.fa-paint-brush:before{content:"\f1fc"}.fa-birthday-cake:before{content:"\f1fd"}.fa-area-chart:before{content:"\f1fe"}.fa-pie-chart:before{content:"\f200"}.fa-line-chart:before{content:"\f201"}.fa-lastfm:before{content:"\f202"}.fa-lastfm-square:before{content:"\f203"}.fa-toggle-off:before{content:"\f204"}.fa-toggle-on:before{content:"\f205"}.fa-bicycle:before{content:"\f206"}.fa-bus:before{content:"\f207"}.fa-ioxhost:before{content:"\f208"}.fa-angellist:before{content:"\f209"}.fa-cc:before{content:"\f20a"}.fa-shekel:before,.fa-sheqel:before,.fa-ils:before{content:"\f20b"}.fa-meanpath:before{content:"\f20c"}.fa-buysellads:before{content:"\f20d"}.fa-connectdevelop:before{content:"\f20e"}.fa-dashcube:before{content:"\f210"}.fa-forumbee:before{content:"\f211"}.fa-leanpub:before{content:"\f212"}.fa-sellsy:before{content:"\f213"}.fa-shirtsinbulk:before{content:"\f214"}.fa-simplybuilt:before{content:"\f215"}.fa-skyatlas:before{content:"\f216"}.fa-cart-plus:before{content:"\f217"}.fa-cart-arrow-down:before{content:"\f218"}.fa-diamond:before{content:"\f219"}.fa-ship:before{content:"\f21a"}.fa-user-secret:before{content:"\f21b"}.fa-motorcycle:before{content:"\f21c"}.fa-street-view:before{content:"\f21d"}.fa-heartbeat:before{content:"\f21e"}.fa-venus:before{content:"\f221"}.fa-mars:before{content:"\f222"}.fa-mercury:before{content:"\f223"}.fa-intersex:before,.fa-transgender:before{content:"\f224"}.fa-transgender-alt:before{content:"\f225"}.fa-venus-double:before{content:"\f226"}.fa-mars-double:before{content:"\f227"}.fa-venus-mars:before{content:"\f228"}.fa-mars-stroke:before{content:"\f229"}.fa-mars-stroke-v:before{content:"\f22a"}.fa-mars-stroke-h:before{content:"\f22b"}.fa-neuter:before{content:"\f22c"}.fa-genderless:before{content:"\f22d"}.fa-facebook-official:before{content:"\f230"}.fa-pinterest-p:before{content:"\f231"}.fa-whatsapp:before{content:"\f232"}.fa-server:before{content:"\f233"}.fa-user-plus:before{content:"\f234"}.fa-user-times:before{content:"\f235"}.fa-hotel:before,.fa-bed:before{content:"\f236"}.fa-viacoin:before{content:"\f237"}.fa-train:before{content:"\f238"}.fa-subway:before{content:"\f239"}.fa-medium:before{content:"\f23a"}.fa-yc:before,.fa-y-combinator:before{content:"\f23b"}.fa-optin-monster:before{content:"\f23c"}.fa-opencart:before{content:"\f23d"}.fa-expeditedssl:before{content:"\f23e"}.fa-battery-4:before,.fa-battery:before,.fa-battery-full:before{content:"\f240"}.fa-battery-3:before,.fa-battery-three-quarters:before{content:"\f241"}.fa-battery-2:before,.fa-battery-half:before{content:"\f242"}.fa-battery-1:before,.fa-battery-quarter:before{content:"\f243"}.fa-battery-0:before,.fa-battery-empty:before{content:"\f244"}.fa-mouse-pointer:before{content:"\f245"}.fa-i-cursor:before{content:"\f246"}.fa-object-group:before{content:"\f247"}.fa-object-ungroup:before{content:"\f248"}.fa-sticky-note:before{content:"\f249"}.fa-sticky-note-o:before{content:"\f24a"}.fa-cc-jcb:before{content:"\f24b"}.fa-cc-diners-club:before{content:"\f24c"}.fa-clone:before{content:"\f24d"}.fa-balance-scale:before{content:"\f24e"}.fa-hourglass-o:before{content:"\f250"}.fa-hourglass-1:before,.fa-hourglass-start:before{content:"\f251"}.fa-hourglass-2:before,.fa-hourglass-half:before{content:"\f252"}.fa-hourglass-3:before,.fa-hourglass-end:before{content:"\f253"}.fa-hourglass:before{content:"\f254"}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:"\f255"}.fa-hand-stop-o:before,.fa-hand-paper-o:before{content:"\f256"}.fa-hand-scissors-o:before{content:"\f257"}.fa-hand-lizard-o:before{content:"\f258"}.fa-hand-spock-o:before{content:"\f259"}.fa-hand-pointer-o:before{content:"\f25a"}.fa-hand-peace-o:before{content:"\f25b"}.fa-trademark:before{content:"\f25c"}.fa-registered:before{content:"\f25d"}.fa-creative-commons:before{content:"\f25e"}.fa-gg:before{content:"\f260"}.fa-gg-circle:before{content:"\f261"}.fa-tripadvisor:before{content:"\f262"}.fa-odnoklassniki:before{content:"\f263"}.fa-odnoklassniki-square:before{content:"\f264"}.fa-get-pocket:before{content:"\f265"}.fa-wikipedia-w:before{content:"\f266"}.fa-safari:before{content:"\f267"}.fa-chrome:before{content:"\f268"}.fa-firefox:before{content:"\f269"}.fa-opera:before{content:"\f26a"}.fa-internet-explorer:before{content:"\f26b"}.fa-tv:before,.fa-television:before{content:"\f26c"}.fa-contao:before{content:"\f26d"}.fa-500px:before{content:"\f26e"}.fa-amazon:before{content:"\f270"}.fa-calendar-plus-o:before{content:"\f271"}.fa-calendar-minus-o:before{content:"\f272"}.fa-calendar-times-o:before{content:"\f273"}.fa-calendar-check-o:before{content:"\f274"}.fa-industry:before{content:"\f275"}.fa-map-pin:before{content:"\f276"}.fa-map-signs:before{content:"\f277"}.fa-map-o:before{content:"\f278"}.fa-map:before{content:"\f279"}.fa-commenting:before{content:"\f27a"}.fa-commenting-o:before{content:"\f27b"}.fa-houzz:before{content:"\f27c"}.fa-vimeo:before{content:"\f27d"}.fa-black-tie:before{content:"\f27e"}.fa-fonticons:before{content:"\f280"}.fa-reddit-alien:before{content:"\f281"}.fa-edge:before{content:"\f282"}.fa-credit-card-alt:before{content:"\f283"}.fa-codiepie:before{content:"\f284"}.fa-modx:before{content:"\f285"}.fa-fort-awesome:before{content:"\f286"}.fa-usb:before{content:"\f287"}.fa-product-hunt:before{content:"\f288"}.fa-mixcloud:before{content:"\f289"}.fa-scribd:before{content:"\f28a"}.fa-pause-circle:before{content:"\f28b"}.fa-pause-circle-o:before{content:"\f28c"}.fa-stop-circle:before{content:"\f28d"}.fa-stop-circle-o:before{content:"\f28e"}.fa-shopping-bag:before{content:"\f290"}.fa-shopping-basket:before{content:"\f291"}.fa-hashtag:before{content:"\f292"}.fa-bluetooth:before{content:"\f293"}.fa-bluetooth-b:before{content:"\f294"}.fa-percent:before{content:"\f295"}.fa-gitlab:before{content:"\f296"}.fa-wpbeginner:before{content:"\f297"}.fa-wpforms:before{content:"\f298"}.fa-envira:before{content:"\f299"}.fa-universal-access:before{content:"\f29a"}.fa-wheelchair-alt:before{content:"\f29b"}.fa-question-circle-o:before{content:"\f29c"}.fa-blind:before{content:"\f29d"}.fa-audio-description:before{content:"\f29e"}.fa-volume-control-phone:before{content:"\f2a0"}.fa-braille:before{content:"\f2a1"}.fa-assistive-listening-systems:before{content:"\f2a2"}.fa-asl-interpreting:before,.fa-american-sign-language-interpreting:before{content:"\f2a3"}.fa-deafness:before,.fa-hard-of-hearing:before,.fa-deaf:before{content:"\f2a4"}.fa-glide:before{content:"\f2a5"}.fa-glide-g:before{content:"\f2a6"}.fa-signing:before,.fa-sign-language:before{content:"\f2a7"}.fa-low-vision:before{content:"\f2a8"}.fa-viadeo:before{content:"\f2a9"}.fa-viadeo-square:before{content:"\f2aa"}.fa-snapchat:before{content:"\f2ab"}.fa-snapchat-ghost:before{content:"\f2ac"}.fa-snapchat-square:before{content:"\f2ad"}.fa-pied-piper:before{content:"\f2ae"}.fa-first-order:before{content:"\f2b0"}.fa-yoast:before{content:"\f2b1"}.fa-themeisle:before{content:"\f2b2"}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:"\f2b3"}.fa-fa:before,.fa-font-awesome:before{content:"\f2b4"}.fa-handshake-o:before{content:"\f2b5"}.fa-envelope-open:before{content:"\f2b6"}.fa-envelope-open-o:before{content:"\f2b7"}.fa-linode:before{content:"\f2b8"}.fa-address-book:before{content:"\f2b9"}.fa-address-book-o:before{content:"\f2ba"}.fa-vcard:before,.fa-address-card:before{content:"\f2bb"}.fa-vcard-o:before,.fa-address-card-o:before{content:"\f2bc"}.fa-user-circle:before{content:"\f2bd"}.fa-user-circle-o:before{content:"\f2be"}.fa-user-o:before{content:"\f2c0"}.fa-id-badge:before{content:"\f2c1"}.fa-drivers-license:before,.fa-id-card:before{content:"\f2c2"}.fa-drivers-license-o:before,.fa-id-card-o:before{content:"\f2c3"}.fa-quora:before{content:"\f2c4"}.fa-free-code-camp:before{content:"\f2c5"}.fa-telegram:before{content:"\f2c6"}.fa-thermometer-4:before,.fa-thermometer:before,.fa-thermometer-full:before{content:"\f2c7"}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:"\f2c8"}.fa-thermometer-2:before,.fa-thermometer-half:before{content:"\f2c9"}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:"\f2ca"}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:"\f2cb"}.fa-shower:before{content:"\f2cc"}.fa-bathtub:before,.fa-s15:before,.fa-bath:before{content:"\f2cd"}.fa-podcast:before{content:"\f2ce"}.fa-window-maximize:before{content:"\f2d0"}.fa-window-minimize:before{content:"\f2d1"}.fa-window-restore:before{content:"\f2d2"}.fa-times-rectangle:before,.fa-window-close:before{content:"\f2d3"}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:"\f2d4"}.fa-bandcamp:before{content:"\f2d5"}.fa-grav:before{content:"\f2d6"}.fa-etsy:before{content:"\f2d7"}.fa-imdb:before{content:"\f2d8"}.fa-ravelry:before{content:"\f2d9"}.fa-eercast:before{content:"\f2da"}.fa-microchip:before{content:"\f2db"}.fa-snowflake-o:before{content:"\f2dc"}.fa-superpowers:before{content:"\f2dd"}.fa-wpexplorer:before{content:"\f2de"}.fa-meetup:before{content:"\f2e0"}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}
diff --git a/docs/errors.md b/docs/errors.md
new file mode 100644
index 0000000..81618e3
--- /dev/null
+++ b/docs/errors.md
@@ -0,0 +1,99 @@
+# Errors
+
+All DB-related errors manifest themselves as exceptions of type `soci_error`, which is derived from `std::runtime_error`.
+This allows to handle database errors within the standard exception framework:
+
+```cpp
+int main()
+{
+    try
+    {
+        // regular code
+    }
+    catch (std::exception const & e)
+    {
+        cerr << "Bang! " << e.what() << endl;
+    }
+}
+```
+
+The `soci_error` class exposes two public functions:
+
+The `get_error_message() const` function returns `std::string` with a brief error message, without any additional information that can be present in the full error message returned by `what()`.
+
+The `get_error_category() const` function returns one of the `error_category` enumeration values, which allows the user to portably react to some subset of common errors.
+For example, `connection_error` or `constraint_violation` have meanings that are common across different database backends, even though the actual mechanics might differ.
+
+## Portability
+
+Error categories are not universally supported and there is no claim that all possible errors that are reported by the database server are covered or interpreted.
+If the error category is not recognized by the backend, it defaults to `unknown`.
+
+## MySQL
+
+The MySQL backend can throw instances of the `mysql_soci_error`, which is publicly derived from `soci_error` and has an additional public `err_num_` member containing the MySQL error code (as returned by `mysql_errno()`):
+
+```cpp
+int main()
+{
+    try
+    {
+        // regular code
+    }
+    catch (soci::mysql_soci_error const & e)
+    {
+        cerr << "MySQL error: " << e.err_num_
+            << " " << e.what() << endl;
+    }
+    catch (soci::exception const & e)
+    {
+        cerr << "Some other error: " << e.what() << endl;
+    }
+}
+```
+
+## Oracle
+
+The Oracle backend can also throw the instances of the `oracle_soci_error`, which is publicly derived from `soci_error` and has an additional public `err_num_` member containing the Oracle error code:
+
+```cpp
+int main()
+{
+    try
+    {
+        // regular code
+    }
+    catch (soci::oracle_soci_error const & e)
+    {
+        cerr << "Oracle error: " << e.err_num_
+            << " " << e.what() << endl;
+    }
+    catch (soci::exception const & e)
+    {
+        cerr << "Some other error: " << e.what() << endl;
+    }
+}
+```
+
+## PostgreSQL
+
+The PostgreSQL backend can also throw the instances of the `postgresql_soci_error`, which is publicly derived from `soci_error` and has an additional public `sqlstate()` member function returning the five-character "SQLSTATE" error code:
+
+```cpp
+int main()
+{
+    try
+    {
+        // regular code
+    }
+    catch (soci::postgresql_soci_error const & e)
+    {
+        cerr << "PostgreSQL error: " << e.sqlstate()
+            << " " << e.what() << endl;
+    }
+    catch (soci::exception const & e)
+    {
+        cerr << "Some other error: " << e.what() << endl;
+    }
+}
+```
diff --git a/docs/errors/index.html b/docs/errors/index.html
deleted file mode 100644
index 0f57ca9..0000000
--- a/docs/errors/index.html
+++ /dev/null
@@ -1,434 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Errors - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../procedures/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../logging/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/errors.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#errors" class="nav-link">Errors</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#portability" class="nav-link">Portability</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#mysql" class="nav-link">MySQL</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#oracle" class="nav-link">Oracle</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#postgresql" class="nav-link">PostgreSQL</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="errors">Errors</h1>
-<p>All DB-related errors manifest themselves as exceptions of type <code>soci_error</code>, which is derived from <code>std::runtime_error</code>.
-This allows to handle database errors within the standard exception framework:</p>
-<pre><code class="language-cpp">int main()
-{
-    try
-    {
-        // regular code
-    }
-    catch (std::exception const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Bang! &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-}
-</code></pre>
-<p>The <code>soci_error</code> class exposes two public functions:</p>
-<p>The <code>get_error_message() const</code> function returns <code>std::string</code> with a brief error message, without any additional information that can be present in the full error message returned by <code>what()</code>.</p>
-<p>The <code>get_error_category() const</code> function returns one of the <code>error_category</code> enumeration values, which allows the user to portably react to some subset of common errors.
-For example, <code>connection_error</code> or <code>constraint_violation</code> have meanings that are common across different database backends, even though the actual mechanics might differ.</p>
-<h2 id="portability">Portability</h2>
-<p>Error categories are not universally supported and there is no claim that all possible errors that are reported by the database server are covered or interpreted.
-If the error category is not recognized by the backend, it defaults to <code>unknown</code>.</p>
-<h2 id="mysql">MySQL</h2>
-<p>The MySQL backend can throw instances of the <code>mysql_soci_error</code>, which is publicly derived from <code>soci_error</code> and has an additional public <code>err_num_</code> member containing the MySQL error code (as returned by <code>mysql_errno()</code>):</p>
-<pre><code class="language-cpp">int main()
-{
-    try
-    {
-        // regular code
-    }
-    catch (soci::mysql_soci_error const &amp; e)
-    {
-        cerr &lt;&lt; &quot;MySQL error: &quot; &lt;&lt; e.err_num_
-            &lt;&lt; &quot; &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-    catch (soci::exception const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Some other error: &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-}
-</code></pre>
-<h2 id="oracle">Oracle</h2>
-<p>The Oracle backend can also throw the instances of the <code>oracle_soci_error</code>, which is publicly derived from <code>soci_error</code> and has an additional public <code>err_num_</code> member containing the Oracle error code:</p>
-<pre><code class="language-cpp">int main()
-{
-    try
-    {
-        // regular code
-    }
-    catch (soci::oracle_soci_error const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Oracle error: &quot; &lt;&lt; e.err_num_
-            &lt;&lt; &quot; &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-    catch (soci::exception const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Some other error: &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-}
-</code></pre>
-<h2 id="postgresql">PostgreSQL</h2>
-<p>The PostgreSQL backend can also throw the instances of the <code>postgresql_soci_error</code>, which is publicly derived from <code>soci_error</code> and has an additional public <code>sqlstate()</code> member function returning the five-character "SQLSTATE" error code:</p>
-<pre><code class="language-cpp">int main()
-{
-    try
-    {
-        // regular code
-    }
-    catch (soci::postgresql_soci_error const &amp; e)
-    {
-        cerr &lt;&lt; &quot;PostgreSQL error: &quot; &lt;&lt; e.sqlstate()
-            &lt;&lt; &quot; &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-    catch (soci::exception const &amp; e)
-    {
-        cerr &lt;&lt; &quot;Some other error: &quot; &lt;&lt; e.what() &lt;&lt; endl;
-    }
-}
-</code></pre></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/faq.md b/docs/faq.md
new file mode 100644
index 0000000..a37ef7a
--- /dev/null
+++ b/docs/faq.md
@@ -0,0 +1,129 @@
+# FAQ
+
+This part of the documentation is supposed to gather in a single place the usual questions (and answers) about SOCI with regard to the design decisions that have shaped it.
+
+## Q: Why "SOCI"?
+
+SOCI was initially developed in the environment where Oracle was the main database technology in use. As a wrapper for the native OCI API (Oracle Call Interface), the name "Simple Oracle Call Interface" was quite obvious - until the 2.0 release, when the internal architecture was largely redesigned to allow the use of *backends* that support other database servers. We have kept the same name to indicate that Oracle is the main supported technology in the sense that the library includes only those features that were naturally implemented in Oracle. With the 2.1 release of the library, two new backends were added (MySQL and SQLite3) and we decided to drop the original full name so that new users looking for a library supporting any of these simpler libraries are not discouraged by seeing "Oracle" somewhere in the name.
+
+The other possible interpretation was "Syntax Oriented Call Interface", which stresses the fact that SOCI was built to support the most natural and easy interface for the user that is similar to the Embedded SQL concept (see below). But on the other hand, SOCI also provides other features (like object-relational mapping) and as a whole it is not just "emulator" of the Embedded SQL. With all these considerations in mind, SOCI is just "SOCI - The C++ Database Access Library".
+
+Still, Oracle is considered to be the main driving server technology in terms of the set of features that are supported by the library. This also means that backends for other servers might need to work around some of the imposed idioms and protocols, but already available and well-working PostgreSQL, MySQL and SQLite3 backends show
+that it's actually not that bad and the abstractions provided by the library are actually very universal. Of course, some of the features that were provided for Oracle might not be supported for all other servers, but we think that it's better to have one leading technology (where at least one group is fully happy) instead of some "common denominator" for all databases (where *nobody* is happy).
+
+## Q: Where the basic SOCI syntax comes from?
+
+The basic SOCI syntax was inspired by the Embedded SQL, which is part of the SQL standard, supported by the major DB technologies and even available as built-in part of the languages used in some DB-oriented integrated development environments. The term "Embedded SQL" is enough for Google to spit millions of references - one of the typical examples is:
+
+```cpp
+{
+    int a;
+    /* ... */
+    EXEC SQL SELECT salary INTO :a
+                FROM Employee
+                WHERE SSN=876543210;
+    /* ... */
+    printf("The salary is %d\n", a);
+    /* ... */
+}
+```
+
+The above is not a regular C (nor C++) code, of course. It's the mix of C and SQL and there is a separate, pecialized preprocessor needed to convert it to something that the actual C (or C++) compiler will be able to understand. This means that the compilation of the program using embedded SQL is two-phase: preprocess the embedded SQL part and compile the result. This two-phase development is quite troublesome, especially when it comes to debugging. Yet, the advantage of it is that the code expresses the programmer's intents in a very straightforward
+way: read something from the database and put it into the local variable. Just like that.
+
+The SOCI library was born as an answer to the following question: is it possible to have the same expressive power without the disadvantages of two-phase builds?
+
+The following was chosen to be the basic SOCI syntax that can mirror the above Embedded SQL example:
+
+```cpp
+int a;
+sql << "SELECT salary FROM Employee WHERE SSN=876543210", into(a);
+```
+
+(as you see, SOCI changes the order of elements a little bit, so that the SQL query is separate and not mixed with other elements)
+
+Apart from mimicking the Embedded SQL techniques in the regular, fully standard C++ code, the above syntax has the following benefit: it is *minimal* with respect to what has to be said. Every single piece above is needed and expresses something important, like:
+
+* which session should be used (the client can be connected to many databases at the same time) - here, the `sql` object encapsulates the session,
+* what SQL query should be executed - here, it's the string literal, but it could be also a `std::string` variable,
+* where to put the result - here, the local variable `a` will receive the result.
+
+Everything else is just a couple of operators that allow to treat the whole as a single expression. It's rather difficult to remove anything from this example.
+
+The fact that the basic SOCI syntax is minimal (but without being obscure at the same time, see below) means that the programmer does not need to bother with unnecessary noise that some other database libraries impose. We hope that after having written one line of code like above by themselves, most programmers will react with something
+like "how obvious!" instead of "how advanced!".
+
+## Q: Why should I use SQL queries as strings in my program? I prefer the query to be generated or composed piece-by-piece by separate functions.
+
+First, you don't need to use SQL queries as string literals. In bigger projects it is a common practice to store SQL queries externally (in a file, or in a... database) and load them before use. This means that they are not necessarily expected to appear in the program code, as they do in our simple code examples and the advantage of separating them from the source code of the main program is, among others, the possibility to optimize and tune the SQL queries without recompilation and relinking of the whole program.
+
+What is the most important, though, is that SOCI does not try to mess with the text of the query (apart from very few cases), which means that the database server will get exactly the same text of the query as is used in the program. The advantage of this is that there is no new SQL-like (or even SQL-*un*like) syntax that you would need to learn, and also that it's much easier to convince a typical DBA to help with SQL tuning or other specialized activities, if he is given the material in the form that is not polluted with any foreign abstractions.
+
+## Q: Why not some stream-like interface, which is well-known to all C++ programmers?
+
+An example of the stream-like interface might be something like this (this is imaginary syntax, not supported by SOCI):
+
+```cpp
+sql.exec("select a, b, c from some_table");
+
+while (!sql.eof())
+{
+    int a, b, c;
+    sql >> a >> b >> c;
+    // ...
+}
+```
+
+We think that the data stored in the relational database should be treated as a set of relations - which is exactly what it is. This means that what is read from the database as a result of some SQL query is a *set of rows*. This set might be ordered, but it is still a set of rows, not a uniformly flat list of values. This distinction might seem to be unnecessarily low-level and that the uniform stream-like presentation of data is more preferable, but it's actually the other way round - the set of rows is something more structured - and that structure was *designed* into the database - than the flat stream and is therefore less prone to programming errors like miscounting the number of values that is expected in each row.
+
+Consider the following programming error:
+
+```cpp
+sql.exec("select a, b from some_table"); // only TWO columns
+
+while (!sql.eof())
+{
+    int a, b, c;
+    sql >> a >> b >> c; // this causes "row-tearing"
+    // ...
+}
+```
+
+*"How to detect the end of each line in a file"* is a common beginner's question that relates to the use of IOStreams - and this common question clearly shows that for the record-oriented data the stream is not an optimal abstraction. Of course, we don't claim that IOStreams is bad - but we do insist that the record-oriented data is
+better manipulated in a way that is also record-aware.
+
+Having said that, we *have* provided some form of the stream-like interface, but with the important limitation that the stream is always bound to the single row, so that the row-tearing effect is not possible. In other words,
+data returned from the database is still structured into rows, but each row can be separately traversed like a stream. We hope that it provides a good balance between convenience and code safety.
+
+## Q: Why use indicators instead of some special value to discover that something is null?
+
+Some programmers are used to indicating the null value by using some special (which means: "unlikely" to be ever used) value - for example, to use the smallest integer value to indicate null integer. Or to use empty string to indicate null string. And so on.
+
+We think that it's *completely wrong*. Null (in the database sense) is an information *about* the data. It describes the *state* of the data and if it's null, then there's *no data at all*. Nothing. Null. It does not make any sense to talk about some special value if in fact there is *no* value at all - especially if we take into account that, for example, the smallest integer value (or whatever else you choose as the "special" value) might not be *that* special in the given application or domain.
+
+Thus, SOCI uses a separate indicators to describe the state of exchanged data. It also has an additional benefit of allowing the library to convey more than two states (null and not null). Indeed, the SOCI library uses indicators also to report that the data was read, but truncated (this applies to strings when reading to fixed-length character arrays). Truncation is also an information about the data and as such it's better to have it in addition to the data, not as part of it.
+
+Having said that, it is important to point at the [Integration with Boost](boost.md) that allows to use `boost::optional<T>` to conveniently pack together the data and the information about its state.
+
+## Q: Overloaded comma operator is just obfuscation, I don't like it.
+
+Well, consider the following:
+
+"Send the query X to the server Y *and* put result into variable Z."
+
+Above, the "and" plays a role of the comma. Even if overloading the comma operator is not a very popular practice in C++, some libraries do this, achieving terse and easy to learn syntax. We are pretty sure that in SOCI the comma operator was overloaded with a good effect.
+
+## Q: The `operator<<` provides a bad abstraction for the "input" statements.
+
+Indeed, the `operator<<` in the basic SOCI syntax shows that something (the query) is *sent* somewhere (to the server). Some people don't like this, especially when the "select" statements are involved. If the high-level idea is to *read*  data from somewhere, then `operator<<` seems unintuitive to the die-hard IOStreams users. The fact is, however, that the code containing SQL statement already indicates that there is a client-server relationship with some other software component (very likely remote). In such code it does not make any sense to pretend that the communication is one-way only, because it's clear that even the "select" statements need to be *sent* somewhere. This approach is also more uniform and allows to cover other statements like "drop table" or alike, where no data is expected to be exchanged at all (and therefore the IOStreams analogies for data exchange have no sense at all). No matter what is the kind of the SQL statement, it is *sent*  to the server and this "sending" justifies the choice of `operator<<`.
+
+Using different operators (`operator>>` and `operator<<`) as a way of distinguishing between different high-level ideas (*reading* and *writing* from the data store, respectively) does make sense on much higher level of abstraction, where the SQL statement itself is already hidden - and we do encourage programmers to use SOCI for implementing such high-level abstractions. For this, the object-relational mapping facilities available in SOCI might prove to be a valuable tool as well, as an effective bridge
+between the low-level world of SQL statements and the high-level world of user-defined abstract data types.
+
+## Q: Why the Boost license?
+
+We decided to use the [Boost license](http://www.boost.org/LICENSE_1_0.txt), because
+it's well recognized in the C++ community, allows us to keep our minimum copyrights, and at the same time allows SOCI to be safely used in commercial projects, without imposing concerns (or just plainuncertainty) typical to other open source licenses, like GPL. We also hope that by choosing the Boost license we have made the life easier
+for both us and our users. It saves us from answering law-related questions that were already answered on the [Boost license info page](http://www.boost.org/more/license_info.html) and it should also give more confidence to our users - especially to those of them, who already accepted the conditions of the Boost license - the just have one license less to analyze.
+
+Still, if for any reason the conditions of this license are not acceptable, we encourage the users to contact us directly (see [links](http://soci.sourceforge.net/people.html) on the relevant SOCI page) to discuss any remaining concerns.
diff --git a/docs/faq/index.html b/docs/faq/index.html
deleted file mode 100644
index 495ffbc..0000000
--- a/docs/faq/index.html
+++ /dev/null
@@ -1,455 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>FAQ - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../license/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../connections/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/faq.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#faq" class="nav-link">FAQ</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#q-why-soci" class="nav-link">Q: Why "SOCI"?</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-where-the-basic-soci-syntax-comes-from" class="nav-link">Q: Where the basic SOCI syntax comes from?</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-why-should-i-use-sql-queries-as-strings-in-my-program-i-prefer-the-query-to-be-generated-or-composed-piece-by-piece-by-separate-functions" class="nav-link">Q: Why should I use SQL queries as strings in my program? I prefer the query to be generated or composed piece-by-piece by separate functions.</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-why-not-some-stream-like-interface-which-is-well-known-to-all-c-programmers" class="nav-link">Q: Why not some stream-like interface, which is well-known to all C++ programmers?</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-why-use-indicators-instead-of-some-special-value-to-discover-that-something-is-null" class="nav-link">Q: Why use indicators instead of some special value to discover that something is null?</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-overloaded-comma-operator-is-just-obfuscation-i-dont-like-it" class="nav-link">Q: Overloaded comma operator is just obfuscation, I don't like it.</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-the-operator-provides-a-bad-abstraction-for-the-input-statements" class="nav-link">Q: The operator&lt;&lt; provides a bad abstraction for the "input" statements.</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#q-why-the-boost-license" class="nav-link">Q: Why the Boost license?</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="faq">FAQ</h1>
-<p>This part of the documentation is supposed to gather in a single place the usual questions (and answers) about SOCI with regard to the design decisions that have shaped it.</p>
-<h2 id="q-why-soci">Q: Why "SOCI"?</h2>
-<p>SOCI was initially developed in the environment where Oracle was the main database technology in use. As a wrapper for the native OCI API (Oracle Call Interface), the name "Simple Oracle Call Interface" was quite obvious - until the 2.0 release, when the internal architecture was largely redesigned to allow the use of <em>backends</em> that support other database servers. We have kept the same name to indicate that Oracle is the main supported technology in the sense that the library includes only those features that were naturally implemented in Oracle. With the 2.1 release of the library, two new backends were added (MySQL and SQLite3) and we decided to drop the original full name so that new users looking for a library supporting any of these simpler libraries are not discouraged by seeing "Oracle" somewhere in the name.</p>
-<p>The other possible interpretation was "Syntax Oriented Call Interface", which stresses the fact that SOCI was built to support the most natural and easy interface for the user that is similar to the Embedded SQL concept (see below). But on the other hand, SOCI also provides other features (like object-relational mapping) and as a whole it is not just "emulator" of the Embedded SQL. With all these considerations in mind, SOCI is just "SOCI - The C++ Database Access Library".</p>
-<p>Still, Oracle is considered to be the main driving server technology in terms of the set of features that are supported by the library. This also means that backends for other servers might need to work around some of the imposed idioms and protocols, but already available and well-working PostgreSQL, MySQL and SQLite3 backends show
-that it's actually not that bad and the abstractions provided by the library are actually very universal. Of course, some of the features that were provided for Oracle might not be supported for all other servers, but we think that it's better to have one leading technology (where at least one group is fully happy) instead of some "common denominator" for all databases (where <em>nobody</em> is happy).</p>
-<h2 id="q-where-the-basic-soci-syntax-comes-from">Q: Where the basic SOCI syntax comes from?</h2>
-<p>The basic SOCI syntax was inspired by the Embedded SQL, which is part of the SQL standard, supported by the major DB technologies and even available as built-in part of the languages used in some DB-oriented integrated development environments. The term "Embedded SQL" is enough for Google to spit millions of references - one of the typical examples is:</p>
-<pre><code class="language-cpp">{
-    int a;
-    /* ... */
-    EXEC SQL SELECT salary INTO :a
-                FROM Employee
-                WHERE SSN=876543210;
-    /* ... */
-    printf(&quot;The salary is %d\n&quot;, a);
-    /* ... */
-}
-</code></pre>
-<p>The above is not a regular C (nor C++) code, of course. It's the mix of C and SQL and there is a separate, pecialized preprocessor needed to convert it to something that the actual C (or C++) compiler will be able to understand. This means that the compilation of the program using embedded SQL is two-phase: preprocess the embedded SQL part and compile the result. This two-phase development is quite troublesome, especially when it comes to debugging. Yet, the advantage of it is that the code expresses the programmer's intents in a very straightforward
-way: read something from the database and put it into the local variable. Just like that.</p>
-<p>The SOCI library was born as an answer to the following question: is it possible to have the same expressive power without the disadvantages of two-phase builds?</p>
-<p>The following was chosen to be the basic SOCI syntax that can mirror the above Embedded SQL example:</p>
-<pre><code class="language-cpp">int a;
-sql &lt;&lt; &quot;SELECT salary FROM Employee WHERE SSN=876543210&quot;, into(a);
-</code></pre>
-<p>(as you see, SOCI changes the order of elements a little bit, so that the SQL query is separate and not mixed with other elements)</p>
-<p>Apart from mimicking the Embedded SQL techniques in the regular, fully standard C++ code, the above syntax has the following benefit: it is <em>minimal</em> with respect to what has to be said. Every single piece above is needed and expresses something important, like:</p>
-<ul>
-<li>which session should be used (the client can be connected to many databases at the same time) - here, the <code>sql</code> object encapsulates the session,</li>
-<li>what SQL query should be executed - here, it's the string literal, but it could be also a <code>std::string</code> variable,</li>
-<li>where to put the result - here, the local variable <code>a</code> will receive the result.</li>
-</ul>
-<p>Everything else is just a couple of operators that allow to treat the whole as a single expression. It's rather difficult to remove anything from this example.</p>
-<p>The fact that the basic SOCI syntax is minimal (but without being obscure at the same time, see below) means that the programmer does not need to bother with unnecessary noise that some other database libraries impose. We hope that after having written one line of code like above by themselves, most programmers will react with something
-like "how obvious!" instead of "how advanced!".</p>
-<h2 id="q-why-should-i-use-sql-queries-as-strings-in-my-program-i-prefer-the-query-to-be-generated-or-composed-piece-by-piece-by-separate-functions">Q: Why should I use SQL queries as strings in my program? I prefer the query to be generated or composed piece-by-piece by separate functions.</h2>
-<p>First, you don't need to use SQL queries as string literals. In bigger projects it is a common practice to store SQL queries externally (in a file, or in a... database) and load them before use. This means that they are not necessarily expected to appear in the program code, as they do in our simple code examples and the advantage of separating them from the source code of the main program is, among others, the possibility to optimize and tune the SQL queries without recompilation and relinking of the whole program.</p>
-<p>What is the most important, though, is that SOCI does not try to mess with the text of the query (apart from very few cases), which means that the database server will get exactly the same text of the query as is used in the program. The advantage of this is that there is no new SQL-like (or even SQL-<em>un</em>like) syntax that you would need to learn, and also that it's much easier to convince a typical DBA to help with SQL tuning or other specialized activities, if he is given the material in the form that is not polluted with any foreign abstractions.</p>
-<h2 id="q-why-not-some-stream-like-interface-which-is-well-known-to-all-c-programmers">Q: Why not some stream-like interface, which is well-known to all C++ programmers?</h2>
-<p>An example of the stream-like interface might be something like this (this is imaginary syntax, not supported by SOCI):</p>
-<pre><code class="language-cpp">sql.exec(&quot;select a, b, c from some_table&quot;);
-
-while (!sql.eof())
-{
-    int a, b, c;
-    sql &gt;&gt; a &gt;&gt; b &gt;&gt; c;
-    // ...
-}
-</code></pre>
-<p>We think that the data stored in the relational database should be treated as a set of relations - which is exactly what it is. This means that what is read from the database as a result of some SQL query is a <em>set of rows</em>. This set might be ordered, but it is still a set of rows, not a uniformly flat list of values. This distinction might seem to be unnecessarily low-level and that the uniform stream-like presentation of data is more preferable, but it's actually the other way round - the set of rows is something more structured - and that structure was <em>designed</em> into the database - than the flat stream and is therefore less prone to programming errors like miscounting the number of values that is expected in each row.</p>
-<p>Consider the following programming error:</p>
-<pre><code class="language-cpp">sql.exec(&quot;select a, b from some_table&quot;); // only TWO columns
-
-while (!sql.eof())
-{
-    int a, b, c;
-    sql &gt;&gt; a &gt;&gt; b &gt;&gt; c; // this causes &quot;row-tearing&quot;
-    // ...
-}
-</code></pre>
-<p><em>"How to detect the end of each line in a file"</em> is a common beginner's question that relates to the use of IOStreams - and this common question clearly shows that for the record-oriented data the stream is not an optimal abstraction. Of course, we don't claim that IOStreams is bad - but we do insist that the record-oriented data is
-better manipulated in a way that is also record-aware.</p>
-<p>Having said that, we <em>have</em> provided some form of the stream-like interface, but with the important limitation that the stream is always bound to the single row, so that the row-tearing effect is not possible. In other words,
-data returned from the database is still structured into rows, but each row can be separately traversed like a stream. We hope that it provides a good balance between convenience and code safety.</p>
-<h2 id="q-why-use-indicators-instead-of-some-special-value-to-discover-that-something-is-null">Q: Why use indicators instead of some special value to discover that something is null?</h2>
-<p>Some programmers are used to indicating the null value by using some special (which means: "unlikely" to be ever used) value - for example, to use the smallest integer value to indicate null integer. Or to use empty string to indicate null string. And so on.</p>
-<p>We think that it's <em>completely wrong</em>. Null (in the database sense) is an information <em>about</em> the data. It describes the <em>state</em> of the data and if it's null, then there's <em>no data at all</em>. Nothing. Null. It does not make any sense to talk about some special value if in fact there is <em>no</em> value at all - especially if we take into account that, for example, the smallest integer value (or whatever else you choose as the "special" value) might not be <em>that</em> special in the given application or domain.</p>
-<p>Thus, SOCI uses a separate indicators to describe the state of exchanged data. It also has an additional benefit of allowing the library to convey more than two states (null and not null). Indeed, the SOCI library uses indicators also to report that the data was read, but truncated (this applies to strings when reading to fixed-length character arrays). Truncation is also an information about the data and as such it's better to have it in addition to the data, not as part of it.</p>
-<p>Having said that, it is important to point at the <a href="../boost/">Integration with Boost</a> that allows to use <code>boost::optional&lt;T&gt;</code> to conveniently pack together the data and the information about its state.</p>
-<h2 id="q-overloaded-comma-operator-is-just-obfuscation-i-dont-like-it">Q: Overloaded comma operator is just obfuscation, I don't like it.</h2>
-<p>Well, consider the following:</p>
-<p>"Send the query X to the server Y <em>and</em> put result into variable Z."</p>
-<p>Above, the "and" plays a role of the comma. Even if overloading the comma operator is not a very popular practice in C++, some libraries do this, achieving terse and easy to learn syntax. We are pretty sure that in SOCI the comma operator was overloaded with a good effect.</p>
-<h2 id="q-the-operator-provides-a-bad-abstraction-for-the-input-statements">Q: The <code>operator&lt;&lt;</code> provides a bad abstraction for the "input" statements.</h2>
-<p>Indeed, the <code>operator&lt;&lt;</code> in the basic SOCI syntax shows that something (the query) is <em>sent</em> somewhere (to the server). Some people don't like this, especially when the "select" statements are involved. If the high-level idea is to <em>read</em>  data from somewhere, then <code>operator&lt;&lt;</code> seems unintuitive to the die-hard IOStreams users. The fact is, however, that the code containing SQL statement already indicates that there is a client-server relationship with some other software component (very likely remote). In such code it does not make any sense to pretend that the communication is one-way only, because it's clear that even the "select" statements need to be <em>sent</em> somewhere. This approach is also more uniform and allows to cover other statements like "drop table" or alike, where no data is expected to be exchanged at all (and therefore the IOStreams analogies for data exchange have no sense at all). No matter what is the kind of the SQL statement, it is <em>sent</em>  to the server and this "sending" justifies the choice of <code>operator&lt;&lt;</code>.</p>
-<p>Using different operators (<code>operator&gt;&gt;</code> and <code>operator&lt;&lt;</code>) as a way of distinguishing between different high-level ideas (<em>reading</em> and <em>writing</em> from the data store, respectively) does make sense on much higher level of abstraction, where the SQL statement itself is already hidden - and we do encourage programmers to use SOCI for implementing such high-level abstractions. For this, the object-relational mapping facilities available in SOCI might prove to be a valuable tool as well, as an effective bridge
-between the low-level world of SQL statements and the high-level world of user-defined abstract data types.</p>
-<h2 id="q-why-the-boost-license">Q: Why the Boost license?</h2>
-<p>We decided to use the <a href="http://www.boost.org/LICENSE_1_0.txt">Boost license</a>, because
-it's well recognized in the C++ community, allows us to keep our minimum copyrights, and at the same time allows SOCI to be safely used in commercial projects, without imposing concerns (or just plainuncertainty) typical to other open source licenses, like GPL. We also hope that by choosing the Boost license we have made the life easier
-for both us and our users. It saves us from answering law-related questions that were already answered on the <a href="http://www.boost.org/more/license_info.html">Boost license info page</a> and it should also give more confidence to our users - especially to those of them, who already accepted the conditions of the Boost license - the just have one license less to analyze.</p>
-<p>Still, if for any reason the conditions of this license are not acceptable, we encourage the users to contact us directly (see <a href="http://soci.sourceforge.net/people.html">links</a> on the relevant SOCI page) to discuss any remaining concerns.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/fonts/fontawesome-webfont.eot b/docs/fonts/fontawesome-webfont.eot
deleted file mode 100644
index e9f60ca..0000000
Binary files a/docs/fonts/fontawesome-webfont.eot and /dev/null differ
diff --git a/docs/fonts/fontawesome-webfont.svg b/docs/fonts/fontawesome-webfont.svg
deleted file mode 100644
index 855c845..0000000
--- a/docs/fonts/fontawesome-webfont.svg
+++ /dev/null
@@ -1,2671 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
-<svg>
-<metadata>
-Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016
- By ,,,
-Copyright Dave Gandy 2016. All rights reserved.
-</metadata>
-<defs>
-<font id="FontAwesome" horiz-adv-x="1536" >
-  <font-face 
-    font-family="FontAwesome"
-    font-weight="400"
-    font-stretch="normal"
-    units-per-em="1792"
-    panose-1="0 0 0 0 0 0 0 0 0 0"
-    ascent="1536"
-    descent="-256"
-    bbox="-1.02083 -256.962 2304.6 1537.02"
-    underline-thickness="0"
-    underline-position="0"
-    unicode-range="U+0020-F500"
-  />
-<missing-glyph horiz-adv-x="896" 
-d="M224 112h448v1312h-448v-1312zM112 0v1536h672v-1536h-672z" />
-    <glyph glyph-name=".notdef" horiz-adv-x="896" 
-d="M224 112h448v1312h-448v-1312zM112 0v1536h672v-1536h-672z" />
-    <glyph glyph-name=".null" horiz-adv-x="0" 
- />
-    <glyph glyph-name="nonmarkingreturn" horiz-adv-x="597" 
- />
-    <glyph glyph-name="space" unicode=" " horiz-adv-x="448" 
- />
-    <glyph glyph-name="dieresis" unicode="&#xa8;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="copyright" unicode="&#xa9;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="registered" unicode="&#xae;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="acute" unicode="&#xb4;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="AE" unicode="&#xc6;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="Oslash" unicode="&#xd8;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="trademark" unicode="&#x2122;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="infinity" unicode="&#x221e;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="notequal" unicode="&#x2260;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="glass" unicode="&#xf000;" horiz-adv-x="1792" 
-d="M1699 1350q0 -35 -43 -78l-632 -632v-768h320q26 0 45 -19t19 -45t-19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45t45 19h320v768l-632 632q-43 43 -43 78q0 23 18 36.5t38 17.5t43 4h1408q23 0 43 -4t38 -17.5t18 -36.5z" />
-    <glyph glyph-name="music" unicode="&#xf001;" 
-d="M1536 1312v-1120q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v537l-768 -237v-709q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89
-t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v967q0 31 19 56.5t49 35.5l832 256q12 4 28 4q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="search" unicode="&#xf002;" horiz-adv-x="1664" 
-d="M1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -52 -38 -90t-90 -38q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5
-t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
-    <glyph glyph-name="envelope" unicode="&#xf003;" horiz-adv-x="1792" 
-d="M1664 32v768q-32 -36 -69 -66q-268 -206 -426 -338q-51 -43 -83 -67t-86.5 -48.5t-102.5 -24.5h-1h-1q-48 0 -102.5 24.5t-86.5 48.5t-83 67q-158 132 -426 338q-37 30 -69 66v-768q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1664 1083v11v13.5t-0.5 13
-t-3 12.5t-5.5 9t-9 7.5t-14 2.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5q0 -168 147 -284q193 -152 401 -317q6 -5 35 -29.5t46 -37.5t44.5 -31.5t50.5 -27.5t43 -9h1h1q20 0 43 9t50.5 27.5t44.5 31.5t46 37.5t35 29.5q208 165 401 317q54 43 100.5 115.5t46.5 131.5z
-M1792 1120v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="heart" unicode="&#xf004;" horiz-adv-x="1792" 
-d="M896 -128q-26 0 -44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124t127 -344q0 -221 -229 -450l-623 -600
-q-18 -18 -44 -18z" />
-    <glyph glyph-name="star" unicode="&#xf005;" horiz-adv-x="1664" 
-d="M1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -21 -10.5 -35.5t-30.5 -14.5q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455
-l502 -73q56 -9 56 -46z" />
-    <glyph glyph-name="star_empty" unicode="&#xf006;" horiz-adv-x="1664" 
-d="M1137 532l306 297l-422 62l-189 382l-189 -382l-422 -62l306 -297l-73 -421l378 199l377 -199zM1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -50 -41 -50q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500
-l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455l502 -73q56 -9 56 -46z" />
-    <glyph glyph-name="user" unicode="&#xf007;" horiz-adv-x="1280" 
-d="M1280 137q0 -109 -62.5 -187t-150.5 -78h-854q-88 0 -150.5 78t-62.5 187q0 85 8.5 160.5t31.5 152t58.5 131t94 89t134.5 34.5q131 -128 313 -128t313 128q76 0 134.5 -34.5t94 -89t58.5 -131t31.5 -152t8.5 -160.5zM1024 1024q0 -159 -112.5 -271.5t-271.5 -112.5
-t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="film" unicode="&#xf008;" horiz-adv-x="1920" 
-d="M384 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 320v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 704v128q0 26 -19 45t-45 19h-128
-q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 -64v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM384 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45
-t45 -19h128q26 0 45 19t19 45zM1792 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 704v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1792 320v128
-q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 704v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19
-t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1920 1248v-1344q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1344q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="th_large" unicode="&#xf009;" horiz-adv-x="1664" 
-d="M768 512v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM768 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 512v-384q0 -52 -38 -90t-90 -38
-h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="th" unicode="&#xf00a;" horiz-adv-x="1792" 
-d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 288v-192q0 -40 -28 -68t-68 -28h-320
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28
-h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192
-q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="th_list" unicode="&#xf00b;" horiz-adv-x="1792" 
-d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-960
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28
-h960q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="ok" unicode="&#xf00c;" horiz-adv-x="1792" 
-d="M1671 970q0 -40 -28 -68l-724 -724l-136 -136q-28 -28 -68 -28t-68 28l-136 136l-362 362q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -295l656 657q28 28 68 28t68 -28l136 -136q28 -28 28 -68z" />
-    <glyph glyph-name="remove" unicode="&#xf00d;" horiz-adv-x="1408" 
-d="M1298 214q0 -40 -28 -68l-136 -136q-28 -28 -68 -28t-68 28l-294 294l-294 -294q-28 -28 -68 -28t-68 28l-136 136q-28 28 -28 68t28 68l294 294l-294 294q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -294l294 294q28 28 68 28t68 -28l136 -136q28 -28 28 -68
-t-28 -68l-294 -294l294 -294q28 -28 28 -68z" />
-    <glyph glyph-name="zoom_in" unicode="&#xf00e;" horiz-adv-x="1664" 
-d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-224q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v224h-224q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h224v224q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5v-224h224
-q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5
-t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
-    <glyph glyph-name="zoom_out" unicode="&#xf010;" horiz-adv-x="1664" 
-d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-576q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h576q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5z
-M1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z
-" />
-    <glyph glyph-name="off" unicode="&#xf011;" 
-d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61t-298 61t-245 164t-164 245t-61 298q0 182 80.5 343t226.5 270q43 32 95.5 25t83.5 -50q32 -42 24.5 -94.5t-49.5 -84.5q-98 -74 -151.5 -181t-53.5 -228q0 -104 40.5 -198.5t109.5 -163.5t163.5 -109.5
-t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5q0 121 -53.5 228t-151.5 181q-42 32 -49.5 84.5t24.5 94.5q31 43 84 50t95 -25q146 -109 226.5 -270t80.5 -343zM896 1408v-640q0 -52 -38 -90t-90 -38t-90 38t-38 90v640q0 52 38 90t90 38t90 -38t38 -90z" />
-    <glyph glyph-name="signal" unicode="&#xf012;" horiz-adv-x="1792" 
-d="M256 96v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 224v-320q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 480v-576q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23
-v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1408 864v-960q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1376v-1472q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1472q0 14 9 23t23 9h192q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="cog" unicode="&#xf013;" 
-d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1536 749v-222q0 -12 -8 -23t-20 -13l-185 -28q-19 -54 -39 -91q35 -50 107 -138q10 -12 10 -25t-9 -23q-27 -37 -99 -108t-94 -71q-12 0 -26 9l-138 108q-44 -23 -91 -38
-q-16 -136 -29 -186q-7 -28 -36 -28h-222q-14 0 -24.5 8.5t-11.5 21.5l-28 184q-49 16 -90 37l-141 -107q-10 -9 -25 -9q-14 0 -25 11q-126 114 -165 168q-7 10 -7 23q0 12 8 23q15 21 51 66.5t54 70.5q-27 50 -41 99l-183 27q-13 2 -21 12.5t-8 23.5v222q0 12 8 23t19 13
-l186 28q14 46 39 92q-40 57 -107 138q-10 12 -10 24q0 10 9 23q26 36 98.5 107.5t94.5 71.5q13 0 26 -10l138 -107q44 23 91 38q16 136 29 186q7 28 36 28h222q14 0 24.5 -8.5t11.5 -21.5l28 -184q49 -16 90 -37l142 107q9 9 24 9q13 0 25 -10q129 -119 165 -170q7 -8 7 -22
-q0 -12 -8 -23q-15 -21 -51 -66.5t-54 -70.5q26 -50 41 -98l183 -28q13 -2 21 -12.5t8 -23.5z" />
-    <glyph glyph-name="trash" unicode="&#xf014;" horiz-adv-x="1408" 
-d="M512 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM768 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1024 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576
-q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1152 76v948h-896v-948q0 -22 7 -40.5t14.5 -27t10.5 -8.5h832q3 0 10.5 8.5t14.5 27t7 40.5zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832
-q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="home" unicode="&#xf015;" horiz-adv-x="1664" 
-d="M1408 544v-480q0 -26 -19 -45t-45 -19h-384v384h-256v-384h-384q-26 0 -45 19t-19 45v480q0 1 0.5 3t0.5 3l575 474l575 -474q1 -2 1 -6zM1631 613l-62 -74q-8 -9 -21 -11h-3q-13 0 -21 7l-692 577l-692 -577q-12 -8 -24 -7q-13 2 -21 11l-62 74q-8 10 -7 23.5t11 21.5
-l719 599q32 26 76 26t76 -26l244 -204v195q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-408l219 -182q10 -8 11 -21.5t-7 -23.5z" />
-    <glyph glyph-name="file_alt" unicode="&#xf016;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-" />
-    <glyph glyph-name="time" unicode="&#xf017;" 
-d="M896 992v-448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="road" unicode="&#xf018;" horiz-adv-x="1920" 
-d="M1111 540v4l-24 320q-1 13 -11 22.5t-23 9.5h-186q-13 0 -23 -9.5t-11 -22.5l-24 -320v-4q-1 -12 8 -20t21 -8h244q12 0 21 8t8 20zM1870 73q0 -73 -46 -73h-704q13 0 22 9.5t8 22.5l-20 256q-1 13 -11 22.5t-23 9.5h-272q-13 0 -23 -9.5t-11 -22.5l-20 -256
-q-1 -13 8 -22.5t22 -9.5h-704q-46 0 -46 73q0 54 26 116l417 1044q8 19 26 33t38 14h339q-13 0 -23 -9.5t-11 -22.5l-15 -192q-1 -14 8 -23t22 -9h166q13 0 22 9t8 23l-15 192q-1 13 -11 22.5t-23 9.5h339q20 0 38 -14t26 -33l417 -1044q26 -62 26 -116z" />
-    <glyph glyph-name="download_alt" unicode="&#xf019;" horiz-adv-x="1664" 
-d="M1280 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 416v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h465l135 -136
-q58 -56 136 -56t136 56l136 136h464q40 0 68 -28t28 -68zM1339 985q17 -41 -14 -70l-448 -448q-18 -19 -45 -19t-45 19l-448 448q-31 29 -14 70q17 39 59 39h256v448q0 26 19 45t45 19h256q26 0 45 -19t19 -45v-448h256q42 0 59 -39z" />
-    <glyph glyph-name="download" unicode="&#xf01a;" 
-d="M1120 608q0 -12 -10 -24l-319 -319q-11 -9 -23 -9t-23 9l-320 320q-15 16 -7 35q8 20 30 20h192v352q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-352h192q14 0 23 -9t9 -23zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273
-t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="upload" unicode="&#xf01b;" 
-d="M1118 660q-8 -20 -30 -20h-192v-352q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v352h-192q-14 0 -23 9t-9 23q0 12 10 24l319 319q11 9 23 9t23 -9l320 -320q15 -16 7 -35zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198
-t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="inbox" unicode="&#xf01c;" 
-d="M1023 576h316q-1 3 -2.5 8.5t-2.5 7.5l-212 496h-708l-212 -496q-1 -3 -2.5 -8.5t-2.5 -7.5h316l95 -192h320zM1536 546v-482q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v482q0 62 25 123l238 552q10 25 36.5 42t52.5 17h832q26 0 52.5 -17t36.5 -42l238 -552
-q25 -61 25 -123z" />
-    <glyph glyph-name="play_circle" unicode="&#xf01d;" 
-d="M1184 640q0 -37 -32 -55l-544 -320q-15 -9 -32 -9q-16 0 -32 8q-32 19 -32 56v640q0 37 32 56q33 18 64 -1l544 -320q32 -18 32 -55zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="repeat" unicode="&#xf01e;" 
-d="M1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l138 138q-148 137 -349 137q-104 0 -198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5q119 0 225 52t179 147q7 10 23 12q15 0 25 -9
-l137 -138q9 -8 9.5 -20.5t-7.5 -22.5q-109 -132 -264 -204.5t-327 -72.5q-156 0 -298 61t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q147 0 284.5 -55.5t244.5 -156.5l130 129q29 31 70 14q39 -17 39 -59z" />
-    <glyph glyph-name="refresh" unicode="&#xf021;" 
-d="M1511 480q0 -5 -1 -7q-64 -268 -268 -434.5t-478 -166.5q-146 0 -282.5 55t-243.5 157l-129 -129q-19 -19 -45 -19t-45 19t-19 45v448q0 26 19 45t45 19h448q26 0 45 -19t19 -45t-19 -45l-137 -137q71 -66 161 -102t187 -36q134 0 250 65t186 179q11 17 53 117
-q8 23 30 23h192q13 0 22.5 -9.5t9.5 -22.5zM1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-26 0 -45 19t-19 45t19 45l138 138q-148 137 -349 137q-134 0 -250 -65t-186 -179q-11 -17 -53 -117q-8 -23 -30 -23h-199q-13 0 -22.5 9.5t-9.5 22.5v7q65 268 270 434.5t480 166.5
-q146 0 284 -55.5t245 -156.5l130 129q19 19 45 19t45 -19t19 -45z" />
-    <glyph glyph-name="list_alt" unicode="&#xf022;" horiz-adv-x="1792" 
-d="M384 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M384 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1536 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5z
-M1536 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5zM1536 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5
-t9.5 -22.5zM1664 160v832q0 13 -9.5 22.5t-22.5 9.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 1248v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47
-t47 -113z" />
-    <glyph glyph-name="lock" unicode="&#xf023;" horiz-adv-x="1152" 
-d="M320 768h512v192q0 106 -75 181t-181 75t-181 -75t-75 -181v-192zM1152 672v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v192q0 184 132 316t316 132t316 -132t132 -316v-192h32q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="flag" unicode="&#xf024;" horiz-adv-x="1792" 
-d="M320 1280q0 -72 -64 -110v-1266q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v1266q-64 38 -64 110q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -25 -12.5 -38.5t-39.5 -27.5q-215 -116 -369 -116q-61 0 -123.5 22t-108.5 48
-t-115.5 48t-142.5 22q-192 0 -464 -146q-17 -9 -33 -9q-26 0 -45 19t-19 45v742q0 32 31 55q21 14 79 43q236 120 421 120q107 0 200 -29t219 -88q38 -19 88 -19q54 0 117.5 21t110 47t88 47t54.5 21q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="headphones" unicode="&#xf025;" horiz-adv-x="1664" 
-d="M1664 650q0 -166 -60 -314l-20 -49l-185 -33q-22 -83 -90.5 -136.5t-156.5 -53.5v-32q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-32q71 0 130 -35.5t93 -95.5l68 12q29 95 29 193q0 148 -88 279t-236.5 209t-315.5 78
-t-315.5 -78t-236.5 -209t-88 -279q0 -98 29 -193l68 -12q34 60 93 95.5t130 35.5v32q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v32q-88 0 -156.5 53.5t-90.5 136.5l-185 33l-20 49q-60 148 -60 314q0 151 67 291t179 242.5
-t266 163.5t320 61t320 -61t266 -163.5t179 -242.5t67 -291z" />
-    <glyph glyph-name="volume_off" unicode="&#xf026;" horiz-adv-x="768" 
-d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45z" />
-    <glyph glyph-name="volume_down" unicode="&#xf027;" horiz-adv-x="1152" 
-d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 36
-t12 56.5t-12 56.5t-29 36t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142z" />
-    <glyph glyph-name="volume_up" unicode="&#xf028;" horiz-adv-x="1664" 
-d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 36
-t12 56.5t-12 56.5t-29 36t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142zM1408 640q0 -153 -85 -282.5t-225 -188.5q-13 -5 -25 -5q-27 0 -46 19t-19 45q0 39 39 59q56 29 76 44q74 54 115.5 135.5t41.5 173.5t-41.5 173.5
-t-115.5 135.5q-20 15 -76 44q-39 20 -39 59q0 26 19 45t45 19q13 0 26 -5q140 -59 225 -188.5t85 -282.5zM1664 640q0 -230 -127 -422.5t-338 -283.5q-13 -5 -26 -5q-26 0 -45 19t-19 45q0 36 39 59q7 4 22.5 10.5t22.5 10.5q46 25 82 51q123 91 192 227t69 289t-69 289
-t-192 227q-36 26 -82 51q-7 4 -22.5 10.5t-22.5 10.5q-39 23 -39 59q0 26 19 45t45 19q13 0 26 -5q211 -91 338 -283.5t127 -422.5z" />
-    <glyph glyph-name="qrcode" unicode="&#xf029;" horiz-adv-x="1408" 
-d="M384 384v-128h-128v128h128zM384 1152v-128h-128v128h128zM1152 1152v-128h-128v128h128zM128 129h384v383h-384v-383zM128 896h384v384h-384v-384zM896 896h384v384h-384v-384zM640 640v-640h-640v640h640zM1152 128v-128h-128v128h128zM1408 128v-128h-128v128h128z
-M1408 640v-384h-384v128h-128v-384h-128v640h384v-128h128v128h128zM640 1408v-640h-640v640h640zM1408 1408v-640h-640v640h640z" />
-    <glyph glyph-name="barcode" unicode="&#xf02a;" horiz-adv-x="1792" 
-d="M63 0h-63v1408h63v-1408zM126 1h-32v1407h32v-1407zM220 1h-31v1407h31v-1407zM377 1h-31v1407h31v-1407zM534 1h-62v1407h62v-1407zM660 1h-31v1407h31v-1407zM723 1h-31v1407h31v-1407zM786 1h-31v1407h31v-1407zM943 1h-63v1407h63v-1407zM1100 1h-63v1407h63v-1407z
-M1226 1h-63v1407h63v-1407zM1352 1h-63v1407h63v-1407zM1446 1h-63v1407h63v-1407zM1635 1h-94v1407h94v-1407zM1698 1h-32v1407h32v-1407zM1792 0h-63v1408h63v-1408z" />
-    <glyph glyph-name="tag" unicode="&#xf02b;" 
-d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5
-l715 -714q37 -39 37 -91z" />
-    <glyph glyph-name="tags" unicode="&#xf02c;" horiz-adv-x="1920" 
-d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5
-l715 -714q37 -39 37 -91zM1899 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-36 0 -59 14t-53 45l470 470q37 37 37 90q0 52 -37 91l-715 714q-38 38 -102 64.5t-117 26.5h224q53 0 117 -26.5t102 -64.5l715 -714q37 -39 37 -91z" />
-    <glyph glyph-name="book" unicode="&#xf02d;" horiz-adv-x="1664" 
-d="M1639 1058q40 -57 18 -129l-275 -906q-19 -64 -76.5 -107.5t-122.5 -43.5h-923q-77 0 -148.5 53.5t-99.5 131.5q-24 67 -2 127q0 4 3 27t4 37q1 8 -3 21.5t-3 19.5q2 11 8 21t16.5 23.5t16.5 23.5q23 38 45 91.5t30 91.5q3 10 0.5 30t-0.5 28q3 11 17 28t17 23
-q21 36 42 92t25 90q1 9 -2.5 32t0.5 28q4 13 22 30.5t22 22.5q19 26 42.5 84.5t27.5 96.5q1 8 -3 25.5t-2 26.5q2 8 9 18t18 23t17 21q8 12 16.5 30.5t15 35t16 36t19.5 32t26.5 23.5t36 11.5t47.5 -5.5l-1 -3q38 9 51 9h761q74 0 114 -56t18 -130l-274 -906
-q-36 -119 -71.5 -153.5t-128.5 -34.5h-869q-27 0 -38 -15q-11 -16 -1 -43q24 -70 144 -70h923q29 0 56 15.5t35 41.5l300 987q7 22 5 57q38 -15 59 -43zM575 1056q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5
-t-16.5 -22.5zM492 800q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5t-16.5 -22.5z" />
-    <glyph glyph-name="bookmark" unicode="&#xf02e;" horiz-adv-x="1280" 
-d="M1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
-    <glyph glyph-name="print" unicode="&#xf02f;" horiz-adv-x="1664" 
-d="M384 0h896v256h-896v-256zM384 640h896v384h-160q-40 0 -68 28t-28 68v160h-640v-640zM1536 576q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 576v-416q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-160q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68
-v160h-224q-13 0 -22.5 9.5t-9.5 22.5v416q0 79 56.5 135.5t135.5 56.5h64v544q0 40 28 68t68 28h672q40 0 88 -20t76 -48l152 -152q28 -28 48 -76t20 -88v-256h64q79 0 135.5 -56.5t56.5 -135.5z" />
-    <glyph glyph-name="camera" unicode="&#xf030;" horiz-adv-x="1920" 
-d="M960 864q119 0 203.5 -84.5t84.5 -203.5t-84.5 -203.5t-203.5 -84.5t-203.5 84.5t-84.5 203.5t84.5 203.5t203.5 84.5zM1664 1280q106 0 181 -75t75 -181v-896q0 -106 -75 -181t-181 -75h-1408q-106 0 -181 75t-75 181v896q0 106 75 181t181 75h224l51 136
-q19 49 69.5 84.5t103.5 35.5h512q53 0 103.5 -35.5t69.5 -84.5l51 -136h224zM960 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="font" unicode="&#xf031;" horiz-adv-x="1664" 
-d="M725 977l-170 -450q33 0 136.5 -2t160.5 -2q19 0 57 2q-87 253 -184 452zM0 -128l2 79q23 7 56 12.5t57 10.5t49.5 14.5t44.5 29t31 50.5l237 616l280 724h75h53q8 -14 11 -21l205 -480q33 -78 106 -257.5t114 -274.5q15 -34 58 -144.5t72 -168.5q20 -45 35 -57
-q19 -15 88 -29.5t84 -20.5q6 -38 6 -57q0 -5 -0.5 -13.5t-0.5 -12.5q-63 0 -190 8t-191 8q-76 0 -215 -7t-178 -8q0 43 4 78l131 28q1 0 12.5 2.5t15.5 3.5t14.5 4.5t15 6.5t11 8t9 11t2.5 14q0 16 -31 96.5t-72 177.5t-42 100l-450 2q-26 -58 -76.5 -195.5t-50.5 -162.5
-q0 -22 14 -37.5t43.5 -24.5t48.5 -13.5t57 -8.5t41 -4q1 -19 1 -58q0 -9 -2 -27q-58 0 -174.5 10t-174.5 10q-8 0 -26.5 -4t-21.5 -4q-80 -14 -188 -14z" />
-    <glyph glyph-name="bold" unicode="&#xf032;" horiz-adv-x="1408" 
-d="M555 15q74 -32 140 -32q376 0 376 335q0 114 -41 180q-27 44 -61.5 74t-67.5 46.5t-80.5 25t-84 10.5t-94.5 2q-73 0 -101 -10q0 -53 -0.5 -159t-0.5 -158q0 -8 -1 -67.5t-0.5 -96.5t4.5 -83.5t12 -66.5zM541 761q42 -7 109 -7q82 0 143 13t110 44.5t74.5 89.5t25.5 142
-q0 70 -29 122.5t-79 82t-108 43.5t-124 14q-50 0 -130 -13q0 -50 4 -151t4 -152q0 -27 -0.5 -80t-0.5 -79q0 -46 1 -69zM0 -128l2 94q15 4 85 16t106 27q7 12 12.5 27t8.5 33.5t5.5 32.5t3 37.5t0.5 34v35.5v30q0 982 -22 1025q-4 8 -22 14.5t-44.5 11t-49.5 7t-48.5 4.5
-t-30.5 3l-4 83q98 2 340 11.5t373 9.5q23 0 68 -0.5t68 -0.5q70 0 136.5 -13t128.5 -42t108 -71t74 -104.5t28 -137.5q0 -52 -16.5 -95.5t-39 -72t-64.5 -57.5t-73 -45t-84 -40q154 -35 256.5 -134t102.5 -248q0 -100 -35 -179.5t-93.5 -130.5t-138 -85.5t-163.5 -48.5
-t-176 -14q-44 0 -132 3t-132 3q-106 0 -307 -11t-231 -12z" />
-    <glyph glyph-name="italic" unicode="&#xf033;" horiz-adv-x="1024" 
-d="M0 -126l17 85q22 7 61.5 16.5t72 19t59.5 23.5q28 35 41 101q1 7 62 289t114 543.5t52 296.5v25q-24 13 -54.5 18.5t-69.5 8t-58 5.5l19 103q33 -2 120 -6.5t149.5 -7t120.5 -2.5q48 0 98.5 2.5t121 7t98.5 6.5q-5 -39 -19 -89q-30 -10 -101.5 -28.5t-108.5 -33.5
-q-8 -19 -14 -42.5t-9 -40t-7.5 -45.5t-6.5 -42q-27 -148 -87.5 -419.5t-77.5 -355.5q-2 -9 -13 -58t-20 -90t-16 -83.5t-6 -57.5l1 -18q17 -4 185 -31q-3 -44 -16 -99q-11 0 -32.5 -1.5t-32.5 -1.5q-29 0 -87 10t-86 10q-138 2 -206 2q-51 0 -143 -9t-121 -11z" />
-    <glyph glyph-name="text_height" unicode="&#xf034;" horiz-adv-x="1792" 
-d="M1744 128q33 0 42 -18.5t-11 -44.5l-126 -162q-20 -26 -49 -26t-49 26l-126 162q-20 26 -11 44.5t42 18.5h80v1024h-80q-33 0 -42 18.5t11 44.5l126 162q20 26 49 26t49 -26l126 -162q20 -26 11 -44.5t-42 -18.5h-80v-1024h80zM81 1407l54 -27q12 -5 211 -5q44 0 132 2
-t132 2q36 0 107.5 -0.5t107.5 -0.5h293q6 0 21 -0.5t20.5 0t16 3t17.5 9t15 17.5l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 48t-14.5 73.5t-7.5 35.5q-6 8 -12 12.5t-15.5 6t-13 2.5t-18 0.5t-16.5 -0.5
-q-17 0 -66.5 0.5t-74.5 0.5t-64 -2t-71 -6q-9 -81 -8 -136q0 -94 2 -388t2 -455q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27
-q19 42 19 383q0 101 -3 303t-3 303v117q0 2 0.5 15.5t0.5 25t-1 25.5t-3 24t-5 14q-11 12 -162 12q-33 0 -93 -12t-80 -26q-19 -13 -34 -72.5t-31.5 -111t-42.5 -53.5q-42 26 -56 44v383z" />
-    <glyph glyph-name="text_width" unicode="&#xf035;" 
-d="M81 1407l54 -27q12 -5 211 -5q44 0 132 2t132 2q70 0 246.5 1t304.5 0.5t247 -4.5q33 -1 56 31l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 47.5t-15 73.5t-7 36q-10 13 -27 19q-5 2 -66 2q-30 0 -93 1t-103 1
-t-94 -2t-96 -7q-9 -81 -8 -136l1 -152v52q0 -55 1 -154t1.5 -180t0.5 -153q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27
-q7 16 11.5 74t6 145.5t1.5 155t-0.5 153.5t-0.5 89q0 7 -2.5 21.5t-2.5 22.5q0 7 0.5 44t1 73t0 76.5t-3 67.5t-6.5 32q-11 12 -162 12q-41 0 -163 -13.5t-138 -24.5q-19 -12 -34 -71.5t-31.5 -111.5t-42.5 -54q-42 26 -56 44v383zM1310 125q12 0 42 -19.5t57.5 -41.5
-t59.5 -49t36 -30q26 -21 26 -49t-26 -49q-4 -3 -36 -30t-59.5 -49t-57.5 -41.5t-42 -19.5q-13 0 -20.5 10.5t-10 28.5t-2.5 33.5t1.5 33t1.5 19.5h-1024q0 -2 1.5 -19.5t1.5 -33t-2.5 -33.5t-10 -28.5t-20.5 -10.5q-12 0 -42 19.5t-57.5 41.5t-59.5 49t-36 30q-26 21 -26 49
-t26 49q4 3 36 30t59.5 49t57.5 41.5t42 19.5q13 0 20.5 -10.5t10 -28.5t2.5 -33.5t-1.5 -33t-1.5 -19.5h1024q0 2 -1.5 19.5t-1.5 33t2.5 33.5t10 28.5t20.5 10.5z" />
-    <glyph glyph-name="align_left" unicode="&#xf036;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45
-t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="align_center" unicode="&#xf037;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h896q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45t-45 -19
-h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h640q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="align_right" unicode="&#xf038;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45
-t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="align_justify" unicode="&#xf039;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45
-t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="list" unicode="&#xf03a;" horiz-adv-x="1792" 
-d="M256 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM256 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5
-t9.5 -22.5zM256 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344
-q13 0 22.5 -9.5t9.5 -22.5zM256 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5
-t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192
-q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="indent_left" unicode="&#xf03b;" horiz-adv-x="1792" 
-d="M384 992v-576q0 -13 -9.5 -22.5t-22.5 -9.5q-14 0 -23 9l-288 288q-9 9 -9 23t9 23l288 288q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5
-t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088
-q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="indent_right" unicode="&#xf03c;" horiz-adv-x="1792" 
-d="M352 704q0 -14 -9 -23l-288 -288q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v576q0 13 9.5 22.5t22.5 9.5q14 0 23 -9l288 -288q9 -9 9 -23zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5
-t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088
-q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="facetime_video" unicode="&#xf03d;" horiz-adv-x="1792" 
-d="M1792 1184v-1088q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-403 403v-166q0 -119 -84.5 -203.5t-203.5 -84.5h-704q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h704q119 0 203.5 -84.5t84.5 -203.5v-165l403 402q18 19 45 19q12 0 25 -5
-q39 -17 39 -59z" />
-    <glyph glyph-name="picture" unicode="&#xf03e;" horiz-adv-x="1920" 
-d="M640 960q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 576v-448h-1408v192l320 320l160 -160l512 512zM1760 1280h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5v1216
-q0 13 -9.5 22.5t-22.5 9.5zM1920 1248v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="pencil" unicode="&#xf040;" 
-d="M363 0l91 91l-235 235l-91 -91v-107h128v-128h107zM886 928q0 22 -22 22q-10 0 -17 -7l-542 -542q-7 -7 -7 -17q0 -22 22 -22q10 0 17 7l542 542q7 7 7 17zM832 1120l416 -416l-832 -832h-416v416zM1515 1024q0 -53 -37 -90l-166 -166l-416 416l166 165q36 38 90 38
-q53 0 91 -38l235 -234q37 -39 37 -91z" />
-    <glyph glyph-name="map_marker" unicode="&#xf041;" horiz-adv-x="1024" 
-d="M768 896q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1024 896q0 -109 -33 -179l-364 -774q-16 -33 -47.5 -52t-67.5 -19t-67.5 19t-46.5 52l-365 774q-33 70 -33 179q0 212 150 362t362 150t362 -150t150 -362z" />
-    <glyph glyph-name="adjust" unicode="&#xf042;" 
-d="M768 96v1088q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="tint" unicode="&#xf043;" horiz-adv-x="1024" 
-d="M512 384q0 36 -20 69q-1 1 -15.5 22.5t-25.5 38t-25 44t-21 50.5q-4 16 -21 16t-21 -16q-7 -23 -21 -50.5t-25 -44t-25.5 -38t-15.5 -22.5q-20 -33 -20 -69q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 512q0 -212 -150 -362t-362 -150t-362 150t-150 362
-q0 145 81 275q6 9 62.5 90.5t101 151t99.5 178t83 201.5q9 30 34 47t51 17t51.5 -17t33.5 -47q28 -93 83 -201.5t99.5 -178t101 -151t62.5 -90.5q81 -127 81 -275z" />
-    <glyph glyph-name="edit" unicode="&#xf044;" horiz-adv-x="1792" 
-d="M888 352l116 116l-152 152l-116 -116v-56h96v-96h56zM1328 1072q-16 16 -33 -1l-350 -350q-17 -17 -1 -33t33 1l350 350q17 17 1 33zM1408 478v-190q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832
-q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-14 -14 -32 -8q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v126q0 13 9 22l64 64q15 15 35 7t20 -29zM1312 1216l288 -288l-672 -672h-288v288zM1756 1084l-92 -92
-l-288 288l92 92q28 28 68 28t68 -28l152 -152q28 -28 28 -68t-28 -68z" />
-    <glyph glyph-name="share" unicode="&#xf045;" horiz-adv-x="1664" 
-d="M1408 547v-259q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h255v0q13 0 22.5 -9.5t9.5 -22.5q0 -27 -26 -32q-77 -26 -133 -60q-10 -4 -16 -4h-112q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832
-q66 0 113 47t47 113v214q0 19 18 29q28 13 54 37q16 16 35 8q21 -9 21 -29zM1645 1043l-384 -384q-18 -19 -45 -19q-12 0 -25 5q-39 17 -39 59v192h-160q-323 0 -438 -131q-119 -137 -74 -473q3 -23 -20 -34q-8 -2 -12 -2q-16 0 -26 13q-10 14 -21 31t-39.5 68.5t-49.5 99.5
-t-38.5 114t-17.5 122q0 49 3.5 91t14 90t28 88t47 81.5t68.5 74t94.5 61.5t124.5 48.5t159.5 30.5t196.5 11h160v192q0 42 39 59q13 5 25 5q26 0 45 -19l384 -384q19 -19 19 -45t-19 -45z" />
-    <glyph glyph-name="check" unicode="&#xf046;" horiz-adv-x="1664" 
-d="M1408 606v-318q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-10 -10 -23 -10q-3 0 -9 2q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832
-q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v254q0 13 9 22l64 64q10 10 23 10q6 0 12 -3q20 -8 20 -29zM1639 1095l-814 -814q-24 -24 -57 -24t-57 24l-430 430q-24 24 -24 57t24 57l110 110q24 24 57 24t57 -24l263 -263l647 647q24 24 57 24t57 -24l110 -110
-q24 -24 24 -57t-24 -57z" />
-    <glyph glyph-name="move" unicode="&#xf047;" horiz-adv-x="1792" 
-d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-384v-384h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v384h-384v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45
-t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h384v384h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45t-19 -45t-45 -19h-128v-384h384v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
-    <glyph glyph-name="step_backward" unicode="&#xf048;" horiz-adv-x="1024" 
-d="M979 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 10 13 19z" />
-    <glyph glyph-name="fast_backward" unicode="&#xf049;" horiz-adv-x="1792" 
-d="M1747 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 10 13 19l710 710
-q19 19 32 13t13 -32v-710q4 10 13 19z" />
-    <glyph glyph-name="backward" unicode="&#xf04a;" horiz-adv-x="1664" 
-d="M1619 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-19 19 -19 45t19 45l710 710q19 19 32 13t13 -32v-710q4 10 13 19z" />
-    <glyph glyph-name="play" unicode="&#xf04b;" horiz-adv-x="1408" 
-d="M1384 609l-1328 -738q-23 -13 -39.5 -3t-16.5 36v1472q0 26 16.5 36t39.5 -3l1328 -738q23 -13 23 -31t-23 -31z" />
-    <glyph glyph-name="pause" unicode="&#xf04c;" 
-d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45zM640 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="stop" unicode="&#xf04d;" 
-d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="forward" unicode="&#xf04e;" horiz-adv-x="1664" 
-d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v710q0 26 13 32t32 -13l710 -710q19 -19 19 -45t-19 -45l-710 -710q-19 -19 -32 -13t-13 32v710q-4 -10 -13 -19z" />
-    <glyph glyph-name="fast_forward" unicode="&#xf050;" horiz-adv-x="1792" 
-d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v710q0 26 13 32t32 -13l710 -710q9 -9 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-4 -10 -13 -19l-710 -710
-q-19 -19 -32 -13t-13 32v710q-4 -10 -13 -19z" />
-    <glyph glyph-name="step_forward" unicode="&#xf051;" horiz-adv-x="1024" 
-d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-4 -10 -13 -19z" />
-    <glyph glyph-name="eject" unicode="&#xf052;" horiz-adv-x="1538" 
-d="M14 557l710 710q19 19 45 19t45 -19l710 -710q19 -19 13 -32t-32 -13h-1472q-26 0 -32 13t13 32zM1473 0h-1408q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1408q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19z" />
-    <glyph glyph-name="chevron_left" unicode="&#xf053;" horiz-adv-x="1280" 
-d="M1171 1235l-531 -531l531 -531q19 -19 19 -45t-19 -45l-166 -166q-19 -19 -45 -19t-45 19l-742 742q-19 19 -19 45t19 45l742 742q19 19 45 19t45 -19l166 -166q19 -19 19 -45t-19 -45z" />
-    <glyph glyph-name="chevron_right" unicode="&#xf054;" horiz-adv-x="1280" 
-d="M1107 659l-742 -742q-19 -19 -45 -19t-45 19l-166 166q-19 19 -19 45t19 45l531 531l-531 531q-19 19 -19 45t19 45l166 166q19 19 45 19t45 -19l742 -742q19 -19 19 -45t-19 -45z" />
-    <glyph glyph-name="plus_sign" unicode="&#xf055;" 
-d="M1216 576v128q0 26 -19 45t-45 19h-256v256q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-256h-256q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h256v-256q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v256h256q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5
-t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="minus_sign" unicode="&#xf056;" 
-d="M1216 576v128q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
-t103 -385.5z" />
-    <glyph glyph-name="remove_sign" unicode="&#xf057;" 
-d="M1149 414q0 26 -19 45l-181 181l181 181q19 19 19 45q0 27 -19 46l-90 90q-19 19 -46 19q-26 0 -45 -19l-181 -181l-181 181q-19 19 -45 19q-27 0 -46 -19l-90 -90q-19 -19 -19 -46q0 -26 19 -45l181 -181l-181 -181q-19 -19 -19 -45q0 -27 19 -46l90 -90q19 -19 46 -19
-q26 0 45 19l181 181l181 -181q19 -19 45 -19q27 0 46 19l90 90q19 19 19 46zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ok_sign" unicode="&#xf058;" 
-d="M1284 802q0 28 -18 46l-91 90q-19 19 -45 19t-45 -19l-408 -407l-226 226q-19 19 -45 19t-45 -19l-91 -90q-18 -18 -18 -46q0 -27 18 -45l362 -362q19 -19 45 -19q27 0 46 19l543 543q18 18 18 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="question_sign" unicode="&#xf059;" 
-d="M896 160v192q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1152 832q0 88 -55.5 163t-138.5 116t-170 41q-243 0 -371 -213q-15 -24 8 -42l132 -100q7 -6 19 -6q16 0 25 12q53 68 86 92q34 24 86 24q48 0 85.5 -26t37.5 -59
-q0 -38 -20 -61t-68 -45q-63 -28 -115.5 -86.5t-52.5 -125.5v-36q0 -14 9 -23t23 -9h192q14 0 23 9t9 23q0 19 21.5 49.5t54.5 49.5q32 18 49 28.5t46 35t44.5 48t28 60.5t12.5 81zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="info_sign" unicode="&#xf05a;" 
-d="M1024 160v160q0 14 -9 23t-23 9h-96v512q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h96v-320h-96q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h448q14 0 23 9t9 23zM896 1056v160q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23
-t23 -9h192q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="screenshot" unicode="&#xf05b;" 
-d="M1197 512h-109q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h109q-32 108 -112.5 188.5t-188.5 112.5v-109q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v109q-108 -32 -188.5 -112.5t-112.5 -188.5h109q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-109
-q32 -108 112.5 -188.5t188.5 -112.5v109q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-109q108 32 188.5 112.5t112.5 188.5zM1536 704v-128q0 -26 -19 -45t-45 -19h-143q-37 -161 -154.5 -278.5t-278.5 -154.5v-143q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v143
-q-161 37 -278.5 154.5t-154.5 278.5h-143q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h143q37 161 154.5 278.5t278.5 154.5v143q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-143q161 -37 278.5 -154.5t154.5 -278.5h143q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="remove_circle" unicode="&#xf05c;" 
-d="M1097 457l-146 -146q-10 -10 -23 -10t-23 10l-137 137l-137 -137q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l137 137l-137 137q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l137 -137l137 137q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23
-l-137 -137l137 -137q10 -10 10 -23t-10 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5
-t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ok_circle" unicode="&#xf05d;" 
-d="M1171 723l-422 -422q-19 -19 -45 -19t-45 19l-294 294q-19 19 -19 45t19 45l102 102q19 19 45 19t45 -19l147 -147l275 275q19 19 45 19t45 -19l102 -102q19 -19 19 -45t-19 -45zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198
-t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ban_circle" unicode="&#xf05e;" 
-d="M1312 643q0 161 -87 295l-754 -753q137 -89 297 -89q111 0 211.5 43.5t173.5 116.5t116 174.5t43 212.5zM313 344l755 754q-135 91 -300 91q-148 0 -273 -73t-198 -199t-73 -274q0 -162 89 -299zM1536 643q0 -157 -61 -300t-163.5 -246t-245 -164t-298.5 -61t-298.5 61
-t-245 164t-163.5 246t-61 300t61 299.5t163.5 245.5t245 164t298.5 61t298.5 -61t245 -164t163.5 -245.5t61 -299.5z" />
-    <glyph glyph-name="arrow_left" unicode="&#xf060;" 
-d="M1536 640v-128q0 -53 -32.5 -90.5t-84.5 -37.5h-704l293 -294q38 -36 38 -90t-38 -90l-75 -76q-37 -37 -90 -37q-52 0 -91 37l-651 652q-37 37 -37 90q0 52 37 91l651 650q38 38 91 38q52 0 90 -38l75 -74q38 -38 38 -91t-38 -91l-293 -293h704q52 0 84.5 -37.5
-t32.5 -90.5z" />
-    <glyph glyph-name="arrow_right" unicode="&#xf061;" 
-d="M1472 576q0 -54 -37 -91l-651 -651q-39 -37 -91 -37q-51 0 -90 37l-75 75q-38 38 -38 91t38 91l293 293h-704q-52 0 -84.5 37.5t-32.5 90.5v128q0 53 32.5 90.5t84.5 37.5h704l-293 294q-38 36 -38 90t38 90l75 75q38 38 90 38q53 0 91 -38l651 -651q37 -35 37 -90z" />
-    <glyph glyph-name="arrow_up" unicode="&#xf062;" horiz-adv-x="1664" 
-d="M1611 565q0 -51 -37 -90l-75 -75q-38 -38 -91 -38q-54 0 -90 38l-294 293v-704q0 -52 -37.5 -84.5t-90.5 -32.5h-128q-53 0 -90.5 32.5t-37.5 84.5v704l-294 -293q-36 -38 -90 -38t-90 38l-75 75q-38 38 -38 90q0 53 38 91l651 651q35 37 90 37q54 0 91 -37l651 -651
-q37 -39 37 -91z" />
-    <glyph glyph-name="arrow_down" unicode="&#xf063;" horiz-adv-x="1664" 
-d="M1611 704q0 -53 -37 -90l-651 -652q-39 -37 -91 -37q-53 0 -90 37l-651 652q-38 36 -38 90q0 53 38 91l74 75q39 37 91 37q53 0 90 -37l294 -294v704q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-704l294 294q37 37 90 37q52 0 91 -37l75 -75q37 -39 37 -91z" />
-    <glyph glyph-name="share_alt" unicode="&#xf064;" horiz-adv-x="1792" 
-d="M1792 896q0 -26 -19 -45l-512 -512q-19 -19 -45 -19t-45 19t-19 45v256h-224q-98 0 -175.5 -6t-154 -21.5t-133 -42.5t-105.5 -69.5t-80 -101t-48.5 -138.5t-17.5 -181q0 -55 5 -123q0 -6 2.5 -23.5t2.5 -26.5q0 -15 -8.5 -25t-23.5 -10q-16 0 -28 17q-7 9 -13 22
-t-13.5 30t-10.5 24q-127 285 -127 451q0 199 53 333q162 403 875 403h224v256q0 26 19 45t45 19t45 -19l512 -512q19 -19 19 -45z" />
-    <glyph glyph-name="resize_full" unicode="&#xf065;" 
-d="M755 480q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23zM1536 1344v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332
-q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="resize_small" unicode="&#xf066;" 
-d="M768 576v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45zM1523 1248q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45
-t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23z" />
-    <glyph glyph-name="plus" unicode="&#xf067;" horiz-adv-x="1408" 
-d="M1408 800v-192q0 -40 -28 -68t-68 -28h-416v-416q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v416h-416q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h416v416q0 40 28 68t68 28h192q40 0 68 -28t28 -68v-416h416q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="minus" unicode="&#xf068;" horiz-adv-x="1408" 
-d="M1408 800v-192q0 -40 -28 -68t-68 -28h-1216q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h1216q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="asterisk" unicode="&#xf069;" horiz-adv-x="1664" 
-d="M1482 486q46 -26 59.5 -77.5t-12.5 -97.5l-64 -110q-26 -46 -77.5 -59.5t-97.5 12.5l-266 153v-307q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v307l-266 -153q-46 -26 -97.5 -12.5t-77.5 59.5l-64 110q-26 46 -12.5 97.5t59.5 77.5l266 154l-266 154
-q-46 26 -59.5 77.5t12.5 97.5l64 110q26 46 77.5 59.5t97.5 -12.5l266 -153v307q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-307l266 153q46 26 97.5 12.5t77.5 -59.5l64 -110q26 -46 12.5 -97.5t-59.5 -77.5l-266 -154z" />
-    <glyph glyph-name="exclamation_sign" unicode="&#xf06a;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM896 161v190q0 14 -9 23.5t-22 9.5h-192q-13 0 -23 -10t-10 -23v-190q0 -13 10 -23t23 -10h192
-q13 0 22 9.5t9 23.5zM894 505l18 621q0 12 -10 18q-10 8 -24 8h-220q-14 0 -24 -8q-10 -6 -10 -18l17 -621q0 -10 10 -17.5t24 -7.5h185q14 0 23.5 7.5t10.5 17.5z" />
-    <glyph glyph-name="gift" unicode="&#xf06b;" 
-d="M928 180v56v468v192h-320v-192v-468v-56q0 -25 18 -38.5t46 -13.5h192q28 0 46 13.5t18 38.5zM472 1024h195l-126 161q-26 31 -69 31q-40 0 -68 -28t-28 -68t28 -68t68 -28zM1160 1120q0 40 -28 68t-68 28q-43 0 -69 -31l-125 -161h194q40 0 68 28t28 68zM1536 864v-320
-q0 -14 -9 -23t-23 -9h-96v-416q0 -40 -28 -68t-68 -28h-1088q-40 0 -68 28t-28 68v416h-96q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h440q-93 0 -158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5q107 0 168 -77l128 -165l128 165q61 77 168 77q93 0 158.5 -65.5t65.5 -158.5
-t-65.5 -158.5t-158.5 -65.5h440q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="leaf" unicode="&#xf06c;" horiz-adv-x="1792" 
-d="M1280 832q0 26 -19 45t-45 19q-172 0 -318 -49.5t-259.5 -134t-235.5 -219.5q-19 -21 -19 -45q0 -26 19 -45t45 -19q24 0 45 19q27 24 74 71t67 66q137 124 268.5 176t313.5 52q26 0 45 19t19 45zM1792 1030q0 -95 -20 -193q-46 -224 -184.5 -383t-357.5 -268
-q-214 -108 -438 -108q-148 0 -286 47q-15 5 -88 42t-96 37q-16 0 -39.5 -32t-45 -70t-52.5 -70t-60 -32q-43 0 -63.5 17.5t-45.5 59.5q-2 4 -6 11t-5.5 10t-3 9.5t-1.5 13.5q0 35 31 73.5t68 65.5t68 56t31 48q0 4 -14 38t-16 44q-9 51 -9 104q0 115 43.5 220t119 184.5
-t170.5 139t204 95.5q55 18 145 25.5t179.5 9t178.5 6t163.5 24t113.5 56.5l29.5 29.5t29.5 28t27 20t36.5 16t43.5 4.5q39 0 70.5 -46t47.5 -112t24 -124t8 -96z" />
-    <glyph glyph-name="fire" unicode="&#xf06d;" horiz-adv-x="1408" 
-d="M1408 -160v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1152 896q0 -78 -24.5 -144t-64 -112.5t-87.5 -88t-96 -77.5t-87.5 -72t-64 -81.5t-24.5 -96.5q0 -96 67 -224l-4 1l1 -1
-q-90 41 -160 83t-138.5 100t-113.5 122.5t-72.5 150.5t-27.5 184q0 78 24.5 144t64 112.5t87.5 88t96 77.5t87.5 72t64 81.5t24.5 96.5q0 94 -66 224l3 -1l-1 1q90 -41 160 -83t138.5 -100t113.5 -122.5t72.5 -150.5t27.5 -184z" />
-    <glyph glyph-name="eye_open" unicode="&#xf06e;" horiz-adv-x="1792" 
-d="M1664 576q-152 236 -381 353q61 -104 61 -225q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 121 61 225q-229 -117 -381 -353q133 -205 333.5 -326.5t434.5 -121.5t434.5 121.5t333.5 326.5zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5
-t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1792 576q0 -34 -20 -69q-140 -230 -376.5 -368.5t-499.5 -138.5t-499.5 139t-376.5 368q-20 35 -20 69t20 69q140 229 376.5 368t499.5 139t499.5 -139t376.5 -368q20 -35 20 -69z" />
-    <glyph glyph-name="eye_close" unicode="&#xf070;" horiz-adv-x="1792" 
-d="M555 201l78 141q-87 63 -136 159t-49 203q0 121 61 225q-229 -117 -381 -353q167 -258 427 -375zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1307 1151q0 -7 -1 -9
-q-106 -189 -316 -567t-315 -566l-49 -89q-10 -16 -28 -16q-12 0 -134 70q-16 10 -16 28q0 12 44 87q-143 65 -263.5 173t-208.5 245q-20 31 -20 69t20 69q153 235 380 371t496 136q89 0 180 -17l54 97q10 16 28 16q5 0 18 -6t31 -15.5t33 -18.5t31.5 -18.5t19.5 -11.5
-q16 -10 16 -27zM1344 704q0 -139 -79 -253.5t-209 -164.5l280 502q8 -45 8 -84zM1792 576q0 -35 -20 -69q-39 -64 -109 -145q-150 -172 -347.5 -267t-419.5 -95l74 132q212 18 392.5 137t301.5 307q-115 179 -282 294l63 112q95 -64 182.5 -153t144.5 -184q20 -34 20 -69z
-" />
-    <glyph glyph-name="warning_sign" unicode="&#xf071;" horiz-adv-x="1792" 
-d="M1024 161v190q0 14 -9.5 23.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -23.5v-190q0 -14 9.5 -23.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 23.5zM1022 535l18 459q0 12 -10 19q-13 11 -24 11h-220q-11 0 -24 -11q-10 -7 -10 -21l17 -457q0 -10 10 -16.5t24 -6.5h185
-q14 0 23.5 6.5t10.5 16.5zM1008 1469l768 -1408q35 -63 -2 -126q-17 -29 -46.5 -46t-63.5 -17h-1536q-34 0 -63.5 17t-46.5 46q-37 63 -2 126l768 1408q17 31 47 49t65 18t65 -18t47 -49z" />
-    <glyph glyph-name="plane" unicode="&#xf072;" horiz-adv-x="1408" 
-d="M1376 1376q44 -52 12 -148t-108 -172l-161 -161l160 -696q5 -19 -12 -33l-128 -96q-7 -6 -19 -6q-4 0 -7 1q-15 3 -21 16l-279 508l-259 -259l53 -194q5 -17 -8 -31l-96 -96q-9 -9 -23 -9h-2q-15 2 -24 13l-189 252l-252 189q-11 7 -13 23q-1 13 9 25l96 97q9 9 23 9
-q6 0 8 -1l194 -53l259 259l-508 279q-14 8 -17 24q-2 16 9 27l128 128q14 13 30 8l665 -159l160 160q76 76 172 108t148 -12z" />
-    <glyph glyph-name="calendar" unicode="&#xf073;" horiz-adv-x="1664" 
-d="M128 -128h288v288h-288v-288zM480 -128h320v288h-320v-288zM128 224h288v320h-288v-320zM480 224h320v320h-320v-320zM128 608h288v288h-288v-288zM864 -128h320v288h-320v-288zM480 608h320v288h-320v-288zM1248 -128h288v288h-288v-288zM864 224h320v320h-320v-320z
-M512 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1248 224h288v320h-288v-320zM864 608h320v288h-320v-288zM1248 608h288v288h-288v-288zM1280 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64
-q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47
-h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="random" unicode="&#xf074;" horiz-adv-x="1792" 
-d="M666 1055q-60 -92 -137 -273q-22 45 -37 72.5t-40.5 63.5t-51 56.5t-63 35t-81.5 14.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q250 0 410 -225zM1792 256q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192q-32 0 -85 -0.5t-81 -1t-73 1
-t-71 5t-64 10.5t-63 18.5t-58 28.5t-59 40t-55 53.5t-56 69.5q59 93 136 273q22 -45 37 -72.5t40.5 -63.5t51 -56.5t63 -35t81.5 -14.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1792 1152q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5
-v192h-256q-48 0 -87 -15t-69 -45t-51 -61.5t-45 -77.5q-32 -62 -78 -171q-29 -66 -49.5 -111t-54 -105t-64 -100t-74 -83t-90 -68.5t-106.5 -42t-128 -16.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q48 0 87 15t69 45t51 61.5t45 77.5q32 62 78 171q29 66 49.5 111
-t54 105t64 100t74 83t90 68.5t106.5 42t128 16.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
-    <glyph glyph-name="comment" unicode="&#xf075;" horiz-adv-x="1792" 
-d="M1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22q-17 -2 -30.5 9t-17.5 29v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281
-q0 130 71 248.5t191 204.5t286 136.5t348 50.5q244 0 450 -85.5t326 -233t120 -321.5z" />
-    <glyph glyph-name="magnet" unicode="&#xf076;" 
-d="M1536 704v-128q0 -201 -98.5 -362t-274 -251.5t-395.5 -90.5t-395.5 90.5t-274 251.5t-98.5 362v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-128q0 -52 23.5 -90t53.5 -57t71 -30t64 -13t44 -2t44 2t64 13t71 30t53.5 57t23.5 90v128q0 26 19 45t45 19h384
-q26 0 45 -19t19 -45zM512 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45zM1536 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="chevron_up" unicode="&#xf077;" horiz-adv-x="1792" 
-d="M1683 205l-166 -165q-19 -19 -45 -19t-45 19l-531 531l-531 -531q-19 -19 -45 -19t-45 19l-166 165q-19 19 -19 45.5t19 45.5l742 741q19 19 45 19t45 -19l742 -741q19 -19 19 -45.5t-19 -45.5z" />
-    <glyph glyph-name="chevron_down" unicode="&#xf078;" horiz-adv-x="1792" 
-d="M1683 728l-742 -741q-19 -19 -45 -19t-45 19l-742 741q-19 19 -19 45.5t19 45.5l166 165q19 19 45 19t45 -19l531 -531l531 531q19 19 45 19t45 -19l166 -165q19 -19 19 -45.5t-19 -45.5z" />
-    <glyph glyph-name="retweet" unicode="&#xf079;" horiz-adv-x="1920" 
-d="M1280 32q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-8 0 -13.5 2t-9 7t-5.5 8t-3 11.5t-1 11.5v13v11v160v416h-192q-26 0 -45 19t-19 45q0 24 15 41l320 384q19 22 49 22t49 -22l320 -384q15 -17 15 -41q0 -26 -19 -45t-45 -19h-192v-384h576q16 0 25 -11l160 -192q7 -10 7 -21
-zM1920 448q0 -24 -15 -41l-320 -384q-20 -23 -49 -23t-49 23l-320 384q-15 17 -15 41q0 26 19 45t45 19h192v384h-576q-16 0 -25 12l-160 192q-7 9 -7 20q0 13 9.5 22.5t22.5 9.5h960q8 0 13.5 -2t9 -7t5.5 -8t3 -11.5t1 -11.5v-13v-11v-160v-416h192q26 0 45 -19t19 -45z
-" />
-    <glyph glyph-name="shopping_cart" unicode="&#xf07a;" horiz-adv-x="1664" 
-d="M640 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1536 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1664 1088v-512q0 -24 -16.5 -42.5t-40.5 -21.5l-1044 -122q13 -60 13 -70q0 -16 -24 -64h920q26 0 45 -19t19 -45
-t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 11 8 31.5t16 36t21.5 40t15.5 29.5l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t19.5 -15.5t13 -24.5t8 -26t5.5 -29.5t4.5 -26h1201q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="folder_close" unicode="&#xf07b;" horiz-adv-x="1664" 
-d="M1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="folder_open" unicode="&#xf07c;" horiz-adv-x="1920" 
-d="M1879 584q0 -31 -31 -66l-336 -396q-43 -51 -120.5 -86.5t-143.5 -35.5h-1088q-34 0 -60.5 13t-26.5 43q0 31 31 66l336 396q43 51 120.5 86.5t143.5 35.5h1088q34 0 60.5 -13t26.5 -43zM1536 928v-160h-832q-94 0 -197 -47.5t-164 -119.5l-337 -396l-5 -6q0 4 -0.5 12.5
-t-0.5 12.5v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="resize_vertical" unicode="&#xf07d;" horiz-adv-x="768" 
-d="M704 1216q0 -26 -19 -45t-45 -19h-128v-1024h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v1024h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45z" />
-    <glyph glyph-name="resize_horizontal" unicode="&#xf07e;" horiz-adv-x="1792" 
-d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-1024v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h1024v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
-    <glyph glyph-name="bar_chart" unicode="&#xf080;" horiz-adv-x="2048" 
-d="M640 640v-512h-256v512h256zM1024 1152v-1024h-256v1024h256zM2048 0v-128h-2048v1536h128v-1408h1920zM1408 896v-768h-256v768h256zM1792 1280v-1152h-256v1152h256z" />
-    <glyph glyph-name="twitter_sign" unicode="&#xf081;" 
-d="M1280 926q-56 -25 -121 -34q68 40 93 117q-65 -38 -134 -51q-61 66 -153 66q-87 0 -148.5 -61.5t-61.5 -148.5q0 -29 5 -48q-129 7 -242 65t-192 155q-29 -50 -29 -106q0 -114 91 -175q-47 1 -100 26v-2q0 -75 50 -133.5t123 -72.5q-29 -8 -51 -8q-13 0 -39 4
-q21 -63 74.5 -104t121.5 -42q-116 -90 -261 -90q-26 0 -50 3q148 -94 322 -94q112 0 210 35.5t168 95t120.5 137t75 162t24.5 168.5q0 18 -1 27q63 45 105 109zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5
-t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="facebook_sign" unicode="&#xf082;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-188v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-532q-119 0 -203.5 84.5t-84.5 203.5v960
-q0 119 84.5 203.5t203.5 84.5h960z" />
-    <glyph glyph-name="camera_retro" unicode="&#xf083;" horiz-adv-x="1792" 
-d="M928 704q0 14 -9 23t-23 9q-66 0 -113 -47t-47 -113q0 -14 9 -23t23 -9t23 9t9 23q0 40 28 68t68 28q14 0 23 9t9 23zM1152 574q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM128 0h1536v128h-1536v-128zM1280 574q0 159 -112.5 271.5
-t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM256 1216h384v128h-384v-128zM128 1024h1536v118v138h-828l-64 -128h-644v-128zM1792 1280v-1280q0 -53 -37.5 -90.5t-90.5 -37.5h-1536q-53 0 -90.5 37.5t-37.5 90.5v1280
-q0 53 37.5 90.5t90.5 37.5h1536q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="key" unicode="&#xf084;" horiz-adv-x="1792" 
-d="M832 1024q0 80 -56 136t-136 56t-136 -56t-56 -136q0 -42 19 -83q-41 19 -83 19q-80 0 -136 -56t-56 -136t56 -136t136 -56t136 56t56 136q0 42 -19 83q41 -19 83 -19q80 0 136 56t56 136zM1683 320q0 -17 -49 -66t-66 -49q-9 0 -28.5 16t-36.5 33t-38.5 40t-24.5 26
-l-96 -96l220 -220q28 -28 28 -68q0 -42 -39 -81t-81 -39q-40 0 -68 28l-671 671q-176 -131 -365 -131q-163 0 -265.5 102.5t-102.5 265.5q0 160 95 313t248 248t313 95q163 0 265.5 -102.5t102.5 -265.5q0 -189 -131 -365l355 -355l96 96q-3 3 -26 24.5t-40 38.5t-33 36.5
-t-16 28.5q0 17 49 66t66 49q13 0 23 -10q6 -6 46 -44.5t82 -79.5t86.5 -86t73 -78t28.5 -41z" />
-    <glyph glyph-name="cogs" unicode="&#xf085;" horiz-adv-x="1920" 
-d="M896 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1664 128q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1152q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5
-t90.5 37.5t37.5 90.5zM1280 731v-185q0 -10 -7 -19.5t-16 -10.5l-155 -24q-11 -35 -32 -76q34 -48 90 -115q7 -11 7 -20q0 -12 -7 -19q-23 -30 -82.5 -89.5t-78.5 -59.5q-11 0 -21 7l-115 90q-37 -19 -77 -31q-11 -108 -23 -155q-7 -24 -30 -24h-186q-11 0 -20 7.5t-10 17.5
-l-23 153q-34 10 -75 31l-118 -89q-7 -7 -20 -7q-11 0 -21 8q-144 133 -144 160q0 9 7 19q10 14 41 53t47 61q-23 44 -35 82l-152 24q-10 1 -17 9.5t-7 19.5v185q0 10 7 19.5t16 10.5l155 24q11 35 32 76q-34 48 -90 115q-7 11 -7 20q0 12 7 20q22 30 82 89t79 59q11 0 21 -7
-l115 -90q34 18 77 32q11 108 23 154q7 24 30 24h186q11 0 20 -7.5t10 -17.5l23 -153q34 -10 75 -31l118 89q8 7 20 7q11 0 21 -8q144 -133 144 -160q0 -8 -7 -19q-12 -16 -42 -54t-45 -60q23 -48 34 -82l152 -23q10 -2 17 -10.5t7 -19.5zM1920 198v-140q0 -16 -149 -31
-q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20
-t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31zM1920 1222v-140q0 -16 -149 -31q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68
-q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70
-q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31z" />
-    <glyph glyph-name="comments" unicode="&#xf086;" horiz-adv-x="1792" 
-d="M1408 768q0 -139 -94 -257t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224
-q0 139 94 257t256.5 186.5t353.5 68.5t353.5 -68.5t256.5 -186.5t94 -257zM1792 512q0 -120 -71 -224.5t-195 -176.5q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7
-q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230z" />
-    <glyph glyph-name="thumbs_up_alt" unicode="&#xf087;" 
-d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 768q0 51 -39 89.5t-89 38.5h-352q0 58 48 159.5t48 160.5q0 98 -32 145t-128 47q-26 -26 -38 -85t-30.5 -125.5t-59.5 -109.5q-22 -23 -77 -91q-4 -5 -23 -30t-31.5 -41t-34.5 -42.5
-t-40 -44t-38.5 -35.5t-40 -27t-35.5 -9h-32v-640h32q13 0 31.5 -3t33 -6.5t38 -11t35 -11.5t35.5 -12.5t29 -10.5q211 -73 342 -73h121q192 0 192 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5q32 1 53.5 47t21.5 81zM1536 769
-q0 -89 -49 -163q9 -33 9 -69q0 -77 -38 -144q3 -21 3 -43q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5h-36h-93q-96 0 -189.5 22.5t-216.5 65.5q-116 40 -138 40h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h274q36 24 137 155q58 75 107 128
-q24 25 35.5 85.5t30.5 126.5t62 108q39 37 90 37q84 0 151 -32.5t102 -101.5t35 -186q0 -93 -48 -192h176q104 0 180 -76t76 -179z" />
-    <glyph glyph-name="thumbs_down_alt" unicode="&#xf088;" 
-d="M256 1088q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 512q0 35 -21.5 81t-53.5 47q15 17 25 47.5t10 55.5q0 69 -53 119q18 31 18 69q0 37 -17.5 73.5t-47.5 52.5q5 30 5 56q0 85 -49 126t-136 41h-128q-131 0 -342 -73q-5 -2 -29 -10.5
-t-35.5 -12.5t-35 -11.5t-38 -11t-33 -6.5t-31.5 -3h-32v-640h32q16 0 35.5 -9t40 -27t38.5 -35.5t40 -44t34.5 -42.5t31.5 -41t23 -30q55 -68 77 -91q41 -43 59.5 -109.5t30.5 -125.5t38 -85q96 0 128 47t32 145q0 59 -48 160.5t-48 159.5h352q50 0 89 38.5t39 89.5z
-M1536 511q0 -103 -76 -179t-180 -76h-176q48 -99 48 -192q0 -118 -35 -186q-35 -69 -102 -101.5t-151 -32.5q-51 0 -90 37q-34 33 -54 82t-25.5 90.5t-17.5 84.5t-31 64q-48 50 -107 127q-101 131 -137 155h-274q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5
-h288q22 0 138 40q128 44 223 66t200 22h112q140 0 226.5 -79t85.5 -216v-5q60 -77 60 -178q0 -22 -3 -43q38 -67 38 -144q0 -36 -9 -69q49 -73 49 -163z" />
-    <glyph glyph-name="star_half" unicode="&#xf089;" horiz-adv-x="896" 
-d="M832 1504v-1339l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41z" />
-    <glyph glyph-name="heart_empty" unicode="&#xf08a;" horiz-adv-x="1792" 
-d="M1664 940q0 81 -21.5 143t-55 98.5t-81.5 59.5t-94 31t-98 8t-112 -25.5t-110.5 -64t-86.5 -72t-60 -61.5q-18 -22 -49 -22t-49 22q-24 28 -60 61.5t-86.5 72t-110.5 64t-112 25.5t-98 -8t-94 -31t-81.5 -59.5t-55 -98.5t-21.5 -143q0 -168 187 -355l581 -560l580 559
-q188 188 188 356zM1792 940q0 -221 -229 -450l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5
-q224 0 351 -124t127 -344z" />
-    <glyph glyph-name="signout" unicode="&#xf08b;" horiz-adv-x="1664" 
-d="M640 96q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h320q13 0 22.5 -9.5t9.5 -22.5q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-66 0 -113 -47t-47 -113v-704
-q0 -66 47 -113t113 -47h288h11h13t11.5 -1t11.5 -3t8 -5.5t7 -9t2 -13.5zM1568 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45z" />
-    <glyph glyph-name="linkedin_sign" unicode="&#xf08c;" 
-d="M237 122h231v694h-231v-694zM483 1030q-1 52 -36 86t-93 34t-94.5 -34t-36.5 -86q0 -51 35.5 -85.5t92.5 -34.5h1q59 0 95 34.5t36 85.5zM1068 122h231v398q0 154 -73 233t-193 79q-136 0 -209 -117h2v101h-231q3 -66 0 -694h231v388q0 38 7 56q15 35 45 59.5t74 24.5
-q116 0 116 -157v-371zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="pushpin" unicode="&#xf08d;" horiz-adv-x="1152" 
-d="M480 672v448q0 14 -9 23t-23 9t-23 -9t-9 -23v-448q0 -14 9 -23t23 -9t23 9t9 23zM1152 320q0 -26 -19 -45t-45 -19h-429l-51 -483q-2 -12 -10.5 -20.5t-20.5 -8.5h-1q-27 0 -32 27l-76 485h-404q-26 0 -45 19t-19 45q0 123 78.5 221.5t177.5 98.5v512q-52 0 -90 38
-t-38 90t38 90t90 38h640q52 0 90 -38t38 -90t-38 -90t-90 -38v-512q99 0 177.5 -98.5t78.5 -221.5z" />
-    <glyph glyph-name="external_link" unicode="&#xf08e;" horiz-adv-x="1792" 
-d="M1408 608v-320q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v320
-q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1792 1472v-512q0 -26 -19 -45t-45 -19t-45 19l-176 176l-652 -652q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l652 652l-176 176q-19 19 -19 45t19 45t45 19h512q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="signin" unicode="&#xf090;" 
-d="M1184 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45zM1536 992v-704q0 -119 -84.5 -203.5t-203.5 -84.5h-320q-13 0 -22.5 9.5t-9.5 22.5
-q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q66 0 113 47t47 113v704q0 66 -47 113t-113 47h-288h-11h-13t-11.5 1t-11.5 3t-8 5.5t-7 9t-2 13.5q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="trophy" unicode="&#xf091;" horiz-adv-x="1664" 
-d="M458 653q-74 162 -74 371h-256v-96q0 -78 94.5 -162t235.5 -113zM1536 928v96h-256q0 -209 -74 -371q141 29 235.5 113t94.5 162zM1664 1056v-128q0 -71 -41.5 -143t-112 -130t-173 -97.5t-215.5 -44.5q-42 -54 -95 -95q-38 -34 -52.5 -72.5t-14.5 -89.5q0 -54 30.5 -91
-t97.5 -37q75 0 133.5 -45.5t58.5 -114.5v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 69 58.5 114.5t133.5 45.5q67 0 97.5 37t30.5 91q0 51 -14.5 89.5t-52.5 72.5q-53 41 -95 95q-113 5 -215.5 44.5t-173 97.5t-112 130t-41.5 143v128q0 40 28 68t68 28h288v96
-q0 66 47 113t113 47h576q66 0 113 -47t47 -113v-96h288q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="github_sign" unicode="&#xf092;" 
-d="M519 336q4 6 -3 13q-9 7 -14 2q-4 -6 3 -13q9 -7 14 -2zM491 377q-5 7 -12 4q-6 -4 0 -12q7 -8 12 -5q6 4 0 13zM450 417q2 4 -5 8q-7 2 -8 -2q-3 -5 4 -8q8 -2 9 2zM471 394q2 1 1.5 4.5t-3.5 5.5q-6 7 -10 3t1 -11q6 -6 11 -2zM557 319q2 7 -9 11q-9 3 -13 -4
-q-2 -7 9 -11q9 -3 13 4zM599 316q0 8 -12 8q-10 0 -10 -8t11 -8t11 8zM638 323q-2 7 -13 5t-9 -9q2 -8 12 -6t10 10zM1280 640q0 212 -150 362t-362 150t-362 -150t-150 -362q0 -167 98 -300.5t252 -185.5q18 -3 26.5 5t8.5 20q0 52 -1 95q-6 -1 -15.5 -2.5t-35.5 -2t-48 4
-t-43.5 20t-29.5 41.5q-23 59 -57 74q-2 1 -4.5 3.5l-8 8t-7 9.5t4 7.5t19.5 3.5q6 0 15 -2t30 -15.5t33 -35.5q16 -28 37.5 -42t43.5 -14t38 3.5t30 9.5q7 47 33 69q-49 6 -86 18.5t-73 39t-55.5 76t-19.5 119.5q0 79 53 137q-24 62 5 136q19 6 54.5 -7.5t60.5 -29.5l26 -16
-q58 17 128 17t128 -17q11 7 28.5 18t55.5 26t57 9q29 -74 5 -136q53 -58 53 -137q0 -57 -14 -100.5t-35.5 -70t-53.5 -44.5t-62.5 -26t-68.5 -12q35 -31 35 -95q0 -40 -0.5 -89t-0.5 -51q0 -12 8.5 -20t26.5 -5q154 52 252 185.5t98 300.5zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="upload_alt" unicode="&#xf093;" horiz-adv-x="1664" 
-d="M1280 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 288v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h427q21 -56 70.5 -92
-t110.5 -36h256q61 0 110.5 36t70.5 92h427q40 0 68 -28t28 -68zM1339 936q-17 -40 -59 -40h-256v-448q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v448h-256q-42 0 -59 40q-17 39 14 69l448 448q18 19 45 19t45 -19l448 -448q31 -30 14 -69z" />
-    <glyph glyph-name="lemon" unicode="&#xf094;" 
-d="M1407 710q0 44 -7 113.5t-18 96.5q-12 30 -17 44t-9 36.5t-4 48.5q0 23 5 68.5t5 67.5q0 37 -10 55q-4 1 -13 1q-19 0 -58 -4.5t-59 -4.5q-60 0 -176 24t-175 24q-43 0 -94.5 -11.5t-85 -23.5t-89.5 -34q-137 -54 -202 -103q-96 -73 -159.5 -189.5t-88 -236t-24.5 -248.5
-q0 -40 12.5 -120t12.5 -121q0 -23 -11 -66.5t-11 -65.5t12 -36.5t34 -14.5q24 0 72.5 11t73.5 11q57 0 169.5 -15.5t169.5 -15.5q181 0 284 36q129 45 235.5 152.5t166 245.5t59.5 275zM1535 712q0 -165 -70 -327.5t-196 -288t-281 -180.5q-124 -44 -326 -44
-q-57 0 -170 14.5t-169 14.5q-24 0 -72.5 -14.5t-73.5 -14.5q-73 0 -123.5 55.5t-50.5 128.5q0 24 11 68t11 67q0 40 -12.5 120.5t-12.5 121.5q0 111 18 217.5t54.5 209.5t100.5 194t150 156q78 59 232 120q194 78 316 78q60 0 175.5 -24t173.5 -24q19 0 57 5t58 5
-q81 0 118 -50.5t37 -134.5q0 -23 -5 -68t-5 -68q0 -13 2 -25t3.5 -16.5t7.5 -20.5t8 -20q16 -40 25 -118.5t9 -136.5z" />
-    <glyph glyph-name="phone" unicode="&#xf095;" horiz-adv-x="1408" 
-d="M1408 296q0 -27 -10 -70.5t-21 -68.5q-21 -50 -122 -106q-94 -51 -186 -51q-27 0 -53 3.5t-57.5 12.5t-47 14.5t-55.5 20.5t-49 18q-98 35 -175 83q-127 79 -264 216t-216 264q-48 77 -83 175q-3 9 -18 49t-20.5 55.5t-14.5 47t-12.5 57.5t-3.5 53q0 92 51 186
-q56 101 106 122q25 11 68.5 21t70.5 10q14 0 21 -3q18 -6 53 -76q11 -19 30 -54t35 -63.5t31 -53.5q3 -4 17.5 -25t21.5 -35.5t7 -28.5q0 -20 -28.5 -50t-62 -55t-62 -53t-28.5 -46q0 -9 5 -22.5t8.5 -20.5t14 -24t11.5 -19q76 -137 174 -235t235 -174q2 -1 19 -11.5t24 -14
-t20.5 -8.5t22.5 -5q18 0 46 28.5t53 62t55 62t50 28.5q14 0 28.5 -7t35.5 -21.5t25 -17.5q25 -15 53.5 -31t63.5 -35t54 -30q70 -35 76 -53q3 -7 3 -21z" />
-    <glyph glyph-name="check_empty" unicode="&#xf096;" horiz-adv-x="1408" 
-d="M1120 1280h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v832q0 66 -47 113t-113 47zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832
-q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="bookmark_empty" unicode="&#xf097;" horiz-adv-x="1280" 
-d="M1152 1280h-1024v-1242l423 406l89 85l89 -85l423 -406v1242zM1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289
-q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
-    <glyph glyph-name="phone_sign" unicode="&#xf098;" 
-d="M1280 343q0 11 -2 16t-18 16.5t-40.5 25t-47.5 26.5t-45.5 25t-28.5 15q-5 3 -19 13t-25 15t-21 5q-15 0 -36.5 -20.5t-39.5 -45t-38.5 -45t-33.5 -20.5q-7 0 -16.5 3.5t-15.5 6.5t-17 9.5t-14 8.5q-99 55 -170 126.5t-127 170.5q-2 3 -8.5 14t-9.5 17t-6.5 15.5
-t-3.5 16.5q0 13 20.5 33.5t45 38.5t45 39.5t20.5 36.5q0 10 -5 21t-15 25t-13 19q-3 6 -15 28.5t-25 45.5t-26.5 47.5t-25 40.5t-16.5 18t-16 2q-48 0 -101 -22q-46 -21 -80 -94.5t-34 -130.5q0 -16 2.5 -34t5 -30.5t9 -33t10 -29.5t12.5 -33t11 -30q60 -164 216.5 -320.5
-t320.5 -216.5q6 -2 30 -11t33 -12.5t29.5 -10t33 -9t30.5 -5t34 -2.5q57 0 130.5 34t94.5 80q22 53 22 101zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z
-" />
-    <glyph glyph-name="twitter" unicode="&#xf099;" horiz-adv-x="1664" 
-d="M1620 1128q-67 -98 -162 -167q1 -14 1 -42q0 -130 -38 -259.5t-115.5 -248.5t-184.5 -210.5t-258 -146t-323 -54.5q-271 0 -496 145q35 -4 78 -4q225 0 401 138q-105 2 -188 64.5t-114 159.5q33 -5 61 -5q43 0 85 11q-112 23 -185.5 111.5t-73.5 205.5v4q68 -38 146 -41
-q-66 44 -105 115t-39 154q0 88 44 163q121 -149 294.5 -238.5t371.5 -99.5q-8 38 -8 74q0 134 94.5 228.5t228.5 94.5q140 0 236 -102q109 21 205 78q-37 -115 -142 -178q93 10 186 50z" />
-    <glyph glyph-name="facebook" unicode="&#xf09a;" horiz-adv-x="1024" 
-d="M959 1524v-264h-157q-86 0 -116 -36t-30 -108v-189h293l-39 -296h-254v-759h-306v759h-255v296h255v218q0 186 104 288.5t277 102.5q147 0 228 -12z" />
-    <glyph glyph-name="github" unicode="&#xf09b;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5q0 -251 -146.5 -451.5t-378.5 -277.5q-27 -5 -40 7t-13 30q0 3 0.5 76.5t0.5 134.5q0 97 -52 142q57 6 102.5 18t94 39t81 66.5t53 105t20.5 150.5q0 119 -79 206q37 91 -8 204q-28 9 -81 -11t-92 -44l-38 -24
-q-93 26 -192 26t-192 -26q-16 11 -42.5 27t-83.5 38.5t-85 13.5q-45 -113 -8 -204q-79 -87 -79 -206q0 -85 20.5 -150t52.5 -105t80.5 -67t94 -39t102.5 -18q-39 -36 -49 -103q-21 -10 -45 -15t-57 -5t-65.5 21.5t-55.5 62.5q-19 32 -48.5 52t-49.5 24l-20 3q-21 0 -29 -4.5
-t-5 -11.5t9 -14t13 -12l7 -5q22 -10 43.5 -38t31.5 -51l10 -23q13 -38 44 -61.5t67 -30t69.5 -7t55.5 3.5l23 4q0 -38 0.5 -88.5t0.5 -54.5q0 -18 -13 -30t-40 -7q-232 77 -378.5 277.5t-146.5 451.5q0 209 103 385.5t279.5 279.5t385.5 103zM291 305q3 7 -7 12
-q-10 3 -13 -2q-3 -7 7 -12q9 -6 13 2zM322 271q7 5 -2 16q-10 9 -16 3q-7 -5 2 -16q10 -10 16 -3zM352 226q9 7 0 19q-8 13 -17 6q-9 -5 0 -18t17 -7zM394 184q8 8 -4 19q-12 12 -20 3q-9 -8 4 -19q12 -12 20 -3zM451 159q3 11 -13 16q-15 4 -19 -7t13 -15q15 -6 19 6z
-M514 154q0 13 -17 11q-16 0 -16 -11q0 -13 17 -11q16 0 16 11zM572 164q-2 11 -18 9q-16 -3 -14 -15t18 -8t14 14z" />
-    <glyph glyph-name="unlock" unicode="&#xf09c;" horiz-adv-x="1664" 
-d="M1664 960v-256q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-192h96q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h672v192q0 185 131.5 316.5t316.5 131.5
-t316.5 -131.5t131.5 -316.5z" />
-    <glyph glyph-name="credit_card" unicode="&#xf09d;" horiz-adv-x="1920" 
-d="M1760 1408q66 0 113 -47t47 -113v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600zM160 1280q-13 0 -22.5 -9.5t-9.5 -22.5v-224h1664v224q0 13 -9.5 22.5t-22.5 9.5h-1600zM1760 0q13 0 22.5 9.5t9.5 22.5v608h-1664v-608
-q0 -13 9.5 -22.5t22.5 -9.5h1600zM256 128v128h256v-128h-256zM640 128v128h384v-128h-384z" />
-    <glyph glyph-name="rss" unicode="&#xf09e;" horiz-adv-x="1408" 
-d="M384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 69q2 -28 -17 -48q-18 -21 -47 -21h-135q-25 0 -43 16.5t-20 41.5q-22 229 -184.5 391.5t-391.5 184.5q-25 2 -41.5 20t-16.5 43v135q0 29 21 47q17 17 43 17h5q160 -13 306 -80.5
-t259 -181.5q114 -113 181.5 -259t80.5 -306zM1408 67q2 -27 -18 -47q-18 -20 -46 -20h-143q-26 0 -44.5 17.5t-19.5 42.5q-12 215 -101 408.5t-231.5 336t-336 231.5t-408.5 102q-25 1 -42.5 19.5t-17.5 43.5v143q0 28 20 46q18 18 44 18h3q262 -13 501.5 -120t425.5 -294
-q187 -186 294 -425.5t120 -501.5z" />
-    <glyph glyph-name="hdd" unicode="&#xf0a0;" 
-d="M1040 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1296 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1408 160v320q0 13 -9.5 22.5t-22.5 9.5
-h-1216q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5zM178 640h1180l-157 482q-4 13 -16 21.5t-26 8.5h-782q-14 0 -26 -8.5t-16 -21.5zM1536 480v-320q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v320q0 25 16 75
-l197 606q17 53 63 86t101 33h782q55 0 101 -33t63 -86l197 -606q16 -50 16 -75z" />
-    <glyph glyph-name="bullhorn" unicode="&#xf0a1;" horiz-adv-x="1792" 
-d="M1664 896q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5v-384q0 -52 -38 -90t-90 -38q-417 347 -812 380q-58 -19 -91 -66t-31 -100.5t40 -92.5q-20 -33 -23 -65.5t6 -58t33.5 -55t48 -50t61.5 -50.5q-29 -58 -111.5 -83t-168.5 -11.5t-132 55.5q-7 23 -29.5 87.5
-t-32 94.5t-23 89t-15 101t3.5 98.5t22 110.5h-122q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h480q435 0 896 384q52 0 90 -38t38 -90v-384zM1536 292v954q-394 -302 -768 -343v-270q377 -42 768 -341z" />
-    <glyph glyph-name="bell" unicode="&#xf0a2;" horiz-adv-x="1792" 
-d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM246 128h1300q-266 300 -266 832q0 51 -24 105t-69 103t-121.5 80.5t-169.5 31.5t-169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -532 -266 -832z
-M1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5
-t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
-    <glyph glyph-name="certificate" unicode="&#xf0a3;" 
-d="M1376 640l138 -135q30 -28 20 -70q-12 -41 -52 -51l-188 -48l53 -186q12 -41 -19 -70q-29 -31 -70 -19l-186 53l-48 -188q-10 -40 -51 -52q-12 -2 -19 -2q-31 0 -51 22l-135 138l-135 -138q-28 -30 -70 -20q-41 11 -51 52l-48 188l-186 -53q-41 -12 -70 19q-31 29 -19 70
-l53 186l-188 48q-40 10 -52 51q-10 42 20 70l138 135l-138 135q-30 28 -20 70q12 41 52 51l188 48l-53 186q-12 41 19 70q29 31 70 19l186 -53l48 188q10 41 51 51q41 12 70 -19l135 -139l135 139q29 30 70 19q41 -10 51 -51l48 -188l186 53q41 12 70 -19q31 -29 19 -70
-l-53 -186l188 -48q40 -10 52 -51q10 -42 -20 -70z" />
-    <glyph glyph-name="hand_right" unicode="&#xf0a4;" horiz-adv-x="1792" 
-d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 768q0 51 -39 89.5t-89 38.5h-576q0 20 15 48.5t33 55t33 68t15 84.5q0 67 -44.5 97.5t-115.5 30.5q-24 0 -90 -139q-24 -44 -37 -65q-40 -64 -112 -145q-71 -81 -101 -106
-q-69 -57 -140 -57h-32v-640h32q72 0 167 -32t193.5 -64t179.5 -32q189 0 189 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5h331q52 0 90 38t38 90zM1792 769q0 -105 -75.5 -181t-180.5 -76h-169q-4 -62 -37 -119q3 -21 3 -43
-q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5q-133 0 -322 69q-164 59 -223 59h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h288q10 0 21.5 4.5t23.5 14t22.5 18t24 22.5t20.5 21.5t19 21.5t14 17q65 74 100 129q13 21 33 62t37 72t40.5 63t55 49.5
-t69.5 17.5q125 0 206.5 -67t81.5 -189q0 -68 -22 -128h374q104 0 180 -76t76 -179z" />
-    <glyph glyph-name="hand_left" unicode="&#xf0a5;" horiz-adv-x="1792" 
-d="M1376 128h32v640h-32q-35 0 -67.5 12t-62.5 37t-50 46t-49 54q-8 9 -12 14q-72 81 -112 145q-14 22 -38 68q-1 3 -10.5 22.5t-18.5 36t-20 35.5t-21.5 30.5t-18.5 11.5q-71 0 -115.5 -30.5t-44.5 -97.5q0 -43 15 -84.5t33 -68t33 -55t15 -48.5h-576q-50 0 -89 -38.5
-t-39 -89.5q0 -52 38 -90t90 -38h331q-15 -17 -25 -47.5t-10 -55.5q0 -69 53 -119q-18 -32 -18 -69t17.5 -73.5t47.5 -52.5q-4 -24 -4 -56q0 -85 48.5 -126t135.5 -41q84 0 183 32t194 64t167 32zM1664 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45z
-M1792 768v-640q0 -53 -37.5 -90.5t-90.5 -37.5h-288q-59 0 -223 -59q-190 -69 -317 -69q-142 0 -230 77.5t-87 217.5l1 5q-61 76 -61 178q0 22 3 43q-33 57 -37 119h-169q-105 0 -180.5 76t-75.5 181q0 103 76 179t180 76h374q-22 60 -22 128q0 122 81.5 189t206.5 67
-q38 0 69.5 -17.5t55 -49.5t40.5 -63t37 -72t33 -62q35 -55 100 -129q2 -3 14 -17t19 -21.5t20.5 -21.5t24 -22.5t22.5 -18t23.5 -14t21.5 -4.5h288q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="hand_up" unicode="&#xf0a6;" 
-d="M1280 -64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 700q0 189 -167 189q-26 0 -56 -5q-16 30 -52.5 47.5t-73.5 17.5t-69 -18q-50 53 -119 53q-25 0 -55.5 -10t-47.5 -25v331q0 52 -38 90t-90 38q-51 0 -89.5 -39t-38.5 -89v-576
-q-20 0 -48.5 15t-55 33t-68 33t-84.5 15q-67 0 -97.5 -44.5t-30.5 -115.5q0 -24 139 -90q44 -24 65 -37q64 -40 145 -112q81 -71 106 -101q57 -69 57 -140v-32h640v32q0 72 32 167t64 193.5t32 179.5zM1536 705q0 -133 -69 -322q-59 -164 -59 -223v-288q0 -53 -37.5 -90.5
-t-90.5 -37.5h-640q-53 0 -90.5 37.5t-37.5 90.5v288q0 10 -4.5 21.5t-14 23.5t-18 22.5t-22.5 24t-21.5 20.5t-21.5 19t-17 14q-74 65 -129 100q-21 13 -62 33t-72 37t-63 40.5t-49.5 55t-17.5 69.5q0 125 67 206.5t189 81.5q68 0 128 -22v374q0 104 76 180t179 76
-q105 0 181 -75.5t76 -180.5v-169q62 -4 119 -37q21 3 43 3q101 0 178 -60q139 1 219.5 -85t80.5 -227z" />
-    <glyph glyph-name="hand_down" unicode="&#xf0a7;" 
-d="M1408 576q0 84 -32 183t-64 194t-32 167v32h-640v-32q0 -35 -12 -67.5t-37 -62.5t-46 -50t-54 -49q-9 -8 -14 -12q-81 -72 -145 -112q-22 -14 -68 -38q-3 -1 -22.5 -10.5t-36 -18.5t-35.5 -20t-30.5 -21.5t-11.5 -18.5q0 -71 30.5 -115.5t97.5 -44.5q43 0 84.5 15t68 33
-t55 33t48.5 15v-576q0 -50 38.5 -89t89.5 -39q52 0 90 38t38 90v331q46 -35 103 -35q69 0 119 53q32 -18 69 -18t73.5 17.5t52.5 47.5q24 -4 56 -4q85 0 126 48.5t41 135.5zM1280 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 580
-q0 -142 -77.5 -230t-217.5 -87l-5 1q-76 -61 -178 -61q-22 0 -43 3q-54 -30 -119 -37v-169q0 -105 -76 -180.5t-181 -75.5q-103 0 -179 76t-76 180v374q-54 -22 -128 -22q-121 0 -188.5 81.5t-67.5 206.5q0 38 17.5 69.5t49.5 55t63 40.5t72 37t62 33q55 35 129 100
-q3 2 17 14t21.5 19t21.5 20.5t22.5 24t18 22.5t14 23.5t4.5 21.5v288q0 53 37.5 90.5t90.5 37.5h640q53 0 90.5 -37.5t37.5 -90.5v-288q0 -59 59 -223q69 -190 69 -317z" />
-    <glyph glyph-name="circle_arrow_left" unicode="&#xf0a8;" 
-d="M1280 576v128q0 26 -19 45t-45 19h-502l189 189q19 19 19 45t-19 45l-91 91q-18 18 -45 18t-45 -18l-362 -362l-91 -91q-18 -18 -18 -45t18 -45l91 -91l362 -362q18 -18 45 -18t45 18l91 91q18 18 18 45t-18 45l-189 189h502q26 0 45 19t19 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="circle_arrow_right" unicode="&#xf0a9;" 
-d="M1285 640q0 27 -18 45l-91 91l-362 362q-18 18 -45 18t-45 -18l-91 -91q-18 -18 -18 -45t18 -45l189 -189h-502q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h502l-189 -189q-19 -19 -19 -45t19 -45l91 -91q18 -18 45 -18t45 18l362 362l91 91q18 18 18 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="circle_arrow_up" unicode="&#xf0aa;" 
-d="M1284 641q0 27 -18 45l-362 362l-91 91q-18 18 -45 18t-45 -18l-91 -91l-362 -362q-18 -18 -18 -45t18 -45l91 -91q18 -18 45 -18t45 18l189 189v-502q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v502l189 -189q19 -19 45 -19t45 19l91 91q18 18 18 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="circle_arrow_down" unicode="&#xf0ab;" 
-d="M1284 639q0 27 -18 45l-91 91q-18 18 -45 18t-45 -18l-189 -189v502q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-502l-189 189q-19 19 -45 19t-45 -19l-91 -91q-18 -18 -18 -45t18 -45l362 -362l91 -91q18 -18 45 -18t45 18l91 91l362 362q18 18 18 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="globe" unicode="&#xf0ac;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1042 887q-2 -1 -9.5 -9.5t-13.5 -9.5q2 0 4.5 5t5 11t3.5 7q6 7 22 15q14 6 52 12q34 8 51 -11
-q-2 2 9.5 13t14.5 12q3 2 15 4.5t15 7.5l2 22q-12 -1 -17.5 7t-6.5 21q0 -2 -6 -8q0 7 -4.5 8t-11.5 -1t-9 -1q-10 3 -15 7.5t-8 16.5t-4 15q-2 5 -9.5 11t-9.5 10q-1 2 -2.5 5.5t-3 6.5t-4 5.5t-5.5 2.5t-7 -5t-7.5 -10t-4.5 -5q-3 2 -6 1.5t-4.5 -1t-4.5 -3t-5 -3.5
-q-3 -2 -8.5 -3t-8.5 -2q15 5 -1 11q-10 4 -16 3q9 4 7.5 12t-8.5 14h5q-1 4 -8.5 8.5t-17.5 8.5t-13 6q-8 5 -34 9.5t-33 0.5q-5 -6 -4.5 -10.5t4 -14t3.5 -12.5q1 -6 -5.5 -13t-6.5 -12q0 -7 14 -15.5t10 -21.5q-3 -8 -16 -16t-16 -12q-5 -8 -1.5 -18.5t10.5 -16.5
-q2 -2 1.5 -4t-3.5 -4.5t-5.5 -4t-6.5 -3.5l-3 -2q-11 -5 -20.5 6t-13.5 26q-7 25 -16 30q-23 8 -29 -1q-5 13 -41 26q-25 9 -58 4q6 1 0 15q-7 15 -19 12q3 6 4 17.5t1 13.5q3 13 12 23q1 1 7 8.5t9.5 13.5t0.5 6q35 -4 50 11q5 5 11.5 17t10.5 17q9 6 14 5.5t14.5 -5.5
-t14.5 -5q14 -1 15.5 11t-7.5 20q12 -1 3 17q-4 7 -8 9q-12 4 -27 -5q-8 -4 2 -8q-1 1 -9.5 -10.5t-16.5 -17.5t-16 5q-1 1 -5.5 13.5t-9.5 13.5q-8 0 -16 -15q3 8 -11 15t-24 8q19 12 -8 27q-7 4 -20.5 5t-19.5 -4q-5 -7 -5.5 -11.5t5 -8t10.5 -5.5t11.5 -4t8.5 -3
-q14 -10 8 -14q-2 -1 -8.5 -3.5t-11.5 -4.5t-6 -4q-3 -4 0 -14t-2 -14q-5 5 -9 17.5t-7 16.5q7 -9 -25 -6l-10 1q-4 0 -16 -2t-20.5 -1t-13.5 8q-4 8 0 20q1 4 4 2q-4 3 -11 9.5t-10 8.5q-46 -15 -94 -41q6 -1 12 1q5 2 13 6.5t10 5.5q34 14 42 7l5 5q14 -16 20 -25
-q-7 4 -30 1q-20 -6 -22 -12q7 -12 5 -18q-4 3 -11.5 10t-14.5 11t-15 5q-16 0 -22 -1q-146 -80 -235 -222q7 -7 12 -8q4 -1 5 -9t2.5 -11t11.5 3q9 -8 3 -19q1 1 44 -27q19 -17 21 -21q3 -11 -10 -18q-1 2 -9 9t-9 4q-3 -5 0.5 -18.5t10.5 -12.5q-7 0 -9.5 -16t-2.5 -35.5
-t-1 -23.5l2 -1q-3 -12 5.5 -34.5t21.5 -19.5q-13 -3 20 -43q6 -8 8 -9q3 -2 12 -7.5t15 -10t10 -10.5q4 -5 10 -22.5t14 -23.5q-2 -6 9.5 -20t10.5 -23q-1 0 -2.5 -1t-2.5 -1q3 -7 15.5 -14t15.5 -13q1 -3 2 -10t3 -11t8 -2q2 20 -24 62q-15 25 -17 29q-3 5 -5.5 15.5
-t-4.5 14.5q2 0 6 -1.5t8.5 -3.5t7.5 -4t2 -3q-3 -7 2 -17.5t12 -18.5t17 -19t12 -13q6 -6 14 -19.5t0 -13.5q9 0 20 -10.5t17 -19.5q5 -8 8 -26t5 -24q2 -7 8.5 -13.5t12.5 -9.5l16 -8t13 -7q5 -2 18.5 -10.5t21.5 -11.5q10 -4 16 -4t14.5 2.5t13.5 3.5q15 2 29 -15t21 -21
-q36 -19 55 -11q-2 -1 0.5 -7.5t8 -15.5t9 -14.5t5.5 -8.5q5 -6 18 -15t18 -15q6 4 7 9q-3 -8 7 -20t18 -10q14 3 14 32q-31 -15 -49 18q0 1 -2.5 5.5t-4 8.5t-2.5 8.5t0 7.5t5 3q9 0 10 3.5t-2 12.5t-4 13q-1 8 -11 20t-12 15q-5 -9 -16 -8t-16 9q0 -1 -1.5 -5.5t-1.5 -6.5
-q-13 0 -15 1q1 3 2.5 17.5t3.5 22.5q1 4 5.5 12t7.5 14.5t4 12.5t-4.5 9.5t-17.5 2.5q-19 -1 -26 -20q-1 -3 -3 -10.5t-5 -11.5t-9 -7q-7 -3 -24 -2t-24 5q-13 8 -22.5 29t-9.5 37q0 10 2.5 26.5t3 25t-5.5 24.5q3 2 9 9.5t10 10.5q2 1 4.5 1.5t4.5 0t4 1.5t3 6q-1 1 -4 3
-q-3 3 -4 3q7 -3 28.5 1.5t27.5 -1.5q15 -11 22 2q0 1 -2.5 9.5t-0.5 13.5q5 -27 29 -9q3 -3 15.5 -5t17.5 -5q3 -2 7 -5.5t5.5 -4.5t5 0.5t8.5 6.5q10 -14 12 -24q11 -40 19 -44q7 -3 11 -2t4.5 9.5t0 14t-1.5 12.5l-1 8v18l-1 8q-15 3 -18.5 12t1.5 18.5t15 18.5q1 1 8 3.5
-t15.5 6.5t12.5 8q21 19 15 35q7 0 11 9q-1 0 -5 3t-7.5 5t-4.5 2q9 5 2 16q5 3 7.5 11t7.5 10q9 -12 21 -2q8 8 1 16q5 7 20.5 10.5t18.5 9.5q7 -2 8 2t1 12t3 12q4 5 15 9t13 5l17 11q3 4 0 4q18 -2 31 11q10 11 -6 20q3 6 -3 9.5t-15 5.5q3 1 11.5 0.5t10.5 1.5
-q15 10 -7 16q-17 5 -43 -12zM879 10q206 36 351 189q-3 3 -12.5 4.5t-12.5 3.5q-18 7 -24 8q1 7 -2.5 13t-8 9t-12.5 8t-11 7q-2 2 -7 6t-7 5.5t-7.5 4.5t-8.5 2t-10 -1l-3 -1q-3 -1 -5.5 -2.5t-5.5 -3t-4 -3t0 -2.5q-21 17 -36 22q-5 1 -11 5.5t-10.5 7t-10 1.5t-11.5 -7
-q-5 -5 -6 -15t-2 -13q-7 5 0 17.5t2 18.5q-3 6 -10.5 4.5t-12 -4.5t-11.5 -8.5t-9 -6.5t-8.5 -5.5t-8.5 -7.5q-3 -4 -6 -12t-5 -11q-2 4 -11.5 6.5t-9.5 5.5q2 -10 4 -35t5 -38q7 -31 -12 -48q-27 -25 -29 -40q-4 -22 12 -26q0 -7 -8 -20.5t-7 -21.5q0 -6 2 -16z" />
-    <glyph glyph-name="wrench" unicode="&#xf0ad;" horiz-adv-x="1664" 
-d="M384 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1028 484l-682 -682q-37 -37 -90 -37q-52 0 -91 37l-106 108q-38 36 -38 90q0 53 38 91l681 681q39 -98 114.5 -173.5t173.5 -114.5zM1662 919q0 -39 -23 -106q-47 -134 -164.5 -217.5
-t-258.5 -83.5q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q58 0 121.5 -16.5t107.5 -46.5q16 -11 16 -28t-16 -28l-293 -169v-224l193 -107q5 3 79 48.5t135.5 81t70.5 35.5q15 0 23.5 -10t8.5 -25z" />
-    <glyph glyph-name="tasks" unicode="&#xf0ae;" horiz-adv-x="1792" 
-d="M1024 128h640v128h-640v-128zM640 640h1024v128h-1024v-128zM1280 1152h384v128h-384v-128zM1792 320v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 832v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19
-t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="filter" unicode="&#xf0b0;" horiz-adv-x="1408" 
-d="M1403 1241q17 -41 -14 -70l-493 -493v-742q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-256 256q-19 19 -19 45v486l-493 493q-31 29 -14 70q17 39 59 39h1280q42 0 59 -39z" />
-    <glyph glyph-name="briefcase" unicode="&#xf0b1;" horiz-adv-x="1792" 
-d="M640 1280h512v128h-512v-128zM1792 640v-480q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v480h672v-160q0 -26 19 -45t45 -19h320q26 0 45 19t19 45v160h672zM1024 640v-128h-256v128h256zM1792 1120v-384h-1792v384q0 66 47 113t113 47h352v160q0 40 28 68
-t68 28h576q40 0 68 -28t28 -68v-160h352q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="fullscreen" unicode="&#xf0b2;" 
-d="M1283 995l-355 -355l355 -355l144 144q29 31 70 14q39 -17 39 -59v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l144 144l-355 355l-355 -355l144 -144q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l144 -144
-l355 355l-355 355l-144 -144q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v448q0 26 19 45t45 19h448q42 0 59 -40q17 -39 -14 -69l-144 -144l355 -355l355 355l-144 144q-31 30 -14 69q17 40 59 40h448q26 0 45 -19t19 -45v-448q0 -42 -39 -59q-13 -5 -25 -5q-26 0 -45 19z
-" />
-    <glyph glyph-name="group" unicode="&#xf0c0;" horiz-adv-x="1920" 
-d="M593 640q-162 -5 -265 -128h-134q-82 0 -138 40.5t-56 118.5q0 353 124 353q6 0 43.5 -21t97.5 -42.5t119 -21.5q67 0 133 23q-5 -37 -5 -66q0 -139 81 -256zM1664 3q0 -120 -73 -189.5t-194 -69.5h-874q-121 0 -194 69.5t-73 189.5q0 53 3.5 103.5t14 109t26.5 108.5
-t43 97.5t62 81t85.5 53.5t111.5 20q10 0 43 -21.5t73 -48t107 -48t135 -21.5t135 21.5t107 48t73 48t43 21.5q61 0 111.5 -20t85.5 -53.5t62 -81t43 -97.5t26.5 -108.5t14 -109t3.5 -103.5zM640 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75
-t75 -181zM1344 896q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5zM1920 671q0 -78 -56 -118.5t-138 -40.5h-134q-103 123 -265 128q81 117 81 256q0 29 -5 66q66 -23 133 -23q59 0 119 21.5t97.5 42.5
-t43.5 21q124 0 124 -353zM1792 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181z" />
-    <glyph glyph-name="link" unicode="&#xf0c1;" horiz-adv-x="1664" 
-d="M1456 320q0 40 -28 68l-208 208q-28 28 -68 28q-42 0 -72 -32q3 -3 19 -18.5t21.5 -21.5t15 -19t13 -25.5t3.5 -27.5q0 -40 -28 -68t-68 -28q-15 0 -27.5 3.5t-25.5 13t-19 15t-21.5 21.5t-18.5 19q-33 -31 -33 -73q0 -40 28 -68l206 -207q27 -27 68 -27q40 0 68 26
-l147 146q28 28 28 67zM753 1025q0 40 -28 68l-206 207q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l208 -208q27 -27 68 -27q42 0 72 31q-3 3 -19 18.5t-21.5 21.5t-15 19t-13 25.5t-3.5 27.5q0 40 28 68t68 28q15 0 27.5 -3.5t25.5 -13t19 -15
-t21.5 -21.5t18.5 -19q33 31 33 73zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-206 207q-83 83 -83 203q0 123 88 209l-88 88q-86 -88 -208 -88q-120 0 -204 84l-208 208q-84 84 -84 204t85 203l147 146q83 83 203 83q121 0 204 -85l206 -207
-q83 -83 83 -203q0 -123 -88 -209l88 -88q86 88 208 88q120 0 204 -84l208 -208q84 -84 84 -204z" />
-    <glyph glyph-name="cloud" unicode="&#xf0c2;" horiz-adv-x="1920" 
-d="M1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088q-185 0 -316.5 131.5t-131.5 316.5q0 132 71 241.5t187 163.5q-2 28 -2 43q0 212 150 362t362 150q158 0 286.5 -88t187.5 -230q70 62 166 62q106 0 181 -75t75 -181q0 -75 -41 -138q129 -30 213 -134.5t84 -239.5z
-" />
-    <glyph glyph-name="beaker" unicode="&#xf0c3;" horiz-adv-x="1664" 
-d="M1527 88q56 -89 21.5 -152.5t-140.5 -63.5h-1152q-106 0 -140.5 63.5t21.5 152.5l503 793v399h-64q-26 0 -45 19t-19 45t19 45t45 19h512q26 0 45 -19t19 -45t-19 -45t-45 -19h-64v-399zM748 813l-272 -429h712l-272 429l-20 31v37v399h-128v-399v-37z" />
-    <glyph glyph-name="cut" unicode="&#xf0c4;" horiz-adv-x="1792" 
-d="M960 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1260 576l507 -398q28 -20 25 -56q-5 -35 -35 -51l-128 -64q-13 -7 -29 -7q-17 0 -31 8l-690 387l-110 -66q-8 -4 -12 -5q14 -49 10 -97q-7 -77 -56 -147.5t-132 -123.5q-132 -84 -277 -84
-q-136 0 -222 78q-90 84 -79 207q7 76 56 147t131 124q132 84 278 84q83 0 151 -31q9 13 22 22l122 73l-122 73q-13 9 -22 22q-68 -31 -151 -31q-146 0 -278 84q-82 53 -131 124t-56 147q-5 59 15.5 113t63.5 93q85 79 222 79q145 0 277 -84q83 -52 132 -123t56 -148
-q4 -48 -10 -97q4 -1 12 -5l110 -66l690 387q14 8 31 8q16 0 29 -7l128 -64q30 -16 35 -51q3 -36 -25 -56zM579 836q46 42 21 108t-106 117q-92 59 -192 59q-74 0 -113 -36q-46 -42 -21 -108t106 -117q92 -59 192 -59q74 0 113 36zM494 91q81 51 106 117t-21 108
-q-39 36 -113 36q-100 0 -192 -59q-81 -51 -106 -117t21 -108q39 -36 113 -36q100 0 192 59zM672 704l96 -58v11q0 36 33 56l14 8l-79 47l-26 -26q-3 -3 -10 -11t-12 -12q-2 -2 -4 -3.5t-3 -2.5zM896 480l96 -32l736 576l-128 64l-768 -431v-113l-160 -96l9 -8q2 -2 7 -6
-q4 -4 11 -12t11 -12l26 -26zM1600 64l128 64l-520 408l-177 -138q-2 -3 -13 -7z" />
-    <glyph glyph-name="copy" unicode="&#xf0c5;" horiz-adv-x="1792" 
-d="M1696 1152q40 0 68 -28t28 -68v-1216q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v288h-544q-40 0 -68 28t-28 68v672q0 40 20 88t48 76l408 408q28 28 76 48t88 20h416q40 0 68 -28t28 -68v-328q68 40 128 40h416zM1152 939l-299 -299h299v299zM512 1323l-299 -299
-h299v299zM708 676l316 316v416h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h512v256q0 40 20 88t48 76zM1664 -128v1152h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h896z" />
-    <glyph glyph-name="paper_clip" unicode="&#xf0c6;" horiz-adv-x="1408" 
-d="M1404 151q0 -117 -79 -196t-196 -79q-135 0 -235 100l-777 776q-113 115 -113 271q0 159 110 270t269 111q158 0 273 -113l605 -606q10 -10 10 -22q0 -16 -30.5 -46.5t-46.5 -30.5q-13 0 -23 10l-606 607q-79 77 -181 77q-106 0 -179 -75t-73 -181q0 -105 76 -181
-l776 -777q63 -63 145 -63q64 0 106 42t42 106q0 82 -63 145l-581 581q-26 24 -60 24q-29 0 -48 -19t-19 -48q0 -32 25 -59l410 -410q10 -10 10 -22q0 -16 -31 -47t-47 -31q-12 0 -22 10l-410 410q-63 61 -63 149q0 82 57 139t139 57q88 0 149 -63l581 -581q100 -98 100 -235
-z" />
-    <glyph glyph-name="save" unicode="&#xf0c7;" 
-d="M384 0h768v384h-768v-384zM1280 0h128v896q0 14 -10 38.5t-20 34.5l-281 281q-10 10 -34 20t-39 10v-416q0 -40 -28 -68t-68 -28h-576q-40 0 -68 28t-28 68v416h-128v-1280h128v416q0 40 28 68t68 28h832q40 0 68 -28t28 -68v-416zM896 928v320q0 13 -9.5 22.5t-22.5 9.5
-h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5zM1536 896v-928q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h928q40 0 88 -20t76 -48l280 -280q28 -28 48 -76t20 -88z" />
-    <glyph glyph-name="sign_blank" unicode="&#xf0c8;" 
-d="M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="reorder" unicode="&#xf0c9;" 
-d="M1536 192v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 704v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 1216v-128q0 -26 -19 -45
-t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="ul" unicode="&#xf0ca;" horiz-adv-x="1792" 
-d="M384 128q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 640q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5
-t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1152q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z
-M1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="ol" unicode="&#xf0cb;" horiz-adv-x="1792" 
-d="M381 -84q0 -80 -54.5 -126t-135.5 -46q-106 0 -172 66l57 88q49 -45 106 -45q29 0 50.5 14.5t21.5 42.5q0 64 -105 56l-26 56q8 10 32.5 43.5t42.5 54t37 38.5v1q-16 0 -48.5 -1t-48.5 -1v-53h-106v152h333v-88l-95 -115q51 -12 81 -49t30 -88zM383 543v-159h-362
-q-6 36 -6 54q0 51 23.5 93t56.5 68t66 47.5t56.5 43.5t23.5 45q0 25 -14.5 38.5t-39.5 13.5q-46 0 -81 -58l-85 59q24 51 71.5 79.5t105.5 28.5q73 0 123 -41.5t50 -112.5q0 -50 -34 -91.5t-75 -64.5t-75.5 -50.5t-35.5 -52.5h127v60h105zM1792 224v-192q0 -13 -9.5 -22.5
-t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1123v-99h-335v99h107q0 41 0.5 121.5t0.5 121.5v12h-2q-8 -17 -50 -54l-71 76l136 127h106v-404h108zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216
-q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="strikethrough" unicode="&#xf0cc;" horiz-adv-x="1792" 
-d="M1760 640q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h1728zM483 704q-28 35 -51 80q-48 98 -48 188q0 181 134 309q133 127 393 127q50 0 167 -19q66 -12 177 -48q10 -38 21 -118q14 -123 14 -183q0 -18 -5 -45l-12 -3l-84 6
-l-14 2q-50 149 -103 205q-88 91 -210 91q-114 0 -182 -59q-67 -58 -67 -146q0 -73 66 -140t279 -129q69 -20 173 -66q58 -28 95 -52h-743zM990 448h411q7 -39 7 -92q0 -111 -41 -212q-23 -56 -71 -104q-37 -35 -109 -81q-80 -48 -153 -66q-80 -21 -203 -21q-114 0 -195 23
-l-140 40q-57 16 -72 28q-8 8 -8 22v13q0 108 -2 156q-1 30 0 68l2 37v44l102 2q15 -34 30 -71t22.5 -56t12.5 -27q35 -57 80 -94q43 -36 105 -57q59 -22 132 -22q64 0 139 27q77 26 122 86q47 61 47 129q0 84 -81 157q-34 29 -137 71z" />
-    <glyph glyph-name="underline" unicode="&#xf0cd;" 
-d="M48 1313q-37 2 -45 4l-3 88q13 1 40 1q60 0 112 -4q132 -7 166 -7q86 0 168 3q116 4 146 5q56 0 86 2l-1 -14l2 -64v-9q-60 -9 -124 -9q-60 0 -79 -25q-13 -14 -13 -132q0 -13 0.5 -32.5t0.5 -25.5l1 -229l14 -280q6 -124 51 -202q35 -59 96 -92q88 -47 177 -47
-q104 0 191 28q56 18 99 51q48 36 65 64q36 56 53 114q21 73 21 229q0 79 -3.5 128t-11 122.5t-13.5 159.5l-4 59q-5 67 -24 88q-34 35 -77 34l-100 -2l-14 3l2 86h84l205 -10q76 -3 196 10l18 -2q6 -38 6 -51q0 -7 -4 -31q-45 -12 -84 -13q-73 -11 -79 -17q-15 -15 -15 -41
-q0 -7 1.5 -27t1.5 -31q8 -19 22 -396q6 -195 -15 -304q-15 -76 -41 -122q-38 -65 -112 -123q-75 -57 -182 -89q-109 -33 -255 -33q-167 0 -284 46q-119 47 -179 122q-61 76 -83 195q-16 80 -16 237v333q0 188 -17 213q-25 36 -147 39zM1536 -96v64q0 14 -9 23t-23 9h-1472
-q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h1472q14 0 23 9t9 23z" />
-    <glyph glyph-name="table" unicode="&#xf0ce;" horiz-adv-x="1664" 
-d="M512 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23
-v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 160v192
-q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192
-q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1664 1248v-1088q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1344q66 0 113 -47t47 -113
-z" />
-    <glyph glyph-name="magic" unicode="&#xf0d0;" horiz-adv-x="1664" 
-d="M1190 955l293 293l-107 107l-293 -293zM1637 1248q0 -27 -18 -45l-1286 -1286q-18 -18 -45 -18t-45 18l-198 198q-18 18 -18 45t18 45l1286 1286q18 18 45 18t45 -18l198 -198q18 -18 18 -45zM286 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM636 1276
-l196 -60l-196 -60l-60 -196l-60 196l-196 60l196 60l60 196zM1566 798l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM926 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98z" />
-    <glyph glyph-name="truck" unicode="&#xf0d1;" horiz-adv-x="1792" 
-d="M640 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM256 640h384v256h-158q-13 0 -22 -9l-195 -195q-9 -9 -9 -22v-30zM1536 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1792 1216v-1024q0 -15 -4 -26.5t-13.5 -18.5
-t-16.5 -11.5t-23.5 -6t-22.5 -2t-25.5 0t-22.5 0.5q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-64q-3 0 -22.5 -0.5t-25.5 0t-22.5 2t-23.5 6t-16.5 11.5t-13.5 18.5t-4 26.5q0 26 19 45t45 19v320q0 8 -0.5 35t0 38
-t2.5 34.5t6.5 37t14 30.5t22.5 30l198 198q19 19 50.5 32t58.5 13h160v192q0 26 19 45t45 19h1024q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="pinterest" unicode="&#xf0d2;" 
-d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103q-111 0 -218 32q59 93 78 164q9 34 54 211q20 -39 73 -67.5t114 -28.5q121 0 216 68.5t147 188.5t52 270q0 114 -59.5 214t-172.5 163t-255 63q-105 0 -196 -29t-154.5 -77t-109 -110.5t-67 -129.5t-21.5 -134
-q0 -104 40 -183t117 -111q30 -12 38 20q2 7 8 31t8 30q6 23 -11 43q-51 61 -51 151q0 151 104.5 259.5t273.5 108.5q151 0 235.5 -82t84.5 -213q0 -170 -68.5 -289t-175.5 -119q-61 0 -98 43.5t-23 104.5q8 35 26.5 93.5t30 103t11.5 75.5q0 50 -27 83t-77 33
-q-62 0 -105 -57t-43 -142q0 -73 25 -122l-99 -418q-17 -70 -13 -177q-206 91 -333 281t-127 423q0 209 103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="pinterest_sign" unicode="&#xf0d3;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-725q85 122 108 210q9 34 53 209q21 -39 73.5 -67t112.5 -28q181 0 295.5 147.5t114.5 373.5q0 84 -35 162.5t-96.5 139t-152.5 97t-197 36.5q-104 0 -194.5 -28.5t-153 -76.5
-t-107.5 -109.5t-66.5 -128t-21.5 -132.5q0 -102 39.5 -180t116.5 -110q13 -5 23.5 0t14.5 19q10 44 15 61q6 23 -11 42q-50 62 -50 150q0 150 103.5 256.5t270.5 106.5q149 0 232.5 -81t83.5 -210q0 -168 -67.5 -286t-173.5 -118q-60 0 -97 43.5t-23 103.5q8 34 26.5 92.5
-t29.5 102t11 74.5q0 49 -26.5 81.5t-75.5 32.5q-61 0 -103.5 -56.5t-42.5 -139.5q0 -72 24 -121l-98 -414q-24 -100 -7 -254h-183q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960z" />
-    <glyph glyph-name="google_plus_sign" unicode="&#xf0d4;" 
-d="M917 631q0 26 -6 64h-362v-132h217q-3 -24 -16.5 -50t-37.5 -53t-66.5 -44.5t-96.5 -17.5q-99 0 -169 71t-70 171t70 171t169 71q92 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585
-h109v110h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="google_plus" unicode="&#xf0d5;" horiz-adv-x="2304" 
-d="M1437 623q0 -208 -87 -370.5t-248 -254t-369 -91.5q-149 0 -285 58t-234 156t-156 234t-58 285t58 285t156 234t234 156t285 58q286 0 491 -192l-199 -191q-117 113 -292 113q-123 0 -227.5 -62t-165.5 -168.5t-61 -232.5t61 -232.5t165.5 -168.5t227.5 -62
-q83 0 152.5 23t114.5 57.5t78.5 78.5t49 83t21.5 74h-416v252h692q12 -63 12 -122zM2304 745v-210h-209v-209h-210v209h-209v210h209v209h210v-209h209z" />
-    <glyph glyph-name="money" unicode="&#xf0d6;" horiz-adv-x="1920" 
-d="M768 384h384v96h-128v448h-114l-148 -137l77 -80q42 37 55 57h2v-288h-128v-96zM1280 640q0 -70 -21 -142t-59.5 -134t-101.5 -101t-138 -39t-138 39t-101.5 101t-59.5 134t-21 142t21 142t59.5 134t101.5 101t138 39t138 -39t101.5 -101t59.5 -134t21 -142zM1792 384
-v512q-106 0 -181 75t-75 181h-1152q0 -106 -75 -181t-181 -75v-512q106 0 181 -75t75 -181h1152q0 106 75 181t181 75zM1920 1216v-1152q0 -26 -19 -45t-45 -19h-1792q-26 0 -45 19t-19 45v1152q0 26 19 45t45 19h1792q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="caret_down" unicode="&#xf0d7;" horiz-adv-x="1024" 
-d="M1024 832q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="caret_up" unicode="&#xf0d8;" horiz-adv-x="1024" 
-d="M1024 320q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="caret_left" unicode="&#xf0d9;" horiz-adv-x="640" 
-d="M640 1088v-896q0 -26 -19 -45t-45 -19t-45 19l-448 448q-19 19 -19 45t19 45l448 448q19 19 45 19t45 -19t19 -45z" />
-    <glyph glyph-name="caret_right" unicode="&#xf0da;" horiz-adv-x="640" 
-d="M576 640q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19t-19 45v896q0 26 19 45t45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="columns" unicode="&#xf0db;" horiz-adv-x="1664" 
-d="M160 0h608v1152h-640v-1120q0 -13 9.5 -22.5t22.5 -9.5zM1536 32v1120h-640v-1152h608q13 0 22.5 9.5t9.5 22.5zM1664 1248v-1216q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1344q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="sort" unicode="&#xf0dc;" horiz-adv-x="1024" 
-d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45zM1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="sort_down" unicode="&#xf0dd;" horiz-adv-x="1024" 
-d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="sort_up" unicode="&#xf0de;" horiz-adv-x="1024" 
-d="M1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="envelope_alt" unicode="&#xf0e0;" horiz-adv-x="1792" 
-d="M1792 826v-794q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v794q44 -49 101 -87q362 -246 497 -345q57 -42 92.5 -65.5t94.5 -48t110 -24.5h1h1q51 0 110 24.5t94.5 48t92.5 65.5q170 123 498 345q57 39 100 87zM1792 1120q0 -79 -49 -151t-122 -123
-q-376 -261 -468 -325q-10 -7 -42.5 -30.5t-54 -38t-52 -32.5t-57.5 -27t-50 -9h-1h-1q-23 0 -50 9t-57.5 27t-52 32.5t-54 38t-42.5 30.5q-91 64 -262 182.5t-205 142.5q-62 42 -117 115.5t-55 136.5q0 78 41.5 130t118.5 52h1472q65 0 112.5 -47t47.5 -113z" />
-    <glyph glyph-name="linkedin" unicode="&#xf0e1;" 
-d="M349 911v-991h-330v991h330zM370 1217q1 -73 -50.5 -122t-135.5 -49h-2q-82 0 -132 49t-50 122q0 74 51.5 122.5t134.5 48.5t133 -48.5t51 -122.5zM1536 488v-568h-329v530q0 105 -40.5 164.5t-126.5 59.5q-63 0 -105.5 -34.5t-63.5 -85.5q-11 -30 -11 -81v-553h-329
-q2 399 2 647t-1 296l-1 48h329v-144h-2q20 32 41 56t56.5 52t87 43.5t114.5 15.5q171 0 275 -113.5t104 -332.5z" />
-    <glyph glyph-name="undo" unicode="&#xf0e2;" 
-d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5
-t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298z" />
-    <glyph glyph-name="legal" unicode="&#xf0e3;" horiz-adv-x="1792" 
-d="M1771 0q0 -53 -37 -90l-107 -108q-39 -37 -91 -37q-53 0 -90 37l-363 364q-38 36 -38 90q0 53 43 96l-256 256l-126 -126q-14 -14 -34 -14t-34 14q2 -2 12.5 -12t12.5 -13t10 -11.5t10 -13.5t6 -13.5t5.5 -16.5t1.5 -18q0 -38 -28 -68q-3 -3 -16.5 -18t-19 -20.5
-t-18.5 -16.5t-22 -15.5t-22 -9t-26 -4.5q-40 0 -68 28l-408 408q-28 28 -28 68q0 13 4.5 26t9 22t15.5 22t16.5 18.5t20.5 19t18 16.5q30 28 68 28q10 0 18 -1.5t16.5 -5.5t13.5 -6t13.5 -10t11.5 -10t13 -12.5t12 -12.5q-14 14 -14 34t14 34l348 348q14 14 34 14t34 -14
-q-2 2 -12.5 12t-12.5 13t-10 11.5t-10 13.5t-6 13.5t-5.5 16.5t-1.5 18q0 38 28 68q3 3 16.5 18t19 20.5t18.5 16.5t22 15.5t22 9t26 4.5q40 0 68 -28l408 -408q28 -28 28 -68q0 -13 -4.5 -26t-9 -22t-15.5 -22t-16.5 -18.5t-20.5 -19t-18 -16.5q-30 -28 -68 -28
-q-10 0 -18 1.5t-16.5 5.5t-13.5 6t-13.5 10t-11.5 10t-13 12.5t-12 12.5q14 -14 14 -34t-14 -34l-126 -126l256 -256q43 43 96 43q52 0 91 -37l363 -363q37 -39 37 -91z" />
-    <glyph glyph-name="dashboard" unicode="&#xf0e4;" horiz-adv-x="1792" 
-d="M384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM576 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1004 351l101 382q6 26 -7.5 48.5t-38.5 29.5
-t-48 -6.5t-30 -39.5l-101 -382q-60 -5 -107 -43.5t-63 -98.5q-20 -77 20 -146t117 -89t146 20t89 117q16 60 -6 117t-72 91zM1664 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 1024q0 53 -37.5 90.5
-t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1472 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 384q0 -261 -141 -483q-19 -29 -54 -29h-1402q-35 0 -54 29
-q-141 221 -141 483q0 182 71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="comment_alt" unicode="&#xf0e5;" horiz-adv-x="1792" 
-d="M896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640
-q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 174 120 321.5
-t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
-    <glyph glyph-name="comments_alt" unicode="&#xf0e6;" horiz-adv-x="1792" 
-d="M704 1152q-153 0 -286 -52t-211.5 -141t-78.5 -191q0 -82 53 -158t149 -132l97 -56l-35 -84q34 20 62 39l44 31l53 -10q78 -14 153 -14q153 0 286 52t211.5 141t78.5 191t-78.5 191t-211.5 141t-286 52zM704 1280q191 0 353.5 -68.5t256.5 -186.5t94 -257t-94 -257
-t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224q0 139 94 257t256.5 186.5
-t353.5 68.5zM1526 111q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129
-q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230q0 -120 -71 -224.5t-195 -176.5z" />
-    <glyph glyph-name="bolt" unicode="&#xf0e7;" horiz-adv-x="896" 
-d="M885 970q18 -20 7 -44l-540 -1157q-13 -25 -42 -25q-4 0 -14 2q-17 5 -25.5 19t-4.5 30l197 808l-406 -101q-4 -1 -12 -1q-18 0 -31 11q-18 15 -13 39l201 825q4 14 16 23t28 9h328q19 0 32 -12.5t13 -29.5q0 -8 -5 -18l-171 -463l396 98q8 2 12 2q19 0 34 -15z" />
-    <glyph glyph-name="sitemap" unicode="&#xf0e8;" horiz-adv-x="1792" 
-d="M1792 288v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320
-q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192q0 52 38 90t90 38h512v192h-96q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h320q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-96v-192h512q52 0 90 -38t38 -90v-192h96q40 0 68 -28t28 -68
-z" />
-    <glyph glyph-name="umbrella" unicode="&#xf0e9;" horiz-adv-x="1664" 
-d="M896 708v-580q0 -104 -76 -180t-180 -76t-180 76t-76 180q0 26 19 45t45 19t45 -19t19 -45q0 -50 39 -89t89 -39t89 39t39 89v580q33 11 64 11t64 -11zM1664 681q0 -13 -9.5 -22.5t-22.5 -9.5q-11 0 -23 10q-49 46 -93 69t-102 23q-68 0 -128 -37t-103 -97
-q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -28 -17q-18 0 -29 17q-4 6 -14.5 24t-17.5 28q-43 60 -102.5 97t-127.5 37t-127.5 -37t-102.5 -97q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -29 -17q-17 0 -28 17q-4 6 -14.5 24t-17.5 28q-43 60 -103 97t-128 37q-58 0 -102 -23t-93 -69
-q-12 -10 -23 -10q-13 0 -22.5 9.5t-9.5 22.5q0 5 1 7q45 183 172.5 319.5t298 204.5t360.5 68q140 0 274.5 -40t246.5 -113.5t194.5 -187t115.5 -251.5q1 -2 1 -7zM896 1408v-98q-42 2 -64 2t-64 -2v98q0 26 19 45t45 19t45 -19t19 -45z" />
-    <glyph glyph-name="paste" unicode="&#xf0ea;" horiz-adv-x="1792" 
-d="M768 -128h896v640h-416q-40 0 -68 28t-28 68v416h-384v-1152zM1024 1312v64q0 13 -9.5 22.5t-22.5 9.5h-704q-13 0 -22.5 -9.5t-9.5 -22.5v-64q0 -13 9.5 -22.5t22.5 -9.5h704q13 0 22.5 9.5t9.5 22.5zM1280 640h299l-299 299v-299zM1792 512v-672q0 -40 -28 -68t-68 -28
-h-960q-40 0 -68 28t-28 68v160h-544q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1088q40 0 68 -28t28 -68v-328q21 -13 36 -28l408 -408q28 -28 48 -76t20 -88z" />
-    <glyph glyph-name="light_bulb" unicode="&#xf0eb;" horiz-adv-x="1024" 
-d="M736 960q0 -13 -9.5 -22.5t-22.5 -9.5t-22.5 9.5t-9.5 22.5q0 46 -54 71t-106 25q-13 0 -22.5 9.5t-9.5 22.5t9.5 22.5t22.5 9.5q50 0 99.5 -16t87 -54t37.5 -90zM896 960q0 72 -34.5 134t-90 101.5t-123 62t-136.5 22.5t-136.5 -22.5t-123 -62t-90 -101.5t-34.5 -134
-q0 -101 68 -180q10 -11 30.5 -33t30.5 -33q128 -153 141 -298h228q13 145 141 298q10 11 30.5 33t30.5 33q68 79 68 180zM1024 960q0 -155 -103 -268q-45 -49 -74.5 -87t-59.5 -95.5t-34 -107.5q47 -28 47 -82q0 -37 -25 -64q25 -27 25 -64q0 -52 -45 -81q13 -23 13 -47
-q0 -46 -31.5 -71t-77.5 -25q-20 -44 -60 -70t-87 -26t-87 26t-60 70q-46 0 -77.5 25t-31.5 71q0 24 13 47q-45 29 -45 81q0 37 25 64q-25 27 -25 64q0 54 47 82q-4 50 -34 107.5t-59.5 95.5t-74.5 87q-103 113 -103 268q0 99 44.5 184.5t117 142t164 89t186.5 32.5
-t186.5 -32.5t164 -89t117 -142t44.5 -184.5z" />
-    <glyph glyph-name="exchange" unicode="&#xf0ec;" horiz-adv-x="1792" 
-d="M1792 352v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5q-12 0 -24 10l-319 320q-9 9 -9 22q0 14 9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h1376q13 0 22.5 -9.5t9.5 -22.5zM1792 896q0 -14 -9 -23l-320 -320q-9 -9 -23 -9
-q-13 0 -22.5 9.5t-9.5 22.5v192h-1376q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1376v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
-    <glyph glyph-name="cloud_download" unicode="&#xf0ed;" horiz-adv-x="1920" 
-d="M1280 608q0 14 -9 23t-23 9h-224v352q0 13 -9.5 22.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-352h-224q-13 0 -22.5 -9.5t-9.5 -22.5q0 -14 9 -23l352 -352q9 -9 23 -9t23 9l351 351q10 12 10 24zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088
-q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
-    <glyph glyph-name="cloud_upload" unicode="&#xf0ee;" horiz-adv-x="1920" 
-d="M1280 672q0 14 -9 23l-352 352q-9 9 -23 9t-23 -9l-351 -351q-10 -12 -10 -24q0 -14 9 -23t23 -9h224v-352q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5v352h224q13 0 22.5 9.5t9.5 22.5zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088
-q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
-    <glyph glyph-name="user_md" unicode="&#xf0f0;" horiz-adv-x="1408" 
-d="M384 192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 68 5.5 131t24 138t47.5 132.5t81 103t120 60.5q-22 -52 -22 -120v-203q-58 -20 -93 -70t-35 -111q0 -80 56 -136t136 -56
-t136 56t56 136q0 61 -35.5 111t-92.5 70v203q0 62 25 93q132 -104 295 -104t295 104q25 -31 25 -93v-64q-106 0 -181 -75t-75 -181v-89q-32 -29 -32 -71q0 -40 28 -68t68 -28t68 28t28 68q0 42 -32 71v89q0 52 38 90t90 38t90 -38t38 -90v-89q-32 -29 -32 -71q0 -40 28 -68
-t68 -28t68 28t28 68q0 42 -32 71v89q0 68 -34.5 127.5t-93.5 93.5q0 10 0.5 42.5t0 48t-2.5 41.5t-7 47t-13 40q68 -15 120 -60.5t81 -103t47.5 -132.5t24 -138t5.5 -131zM1088 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5
-t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="stethoscope" unicode="&#xf0f1;" horiz-adv-x="1408" 
-d="M1280 832q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 832q0 -62 -35.5 -111t-92.5 -70v-395q0 -159 -131.5 -271.5t-316.5 -112.5t-316.5 112.5t-131.5 271.5v132q-164 20 -274 128t-110 252v512q0 26 19 45t45 19q6 0 16 -2q17 30 47 48
-t65 18q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5q-33 0 -64 18v-402q0 -106 94 -181t226 -75t226 75t94 181v402q-31 -18 -64 -18q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5q35 0 65 -18t47 -48q10 2 16 2q26 0 45 -19t19 -45v-512q0 -144 -110 -252
-t-274 -128v-132q0 -106 94 -181t226 -75t226 75t94 181v395q-57 21 -92.5 70t-35.5 111q0 80 56 136t136 56t136 -56t56 -136z" />
-    <glyph glyph-name="suitcase" unicode="&#xf0f2;" horiz-adv-x="1792" 
-d="M640 1152h512v128h-512v-128zM288 1152v-1280h-64q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h64zM1408 1152v-1280h-1024v1280h128v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h128zM1792 928v-832q0 -92 -66 -158t-158 -66h-64v1280h64q92 0 158 -66
-t66 -158z" />
-    <glyph glyph-name="bell_alt" unicode="&#xf0f3;" horiz-adv-x="1792" 
-d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5
-t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
-    <glyph glyph-name="coffee" unicode="&#xf0f4;" horiz-adv-x="1920" 
-d="M1664 896q0 80 -56 136t-136 56h-64v-384h64q80 0 136 56t56 136zM0 128h1792q0 -106 -75 -181t-181 -75h-1280q-106 0 -181 75t-75 181zM1856 896q0 -159 -112.5 -271.5t-271.5 -112.5h-64v-32q0 -92 -66 -158t-158 -66h-704q-92 0 -158 66t-66 158v736q0 26 19 45
-t45 19h1152q159 0 271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="food" unicode="&#xf0f5;" horiz-adv-x="1408" 
-d="M640 1472v-640q0 -61 -35.5 -111t-92.5 -70v-779q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v779q-57 20 -92.5 70t-35.5 111v640q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45
-t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45zM1408 1472v-1600q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v512h-224q-13 0 -22.5 9.5t-9.5 22.5v800q0 132 94 226t226 94h256q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="file_text_alt" unicode="&#xf0f6;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M384 736q0 14 9 23t23 9h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64zM1120 512q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704zM1120 256q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704
-q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704z" />
-    <glyph glyph-name="building" unicode="&#xf0f7;" horiz-adv-x="1408" 
-d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 -128h384v1536h-1152v-1536h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM1408 1472v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="hospital" unicode="&#xf0f8;" horiz-adv-x="1408" 
-d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 -128h384v1152h-256v-32q0 -40 -28 -68t-68 -28h-448q-40 0 -68 28t-28 68v32h-256v-1152h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM896 1056v320q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-96h-128v96q0 13 -9.5 22.5
-t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5v96h128v-96q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1408 1088v-1280q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1280q0 26 19 45t45 19h320
-v288q0 40 28 68t68 28h448q40 0 68 -28t28 -68v-288h320q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="ambulance" unicode="&#xf0f9;" horiz-adv-x="1920" 
-d="M640 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM256 640h384v256h-158q-14 -2 -22 -9l-195 -195q-7 -12 -9 -22v-30zM1536 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5
-t90.5 37.5t37.5 90.5zM1664 800v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM1920 1344v-1152
-q0 -26 -19 -45t-45 -19h-192q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-128q-26 0 -45 19t-19 45t19 45t45 19v416q0 26 13 58t32 51l198 198q19 19 51 32t58 13h160v320q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="medkit" unicode="&#xf0fa;" horiz-adv-x="1792" 
-d="M1280 416v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM640 1152h512v128h-512v-128zM256 1152v-1280h-32
-q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h32zM1440 1152v-1280h-1088v1280h160v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h160zM1792 928v-832q0 -92 -66 -158t-158 -66h-32v1280h32q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="fighter_jet" unicode="&#xf0fb;" horiz-adv-x="1920" 
-d="M1920 576q-1 -32 -288 -96l-352 -32l-224 -64h-64l-293 -352h69q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-96h-160h-64v32h64v416h-160l-192 -224h-96l-32 32v192h32v32h128v8l-192 24v128l192 24v8h-128v32h-32v192l32 32h96l192 -224h160v416h-64v32h64h160h96
-q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-69l293 -352h64l224 -64l352 -32q128 -28 200 -52t80 -34z" />
-    <glyph glyph-name="beer" unicode="&#xf0fc;" horiz-adv-x="1664" 
-d="M640 640v384h-256v-256q0 -53 37.5 -90.5t90.5 -37.5h128zM1664 192v-192h-1152v192l128 192h-128q-159 0 -271.5 112.5t-112.5 271.5v320l-64 64l32 128h480l32 128h960l32 -192l-64 -32v-800z" />
-    <glyph glyph-name="h_sign" unicode="&#xf0fd;" 
-d="M1280 192v896q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-512v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-896q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h512v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="f0fe" unicode="&#xf0fe;" 
-d="M1280 576v128q0 26 -19 45t-45 19h-320v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-320q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h320v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h320q26 0 45 19t19 45zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="double_angle_left" unicode="&#xf100;" horiz-adv-x="1024" 
-d="M627 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23zM1011 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23
-t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23z" />
-    <glyph glyph-name="double_angle_right" unicode="&#xf101;" horiz-adv-x="1024" 
-d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM979 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23
-l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="double_angle_up" unicode="&#xf102;" horiz-adv-x="1152" 
-d="M1075 224q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM1075 608q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393
-q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="double_angle_down" unicode="&#xf103;" horiz-adv-x="1152" 
-d="M1075 672q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23zM1075 1056q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23
-t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
-    <glyph glyph-name="angle_left" unicode="&#xf104;" horiz-adv-x="640" 
-d="M627 992q0 -13 -10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
-    <glyph glyph-name="angle_right" unicode="&#xf105;" horiz-adv-x="640" 
-d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="angle_up" unicode="&#xf106;" horiz-adv-x="1152" 
-d="M1075 352q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="angle_down" unicode="&#xf107;" horiz-adv-x="1152" 
-d="M1075 800q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
-    <glyph glyph-name="desktop" unicode="&#xf108;" horiz-adv-x="1920" 
-d="M1792 544v832q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1376v-1088q0 -66 -47 -113t-113 -47h-544q0 -37 16 -77.5t32 -71t16 -43.5q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19
-t-19 45q0 14 16 44t32 70t16 78h-544q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="laptop" unicode="&#xf109;" horiz-adv-x="1920" 
-d="M416 256q-66 0 -113 47t-47 113v704q0 66 47 113t113 47h1088q66 0 113 -47t47 -113v-704q0 -66 -47 -113t-113 -47h-1088zM384 1120v-704q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5v704q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5z
-M1760 192h160v-96q0 -40 -47 -68t-113 -28h-1600q-66 0 -113 28t-47 68v96h160h1600zM1040 96q16 0 16 16t-16 16h-160q-16 0 -16 -16t16 -16h160z" />
-    <glyph glyph-name="tablet" unicode="&#xf10a;" horiz-adv-x="1152" 
-d="M640 128q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1024 288v960q0 13 -9.5 22.5t-22.5 9.5h-832q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h832q13 0 22.5 9.5t9.5 22.5zM1152 1248v-1088q0 -66 -47 -113t-113 -47h-832
-q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h832q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="mobile_phone" unicode="&#xf10b;" horiz-adv-x="768" 
-d="M464 128q0 33 -23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5t56.5 23.5t23.5 56.5zM672 288v704q0 13 -9.5 22.5t-22.5 9.5h-512q-13 0 -22.5 -9.5t-9.5 -22.5v-704q0 -13 9.5 -22.5t22.5 -9.5h512q13 0 22.5 9.5t9.5 22.5zM480 1136
-q0 16 -16 16h-160q-16 0 -16 -16t16 -16h160q16 0 16 16zM768 1152v-1024q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v1024q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="circle_blank" unicode="&#xf10c;" 
-d="M768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103
-t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="quote_left" unicode="&#xf10d;" horiz-adv-x="1664" 
-d="M768 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z
-M1664 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z" />
-    <glyph glyph-name="quote_right" unicode="&#xf10e;" horiz-adv-x="1664" 
-d="M768 1216v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136zM1664 1216
-v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136z" />
-    <glyph glyph-name="spinner" unicode="&#xf110;" horiz-adv-x="1792" 
-d="M526 142q0 -53 -37.5 -90.5t-90.5 -37.5q-52 0 -90 38t-38 90q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 -64q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM320 640q0 -53 -37.5 -90.5t-90.5 -37.5
-t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1522 142q0 -52 -38 -90t-90 -38q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM558 1138q0 -66 -47 -113t-113 -47t-113 47t-47 113t47 113t113 47t113 -47t47 -113z
-M1728 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1088 1344q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1618 1138q0 -93 -66 -158.5t-158 -65.5q-93 0 -158.5 65.5t-65.5 158.5
-q0 92 65.5 158t158.5 66q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="circle" unicode="&#xf111;" 
-d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="reply" unicode="&#xf112;" horiz-adv-x="1792" 
-d="M1792 416q0 -166 -127 -451q-3 -7 -10.5 -24t-13.5 -30t-13 -22q-12 -17 -28 -17q-15 0 -23.5 10t-8.5 25q0 9 2.5 26.5t2.5 23.5q5 68 5 123q0 101 -17.5 181t-48.5 138.5t-80 101t-105.5 69.5t-133 42.5t-154 21.5t-175.5 6h-224v-256q0 -26 -19 -45t-45 -19t-45 19
-l-512 512q-19 19 -19 45t19 45l512 512q19 19 45 19t45 -19t19 -45v-256h224q713 0 875 -403q53 -134 53 -333z" />
-    <glyph glyph-name="github_alt" unicode="&#xf113;" horiz-adv-x="1664" 
-d="M640 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1280 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1440 320
-q0 120 -69 204t-187 84q-41 0 -195 -21q-71 -11 -157 -11t-157 11q-152 21 -195 21q-118 0 -187 -84t-69 -204q0 -88 32 -153.5t81 -103t122 -60t140 -29.5t149 -7h168q82 0 149 7t140 29.5t122 60t81 103t32 153.5zM1664 496q0 -207 -61 -331q-38 -77 -105.5 -133t-141 -86
-t-170 -47.5t-171.5 -22t-167 -4.5q-78 0 -142 3t-147.5 12.5t-152.5 30t-137 51.5t-121 81t-86 115q-62 123 -62 331q0 237 136 396q-27 82 -27 170q0 116 51 218q108 0 190 -39.5t189 -123.5q147 35 309 35q148 0 280 -32q105 82 187 121t189 39q51 -102 51 -218
-q0 -87 -27 -168q136 -160 136 -398z" />
-    <glyph glyph-name="folder_close_alt" unicode="&#xf114;" horiz-adv-x="1664" 
-d="M1536 224v704q0 40 -28 68t-68 28h-704q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68v-960q0 -40 28 -68t68 -28h1216q40 0 68 28t28 68zM1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320
-q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="folder_open_alt" unicode="&#xf115;" horiz-adv-x="1920" 
-d="M1781 605q0 35 -53 35h-1088q-40 0 -85.5 -21.5t-71.5 -52.5l-294 -363q-18 -24 -18 -40q0 -35 53 -35h1088q40 0 86 22t71 53l294 363q18 22 18 39zM640 768h768v160q0 40 -28 68t-68 28h-576q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68
-v-853l256 315q44 53 116 87.5t140 34.5zM1909 605q0 -62 -46 -120l-295 -363q-43 -53 -116 -87.5t-140 -34.5h-1088q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158v-160h192q54 0 99 -24.5t67 -70.5q15 -32 15 -68z
-" />
-    <glyph glyph-name="expand_alt" unicode="&#xf116;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="collapse_alt" unicode="&#xf117;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="smile" unicode="&#xf118;" 
-d="M1134 461q-37 -121 -138 -195t-228 -74t-228 74t-138 195q-8 25 4 48.5t38 31.5q25 8 48.5 -4t31.5 -38q25 -80 92.5 -129.5t151.5 -49.5t151.5 49.5t92.5 129.5q8 26 32 38t49 4t37 -31.5t4 -48.5zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
-t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5
-t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="frown" unicode="&#xf119;" 
-d="M1134 307q8 -25 -4 -48.5t-37 -31.5t-49 4t-32 38q-25 80 -92.5 129.5t-151.5 49.5t-151.5 -49.5t-92.5 -129.5q-8 -26 -31.5 -38t-48.5 -4q-26 8 -38 31.5t-4 48.5q37 121 138 195t228 74t228 -74t138 -195zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
-t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204
-t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="meh" unicode="&#xf11a;" 
-d="M1152 448q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h640q26 0 45 -19t19 -45zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
-t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="gamepad" unicode="&#xf11b;" horiz-adv-x="1920" 
-d="M832 448v128q0 14 -9 23t-23 9h-192v192q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-192h-192q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h192v-192q0 -14 9 -23t23 -9h128q14 0 23 9t9 23v192h192q14 0 23 9t9 23zM1408 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5
-t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1920 512q0 -212 -150 -362t-362 -150q-192 0 -338 128h-220q-146 -128 -338 -128q-212 0 -362 150
-t-150 362t150 362t362 150h896q212 0 362 -150t150 -362z" />
-    <glyph glyph-name="keyboard" unicode="&#xf11c;" horiz-adv-x="1920" 
-d="M384 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM512 624v-96q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h224q16 0 16 -16zM384 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 368v-96q0 -16 -16 -16
-h-864q-16 0 -16 16v96q0 16 16 16h864q16 0 16 -16zM768 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM640 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1024 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16
-h96q16 0 16 -16zM896 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1280 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1152 880v-96
-q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 880v-352q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h112v240q0 16 16 16h96q16 0 16 -16zM1792 128v896h-1664v-896
-h1664zM1920 1024v-896q0 -53 -37.5 -90.5t-90.5 -37.5h-1664q-53 0 -90.5 37.5t-37.5 90.5v896q0 53 37.5 90.5t90.5 37.5h1664q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="flag_alt" unicode="&#xf11d;" horiz-adv-x="1792" 
-d="M1664 491v616q-169 -91 -306 -91q-82 0 -145 32q-100 49 -184 76.5t-178 27.5q-173 0 -403 -127v-599q245 113 433 113q55 0 103.5 -7.5t98 -26t77 -31t82.5 -39.5l28 -14q44 -22 101 -22q120 0 293 92zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9
-h-64q-14 0 -23 9t-9 23v1266q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102
-q-15 -9 -33 -9q-16 0 -32 8q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
-    <glyph glyph-name="flag_checkered" unicode="&#xf11e;" horiz-adv-x="1792" 
-d="M832 536v192q-181 -16 -384 -117v-185q205 96 384 110zM832 954v197q-172 -8 -384 -126v-189q215 111 384 118zM1664 491v184q-235 -116 -384 -71v224q-20 6 -39 15q-5 3 -33 17t-34.5 17t-31.5 15t-34.5 15.5t-32.5 13t-36 12.5t-35 8.5t-39.5 7.5t-39.5 4t-44 2
-q-23 0 -49 -3v-222h19q102 0 192.5 -29t197.5 -82q19 -9 39 -15v-188q42 -17 91 -17q120 0 293 92zM1664 918v189q-169 -91 -306 -91q-45 0 -78 8v-196q148 -42 384 90zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v1266
-q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102q-15 -9 -33 -9q-16 0 -32 8
-q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
-    <glyph glyph-name="terminal" unicode="&#xf120;" horiz-adv-x="1664" 
-d="M585 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23zM1664 96v-64q0 -14 -9 -23t-23 -9h-960q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h960q14 0 23 -9
-t9 -23z" />
-    <glyph glyph-name="code" unicode="&#xf121;" horiz-adv-x="1920" 
-d="M617 137l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23zM1208 1204l-373 -1291q-4 -13 -15.5 -19.5t-23.5 -2.5l-62 17q-13 4 -19.5 15.5t-2.5 24.5
-l373 1291q4 13 15.5 19.5t23.5 2.5l62 -17q13 -4 19.5 -15.5t2.5 -24.5zM1865 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23z" />
-    <glyph glyph-name="reply_all" unicode="&#xf122;" horiz-adv-x="1792" 
-d="M640 454v-70q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-69l-397 -398q-19 -19 -19 -45t19 -45zM1792 416q0 -58 -17 -133.5t-38.5 -138t-48 -125t-40.5 -90.5l-20 -40q-8 -17 -28 -17q-6 0 -9 1
-q-25 8 -23 34q43 400 -106 565q-64 71 -170.5 110.5t-267.5 52.5v-251q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-262q411 -28 599 -221q169 -173 169 -509z" />
-    <glyph glyph-name="star_half_empty" unicode="&#xf123;" horiz-adv-x="1664" 
-d="M1186 579l257 250l-356 52l-66 10l-30 60l-159 322v-963l59 -31l318 -168l-60 355l-12 66zM1638 841l-363 -354l86 -500q5 -33 -6 -51.5t-34 -18.5q-17 0 -40 12l-449 236l-449 -236q-23 -12 -40 -12q-23 0 -34 18.5t-6 51.5l86 500l-364 354q-32 32 -23 59.5t54 34.5
-l502 73l225 455q20 41 49 41q28 0 49 -41l225 -455l502 -73q45 -7 54 -34.5t-24 -59.5z" />
-    <glyph glyph-name="location_arrow" unicode="&#xf124;" horiz-adv-x="1408" 
-d="M1401 1187l-640 -1280q-17 -35 -57 -35q-5 0 -15 2q-22 5 -35.5 22.5t-13.5 39.5v576h-576q-22 0 -39.5 13.5t-22.5 35.5t4 42t29 30l1280 640q13 7 29 7q27 0 45 -19q15 -14 18.5 -34.5t-6.5 -39.5z" />
-    <glyph glyph-name="crop" unicode="&#xf125;" horiz-adv-x="1664" 
-d="M557 256h595v595zM512 301l595 595h-595v-595zM1664 224v-192q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v224h-864q-14 0 -23 9t-9 23v864h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224v224q0 14 9 23t23 9h192q14 0 23 -9t9 -23
-v-224h851l246 247q10 9 23 9t23 -9q9 -10 9 -23t-9 -23l-247 -246v-851h224q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="code_fork" unicode="&#xf126;" horiz-adv-x="1024" 
-d="M288 64q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM288 1216q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM928 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1024 1088q0 -52 -26 -96.5t-70 -69.5
-q-2 -287 -226 -414q-67 -38 -203 -81q-128 -40 -169.5 -71t-41.5 -100v-26q44 -25 70 -69.5t26 -96.5q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 52 26 96.5t70 69.5v820q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136q0 -52 -26 -96.5t-70 -69.5v-497
-q54 26 154 57q55 17 87.5 29.5t70.5 31t59 39.5t40.5 51t28 69.5t8.5 91.5q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136z" />
-    <glyph glyph-name="unlink" unicode="&#xf127;" horiz-adv-x="1664" 
-d="M439 265l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23zM608 224v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM384 448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23t9 23t23 9h320
-q14 0 23 -9t9 -23zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-334 335q-21 21 -42 56l239 18l273 -274q27 -27 68 -27.5t68 26.5l147 146q28 28 28 67q0 40 -28 68l-274 275l18 239q35 -21 56 -42l336 -336q84 -86 84 -204zM1031 1044l-239 -18
-l-273 274q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l274 -274l-18 -240q-35 21 -56 42l-336 336q-84 86 -84 204q0 120 85 203l147 146q83 83 203 83q121 0 204 -85l334 -335q21 -21 42 -56zM1664 960q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9
-t-9 23t9 23t23 9h320q14 0 23 -9t9 -23zM1120 1504v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM1527 1353l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
-    <glyph glyph-name="question" unicode="&#xf128;" horiz-adv-x="1024" 
-d="M704 280v-240q0 -16 -12 -28t-28 -12h-240q-16 0 -28 12t-12 28v240q0 16 12 28t28 12h240q16 0 28 -12t12 -28zM1020 880q0 -54 -15.5 -101t-35 -76.5t-55 -59.5t-57.5 -43.5t-61 -35.5q-41 -23 -68.5 -65t-27.5 -67q0 -17 -12 -32.5t-28 -15.5h-240q-15 0 -25.5 18.5
-t-10.5 37.5v45q0 83 65 156.5t143 108.5q59 27 84 56t25 76q0 42 -46.5 74t-107.5 32q-65 0 -108 -29q-35 -25 -107 -115q-13 -16 -31 -16q-12 0 -25 8l-164 125q-13 10 -15.5 25t5.5 28q160 266 464 266q80 0 161 -31t146 -83t106 -127.5t41 -158.5z" />
-    <glyph glyph-name="_279" unicode="&#xf129;" horiz-adv-x="640" 
-d="M640 192v-128q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64v384h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-576h64q26 0 45 -19t19 -45zM512 1344v-192q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v192
-q0 26 19 45t45 19h256q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="exclamation" unicode="&#xf12a;" horiz-adv-x="640" 
-d="M512 288v-224q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v224q0 26 19 45t45 19h256q26 0 45 -19t19 -45zM542 1344l-28 -768q-1 -26 -20.5 -45t-45.5 -19h-256q-26 0 -45.5 19t-20.5 45l-28 768q-1 26 17.5 45t44.5 19h320q26 0 44.5 -19t17.5 -45z" />
-    <glyph glyph-name="superscript" unicode="&#xf12b;" 
-d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3q-1 -3 -2.5 -6.5t-3.5 -8t-3 -6.5q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109z
-M1534 846v-206h-514l-3 27q-4 28 -4 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q83 65 188 65q110 0 178 -59.5t68 -158.5q0 -56 -24.5 -103t-62 -76.5t-81.5 -58.5t-82 -50.5
-t-65.5 -51.5t-30.5 -63h232v80h126z" />
-    <glyph glyph-name="subscript" unicode="&#xf12c;" 
-d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3q-1 -3 -2.5 -6.5t-3.5 -8t-3 -6.5q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109z
-M1536 -50v-206h-514l-4 27q-3 45 -3 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q80 65 188 65q110 0 178 -59.5t68 -158.5q0 -66 -34.5 -118.5t-84 -86t-99.5 -62.5t-87 -63t-41 -73
-h232v80h126z" />
-    <glyph glyph-name="_283" unicode="&#xf12d;" horiz-adv-x="1920" 
-d="M896 128l336 384h-768l-336 -384h768zM1909 1205q15 -34 9.5 -71.5t-30.5 -65.5l-896 -1024q-38 -44 -96 -44h-768q-38 0 -69.5 20.5t-47.5 54.5q-15 34 -9.5 71.5t30.5 65.5l896 1024q38 44 96 44h768q38 0 69.5 -20.5t47.5 -54.5z" />
-    <glyph glyph-name="puzzle_piece" unicode="&#xf12e;" horiz-adv-x="1664" 
-d="M1664 438q0 -81 -44.5 -135t-123.5 -54q-41 0 -77.5 17.5t-59 38t-56.5 38t-71 17.5q-110 0 -110 -124q0 -39 16 -115t15 -115v-5q-22 0 -33 -1q-34 -3 -97.5 -11.5t-115.5 -13.5t-98 -5q-61 0 -103 26.5t-42 83.5q0 37 17.5 71t38 56.5t38 59t17.5 77.5q0 79 -54 123.5
-t-135 44.5q-84 0 -143 -45.5t-59 -127.5q0 -43 15 -83t33.5 -64.5t33.5 -53t15 -50.5q0 -45 -46 -89q-37 -35 -117 -35q-95 0 -245 24q-9 2 -27.5 4t-27.5 4l-13 2q-1 0 -3 1q-2 0 -2 1v1024q2 -1 17.5 -3.5t34 -5t21.5 -3.5q150 -24 245 -24q80 0 117 35q46 44 46 89
-q0 22 -15 50.5t-33.5 53t-33.5 64.5t-15 83q0 82 59 127.5t144 45.5q80 0 134 -44.5t54 -123.5q0 -41 -17.5 -77.5t-38 -59t-38 -56.5t-17.5 -71q0 -57 42 -83.5t103 -26.5q64 0 180 15t163 17v-2q-1 -2 -3.5 -17.5t-5 -34t-3.5 -21.5q-24 -150 -24 -245q0 -80 35 -117
-q44 -46 89 -46q22 0 50.5 15t53 33.5t64.5 33.5t83 15q82 0 127.5 -59t45.5 -143z" />
-    <glyph glyph-name="microphone" unicode="&#xf130;" horiz-adv-x="1152" 
-d="M1152 832v-128q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-217 24 -364.5 187.5t-147.5 384.5v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -185 131.5 -316.5t316.5 -131.5
-t316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45zM896 1216v-512q0 -132 -94 -226t-226 -94t-226 94t-94 226v512q0 132 94 226t226 94t226 -94t94 -226z" />
-    <glyph glyph-name="microphone_off" unicode="&#xf131;" horiz-adv-x="1408" 
-d="M271 591l-101 -101q-42 103 -42 214v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -53 15 -113zM1385 1193l-361 -361v-128q0 -132 -94 -226t-226 -94q-55 0 -109 19l-96 -96q97 -51 205 -51q185 0 316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45v-128
-q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-125 13 -235 81l-254 -254q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l1234 1234q10 10 23 10t23 -10l82 -82q10 -10 10 -23
-t-10 -23zM1005 1325l-621 -621v512q0 132 94 226t226 94q102 0 184.5 -59t116.5 -152z" />
-    <glyph glyph-name="shield" unicode="&#xf132;" horiz-adv-x="1280" 
-d="M1088 576v640h-448v-1137q119 63 213 137q235 184 235 360zM1280 1344v-768q0 -86 -33.5 -170.5t-83 -150t-118 -127.5t-126.5 -103t-121 -77.5t-89.5 -49.5t-42.5 -20q-12 -6 -26 -6t-26 6q-16 7 -42.5 20t-89.5 49.5t-121 77.5t-126.5 103t-118 127.5t-83 150
-t-33.5 170.5v768q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="calendar_empty" unicode="&#xf133;" horiz-adv-x="1664" 
-d="M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280
-q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="fire_extinguisher" unicode="&#xf134;" horiz-adv-x="1408" 
-d="M512 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 1376v-320q0 -16 -12 -25q-8 -7 -20 -7q-4 0 -7 1l-448 96q-11 2 -18 11t-7 20h-256v-102q111 -23 183.5 -111t72.5 -203v-800q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v800
-q0 106 62.5 190.5t161.5 114.5v111h-32q-59 0 -115 -23.5t-91.5 -53t-66 -66.5t-40.5 -53.5t-14 -24.5q-17 -35 -57 -35q-16 0 -29 7q-23 12 -31.5 37t3.5 49q5 10 14.5 26t37.5 53.5t60.5 70t85 67t108.5 52.5q-25 42 -25 86q0 66 47 113t113 47t113 -47t47 -113
-q0 -33 -14 -64h302q0 11 7 20t18 11l448 96q3 1 7 1q12 0 20 -7q12 -9 12 -25z" />
-    <glyph glyph-name="rocket" unicode="&#xf135;" horiz-adv-x="1664" 
-d="M1440 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1664 1376q0 -249 -75.5 -430.5t-253.5 -360.5q-81 -80 -195 -176l-20 -379q-2 -16 -16 -26l-384 -224q-7 -4 -16 -4q-12 0 -23 9l-64 64q-13 14 -8 32l85 276l-281 281l-276 -85q-3 -1 -9 -1
-q-14 0 -23 9l-64 64q-17 19 -5 39l224 384q10 14 26 16l379 20q96 114 176 195q188 187 358 258t431 71q14 0 24 -9.5t10 -22.5z" />
-    <glyph glyph-name="maxcdn" unicode="&#xf136;" horiz-adv-x="1792" 
-d="M1745 763l-164 -763h-334l178 832q13 56 -15 88q-27 33 -83 33h-169l-204 -953h-334l204 953h-286l-204 -953h-334l204 953l-153 327h1276q101 0 189.5 -40.5t147.5 -113.5q60 -73 81 -168.5t0 -194.5z" />
-    <glyph glyph-name="chevron_sign_left" unicode="&#xf137;" 
-d="M909 141l102 102q19 19 19 45t-19 45l-307 307l307 307q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="chevron_sign_right" unicode="&#xf138;" 
-d="M717 141l454 454q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l307 -307l-307 -307q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="chevron_sign_up" unicode="&#xf139;" 
-d="M1165 397l102 102q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l307 307l307 -307q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="chevron_sign_down" unicode="&#xf13a;" 
-d="M813 237l454 454q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-307 -307l-307 307q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="html5" unicode="&#xf13b;" horiz-adv-x="1408" 
-d="M1130 939l16 175h-884l47 -534h612l-22 -228l-197 -53l-196 53l-13 140h-175l22 -278l362 -100h4v1l359 99l50 544h-644l-15 181h674zM0 1408h1408l-128 -1438l-578 -162l-574 162z" />
-    <glyph glyph-name="css3" unicode="&#xf13c;" horiz-adv-x="1792" 
-d="M275 1408h1505l-266 -1333l-804 -267l-698 267l71 356h297l-29 -147l422 -161l486 161l68 339h-1208l58 297h1209l38 191h-1208z" />
-    <glyph glyph-name="anchor" unicode="&#xf13d;" horiz-adv-x="1792" 
-d="M960 1280q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1792 352v-352q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-93 93q-119 -143 -318.5 -226.5t-429.5 -83.5t-429.5 83.5t-318.5 226.5l-93 -93q-9 -9 -23 -9q-4 0 -12 2q-20 8 -20 30v352
-q0 14 9 23t23 9h352q22 0 30 -20q8 -19 -7 -35l-100 -100q67 -91 189.5 -153.5t271.5 -82.5v647h-192q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h192v163q-58 34 -93 92.5t-35 128.5q0 106 75 181t181 75t181 -75t75 -181q0 -70 -35 -128.5t-93 -92.5v-163h192q26 0 45 -19
-t19 -45v-128q0 -26 -19 -45t-45 -19h-192v-647q149 20 271.5 82.5t189.5 153.5l-100 100q-15 16 -7 35q8 20 30 20h352q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="unlock_alt" unicode="&#xf13e;" horiz-adv-x="1152" 
-d="M1056 768q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v320q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45q0 106 -75 181t-181 75t-181 -75t-75 -181
-v-320h736z" />
-    <glyph glyph-name="bullseye" unicode="&#xf140;" 
-d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM1152 640q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1280 640q0 -212 -150 -362t-362 -150t-362 150
-t-150 362t150 362t362 150t362 -150t150 -362zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ellipsis_horizontal" unicode="&#xf141;" horiz-adv-x="1408" 
-d="M384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM896 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM1408 800v-192q0 -40 -28 -68t-68 -28h-192
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="ellipsis_vertical" unicode="&#xf142;" horiz-adv-x="384" 
-d="M384 288v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 1312v-192q0 -40 -28 -68t-68 -28h-192
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="_303" unicode="&#xf143;" 
-d="M512 256q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM863 162q-13 233 -176.5 396.5t-396.5 176.5q-14 1 -24 -9t-10 -23v-128q0 -13 8.5 -22t21.5 -10q154 -11 264 -121t121 -264q1 -13 10 -21.5t22 -8.5h128
-q13 0 23 10t9 24zM1247 161q-5 154 -56 297.5t-139.5 260t-205 205t-260 139.5t-297.5 56q-14 1 -23 -9q-10 -10 -10 -23v-128q0 -13 9 -22t22 -10q204 -7 378 -111.5t278.5 -278.5t111.5 -378q1 -13 10 -22t22 -9h128q13 0 23 10q11 9 9 23zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="play_sign" unicode="&#xf144;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1152 585q32 18 32 55t-32 55l-544 320q-31 19 -64 1q-32 -19 -32 -56v-640q0 -37 32 -56
-q16 -8 32 -8q17 0 32 9z" />
-    <glyph glyph-name="ticket" unicode="&#xf145;" horiz-adv-x="1792" 
-d="M1024 1084l316 -316l-572 -572l-316 316zM813 105l618 618q19 19 19 45t-19 45l-362 362q-18 18 -45 18t-45 -18l-618 -618q-19 -19 -19 -45t19 -45l362 -362q18 -18 45 -18t45 18zM1702 742l-907 -908q-37 -37 -90.5 -37t-90.5 37l-126 126q56 56 56 136t-56 136
-t-136 56t-136 -56l-125 126q-37 37 -37 90.5t37 90.5l907 906q37 37 90.5 37t90.5 -37l125 -125q-56 -56 -56 -136t56 -136t136 -56t136 56l126 -125q37 -37 37 -90.5t-37 -90.5z" />
-    <glyph glyph-name="minus_sign_alt" unicode="&#xf146;" 
-d="M1280 576v128q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h896q26 0 45 19t19 45zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
-t84.5 -203.5z" />
-    <glyph glyph-name="check_minus" unicode="&#xf147;" horiz-adv-x="1408" 
-d="M1152 736v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h832q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5
-t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="level_up" unicode="&#xf148;" horiz-adv-x="1024" 
-d="M1018 933q-18 -37 -58 -37h-192v-864q0 -14 -9 -23t-23 -9h-704q-21 0 -29 18q-8 20 4 35l160 192q9 11 25 11h320v640h-192q-40 0 -58 37q-17 37 9 68l320 384q18 22 49 22t49 -22l320 -384q27 -32 9 -68z" />
-    <glyph glyph-name="level_down" unicode="&#xf149;" horiz-adv-x="1024" 
-d="M32 1280h704q13 0 22.5 -9.5t9.5 -23.5v-863h192q40 0 58 -37t-9 -69l-320 -384q-18 -22 -49 -22t-49 22l-320 384q-26 31 -9 69q18 37 58 37h192v640h-320q-14 0 -25 11l-160 192q-13 14 -4 34q9 19 29 19z" />
-    <glyph glyph-name="check_sign" unicode="&#xf14a;" 
-d="M685 237l614 614q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-467 -467l-211 211q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l358 -358q19 -19 45 -19t45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5
-t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="edit_sign" unicode="&#xf14b;" 
-d="M404 428l152 -152l-52 -52h-56v96h-96v56zM818 818q14 -13 -3 -30l-291 -291q-17 -17 -30 -3q-14 13 3 30l291 291q17 17 30 3zM544 128l544 544l-288 288l-544 -544v-288h288zM1152 736l92 92q28 28 28 68t-28 68l-152 152q-28 28 -68 28t-68 -28l-92 -92zM1536 1120
-v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_312" unicode="&#xf14c;" 
-d="M1280 608v480q0 26 -19 45t-45 19h-480q-42 0 -59 -39q-17 -41 14 -70l144 -144l-534 -534q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l534 534l144 -144q18 -19 45 -19q12 0 25 5q39 17 39 59zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960
-q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="share_sign" unicode="&#xf14d;" 
-d="M1005 435l352 352q19 19 19 45t-19 45l-352 352q-30 31 -69 14q-40 -17 -40 -59v-160q-119 0 -216 -19.5t-162.5 -51t-114 -79t-76.5 -95.5t-44.5 -109t-21.5 -111.5t-5 -110.5q0 -181 167 -404q11 -12 25 -12q7 0 13 3q22 9 19 33q-44 354 62 473q46 52 130 75.5
-t224 23.5v-160q0 -42 40 -59q12 -5 24 -5q26 0 45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="compass" unicode="&#xf14e;" 
-d="M640 448l256 128l-256 128v-256zM1024 1039v-542l-512 -256v542zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="collapse" unicode="&#xf150;" 
-d="M1145 861q18 -35 -5 -66l-320 -448q-19 -27 -52 -27t-52 27l-320 448q-23 31 -5 66q17 35 57 35h640q40 0 57 -35zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120
-v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="collapse_top" unicode="&#xf151;" 
-d="M1145 419q-17 -35 -57 -35h-640q-40 0 -57 35q-18 35 5 66l320 448q19 27 52 27t52 -27l320 -448q23 -31 5 -66zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_317" unicode="&#xf152;" 
-d="M1088 640q0 -33 -27 -52l-448 -320q-31 -23 -66 -5q-35 17 -35 57v640q0 40 35 57q35 18 66 -5l448 -320q27 -19 27 -52zM1280 160v960q0 14 -9 23t-23 9h-960q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h960q14 0 23 9t9 23zM1536 1120v-960q0 -119 -84.5 -203.5
-t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="eur" unicode="&#xf153;" horiz-adv-x="1024" 
-d="M976 229l35 -159q3 -12 -3 -22.5t-17 -14.5l-5 -1q-4 -2 -10.5 -3.5t-16 -4.5t-21.5 -5.5t-25.5 -5t-30 -5t-33.5 -4.5t-36.5 -3t-38.5 -1q-234 0 -409 130.5t-238 351.5h-95q-13 0 -22.5 9.5t-9.5 22.5v113q0 13 9.5 22.5t22.5 9.5h66q-2 57 1 105h-67q-14 0 -23 9
-t-9 23v114q0 14 9 23t23 9h98q67 210 243.5 338t400.5 128q102 0 194 -23q11 -3 20 -15q6 -11 3 -24l-43 -159q-3 -13 -14 -19.5t-24 -2.5l-4 1q-4 1 -11.5 2.5l-17.5 3.5t-22.5 3.5t-26 3t-29 2.5t-29.5 1q-126 0 -226 -64t-150 -176h468q16 0 25 -12q10 -12 7 -26
-l-24 -114q-5 -26 -32 -26h-488q-3 -37 0 -105h459q15 0 25 -12q9 -12 6 -27l-24 -112q-2 -11 -11 -18.5t-20 -7.5h-387q48 -117 149.5 -185.5t228.5 -68.5q18 0 36 1.5t33.5 3.5t29.5 4.5t24.5 5t18.5 4.5l12 3l5 2q13 5 26 -2q12 -7 15 -21z" />
-    <glyph glyph-name="gbp" unicode="&#xf154;" horiz-adv-x="1024" 
-d="M1020 399v-367q0 -14 -9 -23t-23 -9h-956q-14 0 -23 9t-9 23v150q0 13 9.5 22.5t22.5 9.5h97v383h-95q-14 0 -23 9.5t-9 22.5v131q0 14 9 23t23 9h95v223q0 171 123.5 282t314.5 111q185 0 335 -125q9 -8 10 -20.5t-7 -22.5l-103 -127q-9 -11 -22 -12q-13 -2 -23 7
-q-5 5 -26 19t-69 32t-93 18q-85 0 -137 -47t-52 -123v-215h305q13 0 22.5 -9t9.5 -23v-131q0 -13 -9.5 -22.5t-22.5 -9.5h-305v-379h414v181q0 13 9 22.5t23 9.5h162q14 0 23 -9.5t9 -22.5z" />
-    <glyph glyph-name="usd" unicode="&#xf155;" horiz-adv-x="1024" 
-d="M978 351q0 -153 -99.5 -263.5t-258.5 -136.5v-175q0 -14 -9 -23t-23 -9h-135q-13 0 -22.5 9.5t-9.5 22.5v175q-66 9 -127.5 31t-101.5 44.5t-74 48t-46.5 37.5t-17.5 18q-17 21 -2 41l103 135q7 10 23 12q15 2 24 -9l2 -2q113 -99 243 -125q37 -8 74 -8q81 0 142.5 43
-t61.5 122q0 28 -15 53t-33.5 42t-58.5 37.5t-66 32t-80 32.5q-39 16 -61.5 25t-61.5 26.5t-62.5 31t-56.5 35.5t-53.5 42.5t-43.5 49t-35.5 58t-21 66.5t-8.5 78q0 138 98 242t255 134v180q0 13 9.5 22.5t22.5 9.5h135q14 0 23 -9t9 -23v-176q57 -6 110.5 -23t87 -33.5
-t63.5 -37.5t39 -29t15 -14q17 -18 5 -38l-81 -146q-8 -15 -23 -16q-14 -3 -27 7q-3 3 -14.5 12t-39 26.5t-58.5 32t-74.5 26t-85.5 11.5q-95 0 -155 -43t-60 -111q0 -26 8.5 -48t29.5 -41.5t39.5 -33t56 -31t60.5 -27t70 -27.5q53 -20 81 -31.5t76 -35t75.5 -42.5t62 -50
-t53 -63.5t31.5 -76.5t13 -94z" />
-    <glyph glyph-name="inr" unicode="&#xf156;" horiz-adv-x="898" 
-d="M898 1066v-102q0 -14 -9 -23t-23 -9h-168q-23 -144 -129 -234t-276 -110q167 -178 459 -536q14 -16 4 -34q-8 -18 -29 -18h-195q-16 0 -25 12q-306 367 -498 571q-9 9 -9 22v127q0 13 9.5 22.5t22.5 9.5h112q132 0 212.5 43t102.5 125h-427q-14 0 -23 9t-9 23v102
-q0 14 9 23t23 9h413q-57 113 -268 113h-145q-13 0 -22.5 9.5t-9.5 22.5v133q0 14 9 23t23 9h832q14 0 23 -9t9 -23v-102q0 -14 -9 -23t-23 -9h-233q47 -61 64 -144h171q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="jpy" unicode="&#xf157;" horiz-adv-x="1027" 
-d="M603 0h-172q-13 0 -22.5 9t-9.5 23v330h-288q-13 0 -22.5 9t-9.5 23v103q0 13 9.5 22.5t22.5 9.5h288v85h-288q-13 0 -22.5 9t-9.5 23v104q0 13 9.5 22.5t22.5 9.5h214l-321 578q-8 16 0 32q10 16 28 16h194q19 0 29 -18l215 -425q19 -38 56 -125q10 24 30.5 68t27.5 61
-l191 420q8 19 29 19h191q17 0 27 -16q9 -14 1 -31l-313 -579h215q13 0 22.5 -9.5t9.5 -22.5v-104q0 -14 -9.5 -23t-22.5 -9h-290v-85h290q13 0 22.5 -9.5t9.5 -22.5v-103q0 -14 -9.5 -23t-22.5 -9h-290v-330q0 -13 -9.5 -22.5t-22.5 -9.5z" />
-    <glyph glyph-name="rub" unicode="&#xf158;" horiz-adv-x="1280" 
-d="M1043 971q0 100 -65 162t-171 62h-320v-448h320q106 0 171 62t65 162zM1280 971q0 -193 -126.5 -315t-326.5 -122h-340v-118h505q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-505v-192q0 -14 -9.5 -23t-22.5 -9h-167q-14 0 -23 9t-9 23v192h-224q-14 0 -23 9t-9 23v128
-q0 14 9 23t23 9h224v118h-224q-14 0 -23 9t-9 23v149q0 13 9 22.5t23 9.5h224v629q0 14 9 23t23 9h539q200 0 326.5 -122t126.5 -315z" />
-    <glyph glyph-name="krw" unicode="&#xf159;" horiz-adv-x="1792" 
-d="M514 341l81 299h-159l75 -300q1 -1 1 -3t1 -3q0 1 0.5 3.5t0.5 3.5zM630 768l35 128h-292l32 -128h225zM822 768h139l-35 128h-70zM1271 340l78 300h-162l81 -299q0 -1 0.5 -3.5t1.5 -3.5q0 1 0.5 3t0.5 3zM1382 768l33 128h-297l34 -128h230zM1792 736v-64q0 -14 -9 -23
-t-23 -9h-213l-164 -616q-7 -24 -31 -24h-159q-24 0 -31 24l-166 616h-209l-167 -616q-7 -24 -31 -24h-159q-11 0 -19.5 7t-10.5 17l-160 616h-208q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h175l-33 128h-142q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h109l-89 344q-5 15 5 28
-q10 12 26 12h137q26 0 31 -24l90 -360h359l97 360q7 24 31 24h126q24 0 31 -24l98 -360h365l93 360q5 24 31 24h137q16 0 26 -12q10 -13 5 -28l-91 -344h111q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-145l-34 -128h179q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="btc" unicode="&#xf15a;" horiz-adv-x="1280" 
-d="M1167 896q18 -182 -131 -258q117 -28 175 -103t45 -214q-7 -71 -32.5 -125t-64.5 -89t-97 -58.5t-121.5 -34.5t-145.5 -15v-255h-154v251q-80 0 -122 1v-252h-154v255q-18 0 -54 0.5t-55 0.5h-200l31 183h111q50 0 58 51v402h16q-6 1 -16 1v287q-13 68 -89 68h-111v164
-l212 -1q64 0 97 1v252h154v-247q82 2 122 2v245h154v-252q79 -7 140 -22.5t113 -45t82.5 -78t36.5 -114.5zM952 351q0 36 -15 64t-37 46t-57.5 30.5t-65.5 18.5t-74 9t-69 3t-64.5 -1t-47.5 -1v-338q8 0 37 -0.5t48 -0.5t53 1.5t58.5 4t57 8.5t55.5 14t47.5 21t39.5 30
-t24.5 40t9.5 51zM881 827q0 33 -12.5 58.5t-30.5 42t-48 28t-55 16.5t-61.5 8t-58 2.5t-54 -1t-39.5 -0.5v-307q5 0 34.5 -0.5t46.5 0t50 2t55 5.5t51.5 11t48.5 18.5t37 27t27 38.5t9 51z" />
-    <glyph glyph-name="file" unicode="&#xf15b;" 
-d="M1024 1024v472q22 -14 36 -28l408 -408q14 -14 28 -36h-472zM896 992q0 -40 28 -68t68 -28h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544z" />
-    <glyph glyph-name="file_text" unicode="&#xf15c;" 
-d="M1468 1060q14 -14 28 -36h-472v472q22 -14 36 -28zM992 896h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544q0 -40 28 -68t68 -28zM1152 160v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704
-q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23z" />
-    <glyph glyph-name="sort_by_alphabet" unicode="&#xf15d;" horiz-adv-x="1664" 
-d="M1191 1128h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1572 -23
-v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -11v-2l14 2q9 2 30 2h248v119h121zM1661 874v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162
-l230 -662h70z" />
-    <glyph glyph-name="_329" unicode="&#xf15e;" horiz-adv-x="1664" 
-d="M1191 104h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1661 -150
-v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162l230 -662h70zM1572 1001v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -10v-3l14 3q9 1 30 1h248
-v119h121z" />
-    <glyph glyph-name="sort_by_attributes" unicode="&#xf160;" horiz-adv-x="1792" 
-d="M736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1792 -32v-192q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832
-q14 0 23 -9t9 -23zM1600 480v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1408 992v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1216 1504v-192q0 -14 -9 -23t-23 -9h-256
-q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="sort_by_attributes_alt" unicode="&#xf161;" horiz-adv-x="1792" 
-d="M1216 -32v-192q0 -14 -9 -23t-23 -9h-256q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192
-q14 0 23 -9t9 -23zM1408 480v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1600 992v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1792 1504v-192q0 -14 -9 -23t-23 -9h-832
-q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="sort_by_order" unicode="&#xf162;" 
-d="M1346 223q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23
-zM1486 165q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5
-t82 -252.5zM1456 882v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165z" />
-    <glyph glyph-name="sort_by_order_alt" unicode="&#xf163;" 
-d="M1346 1247q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9
-t9 -23zM1456 -142v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165zM1486 1189q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13
-q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5t82 -252.5z" />
-    <glyph glyph-name="_334" unicode="&#xf164;" horiz-adv-x="1664" 
-d="M256 192q0 26 -19 45t-45 19q-27 0 -45.5 -19t-18.5 -45q0 -27 18.5 -45.5t45.5 -18.5q26 0 45 18.5t19 45.5zM416 704v-640q0 -26 -19 -45t-45 -19h-288q-26 0 -45 19t-19 45v640q0 26 19 45t45 19h288q26 0 45 -19t19 -45zM1600 704q0 -86 -55 -149q15 -44 15 -76
-q3 -76 -43 -137q17 -56 0 -117q-15 -57 -54 -94q9 -112 -49 -181q-64 -76 -197 -78h-36h-76h-17q-66 0 -144 15.5t-121.5 29t-120.5 39.5q-123 43 -158 44q-26 1 -45 19.5t-19 44.5v641q0 25 18 43.5t43 20.5q24 2 76 59t101 121q68 87 101 120q18 18 31 48t17.5 48.5
-t13.5 60.5q7 39 12.5 61t19.5 52t34 50q19 19 45 19q46 0 82.5 -10.5t60 -26t40 -40.5t24 -45t12 -50t5 -45t0.5 -39q0 -38 -9.5 -76t-19 -60t-27.5 -56q-3 -6 -10 -18t-11 -22t-8 -24h277q78 0 135 -57t57 -135z" />
-    <glyph glyph-name="_335" unicode="&#xf165;" horiz-adv-x="1664" 
-d="M256 960q0 -26 -19 -45t-45 -19q-27 0 -45.5 19t-18.5 45q0 27 18.5 45.5t45.5 18.5q26 0 45 -18.5t19 -45.5zM416 448v640q0 26 -19 45t-45 19h-288q-26 0 -45 -19t-19 -45v-640q0 -26 19 -45t45 -19h288q26 0 45 19t19 45zM1545 597q55 -61 55 -149q-1 -78 -57.5 -135
-t-134.5 -57h-277q4 -14 8 -24t11 -22t10 -18q18 -37 27 -57t19 -58.5t10 -76.5q0 -24 -0.5 -39t-5 -45t-12 -50t-24 -45t-40 -40.5t-60 -26t-82.5 -10.5q-26 0 -45 19q-20 20 -34 50t-19.5 52t-12.5 61q-9 42 -13.5 60.5t-17.5 48.5t-31 48q-33 33 -101 120q-49 64 -101 121
-t-76 59q-25 2 -43 20.5t-18 43.5v641q0 26 19 44.5t45 19.5q35 1 158 44q77 26 120.5 39.5t121.5 29t144 15.5h17h76h36q133 -2 197 -78q58 -69 49 -181q39 -37 54 -94q17 -61 0 -117q46 -61 43 -137q0 -32 -15 -76z" />
-    <glyph glyph-name="youtube_sign" unicode="&#xf166;" 
-d="M919 233v157q0 50 -29 50q-17 0 -33 -16v-224q16 -16 33 -16q29 0 29 49zM1103 355h66v34q0 51 -33 51t-33 -51v-34zM532 621v-70h-80v-423h-74v423h-78v70h232zM733 495v-367h-67v40q-39 -45 -76 -45q-33 0 -42 28q-6 17 -6 54v290h66v-270q0 -24 1 -26q1 -15 15 -15
-q20 0 42 31v280h67zM985 384v-146q0 -52 -7 -73q-12 -42 -53 -42q-35 0 -68 41v-36h-67v493h67v-161q32 40 68 40q41 0 53 -42q7 -21 7 -74zM1236 255v-9q0 -29 -2 -43q-3 -22 -15 -40q-27 -40 -80 -40q-52 0 -81 38q-21 27 -21 86v129q0 59 20 86q29 38 80 38t78 -38
-q21 -29 21 -86v-76h-133v-65q0 -51 34 -51q24 0 30 26q0 1 0.5 7t0.5 16.5v21.5h68zM785 1079v-156q0 -51 -32 -51t-32 51v156q0 52 32 52t32 -52zM1318 366q0 177 -19 260q-10 44 -43 73.5t-76 34.5q-136 15 -412 15q-275 0 -411 -15q-44 -5 -76.5 -34.5t-42.5 -73.5
-q-20 -87 -20 -260q0 -176 20 -260q10 -43 42.5 -73t75.5 -35q137 -15 412 -15t412 15q43 5 75.5 35t42.5 73q20 84 20 260zM563 1017l90 296h-75l-51 -195l-53 195h-78q7 -23 23 -69l24 -69q35 -103 46 -158v-201h74v201zM852 936v130q0 58 -21 87q-29 38 -78 38
-q-51 0 -78 -38q-21 -29 -21 -87v-130q0 -58 21 -87q27 -38 78 -38q49 0 78 38q21 27 21 87zM1033 816h67v370h-67v-283q-22 -31 -42 -31q-15 0 -16 16q-1 2 -1 26v272h-67v-293q0 -37 6 -55q11 -27 43 -27q36 0 77 45v-40zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5
-h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="youtube" unicode="&#xf167;" 
-d="M971 292v-211q0 -67 -39 -67q-23 0 -45 22v301q22 22 45 22q39 0 39 -67zM1309 291v-46h-90v46q0 68 45 68t45 -68zM343 509h107v94h-312v-94h105v-569h100v569zM631 -60h89v494h-89v-378q-30 -42 -57 -42q-18 0 -21 21q-1 3 -1 35v364h-89v-391q0 -49 8 -73
-q12 -37 58 -37q48 0 102 61v-54zM1060 88v197q0 73 -9 99q-17 56 -71 56q-50 0 -93 -54v217h-89v-663h89v48q45 -55 93 -55q54 0 71 55q9 27 9 100zM1398 98v13h-91q0 -51 -2 -61q-7 -36 -40 -36q-46 0 -46 69v87h179v103q0 79 -27 116q-39 51 -106 51q-68 0 -107 -51
-q-28 -37 -28 -116v-173q0 -79 29 -116q39 -51 108 -51q72 0 108 53q18 27 21 54q2 9 2 58zM790 1011v210q0 69 -43 69t-43 -69v-210q0 -70 43 -70t43 70zM1509 260q0 -234 -26 -350q-14 -59 -58 -99t-102 -46q-184 -21 -555 -21t-555 21q-58 6 -102.5 46t-57.5 99
-q-26 112 -26 350q0 234 26 350q14 59 58 99t103 47q183 20 554 20t555 -20q58 -7 102.5 -47t57.5 -99q26 -112 26 -350zM511 1536h102l-121 -399v-271h-100v271q-14 74 -61 212q-37 103 -65 187h106l71 -263zM881 1203v-175q0 -81 -28 -118q-38 -51 -106 -51q-67 0 -105 51
-q-28 38 -28 118v175q0 80 28 117q38 51 105 51q68 0 106 -51q28 -37 28 -117zM1216 1365v-499h-91v55q-53 -62 -103 -62q-46 0 -59 37q-8 24 -8 75v394h91v-367q0 -33 1 -35q3 -22 21 -22q27 0 57 43v381h91z" />
-    <glyph glyph-name="xing" unicode="&#xf168;" horiz-adv-x="1408" 
-d="M597 869q-10 -18 -257 -456q-27 -46 -65 -46h-239q-21 0 -31 17t0 36l253 448q1 0 0 1l-161 279q-12 22 -1 37q9 15 32 15h239q40 0 66 -45zM1403 1511q11 -16 0 -37l-528 -934v-1l336 -615q11 -20 1 -37q-10 -15 -32 -15h-239q-42 0 -66 45l-339 622q18 32 531 942
-q25 45 64 45h241q22 0 31 -15z" />
-    <glyph glyph-name="xing_sign" unicode="&#xf169;" 
-d="M685 771q0 1 -126 222q-21 34 -52 34h-184q-18 0 -26 -11q-7 -12 1 -29l125 -216v-1l-196 -346q-9 -14 0 -28q8 -13 24 -13h185q31 0 50 36zM1309 1268q-7 12 -24 12h-187q-30 0 -49 -35l-411 -729q1 -2 262 -481q20 -35 52 -35h184q18 0 25 12q8 13 -1 28l-260 476v1
-l409 723q8 16 0 28zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="youtube_play" unicode="&#xf16a;" horiz-adv-x="1792" 
-d="M711 408l484 250l-484 253v-503zM896 1270q168 0 324.5 -4.5t229.5 -9.5l73 -4q1 0 17 -1.5t23 -3t23.5 -4.5t28.5 -8t28 -13t31 -19.5t29 -26.5q6 -6 15.5 -18.5t29 -58.5t26.5 -101q8 -64 12.5 -136.5t5.5 -113.5v-40v-136q1 -145 -18 -290q-7 -55 -25 -99.5t-32 -61.5
-l-14 -17q-14 -15 -29 -26.5t-31 -19t-28 -12.5t-28.5 -8t-24 -4.5t-23 -3t-16.5 -1.5q-251 -19 -627 -19q-207 2 -359.5 6.5t-200.5 7.5l-49 4l-36 4q-36 5 -54.5 10t-51 21t-56.5 41q-6 6 -15.5 18.5t-29 58.5t-26.5 101q-8 64 -12.5 136.5t-5.5 113.5v40v136
-q-1 145 18 290q7 55 25 99.5t32 61.5l14 17q14 15 29 26.5t31 19.5t28 13t28.5 8t23.5 4.5t23 3t17 1.5q251 18 627 18z" />
-    <glyph glyph-name="dropbox" unicode="&#xf16b;" horiz-adv-x="1792" 
-d="M402 829l494 -305l-342 -285l-490 319zM1388 274v-108l-490 -293v-1l-1 1l-1 -1v1l-489 293v108l147 -96l342 284v2l1 -1l1 1v-2l343 -284zM554 1418l342 -285l-494 -304l-338 270zM1390 829l338 -271l-489 -319l-343 285zM1239 1418l489 -319l-338 -270l-494 304z" />
-    <glyph glyph-name="stackexchange" unicode="&#xf16c;" 
-d="M1289 -96h-1118v480h-160v-640h1438v640h-160v-480zM347 428l33 157l783 -165l-33 -156zM450 802l67 146l725 -339l-67 -145zM651 1158l102 123l614 -513l-102 -123zM1048 1536l477 -641l-128 -96l-477 641zM330 65v159h800v-159h-800z" />
-    <glyph glyph-name="instagram" unicode="&#xf16d;" 
-d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1162 640q0 -164 -115 -279t-279 -115t-279 115t-115 279t115 279t279 115t279 -115t115 -279zM1270 1050q0 -38 -27 -65t-65 -27t-65 27t-27 65t27 65t65 27t65 -27t27 -65zM768 1270
-q-7 0 -76.5 0.5t-105.5 0t-96.5 -3t-103 -10t-71.5 -18.5q-50 -20 -88 -58t-58 -88q-11 -29 -18.5 -71.5t-10 -103t-3 -96.5t0 -105.5t0.5 -76.5t-0.5 -76.5t0 -105.5t3 -96.5t10 -103t18.5 -71.5q20 -50 58 -88t88 -58q29 -11 71.5 -18.5t103 -10t96.5 -3t105.5 0t76.5 0.5
-t76.5 -0.5t105.5 0t96.5 3t103 10t71.5 18.5q50 20 88 58t58 88q11 29 18.5 71.5t10 103t3 96.5t0 105.5t-0.5 76.5t0.5 76.5t0 105.5t-3 96.5t-10 103t-18.5 71.5q-20 50 -58 88t-88 58q-29 11 -71.5 18.5t-103 10t-96.5 3t-105.5 0t-76.5 -0.5zM1536 640q0 -229 -5 -317
-q-10 -208 -124 -322t-322 -124q-88 -5 -317 -5t-317 5q-208 10 -322 124t-124 322q-5 88 -5 317t5 317q10 208 124 322t322 124q88 5 317 5t317 -5q208 -10 322 -124t124 -322q5 -88 5 -317z" />
-    <glyph glyph-name="flickr" unicode="&#xf16e;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM698 640q0 88 -62 150t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150zM1262 640q0 88 -62 150
-t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150z" />
-    <glyph glyph-name="adn" unicode="&#xf170;" 
-d="M768 914l201 -306h-402zM1133 384h94l-459 691l-459 -691h94l104 160h522zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="f171" unicode="&#xf171;" horiz-adv-x="1408" 
-d="M815 677q8 -63 -50.5 -101t-111.5 -6q-39 17 -53.5 58t-0.5 82t52 58q36 18 72.5 12t64 -35.5t27.5 -67.5zM926 698q-14 107 -113 164t-197 13q-63 -28 -100.5 -88.5t-34.5 -129.5q4 -91 77.5 -155t165.5 -56q91 8 152 84t50 168zM1165 1240q-20 27 -56 44.5t-58 22
-t-71 12.5q-291 47 -566 -2q-43 -7 -66 -12t-55 -22t-50 -43q30 -28 76 -45.5t73.5 -22t87.5 -11.5q228 -29 448 -1q63 8 89.5 12t72.5 21.5t75 46.5zM1222 205q-8 -26 -15.5 -76.5t-14 -84t-28.5 -70t-58 -56.5q-86 -48 -189.5 -71.5t-202 -22t-201.5 18.5q-46 8 -81.5 18
-t-76.5 27t-73 43.5t-52 61.5q-25 96 -57 292l6 16l18 9q223 -148 506.5 -148t507.5 148q21 -6 24 -23t-5 -45t-8 -37zM1403 1166q-26 -167 -111 -655q-5 -30 -27 -56t-43.5 -40t-54.5 -31q-252 -126 -610 -88q-248 27 -394 139q-15 12 -25.5 26.5t-17 35t-9 34t-6 39.5
-t-5.5 35q-9 50 -26.5 150t-28 161.5t-23.5 147.5t-22 158q3 26 17.5 48.5t31.5 37.5t45 30t46 22.5t48 18.5q125 46 313 64q379 37 676 -50q155 -46 215 -122q16 -20 16.5 -51t-5.5 -54z" />
-    <glyph glyph-name="bitbucket_sign" unicode="&#xf172;" 
-d="M848 666q0 43 -41 66t-77 1q-43 -20 -42.5 -72.5t43.5 -70.5q39 -23 81 4t36 72zM928 682q8 -66 -36 -121t-110 -61t-119 40t-56 113q-2 49 25.5 93t72.5 64q70 31 141.5 -10t81.5 -118zM1100 1073q-20 -21 -53.5 -34t-53 -16t-63.5 -8q-155 -20 -324 0q-44 6 -63 9.5
-t-52.5 16t-54.5 32.5q13 19 36 31t40 15.5t47 8.5q198 35 408 1q33 -5 51 -8.5t43 -16t39 -31.5zM1142 327q0 7 5.5 26.5t3 32t-17.5 16.5q-161 -106 -365 -106t-366 106l-12 -6l-5 -12q26 -154 41 -210q47 -81 204 -108q249 -46 428 53q34 19 49 51.5t22.5 85.5t12.5 71z
-M1272 1020q9 53 -8 75q-43 55 -155 88q-216 63 -487 36q-132 -12 -226 -46q-38 -15 -59.5 -25t-47 -34t-29.5 -54q8 -68 19 -138t29 -171t24 -137q1 -5 5 -31t7 -36t12 -27t22 -28q105 -80 284 -100q259 -28 440 63q24 13 39.5 23t31 29t19.5 40q48 267 80 473zM1536 1120
-v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="tumblr" unicode="&#xf173;" horiz-adv-x="1024" 
-d="M944 207l80 -237q-23 -35 -111 -66t-177 -32q-104 -2 -190.5 26t-142.5 74t-95 106t-55.5 120t-16.5 118v544h-168v215q72 26 129 69.5t91 90t58 102t34 99t15 88.5q1 5 4.5 8.5t7.5 3.5h244v-424h333v-252h-334v-518q0 -30 6.5 -56t22.5 -52.5t49.5 -41.5t81.5 -14
-q78 2 134 29z" />
-    <glyph glyph-name="tumblr_sign" unicode="&#xf174;" 
-d="M1136 75l-62 183q-44 -22 -103 -22q-36 -1 -62 10.5t-38.5 31.5t-17.5 40.5t-5 43.5v398h257v194h-256v326h-188q-8 0 -9 -10q-5 -44 -17.5 -87t-39 -95t-77 -95t-118.5 -68v-165h130v-418q0 -57 21.5 -115t65 -111t121 -85.5t176.5 -30.5q69 1 136.5 25t85.5 50z
-M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="long_arrow_down" unicode="&#xf175;" horiz-adv-x="768" 
-d="M765 237q8 -19 -5 -35l-350 -384q-10 -10 -23 -10q-14 0 -24 10l-355 384q-13 16 -5 35q9 19 29 19h224v1248q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1248h224q21 0 29 -19z" />
-    <glyph glyph-name="long_arrow_up" unicode="&#xf176;" horiz-adv-x="768" 
-d="M765 1043q-9 -19 -29 -19h-224v-1248q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1248h-224q-21 0 -29 19t5 35l350 384q10 10 23 10q14 0 24 -10l355 -384q13 -16 5 -35z" />
-    <glyph glyph-name="long_arrow_left" unicode="&#xf177;" horiz-adv-x="1792" 
-d="M1792 736v-192q0 -14 -9 -23t-23 -9h-1248v-224q0 -21 -19 -29t-35 5l-384 350q-10 10 -10 23q0 14 10 24l384 354q16 14 35 6q19 -9 19 -29v-224h1248q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="long_arrow_right" unicode="&#xf178;" horiz-adv-x="1792" 
-d="M1728 643q0 -14 -10 -24l-384 -354q-16 -14 -35 -6q-19 9 -19 29v224h-1248q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h1248v224q0 21 19 29t35 -5l384 -350q10 -10 10 -23z" />
-    <glyph glyph-name="apple" unicode="&#xf179;" horiz-adv-x="1408" 
-d="M1393 321q-39 -125 -123 -250q-129 -196 -257 -196q-49 0 -140 32q-86 32 -151 32q-61 0 -142 -33q-81 -34 -132 -34q-152 0 -301 259q-147 261 -147 503q0 228 113 374q113 144 284 144q72 0 177 -30q104 -30 138 -30q45 0 143 34q102 34 173 34q119 0 213 -65
-q52 -36 104 -100q-79 -67 -114 -118q-65 -94 -65 -207q0 -124 69 -223t158 -126zM1017 1494q0 -61 -29 -136q-30 -75 -93 -138q-54 -54 -108 -72q-37 -11 -104 -17q3 149 78 257q74 107 250 148q1 -3 2.5 -11t2.5 -11q0 -4 0.5 -10t0.5 -10z" />
-    <glyph glyph-name="windows" unicode="&#xf17a;" horiz-adv-x="1664" 
-d="M682 530v-651l-682 94v557h682zM682 1273v-659h-682v565zM1664 530v-786l-907 125v661h907zM1664 1408v-794h-907v669z" />
-    <glyph glyph-name="android" unicode="&#xf17b;" horiz-adv-x="1408" 
-d="M493 1053q16 0 27.5 11.5t11.5 27.5t-11.5 27.5t-27.5 11.5t-27 -11.5t-11 -27.5t11 -27.5t27 -11.5zM915 1053q16 0 27 11.5t11 27.5t-11 27.5t-27 11.5t-27.5 -11.5t-11.5 -27.5t11.5 -27.5t27.5 -11.5zM103 869q42 0 72 -30t30 -72v-430q0 -43 -29.5 -73t-72.5 -30
-t-73 30t-30 73v430q0 42 30 72t73 30zM1163 850v-666q0 -46 -32 -78t-77 -32h-75v-227q0 -43 -30 -73t-73 -30t-73 30t-30 73v227h-138v-227q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73l-1 227h-74q-46 0 -78 32t-32 78v666h918zM931 1255q107 -55 171 -153.5t64 -215.5
-h-925q0 117 64 215.5t172 153.5l-71 131q-7 13 5 20q13 6 20 -6l72 -132q95 42 201 42t201 -42l72 132q7 12 20 6q12 -7 5 -20zM1408 767v-430q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73v430q0 43 30 72.5t72 29.5q43 0 73 -29.5t30 -72.5z" />
-    <glyph glyph-name="linux" unicode="&#xf17c;" 
-d="M663 1125q-11 -1 -15.5 -10.5t-8.5 -9.5q-5 -1 -5 5q0 12 19 15h10zM750 1111q-4 -1 -11.5 6.5t-17.5 4.5q24 11 32 -2q3 -6 -3 -9zM399 684q-4 1 -6 -3t-4.5 -12.5t-5.5 -13.5t-10 -13q-10 -11 -1 -12q4 -1 12.5 7t12.5 18q1 3 2 7t2 6t1.5 4.5t0.5 4v3t-1 2.5t-3 2z
-M1254 325q0 18 -55 42q4 15 7.5 27.5t5 26t3 21.5t0.5 22.5t-1 19.5t-3.5 22t-4 20.5t-5 25t-5.5 26.5q-10 48 -47 103t-72 75q24 -20 57 -83q87 -162 54 -278q-11 -40 -50 -42q-31 -4 -38.5 18.5t-8 83.5t-11.5 107q-9 39 -19.5 69t-19.5 45.5t-15.5 24.5t-13 15t-7.5 7
-q-14 62 -31 103t-29.5 56t-23.5 33t-15 40q-4 21 6 53.5t4.5 49.5t-44.5 25q-15 3 -44.5 18t-35.5 16q-8 1 -11 26t8 51t36 27q37 3 51 -30t4 -58q-11 -19 -2 -26.5t30 -0.5q13 4 13 36v37q-5 30 -13.5 50t-21 30.5t-23.5 15t-27 7.5q-107 -8 -89 -134q0 -15 -1 -15
-q-9 9 -29.5 10.5t-33 -0.5t-15.5 5q1 57 -16 90t-45 34q-27 1 -41.5 -27.5t-16.5 -59.5q-1 -15 3.5 -37t13 -37.5t15.5 -13.5q10 3 16 14q4 9 -7 8q-7 0 -15.5 14.5t-9.5 33.5q-1 22 9 37t34 14q17 0 27 -21t9.5 -39t-1.5 -22q-22 -15 -31 -29q-8 -12 -27.5 -23.5
-t-20.5 -12.5q-13 -14 -15.5 -27t7.5 -18q14 -8 25 -19.5t16 -19t18.5 -13t35.5 -6.5q47 -2 102 15q2 1 23 7t34.5 10.5t29.5 13t21 17.5q9 14 20 8q5 -3 6.5 -8.5t-3 -12t-16.5 -9.5q-20 -6 -56.5 -21.5t-45.5 -19.5q-44 -19 -70 -23q-25 -5 -79 2q-10 2 -9 -2t17 -19
-q25 -23 67 -22q17 1 36 7t36 14t33.5 17.5t30 17t24.5 12t17.5 2.5t8.5 -11q0 -2 -1 -4.5t-4 -5t-6 -4.5t-8.5 -5t-9 -4.5t-10 -5t-9.5 -4.5q-28 -14 -67.5 -44t-66.5 -43t-49 -1q-21 11 -63 73q-22 31 -25 22q-1 -3 -1 -10q0 -25 -15 -56.5t-29.5 -55.5t-21 -58t11.5 -63
-q-23 -6 -62.5 -90t-47.5 -141q-2 -18 -1.5 -69t-5.5 -59q-8 -24 -29 -3q-32 31 -36 94q-2 28 4 56q4 19 -1 18q-2 -1 -4 -5q-36 -65 10 -166q5 -12 25 -28t24 -20q20 -23 104 -90.5t93 -76.5q16 -15 17.5 -38t-14 -43t-45.5 -23q8 -15 29 -44.5t28 -54t7 -70.5q46 24 7 92
-q-4 8 -10.5 16t-9.5 12t-2 6q3 5 13 9.5t20 -2.5q46 -52 166 -36q133 15 177 87q23 38 34 30q12 -6 10 -52q-1 -25 -23 -92q-9 -23 -6 -37.5t24 -15.5q3 19 14.5 77t13.5 90q2 21 -6.5 73.5t-7.5 97t23 70.5q15 18 51 18q1 37 34.5 53t72.5 10.5t60 -22.5zM626 1152
-q3 17 -2.5 30t-11.5 15q-9 2 -9 -7q2 -5 5 -6q10 0 7 -15q-3 -20 8 -20q3 0 3 3zM1045 955q-2 8 -6.5 11.5t-13 5t-14.5 5.5q-5 3 -9.5 8t-7 8t-5.5 6.5t-4 4t-4 -1.5q-14 -16 7 -43.5t39 -31.5q9 -1 14.5 8t3.5 20zM867 1168q0 11 -5 19.5t-11 12.5t-9 3q-6 0 -8 -2t0 -4
-t5 -3q14 -4 18 -31q0 -3 8 2q2 2 2 3zM921 1401q0 2 -2.5 5t-9 7t-9.5 6q-15 15 -24 15q-9 -1 -11.5 -7.5t-1 -13t-0.5 -12.5q-1 -4 -6 -10.5t-6 -9t3 -8.5q4 -3 8 0t11 9t15 9q1 1 9 1t15 2t9 7zM1486 60q20 -12 31 -24.5t12 -24t-2.5 -22.5t-15.5 -22t-23.5 -19.5
-t-30 -18.5t-31.5 -16.5t-32 -15.5t-27 -13q-38 -19 -85.5 -56t-75.5 -64q-17 -16 -68 -19.5t-89 14.5q-18 9 -29.5 23.5t-16.5 25.5t-22 19.5t-47 9.5q-44 1 -130 1q-19 0 -57 -1.5t-58 -2.5q-44 -1 -79.5 -15t-53.5 -30t-43.5 -28.5t-53.5 -11.5q-29 1 -111 31t-146 43
-q-19 4 -51 9.5t-50 9t-39.5 9.5t-33.5 14.5t-17 19.5q-10 23 7 66.5t18 54.5q1 16 -4 40t-10 42.5t-4.5 36.5t10.5 27q14 12 57 14t60 12q30 18 42 35t12 51q21 -73 -32 -106q-32 -20 -83 -15q-34 3 -43 -10q-13 -15 5 -57q2 -6 8 -18t8.5 -18t4.5 -17t1 -22q0 -15 -17 -49
-t-14 -48q3 -17 37 -26q20 -6 84.5 -18.5t99.5 -20.5q24 -6 74 -22t82.5 -23t55.5 -4q43 6 64.5 28t23 48t-7.5 58.5t-19 52t-20 36.5q-121 190 -169 242q-68 74 -113 40q-11 -9 -15 15q-3 16 -2 38q1 29 10 52t24 47t22 42q8 21 26.5 72t29.5 78t30 61t39 54
-q110 143 124 195q-12 112 -16 310q-2 90 24 151.5t106 104.5q39 21 104 21q53 1 106 -13.5t89 -41.5q57 -42 91.5 -121.5t29.5 -147.5q-5 -95 30 -214q34 -113 133 -218q55 -59 99.5 -163t59.5 -191q8 -49 5 -84.5t-12 -55.5t-20 -22q-10 -2 -23.5 -19t-27 -35.5
-t-40.5 -33.5t-61 -14q-18 1 -31.5 5t-22.5 13.5t-13.5 15.5t-11.5 20.5t-9 19.5q-22 37 -41 30t-28 -49t7 -97q20 -70 1 -195q-10 -65 18 -100.5t73 -33t85 35.5q59 49 89.5 66.5t103.5 42.5q53 18 77 36.5t18.5 34.5t-25 28.5t-51.5 23.5q-33 11 -49.5 48t-15 72.5
-t15.5 47.5q1 -31 8 -56.5t14.5 -40.5t20.5 -28.5t21 -19t21.5 -13t16.5 -9.5z" />
-    <glyph glyph-name="dribble" unicode="&#xf17d;" 
-d="M1024 36q-42 241 -140 498h-2l-2 -1q-16 -6 -43 -16.5t-101 -49t-137 -82t-131 -114.5t-103 -148l-15 11q184 -150 418 -150q132 0 256 52zM839 643q-21 49 -53 111q-311 -93 -673 -93q-1 -7 -1 -21q0 -124 44 -236.5t124 -201.5q50 89 123.5 166.5t142.5 124.5t130.5 81
-t99.5 48l37 13q4 1 13 3.5t13 4.5zM732 855q-120 213 -244 378q-138 -65 -234 -186t-128 -272q302 0 606 80zM1416 536q-210 60 -409 29q87 -239 128 -469q111 75 185 189.5t96 250.5zM611 1277q-1 0 -2 -1q1 1 2 1zM1201 1132q-185 164 -433 164q-76 0 -155 -19
-q131 -170 246 -382q69 26 130 60.5t96.5 61.5t65.5 57t37.5 40.5zM1424 647q-3 232 -149 410l-1 -1q-9 -12 -19 -24.5t-43.5 -44.5t-71 -60.5t-100 -65t-131.5 -64.5q25 -53 44 -95q2 -5 6.5 -17t7.5 -17q36 5 74.5 7t73.5 2t69 -1.5t64 -4t56.5 -5.5t48 -6.5t36.5 -6
-t25 -4.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="skype" unicode="&#xf17e;" 
-d="M1173 473q0 50 -19.5 91.5t-48.5 68.5t-73 49t-82.5 34t-87.5 23l-104 24q-30 7 -44 10.5t-35 11.5t-30 16t-16.5 21t-7.5 30q0 77 144 77q43 0 77 -12t54 -28.5t38 -33.5t40 -29t48 -12q47 0 75.5 32t28.5 77q0 55 -56 99.5t-142 67.5t-182 23q-68 0 -132 -15.5
-t-119.5 -47t-89 -87t-33.5 -128.5q0 -61 19 -106.5t56 -75.5t80 -48.5t103 -32.5l146 -36q90 -22 112 -36q32 -20 32 -60q0 -39 -40 -64.5t-105 -25.5q-51 0 -91.5 16t-65 38.5t-45.5 45t-46 38.5t-54 16q-50 0 -75.5 -30t-25.5 -75q0 -92 122 -157.5t291 -65.5
-q73 0 140 18.5t122.5 53.5t88.5 93.5t33 131.5zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5q-130 0 -234 80q-77 -16 -150 -16q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5q0 73 16 150q-80 104 -80 234q0 159 112.5 271.5t271.5 112.5q130 0 234 -80
-q77 16 150 16q143 0 273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -73 -16 -150q80 -104 80 -234z" />
-    <glyph glyph-name="foursquare" unicode="&#xf180;" horiz-adv-x="1280" 
-d="M1000 1102l37 194q5 23 -9 40t-35 17h-712q-23 0 -38.5 -17t-15.5 -37v-1101q0 -7 6 -1l291 352q23 26 38 33.5t48 7.5h239q22 0 37 14.5t18 29.5q24 130 37 191q4 21 -11.5 40t-36.5 19h-294q-29 0 -48 19t-19 48v42q0 29 19 47.5t48 18.5h346q18 0 35 13.5t20 29.5z
-M1227 1324q-15 -73 -53.5 -266.5t-69.5 -350t-35 -173.5q-6 -22 -9 -32.5t-14 -32.5t-24.5 -33t-38.5 -21t-58 -10h-271q-13 0 -22 -10q-8 -9 -426 -494q-22 -25 -58.5 -28.5t-48.5 5.5q-55 22 -55 98v1410q0 55 38 102.5t120 47.5h888q95 0 127 -53t10 -159zM1227 1324
-l-158 -790q4 17 35 173.5t69.5 350t53.5 266.5z" />
-    <glyph glyph-name="trello" unicode="&#xf181;" 
-d="M704 192v1024q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-1024q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1376 576v640q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-640q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408
-q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="female" unicode="&#xf182;" horiz-adv-x="1280" 
-d="M1280 480q0 -40 -28 -68t-68 -28q-51 0 -80 43l-227 341h-45v-132l247 -411q9 -15 9 -33q0 -26 -19 -45t-45 -19h-192v-272q0 -46 -33 -79t-79 -33h-160q-46 0 -79 33t-33 79v272h-192q-26 0 -45 19t-19 45q0 18 9 33l247 411v132h-45l-227 -341q-29 -43 -80 -43
-q-40 0 -68 28t-28 68q0 29 16 53l256 384q73 107 176 107h384q103 0 176 -107l256 -384q16 -24 16 -53zM864 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="male" unicode="&#xf183;" horiz-adv-x="1024" 
-d="M1024 832v-416q0 -40 -28 -68t-68 -28t-68 28t-28 68v352h-64v-912q0 -46 -33 -79t-79 -33t-79 33t-33 79v464h-64v-464q0 -46 -33 -79t-79 -33t-79 33t-33 79v912h-64v-352q0 -40 -28 -68t-68 -28t-68 28t-28 68v416q0 80 56 136t136 56h640q80 0 136 -56t56 -136z
-M736 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="gittip" unicode="&#xf184;" 
-d="M773 234l350 473q16 22 24.5 59t-6 85t-61.5 79q-40 26 -83 25.5t-73.5 -17.5t-54.5 -45q-36 -40 -96 -40q-59 0 -95 40q-24 28 -54.5 45t-73.5 17.5t-84 -25.5q-46 -31 -60.5 -79t-6 -85t24.5 -59zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="sun" unicode="&#xf185;" horiz-adv-x="1792" 
-d="M1472 640q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5t-223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5t45.5 -223.5t123 -184t184 -123t223.5 -45.5t223.5 45.5t184 123t123 184t45.5 223.5zM1748 363q-4 -15 -20 -20l-292 -96v-306q0 -16 -13 -26q-15 -10 -29 -4
-l-292 94l-180 -248q-10 -13 -26 -13t-26 13l-180 248l-292 -94q-14 -6 -29 4q-13 10 -13 26v306l-292 96q-16 5 -20 20q-5 17 4 29l180 248l-180 248q-9 13 -4 29q4 15 20 20l292 96v306q0 16 13 26q15 10 29 4l292 -94l180 248q9 12 26 12t26 -12l180 -248l292 94
-q14 6 29 -4q13 -10 13 -26v-306l292 -96q16 -5 20 -20q5 -16 -4 -29l-180 -248l180 -248q9 -12 4 -29z" />
-    <glyph glyph-name="_366" unicode="&#xf186;" 
-d="M1262 233q-54 -9 -110 -9q-182 0 -337 90t-245 245t-90 337q0 192 104 357q-201 -60 -328.5 -229t-127.5 -384q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51q144 0 273.5 61.5t220.5 171.5zM1465 318q-94 -203 -283.5 -324.5t-413.5 -121.5q-156 0 -298 61
-t-245 164t-164 245t-61 298q0 153 57.5 292.5t156 241.5t235.5 164.5t290 68.5q44 2 61 -39q18 -41 -15 -72q-86 -78 -131.5 -181.5t-45.5 -218.5q0 -148 73 -273t198 -198t273 -73q118 0 228 51q41 18 72 -13q14 -14 17.5 -34t-4.5 -38z" />
-    <glyph glyph-name="archive" unicode="&#xf187;" horiz-adv-x="1792" 
-d="M1088 704q0 26 -19 45t-45 19h-256q-26 0 -45 -19t-19 -45t19 -45t45 -19h256q26 0 45 19t19 45zM1664 896v-960q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v960q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1728 1344v-256q0 -26 -19 -45t-45 -19h-1536
-q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1536q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="bug" unicode="&#xf188;" horiz-adv-x="1664" 
-d="M1632 576q0 -26 -19 -45t-45 -19h-224q0 -171 -67 -290l208 -209q19 -19 19 -45t-19 -45q-18 -19 -45 -19t-45 19l-198 197q-5 -5 -15 -13t-42 -28.5t-65 -36.5t-82 -29t-97 -13v896h-128v-896q-51 0 -101.5 13.5t-87 33t-66 39t-43.5 32.5l-15 14l-183 -207
-q-20 -21 -48 -21q-24 0 -43 16q-19 18 -20.5 44.5t15.5 46.5l202 227q-58 114 -58 274h-224q-26 0 -45 19t-19 45t19 45t45 19h224v294l-173 173q-19 19 -19 45t19 45t45 19t45 -19l173 -173h844l173 173q19 19 45 19t45 -19t19 -45t-19 -45l-173 -173v-294h224q26 0 45 -19
-t19 -45zM1152 1152h-640q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5z" />
-    <glyph glyph-name="vk" unicode="&#xf189;" horiz-adv-x="1920" 
-d="M1917 1016q23 -64 -150 -294q-24 -32 -65 -85q-40 -51 -55 -72t-30.5 -49.5t-12 -42t13 -34.5t32.5 -43t57 -53q4 -2 5 -4q141 -131 191 -221q3 -5 6.5 -12.5t7 -26.5t-0.5 -34t-25 -27.5t-59 -12.5l-256 -4q-24 -5 -56 5t-52 22l-20 12q-30 21 -70 64t-68.5 77.5t-61 58
-t-56.5 15.5q-3 -1 -8 -3.5t-17 -14.5t-21.5 -29.5t-17 -52t-6.5 -77.5q0 -15 -3.5 -27.5t-7.5 -18.5l-4 -5q-18 -19 -53 -22h-115q-71 -4 -146 16.5t-131.5 53t-103 66t-70.5 57.5l-25 24q-10 10 -27.5 30t-71.5 91t-106 151t-122.5 211t-130.5 272q-6 16 -6 27t3 16l4 6
-q15 19 57 19l274 2q12 -2 23 -6.5t16 -8.5l5 -3q16 -11 24 -32q20 -50 46 -103.5t41 -81.5l16 -29q29 -60 56 -104t48.5 -68.5t41.5 -38.5t34 -14t27 5q2 1 5 5t12 22t13.5 47t9.5 81t0 125q-2 40 -9 73t-14 46l-6 12q-25 34 -85 43q-13 2 5 24q16 19 38 30q53 26 239 24
-q82 -1 135 -13q20 -5 33.5 -13.5t20.5 -24t10.5 -32t3.5 -45.5t-1 -55t-2.5 -70.5t-1.5 -82.5q0 -11 -1 -42t-0.5 -48t3.5 -40.5t11.5 -39t22.5 -24.5q8 -2 17 -4t26 11t38 34.5t52 67t68 107.5q60 104 107 225q4 10 10 17.5t11 10.5l4 3l5 2.5t13 3t20 0.5l288 2
-q39 5 64 -2.5t31 -16.5z" />
-    <glyph glyph-name="weibo" unicode="&#xf18a;" horiz-adv-x="1792" 
-d="M675 252q21 34 11 69t-45 50q-34 14 -73 1t-60 -46q-22 -34 -13 -68.5t43 -50.5t74.5 -2.5t62.5 47.5zM769 373q8 13 3.5 26.5t-17.5 18.5q-14 5 -28.5 -0.5t-21.5 -18.5q-17 -31 13 -45q14 -5 29 0.5t22 18.5zM943 266q-45 -102 -158 -150t-224 -12
-q-107 34 -147.5 126.5t6.5 187.5q47 93 151.5 139t210.5 19q111 -29 158.5 -119.5t2.5 -190.5zM1255 426q-9 96 -89 170t-208.5 109t-274.5 21q-223 -23 -369.5 -141.5t-132.5 -264.5q9 -96 89 -170t208.5 -109t274.5 -21q223 23 369.5 141.5t132.5 264.5zM1563 422
-q0 -68 -37 -139.5t-109 -137t-168.5 -117.5t-226 -83t-270.5 -31t-275 33.5t-240.5 93t-171.5 151t-65 199.5q0 115 69.5 245t197.5 258q169 169 341.5 236t246.5 -7q65 -64 20 -209q-4 -14 -1 -20t10 -7t14.5 0.5t13.5 3.5l6 2q139 59 246 59t153 -61q45 -63 0 -178
-q-2 -13 -4.5 -20t4.5 -12.5t12 -7.5t17 -6q57 -18 103 -47t80 -81.5t34 -116.5zM1489 1046q42 -47 54.5 -108.5t-6.5 -117.5q-8 -23 -29.5 -34t-44.5 -4q-23 8 -34 29.5t-4 44.5q20 63 -24 111t-107 35q-24 -5 -45 8t-25 37q-5 24 8 44.5t37 25.5q60 13 119 -5.5t101 -65.5z
-M1670 1209q87 -96 112.5 -222.5t-13.5 -241.5q-9 -27 -34 -40t-52 -4t-40 34t-5 52q28 82 10 172t-80 158q-62 69 -148 95.5t-173 8.5q-28 -6 -52 9.5t-30 43.5t9.5 51.5t43.5 29.5q123 26 244 -11.5t208 -134.5z" />
-    <glyph glyph-name="renren" unicode="&#xf18b;" 
-d="M1133 -34q-171 -94 -368 -94q-196 0 -367 94q138 87 235.5 211t131.5 268q35 -144 132.5 -268t235.5 -211zM638 1394v-485q0 -252 -126.5 -459.5t-330.5 -306.5q-181 215 -181 495q0 187 83.5 349.5t229.5 269.5t325 137zM1536 638q0 -280 -181 -495
-q-204 99 -330.5 306.5t-126.5 459.5v485q179 -30 325 -137t229.5 -269.5t83.5 -349.5z" />
-    <glyph glyph-name="_372" unicode="&#xf18c;" horiz-adv-x="1408" 
-d="M1402 433q-32 -80 -76 -138t-91 -88.5t-99 -46.5t-101.5 -14.5t-96.5 8.5t-86.5 22t-69.5 27.5t-46 22.5l-17 10q-113 -228 -289.5 -359.5t-384.5 -132.5q-19 0 -32 13t-13 32t13 31.5t32 12.5q173 1 322.5 107.5t251.5 294.5q-36 -14 -72 -23t-83 -13t-91 2.5t-93 28.5
-t-92 59t-84.5 100t-74.5 146q114 47 214 57t167.5 -7.5t124.5 -56.5t88.5 -77t56.5 -82q53 131 79 291q-7 -1 -18 -2.5t-46.5 -2.5t-69.5 0.5t-81.5 10t-88.5 23t-84 42.5t-75 65t-54.5 94.5t-28.5 127.5q70 28 133.5 36.5t112.5 -1t92 -30t73.5 -50t56 -61t42 -63t27.5 -56
-t16 -39.5l4 -16q12 122 12 195q-8 6 -21.5 16t-49 44.5t-63.5 71.5t-54 93t-33 112.5t12 127t70 138.5q73 -25 127.5 -61.5t84.5 -76.5t48 -85t20.5 -89t-0.5 -85.5t-13 -76.5t-19 -62t-17 -42l-7 -15q1 -4 1 -50t-1 -72q3 7 10 18.5t30.5 43t50.5 58t71 55.5t91.5 44.5
-t112 14.5t132.5 -24q-2 -78 -21.5 -141.5t-50 -104.5t-69.5 -71.5t-81.5 -45.5t-84.5 -24t-80 -9.5t-67.5 1t-46.5 4.5l-17 3q-23 -147 -73 -283q6 7 18 18.5t49.5 41t77.5 52.5t99.5 42t117.5 20t129 -23.5t137 -77.5z" />
-    <glyph glyph-name="stack_exchange" unicode="&#xf18d;" horiz-adv-x="1280" 
-d="M1259 283v-66q0 -85 -57.5 -144.5t-138.5 -59.5h-57l-260 -269v269h-529q-81 0 -138.5 59.5t-57.5 144.5v66h1238zM1259 609v-255h-1238v255h1238zM1259 937v-255h-1238v255h1238zM1259 1077v-67h-1238v67q0 84 57.5 143.5t138.5 59.5h846q81 0 138.5 -59.5t57.5 -143.5z
-" />
-    <glyph glyph-name="_374" unicode="&#xf18e;" 
-d="M1152 640q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198
-t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="arrow_circle_alt_left" unicode="&#xf190;" 
-d="M1152 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-192q0 -14 -9 -23t-23 -9q-12 0 -24 10l-319 319q-9 9 -9 23t9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h352q13 0 22.5 -9.5t9.5 -22.5zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198
-t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_376" unicode="&#xf191;" 
-d="M1024 960v-640q0 -26 -19 -45t-45 -19q-20 0 -37 12l-448 320q-27 19 -27 52t27 52l448 320q17 12 37 12q26 0 45 -19t19 -45zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5z
-M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="dot_circle_alt" unicode="&#xf192;" 
-d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5
-t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_378" unicode="&#xf193;" horiz-adv-x="1664" 
-d="M1023 349l102 -204q-58 -179 -210 -290t-339 -111q-156 0 -288.5 77.5t-210 210t-77.5 288.5q0 181 104.5 330t274.5 211l17 -131q-122 -54 -195 -165.5t-73 -244.5q0 -185 131.5 -316.5t316.5 -131.5q126 0 232.5 65t165 175.5t49.5 236.5zM1571 249l58 -114l-256 -128
-q-13 -7 -29 -7q-40 0 -57 35l-239 477h-472q-24 0 -42.5 16.5t-21.5 40.5l-96 779q-2 17 6 42q14 51 57 82.5t97 31.5q66 0 113 -47t47 -113q0 -69 -52 -117.5t-120 -41.5l37 -289h423v-128h-407l16 -128h455q40 0 57 -35l228 -455z" />
-    <glyph glyph-name="vimeo_square" unicode="&#xf194;" 
-d="M1292 898q10 216 -161 222q-231 8 -312 -261q44 19 82 19q85 0 74 -96q-4 -57 -74 -167t-105 -110q-43 0 -82 169q-13 54 -45 255q-30 189 -160 177q-59 -7 -164 -100l-81 -72l-81 -72l52 -67q76 52 87 52q57 0 107 -179q15 -55 45 -164.5t45 -164.5q68 -179 164 -179
-q157 0 383 294q220 283 226 444zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_380" unicode="&#xf195;" horiz-adv-x="1152" 
-d="M1152 704q0 -191 -94.5 -353t-256.5 -256.5t-353 -94.5h-160q-14 0 -23 9t-9 23v611l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v93l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v250q0 14 9 23t23 9h160
-q14 0 23 -9t9 -23v-181l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-93l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-487q188 13 318 151t130 328q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="plus_square_o" unicode="&#xf196;" horiz-adv-x="1408" 
-d="M1152 736v-64q0 -14 -9 -23t-23 -9h-352v-352q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v352h-352q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h352v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-352h352q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832
-q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_382" unicode="&#xf197;" horiz-adv-x="2176" 
-d="M620 416q-110 -64 -268 -64h-128v64h-64q-13 0 -22.5 23.5t-9.5 56.5q0 24 7 49q-58 2 -96.5 10.5t-38.5 20.5t38.5 20.5t96.5 10.5q-7 25 -7 49q0 33 9.5 56.5t22.5 23.5h64v64h128q158 0 268 -64h1113q42 -7 106.5 -18t80.5 -14q89 -15 150 -40.5t83.5 -47.5t22.5 -40
-t-22.5 -40t-83.5 -47.5t-150 -40.5q-16 -3 -80.5 -14t-106.5 -18h-1113zM1739 668q53 -36 53 -92t-53 -92l81 -30q68 48 68 122t-68 122zM625 400h1015q-217 -38 -456 -80q-57 0 -113 -24t-83 -48l-28 -24l-288 -288q-26 -26 -70.5 -45t-89.5 -19h-96l-93 464h29
-q157 0 273 64zM352 816h-29l93 464h96q46 0 90 -19t70 -45l288 -288q4 -4 11 -10.5t30.5 -23t48.5 -29t61.5 -23t72.5 -10.5l456 -80h-1015q-116 64 -273 64z" />
-    <glyph glyph-name="_383" unicode="&#xf198;" horiz-adv-x="1664" 
-d="M1519 760q62 0 103.5 -40.5t41.5 -101.5q0 -97 -93 -130l-172 -59l56 -167q7 -21 7 -47q0 -59 -42 -102t-101 -43q-47 0 -85.5 27t-53.5 72l-55 165l-310 -106l55 -164q8 -24 8 -47q0 -59 -42 -102t-102 -43q-47 0 -85 27t-53 72l-55 163l-153 -53q-29 -9 -50 -9
-q-61 0 -101.5 40t-40.5 101q0 47 27.5 85t71.5 53l156 53l-105 313l-156 -54q-26 -8 -48 -8q-60 0 -101 40.5t-41 100.5q0 47 27.5 85t71.5 53l157 53l-53 159q-8 24 -8 47q0 60 42 102.5t102 42.5q47 0 85 -27t53 -72l54 -160l310 105l-54 160q-8 24 -8 47q0 59 42.5 102
-t101.5 43q47 0 85.5 -27.5t53.5 -71.5l53 -161l162 55q21 6 43 6q60 0 102.5 -39.5t42.5 -98.5q0 -45 -30 -81.5t-74 -51.5l-157 -54l105 -316l164 56q24 8 46 8zM725 498l310 105l-105 315l-310 -107z" />
-    <glyph glyph-name="_384" unicode="&#xf199;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM1280 352v436q-31 -35 -64 -55q-34 -22 -132.5 -85t-151.5 -99q-98 -69 -164 -69v0v0q-66 0 -164 69
-q-47 32 -142 92.5t-142 92.5q-12 8 -33 27t-31 27v-436q0 -40 28 -68t68 -28h832q40 0 68 28t28 68zM1280 925q0 41 -27.5 70t-68.5 29h-832q-40 0 -68 -28t-28 -68q0 -37 30.5 -76.5t67.5 -64.5q47 -32 137.5 -89t129.5 -83q3 -2 17 -11.5t21 -14t21 -13t23.5 -13
-t21.5 -9.5t22.5 -7.5t20.5 -2.5t20.5 2.5t22.5 7.5t21.5 9.5t23.5 13t21 13t21 14t17 11.5l267 174q35 23 66.5 62.5t31.5 73.5z" />
-    <glyph glyph-name="_385" unicode="&#xf19a;" horiz-adv-x="1792" 
-d="M127 640q0 163 67 313l367 -1005q-196 95 -315 281t-119 411zM1415 679q0 -19 -2.5 -38.5t-10 -49.5t-11.5 -44t-17.5 -59t-17.5 -58l-76 -256l-278 826q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-75 1 -202 10q-12 1 -20.5 -5t-11.5 -15t-1.5 -18.5t9 -16.5
-t19.5 -8l80 -8l120 -328l-168 -504l-280 832q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-7 0 -23 0.5t-26 0.5q105 160 274.5 253.5t367.5 93.5q147 0 280.5 -53t238.5 -149h-10q-55 0 -92 -40.5t-37 -95.5q0 -12 2 -24t4 -21.5t8 -23t9 -21t12 -22.5t12.5 -21
-t14.5 -24t14 -23q63 -107 63 -212zM909 573l237 -647q1 -6 5 -11q-126 -44 -255 -44q-112 0 -217 32zM1570 1009q95 -174 95 -369q0 -209 -104 -385.5t-279 -278.5l235 678q59 169 59 276q0 42 -6 79zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286
-t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 -215q173 0 331.5 68t273 182.5t182.5 273t68 331.5t-68 331.5t-182.5 273t-273 182.5t-331.5 68t-331.5 -68t-273 -182.5t-182.5 -273t-68 -331.5t68 -331.5t182.5 -273
-t273 -182.5t331.5 -68z" />
-    <glyph glyph-name="_386" unicode="&#xf19b;" horiz-adv-x="1792" 
-d="M1086 1536v-1536l-272 -128q-228 20 -414 102t-293 208.5t-107 272.5q0 140 100.5 263.5t275 205.5t391.5 108v-172q-217 -38 -356.5 -150t-139.5 -255q0 -152 154.5 -267t388.5 -145v1360zM1755 954l37 -390l-525 114l147 83q-119 70 -280 99v172q277 -33 481 -157z" />
-    <glyph glyph-name="_387" unicode="&#xf19c;" horiz-adv-x="2048" 
-d="M960 1536l960 -384v-128h-128q0 -26 -20.5 -45t-48.5 -19h-1526q-28 0 -48.5 19t-20.5 45h-128v128zM256 896h256v-768h128v768h256v-768h128v768h256v-768h128v768h256v-768h59q28 0 48.5 -19t20.5 -45v-64h-1664v64q0 26 20.5 45t48.5 19h59v768zM1851 -64
-q28 0 48.5 -19t20.5 -45v-128h-1920v128q0 26 20.5 45t48.5 19h1782z" />
-    <glyph glyph-name="_388" unicode="&#xf19d;" horiz-adv-x="2304" 
-d="M1774 700l18 -316q4 -69 -82 -128t-235 -93.5t-323 -34.5t-323 34.5t-235 93.5t-82 128l18 316l574 -181q22 -7 48 -7t48 7zM2304 1024q0 -23 -22 -31l-1120 -352q-4 -1 -10 -1t-10 1l-652 206q-43 -34 -71 -111.5t-34 -178.5q63 -36 63 -109q0 -69 -58 -107l58 -433
-q2 -14 -8 -25q-9 -11 -24 -11h-192q-15 0 -24 11q-10 11 -8 25l58 433q-58 38 -58 107q0 73 65 111q11 207 98 330l-333 104q-22 8 -22 31t22 31l1120 352q4 1 10 1t10 -1l1120 -352q22 -8 22 -31z" />
-    <glyph glyph-name="_389" unicode="&#xf19e;" 
-d="M859 579l13 -707q-62 11 -105 11q-41 0 -105 -11l13 707q-40 69 -168.5 295.5t-216.5 374.5t-181 287q58 -15 108 -15q44 0 111 15q63 -111 133.5 -229.5t167 -276.5t138.5 -227q37 61 109.5 177.5t117.5 190t105 176t107 189.5q54 -14 107 -14q56 0 114 14v0
-q-28 -39 -60 -88.5t-49.5 -78.5t-56.5 -96t-49 -84q-146 -248 -353 -610z" />
-    <glyph glyph-name="uniF1A0" unicode="&#xf1a0;" 
-d="M768 750h725q12 -67 12 -128q0 -217 -91 -387.5t-259.5 -266.5t-386.5 -96q-157 0 -299 60.5t-245 163.5t-163.5 245t-60.5 299t60.5 299t163.5 245t245 163.5t299 60.5q300 0 515 -201l-209 -201q-123 119 -306 119q-129 0 -238.5 -65t-173.5 -176.5t-64 -243.5
-t64 -243.5t173.5 -176.5t238.5 -65q87 0 160 24t120 60t82 82t51.5 87t22.5 78h-436v264z" />
-    <glyph glyph-name="f1a1" unicode="&#xf1a1;" horiz-adv-x="1792" 
-d="M1095 369q16 -16 0 -31q-62 -62 -199 -62t-199 62q-16 15 0 31q6 6 15 6t15 -6q48 -49 169 -49q120 0 169 49q6 6 15 6t15 -6zM788 550q0 -37 -26 -63t-63 -26t-63.5 26t-26.5 63q0 38 26.5 64t63.5 26t63 -26.5t26 -63.5zM1183 550q0 -37 -26.5 -63t-63.5 -26t-63 26
-t-26 63t26 63.5t63 26.5t63.5 -26t26.5 -64zM1434 670q0 49 -35 84t-85 35t-86 -36q-130 90 -311 96l63 283l200 -45q0 -37 26 -63t63 -26t63.5 26.5t26.5 63.5t-26.5 63.5t-63.5 26.5q-54 0 -80 -50l-221 49q-19 5 -25 -16l-69 -312q-180 -7 -309 -97q-35 37 -87 37
-q-50 0 -85 -35t-35 -84q0 -35 18.5 -64t49.5 -44q-6 -27 -6 -56q0 -142 140 -243t337 -101q198 0 338 101t140 243q0 32 -7 57q30 15 48 43.5t18 63.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191
-t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_392" unicode="&#xf1a2;" 
-d="M939 407q13 -13 0 -26q-53 -53 -171 -53t-171 53q-13 13 0 26q5 6 13 6t13 -6q42 -42 145 -42t145 42q5 6 13 6t13 -6zM676 563q0 -31 -23 -54t-54 -23t-54 23t-23 54q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1014 563q0 -31 -23 -54t-54 -23t-54 23t-23 54
-q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1229 666q0 42 -30 72t-73 30q-42 0 -73 -31q-113 78 -267 82l54 243l171 -39q1 -32 23.5 -54t53.5 -22q32 0 54.5 22.5t22.5 54.5t-22.5 54.5t-54.5 22.5q-48 0 -69 -43l-189 42q-17 5 -21 -13l-60 -268q-154 -6 -265 -83
-q-30 32 -74 32q-43 0 -73 -30t-30 -72q0 -30 16 -55t42 -38q-5 -25 -5 -48q0 -122 120 -208.5t289 -86.5q170 0 290 86.5t120 208.5q0 25 -6 49q25 13 40.5 37.5t15.5 54.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960
-q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_393" unicode="&#xf1a3;" 
-d="M866 697l90 27v62q0 79 -58 135t-138 56t-138 -55.5t-58 -134.5v-283q0 -20 -14 -33.5t-33 -13.5t-32.5 13.5t-13.5 33.5v120h-151v-122q0 -82 57.5 -139t139.5 -57q81 0 138.5 56.5t57.5 136.5v280q0 19 13.5 33t33.5 14q19 0 32.5 -14t13.5 -33v-54zM1199 502v122h-150
-v-126q0 -20 -13.5 -33.5t-33.5 -13.5q-19 0 -32.5 14t-13.5 33v123l-90 -26l-60 28v-123q0 -80 58 -137t139 -57t138.5 57t57.5 139zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103
-t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="f1a4" unicode="&#xf1a4;" horiz-adv-x="1920" 
-d="M1062 824v118q0 42 -30 72t-72 30t-72 -30t-30 -72v-612q0 -175 -126 -299t-303 -124q-178 0 -303.5 125.5t-125.5 303.5v266h328v-262q0 -43 30 -72.5t72 -29.5t72 29.5t30 72.5v620q0 171 126.5 292t301.5 121q176 0 302 -122t126 -294v-136l-195 -58zM1592 602h328
-v-266q0 -178 -125.5 -303.5t-303.5 -125.5q-177 0 -303 124.5t-126 300.5v268l131 -61l195 58v-270q0 -42 30 -71.5t72 -29.5t72 29.5t30 71.5v275z" />
-    <glyph glyph-name="_395" unicode="&#xf1a5;" 
-d="M1472 160v480h-704v704h-480q-93 0 -158.5 -65.5t-65.5 -158.5v-480h704v-704h480q93 0 158.5 65.5t65.5 158.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
-t84.5 -203.5z" />
-    <glyph glyph-name="_396" unicode="&#xf1a6;" horiz-adv-x="2048" 
-d="M328 1254h204v-983h-532v697h328v286zM328 435v369h-123v-369h123zM614 968v-697h205v697h-205zM614 1254v-204h205v204h-205zM901 968h533v-942h-533v163h328v82h-328v697zM1229 435v369h-123v-369h123zM1516 968h532v-942h-532v163h327v82h-327v697zM1843 435v369h-123
-v-369h123z" />
-    <glyph glyph-name="_397" unicode="&#xf1a7;" 
-d="M1046 516q0 -64 -38 -109t-91 -45q-43 0 -70 15v277q28 17 70 17q53 0 91 -45.5t38 -109.5zM703 944q0 -64 -38 -109.5t-91 -45.5q-43 0 -70 15v277q28 17 70 17q53 0 91 -45t38 -109zM1265 513q0 134 -88 229t-213 95q-20 0 -39 -3q-23 -78 -78 -136q-87 -95 -211 -101
-v-636l211 41v206q51 -19 117 -19q125 0 213 95t88 229zM922 940q0 134 -88.5 229t-213.5 95q-74 0 -141 -36h-186v-840l211 41v206q55 -19 116 -19q125 0 213.5 95t88.5 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960
-q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_398" unicode="&#xf1a8;" horiz-adv-x="2038" 
-d="M1222 607q75 3 143.5 -20.5t118 -58.5t101 -94.5t84 -108t75.5 -120.5q33 -56 78.5 -109t75.5 -80.5t99 -88.5q-48 -30 -108.5 -57.5t-138.5 -59t-114 -47.5q-44 37 -74 115t-43.5 164.5t-33 180.5t-42.5 168.5t-72.5 123t-122.5 48.5l-10 -2l-6 -4q4 -5 13 -14
-q6 -5 28 -23.5t25.5 -22t19 -18t18 -20.5t11.5 -21t10.5 -27.5t4.5 -31t4 -40.5l1 -33q1 -26 -2.5 -57.5t-7.5 -52t-12.5 -58.5t-11.5 -53q-35 1 -101 -9.5t-98 -10.5q-39 0 -72 10q-2 16 -2 47q0 74 3 96q2 13 31.5 41.5t57 59t26.5 51.5q-24 2 -43 -24
-q-36 -53 -111.5 -99.5t-136.5 -46.5q-25 0 -75.5 63t-106.5 139.5t-84 96.5q-6 4 -27 30q-482 -112 -513 -112q-16 0 -28 11t-12 27q0 15 8.5 26.5t22.5 14.5l486 106q-8 14 -8 25t5.5 17.5t16 11.5t20 7t23 4.5t18.5 4.5q4 1 15.5 7.5t17.5 6.5q15 0 28 -16t20 -33
-q163 37 172 37q17 0 29.5 -11t12.5 -28q0 -15 -8.5 -26t-23.5 -14l-182 -40l-1 -16q-1 -26 81.5 -117.5t104.5 -91.5q47 0 119 80t72 129q0 36 -23.5 53t-51 18.5t-51 11.5t-23.5 34q0 16 10 34l-68 19q43 44 43 117q0 26 -5 58q82 16 144 16q44 0 71.5 -1.5t48.5 -8.5
-t31 -13.5t20.5 -24.5t15.5 -33.5t17 -47.5t24 -60l50 25q-3 -40 -23 -60t-42.5 -21t-40 -6.5t-16.5 -20.5zM1282 842q-5 5 -13.5 15.5t-12 14.5t-10.5 11.5t-10 10.5l-8 8t-8.5 7.5t-8 5t-8.5 4.5q-7 3 -14.5 5t-20.5 2.5t-22 0.5h-32.5h-37.5q-126 0 -217 -43
-q16 30 36 46.5t54 29.5t65.5 36t46 36.5t50 55t43.5 50.5q12 -9 28 -31.5t32 -36.5t38 -13l12 1v-76l22 -1q247 95 371 190q28 21 50 39t42.5 37.5t33 31t29.5 34t24 31t24.5 37t23 38t27 47.5t29.5 53l7 9q-2 -53 -43 -139q-79 -165 -205 -264t-306 -142q-14 -3 -42 -7.5
-t-50 -9.5t-39 -14q3 -19 24.5 -46t21.5 -34q0 -11 -26 -30zM1061 -79q39 26 131.5 47.5t146.5 21.5q9 0 22.5 -15.5t28 -42.5t26 -50t24 -51t14.5 -33q-121 -45 -244 -45q-61 0 -125 11zM822 568l48 12l109 -177l-73 -48zM1323 51q3 -15 3 -16q0 -7 -17.5 -14.5t-46 -13
-t-54 -9.5t-53.5 -7.5t-32 -4.5l-7 43q21 2 60.5 8.5t72 10t60.5 3.5h14zM866 679l-96 -20l-6 17q10 1 32.5 7t34.5 6q19 0 35 -10zM1061 45h31l10 -83l-41 -12v95zM1950 1535v1v-1zM1950 1535l-1 -5l-2 -2l1 3zM1950 1535l1 1z" />
-    <glyph glyph-name="_399" unicode="&#xf1a9;" 
-d="M1167 -50q-5 19 -24 5q-30 -22 -87 -39t-131 -17q-129 0 -193 49q-5 4 -13 4q-11 0 -26 -12q-7 -6 -7.5 -16t7.5 -20q34 -32 87.5 -46t102.5 -12.5t99 4.5q41 4 84.5 20.5t65 30t28.5 20.5q12 12 7 29zM1128 65q-19 47 -39 61q-23 15 -76 15q-47 0 -71 -10
-q-29 -12 -78 -56q-26 -24 -12 -44q9 -8 17.5 -4.5t31.5 23.5q3 2 10.5 8.5t10.5 8.5t10 7t11.5 7t12.5 5t15 4.5t16.5 2.5t20.5 1q27 0 44.5 -7.5t23 -14.5t13.5 -22q10 -17 12.5 -20t12.5 1q23 12 14 34zM1483 346q0 22 -5 44.5t-16.5 45t-34 36.5t-52.5 14
-q-33 0 -97 -41.5t-129 -83.5t-101 -42q-27 -1 -63.5 19t-76 49t-83.5 58t-100 49t-111 19q-115 -1 -197 -78.5t-84 -178.5q-2 -112 74 -164q29 -20 62.5 -28.5t103.5 -8.5q57 0 132 32.5t134 71t120 70.5t93 31q26 -1 65 -31.5t71.5 -67t68 -67.5t55.5 -32q35 -3 58.5 14
-t55.5 63q28 41 42.5 101t14.5 106zM1536 506q0 -164 -62 -304.5t-166 -236t-242.5 -149.5t-290.5 -54t-293 57.5t-247.5 157t-170.5 241.5t-64 302q0 89 19.5 172.5t49 145.5t70.5 118.5t78.5 94t78.5 69.5t64.5 46.5t42.5 24.5q14 8 51 26.5t54.5 28.5t48 30t60.5 44
-q36 28 58 72.5t30 125.5q129 -155 186 -193q44 -29 130 -68t129 -66q21 -13 39 -25t60.5 -46.5t76 -70.5t75 -95t69 -122t47 -148.5t19.5 -177.5z" />
-    <glyph glyph-name="_400" unicode="&#xf1aa;" 
-d="M1070 463l-160 -160l-151 -152l-30 -30q-65 -64 -151.5 -87t-171.5 -2q-16 -70 -72 -115t-129 -45q-85 0 -145 60.5t-60 145.5q0 72 44.5 128t113.5 72q-22 86 1 173t88 152l12 12l151 -152l-11 -11q-37 -37 -37 -89t37 -90q37 -37 89 -37t89 37l30 30l151 152l161 160z
-M729 1145l12 -12l-152 -152l-12 12q-37 37 -89 37t-89 -37t-37 -89.5t37 -89.5l29 -29l152 -152l160 -160l-151 -152l-161 160l-151 152l-30 30q-68 67 -90 159.5t5 179.5q-70 15 -115 71t-45 129q0 85 60 145.5t145 60.5q76 0 133.5 -49t69.5 -123q84 20 169.5 -3.5
-t149.5 -87.5zM1536 78q0 -85 -60 -145.5t-145 -60.5q-74 0 -131 47t-71 118q-86 -28 -179.5 -6t-161.5 90l-11 12l151 152l12 -12q37 -37 89 -37t89 37t37 89t-37 89l-30 30l-152 152l-160 160l152 152l160 -160l152 -152l29 -30q64 -64 87.5 -150.5t2.5 -171.5
-q76 -11 126.5 -68.5t50.5 -134.5zM1534 1202q0 -77 -51 -135t-127 -69q26 -85 3 -176.5t-90 -158.5l-12 -12l-151 152l12 12q37 37 37 89t-37 89t-89 37t-89 -37l-30 -30l-152 -152l-160 -160l-152 152l161 160l152 152l29 30q67 67 159 89.5t178 -3.5q11 75 68.5 126
-t135.5 51q85 0 145 -60.5t60 -145.5z" />
-    <glyph glyph-name="f1ab" unicode="&#xf1ab;" 
-d="M654 458q-1 -3 -12.5 0.5t-31.5 11.5l-20 9q-44 20 -87 49q-7 5 -41 31.5t-38 28.5q-67 -103 -134 -181q-81 -95 -105 -110q-4 -2 -19.5 -4t-18.5 0q6 4 82 92q21 24 85.5 115t78.5 118q17 30 51 98.5t36 77.5q-8 1 -110 -33q-8 -2 -27.5 -7.5t-34.5 -9.5t-17 -5
-q-2 -2 -2 -10.5t-1 -9.5q-5 -10 -31 -15q-23 -7 -47 0q-18 4 -28 21q-4 6 -5 23q6 2 24.5 5t29.5 6q58 16 105 32q100 35 102 35q10 2 43 19.5t44 21.5q9 3 21.5 8t14.5 5.5t6 -0.5q2 -12 -1 -33q0 -2 -12.5 -27t-26.5 -53.5t-17 -33.5q-25 -50 -77 -131l64 -28
-q12 -6 74.5 -32t67.5 -28q4 -1 10.5 -25.5t4.5 -30.5zM449 944q3 -15 -4 -28q-12 -23 -50 -38q-30 -12 -60 -12q-26 3 -49 26q-14 15 -18 41l1 3q3 -3 19.5 -5t26.5 0t58 16q36 12 55 14q17 0 21 -17zM1147 815l63 -227l-139 42zM39 15l694 232v1032l-694 -233v-1031z
-M1280 332l102 -31l-181 657l-100 31l-216 -536l102 -31l45 110l211 -65zM777 1294l573 -184v380zM1088 -29l158 -13l-54 -160l-40 66q-130 -83 -276 -108q-58 -12 -91 -12h-84q-79 0 -199.5 39t-183.5 85q-8 7 -8 16q0 8 5 13.5t13 5.5q4 0 18 -7.5t30.5 -16.5t20.5 -11
-q73 -37 159.5 -61.5t157.5 -24.5q95 0 167 14.5t157 50.5q15 7 30.5 15.5t34 19t28.5 16.5zM1536 1050v-1079l-774 246q-14 -6 -375 -127.5t-368 -121.5q-13 0 -18 13q0 1 -1 3v1078q3 9 4 10q5 6 20 11q107 36 149 50v384l558 -198q2 0 160.5 55t316 108.5t161.5 53.5
-q20 0 20 -21v-418z" />
-    <glyph glyph-name="_402" unicode="&#xf1ac;" horiz-adv-x="1792" 
-d="M288 1152q66 0 113 -47t47 -113v-1088q0 -66 -47 -113t-113 -47h-128q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h128zM1664 989q58 -34 93 -93t35 -128v-768q0 -106 -75 -181t-181 -75h-864q-66 0 -113 47t-47 113v1536q0 40 28 68t68 28h672q40 0 88 -20t76 -48
-l152 -152q28 -28 48 -76t20 -88v-163zM928 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 512v128q0 14 -9 23
-t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128
-q14 0 23 9t9 23zM1184 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 256v128q0 14 -9 23t-23 9h-128
-q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1536 896v256h-160q-40 0 -68 28t-28 68v160h-640v-512h896z" />
-    <glyph glyph-name="_403" unicode="&#xf1ad;" 
-d="M1344 1536q26 0 45 -19t19 -45v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280zM512 1248v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 992v-64q0 -14 9 -23t23 -9h64q14 0 23 9
-t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 736v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 480v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 160v64
-q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64
-q14 0 23 9t9 23zM384 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 -96v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9
-t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM896 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 928v64
-q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 160v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64
-q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9
-t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23z" />
-    <glyph glyph-name="_404" unicode="&#xf1ae;" horiz-adv-x="1280" 
-d="M1188 988l-292 -292v-824q0 -46 -33 -79t-79 -33t-79 33t-33 79v384h-64v-384q0 -46 -33 -79t-79 -33t-79 33t-33 79v824l-292 292q-28 28 -28 68t28 68q29 28 68.5 28t67.5 -28l228 -228h368l228 228q28 28 68 28t68 -28q28 -29 28 -68.5t-28 -67.5zM864 1152
-q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="uniF1B1" unicode="&#xf1b0;" horiz-adv-x="1664" 
-d="M780 1064q0 -60 -19 -113.5t-63 -92.5t-105 -39q-76 0 -138 57.5t-92 135.5t-30 151q0 60 19 113.5t63 92.5t105 39q77 0 138.5 -57.5t91.5 -135t30 -151.5zM438 581q0 -80 -42 -139t-119 -59q-76 0 -141.5 55.5t-100.5 133.5t-35 152q0 80 42 139.5t119 59.5
-q76 0 141.5 -55.5t100.5 -134t35 -152.5zM832 608q118 0 255 -97.5t229 -237t92 -254.5q0 -46 -17 -76.5t-48.5 -45t-64.5 -20t-76 -5.5q-68 0 -187.5 45t-182.5 45q-66 0 -192.5 -44.5t-200.5 -44.5q-183 0 -183 146q0 86 56 191.5t139.5 192.5t187.5 146t193 59zM1071 819
-q-61 0 -105 39t-63 92.5t-19 113.5q0 74 30 151.5t91.5 135t138.5 57.5q61 0 105 -39t63 -92.5t19 -113.5q0 -73 -30 -151t-92 -135.5t-138 -57.5zM1503 923q77 0 119 -59.5t42 -139.5q0 -74 -35 -152t-100.5 -133.5t-141.5 -55.5q-77 0 -119 59t-42 139q0 74 35 152.5
-t100.5 134t141.5 55.5z" />
-    <glyph glyph-name="_406" unicode="&#xf1b1;" horiz-adv-x="768" 
-d="M704 1008q0 -145 -57 -243.5t-152 -135.5l45 -821q2 -26 -16 -45t-44 -19h-192q-26 0 -44 19t-16 45l45 821q-95 37 -152 135.5t-57 243.5q0 128 42.5 249.5t117.5 200t160 78.5t160 -78.5t117.5 -200t42.5 -249.5z" />
-    <glyph glyph-name="_407" unicode="&#xf1b2;" horiz-adv-x="1792" 
-d="M896 -93l640 349v636l-640 -233v-752zM832 772l698 254l-698 254l-698 -254zM1664 1024v-768q0 -35 -18 -65t-49 -47l-704 -384q-28 -16 -61 -16t-61 16l-704 384q-31 17 -49 47t-18 65v768q0 40 23 73t61 47l704 256q22 8 44 8t44 -8l704 -256q38 -14 61 -47t23 -73z
-" />
-    <glyph glyph-name="_408" unicode="&#xf1b3;" horiz-adv-x="2304" 
-d="M640 -96l384 192v314l-384 -164v-342zM576 358l404 173l-404 173l-404 -173zM1664 -96l384 192v314l-384 -164v-342zM1600 358l404 173l-404 173l-404 -173zM1152 651l384 165v266l-384 -164v-267zM1088 1030l441 189l-441 189l-441 -189zM2176 512v-416q0 -36 -19 -67
-t-52 -47l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-4 2 -7 4q-2 -2 -7 -4l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-33 16 -52 47t-19 67v416q0 38 21.5 70t56.5 48l434 186v400q0 38 21.5 70t56.5 48l448 192q23 10 50 10t50 -10l448 -192q35 -16 56.5 -48t21.5 -70
-v-400l434 -186q36 -16 57 -48t21 -70z" />
-    <glyph glyph-name="_409" unicode="&#xf1b4;" horiz-adv-x="2048" 
-d="M1848 1197h-511v-124h511v124zM1596 771q-90 0 -146 -52.5t-62 -142.5h408q-18 195 -200 195zM1612 186q63 0 122 32t76 87h221q-100 -307 -427 -307q-214 0 -340.5 132t-126.5 347q0 208 130.5 345.5t336.5 137.5q138 0 240.5 -68t153 -179t50.5 -248q0 -17 -2 -47h-658
-q0 -111 57.5 -171.5t166.5 -60.5zM277 236h296q205 0 205 167q0 180 -199 180h-302v-347zM277 773h281q78 0 123.5 36.5t45.5 113.5q0 144 -190 144h-260v-294zM0 1282h594q87 0 155 -14t126.5 -47.5t90 -96.5t31.5 -154q0 -181 -172 -263q114 -32 172 -115t58 -204
-q0 -75 -24.5 -136.5t-66 -103.5t-98.5 -71t-121 -42t-134 -13h-611v1260z" />
-    <glyph glyph-name="_410" unicode="&#xf1b5;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM499 1041h-371v-787h382q117 0 197 57.5t80 170.5q0 158 -143 200q107 52 107 164q0 57 -19.5 96.5
-t-56.5 60.5t-79 29.5t-97 8.5zM477 723h-176v184h163q119 0 119 -90q0 -94 -106 -94zM486 388h-185v217h189q124 0 124 -113q0 -104 -128 -104zM1136 356q-68 0 -104 38t-36 107h411q1 10 1 30q0 132 -74.5 220.5t-203.5 88.5q-128 0 -210 -86t-82 -216q0 -135 79 -217
-t213 -82q205 0 267 191h-138q-11 -34 -47.5 -54t-75.5 -20zM1126 722q113 0 124 -122h-254q4 56 39 89t91 33zM964 988h319v-77h-319v77z" />
-    <glyph glyph-name="_411" unicode="&#xf1b6;" horiz-adv-x="1792" 
-d="M1582 954q0 -101 -71.5 -172.5t-172.5 -71.5t-172.5 71.5t-71.5 172.5t71.5 172.5t172.5 71.5t172.5 -71.5t71.5 -172.5zM812 212q0 104 -73 177t-177 73q-27 0 -54 -6l104 -42q77 -31 109.5 -106.5t1.5 -151.5q-31 -77 -107 -109t-152 -1q-21 8 -62 24.5t-61 24.5
-q32 -60 91 -96.5t130 -36.5q104 0 177 73t73 177zM1642 953q0 126 -89.5 215.5t-215.5 89.5q-127 0 -216.5 -89.5t-89.5 -215.5q0 -127 89.5 -216t216.5 -89q126 0 215.5 89t89.5 216zM1792 953q0 -189 -133.5 -322t-321.5 -133l-437 -319q-12 -129 -109 -218t-229 -89
-q-121 0 -214 76t-118 192l-230 92v429l389 -157q79 48 173 48q13 0 35 -2l284 407q2 187 135.5 319t320.5 132q188 0 321.5 -133.5t133.5 -321.5z" />
-    <glyph glyph-name="_412" unicode="&#xf1b7;" 
-d="M1242 889q0 80 -57 136.5t-137 56.5t-136.5 -57t-56.5 -136q0 -80 56.5 -136.5t136.5 -56.5t137 56.5t57 136.5zM632 301q0 -83 -58 -140.5t-140 -57.5q-56 0 -103 29t-72 77q52 -20 98 -40q60 -24 120 1.5t85 86.5q24 60 -1.5 120t-86.5 84l-82 33q22 5 42 5
-q82 0 140 -57.5t58 -140.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v153l172 -69q20 -92 93.5 -152t168.5 -60q104 0 181 70t87 173l345 252q150 0 255.5 105.5t105.5 254.5q0 150 -105.5 255.5t-255.5 105.5
-q-148 0 -253 -104.5t-107 -252.5l-225 -322q-9 1 -28 1q-75 0 -137 -37l-297 119v468q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5zM1289 887q0 -100 -71 -170.5t-171 -70.5t-170.5 70.5t-70.5 170.5t70.5 171t170.5 71q101 0 171.5 -70.5t70.5 -171.5z
-" />
-    <glyph glyph-name="_413" unicode="&#xf1b8;" horiz-adv-x="1792" 
-d="M836 367l-15 -368l-2 -22l-420 29q-36 3 -67 31.5t-47 65.5q-11 27 -14.5 55t4 65t12 55t21.5 64t19 53q78 -12 509 -28zM449 953l180 -379l-147 92q-63 -72 -111.5 -144.5t-72.5 -125t-39.5 -94.5t-18.5 -63l-4 -21l-190 357q-17 26 -18 56t6 47l8 18q35 63 114 188
-l-140 86zM1680 436l-188 -359q-12 -29 -36.5 -46.5t-43.5 -20.5l-18 -4q-71 -7 -219 -12l8 -164l-230 367l211 362l7 -173q170 -16 283 -5t170 33zM895 1360q-47 -63 -265 -435l-317 187l-19 12l225 356q20 31 60 45t80 10q24 -2 48.5 -12t42 -21t41.5 -33t36 -34.5
-t36 -39.5t32 -35zM1550 1053l212 -363q18 -37 12.5 -76t-27.5 -74q-13 -20 -33 -37t-38 -28t-48.5 -22t-47 -16t-51.5 -14t-46 -12q-34 72 -265 436l313 195zM1407 1279l142 83l-220 -373l-419 20l151 86q-34 89 -75 166t-75.5 123.5t-64.5 80t-47 46.5l-17 13l405 -1
-q31 3 58 -10.5t39 -28.5l11 -15q39 -61 112 -190z" />
-    <glyph glyph-name="_414" unicode="&#xf1b9;" horiz-adv-x="2048" 
-d="M480 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM516 768h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5zM1888 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM2048 544v-384
-q0 -14 -9 -23t-23 -9h-96v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-1024v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5t179 63.5h768q98 0 179 -63.5t104 -157.5
-l105 -419h28q93 0 158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="_415" unicode="&#xf1ba;" horiz-adv-x="2048" 
-d="M1824 640q93 0 158.5 -65.5t65.5 -158.5v-384q0 -14 -9 -23t-23 -9h-96v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-1024v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5
-t179 63.5h128v224q0 14 9 23t23 9h448q14 0 23 -9t9 -23v-224h128q98 0 179 -63.5t104 -157.5l105 -419h28zM320 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM516 640h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5z
-M1728 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47z" />
-    <glyph glyph-name="_416" unicode="&#xf1bb;" 
-d="M1504 64q0 -26 -19 -45t-45 -19h-462q1 -17 6 -87.5t5 -108.5q0 -25 -18 -42.5t-43 -17.5h-320q-25 0 -43 17.5t-18 42.5q0 38 5 108.5t6 87.5h-462q-26 0 -45 19t-19 45t19 45l402 403h-229q-26 0 -45 19t-19 45t19 45l402 403h-197q-26 0 -45 19t-19 45t19 45l384 384
-q19 19 45 19t45 -19l384 -384q19 -19 19 -45t-19 -45t-45 -19h-197l402 -403q19 -19 19 -45t-19 -45t-45 -19h-229l402 -403q19 -19 19 -45z" />
-    <glyph glyph-name="_417" unicode="&#xf1bc;" 
-d="M1127 326q0 32 -30 51q-193 115 -447 115q-133 0 -287 -34q-42 -9 -42 -52q0 -20 13.5 -34.5t35.5 -14.5q5 0 37 8q132 27 243 27q226 0 397 -103q19 -11 33 -11q19 0 33 13.5t14 34.5zM1223 541q0 40 -35 61q-237 141 -548 141q-153 0 -303 -42q-48 -13 -48 -64
-q0 -25 17.5 -42.5t42.5 -17.5q7 0 37 8q122 33 251 33q279 0 488 -124q24 -13 38 -13q25 0 42.5 17.5t17.5 42.5zM1331 789q0 47 -40 70q-126 73 -293 110.5t-343 37.5q-204 0 -364 -47q-23 -7 -38.5 -25.5t-15.5 -48.5q0 -31 20.5 -52t51.5 -21q11 0 40 8q133 37 307 37
-q159 0 309.5 -34t253.5 -95q21 -12 40 -12q29 0 50.5 20.5t21.5 51.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_418" unicode="&#xf1bd;" horiz-adv-x="1024" 
-d="M1024 1233l-303 -582l24 -31h279v-415h-507l-44 -30l-142 -273l-30 -30h-301v303l303 583l-24 30h-279v415h507l44 30l142 273l30 30h301v-303z" />
-    <glyph glyph-name="_419" unicode="&#xf1be;" horiz-adv-x="2304" 
-d="M784 164l16 241l-16 523q-1 10 -7.5 17t-16.5 7q-9 0 -16 -7t-7 -17l-14 -523l14 -241q1 -10 7.5 -16.5t15.5 -6.5q22 0 24 23zM1080 193l11 211l-12 586q0 16 -13 24q-8 5 -16 5t-16 -5q-13 -8 -13 -24l-1 -6l-10 -579q0 -1 11 -236v-1q0 -10 6 -17q9 -11 23 -11
-q11 0 20 9q9 7 9 20zM35 533l20 -128l-20 -126q-2 -9 -9 -9t-9 9l-17 126l17 128q2 9 9 9t9 -9zM121 612l26 -207l-26 -203q-2 -9 -10 -9q-9 0 -9 10l-23 202l23 207q0 9 9 9q8 0 10 -9zM401 159zM213 650l25 -245l-25 -237q0 -11 -11 -11q-10 0 -12 11l-21 237l21 245
-q2 12 12 12q11 0 11 -12zM307 657l23 -252l-23 -244q-2 -13 -14 -13q-13 0 -13 13l-21 244l21 252q0 13 13 13q12 0 14 -13zM401 639l21 -234l-21 -246q-2 -16 -16 -16q-6 0 -10.5 4.5t-4.5 11.5l-20 246l20 234q0 6 4.5 10.5t10.5 4.5q14 0 16 -15zM784 164zM495 785
-l21 -380l-21 -246q0 -7 -5 -12.5t-12 -5.5q-16 0 -18 18l-18 246l18 380q2 18 18 18q7 0 12 -5.5t5 -12.5zM589 871l19 -468l-19 -244q0 -8 -5.5 -13.5t-13.5 -5.5q-18 0 -20 19l-16 244l16 468q2 19 20 19q8 0 13.5 -5.5t5.5 -13.5zM687 911l18 -506l-18 -242
-q-2 -21 -22 -21q-19 0 -21 21l-16 242l16 506q0 9 6.5 15.5t14.5 6.5q9 0 15 -6.5t7 -15.5zM1079 169v0v0v0zM881 915l15 -510l-15 -239q0 -10 -7.5 -17.5t-17.5 -7.5t-17 7t-8 18l-14 239l14 510q0 11 7.5 18t17.5 7t17.5 -7t7.5 -18zM980 896l14 -492l-14 -236
-q0 -11 -8 -19t-19 -8t-19 8t-9 19l-12 236l12 492q1 12 9 20t19 8t18.5 -8t8.5 -20zM1192 404l-14 -231v0q0 -13 -9 -22t-22 -9t-22 9t-10 22l-6 114l-6 117l12 636v3q2 15 12 24q9 7 20 7q8 0 15 -5q14 -8 16 -26zM2304 423q0 -117 -83 -199.5t-200 -82.5h-786
-q-13 2 -22 11t-9 22v899q0 23 28 33q85 34 181 34q195 0 338 -131.5t160 -323.5q53 22 110 22q117 0 200 -83t83 -201z" />
-    <glyph glyph-name="uniF1C0" unicode="&#xf1c0;" 
-d="M768 768q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 0q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127
-t443 -43zM768 384q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 1536q208 0 385 -34.5t280 -93.5t103 -128v-128q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5
-t-103 128v128q0 69 103 128t280 93.5t385 34.5z" />
-    <glyph glyph-name="uniF1C1" unicode="&#xf1c1;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M894 465q33 -26 84 -56q59 7 117 7q147 0 177 -49q16 -22 2 -52q0 -1 -1 -2l-2 -2v-1q-6 -38 -71 -38q-48 0 -115 20t-130 53q-221 -24 -392 -83q-153 -262 -242 -262q-15 0 -28 7l-24 12q-1 1 -6 5q-10 10 -6 36q9 40 56 91.5t132 96.5q14 9 23 -6q2 -2 2 -4q52 85 107 197
-q68 136 104 262q-24 82 -30.5 159.5t6.5 127.5q11 40 42 40h21h1q23 0 35 -15q18 -21 9 -68q-2 -6 -4 -8q1 -3 1 -8v-30q-2 -123 -14 -192q55 -164 146 -238zM318 54q52 24 137 158q-51 -40 -87.5 -84t-49.5 -74zM716 974q-15 -42 -2 -132q1 7 7 44q0 3 7 43q1 4 4 8
-q-1 1 -1 2q-1 2 -1 3q-1 22 -13 36q0 -1 -1 -2v-2zM592 313q135 54 284 81q-2 1 -13 9.5t-16 13.5q-76 67 -127 176q-27 -86 -83 -197q-30 -56 -45 -83zM1238 329q-24 24 -140 24q76 -28 124 -28q14 0 18 1q0 1 -2 3z" />
-    <glyph glyph-name="_422" unicode="&#xf1c2;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M233 768v-107h70l164 -661h159l128 485q7 20 10 46q2 16 2 24h4l3 -24q1 -3 3.5 -20t5.5 -26l128 -485h159l164 661h70v107h-300v-107h90l-99 -438q-5 -20 -7 -46l-2 -21h-4q0 3 -0.5 6.5t-1.5 8t-1 6.5q-1 5 -4 21t-5 25l-144 545h-114l-144 -545q-2 -9 -4.5 -24.5
-t-3.5 -21.5l-4 -21h-4l-2 21q-2 26 -7 46l-99 438h90v107h-300z" />
-    <glyph glyph-name="_423" unicode="&#xf1c3;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M429 106v-106h281v106h-75l103 161q5 7 10 16.5t7.5 13.5t3.5 4h2q1 -4 5 -10q2 -4 4.5 -7.5t6 -8t6.5 -8.5l107 -161h-76v-106h291v106h-68l-192 273l195 282h67v107h-279v-107h74l-103 -159q-4 -7 -10 -16.5t-9 -13.5l-2 -3h-2q-1 4 -5 10q-6 11 -17 23l-106 159h76v107
-h-290v-107h68l189 -272l-194 -283h-68z" />
-    <glyph glyph-name="_424" unicode="&#xf1c4;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M416 106v-106h327v106h-93v167h137q76 0 118 15q67 23 106.5 87t39.5 146q0 81 -37 141t-100 87q-48 19 -130 19h-368v-107h92v-555h-92zM769 386h-119v268h120q52 0 83 -18q56 -33 56 -115q0 -89 -62 -120q-31 -15 -78 -15z" />
-    <glyph glyph-name="_425" unicode="&#xf1c5;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M1280 320v-320h-1024v192l192 192l128 -128l384 384zM448 512q-80 0 -136 56t-56 136t56 136t136 56t136 -56t56 -136t-56 -136t-136 -56z" />
-    <glyph glyph-name="_426" unicode="&#xf1c6;" 
-d="M640 1152v128h-128v-128h128zM768 1024v128h-128v-128h128zM640 896v128h-128v-128h128zM768 768v128h-128v-128h128zM1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400
-v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-128v-128h-128v128h-512v-1536h1280zM781 593l107 -349q8 -27 8 -52q0 -83 -72.5 -137.5t-183.5 -54.5t-183.5 54.5t-72.5 137.5q0 25 8 52q21 63 120 396v128h128v-128h79
-q22 0 39 -13t23 -34zM640 128q53 0 90.5 19t37.5 45t-37.5 45t-90.5 19t-90.5 -19t-37.5 -45t37.5 -45t90.5 -19z" />
-    <glyph glyph-name="_427" unicode="&#xf1c7;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M620 686q20 -8 20 -30v-544q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-166 167h-131q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h131l166 167q16 15 35 7zM1037 -3q31 0 50 24q129 159 129 363t-129 363q-16 21 -43 24t-47 -14q-21 -17 -23.5 -43.5t14.5 -47.5
-q100 -123 100 -282t-100 -282q-17 -21 -14.5 -47.5t23.5 -42.5q18 -15 40 -15zM826 145q27 0 47 20q87 93 87 219t-87 219q-18 19 -45 20t-46 -17t-20 -44.5t18 -46.5q52 -57 52 -131t-52 -131q-19 -20 -18 -46.5t20 -44.5q20 -17 44 -17z" />
-    <glyph glyph-name="_428" unicode="&#xf1c8;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M768 768q52 0 90 -38t38 -90v-384q0 -52 -38 -90t-90 -38h-384q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h384zM1260 766q20 -8 20 -30v-576q0 -22 -20 -30q-8 -2 -12 -2q-14 0 -23 9l-265 266v90l265 266q9 9 23 9q4 0 12 -2z" />
-    <glyph glyph-name="_429" unicode="&#xf1c9;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M480 768q8 11 21 12.5t24 -6.5l51 -38q11 -8 12.5 -21t-6.5 -24l-182 -243l182 -243q8 -11 6.5 -24t-12.5 -21l-51 -38q-11 -8 -24 -6.5t-21 12.5l-226 301q-14 19 0 38zM1282 467q14 -19 0 -38l-226 -301q-8 -11 -21 -12.5t-24 6.5l-51 38q-11 8 -12.5 21t6.5 24l182 243
-l-182 243q-8 11 -6.5 24t12.5 21l51 38q11 8 24 6.5t21 -12.5zM662 6q-13 2 -20.5 13t-5.5 24l138 831q2 13 13 20.5t24 5.5l63 -10q13 -2 20.5 -13t5.5 -24l-138 -831q-2 -13 -13 -20.5t-24 -5.5z" />
-    <glyph glyph-name="_430" unicode="&#xf1ca;" 
-d="M1497 709v-198q-101 -23 -198 -23q-65 -136 -165.5 -271t-181.5 -215.5t-128 -106.5q-80 -45 -162 3q-28 17 -60.5 43.5t-85 83.5t-102.5 128.5t-107.5 184t-105.5 244t-91.5 314.5t-70.5 390h283q26 -218 70 -398.5t104.5 -317t121.5 -235.5t140 -195q169 169 287 406
-q-142 72 -223 220t-81 333q0 192 104 314.5t284 122.5q178 0 273 -105.5t95 -297.5q0 -159 -58 -286q-7 -1 -19.5 -3t-46 -2t-63 6t-62 25.5t-50.5 51.5q31 103 31 184q0 87 -29 132t-79 45q-53 0 -85 -49.5t-32 -140.5q0 -186 105 -293.5t267 -107.5q62 0 121 14z" />
-    <glyph glyph-name="_431" unicode="&#xf1cb;" horiz-adv-x="1792" 
-d="M216 367l603 -402v359l-334 223zM154 511l193 129l-193 129v-258zM973 -35l603 402l-269 180l-334 -223v-359zM896 458l272 182l-272 182l-272 -182zM485 733l334 223v359l-603 -402zM1445 640l193 -129v258zM1307 733l269 180l-603 402v-359zM1792 913v-546
-q0 -41 -34 -64l-819 -546q-21 -13 -43 -13t-43 13l-819 546q-34 23 -34 64v546q0 41 34 64l819 546q21 13 43 13t43 -13l819 -546q34 -23 34 -64z" />
-    <glyph glyph-name="_432" unicode="&#xf1cc;" horiz-adv-x="2048" 
-d="M1800 764q111 -46 179.5 -145.5t68.5 -221.5q0 -164 -118 -280.5t-285 -116.5q-4 0 -11.5 0.5t-10.5 0.5h-1209h-1h-2h-5q-170 10 -288 125.5t-118 280.5q0 110 55 203t147 147q-12 39 -12 82q0 115 82 196t199 81q95 0 172 -58q75 154 222.5 248t326.5 94
-q166 0 306 -80.5t221.5 -218.5t81.5 -301q0 -6 -0.5 -18t-0.5 -18zM468 498q0 -122 84 -193t208 -71q137 0 240 99q-16 20 -47.5 56.5t-43.5 50.5q-67 -65 -144 -65q-55 0 -93.5 33.5t-38.5 87.5q0 53 38.5 87t91.5 34q44 0 84.5 -21t73 -55t65 -75t69 -82t77 -75t97 -55
-t121.5 -21q121 0 204.5 71.5t83.5 190.5q0 121 -84 192t-207 71q-143 0 -241 -97l93 -108q66 64 142 64q52 0 92 -33t40 -84q0 -57 -37 -91.5t-94 -34.5q-43 0 -82.5 21t-72 55t-65.5 75t-69.5 82t-77.5 75t-96.5 55t-118.5 21q-122 0 -207 -70.5t-85 -189.5z" />
-    <glyph glyph-name="_433" unicode="&#xf1cd;" horiz-adv-x="1792" 
-d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 1408q-190 0 -361 -90l194 -194q82 28 167 28t167 -28l194 194q-171 90 -361 90zM218 279l194 194
-q-28 82 -28 167t28 167l-194 194q-90 -171 -90 -361t90 -361zM896 -128q190 0 361 90l-194 194q-82 -28 -167 -28t-167 28l-194 -194q171 -90 361 -90zM896 256q159 0 271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5
-t271.5 -112.5zM1380 473l194 -194q90 171 90 361t-90 361l-194 -194q28 -82 28 -167t-28 -167z" />
-    <glyph glyph-name="_434" unicode="&#xf1ce;" horiz-adv-x="1792" 
-d="M1760 640q0 -176 -68.5 -336t-184 -275.5t-275.5 -184t-336 -68.5t-336 68.5t-275.5 184t-184 275.5t-68.5 336q0 213 97 398.5t265 305.5t374 151v-228q-221 -45 -366.5 -221t-145.5 -406q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5
-t136.5 204t51 248.5q0 230 -145.5 406t-366.5 221v228q206 -31 374 -151t265 -305.5t97 -398.5z" />
-    <glyph glyph-name="uniF1D0" unicode="&#xf1d0;" horiz-adv-x="1792" 
-d="M19 662q8 217 116 406t305 318h5q0 -1 -1 -3q-8 -8 -28 -33.5t-52 -76.5t-60 -110.5t-44.5 -135.5t-14 -150.5t39 -157.5t108.5 -154q50 -50 102 -69.5t90.5 -11.5t69.5 23.5t47 32.5l16 16q39 51 53 116.5t6.5 122.5t-21 107t-26.5 80l-14 29q-10 25 -30.5 49.5t-43 41
-t-43.5 29.5t-35 19l-13 6l104 115q39 -17 78 -52t59 -61l19 -27q1 48 -18.5 103.5t-40.5 87.5l-20 31l161 183l160 -181q-33 -46 -52.5 -102.5t-22.5 -90.5l-4 -33q22 37 61.5 72.5t67.5 52.5l28 17l103 -115q-44 -14 -85 -50t-60 -65l-19 -29q-31 -56 -48 -133.5t-7 -170
-t57 -156.5q33 -45 77.5 -60.5t85 -5.5t76 26.5t57.5 33.5l21 16q60 53 96.5 115t48.5 121.5t10 121.5t-18 118t-37 107.5t-45.5 93t-45 72t-34.5 47.5l-13 17q-14 13 -7 13l10 -3q40 -29 62.5 -46t62 -50t64 -58t58.5 -65t55.5 -77t45.5 -88t38 -103t23.5 -117t10.5 -136
-q3 -259 -108 -465t-312 -321t-456 -115q-185 0 -351 74t-283.5 198t-184 293t-60.5 353z" />
-    <glyph glyph-name="uniF1D1" unicode="&#xf1d1;" horiz-adv-x="1792" 
-d="M874 -102v-66q-208 6 -385 109.5t-283 275.5l58 34q29 -49 73 -99l65 57q148 -168 368 -212l-17 -86q65 -12 121 -13zM276 428l-83 -28q22 -60 49 -112l-57 -33q-98 180 -98 385t98 385l57 -33q-30 -56 -49 -112l82 -28q-35 -100 -35 -212q0 -109 36 -212zM1528 251
-l58 -34q-106 -172 -283 -275.5t-385 -109.5v66q56 1 121 13l-17 86q220 44 368 212l65 -57q44 50 73 99zM1377 805l-233 -80q14 -42 14 -85t-14 -85l232 -80q-31 -92 -98 -169l-185 162q-57 -67 -147 -85l48 -241q-52 -10 -98 -10t-98 10l48 241q-90 18 -147 85l-185 -162
-q-67 77 -98 169l232 80q-14 42 -14 85t14 85l-233 80q33 93 99 169l185 -162q59 68 147 86l-48 240q44 10 98 10t98 -10l-48 -240q88 -18 147 -86l185 162q66 -76 99 -169zM874 1448v-66q-65 -2 -121 -13l17 -86q-220 -42 -368 -211l-65 56q-38 -42 -73 -98l-57 33
-q106 172 282 275.5t385 109.5zM1705 640q0 -205 -98 -385l-57 33q27 52 49 112l-83 28q36 103 36 212q0 112 -35 212l82 28q-19 56 -49 112l57 33q98 -180 98 -385zM1585 1063l-57 -33q-35 56 -73 98l-65 -56q-148 169 -368 211l17 86q-56 11 -121 13v66q209 -6 385 -109.5
-t282 -275.5zM1748 640q0 173 -67.5 331t-181.5 272t-272 181.5t-331 67.5t-331 -67.5t-272 -181.5t-181.5 -272t-67.5 -331t67.5 -331t181.5 -272t272 -181.5t331 -67.5t331 67.5t272 181.5t181.5 272t67.5 331zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71
-t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF1D2" unicode="&#xf1d2;" 
-d="M582 228q0 -66 -93 -66q-107 0 -107 63q0 64 98 64q102 0 102 -61zM546 694q0 -85 -74 -85q-77 0 -77 84q0 90 77 90q36 0 55 -25.5t19 -63.5zM712 769v125q-78 -29 -135 -29q-50 29 -110 29q-86 0 -145 -57t-59 -143q0 -50 29.5 -102t73.5 -67v-3q-38 -17 -38 -85
-q0 -53 41 -77v-3q-113 -37 -113 -139q0 -45 20 -78.5t54 -51t72 -25.5t81 -8q224 0 224 188q0 67 -48 99t-126 46q-27 5 -51.5 20.5t-24.5 39.5q0 44 49 52q77 15 122 70t45 134q0 24 -10 52q37 9 49 13zM771 350h137q-2 27 -2 82v387q0 46 2 69h-137q3 -23 3 -71v-392
-q0 -50 -3 -75zM1280 366v121q-30 -21 -68 -21q-53 0 -53 82v225h52q9 0 26.5 -1t26.5 -1v117h-105q0 82 3 102h-140q4 -24 4 -55v-47h-60v-117q36 3 37 3q3 0 11 -0.5t12 -0.5v-2h-2v-217q0 -37 2.5 -64t11.5 -56.5t24.5 -48.5t43.5 -31t66 -12q64 0 108 24zM924 1072
-q0 36 -24 63.5t-60 27.5t-60.5 -27t-24.5 -64q0 -36 25 -62.5t60 -26.5t59.5 27t24.5 62zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_438" unicode="&#xf1d3;" horiz-adv-x="1792" 
-d="M595 22q0 100 -165 100q-158 0 -158 -104q0 -101 172 -101q151 0 151 105zM536 777q0 61 -30 102t-89 41q-124 0 -124 -145q0 -135 124 -135q119 0 119 137zM805 1101v-202q-36 -12 -79 -22q16 -43 16 -84q0 -127 -73 -216.5t-197 -112.5q-40 -8 -59.5 -27t-19.5 -58
-q0 -31 22.5 -51.5t58 -32t78.5 -22t86 -25.5t78.5 -37.5t58 -64t22.5 -98.5q0 -304 -363 -304q-69 0 -130 12.5t-116 41t-87.5 82t-32.5 127.5q0 165 182 225v4q-67 41 -67 126q0 109 63 137v4q-72 24 -119.5 108.5t-47.5 165.5q0 139 95 231.5t235 92.5q96 0 178 -47
-q98 0 218 47zM1123 220h-222q4 45 4 134v609q0 94 -4 128h222q-4 -33 -4 -124v-613q0 -89 4 -134zM1724 442v-196q-71 -39 -174 -39q-62 0 -107 20t-70 50t-39.5 78t-18.5 92t-4 103v351h2v4q-7 0 -19 1t-18 1q-21 0 -59 -6v190h96v76q0 54 -6 89h227q-6 -41 -6 -165h171
-v-190q-15 0 -43.5 2t-42.5 2h-85v-365q0 -131 87 -131q61 0 109 33zM1148 1389q0 -58 -39 -101.5t-96 -43.5q-58 0 -98 43.5t-40 101.5q0 59 39.5 103t98.5 44q58 0 96.5 -44.5t38.5 -102.5z" />
-    <glyph glyph-name="_439" unicode="&#xf1d4;" 
-d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="uniF1D5" unicode="&#xf1d5;" horiz-adv-x="1280" 
-d="M842 964q0 -80 -57 -136.5t-136 -56.5q-60 0 -111 35q-62 -67 -115 -146q-247 -371 -202 -859q1 -22 -12.5 -38.5t-34.5 -18.5h-5q-20 0 -35 13.5t-17 33.5q-14 126 -3.5 247.5t29.5 217t54 186t69 155.5t74 125q61 90 132 165q-16 35 -16 77q0 80 56.5 136.5t136.5 56.5
-t136.5 -56.5t56.5 -136.5zM1223 953q0 -158 -78 -292t-212.5 -212t-292.5 -78q-64 0 -131 14q-21 5 -32.5 23.5t-6.5 39.5q5 20 23 31.5t39 7.5q51 -13 108 -13q97 0 186 38t153 102t102 153t38 186t-38 186t-102 153t-153 102t-186 38t-186 -38t-153 -102t-102 -153
-t-38 -186q0 -114 52 -218q10 -20 3.5 -40t-25.5 -30t-39.5 -3t-30.5 26q-64 123 -64 265q0 119 46.5 227t124.5 186t186 124t226 46q158 0 292.5 -78t212.5 -212.5t78 -292.5z" />
-    <glyph glyph-name="uniF1D6" unicode="&#xf1d6;" horiz-adv-x="1792" 
-d="M270 730q-8 19 -8 52q0 20 11 49t24 45q-1 22 7.5 53t22.5 43q0 139 92.5 288.5t217.5 209.5q139 66 324 66q133 0 266 -55q49 -21 90 -48t71 -56t55 -68t42 -74t32.5 -84.5t25.5 -89.5t22 -98l1 -5q55 -83 55 -150q0 -14 -9 -40t-9 -38q0 -1 1.5 -3.5t3.5 -5t2 -3.5
-q77 -114 120.5 -214.5t43.5 -208.5q0 -43 -19.5 -100t-55.5 -57q-9 0 -19.5 7.5t-19 17.5t-19 26t-16 26.5t-13.5 26t-9 17.5q-1 1 -3 1l-5 -4q-59 -154 -132 -223q20 -20 61.5 -38.5t69 -41.5t35.5 -65q-2 -4 -4 -16t-7 -18q-64 -97 -302 -97q-53 0 -110.5 9t-98 20
-t-104.5 30q-15 5 -23 7q-14 4 -46 4.5t-40 1.5q-41 -45 -127.5 -65t-168.5 -20q-35 0 -69 1.5t-93 9t-101 20.5t-74.5 40t-32.5 64q0 40 10 59.5t41 48.5q11 2 40.5 13t49.5 12q4 0 14 2q2 2 2 4l-2 3q-48 11 -108 105.5t-73 156.5l-5 3q-4 0 -12 -20q-18 -41 -54.5 -74.5
-t-77.5 -37.5h-1q-4 0 -6 4.5t-5 5.5q-23 54 -23 100q0 275 252 466z" />
-    <glyph glyph-name="uniF1D7" unicode="&#xf1d7;" horiz-adv-x="2048" 
-d="M580 1075q0 41 -25 66t-66 25q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 66 24.5t25 65.5zM1323 568q0 28 -25.5 50t-65.5 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q40 0 65.5 22t25.5 51zM1087 1075q0 41 -24.5 66t-65.5 25
-q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 65.5 24.5t24.5 65.5zM1722 568q0 28 -26 50t-65 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q39 0 65 22t26 51zM1456 965q-31 4 -70 4q-169 0 -311 -77t-223.5 -208.5t-81.5 -287.5
-q0 -78 23 -152q-35 -3 -68 -3q-26 0 -50 1.5t-55 6.5t-44.5 7t-54.5 10.5t-50 10.5l-253 -127l72 218q-290 203 -290 490q0 169 97.5 311t264 223.5t363.5 81.5q176 0 332.5 -66t262 -182.5t136.5 -260.5zM2048 404q0 -117 -68.5 -223.5t-185.5 -193.5l55 -181l-199 109
-q-150 -37 -218 -37q-169 0 -311 70.5t-223.5 191.5t-81.5 264t81.5 264t223.5 191.5t311 70.5q161 0 303 -70.5t227.5 -192t85.5 -263.5z" />
-    <glyph glyph-name="_443" unicode="&#xf1d8;" horiz-adv-x="1792" 
-d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-453 185l-242 -295q-18 -23 -49 -23q-13 0 -22 4q-19 7 -30.5 23.5t-11.5 36.5v349l864 1059l-1069 -925l-395 162q-37 14 -40 55q-2 40 32 59l1664 960q15 9 32 9q20 0 36 -11z" />
-    <glyph glyph-name="_444" unicode="&#xf1d9;" horiz-adv-x="1792" 
-d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-527 215l-298 -327q-18 -21 -47 -21q-14 0 -23 4q-19 7 -30 23.5t-11 36.5v452l-472 193q-37 14 -40 55q-3 39 32 59l1664 960q35 21 68 -2zM1422 26l221 1323l-1434 -827l336 -137
-l863 639l-478 -797z" />
-    <glyph glyph-name="_445" unicode="&#xf1da;" 
-d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5
-t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298zM896 928v-448q0 -14 -9 -23
-t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_446" unicode="&#xf1db;" 
-d="M768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_447" unicode="&#xf1dc;" horiz-adv-x="1792" 
-d="M1682 -128q-44 0 -132.5 3.5t-133.5 3.5q-44 0 -132 -3.5t-132 -3.5q-24 0 -37 20.5t-13 45.5q0 31 17 46t39 17t51 7t45 15q33 21 33 140l-1 391q0 21 -1 31q-13 4 -50 4h-675q-38 0 -51 -4q-1 -10 -1 -31l-1 -371q0 -142 37 -164q16 -10 48 -13t57 -3.5t45 -15
-t20 -45.5q0 -26 -12.5 -48t-36.5 -22q-47 0 -139.5 3.5t-138.5 3.5q-43 0 -128 -3.5t-127 -3.5q-23 0 -35.5 21t-12.5 45q0 30 15.5 45t36 17.5t47.5 7.5t42 15q33 23 33 143l-1 57v813q0 3 0.5 26t0 36.5t-1.5 38.5t-3.5 42t-6.5 36.5t-11 31.5t-16 18q-15 10 -45 12t-53 2
-t-41 14t-18 45q0 26 12 48t36 22q46 0 138.5 -3.5t138.5 -3.5q42 0 126.5 3.5t126.5 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17 -43.5t-38.5 -14.5t-49.5 -4t-43 -13q-35 -21 -35 -160l1 -320q0 -21 1 -32q13 -3 39 -3h699q25 0 38 3q1 11 1 32l1 320q0 139 -35 160
-q-18 11 -58.5 12.5t-66 13t-25.5 49.5q0 26 12.5 48t37.5 22q44 0 132 -3.5t132 -3.5q43 0 129 3.5t129 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17.5 -44t-40 -14.5t-51.5 -3t-44 -12.5q-35 -23 -35 -161l1 -943q0 -119 34 -140q16 -10 46 -13.5t53.5 -4.5t41.5 -15.5t18 -44.5
-q0 -26 -12 -48t-36 -22z" />
-    <glyph glyph-name="_448" unicode="&#xf1dd;" horiz-adv-x="1280" 
-d="M1278 1347v-73q0 -29 -18.5 -61t-42.5 -32q-50 0 -54 -1q-26 -6 -32 -31q-3 -11 -3 -64v-1152q0 -25 -18 -43t-43 -18h-108q-25 0 -43 18t-18 43v1218h-143v-1218q0 -25 -17.5 -43t-43.5 -18h-108q-26 0 -43.5 18t-17.5 43v496q-147 12 -245 59q-126 58 -192 179
-q-64 117 -64 259q0 166 88 286q88 118 209 159q111 37 417 37h479q25 0 43 -18t18 -43z" />
-    <glyph glyph-name="_449" unicode="&#xf1de;" 
-d="M352 128v-128h-352v128h352zM704 256q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM864 640v-128h-864v128h864zM224 1152v-128h-224v128h224zM1536 128v-128h-736v128h736zM576 1280q26 0 45 -19t19 -45v-256
-q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1216 768q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1536 640v-128h-224v128h224zM1536 1152v-128h-864v128h864z" />
-    <glyph glyph-name="uniF1E0" unicode="&#xf1e0;" 
-d="M1216 512q133 0 226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5t-226.5 93.5t-93.5 226.5q0 12 2 34l-360 180q-92 -86 -218 -86q-133 0 -226.5 93.5t-93.5 226.5t93.5 226.5t226.5 93.5q126 0 218 -86l360 180q-2 22 -2 34q0 133 93.5 226.5t226.5 93.5
-t226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5q-126 0 -218 86l-360 -180q2 -22 2 -34t-2 -34l360 -180q92 86 218 86z" />
-    <glyph glyph-name="_451" unicode="&#xf1e1;" 
-d="M1280 341q0 88 -62.5 151t-150.5 63q-84 0 -145 -58l-241 120q2 16 2 23t-2 23l241 120q61 -58 145 -58q88 0 150.5 63t62.5 151t-62.5 150.5t-150.5 62.5t-151 -62.5t-63 -150.5q0 -7 2 -23l-241 -120q-62 57 -145 57q-88 0 -150.5 -62.5t-62.5 -150.5t62.5 -150.5
-t150.5 -62.5q83 0 145 57l241 -120q-2 -16 -2 -23q0 -88 63 -150.5t151 -62.5t150.5 62.5t62.5 150.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_452" unicode="&#xf1e2;" horiz-adv-x="1792" 
-d="M571 947q-10 25 -34 35t-49 0q-108 -44 -191 -127t-127 -191q-10 -25 0 -49t35 -34q13 -5 24 -5q42 0 60 40q34 84 98.5 148.5t148.5 98.5q25 11 35 35t0 49zM1513 1303l46 -46l-244 -243l68 -68q19 -19 19 -45.5t-19 -45.5l-64 -64q89 -161 89 -343q0 -143 -55.5 -273.5
-t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5q182 0 343 -89l64 64q19 19 45.5 19t45.5 -19l68 -68zM1521 1359q-10 -10 -22 -10q-13 0 -23 10l-91 90q-9 10 -9 23t9 23q10 9 23 9t23 -9l90 -91
-q10 -9 10 -22.5t-10 -22.5zM1751 1129q-11 -9 -23 -9t-23 9l-90 91q-10 9 -10 22.5t10 22.5q9 10 22.5 10t22.5 -10l91 -90q9 -10 9 -23t-9 -23zM1792 1312q0 -14 -9 -23t-23 -9h-96q-14 0 -23 9t-9 23t9 23t23 9h96q14 0 23 -9t9 -23zM1600 1504v-96q0 -14 -9 -23t-23 -9
-t-23 9t-9 23v96q0 14 9 23t23 9t23 -9t9 -23zM1751 1449l-91 -90q-10 -10 -22 -10q-13 0 -23 10q-10 9 -10 22.5t10 22.5l90 91q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
-    <glyph glyph-name="_453" unicode="&#xf1e3;" horiz-adv-x="1792" 
-d="M609 720l287 208l287 -208l-109 -336h-355zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM1515 186q149 203 149 454v3l-102 -89l-240 224l63 323
-l134 -12q-150 206 -389 282l53 -124l-287 -159l-287 159l53 124q-239 -76 -389 -282l135 12l62 -323l-240 -224l-102 89v-3q0 -251 149 -454l30 132l326 -40l139 -298l-116 -69q117 -39 240 -39t240 39l-116 69l139 298l326 40z" />
-    <glyph glyph-name="_454" unicode="&#xf1e4;" horiz-adv-x="1792" 
-d="M448 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM256 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM832 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23
-v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM66 768q-28 0 -47 19t-19 46v129h514v-129q0 -27 -19 -46t-46 -19h-383zM1216 224v-192q0 -14 -9 -23t-23 -9h-192
-q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1600 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23
-zM1408 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1016v-13h-514v10q0 104 -382 102q-382 -1 -382 -102v-10h-514v13q0 17 8.5 43t34 64t65.5 75.5t110.5 76t160 67.5t224 47.5t293.5 18.5t293 -18.5t224 -47.5
-t160.5 -67.5t110.5 -76t65.5 -75.5t34 -64t8.5 -43zM1792 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 962v-129q0 -27 -19 -46t-46 -19h-384q-27 0 -46 19t-19 46v129h514z" />
-    <glyph glyph-name="_455" unicode="&#xf1e5;" horiz-adv-x="1792" 
-d="M704 1216v-768q0 -26 -19 -45t-45 -19v-576q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v512l249 873q7 23 31 23h424zM1024 1216v-704h-256v704h256zM1792 320v-512q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v576q-26 0 -45 19t-19 45v768h424q24 0 31 -23z
-M736 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23zM1408 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_456" unicode="&#xf1e6;" horiz-adv-x="1792" 
-d="M1755 1083q37 -38 37 -90.5t-37 -90.5l-401 -400l150 -150l-160 -160q-163 -163 -389.5 -186.5t-411.5 100.5l-362 -362h-181v181l362 362q-124 185 -100.5 411.5t186.5 389.5l160 160l150 -150l400 401q38 37 91 37t90 -37t37 -90.5t-37 -90.5l-400 -401l234 -234
-l401 400q38 37 91 37t90 -37z" />
-    <glyph glyph-name="_457" unicode="&#xf1e7;" horiz-adv-x="1792" 
-d="M873 796q0 -83 -63.5 -142.5t-152.5 -59.5t-152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59t152.5 -59t63.5 -143zM1375 796q0 -83 -63 -142.5t-153 -59.5q-89 0 -152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59q90 0 153 -59t63 -143zM1600 616v667q0 87 -32 123.5
-t-111 36.5h-1112q-83 0 -112.5 -34t-29.5 -126v-673q43 -23 88.5 -40t81 -28t81 -18.5t71 -11t70 -4t58.5 -0.5t56.5 2t44.5 2q68 1 95 -27q6 -6 10 -9q26 -25 61 -51q7 91 118 87q5 0 36.5 -1.5t43 -2t45.5 -1t53 1t54.5 4.5t61 8.5t62 13.5t67 19.5t67.5 27t72 34.5z
-M1763 621q-121 -149 -372 -252q84 -285 -23 -465q-66 -113 -183 -148q-104 -32 -182 15q-86 51 -82 164l-1 326v1q-8 2 -24.5 6t-23.5 5l-1 -338q4 -114 -83 -164q-79 -47 -183 -15q-117 36 -182 150q-105 180 -22 463q-251 103 -372 252q-25 37 -4 63t60 -1q4 -2 11.5 -7
-t10.5 -8v694q0 72 47 123t114 51h1257q67 0 114 -51t47 -123v-694l21 15q39 27 60 1t-4 -63z" />
-    <glyph glyph-name="_458" unicode="&#xf1e8;" horiz-adv-x="1792" 
-d="M896 1102v-434h-145v434h145zM1294 1102v-434h-145v434h145zM1294 342l253 254v795h-1194v-1049h326v-217l217 217h398zM1692 1536v-1013l-434 -434h-326l-217 -217h-217v217h-398v1158l109 289h1483z" />
-    <glyph glyph-name="_459" unicode="&#xf1e9;" 
-d="M773 217v-127q-1 -292 -6 -305q-12 -32 -51 -40q-54 -9 -181.5 38t-162.5 89q-13 15 -17 36q-1 12 4 26q4 10 34 47t181 216q1 0 60 70q15 19 39.5 24.5t49.5 -3.5q24 -10 37.5 -29t12.5 -42zM624 468q-3 -55 -52 -70l-120 -39q-275 -88 -292 -88q-35 2 -54 36
-q-12 25 -17 75q-8 76 1 166.5t30 124.5t56 32q13 0 202 -77q71 -29 115 -47l84 -34q23 -9 35.5 -30.5t11.5 -48.5zM1450 171q-7 -54 -91.5 -161t-135.5 -127q-37 -14 -63 7q-14 10 -184 287l-47 77q-14 21 -11.5 46t19.5 46q35 43 83 26q1 -1 119 -40q203 -66 242 -79.5
-t47 -20.5q28 -22 22 -61zM778 803q5 -102 -54 -122q-58 -17 -114 71l-378 598q-8 35 19 62q41 43 207.5 89.5t224.5 31.5q40 -10 49 -45q3 -18 22 -305.5t24 -379.5zM1440 695q3 -39 -26 -59q-15 -10 -329 -86q-67 -15 -91 -23l1 2q-23 -6 -46 4t-37 32q-30 47 0 87
-q1 1 75 102q125 171 150 204t34 39q28 19 65 2q48 -23 123 -133.5t81 -167.5v-3z" />
-    <glyph glyph-name="_460" unicode="&#xf1ea;" horiz-adv-x="2048" 
-d="M1024 1024h-384v-384h384v384zM1152 384v-128h-640v128h640zM1152 1152v-640h-640v640h640zM1792 384v-128h-512v128h512zM1792 640v-128h-512v128h512zM1792 896v-128h-512v128h512zM1792 1152v-128h-512v128h512zM256 192v960h-128v-960q0 -26 19 -45t45 -19t45 19
-t19 45zM1920 192v1088h-1536v-1088q0 -33 -11 -64h1483q26 0 45 19t19 45zM2048 1408v-1216q0 -80 -56 -136t-136 -56h-1664q-80 0 -136 56t-56 136v1088h256v128h1792z" />
-    <glyph glyph-name="_461" unicode="&#xf1eb;" horiz-adv-x="2048" 
-d="M1024 13q-20 0 -93 73.5t-73 93.5q0 32 62.5 54t103.5 22t103.5 -22t62.5 -54q0 -20 -73 -93.5t-93 -73.5zM1294 284q-2 0 -40 25t-101.5 50t-128.5 25t-128.5 -25t-101 -50t-40.5 -25q-18 0 -93.5 75t-75.5 93q0 13 10 23q78 77 196 121t233 44t233 -44t196 -121
-q10 -10 10 -23q0 -18 -75.5 -93t-93.5 -75zM1567 556q-11 0 -23 8q-136 105 -252 154.5t-268 49.5q-85 0 -170.5 -22t-149 -53t-113.5 -62t-79 -53t-31 -22q-17 0 -92 75t-75 93q0 12 10 22q132 132 320 205t380 73t380 -73t320 -205q10 -10 10 -22q0 -18 -75 -93t-92 -75z
-M1838 827q-11 0 -22 9q-179 157 -371.5 236.5t-420.5 79.5t-420.5 -79.5t-371.5 -236.5q-11 -9 -22 -9q-17 0 -92.5 75t-75.5 93q0 13 10 23q187 186 445 288t527 102t527 -102t445 -288q10 -10 10 -23q0 -18 -75.5 -93t-92.5 -75z" />
-    <glyph glyph-name="_462" unicode="&#xf1ec;" horiz-adv-x="1792" 
-d="M384 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5
-t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5
-t37.5 90.5zM384 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 768q0 53 -37.5 90.5t-90.5 37.5
-t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1536 0v384q0 52 -38 90t-90 38t-90 -38t-38 -90v-384q0 -52 38 -90t90 -38t90 38t38 90zM1152 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z
-M1536 1088v256q0 26 -19 45t-45 19h-1280q-26 0 -45 -19t-19 -45v-256q0 -26 19 -45t45 -19h1280q26 0 45 19t19 45zM1536 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1408v-1536q0 -52 -38 -90t-90 -38
-h-1408q-52 0 -90 38t-38 90v1536q0 52 38 90t90 38h1408q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_463" unicode="&#xf1ed;" 
-d="M1519 890q18 -84 -4 -204q-87 -444 -565 -444h-44q-25 0 -44 -16.5t-24 -42.5l-4 -19l-55 -346l-2 -15q-5 -26 -24.5 -42.5t-44.5 -16.5h-251q-21 0 -33 15t-9 36q9 56 26.5 168t26.5 168t27 167.5t27 167.5q5 37 43 37h131q133 -2 236 21q175 39 287 144q102 95 155 246
-q24 70 35 133q1 6 2.5 7.5t3.5 1t6 -3.5q79 -59 98 -162zM1347 1172q0 -107 -46 -236q-80 -233 -302 -315q-113 -40 -252 -42q0 -1 -90 -1l-90 1q-100 0 -118 -96q-2 -8 -85 -530q-1 -10 -12 -10h-295q-22 0 -36.5 16.5t-11.5 38.5l232 1471q5 29 27.5 48t51.5 19h598
-q34 0 97.5 -13t111.5 -32q107 -41 163.5 -123t56.5 -196z" />
-    <glyph glyph-name="_464" unicode="&#xf1ee;" horiz-adv-x="1792" 
-d="M441 864q33 0 52 -26q266 -364 362 -774h-446q-127 441 -367 749q-12 16 -3 33.5t29 17.5h373zM1000 507q-49 -199 -125 -393q-79 310 -256 594q40 221 44 449q211 -340 337 -650zM1099 1216q235 -324 384.5 -698.5t184.5 -773.5h-451q-41 665 -553 1472h435zM1792 640
-q0 -424 -101 -812q-67 560 -359 1083q-25 301 -106 584q-4 16 5.5 28.5t25.5 12.5h359q21 0 38.5 -13t22.5 -33q115 -409 115 -850z" />
-    <glyph glyph-name="uniF1F0" unicode="&#xf1f0;" horiz-adv-x="2304" 
-d="M1975 546h-138q14 37 66 179l3 9q4 10 10 26t9 26l12 -55zM531 611l-58 295q-11 54 -75 54h-268l-2 -13q311 -79 403 -336zM710 960l-162 -438l-17 89q-26 70 -85 129.5t-131 88.5l135 -510h175l261 641h-176zM849 318h166l104 642h-166zM1617 944q-69 27 -149 27
-q-123 0 -201 -59t-79 -153q-1 -102 145 -174q48 -23 67 -41t19 -39q0 -30 -30 -46t-69 -16q-86 0 -156 33l-22 11l-23 -144q74 -34 185 -34q130 -1 208.5 59t80.5 160q0 106 -140 174q-49 25 -71 42t-22 38q0 22 24.5 38.5t70.5 16.5q70 1 124 -24l15 -8zM2042 960h-128
-q-65 0 -87 -54l-246 -588h174l35 96h212q5 -22 20 -96h154zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_466" unicode="&#xf1f1;" horiz-adv-x="2304" 
-d="M1119 1195q-128 85 -281 85q-103 0 -197.5 -40.5t-162.5 -108.5t-108.5 -162t-40.5 -197q0 -104 40.5 -198t108.5 -162t162 -108.5t198 -40.5q153 0 281 85q-131 107 -178 265.5t0.5 316.5t177.5 265zM1152 1171q-126 -99 -172 -249.5t-0.5 -300.5t172.5 -249
-q127 99 172.5 249t-0.5 300.5t-172 249.5zM1185 1195q130 -107 177.5 -265.5t0.5 -317t-178 -264.5q128 -85 281 -85q104 0 198 40.5t162 108.5t108.5 162t40.5 198q0 103 -40.5 197t-108.5 162t-162.5 108.5t-197.5 40.5q-153 0 -281 -85zM1926 473h7v3h-17v-3h7v-17h3v17z
-M1955 456h4v20h-5l-6 -13l-6 13h-5v-20h3v15l6 -13h4l5 13v-15zM1947 16v-2h-2h-3v3h3h2v-1zM1947 7h3l-4 5h2l1 1q1 1 1 3t-1 3l-1 1h-3h-6v-13h3v5h1zM685 75q0 19 11 31t30 12q18 0 29 -12.5t11 -30.5q0 -19 -11 -31t-29 -12q-19 0 -30 12t-11 31zM1158 119q30 0 35 -32
-h-70q5 32 35 32zM1514 75q0 19 11 31t29 12t29.5 -12.5t11.5 -30.5q0 -19 -11 -31t-30 -12q-18 0 -29 12t-11 31zM1786 75q0 18 11.5 30.5t29.5 12.5t29.5 -12.5t11.5 -30.5q0 -19 -11.5 -31t-29.5 -12t-29.5 12.5t-11.5 30.5zM1944 3q-2 0 -4 1q-1 0 -3 2t-2 3q-1 2 -1 4
-q0 3 1 4q0 2 2 4l1 1q2 0 2 1q2 1 4 1q3 0 4 -1l4 -2l2 -4v-1q1 -2 1 -3l-1 -1v-3t-1 -1l-1 -2q-2 -2 -4 -2q-1 -1 -4 -1zM599 7h30v85q0 24 -14.5 38.5t-39.5 15.5q-32 0 -47 -24q-14 24 -45 24q-24 0 -39 -20v16h-30v-135h30v75q0 36 33 36q30 0 30 -36v-75h29v75
-q0 36 33 36q30 0 30 -36v-75zM765 7h29v68v67h-29v-16q-17 20 -43 20q-29 0 -48 -20t-19 -51t19 -51t48 -20q28 0 43 20v-17zM943 48q0 34 -47 40l-14 2q-23 4 -23 14q0 15 25 15q23 0 43 -11l12 24q-22 14 -55 14q-26 0 -41 -12t-15 -32q0 -33 47 -39l13 -2q24 -4 24 -14
-q0 -17 -31 -17q-25 0 -45 14l-13 -23q25 -17 58 -17q29 0 45.5 12t16.5 32zM1073 14l-8 25q-13 -7 -26 -7q-19 0 -19 22v61h48v27h-48v41h-30v-41h-28v-27h28v-61q0 -50 47 -50q21 0 36 10zM1159 146q-29 0 -48 -20t-19 -51q0 -32 19.5 -51.5t49.5 -19.5q33 0 55 19l-14 22
-q-18 -15 -39 -15q-34 0 -41 33h101v12q0 32 -18 51.5t-46 19.5zM1318 146q-23 0 -35 -20v16h-30v-135h30v76q0 35 29 35q10 0 18 -4l9 28q-9 4 -21 4zM1348 75q0 -31 19.5 -51t52.5 -20q29 0 48 16l-14 24q-18 -13 -35 -12q-18 0 -29.5 12t-11.5 31t11.5 31t29.5 12
-q19 0 35 -12l14 24q-20 16 -48 16q-33 0 -52.5 -20t-19.5 -51zM1593 7h30v68v67h-30v-16q-15 20 -42 20q-29 0 -48.5 -20t-19.5 -51t19.5 -51t48.5 -20q28 0 42 20v-17zM1726 146q-23 0 -35 -20v16h-29v-135h29v76q0 35 29 35q10 0 18 -4l9 28q-8 4 -21 4zM1866 7h29v68v122
-h-29v-71q-15 20 -43 20t-47.5 -20.5t-19.5 -50.5t19.5 -50.5t47.5 -20.5q29 0 43 20v-17zM1944 27l-2 -1h-3q-2 -1 -4 -3q-3 -1 -3 -4q-1 -2 -1 -6q0 -3 1 -5q0 -2 3 -4q2 -2 4 -3t5 -1q4 0 6 1q0 1 2 2l2 1q1 1 3 4q1 2 1 5q0 4 -1 6q-1 1 -3 4q0 1 -2 2l-2 1q-1 0 -3 0.5
-t-3 0.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_467" unicode="&#xf1f2;" horiz-adv-x="2304" 
-d="M313 759q0 -51 -36 -84q-29 -26 -89 -26h-17v220h17q61 0 89 -27q36 -31 36 -83zM2089 824q0 -52 -64 -52h-19v101h20q63 0 63 -49zM380 759q0 74 -50 120.5t-129 46.5h-95v-333h95q74 0 119 38q60 51 60 128zM410 593h65v333h-65v-333zM730 694q0 40 -20.5 62t-75.5 42
-q-29 10 -39.5 19t-10.5 23q0 16 13.5 26.5t34.5 10.5q29 0 53 -27l34 44q-41 37 -98 37q-44 0 -74 -27.5t-30 -67.5q0 -35 18 -55.5t64 -36.5q37 -13 45 -19q19 -12 19 -34q0 -20 -14 -33.5t-36 -13.5q-48 0 -71 44l-42 -40q44 -64 115 -64q51 0 83 30.5t32 79.5zM1008 604
-v77q-37 -37 -78 -37q-49 0 -80.5 32.5t-31.5 82.5q0 48 31.5 81.5t77.5 33.5q43 0 81 -38v77q-40 20 -80 20q-74 0 -125.5 -50.5t-51.5 -123.5t51 -123.5t125 -50.5q42 0 81 19zM2240 0v527q-65 -40 -144.5 -84t-237.5 -117t-329.5 -137.5t-417.5 -134.5t-504 -118h1569
-q26 0 45 19t19 45zM1389 757q0 75 -53 128t-128 53t-128 -53t-53 -128t53 -128t128 -53t128 53t53 128zM1541 584l144 342h-71l-90 -224l-89 224h-71l142 -342h35zM1714 593h184v56h-119v90h115v56h-115v74h119v57h-184v-333zM2105 593h80l-105 140q76 16 76 94q0 47 -31 73
-t-87 26h-97v-333h65v133h9zM2304 1274v-1268q0 -56 -38.5 -95t-93.5 -39h-2040q-55 0 -93.5 39t-38.5 95v1268q0 56 38.5 95t93.5 39h2040q55 0 93.5 -39t38.5 -95z" />
-    <glyph glyph-name="f1f3" unicode="&#xf1f3;" horiz-adv-x="2304" 
-d="M119 854h89l-45 108zM740 328l74 79l-70 79h-163v-49h142v-55h-142v-54h159zM898 406l99 -110v217zM1186 453q0 33 -40 33h-84v-69h83q41 0 41 36zM1475 457q0 29 -42 29h-82v-61h81q43 0 43 32zM1197 923q0 29 -42 29h-82v-60h81q43 0 43 31zM1656 854h89l-44 108z
-M699 1009v-271h-66v212l-94 -212h-57l-94 212v-212h-132l-25 60h-135l-25 -60h-70l116 271h96l110 -257v257h106l85 -184l77 184h108zM1255 453q0 -20 -5.5 -35t-14 -25t-22.5 -16.5t-26 -10t-31.5 -4.5t-31.5 -1t-32.5 0.5t-29.5 0.5v-91h-126l-80 90l-83 -90h-256v271h260
-l80 -89l82 89h207q109 0 109 -89zM964 794v-56h-217v271h217v-57h-152v-49h148v-55h-148v-54h152zM2304 235v-229q0 -55 -38.5 -94.5t-93.5 -39.5h-2040q-55 0 -93.5 39.5t-38.5 94.5v678h111l25 61h55l25 -61h218v46l19 -46h113l20 47v-47h541v99l10 1q10 0 10 -14v-86h279
-v23q23 -12 55 -18t52.5 -6.5t63 0.5t51.5 1l25 61h56l25 -61h227v58l34 -58h182v378h-180v-44l-25 44h-185v-44l-23 44h-249q-69 0 -109 -22v22h-172v-22q-24 22 -73 22h-628l-43 -97l-43 97h-198v-44l-22 44h-169l-78 -179v391q0 55 38.5 94.5t93.5 39.5h2040
-q55 0 93.5 -39.5t38.5 -94.5v-678h-120q-51 0 -81 -22v22h-177q-55 0 -78 -22v22h-316v-22q-31 22 -87 22h-209v-22q-23 22 -91 22h-234l-54 -58l-50 58h-349v-378h343l55 59l52 -59h211v89h21q59 0 90 13v-102h174v99h8q8 0 10 -2t2 -10v-87h529q57 0 88 24v-24h168
-q60 0 95 17zM1546 469q0 -23 -12 -43t-34 -29q25 -9 34 -26t9 -46v-54h-65v45q0 33 -12 43.5t-46 10.5h-69v-99h-65v271h154q48 0 77 -15t29 -58zM1269 936q0 -24 -12.5 -44t-33.5 -29q26 -9 34.5 -25.5t8.5 -46.5v-53h-65q0 9 0.5 26.5t0 25t-3 18.5t-8.5 16t-17.5 8.5
-t-29.5 3.5h-70v-98h-64v271l153 -1q49 0 78 -14.5t29 -57.5zM1798 327v-56h-216v271h216v-56h-151v-49h148v-55h-148v-54zM1372 1009v-271h-66v271h66zM2065 357q0 -86 -102 -86h-126v58h126q34 0 34 25q0 16 -17 21t-41.5 5t-49.5 3.5t-42 22.5t-17 55q0 39 26 60t66 21
-h130v-57h-119q-36 0 -36 -25q0 -16 17.5 -20.5t42 -4t49 -2.5t42 -21.5t17.5 -54.5zM2304 407v-101q-24 -35 -88 -35h-125v58h125q33 0 33 25q0 13 -12.5 19t-31 5.5t-40 2t-40 8t-31 24t-12.5 48.5q0 39 26.5 60t66.5 21h129v-57h-118q-36 0 -36 -25q0 -20 29 -22t68.5 -5
-t56.5 -26zM2139 1008v-270h-92l-122 203v-203h-132l-26 60h-134l-25 -60h-75q-129 0 -129 133q0 138 133 138h63v-59q-7 0 -28 1t-28.5 0.5t-23 -2t-21.5 -6.5t-14.5 -13.5t-11.5 -23t-3 -33.5q0 -38 13.5 -58t49.5 -20h29l92 213h97l109 -256v256h99l114 -188v188h66z" />
-    <glyph glyph-name="_469" unicode="&#xf1f4;" horiz-adv-x="2304" 
-d="M745 630q0 -37 -25.5 -61.5t-62.5 -24.5q-29 0 -46.5 16t-17.5 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM1530 779q0 -42 -22 -57t-66 -15l-32 -1l17 107q2 11 13 11h18q22 0 35 -2t25 -12.5t12 -30.5zM1881 630q0 -36 -25.5 -61t-61.5 -25q-29 0 -47 16
-t-18 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM513 801q0 59 -38.5 85.5t-100.5 26.5h-160q-19 0 -21 -19l-65 -408q-1 -6 3 -11t10 -5h76q20 0 22 19l18 110q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM822 489l41 261q1 6 -3 11t-10 5h-76
-q-14 0 -17 -33q-27 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q28 0 58 12t48 32q-4 -12 -4 -21q0 -16 13 -16h69q19 0 22 19zM1269 752q0 5 -4 9.5t-9 4.5h-77q-11 0 -18 -10l-106 -156l-44 150q-5 16 -22 16h-75q-5 0 -9 -4.5t-4 -9.5q0 -2 19.5 -59
-t42 -123t23.5 -70q-82 -112 -82 -120q0 -13 13 -13h77q11 0 18 10l255 368q2 2 2 7zM1649 801q0 59 -38.5 85.5t-100.5 26.5h-159q-20 0 -22 -19l-65 -408q-1 -6 3 -11t10 -5h82q12 0 16 13l18 116q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM1958 489
-l41 261q1 6 -3 11t-10 5h-76q-14 0 -17 -33q-26 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q29 0 59 12t47 32q0 -1 -2 -9t-2 -12q0 -16 13 -16h69q19 0 22 19zM2176 898v1q0 14 -13 14h-74q-11 0 -13 -11l-65 -416l-1 -2q0 -5 4 -9.5t10 -4.5h66
-q19 0 21 19zM392 764q-5 -35 -26 -46t-60 -11l-33 -1l17 107q2 11 13 11h19q40 0 58 -11.5t12 -48.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_470" unicode="&#xf1f5;" horiz-adv-x="2304" 
-d="M1597 633q0 -69 -21 -106q-19 -35 -52 -35q-23 0 -41 9v224q29 30 57 30q57 0 57 -122zM2035 669h-110q6 98 56 98q51 0 54 -98zM476 534q0 59 -33 91.5t-101 57.5q-36 13 -52 24t-16 25q0 26 38 26q58 0 124 -33l18 112q-67 32 -149 32q-77 0 -123 -38q-48 -39 -48 -109
-q0 -58 32.5 -90.5t99.5 -56.5q39 -14 54.5 -25.5t15.5 -27.5q0 -31 -48 -31q-29 0 -70 12.5t-72 30.5l-18 -113q72 -41 168 -41q81 0 129 37q51 41 51 117zM771 749l19 111h-96v135l-129 -21l-18 -114l-46 -8l-17 -103h62v-219q0 -84 44 -120q38 -30 111 -30q32 0 79 11v118
-q-32 -7 -44 -7q-42 0 -42 50v197h77zM1087 724v139q-15 3 -28 3q-32 0 -55.5 -16t-33.5 -46l-10 56h-131v-471h150v306q26 31 82 31q16 0 26 -2zM1124 389h150v471h-150v-471zM1746 638q0 122 -45 179q-40 52 -111 52q-64 0 -117 -56l-8 47h-132v-645l150 25v151
-q36 -11 68 -11q83 0 134 56q61 65 61 202zM1278 986q0 33 -23 56t-56 23t-56 -23t-23 -56t23 -56.5t56 -23.5t56 23.5t23 56.5zM2176 629q0 113 -48 176q-50 64 -144 64q-96 0 -151.5 -66t-55.5 -180q0 -128 63 -188q55 -55 161 -55q101 0 160 40l-16 103q-57 -31 -128 -31
-q-43 0 -63 19q-23 19 -28 66h248q2 14 2 52zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_471" unicode="&#xf1f6;" horiz-adv-x="2048" 
-d="M1558 684q61 -356 298 -556q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5zM1024 -176q16 0 16 16t-16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5zM2026 1424q8 -10 7.5 -23.5t-10.5 -22.5
-l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5
-l418 363q10 8 23.5 7t21.5 -11z" />
-    <glyph glyph-name="_472" unicode="&#xf1f7;" horiz-adv-x="2048" 
-d="M1040 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM503 315l877 760q-42 88 -132.5 146.5t-223.5 58.5q-93 0 -169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -384 -137 -645zM1856 128
-q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5l149 129h757q-166 187 -227 459l111 97q61 -356 298 -556zM1942 1520l84 -96q8 -10 7.5 -23.5t-10.5 -22.5l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161
-q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5l418 363q10 8 23.5 7t21.5 -11z" />
-    <glyph glyph-name="_473" unicode="&#xf1f8;" horiz-adv-x="1408" 
-d="M512 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM768 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1024 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704
-q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167
-q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_474" unicode="&#xf1f9;" 
-d="M1150 462v-109q0 -50 -36.5 -89t-94 -60.5t-118 -32.5t-117.5 -11q-205 0 -342.5 139t-137.5 346q0 203 136 339t339 136q34 0 75.5 -4.5t93 -18t92.5 -34t69 -56.5t28 -81v-109q0 -16 -16 -16h-118q-16 0 -16 16v70q0 43 -65.5 67.5t-137.5 24.5q-140 0 -228.5 -91.5
-t-88.5 -237.5q0 -151 91.5 -249.5t233.5 -98.5q68 0 138 24t70 66v70q0 7 4.5 11.5t10.5 4.5h119q6 0 11 -4.5t5 -11.5zM768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5
-t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_475" unicode="&#xf1fa;" 
-d="M972 761q0 108 -53.5 169t-147.5 61q-63 0 -124 -30.5t-110 -84.5t-79.5 -137t-30.5 -180q0 -112 53.5 -173t150.5 -61q96 0 176 66.5t122.5 166t42.5 203.5zM1536 640q0 -111 -37 -197t-98.5 -135t-131.5 -74.5t-145 -27.5q-6 0 -15.5 -0.5t-16.5 -0.5q-95 0 -142 53
-q-28 33 -33 83q-52 -66 -131.5 -110t-173.5 -44q-161 0 -249.5 95.5t-88.5 269.5q0 157 66 290t179 210.5t246 77.5q87 0 155 -35.5t106 -99.5l2 19l11 56q1 6 5.5 12t9.5 6h118q5 0 13 -11q5 -5 3 -16l-120 -614q-5 -24 -5 -48q0 -39 12.5 -52t44.5 -13q28 1 57 5.5t73 24
-t77 50t57 89.5t24 137q0 292 -174 466t-466 174q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51q228 0 405 144q11 9 24 8t21 -12l41 -49q8 -12 7 -24q-2 -13 -12 -22q-102 -83 -227.5 -128t-258.5 -45q-156 0 -298 61
-t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q344 0 556 -212t212 -556z" />
-    <glyph glyph-name="_476" unicode="&#xf1fb;" horiz-adv-x="1792" 
-d="M1698 1442q94 -94 94 -226.5t-94 -225.5l-225 -223l104 -104q10 -10 10 -23t-10 -23l-210 -210q-10 -10 -23 -10t-23 10l-105 105l-603 -603q-37 -37 -90 -37h-203l-256 -128l-64 64l128 256v203q0 53 37 90l603 603l-105 105q-10 10 -10 23t10 23l210 210q10 10 23 10
-t23 -10l104 -104l223 225q93 94 225.5 94t226.5 -94zM512 64l576 576l-192 192l-576 -576v-192h192z" />
-    <glyph glyph-name="f1fc" unicode="&#xf1fc;" horiz-adv-x="1792" 
-d="M1615 1536q70 0 122.5 -46.5t52.5 -116.5q0 -63 -45 -151q-332 -629 -465 -752q-97 -91 -218 -91q-126 0 -216.5 92.5t-90.5 219.5q0 128 92 212l638 579q59 54 130 54zM706 502q39 -76 106.5 -130t150.5 -76l1 -71q4 -213 -129.5 -347t-348.5 -134q-123 0 -218 46.5
-t-152.5 127.5t-86.5 183t-29 220q7 -5 41 -30t62 -44.5t59 -36.5t46 -17q41 0 55 37q25 66 57.5 112.5t69.5 76t88 47.5t103 25.5t125 10.5z" />
-    <glyph glyph-name="_478" unicode="&#xf1fd;" horiz-adv-x="1792" 
-d="M1792 128v-384h-1792v384q45 0 85 14t59 27.5t47 37.5q30 27 51.5 38t56.5 11q24 0 44 -7t31 -15t33 -27q29 -25 47 -38t58 -27t86 -14q45 0 85 14.5t58 27t48 37.5q21 19 32.5 27t31 15t43.5 7q35 0 56.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14t85 14t59 27.5
-t47 37.5q30 27 51.5 38t56.5 11q34 0 55.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14zM1792 448v-192q-24 0 -44 7t-31 15t-33 27q-29 25 -47 38t-58 27t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-22 -19 -33 -27t-31 -15t-44 -7q-35 0 -56.5 11t-51.5 38q-29 25 -47 38
-t-58 27t-86 14q-45 0 -85 -14.5t-58 -27t-48 -37.5q-21 -19 -32.5 -27t-31 -15t-43.5 -7q-35 0 -56.5 11t-51.5 38q-28 24 -47 37.5t-59 27.5t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-30 -27 -51.5 -38t-56.5 -11v192q0 80 56 136t136 56h64v448h256v-448h256v448h256v-448
-h256v448h256v-448h64q80 0 136 -56t56 -136zM512 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1024 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5
-q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1536 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150z" />
-    <glyph glyph-name="_479" unicode="&#xf1fe;" horiz-adv-x="2048" 
-d="M2048 0v-128h-2048v1536h128v-1408h1920zM1664 1024l256 -896h-1664v576l448 576l576 -576z" />
-    <glyph glyph-name="_480" unicode="&#xf200;" horiz-adv-x="1792" 
-d="M768 646l546 -546q-106 -108 -247.5 -168t-298.5 -60q-209 0 -385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103v-762zM955 640h773q0 -157 -60 -298.5t-168 -247.5zM1664 768h-768v768q209 0 385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_481" unicode="&#xf201;" horiz-adv-x="2048" 
-d="M2048 0v-128h-2048v1536h128v-1408h1920zM1920 1248v-435q0 -21 -19.5 -29.5t-35.5 7.5l-121 121l-633 -633q-10 -10 -23 -10t-23 10l-233 233l-416 -416l-192 192l585 585q10 10 23 10t23 -10l233 -233l464 464l-121 121q-16 16 -7.5 35.5t29.5 19.5h435q14 0 23 -9
-t9 -23z" />
-    <glyph glyph-name="_482" unicode="&#xf202;" horiz-adv-x="1792" 
-d="M1292 832q0 -6 10 -41q10 -29 25 -49.5t41 -34t44 -20t55 -16.5q325 -91 325 -332q0 -146 -105.5 -242.5t-254.5 -96.5q-59 0 -111.5 18.5t-91.5 45.5t-77 74.5t-63 87.5t-53.5 103.5t-43.5 103t-39.5 106.5t-35.5 95q-32 81 -61.5 133.5t-73.5 96.5t-104 64t-142 20
-q-96 0 -183 -55.5t-138 -144.5t-51 -185q0 -160 106.5 -279.5t263.5 -119.5q177 0 258 95q56 63 83 116l84 -152q-15 -34 -44 -70l1 -1q-131 -152 -388 -152q-147 0 -269.5 79t-190.5 207.5t-68 274.5q0 105 43.5 206t116 176.5t172 121.5t204.5 46q87 0 159 -19t123.5 -50
-t95 -80t72.5 -99t58.5 -117t50.5 -124.5t50 -130.5t55 -127q96 -200 233 -200q81 0 138.5 48.5t57.5 128.5q0 42 -19 72t-50.5 46t-72.5 31.5t-84.5 27t-87.5 34t-81 52t-65 82t-39 122.5q-3 16 -3 33q0 110 87.5 192t198.5 78q78 -3 120.5 -14.5t90.5 -53.5h-1
-q12 -11 23 -24.5t26 -36t19 -27.5l-129 -99q-26 49 -54 70v1q-23 21 -97 21q-49 0 -84 -33t-35 -83z" />
-    <glyph glyph-name="_483" unicode="&#xf203;" 
-d="M1432 484q0 173 -234 239q-35 10 -53 16.5t-38 25t-29 46.5q0 2 -2 8.5t-3 12t-1 7.5q0 36 24.5 59.5t60.5 23.5q54 0 71 -15h-1q20 -15 39 -51l93 71q-39 54 -49 64q-33 29 -67.5 39t-85.5 10q-80 0 -142 -57.5t-62 -137.5q0 -7 2 -23q16 -96 64.5 -140t148.5 -73
-q29 -8 49 -15.5t45 -21.5t38.5 -34.5t13.5 -46.5v-5q1 -58 -40.5 -93t-100.5 -35q-97 0 -167 144q-23 47 -51.5 121.5t-48 125.5t-54 110.5t-74 95.5t-103.5 60.5t-147 24.5q-101 0 -192 -56t-144 -148t-50 -192v-1q4 -108 50.5 -199t133.5 -147.5t196 -56.5q186 0 279 110
-q20 27 31 51l-60 109q-42 -80 -99 -116t-146 -36q-115 0 -191 87t-76 204q0 105 82 189t186 84q112 0 170 -53.5t104 -172.5q8 -21 25.5 -68.5t28.5 -76.5t31.5 -74.5t38.5 -74t45.5 -62.5t55.5 -53.5t66 -33t80 -13.5q107 0 183 69.5t76 174.5zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_484" unicode="&#xf204;" horiz-adv-x="2048" 
-d="M1152 640q0 104 -40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM1920 640q0 104 -40.5 198.5
-t-109.5 163.5t-163.5 109.5t-198.5 40.5h-386q119 -90 188.5 -224t69.5 -288t-69.5 -288t-188.5 -224h386q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM2048 640q0 -130 -51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5
-t-136.5 204t-51 248.5t51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5z" />
-    <glyph glyph-name="_485" unicode="&#xf205;" horiz-adv-x="2048" 
-d="M0 640q0 130 51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5t-51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5t-136.5 204t-51 248.5zM1408 128q104 0 198.5 40.5t163.5 109.5
-t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5z" />
-    <glyph glyph-name="_486" unicode="&#xf206;" horiz-adv-x="2304" 
-d="M762 384h-314q-40 0 -57.5 35t6.5 67l188 251q-65 31 -137 31q-132 0 -226 -94t-94 -226t94 -226t226 -94q115 0 203 72.5t111 183.5zM576 512h186q-18 85 -75 148zM1056 512l288 384h-480l-99 -132q105 -103 126 -252h165zM2176 448q0 132 -94 226t-226 94
-q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94t226 94t94 226zM2304 448q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 97 39.5 183.5t109.5 149.5l-65 98l-353 -469
-q-18 -26 -51 -26h-197q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q114 0 215 -55l137 183h-224q-26 0 -45 19t-19 45t19 45t45 19h384v-128h435l-85 128h-222q-26 0 -45 19t-19 45t19 45t45 19h256q33 0 53 -28l267 -400
-q91 44 192 44q185 0 316.5 -131.5t131.5 -316.5z" />
-    <glyph glyph-name="_487" unicode="&#xf207;" 
-d="M384 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1362 716l-72 384q-5 23 -22.5 37.5t-40.5 14.5
-h-918q-23 0 -40.5 -14.5t-22.5 -37.5l-72 -384q-5 -30 14 -53t49 -23h1062q30 0 49 23t14 53zM1136 1328q0 20 -14 34t-34 14h-640q-20 0 -34 -14t-14 -34t14 -34t34 -14h640q20 0 34 14t14 34zM1536 603v-603h-128v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
-t-37.5 90.5v128h-768v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5v128h-128v603q0 112 25 223l103 454q9 78 97.5 137t230 89t312.5 30t312.5 -30t230 -89t97.5 -137l105 -454q23 -102 23 -223z" />
-    <glyph glyph-name="_488" unicode="&#xf208;" horiz-adv-x="2048" 
-d="M1463 704q0 -35 -25 -60.5t-61 -25.5h-702q-36 0 -61 25.5t-25 60.5t25 60.5t61 25.5h702q36 0 61 -25.5t25 -60.5zM1677 704q0 86 -23 170h-982q-36 0 -61 25t-25 60q0 36 25 61t61 25h908q-88 143 -235 227t-320 84q-177 0 -327.5 -87.5t-238 -237.5t-87.5 -327
-q0 -86 23 -170h982q36 0 61 -25t25 -60q0 -36 -25 -61t-61 -25h-908q88 -143 235.5 -227t320.5 -84q132 0 253 51.5t208 139t139 208t52 253.5zM2048 959q0 -35 -25 -60t-61 -25h-131q17 -85 17 -170q0 -167 -65.5 -319.5t-175.5 -263t-262.5 -176t-319.5 -65.5
-q-246 0 -448.5 133t-301.5 350h-189q-36 0 -61 25t-25 61q0 35 25 60t61 25h132q-17 85 -17 170q0 167 65.5 319.5t175.5 263t262.5 176t320.5 65.5q245 0 447.5 -133t301.5 -350h188q36 0 61 -25t25 -61z" />
-    <glyph glyph-name="_489" unicode="&#xf209;" horiz-adv-x="1280" 
-d="M953 1158l-114 -328l117 -21q165 451 165 518q0 56 -38 56q-57 0 -130 -225zM654 471l33 -88q37 42 71 67l-33 5.5t-38.5 7t-32.5 8.5zM362 1367q0 -98 159 -521q17 10 49 10q15 0 75 -5l-121 351q-75 220 -123 220q-19 0 -29 -17.5t-10 -37.5zM283 608q0 -36 51.5 -119
-t117.5 -153t100 -70q14 0 25.5 13t11.5 27q0 24 -32 102q-13 32 -32 72t-47.5 89t-61.5 81t-62 32q-20 0 -45.5 -27t-25.5 -47zM125 273q0 -41 25 -104q59 -145 183.5 -227t281.5 -82q227 0 382 170q152 169 152 427q0 43 -1 67t-11.5 62t-30.5 56q-56 49 -211.5 75.5
-t-270.5 26.5q-37 0 -49 -11q-12 -5 -12 -35q0 -34 21.5 -60t55.5 -40t77.5 -23.5t87.5 -11.5t85 -4t70 0h23q24 0 40 -19q15 -19 19 -55q-28 -28 -96 -54q-61 -22 -93 -46q-64 -46 -108.5 -114t-44.5 -137q0 -31 18.5 -88.5t18.5 -87.5l-3 -12q-4 -12 -4 -14
-q-137 10 -146 216q-8 -2 -41 -2q2 -7 2 -21q0 -53 -40.5 -89.5t-94.5 -36.5q-82 0 -166.5 78t-84.5 159q0 34 33 67q52 -64 60 -76q77 -104 133 -104q12 0 26.5 8.5t14.5 20.5q0 34 -87.5 145t-116.5 111q-43 0 -70 -44.5t-27 -90.5zM11 264q0 101 42.5 163t136.5 88
-q-28 74 -28 104q0 62 61 123t122 61q29 0 70 -15q-163 462 -163 567q0 80 41 130.5t119 50.5q131 0 325 -581q6 -17 8 -23q6 16 29 79.5t43.5 118.5t54 127.5t64.5 123t70.5 86.5t76.5 36q71 0 112 -49t41 -122q0 -108 -159 -550q61 -15 100.5 -46t58.5 -78t26 -93.5
-t7 -110.5q0 -150 -47 -280t-132 -225t-211 -150t-278 -55q-111 0 -223 42q-149 57 -258 191.5t-109 286.5z" />
-    <glyph glyph-name="_490" unicode="&#xf20a;" horiz-adv-x="2048" 
-d="M785 528h207q-14 -158 -98.5 -248.5t-214.5 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-203q-5 64 -35.5 99t-81.5 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t40 -51.5t66 -18q95 0 109 139zM1497 528h206
-q-14 -158 -98 -248.5t-214 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-204q-4 64 -35 99t-81 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t39.5 -51.5t65.5 -18q49 0 76.5 38t33.5 101zM1856 647q0 207 -15.5 307
-t-60.5 161q-6 8 -13.5 14t-21.5 15t-16 11q-86 63 -697 63q-625 0 -710 -63q-5 -4 -17.5 -11.5t-21 -14t-14.5 -14.5q-45 -60 -60 -159.5t-15 -308.5q0 -208 15 -307.5t60 -160.5q6 -8 15 -15t20.5 -14t17.5 -12q44 -33 239.5 -49t470.5 -16q610 0 697 65q5 4 17 11t20.5 14
-t13.5 16q46 60 61 159t15 309zM2048 1408v-1536h-2048v1536h2048z" />
-    <glyph glyph-name="_491" unicode="&#xf20b;" 
-d="M992 912v-496q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v496q0 112 -80 192t-192 80h-272v-1152q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v1344q0 14 9 23t23 9h464q135 0 249 -66.5t180.5 -180.5t66.5 -249zM1376 1376v-880q0 -135 -66.5 -249t-180.5 -180.5
-t-249 -66.5h-464q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h160q14 0 23 -9t9 -23v-768h272q112 0 192 80t80 192v880q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_492" unicode="&#xf20c;" 
-d="M1311 694v-114q0 -24 -13.5 -38t-37.5 -14h-202q-24 0 -38 14t-14 38v114q0 24 14 38t38 14h202q24 0 37.5 -14t13.5 -38zM821 464v250q0 53 -32.5 85.5t-85.5 32.5h-133q-68 0 -96 -52q-28 52 -96 52h-130q-53 0 -85.5 -32.5t-32.5 -85.5v-250q0 -22 21 -22h55
-q22 0 22 22v230q0 24 13.5 38t38.5 14h94q24 0 38 -14t14 -38v-230q0 -22 21 -22h54q22 0 22 22v230q0 24 14 38t38 14h97q24 0 37.5 -14t13.5 -38v-230q0 -22 22 -22h55q21 0 21 22zM1410 560v154q0 53 -33 85.5t-86 32.5h-264q-53 0 -86 -32.5t-33 -85.5v-410
-q0 -21 22 -21h55q21 0 21 21v180q31 -42 94 -42h191q53 0 86 32.5t33 85.5zM1536 1176v-1072q0 -96 -68 -164t-164 -68h-1072q-96 0 -164 68t-68 164v1072q0 96 68 164t164 68h1072q96 0 164 -68t68 -164z" />
-    <glyph glyph-name="_493" unicode="&#xf20d;" 
-d="M915 450h-294l147 551zM1001 128h311l-324 1024h-440l-324 -1024h311l383 314zM1536 1120v-960q0 -118 -85 -203t-203 -85h-960q-118 0 -203 85t-85 203v960q0 118 85 203t203 85h960q118 0 203 -85t85 -203z" />
-    <glyph glyph-name="_494" unicode="&#xf20e;" horiz-adv-x="2048" 
-d="M2048 641q0 -21 -13 -36.5t-33 -19.5l-205 -356q3 -9 3 -18q0 -20 -12.5 -35.5t-32.5 -19.5l-193 -337q3 -8 3 -16q0 -23 -16.5 -40t-40.5 -17q-25 0 -41 18h-400q-17 -20 -43 -20t-43 20h-399q-17 -20 -43 -20q-23 0 -40 16.5t-17 40.5q0 8 4 20l-193 335
-q-20 4 -32.5 19.5t-12.5 35.5q0 9 3 18l-206 356q-20 5 -32.5 20.5t-12.5 35.5q0 21 13.5 36.5t33.5 19.5l199 344q0 1 -0.5 3t-0.5 3q0 36 34 51l209 363q-4 10 -4 18q0 24 17 40.5t40 16.5q26 0 44 -21h396q16 21 43 21t43 -21h398q18 21 44 21q23 0 40 -16.5t17 -40.5
-q0 -6 -4 -18l207 -358q23 -1 39 -17.5t16 -38.5q0 -13 -7 -27l187 -324q19 -4 31.5 -19.5t12.5 -35.5zM1063 -158h389l-342 354h-143l-342 -354h360q18 16 39 16t39 -16zM112 654q1 -4 1 -13q0 -10 -2 -15l208 -360l15 -6l188 199v347l-187 194q-13 -8 -29 -10zM986 1438
-h-388l190 -200l554 200h-280q-16 -16 -38 -16t-38 16zM1689 226q1 6 5 11l-64 68l-17 -79h76zM1583 226l22 105l-252 266l-296 -307l63 -64h463zM1495 -142l16 28l65 310h-427l333 -343q8 4 13 5zM578 -158h5l342 354h-373v-335l4 -6q14 -5 22 -13zM552 226h402l64 66
-l-309 321l-157 -166v-221zM359 226h163v189l-168 -177q4 -8 5 -12zM358 1051q0 -1 0.5 -2t0.5 -2q0 -16 -8 -29l171 -177v269zM552 1121v-311l153 -157l297 314l-223 236zM556 1425l-4 -8v-264l205 74l-191 201q-6 -2 -10 -3zM1447 1438h-16l-621 -224l213 -225zM1023 946
-l-297 -315l311 -319l296 307zM688 634l-136 141v-284zM1038 270l-42 -44h85zM1374 618l238 -251l132 624l-3 5l-1 1zM1718 1018q-8 13 -8 29v2l-216 376q-5 1 -13 5l-437 -463l310 -327zM522 1142v223l-163 -282zM522 196h-163l163 -283v283zM1607 196l-48 -227l130 227h-82
-zM1729 266l207 361q-2 10 -2 14q0 1 3 16l-171 296l-129 -612l77 -82q5 3 15 7z" />
-    <glyph glyph-name="f210" unicode="&#xf210;" 
-d="M0 856q0 131 91.5 226.5t222.5 95.5h742l352 358v-1470q0 -132 -91.5 -227t-222.5 -95h-780q-131 0 -222.5 95t-91.5 227v790zM1232 102l-176 180v425q0 46 -32 79t-78 33h-484q-46 0 -78 -33t-32 -79v-492q0 -46 32.5 -79.5t77.5 -33.5h770z" />
-    <glyph glyph-name="_496" unicode="&#xf211;" 
-d="M934 1386q-317 -121 -556 -362.5t-358 -560.5q-20 89 -20 176q0 208 102.5 384.5t278.5 279t384 102.5q82 0 169 -19zM1203 1267q93 -65 164 -155q-389 -113 -674.5 -400.5t-396.5 -676.5q-93 72 -155 162q112 386 395 671t667 399zM470 -67q115 356 379.5 622t619.5 384
-q40 -92 54 -195q-292 -120 -516 -345t-343 -518q-103 14 -194 52zM1536 -125q-193 50 -367 115q-135 -84 -290 -107q109 205 274 370.5t369 275.5q-21 -152 -101 -284q65 -175 115 -370z" />
-    <glyph glyph-name="f212" unicode="&#xf212;" horiz-adv-x="2048" 
-d="M1893 1144l155 -1272q-131 0 -257 57q-200 91 -393 91q-226 0 -374 -148q-148 148 -374 148q-193 0 -393 -91q-128 -57 -252 -57h-5l155 1272q224 127 482 127q233 0 387 -106q154 106 387 106q258 0 482 -127zM1398 157q129 0 232 -28.5t260 -93.5l-124 1021
-q-171 78 -368 78q-224 0 -374 -141q-150 141 -374 141q-197 0 -368 -78l-124 -1021q105 43 165.5 65t148.5 39.5t178 17.5q202 0 374 -108q172 108 374 108zM1438 191l-55 907q-211 -4 -359 -155q-152 155 -374 155q-176 0 -336 -66l-114 -941q124 51 228.5 76t221.5 25
-q209 0 374 -102q172 107 374 102z" />
-    <glyph glyph-name="_498" unicode="&#xf213;" horiz-adv-x="2048" 
-d="M1500 165v733q0 21 -15 36t-35 15h-93q-20 0 -35 -15t-15 -36v-733q0 -20 15 -35t35 -15h93q20 0 35 15t15 35zM1216 165v531q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-531q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM924 165v429q0 20 -15 35t-35 15h-101
-q-20 0 -35 -15t-15 -35v-429q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM632 165v362q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-362q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM2048 311q0 -166 -118 -284t-284 -118h-1244q-166 0 -284 118t-118 284
-q0 116 63 214.5t168 148.5q-10 34 -10 73q0 113 80.5 193.5t193.5 80.5q102 0 180 -67q45 183 194 300t338 117q149 0 275 -73.5t199.5 -199.5t73.5 -275q0 -66 -14 -122q135 -33 221 -142.5t86 -247.5z" />
-    <glyph glyph-name="_499" unicode="&#xf214;" 
-d="M0 1536h1536v-1392l-776 -338l-760 338v1392zM1436 209v926h-1336v-926l661 -294zM1436 1235v201h-1336v-201h1336zM181 937v-115h-37v115h37zM181 789v-115h-37v115h37zM181 641v-115h-37v115h37zM181 493v-115h-37v115h37zM181 345v-115h-37v115h37zM207 202l15 34
-l105 -47l-15 -33zM343 142l15 34l105 -46l-15 -34zM478 82l15 34l105 -46l-15 -34zM614 23l15 33l104 -46l-15 -34zM797 10l105 46l15 -33l-105 -47zM932 70l105 46l15 -34l-105 -46zM1068 130l105 46l15 -34l-105 -46zM1203 189l105 47l15 -34l-105 -46zM259 1389v-36h-114
-v36h114zM421 1389v-36h-115v36h115zM583 1389v-36h-115v36h115zM744 1389v-36h-114v36h114zM906 1389v-36h-114v36h114zM1068 1389v-36h-115v36h115zM1230 1389v-36h-115v36h115zM1391 1389v-36h-114v36h114zM181 1049v-79h-37v115h115v-36h-78zM421 1085v-36h-115v36h115z
-M583 1085v-36h-115v36h115zM744 1085v-36h-114v36h114zM906 1085v-36h-114v36h114zM1068 1085v-36h-115v36h115zM1230 1085v-36h-115v36h115zM1355 970v79h-78v36h115v-115h-37zM1355 822v115h37v-115h-37zM1355 674v115h37v-115h-37zM1355 526v115h37v-115h-37zM1355 378
-v115h37v-115h-37zM1355 230v115h37v-115h-37zM760 265q-129 0 -221 91.5t-92 221.5q0 129 92 221t221 92q130 0 221.5 -92t91.5 -221q0 -130 -91.5 -221.5t-221.5 -91.5zM595 646q0 -36 19.5 -56.5t49.5 -25t64 -7t64 -2t49.5 -9t19.5 -30.5q0 -49 -112 -49q-97 0 -123 51
-h-3l-31 -63q67 -42 162 -42q29 0 56.5 5t55.5 16t45.5 33t17.5 53q0 46 -27.5 69.5t-67.5 27t-79.5 3t-67 5t-27.5 25.5q0 21 20.5 33t40.5 15t41 3q34 0 70.5 -11t51.5 -34h3l30 58q-3 1 -21 8.5t-22.5 9t-19.5 7t-22 7t-20 4.5t-24 4t-23 1q-29 0 -56.5 -5t-54 -16.5
-t-43 -34t-16.5 -53.5z" />
-    <glyph glyph-name="_500" unicode="&#xf215;" horiz-adv-x="2048" 
-d="M863 504q0 112 -79.5 191.5t-191.5 79.5t-191 -79.5t-79 -191.5t79 -191t191 -79t191.5 79t79.5 191zM1726 505q0 112 -79 191t-191 79t-191.5 -79t-79.5 -191q0 -113 79.5 -192t191.5 -79t191 79.5t79 191.5zM2048 1314v-1348q0 -44 -31.5 -75.5t-76.5 -31.5h-1832
-q-45 0 -76.5 31.5t-31.5 75.5v1348q0 44 31.5 75.5t76.5 31.5h431q44 0 76 -31.5t32 -75.5v-161h754v161q0 44 32 75.5t76 31.5h431q45 0 76.5 -31.5t31.5 -75.5z" />
-    <glyph glyph-name="_501" unicode="&#xf216;" horiz-adv-x="2048" 
-d="M1430 953zM1690 749q148 0 253 -98.5t105 -244.5q0 -157 -109 -261.5t-267 -104.5q-85 0 -162 27.5t-138 73.5t-118 106t-109 126t-103.5 132.5t-108.5 126.5t-117 106t-136 73.5t-159 27.5q-154 0 -251.5 -91.5t-97.5 -244.5q0 -157 104 -250t263 -93q100 0 208 37.5
-t193 98.5q5 4 21 18.5t30 24t22 9.5q14 0 24.5 -10.5t10.5 -24.5q0 -24 -60 -77q-101 -88 -234.5 -142t-260.5 -54q-133 0 -245.5 58t-180 165t-67.5 241q0 205 141.5 341t347.5 136q120 0 226.5 -43.5t185.5 -113t151.5 -153t139 -167.5t133.5 -153.5t149.5 -113
-t172.5 -43.5q102 0 168.5 61.5t66.5 162.5q0 95 -64.5 159t-159.5 64q-30 0 -81.5 -18.5t-68.5 -18.5q-20 0 -35.5 15t-15.5 35q0 18 8.5 57t8.5 59q0 159 -107.5 263t-266.5 104q-58 0 -111.5 -18.5t-84 -40.5t-55.5 -40.5t-33 -18.5q-15 0 -25.5 10.5t-10.5 25.5
-q0 19 25 46q59 67 147 103.5t182 36.5q191 0 318 -125.5t127 -315.5q0 -37 -4 -66q57 15 115 15z" />
-    <glyph glyph-name="_502" unicode="&#xf217;" horiz-adv-x="1664" 
-d="M1216 832q0 26 -19 45t-45 19h-128v128q0 26 -19 45t-45 19t-45 -19t-19 -45v-128h-128q-26 0 -45 -19t-19 -45t19 -45t45 -19h128v-128q0 -26 19 -45t45 -19t45 19t19 45v128h128q26 0 45 19t19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
-t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920
-q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="_503" unicode="&#xf218;" horiz-adv-x="1664" 
-d="M1280 832q0 26 -19 45t-45 19t-45 -19l-147 -146v293q0 26 -19 45t-45 19t-45 -19t-19 -45v-293l-147 146q-19 19 -45 19t-45 -19t-19 -45t19 -45l256 -256q19 -19 45 -19t45 19l256 256q19 19 19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
-t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920
-q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="_504" unicode="&#xf219;" horiz-adv-x="2048" 
-d="M212 768l623 -665l-300 665h-323zM1024 -4l349 772h-698zM538 896l204 384h-262l-288 -384h346zM1213 103l623 665h-323zM683 896h682l-204 384h-274zM1510 896h346l-288 384h-262zM1651 1382l384 -512q14 -18 13 -41.5t-17 -40.5l-960 -1024q-18 -20 -47 -20t-47 20
-l-960 1024q-16 17 -17 40.5t13 41.5l384 512q18 26 51 26h1152q33 0 51 -26z" />
-    <glyph glyph-name="_505" unicode="&#xf21a;" horiz-adv-x="2048" 
-d="M1811 -19q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83
-q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83
-q19 19 45 19t45 -19l83 -83zM237 19q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -82l83 82q19 19 45 19t45 -19l83 -82l64 64v293l-210 314q-17 26 -7 56.5t40 40.5l177 58v299h128v128h256v128h256v-128h256v-128h128v-299l177 -58q30 -10 40 -40.5t-7 -56.5l-210 -314
-v-293l19 18q19 19 45 19t45 -19l83 -82l83 82q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83
-q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83zM640 1152v-128l384 128l384 -128v128h-128v128h-512v-128h-128z" />
-    <glyph glyph-name="_506" unicode="&#xf21b;" 
-d="M576 0l96 448l-96 128l-128 64zM832 0l128 640l-128 -64l-96 -128zM992 1010q-2 4 -4 6q-10 8 -96 8q-70 0 -167 -19q-7 -2 -21 -2t-21 2q-97 19 -167 19q-86 0 -96 -8q-2 -2 -4 -6q2 -18 4 -27q2 -3 7.5 -6.5t7.5 -10.5q2 -4 7.5 -20.5t7 -20.5t7.5 -17t8.5 -17t9 -14
-t12 -13.5t14 -9.5t17.5 -8t20.5 -4t24.5 -2q36 0 59 12.5t32.5 30t14.5 34.5t11.5 29.5t17.5 12.5h12q11 0 17.5 -12.5t11.5 -29.5t14.5 -34.5t32.5 -30t59 -12.5q13 0 24.5 2t20.5 4t17.5 8t14 9.5t12 13.5t9 14t8.5 17t7.5 17t7 20.5t7.5 20.5q2 7 7.5 10.5t7.5 6.5
-q2 9 4 27zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 61 4.5 118t19 125.5t37.5 123.5t63.5 103.5t93.5 74.5l-90 220h214q-22 64 -22 128q0 12 2 32q-194 40 -194 96q0 57 210 99q17 62 51.5 134t70.5 114q32 37 76 37q30 0 84 -31t84 -31t84 31
-t84 31q44 0 76 -37q36 -42 70.5 -114t51.5 -134q210 -42 210 -99q0 -56 -194 -96q7 -81 -20 -160h214l-82 -225q63 -33 107.5 -96.5t65.5 -143.5t29 -151.5t8 -148.5z" />
-    <glyph glyph-name="_507" unicode="&#xf21c;" horiz-adv-x="2304" 
-d="M2301 500q12 -103 -22 -198.5t-99 -163.5t-158.5 -106t-196.5 -31q-161 11 -279.5 125t-134.5 274q-12 111 27.5 210.5t118.5 170.5l-71 107q-96 -80 -151 -194t-55 -244q0 -27 -18.5 -46.5t-45.5 -19.5h-256h-69q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5
-t-131.5 316.5t131.5 316.5t316.5 131.5q76 0 152 -27l24 45q-123 110 -304 110h-64q-26 0 -45 19t-19 45t19 45t45 19h128q78 0 145 -13.5t116.5 -38.5t71.5 -39.5t51 -36.5h512h115l-85 128h-222q-30 0 -49 22.5t-14 52.5q4 23 23 38t43 15h253q33 0 53 -28l70 -105
-l114 114q19 19 46 19h101q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-179l115 -172q131 63 275 36q143 -26 244 -134.5t118 -253.5zM448 128q115 0 203 72.5t111 183.5h-314q-35 0 -55 31q-18 32 -1 63l147 277q-47 13 -91 13q-132 0 -226 -94t-94 -226t94 -226
-t226 -94zM1856 128q132 0 226 94t94 226t-94 226t-226 94q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94z" />
-    <glyph glyph-name="_508" unicode="&#xf21d;" 
-d="M1408 0q0 -63 -61.5 -113.5t-164 -81t-225 -46t-253.5 -15.5t-253.5 15.5t-225 46t-164 81t-61.5 113.5q0 49 33 88.5t91 66.5t118 44.5t131 29.5q26 5 48 -10.5t26 -41.5q5 -26 -10.5 -48t-41.5 -26q-58 -10 -106 -23.5t-76.5 -25.5t-48.5 -23.5t-27.5 -19.5t-8.5 -12
-q3 -11 27 -26.5t73 -33t114 -32.5t160.5 -25t201.5 -10t201.5 10t160.5 25t114 33t73 33.5t27 27.5q-1 4 -8.5 11t-27.5 19t-48.5 23.5t-76.5 25t-106 23.5q-26 4 -41.5 26t-10.5 48q4 26 26 41.5t48 10.5q71 -12 131 -29.5t118 -44.5t91 -66.5t33 -88.5zM1024 896v-384
-q0 -26 -19 -45t-45 -19h-64v-384q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v384h-64q-26 0 -45 19t-19 45v384q0 53 37.5 90.5t90.5 37.5h384q53 0 90.5 -37.5t37.5 -90.5zM928 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5
-t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="_509" unicode="&#xf21e;" horiz-adv-x="1792" 
-d="M1280 512h305q-5 -6 -10 -10.5t-9 -7.5l-3 -4l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-5 2 -21 20h369q22 0 39.5 13.5t22.5 34.5l70 281l190 -667q6 -20 23 -33t39 -13q21 0 38 13t23 33l146 485l56 -112q18 -35 57 -35zM1792 940q0 -145 -103 -300h-369l-111 221
-q-8 17 -25.5 27t-36.5 8q-45 -5 -56 -46l-129 -430l-196 686q-6 20 -23.5 33t-39.5 13t-39 -13.5t-22 -34.5l-116 -464h-423q-103 155 -103 300q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124
-t127 -344z" />
-    <glyph glyph-name="venus" unicode="&#xf221;" horiz-adv-x="1280" 
-d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292
-q11 134 80.5 249t182 188t245.5 88q170 19 319 -54t236 -212t87 -306zM128 960q0 -185 131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5z" />
-    <glyph glyph-name="_511" unicode="&#xf222;" 
-d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-382 -383q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5
-q203 0 359 -126l382 382h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_512" unicode="&#xf223;" horiz-adv-x="1280" 
-d="M830 1220q145 -72 233.5 -210.5t88.5 -305.5q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5
-t-147.5 384.5q0 167 88.5 305.5t233.5 210.5q-165 96 -228 273q-6 16 3.5 29.5t26.5 13.5h69q21 0 29 -20q44 -106 140 -171t214 -65t214 65t140 171q8 20 37 20h61q17 0 26.5 -13.5t3.5 -29.5q-63 -177 -228 -273zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
-t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_513" unicode="&#xf224;" 
-d="M1024 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64
-q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-149 16 -270.5 103t-186.5 223.5t-53 291.5q16 204 160 353.5t347 172.5q118 14 228 -19t198 -103l255 254h-134q-14 0 -23 9t-9 23v64zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
-t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_514" unicode="&#xf225;" horiz-adv-x="1792" 
-d="M1280 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64
-q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5t-147.5 384.5q0 201 126 359l-52 53l-101 -111q-9 -10 -22 -10.5t-23 7.5l-48 44q-10 8 -10.5 21.5t8.5 23.5l105 115l-111 112v-134q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9
-t-9 23v288q0 26 19 45t45 19h288q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-133l106 -107l86 94q9 10 22 10.5t23 -7.5l48 -44q10 -8 10.5 -21.5t-8.5 -23.5l-90 -99l57 -56q158 126 359 126t359 -126l255 254h-134q-14 0 -23 9t-9 23v64zM832 256q185 0 316.5 131.5
-t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_515" unicode="&#xf226;" horiz-adv-x="1792" 
-d="M1790 1007q12 -155 -52.5 -292t-186 -224t-271.5 -103v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-512v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23
-t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292q17 206 164.5 356.5t352.5 169.5q206 21 377 -94q171 115 377 94q205 -19 352.5 -169.5t164.5 -356.5zM896 647q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM576 512q115 0 218 57q-154 165 -154 391
-q0 224 154 391q-103 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5zM1152 128v260q-137 15 -256 94q-119 -79 -256 -94v-260h512zM1216 512q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5q-115 0 -218 -57q154 -167 154 -391
-q0 -226 -154 -391q103 -57 218 -57z" />
-    <glyph glyph-name="_516" unicode="&#xf227;" horiz-adv-x="1920" 
-d="M1536 1120q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-31 -182 -166 -312t-318 -156q-210 -29 -384.5 80t-241.5 300q-117 6 -221 57.5t-177.5 133t-113.5 192.5t-32 230
-q9 135 78 252t182 191.5t248 89.5q118 14 227.5 -19t198.5 -103l255 254h-134q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q59 -74 93 -169q182 -9 328 -124l255 254h-134q-14 0 -23 9
-t-9 23v64zM1024 704q0 20 -4 58q-162 -25 -271 -150t-109 -292q0 -20 4 -58q162 25 271 150t109 292zM128 704q0 -168 111 -294t276 -149q-3 29 -3 59q0 210 135 369.5t338 196.5q-53 120 -163.5 193t-245.5 73q-185 0 -316.5 -131.5t-131.5 -316.5zM1088 -128
-q185 0 316.5 131.5t131.5 316.5q0 168 -111 294t-276 149q3 -28 3 -59q0 -210 -135 -369.5t-338 -196.5q53 -120 163.5 -193t245.5 -73z" />
-    <glyph glyph-name="_517" unicode="&#xf228;" horiz-adv-x="2048" 
-d="M1664 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-32 -180 -164.5 -310t-313.5 -157q-223 -34 -409 90q-117 -78 -256 -93v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23
-t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-155 17 -279.5 109.5t-187 237.5t-39.5 307q25 187 159.5 322.5t320.5 164.5q224 34 410 -90q146 97 320 97q201 0 359 -126l255 254h-134q-14 0 -23 9
-t-9 23v64zM896 391q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM128 704q0 -185 131.5 -316.5t316.5 -131.5q117 0 218 57q-154 167 -154 391t154 391q-101 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5zM1216 256q185 0 316.5 131.5t131.5 316.5
-t-131.5 316.5t-316.5 131.5q-117 0 -218 -57q154 -167 154 -391t-154 -391q101 -57 218 -57z" />
-    <glyph glyph-name="_518" unicode="&#xf229;" 
-d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-213 -214l140 -140q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-140 141l-78 -79q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5
-t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5q203 0 359 -126l78 78l-172 172q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l172 -172l213 213h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
-t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_519" unicode="&#xf22a;" horiz-adv-x="1280" 
-d="M640 892q217 -24 364.5 -187.5t147.5 -384.5q0 -167 -87 -306t-236 -212t-319 -54q-133 15 -245.5 88t-182 188t-80.5 249q-12 155 52.5 292t186 224t271.5 103v132h-160q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h160v165l-92 -92q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22
-t9 23l202 201q19 19 45 19t45 -19l202 -201q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-92 92v-165h160q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-160v-132zM576 -128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5
-t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_520" unicode="&#xf22b;" horiz-adv-x="2048" 
-d="M1901 621q19 -19 19 -45t-19 -45l-294 -294q-9 -10 -22.5 -10t-22.5 10l-45 45q-10 9 -10 22.5t10 22.5l185 185h-294v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-132q-24 -217 -187.5 -364.5t-384.5 -147.5q-167 0 -306 87t-212 236t-54 319q15 133 88 245.5
-t188 182t249 80.5q155 12 292 -52.5t224 -186t103 -271.5h132v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224h294l-185 185q-10 9 -10 22.5t10 22.5l45 45q9 10 22.5 10t22.5 -10zM576 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5
-t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_521" unicode="&#xf22c;" horiz-adv-x="1280" 
-d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-612q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v612q-217 24 -364.5 187.5t-147.5 384.5q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM576 512q185 0 316.5 131.5
-t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_522" unicode="&#xf22d;" horiz-adv-x="1280" 
-d="M1024 576q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1152 576q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123
-t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5z" />
-    <glyph glyph-name="_523" unicode="&#xf22e;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="_524" unicode="&#xf22f;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="_525" unicode="&#xf230;" 
-d="M1451 1408q35 0 60 -25t25 -60v-1366q0 -35 -25 -60t-60 -25h-391v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-735q-35 0 -60 25t-25 60v1366q0 35 25 60t60 25h1366z" />
-    <glyph glyph-name="_526" unicode="&#xf231;" horiz-adv-x="1280" 
-d="M0 939q0 108 37.5 203.5t103.5 166.5t152 123t185 78t202 26q158 0 294 -66.5t221 -193.5t85 -287q0 -96 -19 -188t-60 -177t-100 -149.5t-145 -103t-189 -38.5q-68 0 -135 32t-96 88q-10 -39 -28 -112.5t-23.5 -95t-20.5 -71t-26 -71t-32 -62.5t-46 -77.5t-62 -86.5
-l-14 -5l-9 10q-15 157 -15 188q0 92 21.5 206.5t66.5 287.5t52 203q-32 65 -32 169q0 83 52 156t132 73q61 0 95 -40.5t34 -102.5q0 -66 -44 -191t-44 -187q0 -63 45 -104.5t109 -41.5q55 0 102 25t78.5 68t56 95t38 110.5t20 111t6.5 99.5q0 173 -109.5 269.5t-285.5 96.5
-q-200 0 -334 -129.5t-134 -328.5q0 -44 12.5 -85t27 -65t27 -45.5t12.5 -30.5q0 -28 -15 -73t-37 -45q-2 0 -17 3q-51 15 -90.5 56t-61 94.5t-32.5 108t-11 106.5z" />
-    <glyph glyph-name="_527" unicode="&#xf232;" 
-d="M985 562q13 0 97.5 -44t89.5 -53q2 -5 2 -15q0 -33 -17 -76q-16 -39 -71 -65.5t-102 -26.5q-57 0 -190 62q-98 45 -170 118t-148 185q-72 107 -71 194v8q3 91 74 158q24 22 52 22q6 0 18 -1.5t19 -1.5q19 0 26.5 -6.5t15.5 -27.5q8 -20 33 -88t25 -75q0 -21 -34.5 -57.5
-t-34.5 -46.5q0 -7 5 -15q34 -73 102 -137q56 -53 151 -101q12 -7 22 -7q15 0 54 48.5t52 48.5zM782 32q127 0 243.5 50t200.5 134t134 200.5t50 243.5t-50 243.5t-134 200.5t-200.5 134t-243.5 50t-243.5 -50t-200.5 -134t-134 -200.5t-50 -243.5q0 -203 120 -368l-79 -233
-l242 77q158 -104 345 -104zM782 1414q153 0 292.5 -60t240.5 -161t161 -240.5t60 -292.5t-60 -292.5t-161 -240.5t-240.5 -161t-292.5 -60q-195 0 -365 94l-417 -134l136 405q-108 178 -108 389q0 153 60 292.5t161 240.5t240.5 161t292.5 60z" />
-    <glyph glyph-name="_528" unicode="&#xf233;" horiz-adv-x="1792" 
-d="M128 128h1024v128h-1024v-128zM128 640h1024v128h-1024v-128zM1696 192q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM128 1152h1024v128h-1024v-128zM1696 704q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1696 1216
-q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1792 384v-384h-1792v384h1792zM1792 896v-384h-1792v384h1792zM1792 1408v-384h-1792v384h1792z" />
-    <glyph glyph-name="_529" unicode="&#xf234;" horiz-adv-x="2048" 
-d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1664 512h352q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-352q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5
-t-9.5 22.5v352h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v352q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5v-352zM928 288q0 -52 38 -90t90 -38h256v-238q-68 -50 -171 -50h-874q-121 0 -194 69t-73 190q0 53 3.5 103.5t14 109t26.5 108.5
-t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q79 -61 154.5 -91.5t164.5 -30.5t164.5 30.5t154.5 91.5q20 17 39 17q132 0 217 -96h-223q-52 0 -90 -38t-38 -90v-192z" />
-    <glyph glyph-name="_530" unicode="&#xf235;" horiz-adv-x="2048" 
-d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1781 320l249 -249q9 -9 9 -23q0 -13 -9 -22l-136 -136q-9 -9 -22 -9q-14 0 -23 9l-249 249l-249 -249q-9 -9 -23 -9q-13 0 -22 9l-136 136
-q-9 9 -9 22q0 14 9 23l249 249l-249 249q-9 9 -9 23q0 13 9 22l136 136q9 9 22 9q14 0 23 -9l249 -249l249 249q9 9 23 9q13 0 22 -9l136 -136q9 -9 9 -22q0 -14 -9 -23zM1283 320l-181 -181q-37 -37 -37 -91q0 -53 37 -90l83 -83q-21 -3 -44 -3h-874q-121 0 -194 69
-t-73 190q0 53 3.5 103.5t14 109t26.5 108.5t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q154 -122 319 -122t319 122q20 17 39 17q28 0 57 -6q-28 -27 -41 -50t-13 -56q0 -54 37 -91z" />
-    <glyph glyph-name="_531" unicode="&#xf236;" horiz-adv-x="2048" 
-d="M256 512h1728q26 0 45 -19t19 -45v-448h-256v256h-1536v-256h-256v1216q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-704zM832 832q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM2048 576v64q0 159 -112.5 271.5t-271.5 112.5h-704
-q-26 0 -45 -19t-19 -45v-384h1152z" />
-    <glyph glyph-name="_532" unicode="&#xf237;" 
-d="M1536 1536l-192 -448h192v-192h-274l-55 -128h329v-192h-411l-357 -832l-357 832h-411v192h329l-55 128h-274v192h192l-192 448h256l323 -768h378l323 768h256zM768 320l108 256h-216z" />
-    <glyph glyph-name="_533" unicode="&#xf238;" 
-d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM768 192q80 0 136 56t56 136t-56 136t-136 56
-t-136 -56t-56 -136t56 -136t136 -56zM1344 768v512h-1152v-512h1152z" />
-    <glyph glyph-name="_534" unicode="&#xf239;" 
-d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM288 224q66 0 113 47t47 113t-47 113t-113 47
-t-113 -47t-47 -113t47 -113t113 -47zM704 768v512h-544v-512h544zM1248 224q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM1408 768v512h-576v-512h576z" />
-    <glyph glyph-name="_535" unicode="&#xf23a;" horiz-adv-x="1792" 
-d="M597 1115v-1173q0 -25 -12.5 -42.5t-36.5 -17.5q-17 0 -33 8l-465 233q-21 10 -35.5 33.5t-14.5 46.5v1140q0 20 10 34t29 14q14 0 44 -15l511 -256q3 -3 3 -5zM661 1014l534 -866l-534 266v600zM1792 996v-1054q0 -25 -14 -40.5t-38 -15.5t-47 13l-441 220zM1789 1116
-q0 -3 -256.5 -419.5t-300.5 -487.5l-390 634l324 527q17 28 52 28q14 0 26 -6l541 -270q4 -2 4 -6z" />
-    <glyph glyph-name="_536" unicode="&#xf23b;" 
-d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1408v-1536h-1536v1536h1536z" />
-    <glyph glyph-name="_537" unicode="&#xf23c;" horiz-adv-x="2296" 
-d="M478 -139q-8 -16 -27 -34.5t-37 -25.5q-25 -9 -51.5 3.5t-28.5 31.5q-1 22 40 55t68 38q23 4 34 -21.5t2 -46.5zM1819 -139q7 -16 26 -34.5t38 -25.5q25 -9 51.5 3.5t27.5 31.5q2 22 -39.5 55t-68.5 38q-22 4 -33 -21.5t-2 -46.5zM1867 -30q13 -27 56.5 -59.5t77.5 -41.5
-q45 -13 82 4.5t37 50.5q0 46 -67.5 100.5t-115.5 59.5q-40 5 -63.5 -37.5t-6.5 -76.5zM428 -30q-13 -27 -56 -59.5t-77 -41.5q-45 -13 -82 4.5t-37 50.5q0 46 67.5 100.5t115.5 59.5q40 5 63 -37.5t6 -76.5zM1158 1094h1q-41 0 -76 -15q27 -8 44 -30.5t17 -49.5
-q0 -35 -27 -60t-65 -25q-52 0 -80 43q-5 -23 -5 -42q0 -74 56 -126.5t135 -52.5q80 0 136 52.5t56 126.5t-56 126.5t-136 52.5zM1462 1312q-99 109 -220.5 131.5t-245.5 -44.5q27 60 82.5 96.5t118 39.5t121.5 -17t99.5 -74.5t44.5 -131.5zM2212 73q8 -11 -11 -42
-q7 -23 7 -40q1 -56 -44.5 -112.5t-109.5 -91.5t-118 -37q-48 -2 -92 21.5t-66 65.5q-687 -25 -1259 0q-23 -41 -66.5 -65t-92.5 -22q-86 3 -179.5 80.5t-92.5 160.5q2 22 7 40q-19 31 -11 42q6 10 31 1q14 22 41 51q-7 29 2 38q11 10 39 -4q29 20 59 34q0 29 13 37
-q23 12 51 -16q35 5 61 -2q18 -4 38 -19v73q-11 0 -18 2q-53 10 -97 44.5t-55 87.5q-9 38 0 81q15 62 93 95q2 17 19 35.5t36 23.5t33 -7.5t19 -30.5h13q46 -5 60 -23q3 -3 5 -7q10 1 30.5 3.5t30.5 3.5q-15 11 -30 17q-23 40 -91 43q0 6 1 10q-62 2 -118.5 18.5t-84.5 47.5
-q-32 36 -42.5 92t-2.5 112q16 126 90 179q23 16 52 4.5t32 -40.5q0 -1 1.5 -14t2.5 -21t3 -20t5.5 -19t8.5 -10q27 -14 76 -12q48 46 98 74q-40 4 -162 -14l47 46q61 58 163 111q145 73 282 86q-20 8 -41 15.5t-47 14t-42.5 10.5t-47.5 11t-43 10q595 126 904 -139
-q98 -84 158 -222q85 -10 121 9h1q5 3 8.5 10t5.5 19t3 19.5t3 21.5l1 14q3 28 32 40t52 -5q73 -52 91 -178q7 -57 -3.5 -113t-42.5 -91q-28 -32 -83.5 -48.5t-115.5 -18.5v-10q-71 -2 -95 -43q-14 -5 -31 -17q11 -1 32 -3.5t30 -3.5q1 5 5 8q16 18 60 23h13q5 18 19 30t33 8
-t36 -23t19 -36q79 -32 93 -95q9 -40 1 -81q-12 -53 -56 -88t-97 -44q-10 -2 -17 -2q0 -49 -1 -73q20 15 38 19q26 7 61 2q28 28 51 16q14 -9 14 -37q33 -16 59 -34q27 13 38 4q10 -10 2 -38q28 -30 41 -51q23 8 31 -1zM1937 1025q0 -29 -9 -54q82 -32 112 -132
-q4 37 -9.5 98.5t-41.5 90.5q-20 19 -36 17t-16 -20zM1859 925q35 -42 47.5 -108.5t-0.5 -124.5q67 13 97 45q13 14 18 28q-3 64 -31 114.5t-79 66.5q-15 -15 -52 -21zM1822 921q-30 0 -44 1q42 -115 53 -239q21 0 43 3q16 68 1 135t-53 100zM258 839q30 100 112 132
-q-9 25 -9 54q0 18 -16.5 20t-35.5 -17q-28 -29 -41.5 -90.5t-9.5 -98.5zM294 737q29 -31 97 -45q-13 58 -0.5 124.5t47.5 108.5v0q-37 6 -52 21q-51 -16 -78.5 -66t-31.5 -115q9 -17 18 -28zM471 683q14 124 73 235q-19 -4 -55 -18l-45 -19v1q-46 -89 -20 -196q25 -3 47 -3z
-M1434 644q8 -38 16.5 -108.5t11.5 -89.5q3 -18 9.5 -21.5t23.5 4.5q40 20 62 85.5t23 125.5q-24 2 -146 4zM1152 1285q-116 0 -199 -82.5t-83 -198.5q0 -117 83 -199.5t199 -82.5t199 82.5t83 199.5q0 116 -83 198.5t-199 82.5zM1380 646q-105 2 -211 0v1q-1 -27 2.5 -86
-t13.5 -66q29 -14 93.5 -14.5t95.5 10.5q9 3 11 39t-0.5 69.5t-4.5 46.5zM1112 447q8 4 9.5 48t-0.5 88t-4 63v1q-212 -3 -214 -3q-4 -20 -7 -62t0 -83t14 -46q34 -15 101 -16t101 10zM718 636q-16 -59 4.5 -118.5t77.5 -84.5q15 -8 24 -5t12 21q3 16 8 90t10 103
-q-69 -2 -136 -6zM591 510q3 -23 -34 -36q132 -141 271.5 -240t305.5 -154q172 49 310.5 146t293.5 250q-33 13 -30 34q0 2 0.5 3.5t1.5 3t1 2.5v1v-1q-17 2 -50 5.5t-48 4.5q-26 -90 -82 -132q-51 -38 -82 1q-5 6 -9 14q-7 13 -17 62q-2 -5 -5 -9t-7.5 -7t-8 -5.5t-9.5 -4
-l-10 -2.5t-12 -2l-12 -1.5t-13.5 -1t-13.5 -0.5q-106 -9 -163 11q-4 -17 -10 -26.5t-21 -15t-23 -7t-36 -3.5q-6 -1 -9 -1q-179 -17 -203 40q-2 -63 -56 -54q-47 8 -91 54q-12 13 -20 26q-17 29 -26 65q-58 -6 -87 -10q1 -2 4 -10zM507 -118q3 14 3 30q-17 71 -51 130
-t-73 70q-41 12 -101.5 -14.5t-104.5 -80t-39 -107.5q35 -53 100 -93t119 -42q51 -2 94 28t53 79zM510 53q23 -63 27 -119q195 113 392 174q-98 52 -180.5 120t-179.5 165q-6 -4 -29 -13q0 -1 -1 -4t-1 -5q31 -18 22 -37q-12 -23 -56 -34q-10 -13 -29 -24h-1q-2 -83 1 -150
-q19 -34 35 -73zM579 -113q532 -21 1145 0q-254 147 -428 196q-76 -35 -156 -57q-8 -3 -16 0q-65 21 -129 49q-208 -60 -416 -188h-1v-1q1 0 1 1zM1763 -67q4 54 28 120q14 38 33 71l-1 -1q3 77 3 153q-15 8 -30 25q-42 9 -56 33q-9 20 22 38q-2 4 -2 9q-16 4 -28 12
-q-204 -190 -383 -284q198 -59 414 -176zM2155 -90q5 54 -39 107.5t-104 80t-102 14.5q-38 -11 -72.5 -70.5t-51.5 -129.5q0 -16 3 -30q10 -49 53 -79t94 -28q54 2 119 42t100 93z" />
-    <glyph glyph-name="_538" unicode="&#xf23d;" horiz-adv-x="2304" 
-d="M1524 -25q0 -68 -48 -116t-116 -48t-116.5 48t-48.5 116t48.5 116.5t116.5 48.5t116 -48.5t48 -116.5zM775 -25q0 -68 -48.5 -116t-116.5 -48t-116 48t-48 116t48 116.5t116 48.5t116.5 -48.5t48.5 -116.5zM0 1469q57 -60 110.5 -104.5t121 -82t136 -63t166 -45.5
-t200 -31.5t250 -18.5t304 -9.5t372.5 -2.5q139 0 244.5 -5t181 -16.5t124 -27.5t71 -39.5t24 -51.5t-19.5 -64t-56.5 -76.5t-89.5 -91t-116 -104.5t-139 -119q-185 -157 -286 -247q29 51 76.5 109t94 105.5t94.5 98.5t83 91.5t54 80.5t13 70t-45.5 55.5t-116.5 41t-204 23.5
-t-304 5q-168 -2 -314 6t-256 23t-204.5 41t-159.5 51.5t-122.5 62.5t-91.5 66.5t-68 71.5t-50.5 69.5t-40 68t-36.5 59.5z" />
-    <glyph glyph-name="_539" unicode="&#xf23e;" horiz-adv-x="1792" 
-d="M896 1472q-169 0 -323 -66t-265.5 -177.5t-177.5 -265.5t-66 -323t66 -323t177.5 -265.5t265.5 -177.5t323 -66t323 66t265.5 177.5t177.5 265.5t66 323t-66 323t-177.5 265.5t-265.5 177.5t-323 66zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348
-t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM496 704q16 0 16 -16v-480q0 -16 -16 -16h-32q-16 0 -16 16v480q0 16 16 16h32zM896 640q53 0 90.5 -37.5t37.5 -90.5q0 -35 -17.5 -64t-46.5 -46v-114q0 -14 -9 -23
-t-23 -9h-64q-14 0 -23 9t-9 23v114q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5zM896 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM544 928v-96
-q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 93 65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5v-96q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 146 -103 249t-249 103t-249 -103t-103 -249zM1408 192v512q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-512
-q0 -26 19 -45t45 -19h896q26 0 45 19t19 45z" />
-    <glyph glyph-name="_540" unicode="&#xf240;" horiz-adv-x="2304" 
-d="M1920 1024v-768h-1664v768h1664zM2048 448h128v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288zM2304 832v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113
-v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="_541" unicode="&#xf241;" horiz-adv-x="2304" 
-d="M256 256v768h1280v-768h-1280zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
-h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_542" unicode="&#xf242;" horiz-adv-x="2304" 
-d="M256 256v768h896v-768h-896zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
-h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_543" unicode="&#xf243;" horiz-adv-x="2304" 
-d="M256 256v768h512v-768h-512zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
-h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_544" unicode="&#xf244;" horiz-adv-x="2304" 
-d="M2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23
-v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_545" unicode="&#xf245;" horiz-adv-x="1280" 
-d="M1133 493q31 -30 14 -69q-17 -40 -59 -40h-382l201 -476q10 -25 0 -49t-34 -35l-177 -75q-25 -10 -49 0t-35 34l-191 452l-312 -312q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v1504q0 42 40 59q12 5 24 5q27 0 45 -19z" />
-    <glyph glyph-name="_546" unicode="&#xf246;" horiz-adv-x="1024" 
-d="M832 1408q-320 0 -320 -224v-416h128v-128h-128v-544q0 -224 320 -224h64v-128h-64q-272 0 -384 146q-112 -146 -384 -146h-64v128h64q320 0 320 224v544h-128v128h128v416q0 224 -320 224h-64v128h64q272 0 384 -146q112 146 384 146h64v-128h-64z" />
-    <glyph glyph-name="_547" unicode="&#xf247;" horiz-adv-x="2048" 
-d="M2048 1152h-128v-1024h128v-384h-384v128h-1280v-128h-384v384h128v1024h-128v384h384v-128h1280v128h384v-384zM1792 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 -128v128h-128v-128h128zM1664 0v128h128v1024h-128v128h-1280v-128h-128v-1024h128v-128
-h1280zM1920 -128v128h-128v-128h128zM1280 896h384v-768h-896v256h-384v768h896v-256zM512 512h640v512h-640v-512zM1536 256v512h-256v-384h-384v-128h640z" />
-    <glyph glyph-name="_548" unicode="&#xf248;" horiz-adv-x="2304" 
-d="M2304 768h-128v-640h128v-384h-384v128h-896v-128h-384v384h128v128h-384v-128h-384v384h128v640h-128v384h384v-128h896v128h384v-384h-128v-128h384v128h384v-384zM2048 1024v-128h128v128h-128zM1408 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 256
-v128h-128v-128h128zM1536 384h-128v-128h128v128zM384 384h896v128h128v640h-128v128h-896v-128h-128v-640h128v-128zM896 -128v128h-128v-128h128zM2176 -128v128h-128v-128h128zM2048 128v640h-128v128h-384v-384h128v-384h-384v128h-384v-128h128v-128h896v128h128z" />
-    <glyph glyph-name="_549" unicode="&#xf249;" 
-d="M1024 288v-416h-928q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68v-928h-416q-40 0 -68 -28t-28 -68zM1152 256h381q-15 -82 -65 -132l-184 -184q-50 -50 -132 -65v381z" />
-    <glyph glyph-name="_550" unicode="&#xf24a;" 
-d="M1400 256h-248v-248q29 10 41 22l185 185q12 12 22 41zM1120 384h288v896h-1280v-1280h896v288q0 40 28 68t68 28zM1536 1312v-1024q0 -40 -20 -88t-48 -76l-184 -184q-28 -28 -76 -48t-88 -20h-1024q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68
-z" />
-    <glyph glyph-name="_551" unicode="&#xf24b;" horiz-adv-x="2304" 
-d="M1951 538q0 -26 -15.5 -44.5t-38.5 -23.5q-8 -2 -18 -2h-153v140h153q10 0 18 -2q23 -5 38.5 -23.5t15.5 -44.5zM1933 751q0 -25 -15 -42t-38 -21q-3 -1 -15 -1h-139v129h139q3 0 8.5 -0.5t6.5 -0.5q23 -4 38 -21.5t15 -42.5zM728 587v308h-228v-308q0 -58 -38 -94.5
-t-105 -36.5q-108 0 -229 59v-112q53 -15 121 -23t109 -9l42 -1q328 0 328 217zM1442 403v113q-99 -52 -200 -59q-108 -8 -169 41t-61 142t61 142t169 41q101 -7 200 -58v112q-48 12 -100 19.5t-80 9.5l-28 2q-127 6 -218.5 -14t-140.5 -60t-71 -88t-22 -106t22 -106t71 -88
-t140.5 -60t218.5 -14q101 4 208 31zM2176 518q0 54 -43 88.5t-109 39.5v3q57 8 89 41.5t32 79.5q0 55 -41 88t-107 36q-3 0 -12 0.5t-14 0.5h-455v-510h491q74 0 121.5 36.5t47.5 96.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90
-t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_552" unicode="&#xf24c;" horiz-adv-x="2304" 
-d="M858 295v693q-106 -41 -172 -135.5t-66 -211.5t66 -211.5t172 -134.5zM1362 641q0 117 -66 211.5t-172 135.5v-694q106 41 172 135.5t66 211.5zM1577 641q0 -159 -78.5 -294t-213.5 -213.5t-294 -78.5q-119 0 -227.5 46.5t-187 125t-125 187t-46.5 227.5q0 159 78.5 294
-t213.5 213.5t294 78.5t294 -78.5t213.5 -213.5t78.5 -294zM1960 634q0 139 -55.5 261.5t-147.5 205.5t-213.5 131t-252.5 48h-301q-176 0 -323.5 -81t-235 -230t-87.5 -335q0 -171 87 -317.5t236 -231.5t323 -85h301q129 0 251.5 50.5t214.5 135t147.5 202.5t55.5 246z
-M2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_553" unicode="&#xf24d;" horiz-adv-x="1792" 
-d="M1664 -96v1088q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5zM1792 992v-1088q0 -66 -47 -113t-113 -47h-1088q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113
-zM1408 1376v-160h-128v160q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h160v-128h-160q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="_554" unicode="&#xf24e;" horiz-adv-x="2304" 
-d="M1728 1088l-384 -704h768zM448 1088l-384 -704h768zM1269 1280q-14 -40 -45.5 -71.5t-71.5 -45.5v-1291h608q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1344q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h608v1291q-40 14 -71.5 45.5t-45.5 71.5h-491q-14 0 -23 9t-9 23v64
-q0 14 9 23t23 9h491q21 57 70 92.5t111 35.5t111 -35.5t70 -92.5h491q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-491zM1088 1264q33 0 56.5 23.5t23.5 56.5t-23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5zM2176 384q0 -73 -46.5 -131t-117.5 -91
-t-144.5 -49.5t-139.5 -16.5t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81zM896 384q0 -73 -46.5 -131t-117.5 -91t-144.5 -49.5t-139.5 -16.5
-t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81z" />
-    <glyph glyph-name="_555" unicode="&#xf250;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-77 -29 -149 -92.5
-t-129.5 -152.5t-92.5 -210t-35 -253h1024q0 132 -35 253t-92.5 210t-129.5 152.5t-149 92.5q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
-    <glyph glyph-name="_556" unicode="&#xf251;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -66 9 -128h1006q9 61 9 128zM1280 -128q0 130 -34 249.5t-90.5 208t-126.5 152t-146 94.5h-230q-76 -31 -146 -94.5t-126.5 -152t-90.5 -208t-34 -249.5h1024z" />
-    <glyph glyph-name="_557" unicode="&#xf252;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -206 85 -384h854q85 178 85 384zM1223 192q-54 141 -145.5 241.5t-194.5 142.5h-230q-103 -42 -194.5 -142.5t-145.5 -241.5h910z" />
-    <glyph glyph-name="_558" unicode="&#xf253;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-137 -51 -244 -196
-h700q-107 145 -244 196q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
-    <glyph glyph-name="_559" unicode="&#xf254;" 
-d="M1504 -64q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472zM130 0q3 55 16 107t30 95t46 87t53.5 76t64.5 69.5t66 60t70.5 55t66.5 47.5t65 43q-43 28 -65 43t-66.5 47.5t-70.5 55t-66 60t-64.5 69.5t-53.5 76t-46 87
-t-30 95t-16 107h1276q-3 -55 -16 -107t-30 -95t-46 -87t-53.5 -76t-64.5 -69.5t-66 -60t-70.5 -55t-66.5 -47.5t-65 -43q43 -28 65 -43t66.5 -47.5t70.5 -55t66 -60t64.5 -69.5t53.5 -76t46 -87t30 -95t16 -107h-1276zM1504 1536q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9
-h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472z" />
-    <glyph glyph-name="_560" unicode="&#xf255;" 
-d="M768 1152q-53 0 -90.5 -37.5t-37.5 -90.5v-128h-32v93q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-429l-32 30v172q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-224q0 -47 35 -82l310 -296q39 -39 39 -102q0 -26 19 -45t45 -19h640q26 0 45 19t19 45v25
-q0 41 10 77l108 436q10 36 10 77v246q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-32h-32v125q0 40 -25 72.5t-64 40.5q-14 2 -23 2q-46 0 -79 -33t-33 -79v-128h-32v122q0 51 -32.5 89.5t-82.5 43.5q-5 1 -13 1zM768 1280q84 0 149 -50q57 34 123 34q59 0 111 -27
-t86 -76q27 7 59 7q100 0 170 -71.5t70 -171.5v-246q0 -51 -13 -108l-109 -436q-6 -24 -6 -71q0 -80 -56 -136t-136 -56h-640q-84 0 -138 58.5t-54 142.5l-308 296q-76 73 -76 175v224q0 99 70.5 169.5t169.5 70.5q11 0 16 -1q6 95 75.5 160t164.5 65q52 0 98 -21
-q72 69 174 69z" />
-    <glyph glyph-name="_561" unicode="&#xf256;" horiz-adv-x="1792" 
-d="M880 1408q-46 0 -79 -33t-33 -79v-656h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528v-256l-154 205q-38 51 -102 51q-53 0 -90.5 -37.5t-37.5 -90.5q0 -43 26 -77l384 -512q38 -51 102 -51h688q34 0 61 22t34 56l76 405q5 32 5 59v498q0 46 -33 79t-79 33t-79 -33
-t-33 -79v-272h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528h-32v656q0 46 -33 79t-79 33zM880 1536q68 0 125.5 -35.5t88.5 -96.5q19 4 42 4q99 0 169.5 -70.5t70.5 -169.5v-17q105 6 180.5 -64t75.5 -175v-498q0 -40 -8 -83l-76 -404q-14 -79 -76.5 -131t-143.5 -52
-h-688q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 106 75 181t181 75q78 0 128 -34v434q0 99 70.5 169.5t169.5 70.5q23 0 42 -4q31 61 88.5 96.5t125.5 35.5z" />
-    <glyph glyph-name="_562" unicode="&#xf257;" horiz-adv-x="1792" 
-d="M1073 -128h-177q-163 0 -226 141q-23 49 -23 102v5q-62 30 -98.5 88.5t-36.5 127.5q0 38 5 48h-261q-106 0 -181 75t-75 181t75 181t181 75h113l-44 17q-74 28 -119.5 93.5t-45.5 145.5q0 106 75 181t181 75q46 0 91 -17l628 -239h401q106 0 181 -75t75 -181v-668
-q0 -88 -54 -157.5t-140 -90.5l-339 -85q-92 -23 -186 -23zM1024 583l-155 -71l-163 -74q-30 -14 -48 -41.5t-18 -60.5q0 -46 33 -79t79 -33q26 0 46 10l338 154q-49 10 -80.5 50t-31.5 90v55zM1344 272q0 46 -33 79t-79 33q-26 0 -46 -10l-290 -132q-28 -13 -37 -17
-t-30.5 -17t-29.5 -23.5t-16 -29t-8 -40.5q0 -50 31.5 -82t81.5 -32q20 0 38 9l352 160q30 14 48 41.5t18 60.5zM1112 1024l-650 248q-24 8 -46 8q-53 0 -90.5 -37.5t-37.5 -90.5q0 -40 22.5 -73t59.5 -47l526 -200v-64h-640q-53 0 -90.5 -37.5t-37.5 -90.5t37.5 -90.5
-t90.5 -37.5h535l233 106v198q0 63 46 106l111 102h-69zM1073 0q82 0 155 19l339 85q43 11 70 45.5t27 78.5v668q0 53 -37.5 90.5t-90.5 37.5h-308l-136 -126q-36 -33 -36 -82v-296q0 -46 33 -77t79 -31t79 35t33 81v208h32v-208q0 -70 -57 -114q52 -8 86.5 -48.5t34.5 -93.5
-q0 -42 -23 -78t-61 -53l-310 -141h91z" />
-    <glyph glyph-name="_563" unicode="&#xf258;" horiz-adv-x="2048" 
-d="M1151 1536q61 0 116 -28t91 -77l572 -781q118 -159 118 -359v-355q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v177l-286 143h-546q-80 0 -136 56t-56 136v32q0 119 84.5 203.5t203.5 84.5h420l42 128h-686q-100 0 -173.5 67.5t-81.5 166.5q-65 79 -65 182v32
-q0 80 56 136t136 56h959zM1920 -64v355q0 157 -93 284l-573 781q-39 52 -103 52h-959q-26 0 -45 -19t-19 -45q0 -32 1.5 -49.5t9.5 -40.5t25 -43q10 31 35.5 50t56.5 19h832v-32h-832q-26 0 -45 -19t-19 -45q0 -44 3 -58q8 -44 44 -73t81 -29h640h91q40 0 68 -28t28 -68
-q0 -15 -5 -30l-64 -192q-10 -29 -35 -47.5t-56 -18.5h-443q-66 0 -113 -47t-47 -113v-32q0 -26 19 -45t45 -19h561q16 0 29 -7l317 -158q24 -13 38.5 -36t14.5 -50v-197q0 -26 19 -45t45 -19h384q26 0 45 19t19 45z" />
-    <glyph glyph-name="_564" unicode="&#xf259;" horiz-adv-x="2048" 
-d="M459 -256q-77 0 -137.5 47.5t-79.5 122.5l-101 401q-13 57 -13 108q0 45 -5 67l-116 477q-7 27 -7 57q0 93 62 161t155 78q17 85 82.5 139t152.5 54q83 0 148 -51.5t85 -132.5l83 -348l103 428q20 81 85 132.5t148 51.5q89 0 155.5 -57.5t80.5 -144.5q92 -10 152 -79
-t60 -162q0 -24 -7 -59l-123 -512q10 7 37.5 28.5t38.5 29.5t35 23t41 20.5t41.5 11t49.5 5.5q105 0 180 -74t75 -179q0 -62 -28.5 -118t-78.5 -94l-507 -380q-68 -51 -153 -51h-694zM1104 1408q-38 0 -68.5 -24t-39.5 -62l-164 -682h-127l-145 602q-9 38 -39.5 62t-68.5 24
-q-48 0 -80 -33t-32 -80q0 -15 3 -28l132 -547h-26l-99 408q-9 37 -40 62.5t-69 25.5q-47 0 -80 -33t-33 -79q0 -14 3 -26l116 -478q7 -28 9 -86t10 -88l100 -401q8 -32 34 -52.5t59 -20.5h694q42 0 76 26l507 379q56 43 56 110q0 52 -37.5 88.5t-89.5 36.5q-43 0 -77 -26
-l-307 -230v227q0 4 32 138t68 282t39 161q4 18 4 29q0 47 -32 81t-79 34q-39 0 -69.5 -24t-39.5 -62l-116 -482h-26l150 624q3 14 3 28q0 48 -31.5 82t-79.5 34z" />
-    <glyph glyph-name="_565" unicode="&#xf25a;" horiz-adv-x="1792" 
-d="M640 1408q-53 0 -90.5 -37.5t-37.5 -90.5v-512v-384l-151 202q-41 54 -107 54q-52 0 -89 -38t-37 -90q0 -43 26 -77l384 -512q38 -51 102 -51h718q22 0 39.5 13.5t22.5 34.5l92 368q24 96 24 194v217q0 41 -28 71t-68 30t-68 -28t-28 -68h-32v61q0 48 -32 81.5t-80 33.5
-q-46 0 -79 -33t-33 -79v-64h-32v90q0 55 -37 94.5t-91 39.5q-53 0 -90.5 -37.5t-37.5 -90.5v-96h-32v570q0 55 -37 94.5t-91 39.5zM640 1536q107 0 181.5 -77.5t74.5 -184.5v-220q22 2 32 2q99 0 173 -69q47 21 99 21q113 0 184 -87q27 7 56 7q94 0 159 -67.5t65 -161.5
-v-217q0 -116 -28 -225l-92 -368q-16 -64 -68 -104.5t-118 -40.5h-718q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 105 74.5 180.5t179.5 75.5q71 0 130 -35v547q0 106 75 181t181 75zM768 128v384h-32v-384h32zM1024 128v384h-32v-384h32zM1280 128v384h-32
-v-384h32z" />
-    <glyph glyph-name="_566" unicode="&#xf25b;" 
-d="M1288 889q60 0 107 -23q141 -63 141 -226v-177q0 -94 -23 -186l-85 -339q-21 -86 -90.5 -140t-157.5 -54h-668q-106 0 -181 75t-75 181v401l-239 628q-17 45 -17 91q0 106 75 181t181 75q80 0 145.5 -45.5t93.5 -119.5l17 -44v113q0 106 75 181t181 75t181 -75t75 -181
-v-261q27 5 48 5q69 0 127.5 -36.5t88.5 -98.5zM1072 896q-33 0 -60.5 -18t-41.5 -48l-74 -163l-71 -155h55q50 0 90 -31.5t50 -80.5l154 338q10 20 10 46q0 46 -33 79t-79 33zM1293 761q-22 0 -40.5 -8t-29 -16t-23.5 -29.5t-17 -30.5t-17 -37l-132 -290q-10 -20 -10 -46
-q0 -46 33 -79t79 -33q33 0 60.5 18t41.5 48l160 352q9 18 9 38q0 50 -32 81.5t-82 31.5zM128 1120q0 -22 8 -46l248 -650v-69l102 111q43 46 106 46h198l106 233v535q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5v-640h-64l-200 526q-14 37 -47 59.5t-73 22.5
-q-53 0 -90.5 -37.5t-37.5 -90.5zM1180 -128q44 0 78.5 27t45.5 70l85 339q19 73 19 155v91l-141 -310q-17 -38 -53 -61t-78 -23q-53 0 -93.5 34.5t-48.5 86.5q-44 -57 -114 -57h-208v32h208q46 0 81 33t35 79t-31 79t-77 33h-296q-49 0 -82 -36l-126 -136v-308
-q0 -53 37.5 -90.5t90.5 -37.5h668z" />
-    <glyph glyph-name="_567" unicode="&#xf25c;" horiz-adv-x="1973" 
-d="M857 992v-117q0 -13 -9.5 -22t-22.5 -9h-298v-812q0 -13 -9 -22.5t-22 -9.5h-135q-13 0 -22.5 9t-9.5 23v812h-297q-13 0 -22.5 9t-9.5 22v117q0 14 9 23t23 9h793q13 0 22.5 -9.5t9.5 -22.5zM1895 995l77 -961q1 -13 -8 -24q-10 -10 -23 -10h-134q-12 0 -21 8.5
-t-10 20.5l-46 588l-189 -425q-8 -19 -29 -19h-120q-20 0 -29 19l-188 427l-45 -590q-1 -12 -10 -20.5t-21 -8.5h-135q-13 0 -23 10q-9 10 -9 24l78 961q1 12 10 20.5t21 8.5h142q20 0 29 -19l220 -520q10 -24 20 -51q3 7 9.5 24.5t10.5 26.5l221 520q9 19 29 19h141
-q13 0 22 -8.5t10 -20.5z" />
-    <glyph glyph-name="_568" unicode="&#xf25d;" horiz-adv-x="1792" 
-d="M1042 833q0 88 -60 121q-33 18 -117 18h-123v-281h162q66 0 102 37t36 105zM1094 548l205 -373q8 -17 -1 -31q-8 -16 -27 -16h-152q-20 0 -28 17l-194 365h-155v-350q0 -14 -9 -23t-23 -9h-134q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h294q128 0 190 -24q85 -31 134 -109
-t49 -180q0 -92 -42.5 -165.5t-115.5 -109.5q6 -10 9 -16zM896 1376q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM1792 640
-q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_569" unicode="&#xf25e;" horiz-adv-x="1792" 
-d="M605 303q153 0 257 104q14 18 3 36l-45 82q-6 13 -24 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13.5t-23.5 -14.5t-28.5 -13t-33.5 -9.5t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78
-q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-148 0 -246 -96.5t-98 -240.5q0 -146 97 -241.5t247 -95.5zM1235 303q153 0 257 104q14 18 4 36l-45 82q-8 14 -25 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13.5t-23.5 -14.5t-28.5 -13t-33.5 -9.5
-t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-147 0 -245.5 -96.5t-98.5 -240.5q0 -146 97 -241.5t247 -95.5zM896 1376
-q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191
-t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71z" />
-    <glyph glyph-name="f260" unicode="&#xf260;" horiz-adv-x="2048" 
-d="M736 736l384 -384l-384 -384l-672 672l672 672l168 -168l-96 -96l-72 72l-480 -480l480 -480l193 193l-289 287zM1312 1312l672 -672l-672 -672l-168 168l96 96l72 -72l480 480l-480 480l-193 -193l289 -287l-96 -96l-384 384z" />
-    <glyph glyph-name="f261" unicode="&#xf261;" horiz-adv-x="1792" 
-d="M717 182l271 271l-279 279l-88 -88l192 -191l-96 -96l-279 279l279 279l40 -40l87 87l-127 128l-454 -454zM1075 190l454 454l-454 454l-271 -271l279 -279l88 88l-192 191l96 96l279 -279l-279 -279l-40 40l-87 -88zM1792 640q0 -182 -71 -348t-191 -286t-286 -191
-t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_572" unicode="&#xf262;" horiz-adv-x="2304" 
-d="M651 539q0 -39 -27.5 -66.5t-65.5 -27.5q-39 0 -66.5 27.5t-27.5 66.5q0 38 27.5 65.5t66.5 27.5q38 0 65.5 -27.5t27.5 -65.5zM1805 540q0 -39 -27.5 -66.5t-66.5 -27.5t-66.5 27.5t-27.5 66.5t27.5 66t66.5 27t66.5 -27t27.5 -66zM765 539q0 79 -56.5 136t-136.5 57
-t-136.5 -56.5t-56.5 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM1918 540q0 80 -56.5 136.5t-136.5 56.5q-79 0 -136 -56.5t-57 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM850 539q0 -116 -81.5 -197.5t-196.5 -81.5q-116 0 -197.5 82t-81.5 197
-t82 196.5t197 81.5t196.5 -81.5t81.5 -196.5zM2004 540q0 -115 -81.5 -196.5t-197.5 -81.5q-115 0 -196.5 81.5t-81.5 196.5t81.5 196.5t196.5 81.5q116 0 197.5 -81.5t81.5 -196.5zM1040 537q0 191 -135.5 326.5t-326.5 135.5q-125 0 -231 -62t-168 -168.5t-62 -231.5
-t62 -231.5t168 -168.5t231 -62q191 0 326.5 135.5t135.5 326.5zM1708 1110q-254 111 -556 111q-319 0 -573 -110q117 0 223 -45.5t182.5 -122.5t122 -183t45.5 -223q0 115 43.5 219.5t118 180.5t177.5 123t217 50zM2187 537q0 191 -135 326.5t-326 135.5t-326.5 -135.5
-t-135.5 -326.5t135.5 -326.5t326.5 -135.5t326 135.5t135 326.5zM1921 1103h383q-44 -51 -75 -114.5t-40 -114.5q110 -151 110 -337q0 -156 -77 -288t-209 -208.5t-287 -76.5q-133 0 -249 56t-196 155q-47 -56 -129 -179q-11 22 -53.5 82.5t-74.5 97.5
-q-80 -99 -196.5 -155.5t-249.5 -56.5q-155 0 -287 76.5t-209 208.5t-77 288q0 186 110 337q-9 51 -40 114.5t-75 114.5h365q149 100 355 156.5t432 56.5q224 0 421 -56t348 -157z" />
-    <glyph glyph-name="f263" unicode="&#xf263;" horiz-adv-x="1280" 
-d="M640 629q-188 0 -321 133t-133 320q0 188 133 321t321 133t321 -133t133 -321q0 -187 -133 -320t-321 -133zM640 1306q-92 0 -157.5 -65.5t-65.5 -158.5q0 -92 65.5 -157.5t157.5 -65.5t157.5 65.5t65.5 157.5q0 93 -65.5 158.5t-157.5 65.5zM1163 574q13 -27 15 -49.5
-t-4.5 -40.5t-26.5 -38.5t-42.5 -37t-61.5 -41.5q-115 -73 -315 -94l73 -72l267 -267q30 -31 30 -74t-30 -73l-12 -13q-31 -30 -74 -30t-74 30q-67 68 -267 268l-267 -268q-31 -30 -74 -30t-73 30l-12 13q-31 30 -31 73t31 74l267 267l72 72q-203 21 -317 94
-q-39 25 -61.5 41.5t-42.5 37t-26.5 38.5t-4.5 40.5t15 49.5q10 20 28 35t42 22t56 -2t65 -35q5 -4 15 -11t43 -24.5t69 -30.5t92 -24t113 -11q91 0 174 25.5t120 50.5l38 25q33 26 65 35t56 2t42 -22t28 -35z" />
-    <glyph glyph-name="_574" unicode="&#xf264;" 
-d="M927 956q0 -66 -46.5 -112.5t-112.5 -46.5t-112.5 46.5t-46.5 112.5t46.5 112.5t112.5 46.5t112.5 -46.5t46.5 -112.5zM1141 593q-10 20 -28 32t-47.5 9.5t-60.5 -27.5q-10 -8 -29 -20t-81 -32t-127 -20t-124 18t-86 36l-27 18q-31 25 -60.5 27.5t-47.5 -9.5t-28 -32
-q-22 -45 -2 -74.5t87 -73.5q83 -53 226 -67l-51 -52q-142 -142 -191 -190q-22 -22 -22 -52.5t22 -52.5l9 -9q22 -22 52.5 -22t52.5 22l191 191q114 -115 191 -191q22 -22 52.5 -22t52.5 22l9 9q22 22 22 52.5t-22 52.5l-191 190l-52 52q141 14 225 67q67 44 87 73.5t-2 74.5
-zM1092 956q0 134 -95 229t-229 95t-229 -95t-95 -229t95 -229t229 -95t229 95t95 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_575" unicode="&#xf265;" horiz-adv-x="1720" 
-d="M1565 1408q65 0 110 -45.5t45 -110.5v-519q0 -176 -68 -336t-182.5 -275t-274 -182.5t-334.5 -67.5q-176 0 -335.5 67.5t-274.5 182.5t-183 275t-68 336v519q0 64 46 110t110 46h1409zM861 344q47 0 82 33l404 388q37 35 37 85q0 49 -34.5 83.5t-83.5 34.5q-47 0 -82 -33
-l-323 -310l-323 310q-35 33 -81 33q-49 0 -83.5 -34.5t-34.5 -83.5q0 -51 36 -85l405 -388q33 -33 81 -33z" />
-    <glyph glyph-name="_576" unicode="&#xf266;" horiz-adv-x="2304" 
-d="M1494 -103l-295 695q-25 -49 -158.5 -305.5t-198.5 -389.5q-1 -1 -27.5 -0.5t-26.5 1.5q-82 193 -255.5 587t-259.5 596q-21 50 -66.5 107.5t-103.5 100.5t-102 43q0 5 -0.5 24t-0.5 27h583v-50q-39 -2 -79.5 -16t-66.5 -43t-10 -64q26 -59 216.5 -499t235.5 -540
-q31 61 140 266.5t131 247.5q-19 39 -126 281t-136 295q-38 69 -201 71v50l513 -1v-47q-60 -2 -93.5 -25t-12.5 -69q33 -70 87 -189.5t86 -187.5q110 214 173 363q24 55 -10 79.5t-129 26.5q1 7 1 25v24q64 0 170.5 0.5t180 1t92.5 0.5v-49q-62 -2 -119 -33t-90 -81
-l-213 -442q13 -33 127.5 -290t121.5 -274l441 1017q-14 38 -49.5 62.5t-65 31.5t-55.5 8v50l460 -4l1 -2l-1 -44q-139 -4 -201 -145q-526 -1216 -559 -1291h-49z" />
-    <glyph glyph-name="_577" unicode="&#xf267;" horiz-adv-x="1792" 
-d="M949 643q0 -26 -16.5 -45t-41.5 -19q-26 0 -45 16.5t-19 41.5q0 26 17 45t42 19t44 -16.5t19 -41.5zM964 585l350 581q-9 -8 -67.5 -62.5t-125.5 -116.5t-136.5 -127t-117 -110.5t-50.5 -51.5l-349 -580q7 7 67 62t126 116.5t136 127t117 111t50 50.5zM1611 640
-q0 -201 -104 -371q-3 2 -17 11t-26.5 16.5t-16.5 7.5q-13 0 -13 -13q0 -10 59 -44q-74 -112 -184.5 -190.5t-241.5 -110.5l-16 67q-1 10 -15 10q-5 0 -8 -5.5t-2 -9.5l16 -68q-72 -15 -146 -15q-199 0 -372 105q1 2 13 20.5t21.5 33.5t9.5 19q0 13 -13 13q-6 0 -17 -14.5
-t-22.5 -34.5t-13.5 -23q-113 75 -192 187.5t-110 244.5l69 15q10 3 10 15q0 5 -5.5 8t-10.5 2l-68 -15q-14 72 -14 139q0 206 109 379q2 -1 18.5 -12t30 -19t17.5 -8q13 0 13 12q0 6 -12.5 15.5t-32.5 21.5l-20 12q77 112 189 189t244 107l15 -67q2 -10 15 -10q5 0 8 5.5
-t2 10.5l-15 66q71 13 134 13q204 0 379 -109q-39 -56 -39 -65q0 -13 12 -13q11 0 48 64q111 -75 187.5 -186t107.5 -241l-56 -12q-10 -2 -10 -16q0 -5 5.5 -8t9.5 -2l57 13q14 -72 14 -140zM1696 640q0 163 -63.5 311t-170.5 255t-255 170.5t-311 63.5t-311 -63.5
-t-255 -170.5t-170.5 -255t-63.5 -311t63.5 -311t170.5 -255t255 -170.5t311 -63.5t311 63.5t255 170.5t170.5 255t63.5 311zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191
-t191 -286t71 -348z" />
-    <glyph glyph-name="_578" unicode="&#xf268;" horiz-adv-x="1792" 
-d="M893 1536q240 2 451 -120q232 -134 352 -372l-742 39q-160 9 -294 -74.5t-185 -229.5l-276 424q128 159 311 245.5t383 87.5zM146 1131l337 -663q72 -143 211 -217t293 -45l-230 -451q-212 33 -385 157.5t-272.5 316t-99.5 411.5q0 267 146 491zM1732 962
-q58 -150 59.5 -310.5t-48.5 -306t-153 -272t-246 -209.5q-230 -133 -498 -119l405 623q88 131 82.5 290.5t-106.5 277.5zM896 942q125 0 213.5 -88.5t88.5 -213.5t-88.5 -213.5t-213.5 -88.5t-213.5 88.5t-88.5 213.5t88.5 213.5t213.5 88.5z" />
-    <glyph glyph-name="_579" unicode="&#xf269;" horiz-adv-x="1792" 
-d="M903 -256q-283 0 -504.5 150.5t-329.5 398.5q-58 131 -67 301t26 332.5t111 312t179 242.5l-11 -281q11 14 68 15.5t70 -15.5q42 81 160.5 138t234.5 59q-54 -45 -119.5 -148.5t-58.5 -163.5q25 -8 62.5 -13.5t63 -7.5t68 -4t50.5 -3q15 -5 9.5 -45.5t-30.5 -75.5
-q-5 -7 -16.5 -18.5t-56.5 -35.5t-101 -34l15 -189l-139 67q-18 -43 -7.5 -81.5t36 -66.5t65.5 -41.5t81 -6.5q51 9 98 34.5t83.5 45t73.5 17.5q61 -4 89.5 -33t19.5 -65q-1 -2 -2.5 -5.5t-8.5 -12.5t-18 -15.5t-31.5 -10.5t-46.5 -1q-60 -95 -144.5 -135.5t-209.5 -29.5
-q74 -61 162.5 -82.5t168.5 -6t154.5 52t128 87.5t80.5 104q43 91 39 192.5t-37.5 188.5t-78.5 125q87 -38 137 -79.5t77 -112.5q15 170 -57.5 343t-209.5 284q265 -77 412 -279.5t151 -517.5q2 -127 -40.5 -255t-123.5 -238t-189 -196t-247.5 -135.5t-288.5 -49.5z" />
-    <glyph glyph-name="_580" unicode="&#xf26a;" horiz-adv-x="1792" 
-d="M1493 1308q-165 110 -359 110q-155 0 -293 -73t-240 -200q-75 -93 -119.5 -218t-48.5 -266v-42q4 -141 48.5 -266t119.5 -218q102 -127 240 -200t293 -73q194 0 359 110q-121 -108 -274.5 -168t-322.5 -60q-29 0 -43 1q-175 8 -333 82t-272 193t-181 281t-67 339
-q0 182 71 348t191 286t286 191t348 71h3q168 -1 320.5 -60.5t273.5 -167.5zM1792 640q0 -192 -77 -362.5t-213 -296.5q-104 -63 -222 -63q-137 0 -255 84q154 56 253.5 233t99.5 405q0 227 -99 404t-253 234q119 83 254 83q119 0 226 -65q135 -125 210.5 -295t75.5 -361z
-" />
-    <glyph glyph-name="_581" unicode="&#xf26b;" horiz-adv-x="1792" 
-d="M1792 599q0 -56 -7 -104h-1151q0 -146 109.5 -244.5t257.5 -98.5q99 0 185.5 46.5t136.5 130.5h423q-56 -159 -170.5 -281t-267.5 -188.5t-321 -66.5q-187 0 -356 83q-228 -116 -394 -116q-237 0 -237 263q0 115 45 275q17 60 109 229q199 360 475 606
-q-184 -79 -427 -354q63 274 283.5 449.5t501.5 175.5q30 0 45 -1q255 117 433 117q64 0 116 -13t94.5 -40.5t66.5 -76.5t24 -115q0 -116 -75 -286q101 -182 101 -390zM1722 1239q0 83 -53 132t-137 49q-108 0 -254 -70q121 -47 222.5 -131.5t170.5 -195.5q51 135 51 216z
-M128 2q0 -86 48.5 -132.5t134.5 -46.5q115 0 266 83q-122 72 -213.5 183t-137.5 245q-98 -205 -98 -332zM632 715h728q-5 142 -113 237t-251 95q-144 0 -251.5 -95t-112.5 -237z" />
-    <glyph glyph-name="_582" unicode="&#xf26c;" horiz-adv-x="2048" 
-d="M1792 288v960q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1248v-960q0 -66 -47 -113t-113 -47h-736v-128h352q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23
-v64q0 14 9 23t23 9h352v128h-736q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="_583" unicode="&#xf26d;" horiz-adv-x="1792" 
-d="M138 1408h197q-70 -64 -126 -149q-36 -56 -59 -115t-30 -125.5t-8.5 -120t10.5 -132t21 -126t28 -136.5q4 -19 6 -28q51 -238 81 -329q57 -171 152 -275h-272q-48 0 -82 34t-34 82v1304q0 48 34 82t82 34zM1346 1408h308q48 0 82 -34t34 -82v-1304q0 -48 -34 -82t-82 -34
-h-178q212 210 196 565l-469 -101q-2 -45 -12 -82t-31 -72t-59.5 -59.5t-93.5 -36.5q-123 -26 -199 40q-32 27 -53 61t-51.5 129t-64.5 258q-35 163 -45.5 263t-5.5 139t23 77q20 41 62.5 73t102.5 45q45 12 83.5 6.5t67 -17t54 -35t43 -48t34.5 -56.5l468 100
-q-68 175 -180 287z" />
-    <glyph glyph-name="_584" unicode="&#xf26e;" 
-d="M1401 -11l-6 -6q-113 -113 -259 -175q-154 -64 -317 -64q-165 0 -317 64q-148 63 -259 175q-113 112 -175 258q-42 103 -54 189q-4 28 48 36q51 8 56 -20q1 -1 1 -4q18 -90 46 -159q50 -124 152 -226q98 -98 226 -152q132 -56 276 -56q143 0 276 56q128 55 225 152l6 6
-q10 10 25 6q12 -3 33 -22q36 -37 17 -58zM929 604l-66 -66l63 -63q21 -21 -7 -49q-17 -17 -32 -17q-10 0 -19 10l-62 61l-66 -66q-5 -5 -15 -5q-15 0 -31 16l-2 2q-18 15 -18 29q0 7 8 17l66 65l-66 66q-16 16 14 45q18 18 31 18q6 0 13 -5l65 -66l65 65q18 17 48 -13
-q27 -27 11 -44zM1400 547q0 -118 -46 -228q-45 -105 -126 -186q-80 -80 -187 -126t-228 -46t-228 46t-187 126q-82 82 -125 186q-15 33 -15 40h-1q-9 27 43 44q50 16 60 -12q37 -99 97 -167h1v339v2q3 136 102 232q105 103 253 103q147 0 251 -103t104 -249
-q0 -147 -104.5 -251t-250.5 -104q-58 0 -112 16q-28 11 -13 61q16 51 44 43l14 -3q14 -3 33 -6t30 -3q104 0 176 71.5t72 174.5q0 101 -72 171q-71 71 -175 71q-107 0 -178 -80q-64 -72 -64 -160v-413q110 -67 242 -67q96 0 185 36.5t156 103.5t103.5 155t36.5 183
-q0 198 -141 339q-140 140 -339 140q-200 0 -340 -140q-53 -53 -77 -87l-2 -2q-8 -11 -13 -15.5t-21.5 -9.5t-38.5 3q-21 5 -36.5 16.5t-15.5 26.5v680q0 15 10.5 26.5t27.5 11.5h877q30 0 30 -55t-30 -55h-811v-483h1q40 42 102 84t108 61q109 46 231 46q121 0 228 -46
-t187 -126q81 -81 126 -186q46 -112 46 -229zM1369 1128q9 -8 9 -18t-5.5 -18t-16.5 -21q-26 -26 -39 -26q-9 0 -16 7q-106 91 -207 133q-128 56 -276 56q-133 0 -262 -49q-27 -10 -45 37q-9 25 -8 38q3 16 16 20q130 57 299 57q164 0 316 -64q137 -58 235 -152z" />
-    <glyph glyph-name="_585" unicode="&#xf270;" horiz-adv-x="1792" 
-d="M1551 60q15 6 26 3t11 -17.5t-15 -33.5q-13 -16 -44 -43.5t-95.5 -68t-141 -74t-188 -58t-229.5 -24.5q-119 0 -238 31t-209 76.5t-172.5 104t-132.5 105t-84 87.5q-8 9 -10 16.5t1 12t8 7t11.5 2t11.5 -4.5q192 -117 300 -166q389 -176 799 -90q190 40 391 135z
-M1758 175q11 -16 2.5 -69.5t-28.5 -102.5q-34 -83 -85 -124q-17 -14 -26 -9t0 24q21 45 44.5 121.5t6.5 98.5q-5 7 -15.5 11.5t-27 6t-29.5 2.5t-35 0t-31.5 -2t-31 -3t-22.5 -2q-6 -1 -13 -1.5t-11 -1t-8.5 -1t-7 -0.5h-5.5h-4.5t-3 0.5t-2 1.5l-1.5 3q-6 16 47 40t103 30
-q46 7 108 1t76 -24zM1364 618q0 -31 13.5 -64t32 -58t37.5 -46t33 -32l13 -11l-227 -224q-40 37 -79 75.5t-58 58.5l-19 20q-11 11 -25 33q-38 -59 -97.5 -102.5t-127.5 -63.5t-140 -23t-137.5 21t-117.5 65.5t-83 113t-31 162.5q0 84 28 154t72 116.5t106.5 83t122.5 57
-t130 34.5t119.5 18.5t99.5 6.5v127q0 65 -21 97q-34 53 -121 53q-6 0 -16.5 -1t-40.5 -12t-56 -29.5t-56 -59.5t-48 -96l-294 27q0 60 22 119t67 113t108 95t151.5 65.5t190.5 24.5q100 0 181 -25t129.5 -61.5t81 -83t45 -86t12.5 -73.5v-589zM692 597q0 -86 70 -133
-q66 -44 139 -22q84 25 114 123q14 45 14 101v162q-59 -2 -111 -12t-106.5 -33.5t-87 -71t-32.5 -114.5z" />
-    <glyph glyph-name="_586" unicode="&#xf271;" horiz-adv-x="1792" 
-d="M1536 1280q52 0 90 -38t38 -90v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128zM1152 1376v-288q0 -14 9 -23t23 -9
-h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 1376v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM1536 -128v1024h-1408v-1024h1408zM896 448h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224
-v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224z" />
-    <glyph glyph-name="_587" unicode="&#xf272;" horiz-adv-x="1792" 
-d="M1152 416v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23
-t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47
-t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_588" unicode="&#xf273;" horiz-adv-x="1792" 
-d="M1111 151l-46 -46q-9 -9 -22 -9t-23 9l-188 189l-188 -189q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22t9 23l189 188l-189 188q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l188 -188l188 188q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23l-188 -188l188 -188q9 -10 9 -23t-9 -22z
-M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280
-q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_589" unicode="&#xf274;" horiz-adv-x="1792" 
-d="M1303 572l-512 -512q-10 -9 -23 -9t-23 9l-288 288q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l220 -220l444 444q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23
-t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47
-t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_590" unicode="&#xf275;" horiz-adv-x="1792" 
-d="M448 1536q26 0 45 -19t19 -45v-891l536 429q17 14 40 14q26 0 45 -19t19 -45v-379l536 429q17 14 40 14q26 0 45 -19t19 -45v-1152q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h384z" />
-    <glyph glyph-name="_591" unicode="&#xf276;" horiz-adv-x="1024" 
-d="M512 448q66 0 128 15v-655q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v655q62 -15 128 -15zM512 1536q212 0 362 -150t150 -362t-150 -362t-362 -150t-362 150t-150 362t150 362t362 150zM512 1312q14 0 23 9t9 23t-9 23t-23 9q-146 0 -249 -103t-103 -249
-q0 -14 9 -23t23 -9t23 9t9 23q0 119 84.5 203.5t203.5 84.5z" />
-    <glyph glyph-name="_592" unicode="&#xf277;" horiz-adv-x="1792" 
-d="M1745 1239q10 -10 10 -23t-10 -23l-141 -141q-28 -28 -68 -28h-1344q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h576v64q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-64h512q40 0 68 -28zM768 320h256v-512q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v512zM1600 768
-q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-1344q-40 0 -68 28l-141 141q-10 10 -10 23t10 23l141 141q28 28 68 28h512v192h256v-192h576z" />
-    <glyph glyph-name="_593" unicode="&#xf278;" horiz-adv-x="2048" 
-d="M2020 1525q28 -20 28 -53v-1408q0 -20 -11 -36t-29 -23l-640 -256q-24 -11 -48 0l-616 246l-616 -246q-10 -5 -24 -5q-19 0 -36 11q-28 20 -28 53v1408q0 20 11 36t29 23l640 256q24 11 48 0l616 -246l616 246q32 13 60 -6zM736 1390v-1270l576 -230v1270zM128 1173
-v-1270l544 217v1270zM1920 107v1270l-544 -217v-1270z" />
-    <glyph glyph-name="_594" unicode="&#xf279;" horiz-adv-x="1792" 
-d="M512 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472q0 20 17 28l480 256q7 4 15 4zM1760 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472
-q0 20 17 28l480 256q7 4 15 4zM640 1536q8 0 14 -3l512 -256q18 -10 18 -29v-1472q0 -13 -9.5 -22.5t-22.5 -9.5q-8 0 -14 3l-512 256q-18 10 -18 29v1472q0 13 9.5 22.5t22.5 9.5z" />
-    <glyph glyph-name="_595" unicode="&#xf27a;" horiz-adv-x="1792" 
-d="M640 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 640q0 53 -37.5 90.5t-90.5 37.5
-t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-110 0 -211 18q-173 -173 -435 -229q-52 -10 -86 -13q-12 -1 -22 6t-13 18q-4 15 20 37q5 5 23.5 21.5t25.5 23.5t23.5 25.5t24 31.5t20.5 37
-t20 48t14.5 57.5t12.5 72.5q-146 90 -229.5 216.5t-83.5 269.5q0 174 120 321.5t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
-    <glyph glyph-name="_596" unicode="&#xf27b;" horiz-adv-x="1792" 
-d="M640 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 -53 -37.5 -90.5t-90.5 -37.5
-t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5
-t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51
-t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 130 71 248.5t191 204.5t286 136.5t348 50.5t348 -50.5t286 -136.5t191 -204.5t71 -248.5z" />
-    <glyph glyph-name="_597" unicode="&#xf27c;" horiz-adv-x="1024" 
-d="M512 345l512 295v-591l-512 -296v592zM0 640v-591l512 296zM512 1527v-591l-512 -296v591zM512 936l512 295v-591z" />
-    <glyph glyph-name="_598" unicode="&#xf27d;" horiz-adv-x="1792" 
-d="M1709 1018q-10 -236 -332 -651q-333 -431 -562 -431q-142 0 -240 263q-44 160 -132 482q-72 262 -157 262q-18 0 -127 -76l-77 98q24 21 108 96.5t130 115.5q156 138 241 146q95 9 153 -55.5t81 -203.5q44 -287 66 -373q55 -249 120 -249q51 0 154 161q101 161 109 246
-q13 139 -109 139q-57 0 -121 -26q120 393 459 382q251 -8 236 -326z" />
-    <glyph glyph-name="f27e" unicode="&#xf27e;" 
-d="M0 1408h1536v-1536h-1536v1536zM1085 293l-221 631l221 297h-634l221 -297l-221 -631l317 -304z" />
-    <glyph glyph-name="uniF280" unicode="&#xf280;" 
-d="M0 1408h1536v-1536h-1536v1536zM908 1088l-12 -33l75 -83l-31 -114l25 -25l107 57l107 -57l25 25l-31 114l75 83l-12 33h-95l-53 96h-32l-53 -96h-95zM641 925q32 0 44.5 -16t11.5 -63l174 21q0 55 -17.5 92.5t-50.5 56t-69 25.5t-85 7q-133 0 -199 -57.5t-66 -182.5v-72
-h-96v-128h76q20 0 20 -8v-382q0 -14 -5 -20t-18 -7l-73 -7v-88h448v86l-149 14q-6 1 -8.5 1.5t-3.5 2.5t-0.5 4t1 7t0.5 10v387h191l38 128h-231q-6 0 -2 6t4 9v80q0 27 1.5 40.5t7.5 28t19.5 20t36.5 5.5zM1248 96v86l-54 9q-7 1 -9.5 2.5t-2.5 3t1 7.5t1 12v520h-275
-l-23 -101l83 -22q23 -7 23 -27v-370q0 -14 -6 -18.5t-20 -6.5l-70 -9v-86h352z" />
-    <glyph glyph-name="uniF281" unicode="&#xf281;" horiz-adv-x="1792" 
-d="M1792 690q0 -58 -29.5 -105.5t-79.5 -72.5q12 -46 12 -96q0 -155 -106.5 -287t-290.5 -208.5t-400 -76.5t-399.5 76.5t-290 208.5t-106.5 287q0 47 11 94q-51 25 -82 73.5t-31 106.5q0 82 58 140.5t141 58.5q85 0 145 -63q218 152 515 162l116 521q3 13 15 21t26 5
-l369 -81q18 37 54 59.5t79 22.5q62 0 106 -43.5t44 -105.5t-44 -106t-106 -44t-105.5 43.5t-43.5 105.5l-334 74l-104 -472q300 -9 519 -160q58 61 143 61q83 0 141 -58.5t58 -140.5zM418 491q0 -62 43.5 -106t105.5 -44t106 44t44 106t-44 105.5t-106 43.5q-61 0 -105 -44
-t-44 -105zM1228 136q11 11 11 26t-11 26q-10 10 -25 10t-26 -10q-41 -42 -121 -62t-160 -20t-160 20t-121 62q-11 10 -26 10t-25 -10q-11 -10 -11 -25.5t11 -26.5q43 -43 118.5 -68t122.5 -29.5t91 -4.5t91 4.5t122.5 29.5t118.5 68zM1225 341q62 0 105.5 44t43.5 106
-q0 61 -44 105t-105 44q-62 0 -106 -43.5t-44 -105.5t44 -106t106 -44z" />
-    <glyph glyph-name="_602" unicode="&#xf282;" horiz-adv-x="1792" 
-d="M69 741h1q16 126 58.5 241.5t115 217t167.5 176t223.5 117.5t276.5 43q231 0 414 -105.5t294 -303.5q104 -187 104 -442v-188h-1125q1 -111 53.5 -192.5t136.5 -122.5t189.5 -57t213 -3t208 46.5t173.5 84.5v-377q-92 -55 -229.5 -92t-312.5 -38t-316 53
-q-189 73 -311.5 249t-124.5 372q-3 242 111 412t325 268q-48 -60 -78 -125.5t-46 -159.5h635q8 77 -8 140t-47 101.5t-70.5 66.5t-80.5 41t-75 20.5t-56 8.5l-22 1q-135 -5 -259.5 -44.5t-223.5 -104.5t-176 -140.5t-138 -163.5z" />
-    <glyph glyph-name="_603" unicode="&#xf283;" horiz-adv-x="2304" 
-d="M0 32v608h2304v-608q0 -66 -47 -113t-113 -47h-1984q-66 0 -113 47t-47 113zM640 256v-128h384v128h-384zM256 256v-128h256v128h-256zM2144 1408q66 0 113 -47t47 -113v-224h-2304v224q0 66 47 113t113 47h1984z" />
-    <glyph glyph-name="_604" unicode="&#xf284;" horiz-adv-x="1792" 
-d="M1584 246l-218 111q-74 -120 -196.5 -189t-263.5 -69q-147 0 -271 72t-196 196t-72 270q0 110 42.5 209.5t115 172t172 115t209.5 42.5q131 0 247.5 -60.5t192.5 -168.5l215 125q-110 169 -286.5 265t-378.5 96q-161 0 -308 -63t-253 -169t-169 -253t-63 -308t63 -308
-t169 -253t253 -169t308 -63q213 0 397.5 107t290.5 292zM1030 643l693 -352q-116 -253 -334.5 -400t-492.5 -147q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71q260 0 470.5 -133.5t335.5 -366.5zM1543 640h-39v-160h-96v352h136q32 0 54.5 -20
-t28.5 -48t1 -56t-27.5 -48t-57.5 -20z" />
-    <glyph glyph-name="uniF285" unicode="&#xf285;" horiz-adv-x="1792" 
-d="M1427 827l-614 386l92 151h855zM405 562l-184 116v858l1183 -743zM1424 697l147 -95v-858l-532 335zM1387 718l-500 -802h-855l356 571z" />
-    <glyph glyph-name="uniF286" unicode="&#xf286;" horiz-adv-x="1792" 
-d="M640 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1152 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1664 496v-752h-640v320q0 80 -56 136t-136 56t-136 -56t-56 -136v-320h-640v752q0 16 16 16h96
-q16 0 16 -16v-112h128v624q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 6 2.5 9.5t8.5 5t9.5 2t11.5 0t9 -0.5v391q-32 15 -32 50q0 23 16.5 39t38.5 16t38.5 -16t16.5 -39q0 -35 -32 -50v-17q45 10 83 10q21 0 59.5 -7.5t54.5 -7.5
-q17 0 47 7.5t37 7.5q16 0 16 -16v-210q0 -15 -35 -21.5t-62 -6.5q-18 0 -54.5 7.5t-55.5 7.5q-40 0 -90 -12v-133q1 0 9 0.5t11.5 0t9.5 -2t8.5 -5t2.5 -9.5v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-624h128v112q0 16 16 16h96
-q16 0 16 -16z" />
-    <glyph glyph-name="_607" unicode="&#xf287;" horiz-adv-x="2304" 
-d="M2288 731q16 -8 16 -27t-16 -27l-320 -192q-8 -5 -16 -5q-9 0 -16 4q-16 10 -16 28v128h-858q37 -58 83 -165q16 -37 24.5 -55t24 -49t27 -47t27 -34t31.5 -26t33 -8h96v96q0 14 9 23t23 9h320q14 0 23 -9t9 -23v-320q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v96h-96
-q-32 0 -61 10t-51 23.5t-45 40.5t-37 46t-33.5 57t-28.5 57.5t-28 60.5q-23 53 -37 81.5t-36 65t-44.5 53.5t-46.5 17h-360q-22 -84 -91 -138t-157 -54q-106 0 -181 75t-75 181t75 181t181 75q88 0 157 -54t91 -138h104q24 0 46.5 17t44.5 53.5t36 65t37 81.5q19 41 28 60.5
-t28.5 57.5t33.5 57t37 46t45 40.5t51 23.5t61 10h107q21 57 70 92.5t111 35.5q80 0 136 -56t56 -136t-56 -136t-136 -56q-62 0 -111 35.5t-70 92.5h-107q-17 0 -33 -8t-31.5 -26t-27 -34t-27 -47t-24 -49t-24.5 -55q-46 -107 -83 -165h1114v128q0 18 16 28t32 -1z" />
-    <glyph glyph-name="_608" unicode="&#xf288;" horiz-adv-x="1792" 
-d="M1150 774q0 -56 -39.5 -95t-95.5 -39h-253v269h253q56 0 95.5 -39.5t39.5 -95.5zM1329 774q0 130 -91.5 222t-222.5 92h-433v-896h180v269h253q130 0 222 91.5t92 221.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348
-t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_609" unicode="&#xf289;" horiz-adv-x="2304" 
-d="M1645 438q0 59 -34 106.5t-87 68.5q-7 -45 -23 -92q-7 -24 -27.5 -38t-44.5 -14q-12 0 -24 3q-31 10 -45 38.5t-4 58.5q23 71 23 143q0 123 -61 227.5t-166 165.5t-228 61q-134 0 -247 -73t-167 -194q108 -28 188 -106q22 -23 22 -55t-22 -54t-54 -22t-55 22
-q-75 75 -180 75q-106 0 -181 -74.5t-75 -180.5t75 -180.5t181 -74.5h1046q79 0 134.5 55.5t55.5 133.5zM1798 438q0 -142 -100.5 -242t-242.5 -100h-1046q-169 0 -289 119.5t-120 288.5q0 153 100 267t249 136q62 184 221 298t354 114q235 0 408.5 -158.5t196.5 -389.5
-q116 -25 192.5 -118.5t76.5 -214.5zM2048 438q0 -175 -97 -319q-23 -33 -64 -33q-24 0 -43 13q-26 17 -32 48.5t12 57.5q71 104 71 233t-71 233q-18 26 -12 57t32 49t57.5 11.5t49.5 -32.5q97 -142 97 -318zM2304 438q0 -244 -134 -443q-23 -34 -64 -34q-23 0 -42 13
-q-26 18 -32.5 49t11.5 57q108 164 108 358q0 195 -108 357q-18 26 -11.5 57.5t32.5 48.5q26 18 57 12t49 -33q134 -198 134 -442z" />
-    <glyph glyph-name="_610" unicode="&#xf28a;" 
-d="M1500 -13q0 -89 -63 -152.5t-153 -63.5t-153.5 63.5t-63.5 152.5q0 90 63.5 153.5t153.5 63.5t153 -63.5t63 -153.5zM1267 268q-115 -15 -192.5 -102.5t-77.5 -205.5q0 -74 33 -138q-146 -78 -379 -78q-109 0 -201 21t-153.5 54.5t-110.5 76.5t-76 85t-44.5 83
-t-23.5 66.5t-6 39.5q0 19 4.5 42.5t18.5 56t36.5 58t64 43.5t94.5 18t94 -17.5t63 -41t35.5 -53t17.5 -49t4 -33.5q0 -34 -23 -81q28 -27 82 -42t93 -17l40 -1q115 0 190 51t75 133q0 26 -9 48.5t-31.5 44.5t-49.5 41t-74 44t-93.5 47.5t-119.5 56.5q-28 13 -43 20
-q-116 55 -187 100t-122.5 102t-72 125.5t-20.5 162.5q0 78 20.5 150t66 137.5t112.5 114t166.5 77t221.5 28.5q120 0 220 -26t164.5 -67t109.5 -94t64 -105.5t19 -103.5q0 -46 -15 -82.5t-36.5 -58t-48.5 -36t-49 -19.5t-39 -5h-8h-32t-39 5t-44 14t-41 28t-37 46t-24 70.5
-t-10 97.5q-15 16 -59 25.5t-81 10.5l-37 1q-68 0 -117.5 -31t-70.5 -70t-21 -76q0 -24 5 -43t24 -46t53 -51t97 -53.5t150 -58.5q76 -25 138.5 -53.5t109 -55.5t83 -59t60.5 -59.5t41 -62.5t26.5 -62t14.5 -63.5t6 -62t1 -62.5z" />
-    <glyph glyph-name="_611" unicode="&#xf28b;" 
-d="M704 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1152 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103
-t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_612" unicode="&#xf28c;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273
-t73 -273t198 -198t273 -73zM864 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192z" />
-    <glyph glyph-name="_613" unicode="&#xf28d;" 
-d="M1088 352v576q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
-t103 -385.5z" />
-    <glyph glyph-name="_614" unicode="&#xf28e;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273
-t73 -273t198 -198t273 -73zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h576q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-576z" />
-    <glyph glyph-name="_615" unicode="&#xf290;" horiz-adv-x="1792" 
-d="M1757 128l35 -313q3 -28 -16 -50q-19 -21 -48 -21h-1664q-29 0 -48 21q-19 22 -16 50l35 313h1722zM1664 967l86 -775h-1708l86 775q3 24 21 40.5t43 16.5h256v-128q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5v128h384v-128q0 -53 37.5 -90.5t90.5 -37.5
-t90.5 37.5t37.5 90.5v128h256q25 0 43 -16.5t21 -40.5zM1280 1152v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 159 112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="_616" unicode="&#xf291;" horiz-adv-x="2048" 
-d="M1920 768q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5h-15l-115 -662q-8 -46 -44 -76t-82 -30h-1280q-46 0 -82 30t-44 76l-115 662h-15q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5h1792zM485 -32q26 2 43.5 22.5t15.5 46.5l-32 416q-2 26 -22.5 43.5
-t-46.5 15.5t-43.5 -22.5t-15.5 -46.5l32 -416q2 -25 20.5 -42t43.5 -17h5zM896 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1280 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1632 27l32 416
-q2 26 -15.5 46.5t-43.5 22.5t-46.5 -15.5t-22.5 -43.5l-32 -416q-2 -26 15.5 -46.5t43.5 -22.5h5q25 0 43.5 17t20.5 42zM476 1244l-93 -412h-132l101 441q19 88 89 143.5t160 55.5h167q0 26 19 45t45 19h384q26 0 45 -19t19 -45h167q90 0 160 -55.5t89 -143.5l101 -441
-h-132l-93 412q-11 44 -45.5 72t-79.5 28h-167q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45h-167q-45 0 -79.5 -28t-45.5 -72z" />
-    <glyph glyph-name="_617" unicode="&#xf292;" horiz-adv-x="1792" 
-d="M991 512l64 256h-254l-64 -256h254zM1759 1016l-56 -224q-7 -24 -31 -24h-327l-64 -256h311q15 0 25 -12q10 -14 6 -28l-56 -224q-5 -24 -31 -24h-327l-81 -328q-7 -24 -31 -24h-224q-16 0 -26 12q-9 12 -6 28l78 312h-254l-81 -328q-7 -24 -31 -24h-225q-15 0 -25 12
-q-9 12 -6 28l78 312h-311q-15 0 -25 12q-9 12 -6 28l56 224q7 24 31 24h327l64 256h-311q-15 0 -25 12q-10 14 -6 28l56 224q5 24 31 24h327l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h254l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h311
-q15 0 25 -12q9 -12 6 -28z" />
-    <glyph glyph-name="_618" unicode="&#xf293;" 
-d="M841 483l148 -148l-149 -149zM840 1094l149 -149l-148 -148zM710 -130l464 464l-306 306l306 306l-464 464v-611l-255 255l-93 -93l320 -321l-320 -321l93 -93l255 255v-611zM1429 640q0 -209 -32 -365.5t-87.5 -257t-140.5 -162.5t-181.5 -86.5t-219.5 -24.5
-t-219.5 24.5t-181.5 86.5t-140.5 162.5t-87.5 257t-32 365.5t32 365.5t87.5 257t140.5 162.5t181.5 86.5t219.5 24.5t219.5 -24.5t181.5 -86.5t140.5 -162.5t87.5 -257t32 -365.5z" />
-    <glyph glyph-name="_619" unicode="&#xf294;" horiz-adv-x="1024" 
-d="M596 113l173 172l-173 172v-344zM596 823l173 172l-173 172v-344zM628 640l356 -356l-539 -540v711l-297 -296l-108 108l372 373l-372 373l108 108l297 -296v711l539 -540z" />
-    <glyph glyph-name="_620" unicode="&#xf295;" 
-d="M1280 256q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM512 1024q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5
-t112.5 -271.5zM1440 1344q0 -20 -13 -38l-1056 -1408q-19 -26 -51 -26h-160q-26 0 -45 19t-19 45q0 20 13 38l1056 1408q19 26 51 26h160q26 0 45 -19t19 -45zM768 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5
-t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="_621" unicode="&#xf296;" horiz-adv-x="1792" 
-d="M104 830l792 -1015l-868 630q-18 13 -25 34.5t0 42.5l101 308v0zM566 830h660l-330 -1015v0zM368 1442l198 -612h-462l198 612q8 23 33 23t33 -23zM1688 830l101 -308q7 -21 0 -42.5t-25 -34.5l-868 -630l792 1015v0zM1688 830h-462l198 612q8 23 33 23t33 -23z" />
-    <glyph glyph-name="_622" unicode="&#xf297;" horiz-adv-x="1792" 
-d="M384 704h160v224h-160v-224zM1221 372v92q-104 -36 -243 -38q-135 -1 -259.5 46.5t-220.5 122.5l1 -96q88 -80 212 -128.5t272 -47.5q129 0 238 49zM640 704h640v224h-640v-224zM1792 736q0 -187 -99 -352q89 -102 89 -229q0 -157 -129.5 -268t-313.5 -111
-q-122 0 -225 52.5t-161 140.5q-19 -1 -57 -1t-57 1q-58 -88 -161 -140.5t-225 -52.5q-184 0 -313.5 111t-129.5 268q0 127 89 229q-99 165 -99 352q0 209 120 385.5t326.5 279.5t449.5 103t449.5 -103t326.5 -279.5t120 -385.5z" />
-    <glyph glyph-name="_623" unicode="&#xf298;" 
-d="M515 625v-128h-252v128h252zM515 880v-127h-252v127h252zM1273 369v-128h-341v128h341zM1273 625v-128h-672v128h672zM1273 880v-127h-672v127h672zM1408 20v1240q0 8 -6 14t-14 6h-32l-378 -256l-210 171l-210 -171l-378 256h-32q-8 0 -14 -6t-6 -14v-1240q0 -8 6 -14
-t14 -6h1240q8 0 14 6t6 14zM553 1130l185 150h-406zM983 1130l221 150h-406zM1536 1260v-1240q0 -62 -43 -105t-105 -43h-1240q-62 0 -105 43t-43 105v1240q0 62 43 105t105 43h1240q62 0 105 -43t43 -105z" />
-    <glyph glyph-name="_624" unicode="&#xf299;" horiz-adv-x="1792" 
-d="M896 720q-104 196 -160 278q-139 202 -347 318q-34 19 -70 36q-89 40 -94 32t34 -38l39 -31q62 -43 112.5 -93.5t94.5 -116.5t70.5 -113t70.5 -131q9 -17 13 -25q44 -84 84 -153t98 -154t115.5 -150t131 -123.5t148.5 -90.5q153 -66 154 -60q1 3 -49 37q-53 36 -81 57
-q-77 58 -179 211t-185 310zM549 177q-76 60 -132.5 125t-98 143.5t-71 154.5t-58.5 186t-52 209t-60.5 252t-76.5 289q273 0 497.5 -36t379 -92t271 -144.5t185.5 -172.5t110 -198.5t56 -199.5t12.5 -198.5t-9.5 -173t-20 -143.5t-13 -107l323 -327h-104l-281 285
-q-22 -2 -91.5 -14t-121.5 -19t-138 -6t-160.5 17t-167.5 59t-179 111z" />
-    <glyph glyph-name="_625" unicode="&#xf29a;" horiz-adv-x="1792" 
-d="M1374 879q-6 26 -28.5 39.5t-48.5 7.5q-261 -62 -401 -62t-401 62q-26 6 -48.5 -7.5t-28.5 -39.5t7.5 -48.5t39.5 -28.5q194 -46 303 -58q-2 -158 -15.5 -269t-26.5 -155.5t-41 -115.5l-9 -21q-10 -25 1 -49t36 -34q9 -4 23 -4q44 0 60 41l8 20q54 139 71 259h42
-q17 -120 71 -259l8 -20q16 -41 60 -41q14 0 23 4q25 10 36 34t1 49l-9 21q-28 71 -41 115.5t-26.5 155.5t-15.5 269q109 12 303 58q26 6 39.5 28.5t7.5 48.5zM1024 1024q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z
-M1600 640q0 -143 -55.5 -273.5t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5zM896 1408q-156 0 -298 -61t-245 -164t-164 -245t-61 -298t61 -298
-t164 -245t245 -164t298 -61t298 61t245 164t164 245t61 298t-61 298t-164 245t-245 164t-298 61zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_626" unicode="&#xf29b;" 
-d="M1438 723q34 -35 29 -82l-44 -551q-4 -42 -34.5 -70t-71.5 -28q-6 0 -9 1q-44 3 -72.5 36.5t-25.5 77.5l35 429l-143 -8q55 -113 55 -240q0 -216 -148 -372l-137 137q91 101 91 235q0 145 -102.5 248t-247.5 103q-134 0 -236 -92l-137 138q120 114 284 141l264 300
-l-149 87l-181 -161q-33 -30 -77 -27.5t-73 35.5t-26.5 77t34.5 73l239 213q26 23 60 26.5t64 -14.5l488 -283q36 -21 48 -68q17 -67 -26 -117l-205 -232l371 20q49 3 83 -32zM1240 1180q-74 0 -126 52t-52 126t52 126t126 52t126.5 -52t52.5 -126t-52.5 -126t-126.5 -52z
-M613 -62q106 0 196 61l139 -139q-146 -116 -335 -116q-148 0 -273.5 73t-198.5 198t-73 273q0 188 116 336l139 -139q-60 -88 -60 -197q0 -145 102.5 -247.5t247.5 -102.5z" />
-    <glyph glyph-name="_627" unicode="&#xf29c;" 
-d="M880 336v-160q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v160q0 14 9 23t23 9h160q14 0 23 -9t9 -23zM1136 832q0 -50 -15 -90t-45.5 -69t-52 -44t-59.5 -36q-32 -18 -46.5 -28t-26 -24t-11.5 -29v-32q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v68q0 35 10.5 64.5
-t24 47.5t39 35.5t41 25.5t44.5 21q53 25 75 43t22 49q0 42 -43.5 71.5t-95.5 29.5q-56 0 -95 -27q-29 -20 -80 -83q-9 -12 -25 -12q-11 0 -19 6l-108 82q-10 7 -12 20t5 23q122 192 349 192q129 0 238.5 -89.5t109.5 -214.5zM768 1280q-130 0 -248.5 -51t-204 -136.5
-t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5
-t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_628" unicode="&#xf29d;" horiz-adv-x="1408" 
-d="M366 1225q-64 0 -110 45.5t-46 110.5q0 64 46 109.5t110 45.5t109.5 -45.5t45.5 -109.5q0 -65 -45.5 -110.5t-109.5 -45.5zM917 583q0 -50 -30 -67.5t-63.5 -6.5t-47.5 34l-367 438q-7 12 -14 15.5t-11 1.5l-3 -3q-7 -8 4 -21l122 -139l1 -354l-161 -457
-q-67 -192 -92 -234q-15 -26 -28 -32q-50 -26 -103 -1q-29 13 -41.5 43t-9.5 57q2 17 197 618l5 416l-85 -164l35 -222q4 -24 -1 -42t-14 -27.5t-19 -16t-17 -7.5l-7 -2q-19 -3 -34.5 3t-24 16t-14 22t-7.5 19.5t-2 9.5l-46 299l211 381q23 34 113 34q75 0 107 -40l424 -521
-q7 -5 14 -17l3 -3l-1 -1q7 -13 7 -29zM514 433q43 -113 88.5 -225t69.5 -168l24 -55q36 -93 42 -125q11 -70 -36 -97q-35 -22 -66 -16t-51 22t-29 35h-1q-6 16 -8 25l-124 351zM1338 -159q31 -49 31 -57q0 -5 -3 -7q-9 -5 -14.5 0.5t-15.5 26t-16 30.5q-114 172 -423 661
-q3 -1 7 1t7 4l3 2q11 9 11 17z" />
-    <glyph glyph-name="_629" unicode="&#xf29e;" horiz-adv-x="2304" 
-d="M504 542h171l-1 265zM1530 641q0 87 -50.5 140t-146.5 53h-54v-388h52q91 0 145 57t54 138zM956 1018l1 -756q0 -14 -9.5 -24t-23.5 -10h-216q-14 0 -23.5 10t-9.5 24v62h-291l-55 -81q-10 -15 -28 -15h-267q-21 0 -30.5 18t3.5 35l556 757q9 14 27 14h332q14 0 24 -10
-t10 -24zM1783 641q0 -193 -125.5 -303t-324.5 -110h-270q-14 0 -24 10t-10 24v756q0 14 10 24t24 10h268q200 0 326 -109t126 -302zM1939 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5
-t-7.5 60t-20 91.5t-41 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2123 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-45 -108t-74 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5
-h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2304 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66 104.5t41 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96
-t9.5 -70.5z" />
-    <glyph glyph-name="uniF2A0" unicode="&#xf2a0;" horiz-adv-x="1408" 
-d="M617 -153q0 11 -13 58t-31 107t-20 69q-1 4 -5 26.5t-8.5 36t-13.5 21.5q-15 14 -51 14q-23 0 -70 -5.5t-71 -5.5q-34 0 -47 11q-6 5 -11 15.5t-7.5 20t-6.5 24t-5 18.5q-37 128 -37 255t37 255q1 4 5 18.5t6.5 24t7.5 20t11 15.5q13 11 47 11q24 0 71 -5.5t70 -5.5
-q36 0 51 14q9 8 13.5 21.5t8.5 36t5 26.5q2 9 20 69t31 107t13 58q0 22 -43.5 52.5t-75.5 42.5q-20 8 -45 8q-34 0 -98 -18q-57 -17 -96.5 -40.5t-71 -66t-46 -70t-45.5 -94.5q-6 -12 -9 -19q-49 -107 -68 -216t-19 -244t19 -244t68 -216q56 -122 83 -161q63 -91 179 -127
-l6 -2q64 -18 98 -18q25 0 45 8q32 12 75.5 42.5t43.5 52.5zM776 760q-26 0 -45 19t-19 45.5t19 45.5q37 37 37 90q0 52 -37 91q-19 19 -19 45t19 45t45 19t45 -19q75 -75 75 -181t-75 -181q-21 -19 -45 -19zM957 579q-27 0 -45 19q-19 19 -19 45t19 45q112 114 112 272
-t-112 272q-19 19 -19 45t19 45t45 19t45 -19q150 -150 150 -362t-150 -362q-18 -19 -45 -19zM1138 398q-27 0 -45 19q-19 19 -19 45t19 45q90 91 138.5 208t48.5 245t-48.5 245t-138.5 208q-19 19 -19 45t19 45t45 19t45 -19q109 -109 167 -249t58 -294t-58 -294t-167 -249
-q-18 -19 -45 -19z" />
-    <glyph glyph-name="uniF2A1" unicode="&#xf2a1;" horiz-adv-x="2176" 
-d="M192 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 352
-q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 864
-q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 1376q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 192q0 -80 -56 -136
-t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 1216q0 -80 -56 -136t-136 -56
-t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 192q0 -80 -56 -136t-136 -56t-136 56
-t-56 136t56 136t136 56t136 -56t56 -136zM1664 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136
-t56 136t136 56t136 -56t56 -136zM2176 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z" />
-    <glyph glyph-name="uniF2A2" unicode="&#xf2a2;" horiz-adv-x="1792" 
-d="M128 -192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM320 0q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM365 365l256 -256l-90 -90l-256 256zM704 384q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45z
-M1411 704q0 -59 -11.5 -108.5t-37.5 -93.5t-44 -67.5t-53 -64.5q-31 -35 -45.5 -54t-33.5 -50t-26.5 -64t-7.5 -74q0 -159 -112.5 -271.5t-271.5 -112.5q-26 0 -45 19t-19 45t19 45t45 19q106 0 181 75t75 181q0 57 11.5 105.5t37 91t43.5 66.5t52 63q40 46 59.5 72
-t37.5 74.5t18 103.5q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM896 576q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45
-t45 19t45 -19t19 -45zM1184 704q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 93 -65.5 158.5t-158.5 65.5q-92 0 -158 -65.5t-66 -158.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 146 103 249t249 103t249 -103t103 -249zM1578 993q10 -25 -1 -49t-36 -34q-9 -4 -23 -4
-q-19 0 -35.5 11t-23.5 30q-68 178 -224 295q-21 16 -25 42t12 47q17 21 43 25t47 -12q183 -137 266 -351zM1788 1074q9 -25 -1.5 -49t-35.5 -34q-11 -4 -23 -4q-44 0 -60 41q-92 238 -297 393q-22 16 -25.5 42t12.5 47q16 22 42 25.5t47 -12.5q235 -175 341 -449z" />
-    <glyph glyph-name="uniF2A3" unicode="&#xf2a3;" horiz-adv-x="2304" 
-d="M1032 576q-59 2 -84 55q-17 34 -48 53.5t-68 19.5q-53 0 -90.5 -37.5t-37.5 -90.5q0 -56 36 -89l10 -8q34 -31 82 -31q37 0 68 19.5t48 53.5q25 53 84 55zM1600 704q0 56 -36 89l-10 8q-34 31 -82 31q-37 0 -68 -19.5t-48 -53.5q-25 -53 -84 -55q59 -2 84 -55
-q17 -34 48 -53.5t68 -19.5q53 0 90.5 37.5t37.5 90.5zM1174 925q-17 -35 -55 -48t-73 4q-62 31 -134 31q-51 0 -99 -17q3 0 9.5 0.5t9.5 0.5q92 0 170.5 -50t118.5 -133q17 -36 3.5 -73.5t-49.5 -54.5q-18 -9 -39 -9q21 0 39 -9q36 -17 49.5 -54.5t-3.5 -73.5
-q-40 -83 -118.5 -133t-170.5 -50h-6q-16 2 -44 4l-290 27l-239 -120q-14 -7 -29 -7q-40 0 -57 35l-160 320q-11 23 -4 47.5t29 37.5l209 119l148 267q17 155 91.5 291.5t195.5 236.5q31 25 70.5 21.5t64.5 -34.5t21.5 -70t-34.5 -65q-70 -59 -117 -128q123 84 267 101
-q40 5 71.5 -19t35.5 -64q5 -40 -19 -71.5t-64 -35.5q-84 -10 -159 -55q46 10 99 10q115 0 218 -50q36 -18 49 -55.5t-5 -73.5zM2137 1085l160 -320q11 -23 4 -47.5t-29 -37.5l-209 -119l-148 -267q-17 -155 -91.5 -291.5t-195.5 -236.5q-26 -22 -61 -22q-45 0 -74 35
-q-25 31 -21.5 70t34.5 65q70 59 117 128q-123 -84 -267 -101q-4 -1 -12 -1q-36 0 -63.5 24t-31.5 60q-5 40 19 71.5t64 35.5q84 10 159 55q-46 -10 -99 -10q-115 0 -218 50q-36 18 -49 55.5t5 73.5q17 35 55 48t73 -4q62 -31 134 -31q51 0 99 17q-3 0 -9.5 -0.5t-9.5 -0.5
-q-92 0 -170.5 50t-118.5 133q-17 36 -3.5 73.5t49.5 54.5q18 9 39 9q-21 0 -39 9q-36 17 -49.5 54.5t3.5 73.5q40 83 118.5 133t170.5 50h6h1q14 -2 42 -4l291 -27l239 120q14 7 29 7q40 0 57 -35z" />
-    <glyph glyph-name="uniF2A4" unicode="&#xf2a4;" horiz-adv-x="1792" 
-d="M1056 704q0 -26 19 -45t45 -19t45 19t19 45q0 146 -103 249t-249 103t-249 -103t-103 -249q0 -26 19 -45t45 -19t45 19t19 45q0 93 66 158.5t158 65.5t158 -65.5t66 -158.5zM835 1280q-117 0 -223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5q0 -26 19 -45t45 -19t45 19
-t19 45q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -55 -18 -103.5t-37.5 -74.5t-59.5 -72q-34 -39 -52 -63t-43.5 -66.5t-37 -91t-11.5 -105.5q0 -106 -75 -181t-181 -75q-26 0 -45 -19t-19 -45t19 -45t45 -19q159 0 271.5 112.5t112.5 271.5q0 41 7.5 74
-t26.5 64t33.5 50t45.5 54q35 41 53 64.5t44 67.5t37.5 93.5t11.5 108.5q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5zM591 561l226 -226l-579 -579q-12 -12 -29 -12t-29 12l-168 168q-12 12 -12 29t12 29zM1612 1524l168 -168q12 -12 12 -29t-12 -30l-233 -233
-l-26 -25l-71 -71q-66 153 -195 258l91 91l207 207q13 12 30 12t29 -12z" />
-    <glyph glyph-name="uniF2A5" unicode="&#xf2a5;" 
-d="M866 1021q0 -27 -13 -94q-11 -50 -31.5 -150t-30.5 -150q-2 -11 -4.5 -12.5t-13.5 -2.5q-20 -2 -31 -2q-58 0 -84 49.5t-26 113.5q0 88 35 174t103 124q28 14 51 14q28 0 36.5 -16.5t8.5 -47.5zM1352 597q0 14 -39 75.5t-52 66.5q-21 8 -34 8q-91 0 -226 -77l-2 2
-q3 22 27.5 135t24.5 178q0 233 -242 233q-24 0 -68 -6q-94 -17 -168.5 -89.5t-111.5 -166.5t-37 -189q0 -146 80.5 -225t227.5 -79q25 0 25 -3t-1 -5q-4 -34 -26 -117q-14 -52 -51.5 -101t-82.5 -49q-42 0 -42 47q0 24 10.5 47.5t25 39.5t29.5 28.5t26 20t11 8.5q0 3 -7 10
-q-24 22 -58.5 36.5t-65.5 14.5q-35 0 -63.5 -34t-41 -75t-12.5 -75q0 -88 51.5 -142t138.5 -54q82 0 155 53t117.5 126t65.5 153q6 22 15.5 66.5t14.5 66.5q3 12 14 18q118 60 227 60q48 0 127 -18q1 -1 4 -1q5 0 9.5 4.5t4.5 8.5zM1536 1120v-960q0 -119 -84.5 -203.5
-t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="uniF2A6" unicode="&#xf2a6;" horiz-adv-x="1535" 
-d="M744 1231q0 24 -2 38.5t-8.5 30t-21 23t-37.5 7.5q-39 0 -78 -23q-105 -58 -159 -190.5t-54 -269.5q0 -44 8.5 -85.5t26.5 -80.5t52.5 -62.5t81.5 -23.5q4 0 18 -0.5t20 0t16 3t15 8.5t7 16q16 77 48 231.5t48 231.5q19 91 19 146zM1498 575q0 -7 -7.5 -13.5t-15.5 -6.5
-l-6 1q-22 3 -62 11t-72 12.5t-63 4.5q-167 0 -351 -93q-15 -8 -21 -27q-10 -36 -24.5 -105.5t-22.5 -100.5q-23 -91 -70 -179.5t-112.5 -164.5t-154.5 -123t-185 -47q-135 0 -214.5 83.5t-79.5 219.5q0 53 19.5 117t63 116.5t97.5 52.5q38 0 120 -33.5t83 -61.5
-q0 -1 -16.5 -12.5t-39.5 -31t-46 -44.5t-39 -61t-16 -74q0 -33 16.5 -53t48.5 -20q45 0 85 31.5t66.5 78t48 105.5t32.5 107t16 90v9q0 2 -3.5 3.5t-8.5 1.5h-10t-10 -0.5t-6 -0.5q-227 0 -352 122.5t-125 348.5q0 108 34.5 221t96 210t156 167.5t204.5 89.5q52 9 106 9
-q374 0 374 -360q0 -98 -38 -273t-43 -211l3 -3q101 57 182.5 88t167.5 31q22 0 53 -13q19 -7 80 -102.5t61 -116.5z" />
-    <glyph glyph-name="uniF2A7" unicode="&#xf2a7;" horiz-adv-x="1664" 
-d="M831 863q32 0 59 -18l222 -148q61 -40 110 -97l146 -170q40 -46 29 -106l-72 -413q-6 -32 -29.5 -53.5t-55.5 -25.5l-527 -56l-352 -32h-9q-39 0 -67.5 28t-28.5 68q0 37 27 64t65 32l260 32h-448q-41 0 -69.5 30t-26.5 71q2 39 32 65t69 26l442 1l-521 64q-41 5 -66 37
-t-19 73q6 35 34.5 57.5t65.5 22.5h10l481 -60l-351 94q-38 10 -62 41.5t-18 68.5q6 36 33 58.5t62 22.5q6 0 20 -2l448 -96l217 -37q1 0 3 -0.5t3 -0.5q23 0 30.5 23t-12.5 36l-186 125q-35 23 -42 63.5t18 73.5q27 38 76 38zM761 661l186 -125l-218 37l-5 2l-36 38
-l-238 262q-1 1 -2.5 3.5t-2.5 3.5q-24 31 -18.5 70t37.5 64q31 23 68 17.5t64 -33.5l142 -147q-2 -1 -5 -3.5t-4 -4.5q-32 -45 -23 -99t55 -85zM1648 1115l15 -266q4 -73 -11 -147l-48 -219q-12 -59 -67 -87l-106 -54q2 62 -39 109l-146 170q-53 61 -117 103l-222 148
-q-34 23 -76 23q-51 0 -88 -37l-235 312q-25 33 -18 73.5t41 63.5q33 22 71.5 14t62.5 -40l266 -352l-262 455q-21 35 -10.5 75t47.5 59q35 18 72.5 6t57.5 -46l241 -420l-136 337q-15 35 -4.5 74t44.5 56q37 19 76 6t56 -51l193 -415l101 -196q8 -15 23 -17.5t27 7.5t11 26
-l-12 224q-2 41 26 71t69 31q39 0 67 -28.5t30 -67.5z" />
-    <glyph glyph-name="uniF2A8" unicode="&#xf2a8;" horiz-adv-x="1792" 
-d="M335 180q-2 0 -6 2q-86 57 -168.5 145t-139.5 180q-21 30 -21 69q0 9 2 19t4 18t7 18t8.5 16t10.5 17t10 15t12 15.5t11 14.5q184 251 452 365q-110 198 -110 211q0 19 17 29q116 64 128 64q18 0 28 -16l124 -229q92 19 192 19q266 0 497.5 -137.5t378.5 -369.5
-q20 -31 20 -69t-20 -69q-91 -142 -218.5 -253.5t-278.5 -175.5q110 -198 110 -211q0 -20 -17 -29q-116 -64 -127 -64q-19 0 -29 16l-124 229l-64 119l-444 820l7 7q-58 -24 -99 -47q3 -5 127 -234t243 -449t119 -223q0 -7 -9 -9q-13 -3 -72 -3q-57 0 -60 7l-456 841
-q-39 -28 -82 -68q24 -43 214 -393.5t190 -354.5q0 -10 -11 -10q-14 0 -82.5 22t-72.5 28l-106 197l-224 413q-44 -53 -78 -106q2 -3 18 -25t23 -34l176 -327q0 -10 -10 -10zM1165 282l49 -91q273 111 450 385q-180 277 -459 389q67 -64 103 -148.5t36 -176.5
-q0 -106 -47 -200.5t-132 -157.5zM848 896q0 -20 14 -34t34 -14q86 0 147 -61t61 -147q0 -20 14 -34t34 -14t34 14t14 34q0 126 -89 215t-215 89q-20 0 -34 -14t-14 -34zM1214 961l-9 4l7 -7z" />
-    <glyph glyph-name="uniF2A9" unicode="&#xf2a9;" horiz-adv-x="1280" 
-d="M1050 430q0 -215 -147 -374q-148 -161 -378 -161q-232 0 -378 161q-147 159 -147 374q0 147 68 270.5t189 196.5t268 73q96 0 182 -31q-32 -62 -39 -126q-66 28 -143 28q-167 0 -280.5 -123t-113.5 -291q0 -170 112.5 -288.5t281.5 -118.5t281 118.5t112 288.5
-q0 89 -32 166q66 13 123 49q41 -98 41 -212zM846 619q0 -192 -79.5 -345t-238.5 -253l-14 -1q-29 0 -62 5q83 32 146.5 102.5t99.5 154.5t58.5 189t30 192.5t7.5 178.5q0 69 -3 103q55 -160 55 -326zM791 947v-2q-73 214 -206 440q88 -59 142.5 -186.5t63.5 -251.5z
-M1035 744q-83 0 -160 75q218 120 290 247q19 37 21 56q-42 -94 -139.5 -166.5t-204.5 -97.5q-35 54 -35 113q0 37 17 79t43 68q46 44 157 74q59 16 106 58.5t74 100.5q74 -105 74 -253q0 -109 -24 -170q-32 -77 -88.5 -130.5t-130.5 -53.5z" />
-    <glyph glyph-name="uniF2AA" unicode="&#xf2aa;" 
-d="M1050 495q0 78 -28 147q-41 -25 -85 -34q22 -50 22 -114q0 -117 -77 -198.5t-193 -81.5t-193.5 81.5t-77.5 198.5q0 115 78 199.5t193 84.5q53 0 98 -19q4 43 27 87q-60 21 -125 21q-154 0 -257.5 -108.5t-103.5 -263.5t103.5 -261t257.5 -106t257.5 106.5t103.5 260.5z
-M872 850q2 -24 2 -71q0 -63 -5 -123t-20.5 -132.5t-40.5 -130t-68.5 -106t-100.5 -70.5q21 -3 42 -3h10q219 139 219 411q0 116 -38 225zM872 850q-4 80 -44 171.5t-98 130.5q92 -156 142 -302zM1207 955q0 102 -51 174q-41 -86 -124 -109q-69 -19 -109 -53.5t-40 -99.5
-q0 -40 24 -77q74 17 140.5 67t95.5 115q-4 -52 -74.5 -111.5t-138.5 -97.5q52 -52 110 -52q51 0 90 37t60 90q17 42 17 117zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
-t84.5 -203.5z" />
-    <glyph glyph-name="uniF2AB" unicode="&#xf2ab;" 
-d="M1279 388q0 22 -22 27q-67 15 -118 59t-80 108q-7 19 -7 25q0 15 19.5 26t43 17t43 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-12 0 -32 -8t-31 -8q-4 0 -12 2q5 95 5 114q0 79 -17 114q-36 78 -103 121.5t-152 43.5q-199 0 -275 -165q-17 -35 -17 -114q0 -19 5 -114
-q-4 -2 -14 -2q-12 0 -32 7.5t-30 7.5q-21 0 -38.5 -12t-17.5 -32q0 -21 19.5 -35.5t43 -20.5t43 -17t19.5 -26q0 -6 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -46 137 -68q2 -5 6 -26t11.5 -30.5t23.5 -9.5q12 0 37.5 4.5t39.5 4.5q35 0 67 -15t54 -32.5t57.5 -32.5
-t76.5 -15q43 0 79 15t57.5 32.5t53.5 32.5t67 15q14 0 39.5 -4t38.5 -4q16 0 23 10t11 30t6 25q137 22 137 68zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
-t103 -385.5z" />
-    <glyph glyph-name="uniF2AC" unicode="&#xf2ac;" horiz-adv-x="1664" 
-d="M848 1408q134 1 240.5 -68.5t163.5 -192.5q27 -58 27 -179q0 -47 -9 -191q14 -7 28 -7q18 0 51 13.5t51 13.5q29 0 56 -18t27 -46q0 -32 -31.5 -54t-69 -31.5t-69 -29t-31.5 -47.5q0 -15 12 -43q37 -82 102.5 -150t144.5 -101q28 -12 80 -23q28 -6 28 -35
-q0 -70 -219 -103q-7 -11 -11 -39t-14 -46.5t-33 -18.5q-20 0 -62 6.5t-64 6.5q-37 0 -62 -5q-32 -5 -63 -22.5t-58 -38t-58 -40.5t-76 -33.5t-99 -13.5q-52 0 -96.5 13.5t-75 33.5t-57.5 40.5t-58 38t-62 22.5q-26 5 -63 5q-24 0 -65.5 -7.5t-58.5 -7.5q-25 0 -35 18.5
-t-14 47.5t-11 40q-219 33 -219 103q0 29 28 35q52 11 80 23q78 32 144.5 101t102.5 150q12 28 12 43q0 28 -31.5 47.5t-69.5 29.5t-69.5 31.5t-31.5 52.5q0 27 26 45.5t55 18.5q15 0 48 -13t53 -13q18 0 32 7q-9 142 -9 190q0 122 27 180q64 137 172 198t264 63z" />
-    <glyph glyph-name="uniF2AD" unicode="&#xf2ad;" 
-d="M1280 388q0 22 -22 27q-67 14 -118 58t-80 109q-7 14 -7 25q0 15 19.5 26t42.5 17t42.5 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-11 0 -31 -8t-32 -8q-4 0 -12 2q5 63 5 115q0 78 -17 114q-36 78 -102.5 121.5t-152.5 43.5q-198 0 -275 -165q-18 -38 -18 -115
-q0 -38 6 -114q-10 -2 -15 -2q-11 0 -31.5 8t-30.5 8q-20 0 -37.5 -12.5t-17.5 -32.5q0 -21 19.5 -35.5t42.5 -20.5t42.5 -17t19.5 -26q0 -11 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -47 138 -69q2 -5 6 -26t11 -30.5t23 -9.5q13 0 38.5 5t38.5 5q35 0 67.5 -15
-t54.5 -32.5t57.5 -32.5t76.5 -15q43 0 79 15t57.5 32.5t54 32.5t67.5 15q13 0 39 -4.5t39 -4.5q15 0 22.5 9.5t11.5 31t5 24.5q138 22 138 69zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960
-q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="uniF2AE" unicode="&#xf2ae;" horiz-adv-x="2304" 
-d="M2304 1536q-69 -46 -125 -92t-89 -81t-59.5 -71.5t-37.5 -57.5t-22 -44.5t-14 -29.5q-10 -18 -35.5 -136.5t-48.5 -164.5q-15 -29 -50 -60.5t-67.5 -50.5t-72.5 -41t-48 -28q-47 -31 -151 -231q-341 14 -630 -158q-92 -53 -303 -179q47 16 86 31t55 22l15 7
-q71 27 163 64.5t133.5 53.5t108 34.5t142.5 31.5q186 31 465 -7q1 0 10 -3q11 -6 14 -17t-3 -22l-194 -345q-15 -29 -47 -22q-128 24 -354 24q-146 0 -402 -44.5t-392 -46.5q-82 -1 -149 13t-107 37t-61 40t-33 34l-1 1v2q0 6 6 6q138 0 371 55q192 366 374.5 524t383.5 158
-q5 0 14.5 -0.5t38 -5t55 -12t61.5 -24.5t63 -39.5t54 -59t40 -82.5l102 177q2 4 21 42.5t44.5 86.5t61 109.5t84 133.5t100.5 137q66 82 128 141.5t121.5 96.5t92.5 53.5t88 39.5z" />
-    <glyph glyph-name="uniF2B0" unicode="&#xf2b0;" 
-d="M1322 640q0 -45 -5 -76l-236 14l224 -78q-19 -73 -58 -141l-214 103l177 -158q-44 -61 -107 -108l-157 178l103 -215q-61 -37 -140 -59l-79 228l14 -240q-38 -6 -76 -6t-76 6l14 238l-78 -226q-74 19 -140 59l103 215l-157 -178q-59 43 -108 108l178 158l-214 -104
-q-39 69 -58 141l224 79l-237 -14q-5 42 -5 76q0 35 5 77l238 -14l-225 79q19 73 58 140l214 -104l-177 159q46 61 107 108l158 -178l-103 215q67 39 140 58l77 -224l-13 236q36 6 75 6q38 0 76 -6l-14 -237l78 225q74 -19 140 -59l-103 -214l158 178q61 -47 107 -108
-l-177 -159l213 104q37 -62 58 -141l-224 -78l237 14q5 -31 5 -77zM1352 640q0 160 -78.5 295.5t-213 214t-292.5 78.5q-119 0 -227 -46.5t-186.5 -125t-124.5 -187.5t-46 -229q0 -119 46 -228t124.5 -187.5t186.5 -125t227 -46.5q158 0 292.5 78.5t213 214t78.5 294.5z
-M1425 1023v-766l-657 -383l-657 383v766l657 383zM768 -183l708 412v823l-708 411l-708 -411v-823zM1536 1088v-896l-768 -448l-768 448v896l768 448z" />
-    <glyph glyph-name="uniF2B1" unicode="&#xf2b1;" horiz-adv-x="1664" 
-d="M339 1318h691l-26 -72h-665q-110 0 -188.5 -79t-78.5 -189v-771q0 -95 60.5 -169.5t153.5 -93.5q23 -5 98 -5v-72h-45q-140 0 -239.5 100t-99.5 240v771q0 140 99.5 240t239.5 100zM1190 1536h247l-482 -1294q-23 -61 -40.5 -103.5t-45 -98t-54 -93.5t-64.5 -78.5
-t-79.5 -65t-95.5 -41t-116 -18.5v195q163 26 220 182q20 52 20 105q0 54 -20 106l-285 733h228l187 -585zM1664 978v-1111h-795q37 55 45 73h678v1038q0 85 -49.5 155t-129.5 99l25 67q101 -34 163.5 -123.5t62.5 -197.5z" />
-    <glyph glyph-name="uniF2B2" unicode="&#xf2b2;" horiz-adv-x="1792" 
-d="M852 1227q0 -29 -17 -52.5t-45 -23.5t-45 23.5t-17 52.5t17 52.5t45 23.5t45 -23.5t17 -52.5zM688 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50 -21.5t-20 -51.5v-114q0 -30 20.5 -52t49.5 -22q30 0 50.5 22t20.5 52zM860 -149v114q0 30 -20 51.5t-50 21.5t-50.5 -21.5
-t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22q29 0 49.5 22t20.5 52zM1034 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1208 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114
-q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1476 535q-84 -160 -232 -259.5t-323 -99.5q-123 0 -229.5 51.5t-178.5 137t-113 197.5t-41 232q0 88 21 174q-104 -175 -104 -390q0 -162 65 -312t185 -251q30 57 91 57q56 0 86 -50q32 50 87 50q56 0 86 -50q32 50 87 50t87 -50
-q30 50 86 50q28 0 52.5 -15.5t37.5 -40.5q112 94 177 231.5t73 287.5zM1326 564q0 75 -72 75q-17 0 -47 -6q-95 -19 -149 -19q-226 0 -226 243q0 86 30 204q-83 -127 -83 -275q0 -150 89 -260.5t235 -110.5q111 0 210 70q13 48 13 79zM884 1223q0 50 -32 89.5t-81 39.5
-t-81 -39.5t-32 -89.5q0 -51 31.5 -90.5t81.5 -39.5t81.5 39.5t31.5 90.5zM1513 884q0 96 -37.5 179t-113 137t-173.5 54q-77 0 -149 -35t-127 -94q-48 -159 -48 -268q0 -104 45.5 -157t147.5 -53q53 0 142 19q36 6 53 6q51 0 77.5 -28t26.5 -80q0 -26 -4 -46
-q75 68 117.5 165.5t42.5 200.5zM1792 667q0 -111 -33.5 -249.5t-93.5 -204.5q-58 -64 -195 -142.5t-228 -104.5l-4 -1v-114q0 -43 -29.5 -75t-72.5 -32q-56 0 -86 50q-32 -50 -87 -50t-87 50q-30 -50 -86 -50q-55 0 -87 50q-30 -50 -86 -50q-47 0 -75 33.5t-28 81.5
-q-90 -68 -198 -68q-118 0 -211 80q54 1 106 20q-113 31 -182 127q32 -7 71 -7q89 0 164 46q-192 192 -240 306q-24 56 -24 160q0 57 9 125.5t31.5 146.5t55 141t86.5 105t120 42q59 0 81 -52q19 29 42 54q2 3 12 13t13 16q10 15 23 38t25 42t28 39q87 111 211.5 177
-t260.5 66q35 0 62 -4q59 64 146 64q83 0 140 -57q5 -5 5 -12q0 -5 -6 -13.5t-12.5 -16t-16 -17l-10.5 -10.5q17 -6 36 -18t19 -24q0 -6 -16 -25q157 -138 197 -378q25 30 60 30q45 0 100 -49q90 -80 90 -279z" />
-    <glyph glyph-name="uniF2B3" unicode="&#xf2b3;" 
-d="M917 631q0 33 -6 64h-362v-132h217q-12 -76 -74.5 -120.5t-142.5 -44.5q-99 0 -169 71.5t-70 170.5t70 170.5t169 71.5q93 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585h109v110
-h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="uniF2B4" unicode="&#xf2b4;" 
-d="M1536 1024v-839q0 -48 -49 -62q-174 -52 -338 -52q-73 0 -215.5 29.5t-227.5 29.5q-164 0 -370 -48v-338h-160v1368q-63 25 -101 81t-38 124q0 91 64 155t155 64t155 -64t64 -155q0 -68 -38 -124t-101 -81v-68q190 44 343 44q99 0 198 -15q14 -2 111.5 -22.5t149.5 -20.5
-q77 0 165 18q11 2 80 21t89 19q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="uniF2B5" unicode="&#xf2b5;" horiz-adv-x="2304" 
-d="M192 384q40 0 56 32t0 64t-56 32t-56 -32t0 -64t56 -32zM1665 442q-10 13 -38.5 50t-41.5 54t-38 49t-42.5 53t-40.5 47t-45 49l-125 -140q-83 -94 -208.5 -92t-205.5 98q-57 69 -56.5 158t58.5 157l177 206q-22 11 -51 16.5t-47.5 6t-56.5 -0.5t-49 -1q-92 0 -158 -66
-l-158 -158h-155v-544q5 0 21 0.5t22 0t19.5 -2t20.5 -4.5t17.5 -8.5t18.5 -13.5l297 -292q115 -111 227 -111q78 0 125 47q57 -20 112.5 8t72.5 85q74 -6 127 44q20 18 36 45.5t14 50.5q10 -10 43 -10q43 0 77 21t49.5 53t12 71.5t-30.5 73.5zM1824 384h96v512h-93l-157 180
-q-66 76 -169 76h-167q-89 0 -146 -67l-209 -243q-28 -33 -28 -75t27 -75q43 -51 110 -52t111 49l193 218q25 23 53.5 21.5t47 -27t8.5 -56.5q16 -19 56 -63t60 -68q29 -36 82.5 -105.5t64.5 -84.5q52 -66 60 -140zM2112 384q40 0 56 32t0 64t-56 32t-56 -32t0 -64t56 -32z
-M2304 960v-640q0 -26 -19 -45t-45 -19h-434q-27 -65 -82 -106.5t-125 -51.5q-33 -48 -80.5 -81.5t-102.5 -45.5q-42 -53 -104.5 -81.5t-128.5 -24.5q-60 -34 -126 -39.5t-127.5 14t-117 53.5t-103.5 81l-287 282h-358q-26 0 -45 19t-19 45v672q0 26 19 45t45 19h421
-q14 14 47 48t47.5 48t44 40t50.5 37.5t51 25.5t62 19.5t68 5.5h117q99 0 181 -56q82 56 181 56h167q35 0 67 -6t56.5 -14.5t51.5 -26.5t44.5 -31t43 -39.5t39 -42t41 -48t41.5 -48.5h355q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="uniF2B6" unicode="&#xf2b6;" horiz-adv-x="1792" 
-d="M1792 882v-978q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v978q0 15 11 24q8 7 39 34.5t41.5 36t45.5 37.5t70 55.5t96 73t143.5 107t192.5 140.5q5 4 52.5 40t71.5 52.5t64 35t69 18.5t69 -18.5t65 -35.5t71 -52t52 -40q110 -80 192.5 -140.5t143.5 -107
-t96 -73t70 -55.5t45.5 -37.5t41.5 -36t39 -34.5q11 -9 11 -24zM1228 297q263 191 345 252q11 8 12.5 20.5t-6.5 23.5l-38 52q-8 11 -21 12.5t-24 -6.5q-231 -169 -343 -250q-5 -3 -52 -39t-71.5 -52.5t-64.5 -35t-69 -18.5t-69 18.5t-64.5 35t-71.5 52.5t-52 39
-q-186 134 -343 250q-11 8 -24 6.5t-21 -12.5l-38 -52q-8 -11 -6.5 -23.5t12.5 -20.5q82 -61 345 -252q10 -8 50 -38t65 -47t64 -39.5t77.5 -33.5t75.5 -11t75.5 11t79 34.5t64.5 39.5t65 47.5t48 36.5z" />
-    <glyph glyph-name="uniF2B7" unicode="&#xf2b7;" horiz-adv-x="1792" 
-d="M1474 623l39 -51q8 -11 6.5 -23.5t-11.5 -20.5q-43 -34 -126.5 -98.5t-146.5 -113t-67 -51.5q-39 -32 -60 -48t-60.5 -41t-76.5 -36.5t-74 -11.5h-1h-1q-37 0 -74 11.5t-76 36.5t-61 41.5t-60 47.5q-5 4 -65 50.5t-143.5 111t-122.5 94.5q-11 8 -12.5 20.5t6.5 23.5
-l37 52q8 11 21.5 13t24.5 -7q94 -73 306 -236q5 -4 43.5 -35t60.5 -46.5t56.5 -32.5t58.5 -17h1h1q24 0 58.5 17t56.5 32.5t60.5 46.5t43.5 35q258 198 313 242q11 8 24 6.5t21 -12.5zM1664 -96v928q-90 83 -159 139q-91 74 -389 304q-3 2 -43 35t-61 48t-56 32.5t-59 17.5
-h-1h-1q-24 0 -59 -17.5t-56 -32.5t-61 -48t-43 -35q-215 -166 -315.5 -245.5t-129.5 -104t-82 -74.5q-14 -12 -21 -19v-928q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 832v-928q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v928q0 56 41 94
-q123 114 350 290.5t233 181.5q36 30 59 47.5t61.5 42t76 36.5t74.5 12h1h1q37 0 74.5 -12t76 -36.5t61.5 -42t59 -47.5q43 -36 156 -122t226 -177t201 -173q41 -38 41 -94z" />
-    <glyph glyph-name="uniF2B8" unicode="&#xf2b8;" 
-d="M330 1l202 -214l-34 236l-216 213zM556 -225l274 218l-11 245l-300 -215zM245 413l227 -213l-48 327l-245 204zM495 189l317 214l-14 324l-352 -200zM843 178l95 -80l-2 239l-103 79q0 -1 1 -8.5t0 -12t-5 -7.5l-78 -52l85 -70q7 -6 7 -88zM138 930l256 -200l-68 465
-l-279 173zM1173 267l15 234l-230 -164l2 -240zM417 722l373 194l-19 441l-423 -163zM1270 357l20 233l-226 142l-2 -105l144 -95q6 -4 4 -9l-7 -119zM1461 496l30 222l-179 -128l-20 -228zM1273 329l-71 49l-8 -117q0 -5 -4 -8l-234 -187q-7 -5 -14 0l-98 83l7 -161
-q0 -5 -4 -8l-293 -234q-4 -2 -6 -2q-8 2 -8 3l-228 242q-4 4 -59 277q-2 7 5 11l61 37q-94 86 -95 92l-72 351q-2 7 6 12l94 45q-133 100 -135 108l-96 466q-2 10 7 13l433 135q5 0 8 -1l317 -153q6 -4 6 -9l20 -463q0 -7 -6 -10l-118 -61l126 -85q5 -2 5 -8l5 -123l121 74
-q5 4 11 0l84 -56l3 110q0 6 5 9l206 126q6 3 11 0l245 -135q4 -4 5 -7t-6.5 -60t-17.5 -124.5t-10 -70.5q0 -5 -4 -7l-191 -153q-6 -5 -13 0z" />
-    <glyph glyph-name="uniF2B9" unicode="&#xf2b9;" horiz-adv-x="1664" 
-d="M1201 298q0 57 -5.5 107t-21 100.5t-39.5 86t-64 58t-91 22.5q-6 -4 -33.5 -20.5t-42.5 -24.5t-40.5 -20t-49 -17t-46.5 -5t-46.5 5t-49 17t-40.5 20t-42.5 24.5t-33.5 20.5q-51 0 -91 -22.5t-64 -58t-39.5 -86t-21 -100.5t-5.5 -107q0 -73 42 -121.5t103 -48.5h576
-q61 0 103 48.5t42 121.5zM1028 892q0 108 -76.5 184t-183.5 76t-183.5 -76t-76.5 -184q0 -107 76.5 -183t183.5 -76t183.5 76t76.5 183zM1664 352v-192q0 -14 -9 -23t-23 -9h-96v-224q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h1216
-q66 0 113 -47t47 -113v-224h96q14 0 23 -9t9 -23v-192q0 -14 -9 -23t-23 -9h-96v-128h96q14 0 23 -9t9 -23v-192q0 -14 -9 -23t-23 -9h-96v-128h96q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="uniF2BA" unicode="&#xf2ba;" horiz-adv-x="1664" 
-d="M1028 892q0 -107 -76.5 -183t-183.5 -76t-183.5 76t-76.5 183q0 108 76.5 184t183.5 76t183.5 -76t76.5 -184zM980 672q46 0 82.5 -17t60 -47.5t39.5 -67t24 -81t11.5 -82.5t3.5 -79q0 -67 -39.5 -118.5t-105.5 -51.5h-576q-66 0 -105.5 51.5t-39.5 118.5q0 48 4.5 93.5
-t18.5 98.5t36.5 91.5t63 64.5t93.5 26h5q7 -4 32 -19.5t35.5 -21t33 -17t37 -16t35 -9t39.5 -4.5t39.5 4.5t35 9t37 16t33 17t35.5 21t32 19.5zM1664 928q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-128h96q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-128h96
-q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-224q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h1216q66 0 113 -47t47 -113v-224h96q13 0 22.5 -9.5t9.5 -22.5v-192zM1408 -96v1472q0 13 -9.5 22.5t-22.5 9.5h-1216
-q-13 0 -22.5 -9.5t-9.5 -22.5v-1472q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5z" />
-    <glyph glyph-name="uniF2BB" unicode="&#xf2bb;" horiz-adv-x="2048" 
-d="M1024 405q0 64 -9 117.5t-29.5 103t-60.5 78t-97 28.5q-6 -4 -30 -18t-37.5 -21.5t-35.5 -17.5t-43 -14.5t-42 -4.5t-42 4.5t-43 14.5t-35.5 17.5t-37.5 21.5t-30 18q-57 0 -97 -28.5t-60.5 -78t-29.5 -103t-9 -117.5t37 -106.5t91 -42.5h512q54 0 91 42.5t37 106.5z
-M867 925q0 94 -66.5 160.5t-160.5 66.5t-160.5 -66.5t-66.5 -160.5t66.5 -160.5t160.5 -66.5t160.5 66.5t66.5 160.5zM1792 416v64q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1792 676v56q0 15 -10.5 25.5t-25.5 10.5h-568
-q-15 0 -25.5 -10.5t-10.5 -25.5v-56q0 -15 10.5 -25.5t25.5 -10.5h568q15 0 25.5 10.5t10.5 25.5zM1792 928v64q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-352v96q0 14 -9 23t-23 9
-h-64q-14 0 -23 -9t-9 -23v-96h-768v96q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-96h-352q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2BC" unicode="&#xf2bc;" horiz-adv-x="2048" 
-d="M1024 405q0 -64 -37 -106.5t-91 -42.5h-512q-54 0 -91 42.5t-37 106.5t9 117.5t29.5 103t60.5 78t97 28.5q6 -4 30 -18t37.5 -21.5t35.5 -17.5t43 -14.5t42 -4.5t42 4.5t43 14.5t35.5 17.5t37.5 21.5t30 18q57 0 97 -28.5t60.5 -78t29.5 -103t9 -117.5zM867 925
-q0 -94 -66.5 -160.5t-160.5 -66.5t-160.5 66.5t-66.5 160.5t66.5 160.5t160.5 66.5t160.5 -66.5t66.5 -160.5zM1792 480v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM1792 732v-56q0 -15 -10.5 -25.5t-25.5 -10.5h-568
-q-15 0 -25.5 10.5t-10.5 25.5v56q0 15 10.5 25.5t25.5 10.5h568q15 0 25.5 -10.5t10.5 -25.5zM1792 992v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM1920 32v1216q0 13 -9.5 22.5t-22.5 9.5h-1728q-13 0 -22.5 -9.5
-t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h352v96q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-96h768v96q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-96h352q13 0 22.5 9.5t9.5 22.5zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-1728q-66 0 -113 47t-47 113v1216q0 66 47 113
-t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2BD" unicode="&#xf2bd;" horiz-adv-x="1792" 
-d="M1523 197q-22 155 -87.5 257.5t-184.5 118.5q-67 -74 -159.5 -115.5t-195.5 -41.5t-195.5 41.5t-159.5 115.5q-119 -16 -184.5 -118.5t-87.5 -257.5q106 -150 271 -237.5t356 -87.5t356 87.5t271 237.5zM1280 896q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5
-t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1792 640q0 -182 -71 -347.5t-190.5 -286t-285.5 -191.5t-349 -71q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2BE" unicode="&#xf2be;" horiz-adv-x="1792" 
-d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348q0 -181 -70.5 -347t-190.5 -286t-286 -191.5t-349 -71.5t-349 71t-285.5 191.5t-190.5 286t-71 347.5t71 348t191 286t286 191t348 71zM1515 185q149 205 149 455q0 156 -61 298t-164 245t-245 164t-298 61t-298 -61
-t-245 -164t-164 -245t-61 -298q0 -250 149 -455q66 327 306 327q131 -128 313 -128t313 128q240 0 306 -327zM1280 832q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5z" />
-    <glyph glyph-name="uniF2C0" unicode="&#xf2c0;" 
-d="M1201 752q47 -14 89.5 -38t89 -73t79.5 -115.5t55 -172t22 -236.5q0 -154 -100 -263.5t-241 -109.5h-854q-141 0 -241 109.5t-100 263.5q0 131 22 236.5t55 172t79.5 115.5t89 73t89.5 38q-79 125 -79 272q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5
-t198.5 -40.5t163.5 -109.5t109.5 -163.5t40.5 -198.5q0 -147 -79 -272zM768 1408q-159 0 -271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5zM1195 -128q88 0 150.5 71.5t62.5 173.5q0 239 -78.5 377t-225.5 145
-q-145 -127 -336 -127t-336 127q-147 -7 -225.5 -145t-78.5 -377q0 -102 62.5 -173.5t150.5 -71.5h854z" />
-    <glyph glyph-name="uniF2C1" unicode="&#xf2c1;" horiz-adv-x="1280" 
-d="M1024 278q0 -64 -37 -107t-91 -43h-512q-54 0 -91 43t-37 107t9 118t29.5 104t61 78.5t96.5 28.5q80 -75 188 -75t188 75q56 0 96.5 -28.5t61 -78.5t29.5 -104t9 -118zM870 797q0 -94 -67.5 -160.5t-162.5 -66.5t-162.5 66.5t-67.5 160.5t67.5 160.5t162.5 66.5
-t162.5 -66.5t67.5 -160.5zM1152 -96v1376h-1024v-1376q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1280 1376v-1472q0 -66 -47 -113t-113 -47h-960q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h352v-96q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v96h352
-q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2C2" unicode="&#xf2c2;" horiz-adv-x="2048" 
-d="M896 324q0 54 -7.5 100.5t-24.5 90t-51 68.5t-81 25q-64 -64 -156 -64t-156 64q-47 0 -81 -25t-51 -68.5t-24.5 -90t-7.5 -100.5q0 -55 31.5 -93.5t75.5 -38.5h426q44 0 75.5 38.5t31.5 93.5zM768 768q0 80 -56 136t-136 56t-136 -56t-56 -136t56 -136t136 -56t136 56
-t56 136zM1792 288v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1408 544v64q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1792 544v64q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23
-v-64q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1792 800v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM128 1152h1792v96q0 14 -9 23t-23 9h-1728q-14 0 -23 -9t-9 -23v-96zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-1728
-q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2C3" unicode="&#xf2c3;" horiz-adv-x="2048" 
-d="M896 324q0 -55 -31.5 -93.5t-75.5 -38.5h-426q-44 0 -75.5 38.5t-31.5 93.5q0 54 7.5 100.5t24.5 90t51 68.5t81 25q64 -64 156 -64t156 64q47 0 81 -25t51 -68.5t24.5 -90t7.5 -100.5zM768 768q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z
-M1792 352v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704q14 0 23 -9t9 -23zM1408 608v-64q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h320q14 0 23 -9t9 -23zM1792 608v-64q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v64
-q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 864v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704q14 0 23 -9t9 -23zM1920 32v1120h-1792v-1120q0 -13 9.5 -22.5t22.5 -9.5h1728q13 0 22.5 9.5t9.5 22.5zM2048 1248v-1216q0 -66 -47 -113t-113 -47
-h-1728q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2C4" unicode="&#xf2c4;" horiz-adv-x="1792" 
-d="M1255 749q0 318 -105 474.5t-330 156.5q-222 0 -326 -157t-104 -474q0 -316 104 -471.5t326 -155.5q74 0 131 17q-22 43 -39 73t-44 65t-53.5 56.5t-63 36t-77.5 14.5q-46 0 -79 -16l-49 97q105 91 276 91q132 0 215.5 -54t150.5 -155q67 149 67 402zM1645 117h117
-q3 -27 -2 -67t-26.5 -95t-58 -100.5t-107 -78t-162.5 -32.5q-71 0 -130.5 19t-105.5 56t-79 78t-66 96q-97 -27 -205 -27q-150 0 -292.5 58t-253 158.5t-178 249t-67.5 317.5q0 170 67.5 319.5t178.5 250.5t253.5 159t291.5 58q121 0 238.5 -36t217 -106t176 -164.5
-t119.5 -219t43 -261.5q0 -190 -80.5 -347.5t-218.5 -264.5q47 -70 93.5 -106.5t104.5 -36.5q61 0 94 37.5t38 85.5z" />
-    <glyph glyph-name="uniF2C5" unicode="&#xf2c5;" horiz-adv-x="2304" 
-d="M453 -101q0 -21 -16 -37.5t-37 -16.5q-1 0 -13 3q-63 15 -162 140q-225 284 -225 676q0 341 213 614q39 51 95 103.5t94 52.5q19 0 35 -13.5t16 -32.5q0 -27 -63 -90q-98 -102 -147 -184q-119 -199 -119 -449q0 -281 123 -491q50 -85 136 -173q2 -3 14.5 -16t19.5 -21
-t17 -20.5t14.5 -23.5t4.5 -21zM1796 33q0 -29 -17.5 -48.5t-46.5 -19.5h-1081q-26 0 -45 19t-19 45q0 29 17.5 48.5t46.5 19.5h1081q26 0 45 -19t19 -45zM1581 644q0 -134 -67 -233q-25 -38 -69.5 -78.5t-83.5 -60.5q-16 -10 -27 -10q-7 0 -15 6t-8 12q0 9 19 30t42 46
-t42 67.5t19 88.5q0 76 -35 130q-29 42 -46 42q-3 0 -3 -5q0 -12 7.5 -35.5t7.5 -36.5q0 -22 -21.5 -35t-44.5 -13q-66 0 -66 76q0 15 1.5 44t1.5 44q0 25 -10 46q-13 25 -42 53.5t-51 28.5q-5 0 -7 -0.5t-3.5 -2.5t-1.5 -6q0 -2 16 -26t16 -54q0 -37 -19 -68t-46 -54
-t-53.5 -46t-45.5 -54t-19 -68q0 -98 42 -160q29 -43 79 -63q16 -5 17 -10q1 -2 1 -5q0 -16 -18 -16q-6 0 -33 11q-119 43 -195 139.5t-76 218.5q0 55 24.5 115.5t60 115t70.5 108.5t59.5 113.5t24.5 111.5q0 53 -25 94q-29 48 -56 64q-19 9 -19 21q0 20 41 20q50 0 110 -29
-q41 -19 71 -44.5t49.5 -51t33.5 -62.5t22 -69t16 -80q0 -1 3 -17.5t4.5 -25t5.5 -25t9 -27t11 -21.5t14.5 -16.5t18.5 -5.5q23 0 37 14t14 37q0 25 -20 67t-20 52t10 10q27 0 93 -70q72 -76 102.5 -156t30.5 -186zM2304 615q0 -274 -138 -503q-19 -32 -48 -72t-68 -86.5
-t-81 -77t-74 -30.5q-16 0 -31 15.5t-15 31.5q0 15 29 50.5t68.5 77t48.5 52.5q183 230 183 531q0 131 -20.5 235t-72.5 211q-58 119 -163 228q-2 3 -13 13.5t-16.5 16.5t-15 17.5t-15 20t-9.5 18.5t-4 19q0 19 16 35.5t35 16.5q70 0 196 -169q98 -131 146 -273t60 -314
-q2 -42 2 -64z" />
-    <glyph glyph-name="uniF2C6" unicode="&#xf2c6;" horiz-adv-x="1792" 
-d="M1189 229l147 693q9 44 -10.5 63t-51.5 7l-864 -333q-29 -11 -39.5 -25t-2.5 -26.5t32 -19.5l221 -69l513 323q21 14 32 6q7 -5 -4 -15l-415 -375v0v0l-16 -228q23 0 45 22l108 104l224 -165q64 -36 81 38zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71
-t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2C7" unicode="&#xf2c7;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v907h128v-907q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2C8" unicode="&#xf2c8;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v651h128v-651q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2C9" unicode="&#xf2c9;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v395h128v-395q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2CA" unicode="&#xf2ca;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v139h128v-139q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2CB" unicode="&#xf2cb;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 79 56 135.5t136 56.5t136 -56.5t56 -135.5zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5t93.5 226.5z
-M896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192v128h192z" />
-    <glyph glyph-name="uniF2CC" unicode="&#xf2cc;" horiz-adv-x="1920" 
-d="M1433 1287q10 -10 10 -23t-10 -23l-626 -626q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l44 44q-72 91 -81.5 207t46.5 215q-74 71 -176 71q-106 0 -181 -75t-75 -181v-1280h-256v1280q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5q106 0 201 -41
-t166 -115q94 39 197 24.5t185 -79.5l44 44q10 10 23 10t23 -10zM1344 1024q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1600 896q-26 0 -45 19t-19 45t19 45t45 19t45 -19t19 -45t-19 -45t-45 -19zM1856 1024q26 0 45 -19t19 -45t-19 -45t-45 -19
-t-45 19t-19 45t19 45t45 19zM1216 896q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1408 832q0 26 19 45t45 19t45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45zM1728 896q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 768
-q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1344 640q-26 0 -45 19t-19 45t19 45t45 19t45 -19t19 -45t-19 -45t-45 -19zM1600 768q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1216 512q-26 0 -45 19t-19 45t19 45t45 19t45 -19
-t19 -45t-19 -45t-45 -19zM1472 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 512q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1344 512q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1216 384
-q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 256q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19z" />
-    <glyph glyph-name="uniF2CD" unicode="&#xf2cd;" horiz-adv-x="1792" 
-d="M1664 448v-192q0 -169 -128 -286v-194q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v118q-63 -22 -128 -22h-768q-65 0 -128 22v-110q0 -17 -9.5 -28.5t-22.5 -11.5h-64q-13 0 -22.5 11.5t-9.5 28.5v186q-128 117 -128 286v192h1536zM704 864q0 -14 -9 -23t-23 -9t-23 9
-t-9 23t9 23t23 9t23 -9t9 -23zM768 928q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM704 992q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 992q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM768 1056q0 -14 -9 -23t-23 -9t-23 9
-t-9 23t9 23t23 9t23 -9t9 -23zM704 1120q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1792 608v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v640q0 106 75 181t181 75q108 0 184 -78q46 19 98 12t93 -39l22 22q11 11 22 0l42 -42
-q11 -11 0 -22l-314 -314q-11 -11 -22 0l-42 42q-11 11 0 22l22 22q-36 46 -40.5 104t23.5 108q-37 35 -88 35q-53 0 -90.5 -37.5t-37.5 -90.5v-640h1504q14 0 23 -9t9 -23zM896 1056q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 1120q0 -14 -9 -23t-23 -9
-t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM768 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM960 1120q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM896 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 1248q0 -14 -9 -23
-t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1024 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM960 1248q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1088 1248q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23z" />
-    <glyph glyph-name="uniF2CE" unicode="&#xf2ce;" 
-d="M994 344q0 -86 -17 -197q-31 -215 -55 -313q-22 -90 -152 -90t-152 90q-24 98 -55 313q-17 110 -17 197q0 168 224 168t224 -168zM1536 768q0 -240 -134 -434t-350 -280q-8 -3 -15 3t-6 15q7 48 10 66q4 32 6 47q1 9 9 12q159 81 255.5 234t96.5 337q0 180 -91 330.5
-t-247 234.5t-337 74q-124 -7 -237 -61t-193.5 -140.5t-128 -202t-46.5 -240.5q1 -184 99 -336.5t257 -231.5q7 -3 9 -12q3 -21 6 -45q1 -9 5 -32.5t6 -35.5q1 -9 -6.5 -15t-15.5 -2q-148 58 -261 169.5t-173.5 264t-52.5 319.5q7 143 66 273.5t154.5 227t225 157.5t272.5 70
-q164 10 315.5 -46.5t261 -160.5t175 -250.5t65.5 -308.5zM994 800q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5zM1282 768q0 -122 -53.5 -228.5t-146.5 -177.5q-8 -6 -16 -2t-10 14q-6 52 -29 92q-7 10 3 20
-q58 54 91 127t33 155q0 111 -58.5 204t-157.5 141.5t-212 36.5q-133 -15 -229 -113t-109 -231q-10 -92 23.5 -176t98.5 -144q10 -10 3 -20q-24 -41 -29 -93q-2 -9 -10 -13t-16 2q-95 74 -148.5 183t-51.5 234q3 131 69 244t177 181.5t241 74.5q144 7 268 -60t196.5 -187.5
-t72.5 -263.5z" />
-    <glyph glyph-name="uniF2D0" unicode="&#xf2d0;" horiz-adv-x="1792" 
-d="M256 128h1280v768h-1280v-768zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D1" unicode="&#xf2d1;" horiz-adv-x="1792" 
-d="M1792 224v-192q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D2" unicode="&#xf2d2;" horiz-adv-x="2048" 
-d="M256 0h768v512h-768v-512zM1280 512h512v768h-768v-256h96q66 0 113 -47t47 -113v-352zM2048 1376v-960q0 -66 -47 -113t-113 -47h-608v-352q0 -66 -47 -113t-113 -47h-960q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h608v352q0 66 47 113t113 47h960q66 0 113 -47
-t47 -113z" />
-    <glyph glyph-name="uniF2D3" unicode="&#xf2d3;" horiz-adv-x="1792" 
-d="M1175 215l146 146q10 10 10 23t-10 23l-233 233l233 233q10 10 10 23t-10 23l-146 146q-10 10 -23 10t-23 -10l-233 -233l-233 233q-10 10 -23 10t-23 -10l-146 -146q-10 -10 -10 -23t10 -23l233 -233l-233 -233q-10 -10 -10 -23t10 -23l146 -146q10 -10 23 -10t23 10
-l233 233l233 -233q10 -10 23 -10t23 10zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D4" unicode="&#xf2d4;" horiz-adv-x="1792" 
-d="M1257 425l-146 -146q-10 -10 -23 -10t-23 10l-169 169l-169 -169q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l169 169l-169 169q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l169 -169l169 169q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23
-l-169 -169l169 -169q10 -10 10 -23t-10 -23zM256 128h1280v1024h-1280v-1024zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D5" unicode="&#xf2d5;" horiz-adv-x="1792" 
-d="M1070 358l306 564h-654l-306 -564h654zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2D6" unicode="&#xf2d6;" horiz-adv-x="1794" 
-d="M1291 1060q-15 17 -35 8.5t-26 -28.5t5 -38q14 -17 40 -14.5t34 20.5t-18 52zM895 814q-8 -8 -19.5 -8t-18.5 8q-8 8 -8 19t8 18q7 8 18.5 8t19.5 -8q7 -7 7 -18t-7 -19zM1060 740l-35 -35q-12 -13 -29.5 -13t-30.5 13l-38 38q-12 13 -12 30t12 30l35 35q12 12 29.5 12
-t30.5 -12l38 -39q12 -12 12 -29.5t-12 -29.5zM951 870q-7 -8 -18.5 -8t-19.5 8q-7 8 -7 19t7 19q8 8 19 8t19 -8t8 -19t-8 -19zM1354 968q-34 -64 -107.5 -85.5t-127.5 16.5q-38 28 -61 66.5t-21 87.5t39 92t75.5 53t70.5 -5t70 -51q2 -2 13 -12.5t14.5 -13.5t13 -13.5
-t12.5 -15.5t10 -15.5t8.5 -18t4 -18.5t1 -21t-5 -22t-9.5 -24zM1555 486q3 20 -8.5 34.5t-27.5 21.5t-33 17t-23 20q-40 71 -84 98.5t-113 11.5q19 13 40 18.5t33 4.5l12 -1q2 45 -34 90q6 20 6.5 40.5t-2.5 30.5l-3 10q43 24 71 65t34 91q10 84 -43 150.5t-137 76.5
-q-60 7 -114 -18.5t-82 -74.5q-30 -51 -33.5 -101t14.5 -87t43.5 -64t56.5 -42q-45 4 -88 36t-57 88q-28 108 32 222q-16 21 -29 32q-50 0 -89 -19q19 24 42 37t36 14l13 1q0 50 -13 78q-10 21 -32.5 28.5t-47 -3.5t-37.5 -40q2 4 4 7q-7 -28 -6.5 -75.5t19 -117t48.5 -122.5
-q-25 -14 -47 -36q-35 -16 -85.5 -70.5t-84.5 -101.5l-33 -46q-90 -34 -181 -125.5t-75 -162.5q1 -16 11 -27q-15 -12 -30 -30q-21 -25 -21 -54t21.5 -40t63.5 6q41 19 77 49.5t55 60.5q-2 2 -6.5 5t-20.5 7.5t-33 3.5q23 5 51 12.5t40 10t27.5 6t26 4t23.5 0.5q14 -7 22 34
-q7 37 7 90q0 102 -40 150q106 -103 101 -219q-1 -29 -15 -50t-27 -27l-13 -6q-4 -7 -19 -32t-26 -45.5t-26.5 -52t-25 -61t-17 -63t-6.5 -66.5t10 -63q-35 54 -37 80q-22 -24 -34.5 -39t-33.5 -42t-30.5 -46t-16.5 -41t-0.5 -38t25.5 -27q45 -25 144 64t190.5 221.5
-t122.5 228.5q86 52 145 115.5t86 119.5q47 -93 154 -178q104 -83 167 -80q39 2 46 43zM1794 640q0 -182 -71 -348t-191 -286t-286.5 -191t-348.5 -71t-348.5 71t-286.5 191t-191 286t-71 348t71 348t191 286t286.5 191t348.5 71t348.5 -71t286.5 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2D7" unicode="&#xf2d7;" 
-d="M518 1353v-655q103 -1 191.5 1.5t125.5 5.5l37 3q68 2 90.5 24.5t39.5 94.5l33 142h103l-14 -322l7 -319h-103l-29 127q-15 68 -45 93t-84 26q-87 8 -352 8v-556q0 -78 43.5 -115.5t133.5 -37.5h357q35 0 59.5 2t55 7.5t54 18t48.5 32t46 50.5t39 73l93 216h89
-q-6 -37 -31.5 -252t-30.5 -276q-146 5 -263.5 8t-162.5 4h-44h-628l-376 -12v102l127 25q67 13 91.5 37t25.5 79l8 643q3 402 -8 645q-2 61 -25.5 84t-91.5 36l-127 24v102l376 -12h702q139 0 374 27q-6 -68 -14 -194.5t-12 -219.5l-5 -92h-93l-32 124q-31 121 -74 179.5
-t-113 58.5h-548q-28 0 -35.5 -8.5t-7.5 -30.5z" />
-    <glyph glyph-name="uniF2D8" unicode="&#xf2d8;" 
-d="M922 739v-182q0 -4 0.5 -15t0 -15l-1.5 -12t-3.5 -11.5t-6.5 -7.5t-11 -5.5t-16 -1.5v309q9 0 16 -1t11 -5t6.5 -5.5t3.5 -9.5t1 -10.5v-13.5v-14zM1238 643v-121q0 -1 0.5 -12.5t0 -15.5t-2.5 -11.5t-7.5 -10.5t-13.5 -3q-9 0 -14 9q-4 10 -4 165v7v8.5v9t1.5 8.5l3.5 7
-t5 5.5t8 1.5q6 0 10 -1.5t6.5 -4.5t4 -6t2 -8.5t0.5 -8v-9.5v-9zM180 407h122v472h-122v-472zM614 407h106v472h-159l-28 -221q-20 148 -32 221h-158v-472h107v312l45 -312h76l43 319v-319zM1039 712q0 67 -5 90q-3 16 -11 28.5t-17 20.5t-25 14t-26.5 8.5t-31 4t-29 1.5
-h-29.5h-12h-91v-472h56q169 -1 197 24.5t25 180.5q-1 62 -1 100zM1356 515v133q0 29 -2 45t-9.5 33.5t-24.5 25t-46 7.5q-46 0 -77 -34v154h-117v-472h110l7 30q30 -36 77 -36q50 0 66 30.5t16 83.5zM1536 1248v-1216q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113
-v1216q0 66 47 113t113 47h1216q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D9" unicode="&#xf2d9;" horiz-adv-x="2176" 
-d="M1143 -197q-6 1 -11 4q-13 8 -36 23t-86 65t-116.5 104.5t-112 140t-89.5 172.5q-17 3 -175 37q66 -213 235 -362t391 -184zM502 409l168 -28q-25 76 -41 167.5t-19 145.5l-4 53q-84 -82 -121 -224q5 -65 17 -114zM612 1018q-43 -64 -77 -148q44 46 74 68zM2049 584
-q0 161 -62 307t-167.5 252t-250.5 168.5t-304 62.5q-147 0 -281 -52.5t-240 -148.5q-30 -58 -45 -160q60 51 143 83.5t158.5 43t143 13.5t108.5 -1l40 -3q33 -1 53 -15.5t24.5 -33t6.5 -37t-1 -28.5q-126 11 -227.5 0.5t-183 -43.5t-142.5 -71.5t-131 -98.5
-q4 -36 11.5 -92.5t35.5 -178t62 -179.5q123 -6 247.5 14.5t214.5 53.5t162.5 67t109.5 59l37 24q22 16 39.5 20.5t30.5 -5t17 -34.5q14 -97 -39 -121q-208 -97 -467 -134q-135 -20 -317 -16q41 -96 110 -176.5t137 -127t130.5 -79t101.5 -43.5l39 -12q143 -23 263 15
-q195 99 314 289t119 418zM2123 621q-14 -135 -40 -212q-70 -208 -181.5 -346.5t-318.5 -253.5q-48 -33 -82 -44q-72 -26 -163 -16q-36 -3 -73 -3q-283 0 -504.5 173t-295.5 442q-1 0 -4 0.5t-5 0.5q-6 -50 2.5 -112.5t26 -115t36 -98t31.5 -71.5l14 -26q8 -12 54 -82
-q-71 38 -124.5 106.5t-78.5 140t-39.5 137t-17.5 107.5l-2 42q-5 2 -33.5 12.5t-48.5 18t-53 20.5t-57.5 25t-50 25.5t-42.5 27t-25 25.5q19 -10 50.5 -25.5t113 -45.5t145.5 -38l2 32q11 149 94 290q41 202 176 365q28 115 81 214q15 28 32 45t49 32q158 74 303.5 104
-t302 11t306.5 -97q220 -115 333 -336t87 -474z" />
-    <glyph glyph-name="uniF2DA" unicode="&#xf2da;" horiz-adv-x="1792" 
-d="M1341 752q29 44 -6.5 129.5t-121.5 142.5q-58 39 -125.5 53.5t-118 4.5t-68.5 -37q-12 -23 -4.5 -28t42.5 -10q23 -3 38.5 -5t44.5 -9.5t56 -17.5q36 -13 67.5 -31.5t53 -37t40 -38.5t30.5 -38t22 -34.5t16.5 -28.5t12 -18.5t10.5 -6t11 9.5zM1704 178
-q-52 -127 -148.5 -220t-214.5 -141.5t-253 -60.5t-266 13.5t-251 91t-210 161.5t-141.5 235.5t-46.5 303.5q1 41 8.5 84.5t12.5 64t24 80.5t23 73q-51 -208 1 -397t173 -318t291 -206t346 -83t349 74.5t289 244.5q20 27 18 14q0 -4 -4 -14zM1465 627q0 -104 -40.5 -199
-t-108.5 -164t-162 -109.5t-198 -40.5t-198 40.5t-162 109.5t-108.5 164t-40.5 199t40.5 199t108.5 164t162 109.5t198 40.5t198 -40.5t162 -109.5t108.5 -164t40.5 -199zM1752 915q-65 147 -180.5 251t-253 153.5t-292 53.5t-301 -36.5t-275.5 -129t-220 -211.5t-131 -297
-t-10 -373q-49 161 -51.5 311.5t35.5 272.5t109 227t165.5 180.5t207 126t232 71t242.5 9t236 -54t216 -124.5t178 -197q33 -50 62 -121t31 -112zM1690 573q12 244 -136.5 416t-396.5 240q-8 0 -10 5t24 8q125 -4 230 -50t173 -120t116 -168.5t58.5 -199t-1 -208
-t-61.5 -197.5t-122.5 -167t-185 -117.5t-248.5 -46.5q108 30 201.5 80t174 123t129.5 176.5t55 225.5z" />
-    <glyph glyph-name="uniF2DB" unicode="&#xf2db;" 
-d="M192 256v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 512v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 768v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16
-q0 16 16 16h112zM192 1024v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 1280v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM1280 1440v-1472q0 -40 -28 -68t-68 -28h-832q-40 0 -68 28
-t-28 68v1472q0 40 28 68t68 28h832q40 0 68 -28t28 -68zM1536 208v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 464v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 720v-32
-q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 976v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 1232v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16
-h48q16 0 16 -16z" />
-    <glyph glyph-name="uniF2DC" unicode="&#xf2dc;" horiz-adv-x="1664" 
-d="M1566 419l-167 -33l186 -107q23 -13 29.5 -38.5t-6.5 -48.5q-14 -23 -39 -29.5t-48 6.5l-186 106l55 -160q13 -38 -12 -63.5t-60.5 -20.5t-48.5 42l-102 300l-271 156v-313l208 -238q16 -18 17 -39t-11 -36.5t-28.5 -25t-37 -5.5t-36.5 22l-112 128v-214q0 -26 -19 -45
-t-45 -19t-45 19t-19 45v214l-112 -128q-16 -18 -36.5 -22t-37 5.5t-28.5 25t-11 36.5t17 39l208 238v313l-271 -156l-102 -300q-13 -37 -48.5 -42t-60.5 20.5t-12 63.5l55 160l-186 -106q-23 -13 -48 -6.5t-39 29.5q-13 23 -6.5 48.5t29.5 38.5l186 107l-167 33
-q-29 6 -42 29t-8.5 46.5t25.5 40t50 10.5l310 -62l271 157l-271 157l-310 -62q-4 -1 -13 -1q-27 0 -44 18t-19 40t11 43t40 26l167 33l-186 107q-23 13 -29.5 38.5t6.5 48.5t39 30t48 -7l186 -106l-55 160q-13 38 12 63.5t60.5 20.5t48.5 -42l102 -300l271 -156v313
-l-208 238q-16 18 -17 39t11 36.5t28.5 25t37 5.5t36.5 -22l112 -128v214q0 26 19 45t45 19t45 -19t19 -45v-214l112 128q16 18 36.5 22t37 -5.5t28.5 -25t11 -36.5t-17 -39l-208 -238v-313l271 156l102 300q13 37 48.5 42t60.5 -20.5t12 -63.5l-55 -160l186 106
-q23 13 48 6.5t39 -29.5q13 -23 6.5 -48.5t-29.5 -38.5l-186 -107l167 -33q27 -5 40 -26t11 -43t-19 -40t-44 -18q-9 0 -13 1l-310 62l-271 -157l271 -157l310 62q29 6 50 -10.5t25.5 -40t-8.5 -46.5t-42 -29z" />
-    <glyph glyph-name="uniF2DD" unicode="&#xf2dd;" horiz-adv-x="1792" 
-d="M1473 607q7 118 -33 226.5t-113 189t-177 131t-221 57.5q-116 7 -225.5 -32t-192 -110.5t-135 -175t-59.5 -220.5q-7 -118 33 -226.5t113 -189t177.5 -131t221.5 -57.5q155 -9 293 59t224 195.5t94 283.5zM1792 1536l-349 -348q120 -117 180.5 -272t50.5 -321
-q-11 -183 -102 -339t-241 -255.5t-332 -124.5l-999 -132l347 347q-120 116 -180.5 271.5t-50.5 321.5q11 184 102 340t241.5 255.5t332.5 124.5q167 22 500 66t500 66z" />
-    <glyph glyph-name="uniF2DE" unicode="&#xf2de;" horiz-adv-x="1792" 
-d="M948 508l163 -329h-51l-175 350l-171 -350h-49l179 374l-78 33l21 49l240 -102l-21 -50zM563 1100l304 -130l-130 -304l-304 130zM907 915l240 -103l-103 -239l-239 102zM1188 765l191 -81l-82 -190l-190 81zM1680 640q0 159 -62 304t-167.5 250.5t-250.5 167.5t-304 62
-t-304 -62t-250.5 -167.5t-167.5 -250.5t-62 -304t62 -304t167.5 -250.5t250.5 -167.5t304 -62t304 62t250.5 167.5t167.5 250.5t62 304zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71
-t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2E0" unicode="&#xf2e0;" horiz-adv-x="1920" 
-d="M1334 302q-4 24 -27.5 34t-49.5 10.5t-48.5 12.5t-25.5 38q-5 47 33 139.5t75 181t32 127.5q-14 101 -117 103q-45 1 -75 -16l-3 -2l-5 -2.5t-4.5 -2t-5 -2t-5 -0.5t-6 1.5t-6 3.5t-6.5 5q-3 2 -9 8.5t-9 9t-8.5 7.5t-9.5 7.5t-9.5 5.5t-11 4.5t-11.5 2.5q-30 5 -48 -3
-t-45 -31q-1 -1 -9 -8.5t-12.5 -11t-15 -10t-16.5 -5.5t-17 3q-54 27 -84 40q-41 18 -94 -5t-76 -65q-16 -28 -41 -98.5t-43.5 -132.5t-40 -134t-21.5 -73q-22 -69 18.5 -119t110.5 -46q30 2 50.5 15t38.5 46q7 13 79 199.5t77 194.5q6 11 21.5 18t29.5 0q27 -15 21 -53
-q-2 -18 -51 -139.5t-50 -132.5q-6 -38 19.5 -56.5t60.5 -7t55 49.5q4 8 45.5 92t81.5 163.5t46 88.5q20 29 41 28q29 0 25 -38q-2 -16 -65.5 -147.5t-70.5 -159.5q-12 -53 13 -103t74 -74q17 -9 51 -15.5t71.5 -8t62.5 14t20 48.5zM383 86q3 -15 -5 -27.5t-23 -15.5
-q-14 -3 -26.5 5t-15.5 23q-3 14 5 27t22 16t27 -5t16 -23zM953 -177q12 -17 8.5 -37.5t-20.5 -32.5t-37.5 -8t-32.5 21q-11 17 -7.5 37.5t20.5 32.5t37.5 8t31.5 -21zM177 635q-18 -27 -49.5 -33t-57.5 13q-26 18 -32 50t12 58q18 27 49.5 33t57.5 -12q26 -19 32 -50.5
-t-12 -58.5zM1467 -42q19 -28 13 -61.5t-34 -52.5t-60.5 -13t-51.5 34t-13 61t33 53q28 19 60.5 13t52.5 -34zM1579 562q69 -113 42.5 -244.5t-134.5 -207.5q-90 -63 -199 -60q-20 -80 -84.5 -127t-143.5 -44.5t-140 57.5q-12 -9 -13 -10q-103 -71 -225 -48.5t-193 126.5
-q-50 73 -53 164q-83 14 -142.5 70.5t-80.5 128t-2 152t81 138.5q-36 60 -38 128t24.5 125t79.5 98.5t121 50.5q32 85 99 148t146.5 91.5t168 17t159.5 -66.5q72 21 140 17.5t128.5 -36t104.5 -80t67.5 -115t17.5 -140.5q52 -16 87 -57t45.5 -89t-5.5 -99.5t-58 -87.5z
-M455 1222q14 -20 9.5 -44.5t-24.5 -38.5q-19 -14 -43.5 -9.5t-37.5 24.5q-14 20 -9.5 44.5t24.5 38.5q19 14 43.5 9.5t37.5 -24.5zM614 1503q4 -16 -5 -30.5t-26 -18.5t-31 5.5t-18 26.5q-3 17 6.5 31t25.5 18q17 4 31 -5.5t17 -26.5zM1800 555q4 -20 -6.5 -37t-30.5 -21
-q-19 -4 -36 6.5t-21 30.5t6.5 37t30.5 22q20 4 36.5 -7.5t20.5 -30.5zM1136 1448q16 -27 8.5 -58.5t-35.5 -47.5q-27 -16 -57.5 -8.5t-46.5 34.5q-16 28 -8.5 59t34.5 48t58 9t47 -36zM1882 792q4 -15 -4 -27.5t-23 -16.5q-15 -3 -27.5 5.5t-15.5 22.5q-3 15 5 28t23 16
-q14 3 26.5 -5t15.5 -23zM1691 1033q15 -22 10.5 -49t-26.5 -43q-22 -15 -49 -10t-42 27t-10 49t27 43t48.5 11t41.5 -28z" />
-    <glyph glyph-name="uniF2E1" unicode="&#xf2e1;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E2" unicode="&#xf2e2;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E3" unicode="&#xf2e3;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E4" unicode="&#xf2e4;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E5" unicode="&#xf2e5;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E6" unicode="&#xf2e6;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E7" unicode="&#xf2e7;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="_698" unicode="&#xf2e8;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E9" unicode="&#xf2e9;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EA" unicode="&#xf2ea;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EB" unicode="&#xf2eb;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EC" unicode="&#xf2ec;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2ED" unicode="&#xf2ed;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EE" unicode="&#xf2ee;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="lessequal" unicode="&#xf500;" horiz-adv-x="1792" 
- />
-  </font>
-</defs></svg>
diff --git a/docs/fonts/fontawesome-webfont.ttf b/docs/fonts/fontawesome-webfont.ttf
deleted file mode 100644
index 35acda2..0000000
Binary files a/docs/fonts/fontawesome-webfont.ttf and /dev/null differ
diff --git a/docs/fonts/fontawesome-webfont.woff b/docs/fonts/fontawesome-webfont.woff
deleted file mode 100644
index 400014a..0000000
Binary files a/docs/fonts/fontawesome-webfont.woff and /dev/null differ
diff --git a/docs/fonts/fontawesome-webfont.woff2 b/docs/fonts/fontawesome-webfont.woff2
deleted file mode 100644
index 4d13fc6..0000000
Binary files a/docs/fonts/fontawesome-webfont.woff2 and /dev/null differ
diff --git a/docs/img/favicon.ico b/docs/img/favicon.ico
deleted file mode 100644
index e85006a..0000000
Binary files a/docs/img/favicon.ico and /dev/null differ
diff --git a/docs/img/grid.png b/docs/img/grid.png
deleted file mode 100644
index 878c3ed..0000000
Binary files a/docs/img/grid.png and /dev/null differ
diff --git a/docs/index.html b/docs/index.html
deleted file mode 100644
index 6cae9c8..0000000
--- a/docs/index.html
+++ /dev/null
@@ -1,412 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        <meta name="description" content="SOCI - The C++ Database Access Library">
-        
-        
-        <link rel="shortcut icon" href="img/favicon.ico">
-        <title>SOCI (4.0.3)</title>
-        <link href="css/bootstrap.min.css" rel="stylesheet">
-        <link href="css/font-awesome.min.css" rel="stylesheet">
-        <link href="css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="js/jquery-1.10.2.min.js" defer></script>
-        <script src="js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body class="homepage">
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href=".">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem active">
-                                <a href="." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" class="nav-link disabled">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="quickstart/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/index.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#soci-the-c-database-access-library" class="nav-link">SOCI - The C++ Database Access Library</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#basic-syntax" class="nav-link">Basic Syntax</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#basic-orm" class="nav-link">Basic ORM</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#integrations" class="nav-link">Integrations</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#database-backends" class="nav-link">Database Backends</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#language-bindings" class="nav-link">Language Bindings</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="soci-the-c-database-access-library">SOCI - The C++ Database Access Library</h1>
-<p>SOCI is a database access library written in C++ that makes an illusion of embedding
-SQL queries in the regular C++ code, staying entirely within the Standard C++.</p>
-<p>The idea is to provide C++ programmers a way to access SQL databases in the most natural and intuitive way.
-If you find existing libraries too difficult for your needs or just distracting, SOCI can be a good alternative.</p>
-<h2 id="basic-syntax">Basic Syntax</h2>
-<p>The simplest motivating code example for the SQL query that is supposed to retrieve a single row is:</p>
-<pre><code class="language-cpp">int id = ...;
-string name;
-int salary;
-
-sql &lt;&lt; &quot;select name, salary from persons where id = &quot; &lt;&lt; id,
-        into(name), into(salary);
-</code></pre>
-<h2 id="basic-orm">Basic ORM</h2>
-<p>The following benefits from extensive support for object-relational mapping:</p>
-<pre><code class="language-cpp">int id = ...;
-Person p;
-
-sql &lt;&lt; &quot;select first_name, last_name, date_of_birth &quot;
-       &quot;from persons where id = &quot; &lt;&lt; id, into(p);
-</code></pre>
-<h2 id="integrations">Integrations</h2>
-<p>Integration with STL is also supported:</p>
-<pre><code class="language-cpp">Rowset&lt;string&gt; rs = (sql.prepare &lt;&lt; &quot;select name from persons&quot;);
-std::copy(rs.begin(), rs.end(), std::ostream_iterator&lt;std::string&gt;(std::cout, &quot;\n&quot;));
-</code></pre>
-<p>SOCI offers also extensive <a href="boost/">integration with Boost</a> datatypes (optional, tuple and fusion) and flexible support for user-defined datatypes.</p>
-<h2 id="database-backends">Database Backends</h2>
-<p>Starting from its 2.0.0 release, SOCI uses the plug-in architecture for
-backends - this allows to target various database servers.</p>
-<p>Currently (SOCI 4.0.3), backends for following database systems are supported:</p>
-<ul>
-<li><a href="backends/db2/">DB2</a></li>
-<li><a href="backends/firebird/">Firebird</a></li>
-<li><a href="backends/mysql/">MySQL</a></li>
-<li><a href="backends/odbc/">ODBC</a> (generic backend)</li>
-<li><a href="backends/oracle/">Oracle</a></li>
-<li><a href="backends/postgresql/">PostgreSQL</a></li>
-<li><a href="backends/sqlite3/">SQLite3</a></li>
-</ul>
-<p>The intent of the library is to cover as many database technologies as possible.
-For this, the project has to rely on volunteer contributions from other programmers,
-who have expertise with the existing database interfaces and would like to help
-writing dedicated backends.</p>
-<h2 id="language-bindings">Language Bindings</h2>
-<p>Even though SOCI is mainly a C++ library, it also allows to use it from other programming languages.
-Currently the package contains the Ada binding, with more bindings likely to come in the future.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = ".",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="js/base.js" defer></script>
-        <script src="search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
-
-<!--
-MkDocs version : 1.2.3
-Build Date UTC : 2022-02-10 19:16:35.360963+00:00
--->
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..020c6f4
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,68 @@
+# SOCI - The C++ Database Access Library
+
+SOCI is a database access library written in C++ that makes an illusion of embedding
+SQL queries in the regular C++ code, staying entirely within the Standard C++.
+
+The idea is to provide C++ programmers a way to access SQL databases in the most natural and intuitive way.
+If you find existing libraries too difficult for your needs or just distracting, SOCI can be a good alternative.
+
+## Basic Syntax
+
+The simplest motivating code example for the SQL query that is supposed to retrieve a single row is:
+
+```cpp
+int id = ...;
+string name;
+int salary;
+
+sql << "select name, salary from persons where id = " << id,
+        into(name), into(salary);
+```
+
+## Basic ORM
+
+The following benefits from extensive support for object-relational mapping:
+
+```cpp
+int id = ...;
+Person p;
+
+sql << "select first_name, last_name, date_of_birth "
+       "from persons where id = " << id, into(p);
+```
+
+## Integrations
+
+Integration with STL is also supported:
+
+```cpp
+Rowset<string> rs = (sql.prepare << "select name from persons");
+std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, "\n"));
+```
+
+SOCI offers also extensive [integration with Boost](boost.md) datatypes (optional, tuple and fusion) and flexible support for user-defined datatypes.
+
+## Database Backends
+
+Starting from its 2.0.0 release, SOCI uses the plug-in architecture for
+backends - this allows to target various database servers.
+
+Currently (SOCI 4.0.3), backends for following database systems are supported:
+
+* [DB2](backends/db2.md)
+* [Firebird](backends/firebird.md)
+* [MySQL](backends/mysql.md)
+* [ODBC](backends/odbc.md) (generic backend)
+* [Oracle](backends/oracle.md)
+* [PostgreSQL](backends/postgresql.md)
+* [SQLite3](backends/sqlite3.md)
+
+The intent of the library is to cover as many database technologies as possible.
+For this, the project has to rely on volunteer contributions from other programmers,
+who have expertise with the existing database interfaces and would like to help
+writing dedicated backends.
+
+## Language Bindings
+
+Even though SOCI is mainly a C++ library, it also allows to use it from other programming languages.
+Currently the package contains the Ada binding, with more bindings likely to come in the future.
diff --git a/docs/indicators.md b/docs/indicators.md
new file mode 100644
index 0000000..2645ad4
--- /dev/null
+++ b/docs/indicators.md
@@ -0,0 +1,105 @@
+# Data Indicators
+
+In order to support SQL NULL values and other conditions which are not real errors, the concept of *indicator* is provided.
+
+## Select with NULL values
+
+For example, when the following SQL query is executed:
+
+```sql
+select name from person where id = 7
+```
+
+there are three possible outcomes:
+
+1. there is a person with id = 7 and her name is returned
+2. there is a person with id = 7, but she has no name (her name is null in the database table)
+3. there is no such person
+
+Whereas the first alternative is easy to handle, the other two are more complex.
+Moreover, they are not necessarily errors from the application's point of view and what's more interesting, they are *different* and the application may wish to detect which is the case.
+The following example does this:
+
+```cpp
+string name;
+indicator ind;
+
+sql << "select name from person where id = 7", into(name, ind);
+
+if (sql.got_data())
+{
+    switch (ind)
+    {
+    case i_ok:
+        // the data was returned without problems
+        break;
+    case i_null:
+        // there is a person, but he has no name (his name is null)
+        break;
+    case i_truncated:
+        // the name was returned only in part,
+        // because the provided buffer was too short
+        // (not possible with std::string, but possible with char* and char[])
+        break;
+    }
+}
+else
+{
+    // no such person in the database: notice that indicator will have the
+    // value i_null in this branch because often enough missing value can
+    // be handled in the same way as a null one, but you may also distinguish
+    // between the two cases if necessary, as done here by using got_data()
+}
+```
+
+The use of indicator variable is optional. However, if `sql.got_data() == true` and the result would be `i_null`, an exception is thrown if no indicator was used.
+This means that you should use indicator variables everywhere where the application logic (and database schema) allow the "attribute not set" condition.
+If no data was fetched to begin with, the indicator would also be `i_null` (see above example) but no exception will be thrown. Thus, you will have to explicitly handle `sql.got_data() == false` (instead of relying on an exception being thrown), if you want to perform any special action in this event.
+
+## Insert with NULL values
+
+Indicator variables can be also used when binding input data, to control whether the data is to be used as provided, or explicitly overridden to be null:
+
+```cpp
+int id = 7;
+string name;
+indicator ind = i_null;
+sql << "insert into person(id, name) values(:id, :name)",
+        use(id), use(name, ind);
+```
+
+In the above example, the row is inserted with `name` attribute set to null.
+
+## Bulk operations with NULL values
+
+Indicator variables can also be used in conjunction with vector based insert, update, and select statements:
+
+```cpp
+vector<string> names(100);
+vector<indicator> inds;
+sql << "select name from person where id = 7", into(names, inds);
+```
+
+The above example retrieves first 100 rows of data (or less).
+The initial size of `names` vector provides the (maximum) number of rows that should be read.
+Both vectors will be automatically resized according to the number of rows that were actually read.
+
+The following example inserts null for each value of name:
+
+```cpp
+vector<int> ids;
+vector<string> names;
+vector<indicator> nameIndicators;
+
+for (int i = 0; i != 10; ++i)
+{
+    ids.push_back(i);
+    names.push_back("");
+    nameIndicators.push_back(i_null);
+}
+
+sql << "insert into person(id, name) values(:id, :name)",
+        use(ids), use(name, nameIndicators);
+```
+
+See also [Integration with Boost](boost.md) to learn how the Boost.Optional library can be used to handle null data conditions in a more natural way.
diff --git a/docs/indicators/index.html b/docs/indicators/index.html
deleted file mode 100644
index e61998c..0000000
--- a/docs/indicators/index.html
+++ /dev/null
@@ -1,433 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Data Indicators - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../binding/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../types/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/indicators.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#data-indicators" class="nav-link">Data Indicators</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#select-with-null-values" class="nav-link">Select with NULL values</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#insert-with-null-values" class="nav-link">Insert with NULL values</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#bulk-operations-with-null-values" class="nav-link">Bulk operations with NULL values</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="data-indicators">Data Indicators</h1>
-<p>In order to support SQL NULL values and other conditions which are not real errors, the concept of <em>indicator</em> is provided.</p>
-<h2 id="select-with-null-values">Select with NULL values</h2>
-<p>For example, when the following SQL query is executed:</p>
-<pre><code class="language-sql">select name from person where id = 7
-</code></pre>
-<p>there are three possible outcomes:</p>
-<ol>
-<li>there is a person with id = 7 and her name is returned</li>
-<li>there is a person with id = 7, but she has no name (her name is null in the database table)</li>
-<li>there is no such person</li>
-</ol>
-<p>Whereas the first alternative is easy to handle, the other two are more complex.
-Moreover, they are not necessarily errors from the application's point of view and what's more interesting, they are <em>different</em> and the application may wish to detect which is the case.
-The following example does this:</p>
-<pre><code class="language-cpp">string name;
-indicator ind;
-
-sql &lt;&lt; &quot;select name from person where id = 7&quot;, into(name, ind);
-
-if (sql.got_data())
-{
-    switch (ind)
-    {
-    case i_ok:
-        // the data was returned without problems
-        break;
-    case i_null:
-        // there is a person, but he has no name (his name is null)
-        break;
-    case i_truncated:
-        // the name was returned only in part,
-        // because the provided buffer was too short
-        // (not possible with std::string, but possible with char* and char[])
-        break;
-    }
-}
-else
-{
-    // no such person in the database: notice that indicator will have the
-    // value i_null in this branch because often enough missing value can
-    // be handled in the same way as a null one, but you may also distinguish
-    // between the two cases if necessary, as done here by using got_data()
-}
-</code></pre>
-<p>The use of indicator variable is optional, but if it is not used and the result would be <code>i_null</code>,
-then the exception is thrown.
-This means that you should use indicator variables everywhere where the application logic (and database schema) allow the "attribute not set" condition.</p>
-<h2 id="insert-with-null-values">Insert with NULL values</h2>
-<p>Indicator variables can be also used when binding input data, to control whether the data is to be used as provided, or explicitly overridden to be null:</p>
-<pre><code class="language-cpp">int id = 7;
-string name;
-indicator ind = i_null;
-sql &lt;&lt; &quot;insert into person(id, name) values(:id, :name)&quot;,
-        use(id), use(name, ind);
-</code></pre>
-<p>In the above example, the row is inserted with <code>name</code> attribute set to null.</p>
-<h2 id="bulk-operations-with-null-values">Bulk operations with NULL values</h2>
-<p>Indicator variables can also be used in conjunction with vector based insert, update, and select statements:</p>
-<pre><code class="language-cpp">vector&lt;string&gt; names(100);
-vector&lt;indicator&gt; inds;
-sql &lt;&lt; &quot;select name from person where id = 7&quot;, into(names, inds);
-</code></pre>
-<p>The above example retrieves first 100 rows of data (or less).
-The initial size of <code>names</code> vector provides the (maximum) number of rows that should be read.
-Both vectors will be automatically resized according to the number of rows that were actually read.</p>
-<p>The following example inserts null for each value of name:</p>
-<pre><code class="language-cpp">vector&lt;int&gt; ids;
-vector&lt;string&gt; names;
-vector&lt;indicator&gt; nameIndicators;
-
-for (int i = 0; i != 10; ++i)
-{
-    ids.push_back(i);
-    names.push_back(&quot;&quot;);
-    nameIndicators.push_back(i_null);
-}
-
-sql &lt;&lt; &quot;insert into person(id, name) values(:id, :name)&quot;,
-        use(ids), use(name, nameIndicators);
-</code></pre>
-<p>See also <a href="../boost/">Integration with Boost</a> to learn how the Boost.Optional library can be used to handle null data conditions in a more natural way.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/installation.md b/docs/installation.md
new file mode 100644
index 0000000..a06738d
--- /dev/null
+++ b/docs/installation.md
@@ -0,0 +1,301 @@
+# Installation
+
+## Requirements
+
+Below is an overall list of SOCI core:
+
+* C++ compiler: [GCC](http://gcc.gnu.org/), [Microsoft Visual C++](http://msdn.microsoft.com/en-us/visualc), [LLVM/clang](http://clang.llvm.org/)
+* [CMake](http://www.cmake.org) 2.8+ - in order to use build configuration for CMake
+* [Boost C++ Libraries](http://www.boost.org): DateTime, Fusion, Optional, Preprocessor, Tuple
+
+and backend-specific dependencies:
+
+* [DB2 Call Level Interface (CLI)](http://pic.dhe.ibm.com/infocenter/db2luw/v10r1/topic/com.ibm.swg.im.dbclient.install.doc/doc/c0023452.html)
+* [Firebird client library](http://www.firebirdsql.org/manual/ufb-cs-clientlib.html)
+* [mysqlclient](https://dev.mysql.com/doc/refman/5.6/en/c-api.html) - C API to MySQL
+* ODBC (Open Database Connectivity) implementation: [Microsoft ODBC](http://msdn.microsoft.com/en-us/library/windows/desktop/ms710252.aspx) [iODBC](http://www.iodbc.org/), [unixODBC](http://www.unixodbc.org/)
+* [Oracle Call Interface (OCI)](http://www.oracle.com/technetwork/database/features/oci/index.html)
+* [libpq](http://www.postgresql.org/docs/current/static/libpq.html) - C API to PostgreSQL
+* [SQLite 3](http://www.sqlite.org/) library
+
+## Downloads
+
+Download package with latest release of the SOCI source code:
+[soci-X.Y.Z](https://sourceforge.net/projects/soci/),
+where X.Y.Z is the version number. Unpack the archive.
+
+You can always clone SOCI from the Git repository:
+
+```console
+git clone git://github.com/SOCI/soci.git
+```
+
+## Building with CMake
+
+SOCI is configured to build using [CMake](http://cmake.org/) system in version 2.8+.
+
+The build configuration allows to control various aspects of compilation and
+installation by setting common CMake variables that change behaviour, describe
+system or control build (see [CMake help](http://cmake.org/cmake/help/documentation.html))
+as well as SOCI-specific variables described below.
+All these variables are available regardless of platform or compilation toolset used.
+
+Running CMake from the command line allows to set variables in the CMake cache
+with the following syntax: `-DVARIABLE:TYPE=VALUE`. If you are new to CMake,
+you may find the tutorial [Running CMake](http://cmake.org/cmake/help/runningcmake.html) helpful.
+
+### Running CMake on Unix
+
+Steps outline using GNU Make `Makefile`-s:
+
+```console
+mkdir build
+cd build
+cmake -G "Unix Makefiles" -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) /path/to/soci-X.Y.Z
+make
+make install
+```
+
+### Running CMake on Windows
+
+Steps outline using Visual Studio 2010 and MSBuild:
+
+```console
+mkdir build
+cd build
+cmake -G "Visual Studio 10" -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) C:\path\to\soci-X.Y.Z
+msbuild.exe SOCI.sln
+```
+
+### CMake configuration
+
+By default, CMake will try to determine availability of all dependencies automatically.
+If you are lucky, you will not need to specify any of the CMake variables explained below.
+However, if CMake reports some of the core or backend-specific dependencies
+as missing, you will need specify relevant variables to tell CMake where to look
+for the required components.
+
+CMake configures SOCI build performing sequence of steps.
+Each subsequent step is dependant on result of previous steps corresponding with particular feature.
+First, CMake checks system platform and compilation toolset.
+Next, CMake tries to find all external dependencies.
+Then, depending on the results of the dependency check, CMake determines SOCI backends which are possible to build.
+The SOCI-specific variables described below provide users with basic control of this behaviour.
+
+The following sections provide summary of variables accepted by CMake scripts configuring SOCI build.
+The lists consist of common variables for SOCI core and all backends as well as variables specific to SOCI backends and their direct dependencies.
+
+List of a few essential CMake variables:
+
+* `CMAKE_BUILD_TYPE` - string - Specifies the build type for make based generators (see CMake [help](http://cmake.org/cmake/help/cmake-2-8-docs.html#variable:CMAKE_BUILD_TYPE)).
+* `CMAKE_INSTALL_PREFIX` - path - Install directory used by install command (see CMake [help](http://cmake.org/cmake/help/cmake-2-8-docs.html#variable:CMAKE_INSTALL_PREFIX)).
+* `CMAKE_VERBOSE_MAKEFILE` - boolean - If ON, create verbose makefile (see CMake [help](http://cmake.org/cmake/help/cmake-2-8-docs.html#variable:CMAKE_VERBOSE_MAKEFILE)).
+
+List of variables to control common SOCI features and dependencies:
+
+* `SOCI_SHARED` - boolean - Request to build shared libraries for SOCI core and all successfully configured backends. Default is `ON`.
+* `SOCI_STATIC` - boolean - Request to build static libraries for SOCI core and all successfully configured backends. Default is `ON`.
+* `SOCI_TESTS` - boolean - Request to build regression tests for SOCI core and all successfully configured backends.
+* `WITH_BOOST` - boolean - Should CMake try to detect [Boost C++ Libraries](http://www.boost.org/). If ON, CMake will try to find Boost headers and binaries of [Boost.Date_Time](http://www.boost.org/doc/libs/release/doc/html/date_time.html) library.
+
+Some other build options:
+
+* `SOCI_ASAN` - boolean - Build with address sanitizer (ASAN) support. Useful for finding problems when debugging, but shouldn't be used for the production builds due to extra overhead. Default is `OFF`.
+* `SOCI_LTO` - boolean - Build with link-time optimizations, if supported. This produces noticeably smaller libraries. Default is `OFF`, but turning it on is recommended for the production builds.
+* `SOCI_VISIBILITY` - boolean - Use hidden ELF visibility for private symbols if supported by the platform. This option produces smaller libraries by avoiding exporting internal function symbols. Default is `ON`.
+
+#### Empty (sample backend)
+
+* `SOCI_EMPTY` - boolean - Builds the [sample backend](backends/index.md) called Empty. Always ON by default.
+* `SOCI_EMPTY_TEST_CONNSTR` - string - Connection string used to run regression tests of the Empty backend. It is a dummy value. Example: `-DSOCI_EMPTY_TEST_CONNSTR="dummy connection"`
+
+#### IBM DB2
+
+* `WITH_DB2` - boolean - Should CMake try to detect IBM DB2 Call Level Interface (CLI) library.
+* `DB2_INCLUDE_DIR` - string - Path to DB2 CLI include directories where CMake should look for `sqlcli1.h` header.
+* `DB2_LIBRARIES` - string - Full paths to  `db2` or `db2api` libraries to link SOCI against to enable the backend support.
+* `SOCI_DB2` - boolean - Requests to build [DB2](backends/db2.md) backend. Automatically switched on, if `WITH_DB2` is set to ON.
+* `SOCI_DB2_TEST_CONNSTR` - string - See [DB2 backend reference](backends/db2.md) for details. Example: `-DSOCI_DB2_TEST_CONNSTR:STRING="DSN=SAMPLE;Uid=db2inst1;Pwd=db2inst1;autocommit=off"`
+
+#### Firebird
+
+* `WITH_FIREBIRD` - boolean - Should CMake try to detect Firebird client library.
+* `FIREBIRD_INCLUDE_DIR` - string - Path to Firebird include directories where CMake should look for `ibase.h` header.
+* `FIREBIRD_LIBRARIES` - string - Full paths to Firebird `fbclient` or `fbclient_ms` libraries to link SOCI against to enable the backend support.
+* `SOCI_FIREBIRD` - boolean - Requests to build [Firebird](backends/firebird.md) backend. Automatically switched on, if `WITH_FIREBIRD` is set to ON.
+* `SOCI_FIREBIRD_TEST_CONNSTR` - string - See [Firebird backend reference](backends/firebird.md) for details. Example: `-DSOCI_FIREBIRD_TEST_CONNSTR:STRING="service=LOCALHOST:/tmp/soci_test.fdb user=SYSDBA password=masterkey"`
+
+#### MySQL
+
+* `WITH_MYSQL` - boolean - Should CMake try to detect [mysqlclient](https://dev.mysql.com/doc/refman/5.5/en/c-api.html) libraries providing MySQL C API. Note, currently the [mysql_config](https://dev.mysql.com/doc/refman/5.5/en/c-api-building-clients.html) program is not being used.
+* `MYSQL_DIR` - string - Path to MySQL installation root directory. CMake will scan subdirectories `MYSQL_DIR/include` and `MYSQL_DIR/lib` respectively for MySQL headers and libraries.
+* `MYSQL_INCLUDE_DIR` - string - Path to MySQL include directory where CMake should look for `mysql.h` header.
+* `MYSQL_LIBRARIES` - string - Full paths to libraries to link SOCI against to enable the backend support.
+* `SOCI_MYSQL` - boolean - Requests to build [MySQL](backends/mysql.md) backend. Automatically switched on, if `WITH_MYSQL` is set to ON.
+* `SOCI_MYSQL_TEST_CONNSTR` - string - Connection string to MySQL test database. Format of the string is explained [MySQL backend reference](backends/mysql.md). Example: `-DSOCI_MYSQL_TEST_CONNSTR:STRING="db=mydb user=mloskot password=secret"`
+
+#### ODBC
+
+* `WITH_ODBC` - boolean - Should CMake try to detect ODBC libraries. On Unix systems, CMake tries to find [unixODBC](http://www.unixodbc.org/) or [iODBC](http://www.iodbc.org/) implementations.
+* `ODBC_INCLUDE_DIR` - string - Path to ODBC implementation include directories where CMake should look for `sql.h` header.
+* `ODBC_LIBRARIES` - string - Full paths to libraries to link SOCI against to enable the backend support.
+* `SOCI_ODBC` - boolean - Requests to build [ODBC](backends/odbc.md) backend. Automatically switched on, if `WITH_ODBC` is set to ON.
+* `SOCI_ODBC_TEST_{database}_CONNSTR` - string - ODBC Data Source Name (DSN) or ODBC File Data Source Name (FILEDSN) to test database: Microsoft Access (.mdb), Microsoft SQL Server, MySQL, PostgreSQL or any other ODBC SQL data source. {database} is placeholder for name of database driver ACCESS, MYSQL, POSTGRESQL, etc. See [ODBC](backends/odbc.md) backend reference for details. Example: `-DSOCI_ODBC_TEST_POSTGRESQL_CONNSTR="FILEDSN=/home/mloskot/soci/build/test-postgresql.dsn"`
+
+#### Oracle
+
+* `WITH_ORACLE` - boolean - Should CMake try to detect [Oracle Call Interface (OCI)](http://en.wikipedia.org/wiki/Oracle_Call_Interface) libraries.
+* `ORACLE_INCLUDE_DIR` - string - Path to Oracle include directory where CMake should look for `oci.h` header.
+* `ORACLE_LIBRARIES` - string - Full paths to libraries to link SOCI against to enable the backend support.
+* `SOCI_ORACLE` - boolean - Requests to build [Oracle](backends/oracle.md) backend. Automatically switched on, if `WITH_ORACLE` is set to ON.
+* `SOCI_ORACLE_TEST_CONNSTR` - string - Connection string to Oracle test database. Format of the string is explained [Oracle backend reference](backends/oracle.md). Example: `-DSOCI_ORACLE_TEST_CONNSTR:STRING="service=orcl user=scott password=tiger"`
+
+#### PostgreSQL
+
+* `WITH_POSTGRESQL` - boolean - Should CMake try to detect PostgreSQL client interface libraries. SOCI relies on [libpq](http://www.postgresql.org/docs/current/static/libpq.html") C library.
+* `POSTGRESQL_INCLUDE_DIR` - string - Path to PostgreSQL include directory where CMake should look for `libpq-fe.h` header.
+* `POSTGRESQL_LIBRARY` - string - Full paths to libraries to link SOCI against to enable the backend support. The `POSTGRESQL_LIBRARIES` will be set with PostgreSQL libraries needed for linking.
+* `SOCI_POSTGRESQL` - boolean - Requests to build [PostgreSQL](backends/postgresql.md) backend. Automatically switched on, if `WITH_POSTGRESQL` is set to ON.
+* `SOCI_POSTGRESQL_TEST_CONNSTR` - string - Connection string to PostgreSQL test database. Format of the string is explained PostgreSQL backend reference. Example: `-DSOCI_POSTGRESQL_TEST_CONNSTR:STRING="dbname=mydb user=scott"`
+
+#### SQLite 3
+
+* `WITH_SQLITE3` - boolean - Should CMake try to detect SQLite C/C++ library. As bonus, the configuration tries OSGeo4W distribution if OSGEO4W_ROOT environment variable is set.
+* `SQLITE3_INCLUDE_DIR` - string - Path to SQLite 3 include directory where CMake should look for `sqlite3.h` header.
+* `SQLITE3_LIBRARY` - string - Full paths to libraries to link SOCI against to enable the backend support.
+* `SOCI_SQLITE3` - boolean - Requests to build [SQLite3](backends/sqlite3.md) backend. Automatically switched on, if `WITH_SQLITE3` is set to ON.
+* `SOCI_SQLITE3_TEST_CONNSTR` - string - Connection string is simply a file path where SQLite3 test database will be created (e.g. /home/john/soci_test.db). Check [SQLite3 backend reference](backends/sqlite3.md) for details. Example: `-DSOCI_SQLITE3_TEST_CONNSTR="my.db"` or `-DSOCI_SQLITE3_TEST_CONNSTR=":memory:"`.
+
+## Building with Makefiles on Unix
+
+*NOTE: These (classic) Makefiles have not been maintained for long time.
+The officially maintained build configuration is CMake.
+If you still want to use these Makefiles, you've been warned that you may need to patch them.*
+
+The classic set of Makefiles for Unix/Linux systems is provided for those users who need complete control over the whole processand who can benefit from the basic scaffolding that they can extend on their own.
+In this sense, the basic Makefiles are supposed to provide a minimal starting point for custom experimentation and are not intended to be a complete build/installation solution.
+At the same time, they are complete in the sense that they can compile the library with all test programs and for some users this level of support will be just fine.
+
+The `core` directory of the library distribution contains the `Makefile.basic` that can be used to compile the core part of the library.
+Run `make -f Makefile.basic` or `make -f Makefile.basic shared` to get the static and shared versions, respectively.
+Similarly, the `backends/<i>name</i>` directory contains the backend part for each supported backend with the appropriate `Makefile.basic` and the `backends/<i>name</i>/test` directory contains the test program for the given backend.
+
+For example, the simplest way to compile the static version of the library and the test program for PostgreSQL is:
+
+```console
+cd src/core
+make -f Makefile.basic
+cd ../backends/postgresql
+make -f Makefile.basic
+cd test
+make -f Makefile.basic
+```
+
+For each backend and its test program, the `Makefile.basic`s contain the variables that can have values specific to the given environment - they usually name the include and library paths.
+These variables are placed at the beginning of the `Makefile.basic`s.
+Please review their values in case of any compilation problems.
+
+The Makefiles for test programs can be a good starting point to find out correct compiler and linker options.
+
+## Building with Conan
+
+SOCI is available as a [Conan](https://docs.conan.io/en/latest/) package since
+February 2021 for the version [4.0.1](https://conan.io/center/soci) for the
+following backends: sqlite3, odbc, mysql, and postgresql.
+
+This section lists the steps required to use SOCI in a CMake project with Conan:
+
+### Install Conan
+
+Install Conan if it is not installed yet:
+
+```console
+pip3 install conan
+```
+
+### Create `conanfile.txt`
+
+Create a `conanfile.txt` in the same directory of the `CMakeLists.txt`, with a
+_reference to a recipe_ (which is a string with the library name and the
+version to use), the build options, and the CMake generator:
+
+```text
+# conanfile.txt
+[requires]
+soci/4.0.1
+
+[options]
+soci:shared       = True
+soci:with_sqlite3 = True
+
+[generators]
+cmake
+```
+
+The option `soci:with_sqlite3 = True` indicates that the `sqlite3` backend will
+be downloaded and used.
+
+### Update `CMakeLists.txt`
+
+Add the following Conan-specific lines to the `CMakeLists.txt` of your project:
+
+```cmake
+include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
+conan_basic_setup(TARGETS)
+conan_target_link_libraries(${PROJECT_NAME} ${CONAN_LIBS})
+```
+
+The command `conan_target_link_libraries` replaces `target_link_libraries`.
+
+### Run Conan
+
+Run `conan install` to install SOCI, and then build your project as usual:
+
+```bash
+mkdir build
+cd build
+conan install .. --build=soci
+cmake ..
+cmake . --build
+```
+
+## Running tests
+
+The process of running regression tests highly depends on user's environment and build configuration, so it may be quite involving process.
+The CMake configuration provides variables to allow users willing to run the tests to configure build and specify database connection parameters (see the lists above for variable names).
+
+In order to run regression tests, configure and build desired SOCI backends and prepare working database instances for them.
+
+While configuring build with CMake, specify `SOCI_TESTS=ON` to enable building regression tests.
+Also, specify `SOCI_{backend name}_TEST_CONNSTR` variables to tell the tests runner how to connect with your test databases.
+
+Dedicated `make test` target can be used to execute regression tests on build completion:
+
+```console
+mkdir build
+cd build
+cmake -G "Unix Makefiles" \
+        -DWITH_BOOST=OFF \
+        -DSOCI_TESTS=ON \
+        -DSOCI_EMPTY_TEST_CONNSTR="dummy connection" \
+        -DSOCI_SQLITE3_TEST_CONNSTR="test.db" \
+        (...)
+        ../soci-X.Y.Z
+make
+make test
+make install
+```
+
+In the example above, regression tests for the sample Empty backend and SQLite 3 backend are configured for execution by `make test` target.
+
+## Using library
+
+CMake build produces set of shared and static libraries for SOCI core and backends separately.
+On Unix, for example, `build/lib` directory will consist of the static libraries named like `libsoci_core.a`, `libsoci_sqlite3.a` and shared libraries with names like `libsoci_core.so.4.0.0`, `libsoci_sqlite3.so.4.0.0`, and so on.
+
+If your project also uses CMake, you can simply use `find_package(Soci)` to check for SOCI availability and `target_link_libraries()` to link with the SOCI libraries available under the names `Soci::core` and `Soci::<backend>` (or `Soci::<backend>_static` if you prefer linking statically) and ensure that SOCI headers can be included (i.e. there is no need to use `target_include_directories()` explicitly). An example of a very simple CMake-based project using SOCI is provided in the `examples/connect` directory.
+
+Alternatively, you can add SOCI as a subdirectory to your project and include it via `add_subdirectory()`. As before, `target_link_libraries()` is used to link with the SOCI libraries available under the same names `Soci::core` and `Soci::<backend>` as above. An example of this can be found in the directory `examples/subdir-include`.
+
+If you don't use CMake but want to use SOCI in your program, you need to specify the paths to the SOCI headers and libraries in your build configuration and to
+tell the linker to link against the libraries you want to use in your program.
diff --git a/docs/installation/index.html b/docs/installation/index.html
deleted file mode 100644
index c2687fe..0000000
--- a/docs/installation/index.html
+++ /dev/null
@@ -1,605 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Installation - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../quickstart/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../structure/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/installation.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#installation" class="nav-link">Installation</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#requirements" class="nav-link">Requirements</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#downloads" class="nav-link">Downloads</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#building-with-cmake" class="nav-link">Building with CMake</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#building-with-makefiles-on-unix" class="nav-link">Building with Makefiles on Unix</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#building-with-conan" class="nav-link">Building with Conan</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#running-tests" class="nav-link">Running tests</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#using-library" class="nav-link">Using library</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="installation">Installation</h1>
-<h2 id="requirements">Requirements</h2>
-<p>Below is an overall list of SOCI core:</p>
-<ul>
-<li>C++ compiler: <a href="http://gcc.gnu.org/">GCC</a>, <a href="http://msdn.microsoft.com/en-us/visualc">Microsoft Visual C++</a>, <a href="http://clang.llvm.org/">LLVM/clang</a></li>
-<li><a href="http://www.cmake.org">CMake</a> 2.8+ - in order to use build configuration for CMake</li>
-<li><a href="http://www.boost.org">Boost C++ Libraries</a>: DateTime, Fusion, Optional, Preprocessor, Tuple</li>
-</ul>
-<p>and backend-specific dependencies:</p>
-<ul>
-<li><a href="http://pic.dhe.ibm.com/infocenter/db2luw/v10r1/topic/com.ibm.swg.im.dbclient.install.doc/doc/c0023452.html">DB2 Call Level Interface (CLI)</a></li>
-<li><a href="http://www.firebirdsql.org/manual/ufb-cs-clientlib.html">Firebird client library</a></li>
-<li><a href="https://dev.mysql.com/doc/refman/5.6/en/c-api.html">mysqlclient</a> - C API to MySQL</li>
-<li>ODBC (Open Database Connectivity) implementation: <a href="http://msdn.microsoft.com/en-us/library/windows/desktop/ms710252.aspx">Microsoft ODBC</a> <a href="http://www.iodbc.org/">iODBC</a>, <a href="http://www.unixodbc.org/">unixODBC</a></li>
-<li><a href="http://www.oracle.com/technetwork/database/features/oci/index.html">Oracle Call Interface (OCI)</a></li>
-<li><a href="http://www.postgresql.org/docs/current/static/libpq.html">libpq</a> - C API to PostgreSQL</li>
-<li><a href="http://www.sqlite.org/">SQLite 3</a> library</li>
-</ul>
-<h2 id="downloads">Downloads</h2>
-<p>Download package with latest release of the SOCI source code:
-<a href="https://sourceforge.net/projects/soci/">soci-X.Y.Z</a>,
-where X.Y.Z is the version number. Unpack the archive.</p>
-<p>You can always clone SOCI from the Git repository:</p>
-<pre><code class="language-console">git clone git://github.com/SOCI/soci.git
-</code></pre>
-<h2 id="building-with-cmake">Building with CMake</h2>
-<p>SOCI is configured to build using <a href="http://cmake.org/">CMake</a> system in version 2.8+.</p>
-<p>The build configuration allows to control various aspects of compilation and
-installation by setting common CMake variables that change behaviour, describe
-system or control build (see <a href="http://cmake.org/cmake/help/documentation.html">CMake help</a>)
-as well as SOCI-specific variables described below.
-All these variables are available regardless of platform or compilation toolset used.</p>
-<p>Running CMake from the command line allows to set variables in the CMake cache
-with the following syntax: <code>-DVARIABLE:TYPE=VALUE</code>. If you are new to CMake,
-you may find the tutorial <a href="http://cmake.org/cmake/help/runningcmake.html">Running CMake</a> helpful.</p>
-<h3 id="running-cmake-on-unix">Running CMake on Unix</h3>
-<p>Steps outline using GNU Make <code>Makefile</code>-s:</p>
-<pre><code class="language-console">mkdir build
-cd build
-cmake -G &quot;Unix Makefiles&quot; -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) /path/to/soci-X.Y.Z
-make
-make install
-</code></pre>
-<h3 id="running-cmake-on-windows">Running CMake on Windows</h3>
-<p>Steps outline using Visual Studio 2010 and MSBuild:</p>
-<pre><code class="language-console">mkdir build
-cd build
-cmake -G &quot;Visual Studio 10&quot; -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) C:\path\to\soci-X.Y.Z
-msbuild.exe SOCI.sln
-</code></pre>
-<h3 id="cmake-configuration">CMake configuration</h3>
-<p>By default, CMake will try to determine availability of all dependencies automatically.
-If you are lucky, you will not need to specify any of the CMake variables explained below.
-However, if CMake reports some of the core or backend-specific dependencies
-as missing, you will need specify relevant variables to tell CMake where to look
-for the required components.</p>
-<p>CMake configures SOCI build performing sequence of steps.
-Each subsequent step is dependant on result of previous steps corresponding with particular feature.
-First, CMake checks system platform and compilation toolset.
-Next, CMake tries to find all external dependencies.
-Then, depending on the results of the dependency check, CMake determines SOCI backends which are possible to build.
-The SOCI-specific variables described below provide users with basic control of this behaviour.</p>
-<p>The following sections provide summary of variables accepted by CMake scripts configuring SOCI build.
-The lists consist of common variables for SOCI core and all backends as well as variables specific to SOCI backends and their direct dependencies.</p>
-<p>List of a few essential CMake variables:</p>
-<ul>
-<li><code>CMAKE_BUILD_TYPE</code> - string - Specifies the build type for make based generators (see CMake <a href="http://cmake.org/cmake/help/cmake-2-8-docs.html#variable:CMAKE_BUILD_TYPE">help</a>).</li>
-<li><code>CMAKE_INSTALL_PREFIX</code> - path - Install directory used by install command (see CMake <a href="http://cmake.org/cmake/help/cmake-2-8-docs.html#variable:CMAKE_INSTALL_PREFIX">help</a>).</li>
-<li><code>CMAKE_VERBOSE_MAKEFILE</code> - boolean - If ON, create verbose makefile (see CMake <a href="http://cmake.org/cmake/help/cmake-2-8-docs.html#variable:CMAKE_VERBOSE_MAKEFILE">help</a>).</li>
-</ul>
-<p>List of variables to control common SOCI features and dependencies:</p>
-<ul>
-<li><code>SOCI_CXX11</code> - boolean - Request to compile in C++11 compatibility mode. Default is <code>OFF</code>, unless <a href="https://cmake.org/cmake/help/v3.1/variable/CMAKE_CXX_STANDARD.html">CMAKE_CXX_STANDARD</a> with version <code>11</code> or later is given in the command line.</li>
-<li><code>SOCI_SHARED</code> - boolean - Request to build shared libraries for SOCI core and all successfully configured backends. Default is <code>ON</code>.</li>
-<li><code>SOCI_STATIC</code> - boolean - Request to build static libraries for SOCI core and all successfully configured backends. Default is <code>ON</code>.</li>
-<li><code>SOCI_TESTS</code> - boolean - Request to build regression tests for SOCI core and all successfully configured backends.</li>
-<li><code>WITH_BOOST</code> - boolean - Should CMake try to detect <a href="http://www.boost.org/">Boost C++ Libraries</a>. If ON, CMake will try to find Boost headers and binaries of <a href="http://www.boost.org/doc/libs/release/doc/html/date_time.html">Boost.Date_Time</a> library.</li>
-</ul>
-<p>Some other build options:</p>
-<ul>
-<li><code>SOCI_ASAN</code> - boolean - Build with address sanitizer (ASAN) support. Useful for finding problems when debugging, but shouldn't be used for the production builds due to extra overhead. Default is <code>OFF</code>.</li>
-<li><code>SOCI_LTO</code> - boolean - Build with link-time optimizations, if supported. This produces noticeably smaller libraries. Default is <code>OFF</code>, but turning it on is recommended for the production builds.</li>
-<li><code>SOCI_VISIBILITY</code> - boolean - Use hidden ELF visibility for private symbols if supported by the platform. This option produces smaller libraries by avoiding exporting internal function symbols. Default is <code>ON</code>.</li>
-</ul>
-<h4 id="empty-sample-backend">Empty (sample backend)</h4>
-<ul>
-<li><code>SOCI_EMPTY</code> - boolean - Builds the <a href="../backends/">sample backend</a> called Empty. Always ON by default.</li>
-<li><code>SOCI_EMPTY_TEST_CONNSTR</code> - string - Connection string used to run regression tests of the Empty backend. It is a dummy value. Example: <code>-DSOCI_EMPTY_TEST_CONNSTR="dummy connection"</code></li>
-</ul>
-<h4 id="ibm-db2">IBM DB2</h4>
-<ul>
-<li><code>WITH_DB2</code> - boolean - Should CMake try to detect IBM DB2 Call Level Interface (CLI) library.</li>
-<li><code>DB2_INCLUDE_DIR</code> - string - Path to DB2 CLI include directories where CMake should look for <code>sqlcli1.h</code> header.</li>
-<li><code>DB2_LIBRARIES</code> - string - Full paths to  <code>db2</code> or <code>db2api</code> libraries to link SOCI against to enable the backend support.</li>
-<li><code>SOCI_DB2</code> - boolean - Requests to build <a href="../backends/db2/">DB2</a> backend. Automatically switched on, if <code>WITH_DB2</code> is set to ON.</li>
-<li><code>SOCI_DB2_TEST_CONNSTR</code> - string - See <a href="../backends/db2/">DB2 backend reference</a> for details. Example: <code>-DSOCI_DB2_TEST_CONNSTR:STRING="DSN=SAMPLE;Uid=db2inst1;Pwd=db2inst1;autocommit=off"</code></li>
-</ul>
-<h4 id="firebird">Firebird</h4>
-<ul>
-<li><code>WITH_FIREBIRD</code> - boolean - Should CMake try to detect Firebird client library.</li>
-<li><code>FIREBIRD_INCLUDE_DIR</code> - string - Path to Firebird include directories where CMake should look for <code>ibase.h</code> header.</li>
-<li><code>FIREBIRD_LIBRARIES</code> - string - Full paths to Firebird <code>fbclient</code> or <code>fbclient_ms</code> libraries to link SOCI against to enable the backend support.</li>
-<li><code>SOCI_FIREBIRD</code> - boolean - Requests to build <a href="../backends/firebird/">Firebird</a> backend. Automatically switched on, if <code>WITH_FIREBIRD</code> is set to ON.</li>
-<li><code>SOCI_FIREBIRD_TEST_CONNSTR</code> - string - See <a href="../backends/firebird/">Firebird backend reference</a> for details. Example: <code>-DSOCI_FIREBIRD_TEST_CONNSTR:STRING="service=LOCALHOST:/tmp/soci_test.fdb user=SYSDBA password=masterkey"</code></li>
-</ul>
-<h4 id="mysql">MySQL</h4>
-<ul>
-<li><code>WITH_MYSQL</code> - boolean - Should CMake try to detect <a href="https://dev.mysql.com/doc/refman/5.5/en/c-api.html">mysqlclient</a> libraries providing MySQL C API. Note, currently the <a href="https://dev.mysql.com/doc/refman/5.5/en/c-api-building-clients.html">mysql_config</a> program is not being used.</li>
-<li><code>MYSQL_DIR</code> - string - Path to MySQL installation root directory. CMake will scan subdirectories <code>MYSQL_DIR/include</code> and <code>MYSQL_DIR/lib</code> respectively for MySQL headers and libraries.</li>
-<li><code>MYSQL_INCLUDE_DIR</code> - string - Path to MySQL include directory where CMake should look for <code>mysql.h</code> header.</li>
-<li><code>MYSQL_LIBRARIES</code> - string - Full paths to libraries to link SOCI against to enable the backend support.</li>
-<li><code>SOCI_MYSQL</code> - boolean - Requests to build <a href="../backends/mysql/">MySQL</a> backend. Automatically switched on, if <code>WITH_MYSQL</code> is set to ON.</li>
-<li><code>SOCI_MYSQL_TEST_CONNSTR</code> - string - Connection string to MySQL test database. Format of the string is explained <a href="../backends/mysql/">MySQL backend reference</a>. Example: <code>-DSOCI_MYSQL_TEST_CONNSTR:STRING="db=mydb user=mloskot password=secret"</code></li>
-</ul>
-<h4 id="odbc">ODBC</h4>
-<ul>
-<li><code>WITH_ODBC</code> - boolean - Should CMake try to detect ODBC libraries. On Unix systems, CMake tries to find <a href="http://www.unixodbc.org/">unixODBC</a> or <a href="http://www.iodbc.org/">iODBC</a> implementations.</li>
-<li><code>ODBC_INCLUDE_DIR</code> - string - Path to ODBC implementation include directories where CMake should look for <code>sql.h</code> header.</li>
-<li><code>ODBC_LIBRARIES</code> - string - Full paths to libraries to link SOCI against to enable the backend support.</li>
-<li><code>SOCI_ODBC</code> - boolean - Requests to build <a href="../backends/odbc/">ODBC</a> backend. Automatically switched on, if <code>WITH_ODBC</code> is set to ON.</li>
-<li><code>SOCI_ODBC_TEST_{database}_CONNSTR</code> - string - ODBC Data Source Name (DSN) or ODBC File Data Source Name (FILEDSN) to test database: Microsoft Access (.mdb), Microsoft SQL Server, MySQL, PostgreSQL or any other ODBC SQL data source. {database} is placeholder for name of database driver ACCESS, MYSQL, POSTGRESQL, etc. See <a href="../backends/odbc/">ODBC</a> backend reference for details. Example: <code>-DSOCI_ODBC_TEST_POSTGRESQL_CONNSTR="FILEDSN=/home/mloskot/soci/build/test-postgresql.dsn"</code></li>
-</ul>
-<h4 id="oracle">Oracle</h4>
-<ul>
-<li><code>WITH_ORACLE</code> - boolean - Should CMake try to detect <a href="http://en.wikipedia.org/wiki/Oracle_Call_Interface">Oracle Call Interface (OCI)</a> libraries.</li>
-<li><code>ORACLE_INCLUDE_DIR</code> - string - Path to Oracle include directory where CMake should look for <code>oci.h</code> header.</li>
-<li><code>ORACLE_LIBRARIES</code> - string - Full paths to libraries to link SOCI against to enable the backend support.</li>
-<li><code>SOCI_ORACLE</code> - boolean - Requests to build <a href="../backends/oracle/">Oracle</a> backend. Automatically switched on, if <code>WITH_ORACLE</code> is set to ON.</li>
-<li><code>SOCI_ORACLE_TEST_CONNSTR</code> - string - Connection string to Oracle test database. Format of the string is explained <a href="../backends/oracle/">Oracle backend reference</a>. Example: <code>-DSOCI_ORACLE_TEST_CONNSTR:STRING="service=orcl user=scott password=tiger"</code></li>
-</ul>
-<h4 id="postgresql">PostgreSQL</h4>
-<ul>
-<li><code>WITH_POSTGRESQL</code> - boolean - Should CMake try to detect PostgreSQL client interface libraries. SOCI relies on <a href="http://www.postgresql.org/docs/current/static/libpq.html&quot;">libpq</a> C library.</li>
-<li><code>POSTGRESQL_INCLUDE_DIR</code> - string - Path to PostgreSQL include directory where CMake should look for <code>libpq-fe.h</code> header.</li>
-<li><code>POSTGRESQL_LIBRARY</code> - string - Full paths to libraries to link SOCI against to enable the backend support. The <code>POSTGRESQL_LIBRARIES</code> will be set with PostgreSQL libraries needed for linking.</li>
-<li><code>SOCI_POSTGRESQL</code> - boolean - Requests to build <a href="../backends/postgresql/">PostgreSQL</a> backend. Automatically switched on, if <code>WITH_POSTGRESQL</code> is set to ON.</li>
-<li><code>SOCI_POSTGRESQL_TEST_CONNSTR</code> - string - Connection string to PostgreSQL test database. Format of the string is explained PostgreSQL backend reference. Example: <code>-DSOCI_POSTGRESQL_TEST_CONNSTR:STRING="dbname=mydb user=scott"</code></li>
-</ul>
-<h4 id="sqlite-3">SQLite 3</h4>
-<ul>
-<li><code>WITH_SQLITE3</code> - boolean - Should CMake try to detect SQLite C/C++ library. As bonus, the configuration tries OSGeo4W distribution if OSGEO4W_ROOT environment variable is set.</li>
-<li><code>SQLITE3_INCLUDE_DIR</code> - string - Path to SQLite 3 include directory where CMake should look for <code>sqlite3.h</code> header.</li>
-<li><code>SQLITE3_LIBRARIES</code> - string - Full paths to libraries to link SOCI against to enable the backend support.</li>
-<li><code>SOCI_SQLITE3</code> - boolean - Requests to build <a href="../backends/sqlite3/">SQLite3</a> backend. Automatically switched on, if <code>WITH_SQLITE3</code> is set to ON.</li>
-<li><code>SOCI_SQLITE3_TEST_CONNSTR</code> - string - Connection string is simply a file path where SQLite3 test database will be created (e.g. /home/john/soci_test.db). Check <a href="../backends/sqlite3/">SQLite3 backend reference</a> for details. Example: <code>-DSOCI_SQLITE3_TEST_CONNSTR="my.db"</code> or <code>-DSOCI_SQLITE3_TEST_CONNSTR=":memory:"</code>.</li>
-</ul>
-<h2 id="building-with-makefiles-on-unix">Building with Makefiles on Unix</h2>
-<p><em>NOTE: These (classic) Makefiles have not been maintained for long time.
-The officially maintained build configuration is CMake.
-If you still want to use these Makefiles, you've been warned that you may need to patch them.</em></p>
-<p>The classic set of Makefiles for Unix/Linux systems is provided for those users who need complete control over the whole processand who can benefit from the basic scaffolding that they can extend on their own.
-In this sense, the basic Makefiles are supposed to provide a minimal starting point for custom experimentation and are not intended to be a complete build/installation solution.
-At the same time, they are complete in the sense that they can compile the library with all test programs and for some users this level of support will be just fine.</p>
-<p>The <code>core</code> directory of the library distribution contains the <code>Makefile.basic</code> that can be used to compile the core part of the library.
-Run <code>make -f Makefile.basic</code> or <code>make -f Makefile.basic shared</code> to get the static and shared versions, respectively.
-Similarly, the <code>backends/&lt;i&gt;name&lt;/i&gt;</code> directory contains the backend part for each supported backend with the appropriate <code>Makefile.basic</code> and the <code>backends/&lt;i&gt;name&lt;/i&gt;/test</code> directory contains the test program for the given backend.</p>
-<p>For example, the simplest way to compile the static version of the library and the test program for PostgreSQL is:</p>
-<pre><code class="language-console">cd src/core
-make -f Makefile.basic
-cd ../backends/postgresql
-make -f Makefile.basic
-cd test
-make -f Makefile.basic
-</code></pre>
-<p>For each backend and its test program, the <code>Makefile.basic</code>s contain the variables that can have values specific to the given environment - they usually name the include and library paths.
-These variables are placed at the beginning of the <code>Makefile.basic</code>s.
-Please review their values in case of any compilation problems.</p>
-<p>The Makefiles for test programs can be a good starting point to find out correct compiler and linker options.</p>
-<h2 id="building-with-conan">Building with Conan</h2>
-<p>SOCI is available as a <a href="https://docs.conan.io/en/latest/">Conan</a> package since
-February 2021 for the version <a href="https://conan.io/center/soci">4.0.1</a> for the
-follwoiing backends: sqlite3, odbc, mysql, and postgresql, and with the
-following flag enabled: <code>SOCI_CXX11=True</code>.</p>
-<p>This section lists the steps required to use SOCI in a CMake project with Conan:</p>
-<h3 id="install-conan">Install Conan</h3>
-<p>Install Conan if it is not installed yet:</p>
-<pre><code class="language-console">pip3 install conan
-</code></pre>
-<h3 id="create-conanfiletxt">Create <code>conanfile.txt</code></h3>
-<p>Create a <code>conanfile.txt</code> in the same directory of the <code>CMakeLists.txt</code>, with a
-<em>reference to a recipe</em> (which is a string with the library name and the
-version to use), the build options, and the CMake generator:</p>
-<pre><code class="language-text"># conanfile.txt
-[requires]
-soci/4.0.1
-
-[options]
-soci:shared       = True
-soci:with_sqlite3 = True
-
-[generators]
-cmake
-</code></pre>
-<p>The option <code>soci:with_sqlite3 = True</code> indicates that the <code>sqlite3</code> backend will
-be downloaded and used.</p>
-<h3 id="update-cmakeliststxt">Update <code>CMakeLists.txt</code></h3>
-<p>Add the following Conan-specific lines to the <code>CMakeLists.txt</code> of your project:</p>
-<pre><code class="language-cmake">include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
-conan_basic_setup(TARGETS)
-conan_target_link_libraries(${PROJECT_NAME} ${CONAN_LIBS})
-</code></pre>
-<p>The command <code>conan_target_link_libraries</code> replaces <code>target_link_libraries</code>.</p>
-<h3 id="run-conan">Run Conan</h3>
-<p>Run <code>conan install</code> to install SOCI, and then build your project as usual:</p>
-<pre><code class="language-bash">mkdir build
-cd build
-conan install .. --build=soci
-cmake ..
-cmake . --build
-</code></pre>
-<h2 id="running-tests">Running tests</h2>
-<p>The process of running regression tests highly depends on user's environment and build configuration, so it may be quite involving process.
-The CMake configuration provides variables to allow users willing to run the tests to configure build and specify database connection parameters (see the lists above for variable names).</p>
-<p>In order to run regression tests, configure and build desired SOCI backends and prepare working database instances for them.</p>
-<p>While configuring build with CMake, specify <code>SOCI_TESTS=ON</code> to enable building regression tests.
-Also, specify <code>SOCI_{backend name}_TEST_CONNSTR</code> variables to tell the tests runner how to connect with your test databases.</p>
-<p>Dedicated <code>make test</code> target can be used to execute regression tests on build completion:</p>
-<pre><code class="language-console">mkdir build
-cd build
-cmake -G &quot;Unix Makefiles&quot; \
-        -DWITH_BOOST=OFF \
-        -DSOCI_TESTS=ON \
-        -DSOCI_EMPTY_TEST_CONNSTR=&quot;dummy connection&quot; \
-        -DSOCI_SQLITE3_TEST_CONNSTR=&quot;test.db&quot; \
-        (...)
-        ../soci-X.Y.Z
-make
-make test
-make install
-</code></pre>
-<p>In the example above, regression tests for the sample Empty backend and SQLite 3 backend are configured for execution by <code>make test</code> target.</p>
-<h2 id="using-library">Using library</h2>
-<p>CMake build produces set of shared and static libraries for SOCI core and backends separately.
-On Unix, for example, <code>build/lib</code> directory will consist of the static libraries named like <code>libsoci_core.a</code>, <code>libsoci_sqlite3.a</code> and shared libraries with names like <code>libsoci_core.so.4.0.0</code>, <code>libsoci_sqlite3.so.4.0.0</code>, and so on.</p>
-<p>If your project also uses CMake, you can simply use <code>find_package(SOCI)</code> to check for SOCI availability and <code>target_link_libraries()</code> to link with the SOCI libraries available under the names <code>SOCI::soci_core</code> and <code>SOCI::soci_&lt;backend&gt;</code> and ensure that SOCI headers can be included (i.e. there is no need to use <code>target_include_directories()</code> explicitly). An example of a very simple CMake-based project using SOCI is provided in the <code>examples/connect</code> directory. \
-Alternatively, you can add SOCI as a subdirectory to your project and include it via <code>add_subdirectory()</code>. As before, <code>target_link_libraries()</code> is used to link with the SOCI libraries available under the names <code>soci_core</code> and <code>soci_&lt;backend&gt;</code> (note: the alias  <code>SOCI::</code> has to be omitted here). In order for SOCI to also find its header files that get generated by CMake, <code>target_include_directories()</code> needs to add SOCI's built include directory <code>${CMAKE_BINARY_DIR/path/to/soci/include}</code>. An example of this can be found in the directory <code>examples/subdir-include</code>.</p>
-<p>If you don't use CMake but want to use SOCI in your program, you need to specify the paths to the SOCI headers and libraries in your build configuration and to
-tell the linker to link against the libraries you want to use in your program.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/interfaces.md b/docs/interfaces.md
new file mode 100644
index 0000000..3648073
--- /dev/null
+++ b/docs/interfaces.md
@@ -0,0 +1,84 @@
+# Interfaces
+
+One of the major features of SOCI, although not immediately visible, is the variety of interfaces (APIs) that are available for the user. These can be divided into *sugar*, *core* and *simple*.
+
+## Sugar
+
+The most exposed and promoted interface supports the syntax sugar that makes SOCI similar in look and feel to embedded SQL.
+The example of application code using this interface is:
+
+```cpp
+session sql("postgresql://dbname=mydb");
+
+int id = 123;
+string name;
+
+sql << "select name from persons where id = :id", into(name), use(id);
+```
+
+## Core
+
+The above example is equivalent to the following, more explicit sequence of calls:
+
+```cpp
+session sql("postgresql://dbname=mydb");
+
+int id = 123;
+string name;
+
+statement st(sql);
+st.exchange(into(name));
+st.exchange(use(id));
+st.alloc();
+st.prepare("select name from persons where id = :id");
+st.define_and_bind();
+st.execute(true);
+```
+
+The value of the *core* interface is that it is the basis for all other interfaces, and can be also used by developers to easily prepare their own convenience interfaces.
+Users who cannot or for some reason do not want to use the natural *sugar* interface should try the *core* one as the foundation and access point to all SOCI functionality.
+
+Note that the *sugar* interface wraps only those parts of the *core* that are related to data binding and query streaming.
+
+## Simple
+
+The *simple* interface is provided specifically to allow easy integration of the SOCI library with other languages that have the ability to link with binaries using the "C" calling convention.
+To facilitate this integration, the *simple* interface does not use any pointers to data except C-style strings and opaque handles, but the consequence of this is that user data is managed by SOCI and not by user code.
+To avoid exceptions passing the module boundaries, all errors are reported as state variables of relevant objects.
+
+The above examples can be rewritten as (without error-handling):
+
+```cpp
+#include <soci-simple.h>
+
+// ...
+session_handle sql = soci_create_session("postgresql://dbname=mydb");
+
+statement_handle st = soci_create_statement(sql);
+
+soci_use_int(st, "id");
+soci_set_use_int(st, "id", 123);
+
+int namePosition = soci_into_string(st);
+
+soci_prepare(st, "select name from persons where id = :id");
+
+soci_execute(st, true);
+
+char const * name = soci_get_into_string(st, namePosition);
+
+printf("name is %s\n", name);
+
+soci_destroy_statement(st);
+soci_destroy_session(sql);
+```
+
+The *simple* interface supports single and bulk data exchange for static binding.
+Dynamic row description is not supported in this release.
+
+See [Simple client interface](api/client.md#simple-client-interface) reference documentation for more details.
+
+## Low-level backend interface
+
+The low-level backend interface allows to interact with backends directly and in principle allows to access the database without involving any other component.
+There is no particular reason to use this interface in the user code.
diff --git a/docs/interfaces/index.html b/docs/interfaces/index.html
deleted file mode 100644
index ee41da6..0000000
--- a/docs/interfaces/index.html
+++ /dev/null
@@ -1,419 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Interfaces - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../logging/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../backends/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/interfaces.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#interfaces" class="nav-link">Interfaces</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#sugar" class="nav-link">Sugar</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#core" class="nav-link">Core</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#simple" class="nav-link">Simple</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#low-level-backend-interface" class="nav-link">Low-level backend interface</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="interfaces">Interfaces</h1>
-<p>One of the major features of SOCI, although not immediately visible, is the variety of interfaces (APIs) that are available for the user. These can be divided into <em>sugar</em>, <em>core</em> and <em>simple</em>.</p>
-<h2 id="sugar">Sugar</h2>
-<p>The most exposed and promoted interface supports the syntax sugar that makes SOCI similar in look and feel to embedded SQL.
-The example of application code using this interface is:</p>
-<pre><code class="language-cpp">session sql(&quot;postgresql://dbname=mydb&quot;);
-
-int id = 123;
-string name;
-
-sql &lt;&lt; &quot;select name from persons where id = :id&quot;, into(name), use(id);
-</code></pre>
-<h2 id="core">Core</h2>
-<p>The above example is equivalent to the following, more explicit sequence of calls:</p>
-<pre><code class="language-cpp">session sql(&quot;postgresql://dbname=mydb&quot;);
-
-int id = 123;
-string name;
-
-statement st(sql);
-st.exchange(into(name));
-st.exchange(use(id));
-st.alloc();
-st.prepare(&quot;select name from persons where id = :id&quot;);
-st.define_and_bind();
-st.execute(true);
-</code></pre>
-<p>The value of the <em>core</em> interface is that it is the basis for all other interfaces, and can be also used by developers to easily prepare their own convenience interfaces.
-Users who cannot or for some reason do not want to use the natural <em>sugar</em> interface should try the <em>core</em> one as the foundation and access point to all SOCI functionality.</p>
-<p>Note that the <em>sugar</em> interface wraps only those parts of the <em>core</em> that are related to data binding and query streaming.</p>
-<h2 id="simple">Simple</h2>
-<p>The <em>simple</em> interface is provided specifically to allow easy integration of the SOCI library with other languages that have the ability to link with binaries using the "C" calling convention.
-To facilitate this integration, the <em>simple</em> interface does not use any pointers to data except C-style strings and opaque handles, but the consequence of this is that user data is managed by SOCI and not by user code.
-To avoid exceptions passing the module boundaries, all errors are reported as state variables of relevant objects.</p>
-<p>The above examples can be rewritten as (without error-handling):</p>
-<pre><code class="language-cpp">#include &lt;soci-simple.h&gt;
-
-// ...
-session_handle sql = soci_create_session(&quot;postgresql://dbname=mydb&quot;);
-
-statement_handle st = soci_create_statement(sql);
-
-soci_use_int(st, &quot;id&quot;);
-soci_set_use_int(st, &quot;id&quot;, 123);
-
-int namePosition = soci_into_string(st);
-
-soci_prepare(st, &quot;select name from persons where id = :id&quot;);
-
-soci_execute(st, true);
-
-char const * name = soci_get_into_string(st, namePosition);
-
-printf(&quot;name is %s\n&quot;, name);
-
-soci_destroy_statement(st);
-soci_destroy_session(sql);
-</code></pre>
-<p>The <em>simple</em> interface supports single and bulk data exchange for static binding.
-Dynamic row description is not supported in this release.</p>
-<p>See <a href="../api/client/#simple-client-interface">Simple client interface</a> reference documentation for more details.</p>
-<h2 id="low-level-backend-interface">Low-level backend interface</h2>
-<p>The low-level backend interface allows to interact with backends directly and in principle allows to access the database without involving any other component.
-There is no particular reason to use this interface in the user code.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/js/base.js b/docs/js/base.js
deleted file mode 100644
index b0f4726..0000000
--- a/docs/js/base.js
+++ /dev/null
@@ -1,283 +0,0 @@
-function getSearchTerm() {
-    var sPageURL = window.location.search.substring(1);
-    var sURLVariables = sPageURL.split('&');
-    for (var i = 0; i < sURLVariables.length; i++) {
-        var sParameterName = sURLVariables[i].split('=');
-        if (sParameterName[0] == 'q') {
-            return sParameterName[1];
-        }
-    }
-}
-
-function applyTopPadding() {
-    // Update various absolute positions to match where the main container
-    // starts. This is necessary for handling multi-line nav headers, since
-    // that pushes the main container down.
-    var offset = $('body > .container').offset();
-    $('html').css('scroll-padding-top', offset.top + 'px');
-    $('.bs-sidebar.affix').css('top', offset.top + 'px');
-}
-
-$(document).ready(function() {
-
-    applyTopPadding();
-
-    var search_term = getSearchTerm(),
-        $search_modal = $('#mkdocs_search_modal'),
-        $keyboard_modal = $('#mkdocs_keyboard_modal');
-
-    if (search_term) {
-        $search_modal.modal();
-    }
-
-    // make sure search input gets autofocus every time modal opens.
-    $search_modal.on('shown.bs.modal', function() {
-        $search_modal.find('#mkdocs-search-query').focus();
-    });
-
-    // Close search modal when result is selected
-    // The links get added later so listen to parent
-    $('#mkdocs-search-results').click(function(e) {
-        if ($(e.target).is('a')) {
-            $search_modal.modal('hide');
-        }
-    });
-
-    // Populate keyboard modal with proper Keys
-    $keyboard_modal.find('.help.shortcut kbd')[0].innerHTML = keyCodes[shortcuts.help];
-    $keyboard_modal.find('.prev.shortcut kbd')[0].innerHTML = keyCodes[shortcuts.previous];
-    $keyboard_modal.find('.next.shortcut kbd')[0].innerHTML = keyCodes[shortcuts.next];
-    $keyboard_modal.find('.search.shortcut kbd')[0].innerHTML = keyCodes[shortcuts.search];
-
-    // Keyboard navigation
-    document.addEventListener("keydown", function(e) {
-        if ($(e.target).is(':input')) return true;
-        var key = e.which || e.keyCode || window.event && window.event.keyCode;
-        var page;
-        switch (key) {
-            case shortcuts.next:
-                page = $('.navbar a[rel="next"]:first').prop('href');
-                break;
-            case shortcuts.previous:
-                page = $('.navbar a[rel="prev"]:first').prop('href');
-                break;
-            case shortcuts.search:
-                e.preventDefault();
-                $keyboard_modal.modal('hide');
-                $search_modal.modal('show');
-                $search_modal.find('#mkdocs-search-query').focus();
-                break;
-            case shortcuts.help:
-                $search_modal.modal('hide');
-                $keyboard_modal.modal('show');
-                break;
-            default: break;
-        }
-        if (page) {
-            $keyboard_modal.modal('hide');
-            window.location.href = page;
-        }
-    });
-
-    $('table').addClass('table table-striped table-hover');
-
-    // Improve the scrollspy behaviour when users click on a TOC item.
-    $(".bs-sidenav a").on("click", function() {
-        var clicked = this;
-        setTimeout(function() {
-            var active = $('.nav li.active a');
-            active = active[active.length - 1];
-            if (clicked !== active) {
-                $(active).parent().removeClass("active");
-                $(clicked).parent().addClass("active");
-            }
-        }, 50);
-    });
-
-    function showInnerDropdown(item) {
-        var popup = $(item).next('.dropdown-menu');
-        popup.addClass('show');
-        $(item).addClass('open');
-
-        // First, close any sibling dropdowns.
-        var container = $(item).parent().parent();
-        container.find('> .dropdown-submenu > a').each(function(i, el) {
-            if (el !== item) {
-                hideInnerDropdown(el);
-            }
-        });
-
-        var popupMargin = 10;
-        var maxBottom = $(window).height() - popupMargin;
-        var bounds = item.getBoundingClientRect();
-
-        popup.css('left', bounds.right + 'px');
-        if (bounds.top + popup.height() > maxBottom &&
-            bounds.top > $(window).height() / 2) {
-            popup.css({
-                'top': (bounds.bottom - popup.height()) + 'px',
-                'max-height': (bounds.bottom - popupMargin) + 'px',
-            });
-        } else {
-            popup.css({
-                'top': bounds.top + 'px',
-                'max-height': (maxBottom - bounds.top) + 'px',
-            });
-        }
-    }
-
-    function hideInnerDropdown(item) {
-        var popup = $(item).next('.dropdown-menu');
-        popup.removeClass('show');
-        $(item).removeClass('open');
-
-        popup.scrollTop(0);
-        popup.find('.dropdown-menu').scrollTop(0).removeClass('show');
-        popup.find('.dropdown-submenu > a').removeClass('open');
-    }
-
-    $('.dropdown-submenu > a').on('click', function(e) {
-        if ($(this).next('.dropdown-menu').hasClass('show')) {
-            hideInnerDropdown(this);
-        } else {
-            showInnerDropdown(this);
-        }
-
-        e.stopPropagation();
-        e.preventDefault();
-    });
-
-    $('.dropdown-menu').parent().on('hide.bs.dropdown', function(e) {
-        $(this).find('.dropdown-menu').scrollTop(0);
-        $(this).find('.dropdown-submenu > a').removeClass('open');
-        $(this).find('.dropdown-menu .dropdown-menu').removeClass('show');
-    });
-});
-
-$(window).on('resize', applyTopPadding);
-
-$('body').scrollspy({
-    target: '.bs-sidebar',
-    offset: 100
-});
-
-/* Prevent disabled links from causing a page reload */
-$("li.disabled a").click(function() {
-    event.preventDefault();
-});
-
-// See https://www.cambiaresearch.com/articles/15/javascript-char-codes-key-codes
-// We only list common keys below. Obscure keys are omitted and their use is discouraged.
-var keyCodes = {
-    8: 'backspace',
-    9: 'tab',
-    13: 'enter',
-    16: 'shift',
-    17: 'ctrl',
-    18: 'alt',
-    19: 'pause/break',
-    20: 'caps lock',
-    27: 'escape',
-    32: 'spacebar',
-    33: 'page up',
-    34: 'page down',
-    35: 'end',
-    36: 'home',
-    37: '&larr;',
-    38: '&uarr;',
-    39: '&rarr;',
-    40: '&darr;',
-    45: 'insert',
-    46: 'delete',
-    48: '0',
-    49: '1',
-    50: '2',
-    51: '3',
-    52: '4',
-    53: '5',
-    54: '6',
-    55: '7',
-    56: '8',
-    57: '9',
-    65: 'a',
-    66: 'b',
-    67: 'c',
-    68: 'd',
-    69: 'e',
-    70: 'f',
-    71: 'g',
-    72: 'h',
-    73: 'i',
-    74: 'j',
-    75: 'k',
-    76: 'l',
-    77: 'm',
-    78: 'n',
-    79: 'o',
-    80: 'p',
-    81: 'q',
-    82: 'r',
-    83: 's',
-    84: 't',
-    85: 'u',
-    86: 'v',
-    87: 'w',
-    88: 'x',
-    89: 'y',
-    90: 'z',
-    91: 'Left Windows Key / Left ⌘',
-    92: 'Right Windows Key',
-    93: 'Windows Menu / Right ⌘',
-    96: 'numpad 0',
-    97: 'numpad 1',
-    98: 'numpad 2',
-    99: 'numpad 3',
-    100: 'numpad 4',
-    101: 'numpad 5',
-    102: 'numpad 6',
-    103: 'numpad 7',
-    104: 'numpad 8',
-    105: 'numpad 9',
-    106: 'multiply',
-    107: 'add',
-    109: 'subtract',
-    110: 'decimal point',
-    111: 'divide',
-    112: 'f1',
-    113: 'f2',
-    114: 'f3',
-    115: 'f4',
-    116: 'f5',
-    117: 'f6',
-    118: 'f7',
-    119: 'f8',
-    120: 'f9',
-    121: 'f10',
-    122: 'f11',
-    123: 'f12',
-    124: 'f13',
-    125: 'f14',
-    126: 'f15',
-    127: 'f16',
-    128: 'f17',
-    129: 'f18',
-    130: 'f19',
-    131: 'f20',
-    132: 'f21',
-    133: 'f22',
-    134: 'f23',
-    135: 'f24',
-    144: 'num lock',
-    145: 'scroll lock',
-    186: '&semi;',
-    187: '&equals;',
-    188: '&comma;',
-    189: '&hyphen;',
-    190: '&period;',
-    191: '&quest;',
-    192: '&grave;',
-    219: '&lsqb;',
-    220: '&bsol;',
-    221: '&rsqb;',
-    222: '&apos;',
-};
diff --git a/docs/js/bootstrap.min.js b/docs/js/bootstrap.min.js
deleted file mode 100644
index ca013b7..0000000
--- a/docs/js/bootstrap.min.js
+++ /dev/null
@@ -1,7 +0,0 @@
-/*!
-  * Bootstrap v4.3.1 (https://getbootstrap.com/)
-  * Copyright 2011-2019 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors)
-  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
-  */
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("jquery"),require("popper.js")):"function"==typeof define&&define.amd?define(["exports","jquery","popper.js"],e):e((t=t||self).bootstrap={},t.jQuery,t.Popper)}(this,function(t,g,u){"use strict";function i(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}function s(t,e,n){return e&&i(t.prototype,e),n&&i(t,n),t}function l(o){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},e=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(e=e.concat(Object.getOwnPropertySymbols(r).filter(function(t){return Object.getOwnPropertyDescriptor(r,t).enumerable}))),e.forEach(function(t){var e,n,i;e=o,i=r[n=t],n in e?Object.defineProperty(e,n,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[n]=i})}return o}g=g&&g.hasOwnProperty("default")?g.default:g,u=u&&u.hasOwnProperty("default")?u.default:u;var e="transitionend";function n(t){var e=this,n=!1;return g(this).one(_.TRANSITION_END,function(){n=!0}),setTimeout(function(){n||_.triggerTransitionEnd(e)},t),this}var _={TRANSITION_END:"bsTransitionEnd",getUID:function(t){for(;t+=~~(1e6*Math.random()),document.getElementById(t););return t},getSelectorFromElement:function(t){var e=t.getAttribute("data-target");if(!e||"#"===e){var n=t.getAttribute("href");e=n&&"#"!==n?n.trim():""}try{return document.querySelector(e)?e:null}catch(t){return null}},getTransitionDurationFromElement:function(t){if(!t)return 0;var e=g(t).css("transition-duration"),n=g(t).css("transition-delay"),i=parseFloat(e),o=parseFloat(n);return i||o?(e=e.split(",")[0],n=n.split(",")[0],1e3*(parseFloat(e)+parseFloat(n))):0},reflow:function(t){return t.offsetHeight},triggerTransitionEnd:function(t){g(t).trigger(e)},supportsTransitionEnd:function(){return Boolean(e)},isElement:function(t){return(t[0]||t).nodeType},typeCheckConfig:function(t,e,n){for(var i in n)if(Object.prototype.hasOwnProperty.call(n,i)){var o=n[i],r=e[i],s=r&&_.isElement(r)?"element":(a=r,{}.toString.call(a).match(/\s([a-z]+)/i)[1].toLowerCase());if(!new RegExp(o).test(s))throw new Error(t.toUpperCase()+': Option "'+i+'" provided type "'+s+'" but expected type "'+o+'".')}var a},findShadowRoot:function(t){if(!document.documentElement.attachShadow)return null;if("function"!=typeof t.getRootNode)return t instanceof ShadowRoot?t:t.parentNode?_.findShadowRoot(t.parentNode):null;var e=t.getRootNode();return e instanceof ShadowRoot?e:null}};g.fn.emulateTransitionEnd=n,g.event.special[_.TRANSITION_END]={bindType:e,delegateType:e,handle:function(t){if(g(t.target).is(this))return t.handleObj.handler.apply(this,arguments)}};var o="alert",r="bs.alert",a="."+r,c=g.fn[o],h={CLOSE:"close"+a,CLOSED:"closed"+a,CLICK_DATA_API:"click"+a+".data-api"},f="alert",d="fade",m="show",p=function(){function i(t){this._element=t}var t=i.prototype;return t.close=function(t){var e=this._element;t&&(e=this._getRootElement(t)),this._triggerCloseEvent(e).isDefaultPrevented()||this._removeElement(e)},t.dispose=function(){g.removeData(this._element,r),this._element=null},t._getRootElement=function(t){var e=_.getSelectorFromElement(t),n=!1;return e&&(n=document.querySelector(e)),n||(n=g(t).closest("."+f)[0]),n},t._triggerCloseEvent=function(t){var e=g.Event(h.CLOSE);return g(t).trigger(e),e},t._removeElement=function(e){var n=this;if(g(e).removeClass(m),g(e).hasClass(d)){var t=_.getTransitionDurationFromElement(e);g(e).one(_.TRANSITION_END,function(t){return n._destroyElement(e,t)}).emulateTransitionEnd(t)}else this._destroyElement(e)},t._destroyElement=function(t){g(t).detach().trigger(h.CLOSED).remove()},i._jQueryInterface=function(n){return this.each(function(){var t=g(this),e=t.data(r);e||(e=new i(this),t.data(r,e)),"close"===n&&e[n](this)})},i._handleDismiss=function(e){return function(t){t&&t.preventDefault(),e.close(this)}},s(i,null,[{key:"VERSION",get:function(){return"4.3.1"}}]),i}();g(document).on(h.CLICK_DATA_API,'[data-dismiss="alert"]',p._handleDismiss(new p)),g.fn[o]=p._jQueryInterface,g.fn[o].Constructor=p,g.fn[o].noConflict=function(){return g.fn[o]=c,p._jQueryInterface};var v="button",y="bs.button",E="."+y,C=".data-api",T=g.fn[v],S="active",b="btn",I="focus",D='[data-toggle^="button"]',w='[data-toggle="buttons"]',A='input:not([type="hidden"])',N=".active",O=".btn",k={CLICK_DATA_API:"click"+E+C,FOCUS_BLUR_DATA_API:"focus"+E+C+" blur"+E+C},P=function(){function n(t){this._element=t}var t=n.prototype;return t.toggle=function(){var t=!0,e=!0,n=g(this._element).closest(w)[0];if(n){var i=this._element.querySelector(A);if(i){if("radio"===i.type)if(i.checked&&this._element.classList.contains(S))t=!1;else{var o=n.querySelector(N);o&&g(o).removeClass(S)}if(t){if(i.hasAttribute("disabled")||n.hasAttribute("disabled")||i.classList.contains("disabled")||n.classList.contains("disabled"))return;i.checked=!this._element.classList.contains(S),g(i).trigger("change")}i.focus(),e=!1}}e&&this._element.setAttribute("aria-pressed",!this._element.classList.contains(S)),t&&g(this._element).toggleClass(S)},t.dispose=function(){g.removeData(this._element,y),this._element=null},n._jQueryInterface=function(e){return this.each(function(){var t=g(this).data(y);t||(t=new n(this),g(this).data(y,t)),"toggle"===e&&t[e]()})},s(n,null,[{key:"VERSION",get:function(){return"4.3.1"}}]),n}();g(document).on(k.CLICK_DATA_API,D,function(t){t.preventDefault();var e=t.target;g(e).hasClass(b)||(e=g(e).closest(O)),P._jQueryInterface.call(g(e),"toggle")}).on(k.FOCUS_BLUR_DATA_API,D,function(t){var e=g(t.target).closest(O)[0];g(e).toggleClass(I,/^focus(in)?$/.test(t.type))}),g.fn[v]=P._jQueryInterface,g.fn[v].Constructor=P,g.fn[v].noConflict=function(){return g.fn[v]=T,P._jQueryInterface};var L="carousel",j="bs.carousel",H="."+j,R=".data-api",x=g.fn[L],F={interval:5e3,keyboard:!0,slide:!1,pause:"hover",wrap:!0,touch:!0},U={interval:"(number|boolean)",keyboard:"boolean",slide:"(boolean|string)",pause:"(string|boolean)",wrap:"boolean",touch:"boolean"},W="next",q="prev",M="left",K="right",Q={SLIDE:"slide"+H,SLID:"slid"+H,KEYDOWN:"keydown"+H,MOUSEENTER:"mouseenter"+H,MOUSELEAVE:"mouseleave"+H,TOUCHSTART:"touchstart"+H,TOUCHMOVE:"touchmove"+H,TOUCHEND:"touchend"+H,POINTERDOWN:"pointerdown"+H,POINTERUP:"pointerup"+H,DRAG_START:"dragstart"+H,LOAD_DATA_API:"load"+H+R,CLICK_DATA_API:"click"+H+R},B="carousel",V="active",Y="slide",z="carousel-item-right",X="carousel-item-left",$="carousel-item-next",G="carousel-item-prev",J="pointer-event",Z=".active",tt=".active.carousel-item",et=".carousel-item",nt=".carousel-item img",it=".carousel-item-next, .carousel-item-prev",ot=".carousel-indicators",rt="[data-slide], [data-slide-to]",st='[data-ride="carousel"]',at={TOUCH:"touch",PEN:"pen"},lt=function(){function r(t,e){this._items=null,this._interval=null,this._activeElement=null,this._isPaused=!1,this._isSliding=!1,this.touchTimeout=null,this.touchStartX=0,this.touchDeltaX=0,this._config=this._getConfig(e),this._element=t,this._indicatorsElement=this._element.querySelector(ot),this._touchSupported="ontouchstart"in document.documentElement||0<navigator.maxTouchPoints,this._pointerEvent=Boolean(window.PointerEvent||window.MSPointerEvent),this._addEventListeners()}var t=r.prototype;return t.next=function(){this._isSliding||this._slide(W)},t.nextWhenVisible=function(){!document.hidden&&g(this._element).is(":visible")&&"hidden"!==g(this._element).css("visibility")&&this.next()},t.prev=function(){this._isSliding||this._slide(q)},t.pause=function(t){t||(this._isPaused=!0),this._element.querySelector(it)&&(_.triggerTransitionEnd(this._element),this.cycle(!0)),clearInterval(this._interval),this._interval=null},t.cycle=function(t){t||(this._isPaused=!1),this._interval&&(clearInterval(this._interval),this._interval=null),this._config.interval&&!this._isPaused&&(this._interval=setInterval((document.visibilityState?this.nextWhenVisible:this.next).bind(this),this._config.interval))},t.to=function(t){var e=this;this._activeElement=this._element.querySelector(tt);var n=this._getItemIndex(this._activeElement);if(!(t>this._items.length-1||t<0))if(this._isSliding)g(this._element).one(Q.SLID,function(){return e.to(t)});else{if(n===t)return this.pause(),void this.cycle();var i=n<t?W:q;this._slide(i,this._items[t])}},t.dispose=function(){g(this._element).off(H),g.removeData(this._element,j),this._items=null,this._config=null,this._element=null,this._interval=null,this._isPaused=null,this._isSliding=null,this._activeElement=null,this._indicatorsElement=null},t._getConfig=function(t){return t=l({},F,t),_.typeCheckConfig(L,t,U),t},t._handleSwipe=function(){var t=Math.abs(this.touchDeltaX);if(!(t<=40)){var e=t/this.touchDeltaX;0<e&&this.prev(),e<0&&this.next()}},t._addEventListeners=function(){var e=this;this._config.keyboard&&g(this._element).on(Q.KEYDOWN,function(t){return e._keydown(t)}),"hover"===this._config.pause&&g(this._element).on(Q.MOUSEENTER,function(t){return e.pause(t)}).on(Q.MOUSELEAVE,function(t){return e.cycle(t)}),this._config.touch&&this._addTouchEventListeners()},t._addTouchEventListeners=function(){var n=this;if(this._touchSupported){var e=function(t){n._pointerEvent&&at[t.originalEvent.pointerType.toUpperCase()]?n.touchStartX=t.originalEvent.clientX:n._pointerEvent||(n.touchStartX=t.originalEvent.touches[0].clientX)},i=function(t){n._pointerEvent&&at[t.originalEvent.pointerType.toUpperCase()]&&(n.touchDeltaX=t.originalEvent.clientX-n.touchStartX),n._handleSwipe(),"hover"===n._config.pause&&(n.pause(),n.touchTimeout&&clearTimeout(n.touchTimeout),n.touchTimeout=setTimeout(function(t){return n.cycle(t)},500+n._config.interval))};g(this._element.querySelectorAll(nt)).on(Q.DRAG_START,function(t){return t.preventDefault()}),this._pointerEvent?(g(this._element).on(Q.POINTERDOWN,function(t){return e(t)}),g(this._element).on(Q.POINTERUP,function(t){return i(t)}),this._element.classList.add(J)):(g(this._element).on(Q.TOUCHSTART,function(t){return e(t)}),g(this._element).on(Q.TOUCHMOVE,function(t){var e;(e=t).originalEvent.touches&&1<e.originalEvent.touches.length?n.touchDeltaX=0:n.touchDeltaX=e.originalEvent.touches[0].clientX-n.touchStartX}),g(this._element).on(Q.TOUCHEND,function(t){return i(t)}))}},t._keydown=function(t){if(!/input|textarea/i.test(t.target.tagName))switch(t.which){case 37:t.preventDefault(),this.prev();break;case 39:t.preventDefault(),this.next()}},t._getItemIndex=function(t){return this._items=t&&t.parentNode?[].slice.call(t.parentNode.querySelectorAll(et)):[],this._items.indexOf(t)},t._getItemByDirection=function(t,e){var n=t===W,i=t===q,o=this._getItemIndex(e),r=this._items.length-1;if((i&&0===o||n&&o===r)&&!this._config.wrap)return e;var s=(o+(t===q?-1:1))%this._items.length;return-1===s?this._items[this._items.length-1]:this._items[s]},t._triggerSlideEvent=function(t,e){var n=this._getItemIndex(t),i=this._getItemIndex(this._element.querySelector(tt)),o=g.Event(Q.SLIDE,{relatedTarget:t,direction:e,from:i,to:n});return g(this._element).trigger(o),o},t._setActiveIndicatorElement=function(t){if(this._indicatorsElement){var e=[].slice.call(this._indicatorsElement.querySelectorAll(Z));g(e).removeClass(V);var n=this._indicatorsElement.children[this._getItemIndex(t)];n&&g(n).addClass(V)}},t._slide=function(t,e){var n,i,o,r=this,s=this._element.querySelector(tt),a=this._getItemIndex(s),l=e||s&&this._getItemByDirection(t,s),c=this._getItemIndex(l),h=Boolean(this._interval);if(o=t===W?(n=X,i=$,M):(n=z,i=G,K),l&&g(l).hasClass(V))this._isSliding=!1;else if(!this._triggerSlideEvent(l,o).isDefaultPrevented()&&s&&l){this._isSliding=!0,h&&this.pause(),this._setActiveIndicatorElement(l);var u=g.Event(Q.SLID,{relatedTarget:l,direction:o,from:a,to:c});if(g(this._element).hasClass(Y)){g(l).addClass(i),_.reflow(l),g(s).addClass(n),g(l).addClass(n);var f=parseInt(l.getAttribute("data-interval"),10);this._config.interval=f?(this._config.defaultInterval=this._config.defaultInterval||this._config.interval,f):this._config.defaultInterval||this._config.interval;var d=_.getTransitionDurationFromElement(s);g(s).one(_.TRANSITION_END,function(){g(l).removeClass(n+" "+i).addClass(V),g(s).removeClass(V+" "+i+" "+n),r._isSliding=!1,setTimeout(function(){return g(r._element).trigger(u)},0)}).emulateTransitionEnd(d)}else g(s).removeClass(V),g(l).addClass(V),this._isSliding=!1,g(this._element).trigger(u);h&&this.cycle()}},r._jQueryInterface=function(i){return this.each(function(){var t=g(this).data(j),e=l({},F,g(this).data());"object"==typeof i&&(e=l({},e,i));var n="string"==typeof i?i:e.slide;if(t||(t=new r(this,e),g(this).data(j,t)),"number"==typeof i)t.to(i);else if("string"==typeof n){if("undefined"==typeof t[n])throw new TypeError('No method named "'+n+'"');t[n]()}else e.interval&&e.ride&&(t.pause(),t.cycle())})},r._dataApiClickHandler=function(t){var e=_.getSelectorFromElement(this);if(e){var n=g(e)[0];if(n&&g(n).hasClass(B)){var i=l({},g(n).data(),g(this).data()),o=this.getAttribute("data-slide-to");o&&(i.interval=!1),r._jQueryInterface.call(g(n),i),o&&g(n).data(j).to(o),t.preventDefault()}}},s(r,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return F}}]),r}();g(document).on(Q.CLICK_DATA_API,rt,lt._dataApiClickHandler),g(window).on(Q.LOAD_DATA_API,function(){for(var t=[].slice.call(document.querySelectorAll(st)),e=0,n=t.length;e<n;e++){var i=g(t[e]);lt._jQueryInterface.call(i,i.data())}}),g.fn[L]=lt._jQueryInterface,g.fn[L].Constructor=lt,g.fn[L].noConflict=function(){return g.fn[L]=x,lt._jQueryInterface};var ct="collapse",ht="bs.collapse",ut="."+ht,ft=g.fn[ct],dt={toggle:!0,parent:""},gt={toggle:"boolean",parent:"(string|element)"},_t={SHOW:"show"+ut,SHOWN:"shown"+ut,HIDE:"hide"+ut,HIDDEN:"hidden"+ut,CLICK_DATA_API:"click"+ut+".data-api"},mt="show",pt="collapse",vt="collapsing",yt="collapsed",Et="width",Ct="height",Tt=".show, .collapsing",St='[data-toggle="collapse"]',bt=function(){function a(e,t){this._isTransitioning=!1,this._element=e,this._config=this._getConfig(t),this._triggerArray=[].slice.call(document.querySelectorAll('[data-toggle="collapse"][href="#'+e.id+'"],[data-toggle="collapse"][data-target="#'+e.id+'"]'));for(var n=[].slice.call(document.querySelectorAll(St)),i=0,o=n.length;i<o;i++){var r=n[i],s=_.getSelectorFromElement(r),a=[].slice.call(document.querySelectorAll(s)).filter(function(t){return t===e});null!==s&&0<a.length&&(this._selector=s,this._triggerArray.push(r))}this._parent=this._config.parent?this._getParent():null,this._config.parent||this._addAriaAndCollapsedClass(this._element,this._triggerArray),this._config.toggle&&this.toggle()}var t=a.prototype;return t.toggle=function(){g(this._element).hasClass(mt)?this.hide():this.show()},t.show=function(){var t,e,n=this;if(!this._isTransitioning&&!g(this._element).hasClass(mt)&&(this._parent&&0===(t=[].slice.call(this._parent.querySelectorAll(Tt)).filter(function(t){return"string"==typeof n._config.parent?t.getAttribute("data-parent")===n._config.parent:t.classList.contains(pt)})).length&&(t=null),!(t&&(e=g(t).not(this._selector).data(ht))&&e._isTransitioning))){var i=g.Event(_t.SHOW);if(g(this._element).trigger(i),!i.isDefaultPrevented()){t&&(a._jQueryInterface.call(g(t).not(this._selector),"hide"),e||g(t).data(ht,null));var o=this._getDimension();g(this._element).removeClass(pt).addClass(vt),this._element.style[o]=0,this._triggerArray.length&&g(this._triggerArray).removeClass(yt).attr("aria-expanded",!0),this.setTransitioning(!0);var r="scroll"+(o[0].toUpperCase()+o.slice(1)),s=_.getTransitionDurationFromElement(this._element);g(this._element).one(_.TRANSITION_END,function(){g(n._element).removeClass(vt).addClass(pt).addClass(mt),n._element.style[o]="",n.setTransitioning(!1),g(n._element).trigger(_t.SHOWN)}).emulateTransitionEnd(s),this._element.style[o]=this._element[r]+"px"}}},t.hide=function(){var t=this;if(!this._isTransitioning&&g(this._element).hasClass(mt)){var e=g.Event(_t.HIDE);if(g(this._element).trigger(e),!e.isDefaultPrevented()){var n=this._getDimension();this._element.style[n]=this._element.getBoundingClientRect()[n]+"px",_.reflow(this._element),g(this._element).addClass(vt).removeClass(pt).removeClass(mt);var i=this._triggerArray.length;if(0<i)for(var o=0;o<i;o++){var r=this._triggerArray[o],s=_.getSelectorFromElement(r);if(null!==s)g([].slice.call(document.querySelectorAll(s))).hasClass(mt)||g(r).addClass(yt).attr("aria-expanded",!1)}this.setTransitioning(!0);this._element.style[n]="";var a=_.getTransitionDurationFromElement(this._element);g(this._element).one(_.TRANSITION_END,function(){t.setTransitioning(!1),g(t._element).removeClass(vt).addClass(pt).trigger(_t.HIDDEN)}).emulateTransitionEnd(a)}}},t.setTransitioning=function(t){this._isTransitioning=t},t.dispose=function(){g.removeData(this._element,ht),this._config=null,this._parent=null,this._element=null,this._triggerArray=null,this._isTransitioning=null},t._getConfig=function(t){return(t=l({},dt,t)).toggle=Boolean(t.toggle),_.typeCheckConfig(ct,t,gt),t},t._getDimension=function(){return g(this._element).hasClass(Et)?Et:Ct},t._getParent=function(){var t,n=this;_.isElement(this._config.parent)?(t=this._config.parent,"undefined"!=typeof this._config.parent.jquery&&(t=this._config.parent[0])):t=document.querySelector(this._config.parent);var e='[data-toggle="collapse"][data-parent="'+this._config.parent+'"]',i=[].slice.call(t.querySelectorAll(e));return g(i).each(function(t,e){n._addAriaAndCollapsedClass(a._getTargetFromElement(e),[e])}),t},t._addAriaAndCollapsedClass=function(t,e){var n=g(t).hasClass(mt);e.length&&g(e).toggleClass(yt,!n).attr("aria-expanded",n)},a._getTargetFromElement=function(t){var e=_.getSelectorFromElement(t);return e?document.querySelector(e):null},a._jQueryInterface=function(i){return this.each(function(){var t=g(this),e=t.data(ht),n=l({},dt,t.data(),"object"==typeof i&&i?i:{});if(!e&&n.toggle&&/show|hide/.test(i)&&(n.toggle=!1),e||(e=new a(this,n),t.data(ht,e)),"string"==typeof i){if("undefined"==typeof e[i])throw new TypeError('No method named "'+i+'"');e[i]()}})},s(a,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return dt}}]),a}();g(document).on(_t.CLICK_DATA_API,St,function(t){"A"===t.currentTarget.tagName&&t.preventDefault();var n=g(this),e=_.getSelectorFromElement(this),i=[].slice.call(document.querySelectorAll(e));g(i).each(function(){var t=g(this),e=t.data(ht)?"toggle":n.data();bt._jQueryInterface.call(t,e)})}),g.fn[ct]=bt._jQueryInterface,g.fn[ct].Constructor=bt,g.fn[ct].noConflict=function(){return g.fn[ct]=ft,bt._jQueryInterface};var It="dropdown",Dt="bs.dropdown",wt="."+Dt,At=".data-api",Nt=g.fn[It],Ot=new RegExp("38|40|27"),kt={HIDE:"hide"+wt,HIDDEN:"hidden"+wt,SHOW:"show"+wt,SHOWN:"shown"+wt,CLICK:"click"+wt,CLICK_DATA_API:"click"+wt+At,KEYDOWN_DATA_API:"keydown"+wt+At,KEYUP_DATA_API:"keyup"+wt+At},Pt="disabled",Lt="show",jt="dropup",Ht="dropright",Rt="dropleft",xt="dropdown-menu-right",Ft="position-static",Ut='[data-toggle="dropdown"]',Wt=".dropdown form",qt=".dropdown-menu",Mt=".navbar-nav",Kt=".dropdown-menu .dropdown-item:not(.disabled):not(:disabled)",Qt="top-start",Bt="top-end",Vt="bottom-start",Yt="bottom-end",zt="right-start",Xt="left-start",$t={offset:0,flip:!0,boundary:"scrollParent",reference:"toggle",display:"dynamic"},Gt={offset:"(number|string|function)",flip:"boolean",boundary:"(string|element)",reference:"(string|element)",display:"string"},Jt=function(){function c(t,e){this._element=t,this._popper=null,this._config=this._getConfig(e),this._menu=this._getMenuElement(),this._inNavbar=this._detectNavbar(),this._addEventListeners()}var t=c.prototype;return t.toggle=function(){if(!this._element.disabled&&!g(this._element).hasClass(Pt)){var t=c._getParentFromElement(this._element),e=g(this._menu).hasClass(Lt);if(c._clearMenus(),!e){var n={relatedTarget:this._element},i=g.Event(kt.SHOW,n);if(g(t).trigger(i),!i.isDefaultPrevented()){if(!this._inNavbar){if("undefined"==typeof u)throw new TypeError("Bootstrap's dropdowns require Popper.js (https://popper.js.org/)");var o=this._element;"parent"===this._config.reference?o=t:_.isElement(this._config.reference)&&(o=this._config.reference,"undefined"!=typeof this._config.reference.jquery&&(o=this._config.reference[0])),"scrollParent"!==this._config.boundary&&g(t).addClass(Ft),this._popper=new u(o,this._menu,this._getPopperConfig())}"ontouchstart"in document.documentElement&&0===g(t).closest(Mt).length&&g(document.body).children().on("mouseover",null,g.noop),this._element.focus(),this._element.setAttribute("aria-expanded",!0),g(this._menu).toggleClass(Lt),g(t).toggleClass(Lt).trigger(g.Event(kt.SHOWN,n))}}}},t.show=function(){if(!(this._element.disabled||g(this._element).hasClass(Pt)||g(this._menu).hasClass(Lt))){var t={relatedTarget:this._element},e=g.Event(kt.SHOW,t),n=c._getParentFromElement(this._element);g(n).trigger(e),e.isDefaultPrevented()||(g(this._menu).toggleClass(Lt),g(n).toggleClass(Lt).trigger(g.Event(kt.SHOWN,t)))}},t.hide=function(){if(!this._element.disabled&&!g(this._element).hasClass(Pt)&&g(this._menu).hasClass(Lt)){var t={relatedTarget:this._element},e=g.Event(kt.HIDE,t),n=c._getParentFromElement(this._element);g(n).trigger(e),e.isDefaultPrevented()||(g(this._menu).toggleClass(Lt),g(n).toggleClass(Lt).trigger(g.Event(kt.HIDDEN,t)))}},t.dispose=function(){g.removeData(this._element,Dt),g(this._element).off(wt),this._element=null,(this._menu=null)!==this._popper&&(this._popper.destroy(),this._popper=null)},t.update=function(){this._inNavbar=this._detectNavbar(),null!==this._popper&&this._popper.scheduleUpdate()},t._addEventListeners=function(){var e=this;g(this._element).on(kt.CLICK,function(t){t.preventDefault(),t.stopPropagation(),e.toggle()})},t._getConfig=function(t){return t=l({},this.constructor.Default,g(this._element).data(),t),_.typeCheckConfig(It,t,this.constructor.DefaultType),t},t._getMenuElement=function(){if(!this._menu){var t=c._getParentFromElement(this._element);t&&(this._menu=t.querySelector(qt))}return this._menu},t._getPlacement=function(){var t=g(this._element.parentNode),e=Vt;return t.hasClass(jt)?(e=Qt,g(this._menu).hasClass(xt)&&(e=Bt)):t.hasClass(Ht)?e=zt:t.hasClass(Rt)?e=Xt:g(this._menu).hasClass(xt)&&(e=Yt),e},t._detectNavbar=function(){return 0<g(this._element).closest(".navbar").length},t._getOffset=function(){var e=this,t={};return"function"==typeof this._config.offset?t.fn=function(t){return t.offsets=l({},t.offsets,e._config.offset(t.offsets,e._element)||{}),t}:t.offset=this._config.offset,t},t._getPopperConfig=function(){var t={placement:this._getPlacement(),modifiers:{offset:this._getOffset(),flip:{enabled:this._config.flip},preventOverflow:{boundariesElement:this._config.boundary}}};return"static"===this._config.display&&(t.modifiers.applyStyle={enabled:!1}),t},c._jQueryInterface=function(e){return this.each(function(){var t=g(this).data(Dt);if(t||(t=new c(this,"object"==typeof e?e:null),g(this).data(Dt,t)),"string"==typeof e){if("undefined"==typeof t[e])throw new TypeError('No method named "'+e+'"');t[e]()}})},c._clearMenus=function(t){if(!t||3!==t.which&&("keyup"!==t.type||9===t.which))for(var e=[].slice.call(document.querySelectorAll(Ut)),n=0,i=e.length;n<i;n++){var o=c._getParentFromElement(e[n]),r=g(e[n]).data(Dt),s={relatedTarget:e[n]};if(t&&"click"===t.type&&(s.clickEvent=t),r){var a=r._menu;if(g(o).hasClass(Lt)&&!(t&&("click"===t.type&&/input|textarea/i.test(t.target.tagName)||"keyup"===t.type&&9===t.which)&&g.contains(o,t.target))){var l=g.Event(kt.HIDE,s);g(o).trigger(l),l.isDefaultPrevented()||("ontouchstart"in document.documentElement&&g(document.body).children().off("mouseover",null,g.noop),e[n].setAttribute("aria-expanded","false"),g(a).removeClass(Lt),g(o).removeClass(Lt).trigger(g.Event(kt.HIDDEN,s)))}}}},c._getParentFromElement=function(t){var e,n=_.getSelectorFromElement(t);return n&&(e=document.querySelector(n)),e||t.parentNode},c._dataApiKeydownHandler=function(t){if((/input|textarea/i.test(t.target.tagName)?!(32===t.which||27!==t.which&&(40!==t.which&&38!==t.which||g(t.target).closest(qt).length)):Ot.test(t.which))&&(t.preventDefault(),t.stopPropagation(),!this.disabled&&!g(this).hasClass(Pt))){var e=c._getParentFromElement(this),n=g(e).hasClass(Lt);if(n&&(!n||27!==t.which&&32!==t.which)){var i=[].slice.call(e.querySelectorAll(Kt));if(0!==i.length){var o=i.indexOf(t.target);38===t.which&&0<o&&o--,40===t.which&&o<i.length-1&&o++,o<0&&(o=0),i[o].focus()}}else{if(27===t.which){var r=e.querySelector(Ut);g(r).trigger("focus")}g(this).trigger("click")}}},s(c,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return $t}},{key:"DefaultType",get:function(){return Gt}}]),c}();g(document).on(kt.KEYDOWN_DATA_API,Ut,Jt._dataApiKeydownHandler).on(kt.KEYDOWN_DATA_API,qt,Jt._dataApiKeydownHandler).on(kt.CLICK_DATA_API+" "+kt.KEYUP_DATA_API,Jt._clearMenus).on(kt.CLICK_DATA_API,Ut,function(t){t.preventDefault(),t.stopPropagation(),Jt._jQueryInterface.call(g(this),"toggle")}).on(kt.CLICK_DATA_API,Wt,function(t){t.stopPropagation()}),g.fn[It]=Jt._jQueryInterface,g.fn[It].Constructor=Jt,g.fn[It].noConflict=function(){return g.fn[It]=Nt,Jt._jQueryInterface};var Zt="modal",te="bs.modal",ee="."+te,ne=g.fn[Zt],ie={backdrop:!0,keyboard:!0,focus:!0,show:!0},oe={backdrop:"(boolean|string)",keyboard:"boolean",focus:"boolean",show:"boolean"},re={HIDE:"hide"+ee,HIDDEN:"hidden"+ee,SHOW:"show"+ee,SHOWN:"shown"+ee,FOCUSIN:"focusin"+ee,RESIZE:"resize"+ee,CLICK_DISMISS:"click.dismiss"+ee,KEYDOWN_DISMISS:"keydown.dismiss"+ee,MOUSEUP_DISMISS:"mouseup.dismiss"+ee,MOUSEDOWN_DISMISS:"mousedown.dismiss"+ee,CLICK_DATA_API:"click"+ee+".data-api"},se="modal-dialog-scrollable",ae="modal-scrollbar-measure",le="modal-backdrop",ce="modal-open",he="fade",ue="show",fe=".modal-dialog",de=".modal-body",ge='[data-toggle="modal"]',_e='[data-dismiss="modal"]',me=".fixed-top, .fixed-bottom, .is-fixed, .sticky-top",pe=".sticky-top",ve=function(){function o(t,e){this._config=this._getConfig(e),this._element=t,this._dialog=t.querySelector(fe),this._backdrop=null,this._isShown=!1,this._isBodyOverflowing=!1,this._ignoreBackdropClick=!1,this._isTransitioning=!1,this._scrollbarWidth=0}var t=o.prototype;return t.toggle=function(t){return this._isShown?this.hide():this.show(t)},t.show=function(t){var e=this;if(!this._isShown&&!this._isTransitioning){g(this._element).hasClass(he)&&(this._isTransitioning=!0);var n=g.Event(re.SHOW,{relatedTarget:t});g(this._element).trigger(n),this._isShown||n.isDefaultPrevented()||(this._isShown=!0,this._checkScrollbar(),this._setScrollbar(),this._adjustDialog(),this._setEscapeEvent(),this._setResizeEvent(),g(this._element).on(re.CLICK_DISMISS,_e,function(t){return e.hide(t)}),g(this._dialog).on(re.MOUSEDOWN_DISMISS,function(){g(e._element).one(re.MOUSEUP_DISMISS,function(t){g(t.target).is(e._element)&&(e._ignoreBackdropClick=!0)})}),this._showBackdrop(function(){return e._showElement(t)}))}},t.hide=function(t){var e=this;if(t&&t.preventDefault(),this._isShown&&!this._isTransitioning){var n=g.Event(re.HIDE);if(g(this._element).trigger(n),this._isShown&&!n.isDefaultPrevented()){this._isShown=!1;var i=g(this._element).hasClass(he);if(i&&(this._isTransitioning=!0),this._setEscapeEvent(),this._setResizeEvent(),g(document).off(re.FOCUSIN),g(this._element).removeClass(ue),g(this._element).off(re.CLICK_DISMISS),g(this._dialog).off(re.MOUSEDOWN_DISMISS),i){var o=_.getTransitionDurationFromElement(this._element);g(this._element).one(_.TRANSITION_END,function(t){return e._hideModal(t)}).emulateTransitionEnd(o)}else this._hideModal()}}},t.dispose=function(){[window,this._element,this._dialog].forEach(function(t){return g(t).off(ee)}),g(document).off(re.FOCUSIN),g.removeData(this._element,te),this._config=null,this._element=null,this._dialog=null,this._backdrop=null,this._isShown=null,this._isBodyOverflowing=null,this._ignoreBackdropClick=null,this._isTransitioning=null,this._scrollbarWidth=null},t.handleUpdate=function(){this._adjustDialog()},t._getConfig=function(t){return t=l({},ie,t),_.typeCheckConfig(Zt,t,oe),t},t._showElement=function(t){var e=this,n=g(this._element).hasClass(he);this._element.parentNode&&this._element.parentNode.nodeType===Node.ELEMENT_NODE||document.body.appendChild(this._element),this._element.style.display="block",this._element.removeAttribute("aria-hidden"),this._element.setAttribute("aria-modal",!0),g(this._dialog).hasClass(se)?this._dialog.querySelector(de).scrollTop=0:this._element.scrollTop=0,n&&_.reflow(this._element),g(this._element).addClass(ue),this._config.focus&&this._enforceFocus();var i=g.Event(re.SHOWN,{relatedTarget:t}),o=function(){e._config.focus&&e._element.focus(),e._isTransitioning=!1,g(e._element).trigger(i)};if(n){var r=_.getTransitionDurationFromElement(this._dialog);g(this._dialog).one(_.TRANSITION_END,o).emulateTransitionEnd(r)}else o()},t._enforceFocus=function(){var e=this;g(document).off(re.FOCUSIN).on(re.FOCUSIN,function(t){document!==t.target&&e._element!==t.target&&0===g(e._element).has(t.target).length&&e._element.focus()})},t._setEscapeEvent=function(){var e=this;this._isShown&&this._config.keyboard?g(this._element).on(re.KEYDOWN_DISMISS,function(t){27===t.which&&(t.preventDefault(),e.hide())}):this._isShown||g(this._element).off(re.KEYDOWN_DISMISS)},t._setResizeEvent=function(){var e=this;this._isShown?g(window).on(re.RESIZE,function(t){return e.handleUpdate(t)}):g(window).off(re.RESIZE)},t._hideModal=function(){var t=this;this._element.style.display="none",this._element.setAttribute("aria-hidden",!0),this._element.removeAttribute("aria-modal"),this._isTransitioning=!1,this._showBackdrop(function(){g(document.body).removeClass(ce),t._resetAdjustments(),t._resetScrollbar(),g(t._element).trigger(re.HIDDEN)})},t._removeBackdrop=function(){this._backdrop&&(g(this._backdrop).remove(),this._backdrop=null)},t._showBackdrop=function(t){var e=this,n=g(this._element).hasClass(he)?he:"";if(this._isShown&&this._config.backdrop){if(this._backdrop=document.createElement("div"),this._backdrop.className=le,n&&this._backdrop.classList.add(n),g(this._backdrop).appendTo(document.body),g(this._element).on(re.CLICK_DISMISS,function(t){e._ignoreBackdropClick?e._ignoreBackdropClick=!1:t.target===t.currentTarget&&("static"===e._config.backdrop?e._element.focus():e.hide())}),n&&_.reflow(this._backdrop),g(this._backdrop).addClass(ue),!t)return;if(!n)return void t();var i=_.getTransitionDurationFromElement(this._backdrop);g(this._backdrop).one(_.TRANSITION_END,t).emulateTransitionEnd(i)}else if(!this._isShown&&this._backdrop){g(this._backdrop).removeClass(ue);var o=function(){e._removeBackdrop(),t&&t()};if(g(this._element).hasClass(he)){var r=_.getTransitionDurationFromElement(this._backdrop);g(this._backdrop).one(_.TRANSITION_END,o).emulateTransitionEnd(r)}else o()}else t&&t()},t._adjustDialog=function(){var t=this._element.scrollHeight>document.documentElement.clientHeight;!this._isBodyOverflowing&&t&&(this._element.style.paddingLeft=this._scrollbarWidth+"px"),this._isBodyOverflowing&&!t&&(this._element.style.paddingRight=this._scrollbarWidth+"px")},t._resetAdjustments=function(){this._element.style.paddingLeft="",this._element.style.paddingRight=""},t._checkScrollbar=function(){var t=document.body.getBoundingClientRect();this._isBodyOverflowing=t.left+t.right<window.innerWidth,this._scrollbarWidth=this._getScrollbarWidth()},t._setScrollbar=function(){var o=this;if(this._isBodyOverflowing){var t=[].slice.call(document.querySelectorAll(me)),e=[].slice.call(document.querySelectorAll(pe));g(t).each(function(t,e){var n=e.style.paddingRight,i=g(e).css("padding-right");g(e).data("padding-right",n).css("padding-right",parseFloat(i)+o._scrollbarWidth+"px")}),g(e).each(function(t,e){var n=e.style.marginRight,i=g(e).css("margin-right");g(e).data("margin-right",n).css("margin-right",parseFloat(i)-o._scrollbarWidth+"px")});var n=document.body.style.paddingRight,i=g(document.body).css("padding-right");g(document.body).data("padding-right",n).css("padding-right",parseFloat(i)+this._scrollbarWidth+"px")}g(document.body).addClass(ce)},t._resetScrollbar=function(){var t=[].slice.call(document.querySelectorAll(me));g(t).each(function(t,e){var n=g(e).data("padding-right");g(e).removeData("padding-right"),e.style.paddingRight=n||""});var e=[].slice.call(document.querySelectorAll(""+pe));g(e).each(function(t,e){var n=g(e).data("margin-right");"undefined"!=typeof n&&g(e).css("margin-right",n).removeData("margin-right")});var n=g(document.body).data("padding-right");g(document.body).removeData("padding-right"),document.body.style.paddingRight=n||""},t._getScrollbarWidth=function(){var t=document.createElement("div");t.className=ae,document.body.appendChild(t);var e=t.getBoundingClientRect().width-t.clientWidth;return document.body.removeChild(t),e},o._jQueryInterface=function(n,i){return this.each(function(){var t=g(this).data(te),e=l({},ie,g(this).data(),"object"==typeof n&&n?n:{});if(t||(t=new o(this,e),g(this).data(te,t)),"string"==typeof n){if("undefined"==typeof t[n])throw new TypeError('No method named "'+n+'"');t[n](i)}else e.show&&t.show(i)})},s(o,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return ie}}]),o}();g(document).on(re.CLICK_DATA_API,ge,function(t){var e,n=this,i=_.getSelectorFromElement(this);i&&(e=document.querySelector(i));var o=g(e).data(te)?"toggle":l({},g(e).data(),g(this).data());"A"!==this.tagName&&"AREA"!==this.tagName||t.preventDefault();var r=g(e).one(re.SHOW,function(t){t.isDefaultPrevented()||r.one(re.HIDDEN,function(){g(n).is(":visible")&&n.focus()})});ve._jQueryInterface.call(g(e),o,this)}),g.fn[Zt]=ve._jQueryInterface,g.fn[Zt].Constructor=ve,g.fn[Zt].noConflict=function(){return g.fn[Zt]=ne,ve._jQueryInterface};var ye=["background","cite","href","itemtype","longdesc","poster","src","xlink:href"],Ee={"*":["class","dir","id","lang","role",/^aria-[\w-]*$/i],a:["target","href","title","rel"],area:[],b:[],br:[],col:[],code:[],div:[],em:[],hr:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],i:[],img:["src","alt","title","width","height"],li:[],ol:[],p:[],pre:[],s:[],small:[],span:[],sub:[],sup:[],strong:[],u:[],ul:[]},Ce=/^(?:(?:https?|mailto|ftp|tel|file):|[^&:/?#]*(?:[/?#]|$))/gi,Te=/^data:(?:image\/(?:bmp|gif|jpeg|jpg|png|tiff|webp)|video\/(?:mpeg|mp4|ogg|webm)|audio\/(?:mp3|oga|ogg|opus));base64,[a-z0-9+/]+=*$/i;function Se(t,s,e){if(0===t.length)return t;if(e&&"function"==typeof e)return e(t);for(var n=(new window.DOMParser).parseFromString(t,"text/html"),a=Object.keys(s),l=[].slice.call(n.body.querySelectorAll("*")),i=function(t,e){var n=l[t],i=n.nodeName.toLowerCase();if(-1===a.indexOf(n.nodeName.toLowerCase()))return n.parentNode.removeChild(n),"continue";var o=[].slice.call(n.attributes),r=[].concat(s["*"]||[],s[i]||[]);o.forEach(function(t){(function(t,e){var n=t.nodeName.toLowerCase();if(-1!==e.indexOf(n))return-1===ye.indexOf(n)||Boolean(t.nodeValue.match(Ce)||t.nodeValue.match(Te));for(var i=e.filter(function(t){return t instanceof RegExp}),o=0,r=i.length;o<r;o++)if(n.match(i[o]))return!0;return!1})(t,r)||n.removeAttribute(t.nodeName)})},o=0,r=l.length;o<r;o++)i(o);return n.body.innerHTML}var be="tooltip",Ie="bs.tooltip",De="."+Ie,we=g.fn[be],Ae="bs-tooltip",Ne=new RegExp("(^|\\s)"+Ae+"\\S+","g"),Oe=["sanitize","whiteList","sanitizeFn"],ke={animation:"boolean",template:"string",title:"(string|element|function)",trigger:"string",delay:"(number|object)",html:"boolean",selector:"(string|boolean)",placement:"(string|function)",offset:"(number|string|function)",container:"(string|element|boolean)",fallbackPlacement:"(string|array)",boundary:"(string|element)",sanitize:"boolean",sanitizeFn:"(null|function)",whiteList:"object"},Pe={AUTO:"auto",TOP:"top",RIGHT:"right",BOTTOM:"bottom",LEFT:"left"},Le={animation:!0,template:'<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>',trigger:"hover focus",title:"",delay:0,html:!1,selector:!1,placement:"top",offset:0,container:!1,fallbackPlacement:"flip",boundary:"scrollParent",sanitize:!0,sanitizeFn:null,whiteList:Ee},je="show",He="out",Re={HIDE:"hide"+De,HIDDEN:"hidden"+De,SHOW:"show"+De,SHOWN:"shown"+De,INSERTED:"inserted"+De,CLICK:"click"+De,FOCUSIN:"focusin"+De,FOCUSOUT:"focusout"+De,MOUSEENTER:"mouseenter"+De,MOUSELEAVE:"mouseleave"+De},xe="fade",Fe="show",Ue=".tooltip-inner",We=".arrow",qe="hover",Me="focus",Ke="click",Qe="manual",Be=function(){function i(t,e){if("undefined"==typeof u)throw new TypeError("Bootstrap's tooltips require Popper.js (https://popper.js.org/)");this._isEnabled=!0,this._timeout=0,this._hoverState="",this._activeTrigger={},this._popper=null,this.element=t,this.config=this._getConfig(e),this.tip=null,this._setListeners()}var t=i.prototype;return t.enable=function(){this._isEnabled=!0},t.disable=function(){this._isEnabled=!1},t.toggleEnabled=function(){this._isEnabled=!this._isEnabled},t.toggle=function(t){if(this._isEnabled)if(t){var e=this.constructor.DATA_KEY,n=g(t.currentTarget).data(e);n||(n=new this.constructor(t.currentTarget,this._getDelegateConfig()),g(t.currentTarget).data(e,n)),n._activeTrigger.click=!n._activeTrigger.click,n._isWithActiveTrigger()?n._enter(null,n):n._leave(null,n)}else{if(g(this.getTipElement()).hasClass(Fe))return void this._leave(null,this);this._enter(null,this)}},t.dispose=function(){clearTimeout(this._timeout),g.removeData(this.element,this.constructor.DATA_KEY),g(this.element).off(this.constructor.EVENT_KEY),g(this.element).closest(".modal").off("hide.bs.modal"),this.tip&&g(this.tip).remove(),this._isEnabled=null,this._timeout=null,this._hoverState=null,(this._activeTrigger=null)!==this._popper&&this._popper.destroy(),this._popper=null,this.element=null,this.config=null,this.tip=null},t.show=function(){var e=this;if("none"===g(this.element).css("display"))throw new Error("Please use show on visible elements");var t=g.Event(this.constructor.Event.SHOW);if(this.isWithContent()&&this._isEnabled){g(this.element).trigger(t);var n=_.findShadowRoot(this.element),i=g.contains(null!==n?n:this.element.ownerDocument.documentElement,this.element);if(t.isDefaultPrevented()||!i)return;var o=this.getTipElement(),r=_.getUID(this.constructor.NAME);o.setAttribute("id",r),this.element.setAttribute("aria-describedby",r),this.setContent(),this.config.animation&&g(o).addClass(xe);var s="function"==typeof this.config.placement?this.config.placement.call(this,o,this.element):this.config.placement,a=this._getAttachment(s);this.addAttachmentClass(a);var l=this._getContainer();g(o).data(this.constructor.DATA_KEY,this),g.contains(this.element.ownerDocument.documentElement,this.tip)||g(o).appendTo(l),g(this.element).trigger(this.constructor.Event.INSERTED),this._popper=new u(this.element,o,{placement:a,modifiers:{offset:this._getOffset(),flip:{behavior:this.config.fallbackPlacement},arrow:{element:We},preventOverflow:{boundariesElement:this.config.boundary}},onCreate:function(t){t.originalPlacement!==t.placement&&e._handlePopperPlacementChange(t)},onUpdate:function(t){return e._handlePopperPlacementChange(t)}}),g(o).addClass(Fe),"ontouchstart"in document.documentElement&&g(document.body).children().on("mouseover",null,g.noop);var c=function(){e.config.animation&&e._fixTransition();var t=e._hoverState;e._hoverState=null,g(e.element).trigger(e.constructor.Event.SHOWN),t===He&&e._leave(null,e)};if(g(this.tip).hasClass(xe)){var h=_.getTransitionDurationFromElement(this.tip);g(this.tip).one(_.TRANSITION_END,c).emulateTransitionEnd(h)}else c()}},t.hide=function(t){var e=this,n=this.getTipElement(),i=g.Event(this.constructor.Event.HIDE),o=function(){e._hoverState!==je&&n.parentNode&&n.parentNode.removeChild(n),e._cleanTipClass(),e.element.removeAttribute("aria-describedby"),g(e.element).trigger(e.constructor.Event.HIDDEN),null!==e._popper&&e._popper.destroy(),t&&t()};if(g(this.element).trigger(i),!i.isDefaultPrevented()){if(g(n).removeClass(Fe),"ontouchstart"in document.documentElement&&g(document.body).children().off("mouseover",null,g.noop),this._activeTrigger[Ke]=!1,this._activeTrigger[Me]=!1,this._activeTrigger[qe]=!1,g(this.tip).hasClass(xe)){var r=_.getTransitionDurationFromElement(n);g(n).one(_.TRANSITION_END,o).emulateTransitionEnd(r)}else o();this._hoverState=""}},t.update=function(){null!==this._popper&&this._popper.scheduleUpdate()},t.isWithContent=function(){return Boolean(this.getTitle())},t.addAttachmentClass=function(t){g(this.getTipElement()).addClass(Ae+"-"+t)},t.getTipElement=function(){return this.tip=this.tip||g(this.config.template)[0],this.tip},t.setContent=function(){var t=this.getTipElement();this.setElementContent(g(t.querySelectorAll(Ue)),this.getTitle()),g(t).removeClass(xe+" "+Fe)},t.setElementContent=function(t,e){"object"!=typeof e||!e.nodeType&&!e.jquery?this.config.html?(this.config.sanitize&&(e=Se(e,this.config.whiteList,this.config.sanitizeFn)),t.html(e)):t.text(e):this.config.html?g(e).parent().is(t)||t.empty().append(e):t.text(g(e).text())},t.getTitle=function(){var t=this.element.getAttribute("data-original-title");return t||(t="function"==typeof this.config.title?this.config.title.call(this.element):this.config.title),t},t._getOffset=function(){var e=this,t={};return"function"==typeof this.config.offset?t.fn=function(t){return t.offsets=l({},t.offsets,e.config.offset(t.offsets,e.element)||{}),t}:t.offset=this.config.offset,t},t._getContainer=function(){return!1===this.config.container?document.body:_.isElement(this.config.container)?g(this.config.container):g(document).find(this.config.container)},t._getAttachment=function(t){return Pe[t.toUpperCase()]},t._setListeners=function(){var i=this;this.config.trigger.split(" ").forEach(function(t){if("click"===t)g(i.element).on(i.constructor.Event.CLICK,i.config.selector,function(t){return i.toggle(t)});else if(t!==Qe){var e=t===qe?i.constructor.Event.MOUSEENTER:i.constructor.Event.FOCUSIN,n=t===qe?i.constructor.Event.MOUSELEAVE:i.constructor.Event.FOCUSOUT;g(i.element).on(e,i.config.selector,function(t){return i._enter(t)}).on(n,i.config.selector,function(t){return i._leave(t)})}}),g(this.element).closest(".modal").on("hide.bs.modal",function(){i.element&&i.hide()}),this.config.selector?this.config=l({},this.config,{trigger:"manual",selector:""}):this._fixTitle()},t._fixTitle=function(){var t=typeof this.element.getAttribute("data-original-title");(this.element.getAttribute("title")||"string"!==t)&&(this.element.setAttribute("data-original-title",this.element.getAttribute("title")||""),this.element.setAttribute("title",""))},t._enter=function(t,e){var n=this.constructor.DATA_KEY;(e=e||g(t.currentTarget).data(n))||(e=new this.constructor(t.currentTarget,this._getDelegateConfig()),g(t.currentTarget).data(n,e)),t&&(e._activeTrigger["focusin"===t.type?Me:qe]=!0),g(e.getTipElement()).hasClass(Fe)||e._hoverState===je?e._hoverState=je:(clearTimeout(e._timeout),e._hoverState=je,e.config.delay&&e.config.delay.show?e._timeout=setTimeout(function(){e._hoverState===je&&e.show()},e.config.delay.show):e.show())},t._leave=function(t,e){var n=this.constructor.DATA_KEY;(e=e||g(t.currentTarget).data(n))||(e=new this.constructor(t.currentTarget,this._getDelegateConfig()),g(t.currentTarget).data(n,e)),t&&(e._activeTrigger["focusout"===t.type?Me:qe]=!1),e._isWithActiveTrigger()||(clearTimeout(e._timeout),e._hoverState=He,e.config.delay&&e.config.delay.hide?e._timeout=setTimeout(function(){e._hoverState===He&&e.hide()},e.config.delay.hide):e.hide())},t._isWithActiveTrigger=function(){for(var t in this._activeTrigger)if(this._activeTrigger[t])return!0;return!1},t._getConfig=function(t){var e=g(this.element).data();return Object.keys(e).forEach(function(t){-1!==Oe.indexOf(t)&&delete e[t]}),"number"==typeof(t=l({},this.constructor.Default,e,"object"==typeof t&&t?t:{})).delay&&(t.delay={show:t.delay,hide:t.delay}),"number"==typeof t.title&&(t.title=t.title.toString()),"number"==typeof t.content&&(t.content=t.content.toString()),_.typeCheckConfig(be,t,this.constructor.DefaultType),t.sanitize&&(t.template=Se(t.template,t.whiteList,t.sanitizeFn)),t},t._getDelegateConfig=function(){var t={};if(this.config)for(var e in this.config)this.constructor.Default[e]!==this.config[e]&&(t[e]=this.config[e]);return t},t._cleanTipClass=function(){var t=g(this.getTipElement()),e=t.attr("class").match(Ne);null!==e&&e.length&&t.removeClass(e.join(""))},t._handlePopperPlacementChange=function(t){var e=t.instance;this.tip=e.popper,this._cleanTipClass(),this.addAttachmentClass(this._getAttachment(t.placement))},t._fixTransition=function(){var t=this.getTipElement(),e=this.config.animation;null===t.getAttribute("x-placement")&&(g(t).removeClass(xe),this.config.animation=!1,this.hide(),this.show(),this.config.animation=e)},i._jQueryInterface=function(n){return this.each(function(){var t=g(this).data(Ie),e="object"==typeof n&&n;if((t||!/dispose|hide/.test(n))&&(t||(t=new i(this,e),g(this).data(Ie,t)),"string"==typeof n)){if("undefined"==typeof t[n])throw new TypeError('No method named "'+n+'"');t[n]()}})},s(i,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return Le}},{key:"NAME",get:function(){return be}},{key:"DATA_KEY",get:function(){return Ie}},{key:"Event",get:function(){return Re}},{key:"EVENT_KEY",get:function(){return De}},{key:"DefaultType",get:function(){return ke}}]),i}();g.fn[be]=Be._jQueryInterface,g.fn[be].Constructor=Be,g.fn[be].noConflict=function(){return g.fn[be]=we,Be._jQueryInterface};var Ve="popover",Ye="bs.popover",ze="."+Ye,Xe=g.fn[Ve],$e="bs-popover",Ge=new RegExp("(^|\\s)"+$e+"\\S+","g"),Je=l({},Be.Default,{placement:"right",trigger:"click",content:"",template:'<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>'}),Ze=l({},Be.DefaultType,{content:"(string|element|function)"}),tn="fade",en="show",nn=".popover-header",on=".popover-body",rn={HIDE:"hide"+ze,HIDDEN:"hidden"+ze,SHOW:"show"+ze,SHOWN:"shown"+ze,INSERTED:"inserted"+ze,CLICK:"click"+ze,FOCUSIN:"focusin"+ze,FOCUSOUT:"focusout"+ze,MOUSEENTER:"mouseenter"+ze,MOUSELEAVE:"mouseleave"+ze},sn=function(t){var e,n;function i(){return t.apply(this,arguments)||this}n=t,(e=i).prototype=Object.create(n.prototype),(e.prototype.constructor=e).__proto__=n;var o=i.prototype;return o.isWithContent=function(){return this.getTitle()||this._getContent()},o.addAttachmentClass=function(t){g(this.getTipElement()).addClass($e+"-"+t)},o.getTipElement=function(){return this.tip=this.tip||g(this.config.template)[0],this.tip},o.setContent=function(){var t=g(this.getTipElement());this.setElementContent(t.find(nn),this.getTitle());var e=this._getContent();"function"==typeof e&&(e=e.call(this.element)),this.setElementContent(t.find(on),e),t.removeClass(tn+" "+en)},o._getContent=function(){return this.element.getAttribute("data-content")||this.config.content},o._cleanTipClass=function(){var t=g(this.getTipElement()),e=t.attr("class").match(Ge);null!==e&&0<e.length&&t.removeClass(e.join(""))},i._jQueryInterface=function(n){return this.each(function(){var t=g(this).data(Ye),e="object"==typeof n?n:null;if((t||!/dispose|hide/.test(n))&&(t||(t=new i(this,e),g(this).data(Ye,t)),"string"==typeof n)){if("undefined"==typeof t[n])throw new TypeError('No method named "'+n+'"');t[n]()}})},s(i,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return Je}},{key:"NAME",get:function(){return Ve}},{key:"DATA_KEY",get:function(){return Ye}},{key:"Event",get:function(){return rn}},{key:"EVENT_KEY",get:function(){return ze}},{key:"DefaultType",get:function(){return Ze}}]),i}(Be);g.fn[Ve]=sn._jQueryInterface,g.fn[Ve].Constructor=sn,g.fn[Ve].noConflict=function(){return g.fn[Ve]=Xe,sn._jQueryInterface};var an="scrollspy",ln="bs.scrollspy",cn="."+ln,hn=g.fn[an],un={offset:10,method:"auto",target:""},fn={offset:"number",method:"string",target:"(string|element)"},dn={ACTIVATE:"activate"+cn,SCROLL:"scroll"+cn,LOAD_DATA_API:"load"+cn+".data-api"},gn="dropdown-item",_n="active",mn='[data-spy="scroll"]',pn=".nav, .list-group",vn=".nav-link",yn=".nav-item",En=".list-group-item",Cn=".dropdown",Tn=".dropdown-item",Sn=".dropdown-toggle",bn="offset",In="position",Dn=function(){function n(t,e){var n=this;this._element=t,this._scrollElement="BODY"===t.tagName?window:t,this._config=this._getConfig(e),this._selector=this._config.target+" "+vn+","+this._config.target+" "+En+","+this._config.target+" "+Tn,this._offsets=[],this._targets=[],this._activeTarget=null,this._scrollHeight=0,g(this._scrollElement).on(dn.SCROLL,function(t){return n._process(t)}),this.refresh(),this._process()}var t=n.prototype;return t.refresh=function(){var e=this,t=this._scrollElement===this._scrollElement.window?bn:In,o="auto"===this._config.method?t:this._config.method,r=o===In?this._getScrollTop():0;this._offsets=[],this._targets=[],this._scrollHeight=this._getScrollHeight(),[].slice.call(document.querySelectorAll(this._selector)).map(function(t){var e,n=_.getSelectorFromElement(t);if(n&&(e=document.querySelector(n)),e){var i=e.getBoundingClientRect();if(i.width||i.height)return[g(e)[o]().top+r,n]}return null}).filter(function(t){return t}).sort(function(t,e){return t[0]-e[0]}).forEach(function(t){e._offsets.push(t[0]),e._targets.push(t[1])})},t.dispose=function(){g.removeData(this._element,ln),g(this._scrollElement).off(cn),this._element=null,this._scrollElement=null,this._config=null,this._selector=null,this._offsets=null,this._targets=null,this._activeTarget=null,this._scrollHeight=null},t._getConfig=function(t){if("string"!=typeof(t=l({},un,"object"==typeof t&&t?t:{})).target){var e=g(t.target).attr("id");e||(e=_.getUID(an),g(t.target).attr("id",e)),t.target="#"+e}return _.typeCheckConfig(an,t,fn),t},t._getScrollTop=function(){return this._scrollElement===window?this._scrollElement.pageYOffset:this._scrollElement.scrollTop},t._getScrollHeight=function(){return this._scrollElement.scrollHeight||Math.max(document.body.scrollHeight,document.documentElement.scrollHeight)},t._getOffsetHeight=function(){return this._scrollElement===window?window.innerHeight:this._scrollElement.getBoundingClientRect().height},t._process=function(){var t=this._getScrollTop()+this._config.offset,e=this._getScrollHeight(),n=this._config.offset+e-this._getOffsetHeight();if(this._scrollHeight!==e&&this.refresh(),n<=t){var i=this._targets[this._targets.length-1];this._activeTarget!==i&&this._activate(i)}else{if(this._activeTarget&&t<this._offsets[0]&&0<this._offsets[0])return this._activeTarget=null,void this._clear();for(var o=this._offsets.length;o--;){this._activeTarget!==this._targets[o]&&t>=this._offsets[o]&&("undefined"==typeof this._offsets[o+1]||t<this._offsets[o+1])&&this._activate(this._targets[o])}}},t._activate=function(e){this._activeTarget=e,this._clear();var t=this._selector.split(",").map(function(t){return t+'[data-target="'+e+'"],'+t+'[href="'+e+'"]'}),n=g([].slice.call(document.querySelectorAll(t.join(","))));n.hasClass(gn)?(n.closest(Cn).find(Sn).addClass(_n),n.addClass(_n)):(n.addClass(_n),n.parents(pn).prev(vn+", "+En).addClass(_n),n.parents(pn).prev(yn).children(vn).addClass(_n)),g(this._scrollElement).trigger(dn.ACTIVATE,{relatedTarget:e})},t._clear=function(){[].slice.call(document.querySelectorAll(this._selector)).filter(function(t){return t.classList.contains(_n)}).forEach(function(t){return t.classList.remove(_n)})},n._jQueryInterface=function(e){return this.each(function(){var t=g(this).data(ln);if(t||(t=new n(this,"object"==typeof e&&e),g(this).data(ln,t)),"string"==typeof e){if("undefined"==typeof t[e])throw new TypeError('No method named "'+e+'"');t[e]()}})},s(n,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"Default",get:function(){return un}}]),n}();g(window).on(dn.LOAD_DATA_API,function(){for(var t=[].slice.call(document.querySelectorAll(mn)),e=t.length;e--;){var n=g(t[e]);Dn._jQueryInterface.call(n,n.data())}}),g.fn[an]=Dn._jQueryInterface,g.fn[an].Constructor=Dn,g.fn[an].noConflict=function(){return g.fn[an]=hn,Dn._jQueryInterface};var wn="bs.tab",An="."+wn,Nn=g.fn.tab,On={HIDE:"hide"+An,HIDDEN:"hidden"+An,SHOW:"show"+An,SHOWN:"shown"+An,CLICK_DATA_API:"click"+An+".data-api"},kn="dropdown-menu",Pn="active",Ln="disabled",jn="fade",Hn="show",Rn=".dropdown",xn=".nav, .list-group",Fn=".active",Un="> li > .active",Wn='[data-toggle="tab"], [data-toggle="pill"], [data-toggle="list"]',qn=".dropdown-toggle",Mn="> .dropdown-menu .active",Kn=function(){function i(t){this._element=t}var t=i.prototype;return t.show=function(){var n=this;if(!(this._element.parentNode&&this._element.parentNode.nodeType===Node.ELEMENT_NODE&&g(this._element).hasClass(Pn)||g(this._element).hasClass(Ln))){var t,i,e=g(this._element).closest(xn)[0],o=_.getSelectorFromElement(this._element);if(e){var r="UL"===e.nodeName||"OL"===e.nodeName?Un:Fn;i=(i=g.makeArray(g(e).find(r)))[i.length-1]}var s=g.Event(On.HIDE,{relatedTarget:this._element}),a=g.Event(On.SHOW,{relatedTarget:i});if(i&&g(i).trigger(s),g(this._element).trigger(a),!a.isDefaultPrevented()&&!s.isDefaultPrevented()){o&&(t=document.querySelector(o)),this._activate(this._element,e);var l=function(){var t=g.Event(On.HIDDEN,{relatedTarget:n._element}),e=g.Event(On.SHOWN,{relatedTarget:i});g(i).trigger(t),g(n._element).trigger(e)};t?this._activate(t,t.parentNode,l):l()}}},t.dispose=function(){g.removeData(this._element,wn),this._element=null},t._activate=function(t,e,n){var i=this,o=(!e||"UL"!==e.nodeName&&"OL"!==e.nodeName?g(e).children(Fn):g(e).find(Un))[0],r=n&&o&&g(o).hasClass(jn),s=function(){return i._transitionComplete(t,o,n)};if(o&&r){var a=_.getTransitionDurationFromElement(o);g(o).removeClass(Hn).one(_.TRANSITION_END,s).emulateTransitionEnd(a)}else s()},t._transitionComplete=function(t,e,n){if(e){g(e).removeClass(Pn);var i=g(e.parentNode).find(Mn)[0];i&&g(i).removeClass(Pn),"tab"===e.getAttribute("role")&&e.setAttribute("aria-selected",!1)}if(g(t).addClass(Pn),"tab"===t.getAttribute("role")&&t.setAttribute("aria-selected",!0),_.reflow(t),t.classList.contains(jn)&&t.classList.add(Hn),t.parentNode&&g(t.parentNode).hasClass(kn)){var o=g(t).closest(Rn)[0];if(o){var r=[].slice.call(o.querySelectorAll(qn));g(r).addClass(Pn)}t.setAttribute("aria-expanded",!0)}n&&n()},i._jQueryInterface=function(n){return this.each(function(){var t=g(this),e=t.data(wn);if(e||(e=new i(this),t.data(wn,e)),"string"==typeof n){if("undefined"==typeof e[n])throw new TypeError('No method named "'+n+'"');e[n]()}})},s(i,null,[{key:"VERSION",get:function(){return"4.3.1"}}]),i}();g(document).on(On.CLICK_DATA_API,Wn,function(t){t.preventDefault(),Kn._jQueryInterface.call(g(this),"show")}),g.fn.tab=Kn._jQueryInterface,g.fn.tab.Constructor=Kn,g.fn.tab.noConflict=function(){return g.fn.tab=Nn,Kn._jQueryInterface};var Qn="toast",Bn="bs.toast",Vn="."+Bn,Yn=g.fn[Qn],zn={CLICK_DISMISS:"click.dismiss"+Vn,HIDE:"hide"+Vn,HIDDEN:"hidden"+Vn,SHOW:"show"+Vn,SHOWN:"shown"+Vn},Xn="fade",$n="hide",Gn="show",Jn="showing",Zn={animation:"boolean",autohide:"boolean",delay:"number"},ti={animation:!0,autohide:!0,delay:500},ei='[data-dismiss="toast"]',ni=function(){function i(t,e){this._element=t,this._config=this._getConfig(e),this._timeout=null,this._setListeners()}var t=i.prototype;return t.show=function(){var t=this;g(this._element).trigger(zn.SHOW),this._config.animation&&this._element.classList.add(Xn);var e=function(){t._element.classList.remove(Jn),t._element.classList.add(Gn),g(t._element).trigger(zn.SHOWN),t._config.autohide&&t.hide()};if(this._element.classList.remove($n),this._element.classList.add(Jn),this._config.animation){var n=_.getTransitionDurationFromElement(this._element);g(this._element).one(_.TRANSITION_END,e).emulateTransitionEnd(n)}else e()},t.hide=function(t){var e=this;this._element.classList.contains(Gn)&&(g(this._element).trigger(zn.HIDE),t?this._close():this._timeout=setTimeout(function(){e._close()},this._config.delay))},t.dispose=function(){clearTimeout(this._timeout),this._timeout=null,this._element.classList.contains(Gn)&&this._element.classList.remove(Gn),g(this._element).off(zn.CLICK_DISMISS),g.removeData(this._element,Bn),this._element=null,this._config=null},t._getConfig=function(t){return t=l({},ti,g(this._element).data(),"object"==typeof t&&t?t:{}),_.typeCheckConfig(Qn,t,this.constructor.DefaultType),t},t._setListeners=function(){var t=this;g(this._element).on(zn.CLICK_DISMISS,ei,function(){return t.hide(!0)})},t._close=function(){var t=this,e=function(){t._element.classList.add($n),g(t._element).trigger(zn.HIDDEN)};if(this._element.classList.remove(Gn),this._config.animation){var n=_.getTransitionDurationFromElement(this._element);g(this._element).one(_.TRANSITION_END,e).emulateTransitionEnd(n)}else e()},i._jQueryInterface=function(n){return this.each(function(){var t=g(this),e=t.data(Bn);if(e||(e=new i(this,"object"==typeof n&&n),t.data(Bn,e)),"string"==typeof n){if("undefined"==typeof e[n])throw new TypeError('No method named "'+n+'"');e[n](this)}})},s(i,null,[{key:"VERSION",get:function(){return"4.3.1"}},{key:"DefaultType",get:function(){return Zn}},{key:"Default",get:function(){return ti}}]),i}();g.fn[Qn]=ni._jQueryInterface,g.fn[Qn].Constructor=ni,g.fn[Qn].noConflict=function(){return g.fn[Qn]=Yn,ni._jQueryInterface},function(){if("undefined"==typeof g)throw new TypeError("Bootstrap's JavaScript requires jQuery. jQuery must be included before Bootstrap's JavaScript.");var t=g.fn.jquery.split(" ")[0].split(".");if(t[0]<2&&t[1]<9||1===t[0]&&9===t[1]&&t[2]<1||4<=t[0])throw new Error("Bootstrap's JavaScript requires at least jQuery v1.9.1 but less than v4.0.0")}(),t.Util=_,t.Alert=p,t.Button=P,t.Carousel=lt,t.Collapse=bt,t.Dropdown=Jt,t.Modal=ve,t.Popover=sn,t.Scrollspy=Dn,t.Tab=Kn,t.Toast=ni,t.Tooltip=Be,Object.defineProperty(t,"__esModule",{value:!0})});
-//# sourceMappingURL=bootstrap.min.js.map
diff --git a/docs/js/jquery-1.10.2.min.js b/docs/js/jquery-1.10.2.min.js
deleted file mode 100644
index da41706..0000000
--- a/docs/js/jquery-1.10.2.min.js
+++ /dev/null
@@ -1,6 +0,0 @@
-/*! jQuery v1.10.2 | (c) 2005, 2013 jQuery Foundation, Inc. | jquery.org/license
-//@ sourceMappingURL=jquery-1.10.2.min.map
-*/
-(function(e,t){var n,r,i=typeof t,o=e.location,a=e.document,s=a.documentElement,l=e.jQuery,u=e.$,c={},p=[],f="1.10.2",d=p.concat,h=p.push,g=p.slice,m=p.indexOf,y=c.toString,v=c.hasOwnProperty,b=f.trim,x=function(e,t){return new x.fn.init(e,t,r)},w=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,T=/\S+/g,C=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,N=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,k=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,E=/^[\],:{}\s]*$/,S=/(?:^|:|,)(?:\s*\[)+/g,A=/\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g,j=/"[^"\\\r\n]*"|true|false|null|-?(?:\d+\.|)\d+(?:[eE][+-]?\d+|)/g,D=/^-ms-/,L=/-([\da-z])/gi,H=function(e,t){return t.toUpperCase()},q=function(e){(a.addEventListener||"load"===e.type||"complete"===a.readyState)&&(_(),x.ready())},_=function(){a.addEventListener?(a.removeEventListener("DOMContentLoaded",q,!1),e.removeEventListener("load",q,!1)):(a.detachEvent("onreadystatechange",q),e.detachEvent("onload",q))};x.fn=x.prototype={jquery:f,constructor:x,init:function(e,n,r){var i,o;if(!e)return this;if("string"==typeof e){if(i="<"===e.charAt(0)&&">"===e.charAt(e.length-1)&&e.length>=3?[null,e,null]:N.exec(e),!i||!i[1]&&n)return!n||n.jquery?(n||r).find(e):this.constructor(n).find(e);if(i[1]){if(n=n instanceof x?n[0]:n,x.merge(this,x.parseHTML(i[1],n&&n.nodeType?n.ownerDocument||n:a,!0)),k.test(i[1])&&x.isPlainObject(n))for(i in n)x.isFunction(this[i])?this[i](n[i]):this.attr(i,n[i]);return this}if(o=a.getElementById(i[2]),o&&o.parentNode){if(o.id!==i[2])return r.find(e);this.length=1,this[0]=o}return this.context=a,this.selector=e,this}return e.nodeType?(this.context=this[0]=e,this.length=1,this):x.isFunction(e)?r.ready(e):(e.selector!==t&&(this.selector=e.selector,this.context=e.context),x.makeArray(e,this))},selector:"",length:0,toArray:function(){return g.call(this)},get:function(e){return null==e?this.toArray():0>e?this[this.length+e]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t.context=this.context,t},each:function(e,t){return x.each(this,e,t)},ready:function(e){return x.ready.promise().done(e),this},slice:function(){return this.pushStack(g.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(0>e?t:0);return this.pushStack(n>=0&&t>n?[this[n]]:[])},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},end:function(){return this.prevObject||this.constructor(null)},push:h,sort:[].sort,splice:[].splice},x.fn.init.prototype=x.fn,x.extend=x.fn.extend=function(){var e,n,r,i,o,a,s=arguments[0]||{},l=1,u=arguments.length,c=!1;for("boolean"==typeof s&&(c=s,s=arguments[1]||{},l=2),"object"==typeof s||x.isFunction(s)||(s={}),u===l&&(s=this,--l);u>l;l++)if(null!=(o=arguments[l]))for(i in o)e=s[i],r=o[i],s!==r&&(c&&r&&(x.isPlainObject(r)||(n=x.isArray(r)))?(n?(n=!1,a=e&&x.isArray(e)?e:[]):a=e&&x.isPlainObject(e)?e:{},s[i]=x.extend(c,a,r)):r!==t&&(s[i]=r));return s},x.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),noConflict:function(t){return e.$===x&&(e.$=u),t&&e.jQuery===x&&(e.jQuery=l),x},isReady:!1,readyWait:1,holdReady:function(e){e?x.readyWait++:x.ready(!0)},ready:function(e){if(e===!0?!--x.readyWait:!x.isReady){if(!a.body)return setTimeout(x.ready);x.isReady=!0,e!==!0&&--x.readyWait>0||(n.resolveWith(a,[x]),x.fn.trigger&&x(a).trigger("ready").off("ready"))}},isFunction:function(e){return"function"===x.type(e)},isArray:Array.isArray||function(e){return"array"===x.type(e)},isWindow:function(e){return null!=e&&e==e.window},isNumeric:function(e){return!isNaN(parseFloat(e))&&isFinite(e)},type:function(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[y.call(e)]||"object":typeof e},isPlainObject:function(e){var n;if(!e||"object"!==x.type(e)||e.nodeType||x.isWindow(e))return!1;try{if(e.constructor&&!v.call(e,"constructor")&&!v.call(e.constructor.prototype,"isPrototypeOf"))return!1}catch(r){return!1}if(x.support.ownLast)for(n in e)return v.call(e,n);for(n in e);return n===t||v.call(e,n)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},error:function(e){throw Error(e)},parseHTML:function(e,t,n){if(!e||"string"!=typeof e)return null;"boolean"==typeof t&&(n=t,t=!1),t=t||a;var r=k.exec(e),i=!n&&[];return r?[t.createElement(r[1])]:(r=x.buildFragment([e],t,i),i&&x(i).remove(),x.merge([],r.childNodes))},parseJSON:function(n){return e.JSON&&e.JSON.parse?e.JSON.parse(n):null===n?n:"string"==typeof n&&(n=x.trim(n),n&&E.test(n.replace(A,"@").replace(j,"]").replace(S,"")))?Function("return "+n)():(x.error("Invalid JSON: "+n),t)},parseXML:function(n){var r,i;if(!n||"string"!=typeof n)return null;try{e.DOMParser?(i=new DOMParser,r=i.parseFromString(n,"text/xml")):(r=new ActiveXObject("Microsoft.XMLDOM"),r.async="false",r.loadXML(n))}catch(o){r=t}return r&&r.documentElement&&!r.getElementsByTagName("parsererror").length||x.error("Invalid XML: "+n),r},noop:function(){},globalEval:function(t){t&&x.trim(t)&&(e.execScript||function(t){e.eval.call(e,t)})(t)},camelCase:function(e){return e.replace(D,"ms-").replace(L,H)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,t,n){var r,i=0,o=e.length,a=M(e);if(n){if(a){for(;o>i;i++)if(r=t.apply(e[i],n),r===!1)break}else for(i in e)if(r=t.apply(e[i],n),r===!1)break}else if(a){for(;o>i;i++)if(r=t.call(e[i],i,e[i]),r===!1)break}else for(i in e)if(r=t.call(e[i],i,e[i]),r===!1)break;return e},trim:b&&!b.call("\ufeff\u00a0")?function(e){return null==e?"":b.call(e)}:function(e){return null==e?"":(e+"").replace(C,"")},makeArray:function(e,t){var n=t||[];return null!=e&&(M(Object(e))?x.merge(n,"string"==typeof e?[e]:e):h.call(n,e)),n},inArray:function(e,t,n){var r;if(t){if(m)return m.call(t,e,n);for(r=t.length,n=n?0>n?Math.max(0,r+n):n:0;r>n;n++)if(n in t&&t[n]===e)return n}return-1},merge:function(e,n){var r=n.length,i=e.length,o=0;if("number"==typeof r)for(;r>o;o++)e[i++]=n[o];else while(n[o]!==t)e[i++]=n[o++];return e.length=i,e},grep:function(e,t,n){var r,i=[],o=0,a=e.length;for(n=!!n;a>o;o++)r=!!t(e[o],o),n!==r&&i.push(e[o]);return i},map:function(e,t,n){var r,i=0,o=e.length,a=M(e),s=[];if(a)for(;o>i;i++)r=t(e[i],i,n),null!=r&&(s[s.length]=r);else for(i in e)r=t(e[i],i,n),null!=r&&(s[s.length]=r);return d.apply([],s)},guid:1,proxy:function(e,n){var r,i,o;return"string"==typeof n&&(o=e[n],n=e,e=o),x.isFunction(e)?(r=g.call(arguments,2),i=function(){return e.apply(n||this,r.concat(g.call(arguments)))},i.guid=e.guid=e.guid||x.guid++,i):t},access:function(e,n,r,i,o,a,s){var l=0,u=e.length,c=null==r;if("object"===x.type(r)){o=!0;for(l in r)x.access(e,n,l,r[l],!0,a,s)}else if(i!==t&&(o=!0,x.isFunction(i)||(s=!0),c&&(s?(n.call(e,i),n=null):(c=n,n=function(e,t,n){return c.call(x(e),n)})),n))for(;u>l;l++)n(e[l],r,s?i:i.call(e[l],l,n(e[l],r)));return o?e:c?n.call(e):u?n(e[0],r):a},now:function(){return(new Date).getTime()},swap:function(e,t,n,r){var i,o,a={};for(o in t)a[o]=e.style[o],e.style[o]=t[o];i=n.apply(e,r||[]);for(o in t)e.style[o]=a[o];return i}}),x.ready.promise=function(t){if(!n)if(n=x.Deferred(),"complete"===a.readyState)setTimeout(x.ready);else if(a.addEventListener)a.addEventListener("DOMContentLoaded",q,!1),e.addEventListener("load",q,!1);else{a.attachEvent("onreadystatechange",q),e.attachEvent("onload",q);var r=!1;try{r=null==e.frameElement&&a.documentElement}catch(i){}r&&r.doScroll&&function o(){if(!x.isReady){try{r.doScroll("left")}catch(e){return setTimeout(o,50)}_(),x.ready()}}()}return n.promise(t)},x.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(e,t){c["[object "+t+"]"]=t.toLowerCase()});function M(e){var t=e.length,n=x.type(e);return x.isWindow(e)?!1:1===e.nodeType&&t?!0:"array"===n||"function"!==n&&(0===t||"number"==typeof t&&t>0&&t-1 in e)}r=x(a),function(e,t){var n,r,i,o,a,s,l,u,c,p,f,d,h,g,m,y,v,b="sizzle"+-new Date,w=e.document,T=0,C=0,N=st(),k=st(),E=st(),S=!1,A=function(e,t){return e===t?(S=!0,0):0},j=typeof t,D=1<<31,L={}.hasOwnProperty,H=[],q=H.pop,_=H.push,M=H.push,O=H.slice,F=H.indexOf||function(e){var t=0,n=this.length;for(;n>t;t++)if(this[t]===e)return t;return-1},B="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",P="[\\x20\\t\\r\\n\\f]",R="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",W=R.replace("w","w#"),$="\\["+P+"*("+R+")"+P+"*(?:([*^$|!~]?=)"+P+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+W+")|)|)"+P+"*\\]",I=":("+R+")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|"+$.replace(3,8)+")*)|.*)\\)|)",z=RegExp("^"+P+"+|((?:^|[^\\\\])(?:\\\\.)*)"+P+"+$","g"),X=RegExp("^"+P+"*,"+P+"*"),U=RegExp("^"+P+"*([>+~]|"+P+")"+P+"*"),V=RegExp(P+"*[+~]"),Y=RegExp("="+P+"*([^\\]'\"]*)"+P+"*\\]","g"),J=RegExp(I),G=RegExp("^"+W+"$"),Q={ID:RegExp("^#("+R+")"),CLASS:RegExp("^\\.("+R+")"),TAG:RegExp("^("+R.replace("w","w*")+")"),ATTR:RegExp("^"+$),PSEUDO:RegExp("^"+I),CHILD:RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+P+"*(even|odd|(([+-]|)(\\d*)n|)"+P+"*(?:([+-]|)"+P+"*(\\d+)|))"+P+"*\\)|)","i"),bool:RegExp("^(?:"+B+")$","i"),needsContext:RegExp("^"+P+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+P+"*((?:-\\d)?\\d*)"+P+"*\\)|)(?=[^-]|$)","i")},K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,et=/^(?:input|select|textarea|button)$/i,tt=/^h\d$/i,nt=/'|\\/g,rt=RegExp("\\\\([\\da-f]{1,6}"+P+"?|("+P+")|.)","ig"),it=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:0>r?String.fromCharCode(r+65536):String.fromCharCode(55296|r>>10,56320|1023&r)};try{M.apply(H=O.call(w.childNodes),w.childNodes),H[w.childNodes.length].nodeType}catch(ot){M={apply:H.length?function(e,t){_.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function at(e,t,n,i){var o,a,s,l,u,c,d,m,y,x;if((t?t.ownerDocument||t:w)!==f&&p(t),t=t||f,n=n||[],!e||"string"!=typeof e)return n;if(1!==(l=t.nodeType)&&9!==l)return[];if(h&&!i){if(o=Z.exec(e))if(s=o[1]){if(9===l){if(a=t.getElementById(s),!a||!a.parentNode)return n;if(a.id===s)return n.push(a),n}else if(t.ownerDocument&&(a=t.ownerDocument.getElementById(s))&&v(t,a)&&a.id===s)return n.push(a),n}else{if(o[2])return M.apply(n,t.getElementsByTagName(e)),n;if((s=o[3])&&r.getElementsByClassName&&t.getElementsByClassName)return M.apply(n,t.getElementsByClassName(s)),n}if(r.qsa&&(!g||!g.test(e))){if(m=d=b,y=t,x=9===l&&e,1===l&&"object"!==t.nodeName.toLowerCase()){c=mt(e),(d=t.getAttribute("id"))?m=d.replace(nt,"\\$&"):t.setAttribute("id",m),m="[id='"+m+"'] ",u=c.length;while(u--)c[u]=m+yt(c[u]);y=V.test(e)&&t.parentNode||t,x=c.join(",")}if(x)try{return M.apply(n,y.querySelectorAll(x)),n}catch(T){}finally{d||t.removeAttribute("id")}}}return kt(e.replace(z,"$1"),t,n,i)}function st(){var e=[];function t(n,r){return e.push(n+=" ")>o.cacheLength&&delete t[e.shift()],t[n]=r}return t}function lt(e){return e[b]=!0,e}function ut(e){var t=f.createElement("div");try{return!!e(t)}catch(n){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ct(e,t){var n=e.split("|"),r=e.length;while(r--)o.attrHandle[n[r]]=t}function pt(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&(~t.sourceIndex||D)-(~e.sourceIndex||D);if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function ft(e){return function(t){var n=t.nodeName.toLowerCase();return"input"===n&&t.type===e}}function dt(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function ht(e){return lt(function(t){return t=+t,lt(function(n,r){var i,o=e([],n.length,t),a=o.length;while(a--)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}s=at.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?"HTML"!==t.nodeName:!1},r=at.support={},p=at.setDocument=function(e){var n=e?e.ownerDocument||e:w,i=n.defaultView;return n!==f&&9===n.nodeType&&n.documentElement?(f=n,d=n.documentElement,h=!s(n),i&&i.attachEvent&&i!==i.top&&i.attachEvent("onbeforeunload",function(){p()}),r.attributes=ut(function(e){return e.className="i",!e.getAttribute("className")}),r.getElementsByTagName=ut(function(e){return e.appendChild(n.createComment("")),!e.getElementsByTagName("*").length}),r.getElementsByClassName=ut(function(e){return e.innerHTML="<div class='a'></div><div class='a i'></div>",e.firstChild.className="i",2===e.getElementsByClassName("i").length}),r.getById=ut(function(e){return d.appendChild(e).id=b,!n.getElementsByName||!n.getElementsByName(b).length}),r.getById?(o.find.ID=function(e,t){if(typeof t.getElementById!==j&&h){var n=t.getElementById(e);return n&&n.parentNode?[n]:[]}},o.filter.ID=function(e){var t=e.replace(rt,it);return function(e){return e.getAttribute("id")===t}}):(delete o.find.ID,o.filter.ID=function(e){var t=e.replace(rt,it);return function(e){var n=typeof e.getAttributeNode!==j&&e.getAttributeNode("id");return n&&n.value===t}}),o.find.TAG=r.getElementsByTagName?function(e,n){return typeof n.getElementsByTagName!==j?n.getElementsByTagName(e):t}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},o.find.CLASS=r.getElementsByClassName&&function(e,n){return typeof n.getElementsByClassName!==j&&h?n.getElementsByClassName(e):t},m=[],g=[],(r.qsa=K.test(n.querySelectorAll))&&(ut(function(e){e.innerHTML="<select><option selected=''></option></select>",e.querySelectorAll("[selected]").length||g.push("\\["+P+"*(?:value|"+B+")"),e.querySelectorAll(":checked").length||g.push(":checked")}),ut(function(e){var t=n.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("t",""),e.querySelectorAll("[t^='']").length&&g.push("[*^$]="+P+"*(?:''|\"\")"),e.querySelectorAll(":enabled").length||g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(r.matchesSelector=K.test(y=d.webkitMatchesSelector||d.mozMatchesSelector||d.oMatchesSelector||d.msMatchesSelector))&&ut(function(e){r.disconnectedMatch=y.call(e,"div"),y.call(e,"[s!='']:x"),m.push("!=",I)}),g=g.length&&RegExp(g.join("|")),m=m.length&&RegExp(m.join("|")),v=K.test(d.contains)||d.compareDocumentPosition?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},A=d.compareDocumentPosition?function(e,t){if(e===t)return S=!0,0;var i=t.compareDocumentPosition&&e.compareDocumentPosition&&e.compareDocumentPosition(t);return i?1&i||!r.sortDetached&&t.compareDocumentPosition(e)===i?e===n||v(w,e)?-1:t===n||v(w,t)?1:c?F.call(c,e)-F.call(c,t):0:4&i?-1:1:e.compareDocumentPosition?-1:1}:function(e,t){var r,i=0,o=e.parentNode,a=t.parentNode,s=[e],l=[t];if(e===t)return S=!0,0;if(!o||!a)return e===n?-1:t===n?1:o?-1:a?1:c?F.call(c,e)-F.call(c,t):0;if(o===a)return pt(e,t);r=e;while(r=r.parentNode)s.unshift(r);r=t;while(r=r.parentNode)l.unshift(r);while(s[i]===l[i])i++;return i?pt(s[i],l[i]):s[i]===w?-1:l[i]===w?1:0},n):f},at.matches=function(e,t){return at(e,null,null,t)},at.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(Y,"='$1']"),!(!r.matchesSelector||!h||m&&m.test(t)||g&&g.test(t)))try{var n=y.call(e,t);if(n||r.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(i){}return at(t,f,null,[e]).length>0},at.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},at.attr=function(e,n){(e.ownerDocument||e)!==f&&p(e);var i=o.attrHandle[n.toLowerCase()],a=i&&L.call(o.attrHandle,n.toLowerCase())?i(e,n,!h):t;return a===t?r.attributes||!h?e.getAttribute(n):(a=e.getAttributeNode(n))&&a.specified?a.value:null:a},at.error=function(e){throw Error("Syntax error, unrecognized expression: "+e)},at.uniqueSort=function(e){var t,n=[],i=0,o=0;if(S=!r.detectDuplicates,c=!r.sortStable&&e.slice(0),e.sort(A),S){while(t=e[o++])t===e[o]&&(i=n.push(o));while(i--)e.splice(n[i],1)}return e},a=at.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=a(e)}else if(3===i||4===i)return e.nodeValue}else for(;t=e[r];r++)n+=a(t);return n},o=at.selectors={cacheLength:50,createPseudo:lt,match:Q,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(rt,it),e[3]=(e[4]||e[5]||"").replace(rt,it),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||at.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&at.error(e[0]),e},PSEUDO:function(e){var n,r=!e[5]&&e[2];return Q.CHILD.test(e[0])?null:(e[3]&&e[4]!==t?e[2]=e[4]:r&&J.test(r)&&(n=mt(r,!0))&&(n=r.indexOf(")",r.length-n)-r.length)&&(e[0]=e[0].slice(0,n),e[2]=r.slice(0,n)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(rt,it).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=N[e+" "];return t||(t=RegExp("(^|"+P+")"+e+"("+P+"|$)"))&&N(e,function(e){return t.test("string"==typeof e.className&&e.className||typeof e.getAttribute!==j&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=at.attr(r,e);return null==i?"!="===t:t?(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i+" ").indexOf(n)>-1:"|="===t?i===n||i.slice(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var u,c,p,f,d,h,g=o!==a?"nextSibling":"previousSibling",m=t.parentNode,y=s&&t.nodeName.toLowerCase(),v=!l&&!s;if(m){if(o){while(g){p=t;while(p=p[g])if(s?p.nodeName.toLowerCase()===y:1===p.nodeType)return!1;h=g="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?m.firstChild:m.lastChild],a&&v){c=m[b]||(m[b]={}),u=c[e]||[],d=u[0]===T&&u[1],f=u[0]===T&&u[2],p=d&&m.childNodes[d];while(p=++d&&p&&p[g]||(f=d=0)||h.pop())if(1===p.nodeType&&++f&&p===t){c[e]=[T,d,f];break}}else if(v&&(u=(t[b]||(t[b]={}))[e])&&u[0]===T)f=u[1];else while(p=++d&&p&&p[g]||(f=d=0)||h.pop())if((s?p.nodeName.toLowerCase()===y:1===p.nodeType)&&++f&&(v&&((p[b]||(p[b]={}))[e]=[T,f]),p===t))break;return f-=i,f===r||0===f%r&&f/r>=0}}},PSEUDO:function(e,t){var n,r=o.pseudos[e]||o.setFilters[e.toLowerCase()]||at.error("unsupported pseudo: "+e);return r[b]?r(t):r.length>1?(n=[e,e,"",t],o.setFilters.hasOwnProperty(e.toLowerCase())?lt(function(e,n){var i,o=r(e,t),a=o.length;while(a--)i=F.call(e,o[a]),e[i]=!(n[i]=o[a])}):function(e){return r(e,0,n)}):r}},pseudos:{not:lt(function(e){var t=[],n=[],r=l(e.replace(z,"$1"));return r[b]?lt(function(e,t,n,i){var o,a=r(e,null,i,[]),s=e.length;while(s--)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),!n.pop()}}),has:lt(function(e){return function(t){return at(e,t).length>0}}),contains:lt(function(e){return function(t){return(t.textContent||t.innerText||a(t)).indexOf(e)>-1}}),lang:lt(function(e){return G.test(e||"")||at.error("unsupported lang: "+e),e=e.replace(rt,it).toLowerCase(),function(t){var n;do if(n=h?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===d},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeName>"@"||3===e.nodeType||4===e.nodeType)return!1;return!0},parent:function(e){return!o.pseudos.empty(e)},header:function(e){return tt.test(e.nodeName)},input:function(e){return et.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||t.toLowerCase()===e.type)},first:ht(function(){return[0]}),last:ht(function(e,t){return[t-1]}),eq:ht(function(e,t,n){return[0>n?n+t:n]}),even:ht(function(e,t){var n=0;for(;t>n;n+=2)e.push(n);return e}),odd:ht(function(e,t){var n=1;for(;t>n;n+=2)e.push(n);return e}),lt:ht(function(e,t,n){var r=0>n?n+t:n;for(;--r>=0;)e.push(r);return e}),gt:ht(function(e,t,n){var r=0>n?n+t:n;for(;t>++r;)e.push(r);return e})}},o.pseudos.nth=o.pseudos.eq;for(n in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})o.pseudos[n]=ft(n);for(n in{submit:!0,reset:!0})o.pseudos[n]=dt(n);function gt(){}gt.prototype=o.filters=o.pseudos,o.setFilters=new gt;function mt(e,t){var n,r,i,a,s,l,u,c=k[e+" "];if(c)return t?0:c.slice(0);s=e,l=[],u=o.preFilter;while(s){(!n||(r=X.exec(s)))&&(r&&(s=s.slice(r[0].length)||s),l.push(i=[])),n=!1,(r=U.exec(s))&&(n=r.shift(),i.push({value:n,type:r[0].replace(z," ")}),s=s.slice(n.length));for(a in o.filter)!(r=Q[a].exec(s))||u[a]&&!(r=u[a](r))||(n=r.shift(),i.push({value:n,type:a,matches:r}),s=s.slice(n.length));if(!n)break}return t?s.length:s?at.error(e):k(e,l).slice(0)}function yt(e){var t=0,n=e.length,r="";for(;n>t;t++)r+=e[t].value;return r}function vt(e,t,n){var r=t.dir,o=n&&"parentNode"===r,a=C++;return t.first?function(t,n,i){while(t=t[r])if(1===t.nodeType||o)return e(t,n,i)}:function(t,n,s){var l,u,c,p=T+" "+a;if(s){while(t=t[r])if((1===t.nodeType||o)&&e(t,n,s))return!0}else while(t=t[r])if(1===t.nodeType||o)if(c=t[b]||(t[b]={}),(u=c[r])&&u[0]===p){if((l=u[1])===!0||l===i)return l===!0}else if(u=c[r]=[p],u[1]=e(t,n,s)||i,u[1]===!0)return!0}}function bt(e){return e.length>1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function xt(e,t,n,r,i){var o,a=[],s=0,l=e.length,u=null!=t;for(;l>s;s++)(o=e[s])&&(!n||n(o,r,i))&&(a.push(o),u&&t.push(s));return a}function wt(e,t,n,r,i,o){return r&&!r[b]&&(r=wt(r)),i&&!i[b]&&(i=wt(i,o)),lt(function(o,a,s,l){var u,c,p,f=[],d=[],h=a.length,g=o||Nt(t||"*",s.nodeType?[s]:s,[]),m=!e||!o&&t?g:xt(g,f,e,s,l),y=n?i||(o?e:h||r)?[]:a:m;if(n&&n(m,y,s,l),r){u=xt(y,d),r(u,[],s,l),c=u.length;while(c--)(p=u[c])&&(y[d[c]]=!(m[d[c]]=p))}if(o){if(i||e){if(i){u=[],c=y.length;while(c--)(p=y[c])&&u.push(m[c]=p);i(null,y=[],u,l)}c=y.length;while(c--)(p=y[c])&&(u=i?F.call(o,p):f[c])>-1&&(o[u]=!(a[u]=p))}}else y=xt(y===a?y.splice(h,y.length):y),i?i(null,a,y,l):M.apply(a,y)})}function Tt(e){var t,n,r,i=e.length,a=o.relative[e[0].type],s=a||o.relative[" "],l=a?1:0,c=vt(function(e){return e===t},s,!0),p=vt(function(e){return F.call(t,e)>-1},s,!0),f=[function(e,n,r){return!a&&(r||n!==u)||((t=n).nodeType?c(e,n,r):p(e,n,r))}];for(;i>l;l++)if(n=o.relative[e[l].type])f=[vt(bt(f),n)];else{if(n=o.filter[e[l].type].apply(null,e[l].matches),n[b]){for(r=++l;i>r;r++)if(o.relative[e[r].type])break;return wt(l>1&&bt(f),l>1&&yt(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(z,"$1"),n,r>l&&Tt(e.slice(l,r)),i>r&&Tt(e=e.slice(r)),i>r&&yt(e))}f.push(n)}return bt(f)}function Ct(e,t){var n=0,r=t.length>0,a=e.length>0,s=function(s,l,c,p,d){var h,g,m,y=[],v=0,b="0",x=s&&[],w=null!=d,C=u,N=s||a&&o.find.TAG("*",d&&l.parentNode||l),k=T+=null==C?1:Math.random()||.1;for(w&&(u=l!==f&&l,i=n);null!=(h=N[b]);b++){if(a&&h){g=0;while(m=e[g++])if(m(h,l,c)){p.push(h);break}w&&(T=k,i=++n)}r&&((h=!m&&h)&&v--,s&&x.push(h))}if(v+=b,r&&b!==v){g=0;while(m=t[g++])m(x,y,l,c);if(s){if(v>0)while(b--)x[b]||y[b]||(y[b]=q.call(p));y=xt(y)}M.apply(p,y),w&&!s&&y.length>0&&v+t.length>1&&at.uniqueSort(p)}return w&&(T=k,u=C),x};return r?lt(s):s}l=at.compile=function(e,t){var n,r=[],i=[],o=E[e+" "];if(!o){t||(t=mt(e)),n=t.length;while(n--)o=Tt(t[n]),o[b]?r.push(o):i.push(o);o=E(e,Ct(i,r))}return o};function Nt(e,t,n){var r=0,i=t.length;for(;i>r;r++)at(e,t[r],n);return n}function kt(e,t,n,i){var a,s,u,c,p,f=mt(e);if(!i&&1===f.length){if(s=f[0]=f[0].slice(0),s.length>2&&"ID"===(u=s[0]).type&&r.getById&&9===t.nodeType&&h&&o.relative[s[1].type]){if(t=(o.find.ID(u.matches[0].replace(rt,it),t)||[])[0],!t)return n;e=e.slice(s.shift().value.length)}a=Q.needsContext.test(e)?0:s.length;while(a--){if(u=s[a],o.relative[c=u.type])break;if((p=o.find[c])&&(i=p(u.matches[0].replace(rt,it),V.test(s[0].type)&&t.parentNode||t))){if(s.splice(a,1),e=i.length&&yt(s),!e)return M.apply(n,i),n;break}}}return l(e,f)(i,t,!h,n,V.test(e)),n}r.sortStable=b.split("").sort(A).join("")===b,r.detectDuplicates=S,p(),r.sortDetached=ut(function(e){return 1&e.compareDocumentPosition(f.createElement("div"))}),ut(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||ct("type|href|height|width",function(e,n,r){return r?t:e.getAttribute(n,"type"===n.toLowerCase()?1:2)}),r.attributes&&ut(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ct("value",function(e,n,r){return r||"input"!==e.nodeName.toLowerCase()?t:e.defaultValue}),ut(function(e){return null==e.getAttribute("disabled")})||ct(B,function(e,n,r){var i;return r?t:(i=e.getAttributeNode(n))&&i.specified?i.value:e[n]===!0?n.toLowerCase():null}),x.find=at,x.expr=at.selectors,x.expr[":"]=x.expr.pseudos,x.unique=at.uniqueSort,x.text=at.getText,x.isXMLDoc=at.isXML,x.contains=at.contains}(e);var O={};function F(e){var t=O[e]={};return x.each(e.match(T)||[],function(e,n){t[n]=!0}),t}x.Callbacks=function(e){e="string"==typeof e?O[e]||F(e):x.extend({},e);var n,r,i,o,a,s,l=[],u=!e.once&&[],c=function(t){for(r=e.memory&&t,i=!0,a=s||0,s=0,o=l.length,n=!0;l&&o>a;a++)if(l[a].apply(t[0],t[1])===!1&&e.stopOnFalse){r=!1;break}n=!1,l&&(u?u.length&&c(u.shift()):r?l=[]:p.disable())},p={add:function(){if(l){var t=l.length;(function i(t){x.each(t,function(t,n){var r=x.type(n);"function"===r?e.unique&&p.has(n)||l.push(n):n&&n.length&&"string"!==r&&i(n)})})(arguments),n?o=l.length:r&&(s=t,c(r))}return this},remove:function(){return l&&x.each(arguments,function(e,t){var r;while((r=x.inArray(t,l,r))>-1)l.splice(r,1),n&&(o>=r&&o--,a>=r&&a--)}),this},has:function(e){return e?x.inArray(e,l)>-1:!(!l||!l.length)},empty:function(){return l=[],o=0,this},disable:function(){return l=u=r=t,this},disabled:function(){return!l},lock:function(){return u=t,r||p.disable(),this},locked:function(){return!u},fireWith:function(e,t){return!l||i&&!u||(t=t||[],t=[e,t.slice?t.slice():t],n?u.push(t):c(t)),this},fire:function(){return p.fireWith(this,arguments),this},fired:function(){return!!i}};return p},x.extend({Deferred:function(e){var t=[["resolve","done",x.Callbacks("once memory"),"resolved"],["reject","fail",x.Callbacks("once memory"),"rejected"],["notify","progress",x.Callbacks("memory")]],n="pending",r={state:function(){return n},always:function(){return i.done(arguments).fail(arguments),this},then:function(){var e=arguments;return x.Deferred(function(n){x.each(t,function(t,o){var a=o[0],s=x.isFunction(e[t])&&e[t];i[o[1]](function(){var e=s&&s.apply(this,arguments);e&&x.isFunction(e.promise)?e.promise().done(n.resolve).fail(n.reject).progress(n.notify):n[a+"With"](this===r?n.promise():this,s?[e]:arguments)})}),e=null}).promise()},promise:function(e){return null!=e?x.extend(e,r):r}},i={};return r.pipe=r.then,x.each(t,function(e,o){var a=o[2],s=o[3];r[o[1]]=a.add,s&&a.add(function(){n=s},t[1^e][2].disable,t[2][2].lock),i[o[0]]=function(){return i[o[0]+"With"](this===i?r:this,arguments),this},i[o[0]+"With"]=a.fireWith}),r.promise(i),e&&e.call(i,i),i},when:function(e){var t=0,n=g.call(arguments),r=n.length,i=1!==r||e&&x.isFunction(e.promise)?r:0,o=1===i?e:x.Deferred(),a=function(e,t,n){return function(r){t[e]=this,n[e]=arguments.length>1?g.call(arguments):r,n===s?o.notifyWith(t,n):--i||o.resolveWith(t,n)}},s,l,u;if(r>1)for(s=Array(r),l=Array(r),u=Array(r);r>t;t++)n[t]&&x.isFunction(n[t].promise)?n[t].promise().done(a(t,u,n)).fail(o.reject).progress(a(t,l,s)):--i;return i||o.resolveWith(u,n),o.promise()}}),x.support=function(t){var n,r,o,s,l,u,c,p,f,d=a.createElement("div");if(d.setAttribute("className","t"),d.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",n=d.getElementsByTagName("*")||[],r=d.getElementsByTagName("a")[0],!r||!r.style||!n.length)return t;s=a.createElement("select"),u=s.appendChild(a.createElement("option")),o=d.getElementsByTagName("input")[0],r.style.cssText="top:1px;float:left;opacity:.5",t.getSetAttribute="t"!==d.className,t.leadingWhitespace=3===d.firstChild.nodeType,t.tbody=!d.getElementsByTagName("tbody").length,t.htmlSerialize=!!d.getElementsByTagName("link").length,t.style=/top/.test(r.getAttribute("style")),t.hrefNormalized="/a"===r.getAttribute("href"),t.opacity=/^0.5/.test(r.style.opacity),t.cssFloat=!!r.style.cssFloat,t.checkOn=!!o.value,t.optSelected=u.selected,t.enctype=!!a.createElement("form").enctype,t.html5Clone="<:nav></:nav>"!==a.createElement("nav").cloneNode(!0).outerHTML,t.inlineBlockNeedsLayout=!1,t.shrinkWrapBlocks=!1,t.pixelPosition=!1,t.deleteExpando=!0,t.noCloneEvent=!0,t.reliableMarginRight=!0,t.boxSizingReliable=!0,o.checked=!0,t.noCloneChecked=o.cloneNode(!0).checked,s.disabled=!0,t.optDisabled=!u.disabled;try{delete d.test}catch(h){t.deleteExpando=!1}o=a.createElement("input"),o.setAttribute("value",""),t.input=""===o.getAttribute("value"),o.value="t",o.setAttribute("type","radio"),t.radioValue="t"===o.value,o.setAttribute("checked","t"),o.setAttribute("name","t"),l=a.createDocumentFragment(),l.appendChild(o),t.appendChecked=o.checked,t.checkClone=l.cloneNode(!0).cloneNode(!0).lastChild.checked,d.attachEvent&&(d.attachEvent("onclick",function(){t.noCloneEvent=!1}),d.cloneNode(!0).click());for(f in{submit:!0,change:!0,focusin:!0})d.setAttribute(c="on"+f,"t"),t[f+"Bubbles"]=c in e||d.attributes[c].expando===!1;d.style.backgroundClip="content-box",d.cloneNode(!0).style.backgroundClip="",t.clearCloneStyle="content-box"===d.style.backgroundClip;for(f in x(t))break;return t.ownLast="0"!==f,x(function(){var n,r,o,s="padding:0;margin:0;border:0;display:block;box-sizing:content-box;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;",l=a.getElementsByTagName("body")[0];l&&(n=a.createElement("div"),n.style.cssText="border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px",l.appendChild(n).appendChild(d),d.innerHTML="<table><tr><td></td><td>t</td></tr></table>",o=d.getElementsByTagName("td"),o[0].style.cssText="padding:0;margin:0;border:0;display:none",p=0===o[0].offsetHeight,o[0].style.display="",o[1].style.display="none",t.reliableHiddenOffsets=p&&0===o[0].offsetHeight,d.innerHTML="",d.style.cssText="box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;",x.swap(l,null!=l.style.zoom?{zoom:1}:{},function(){t.boxSizing=4===d.offsetWidth}),e.getComputedStyle&&(t.pixelPosition="1%"!==(e.getComputedStyle(d,null)||{}).top,t.boxSizingReliable="4px"===(e.getComputedStyle(d,null)||{width:"4px"}).width,r=d.appendChild(a.createElement("div")),r.style.cssText=d.style.cssText=s,r.style.marginRight=r.style.width="0",d.style.width="1px",t.reliableMarginRight=!parseFloat((e.getComputedStyle(r,null)||{}).marginRight)),typeof d.style.zoom!==i&&(d.innerHTML="",d.style.cssText=s+"width:1px;padding:1px;display:inline;zoom:1",t.inlineBlockNeedsLayout=3===d.offsetWidth,d.style.display="block",d.innerHTML="<div></div>",d.firstChild.style.width="5px",t.shrinkWrapBlocks=3!==d.offsetWidth,t.inlineBlockNeedsLayout&&(l.style.zoom=1)),l.removeChild(n),n=d=o=r=null)}),n=s=l=u=r=o=null,t
-}({});var B=/(?:\{[\s\S]*\}|\[[\s\S]*\])$/,P=/([A-Z])/g;function R(e,n,r,i){if(x.acceptData(e)){var o,a,s=x.expando,l=e.nodeType,u=l?x.cache:e,c=l?e[s]:e[s]&&s;if(c&&u[c]&&(i||u[c].data)||r!==t||"string"!=typeof n)return c||(c=l?e[s]=p.pop()||x.guid++:s),u[c]||(u[c]=l?{}:{toJSON:x.noop}),("object"==typeof n||"function"==typeof n)&&(i?u[c]=x.extend(u[c],n):u[c].data=x.extend(u[c].data,n)),a=u[c],i||(a.data||(a.data={}),a=a.data),r!==t&&(a[x.camelCase(n)]=r),"string"==typeof n?(o=a[n],null==o&&(o=a[x.camelCase(n)])):o=a,o}}function W(e,t,n){if(x.acceptData(e)){var r,i,o=e.nodeType,a=o?x.cache:e,s=o?e[x.expando]:x.expando;if(a[s]){if(t&&(r=n?a[s]:a[s].data)){x.isArray(t)?t=t.concat(x.map(t,x.camelCase)):t in r?t=[t]:(t=x.camelCase(t),t=t in r?[t]:t.split(" ")),i=t.length;while(i--)delete r[t[i]];if(n?!I(r):!x.isEmptyObject(r))return}(n||(delete a[s].data,I(a[s])))&&(o?x.cleanData([e],!0):x.support.deleteExpando||a!=a.window?delete a[s]:a[s]=null)}}}x.extend({cache:{},noData:{applet:!0,embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"},hasData:function(e){return e=e.nodeType?x.cache[e[x.expando]]:e[x.expando],!!e&&!I(e)},data:function(e,t,n){return R(e,t,n)},removeData:function(e,t){return W(e,t)},_data:function(e,t,n){return R(e,t,n,!0)},_removeData:function(e,t){return W(e,t,!0)},acceptData:function(e){if(e.nodeType&&1!==e.nodeType&&9!==e.nodeType)return!1;var t=e.nodeName&&x.noData[e.nodeName.toLowerCase()];return!t||t!==!0&&e.getAttribute("classid")===t}}),x.fn.extend({data:function(e,n){var r,i,o=null,a=0,s=this[0];if(e===t){if(this.length&&(o=x.data(s),1===s.nodeType&&!x._data(s,"parsedAttrs"))){for(r=s.attributes;r.length>a;a++)i=r[a].name,0===i.indexOf("data-")&&(i=x.camelCase(i.slice(5)),$(s,i,o[i]));x._data(s,"parsedAttrs",!0)}return o}return"object"==typeof e?this.each(function(){x.data(this,e)}):arguments.length>1?this.each(function(){x.data(this,e,n)}):s?$(s,e,x.data(s,e)):null},removeData:function(e){return this.each(function(){x.removeData(this,e)})}});function $(e,n,r){if(r===t&&1===e.nodeType){var i="data-"+n.replace(P,"-$1").toLowerCase();if(r=e.getAttribute(i),"string"==typeof r){try{r="true"===r?!0:"false"===r?!1:"null"===r?null:+r+""===r?+r:B.test(r)?x.parseJSON(r):r}catch(o){}x.data(e,n,r)}else r=t}return r}function I(e){var t;for(t in e)if(("data"!==t||!x.isEmptyObject(e[t]))&&"toJSON"!==t)return!1;return!0}x.extend({queue:function(e,n,r){var i;return e?(n=(n||"fx")+"queue",i=x._data(e,n),r&&(!i||x.isArray(r)?i=x._data(e,n,x.makeArray(r)):i.push(r)),i||[]):t},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t),a=function(){x.dequeue(e,t)};"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,a,o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return x._data(e,n)||x._data(e,n,{empty:x.Callbacks("once memory").add(function(){x._removeData(e,t+"queue"),x._removeData(e,n)})})}}),x.fn.extend({queue:function(e,n){var r=2;return"string"!=typeof e&&(n=e,e="fx",r--),r>arguments.length?x.queue(this[0],e):n===t?this:this.each(function(){var t=x.queue(this,e,n);x._queueHooks(this,e),"fx"===e&&"inprogress"!==t[0]&&x.dequeue(this,e)})},dequeue:function(e){return this.each(function(){x.dequeue(this,e)})},delay:function(e,t){return e=x.fx?x.fx.speeds[e]||e:e,t=t||"fx",this.queue(t,function(t,n){var r=setTimeout(t,e);n.stop=function(){clearTimeout(r)}})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,n){var r,i=1,o=x.Deferred(),a=this,s=this.length,l=function(){--i||o.resolveWith(a,[a])};"string"!=typeof e&&(n=e,e=t),e=e||"fx";while(s--)r=x._data(a[s],e+"queueHooks"),r&&r.empty&&(i++,r.empty.add(l));return l(),o.promise(n)}});var z,X,U=/[\t\r\n\f]/g,V=/\r/g,Y=/^(?:input|select|textarea|button|object)$/i,J=/^(?:a|area)$/i,G=/^(?:checked|selected)$/i,Q=x.support.getSetAttribute,K=x.support.input;x.fn.extend({attr:function(e,t){return x.access(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})},prop:function(e,t){return x.access(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return e=x.propFix[e]||e,this.each(function(){try{this[e]=t,delete this[e]}catch(n){}})},addClass:function(e){var t,n,r,i,o,a=0,s=this.length,l="string"==typeof e&&e;if(x.isFunction(e))return this.each(function(t){x(this).addClass(e.call(this,t,this.className))});if(l)for(t=(e||"").match(T)||[];s>a;a++)if(n=this[a],r=1===n.nodeType&&(n.className?(" "+n.className+" ").replace(U," "):" ")){o=0;while(i=t[o++])0>r.indexOf(" "+i+" ")&&(r+=i+" ");n.className=x.trim(r)}return this},removeClass:function(e){var t,n,r,i,o,a=0,s=this.length,l=0===arguments.length||"string"==typeof e&&e;if(x.isFunction(e))return this.each(function(t){x(this).removeClass(e.call(this,t,this.className))});if(l)for(t=(e||"").match(T)||[];s>a;a++)if(n=this[a],r=1===n.nodeType&&(n.className?(" "+n.className+" ").replace(U," "):"")){o=0;while(i=t[o++])while(r.indexOf(" "+i+" ")>=0)r=r.replace(" "+i+" "," ");n.className=e?x.trim(r):""}return this},toggleClass:function(e,t){var n=typeof e;return"boolean"==typeof t&&"string"===n?t?this.addClass(e):this.removeClass(e):x.isFunction(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,this.className,t),t)}):this.each(function(){if("string"===n){var t,r=0,o=x(this),a=e.match(T)||[];while(t=a[r++])o.hasClass(t)?o.removeClass(t):o.addClass(t)}else(n===i||"boolean"===n)&&(this.className&&x._data(this,"__className__",this.className),this.className=this.className||e===!1?"":x._data(this,"__className__")||"")})},hasClass:function(e){var t=" "+e+" ",n=0,r=this.length;for(;r>n;n++)if(1===this[n].nodeType&&(" "+this[n].className+" ").replace(U," ").indexOf(t)>=0)return!0;return!1},val:function(e){var n,r,i,o=this[0];{if(arguments.length)return i=x.isFunction(e),this.each(function(n){var o;1===this.nodeType&&(o=i?e.call(this,n,x(this).val()):e,null==o?o="":"number"==typeof o?o+="":x.isArray(o)&&(o=x.map(o,function(e){return null==e?"":e+""})),r=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()],r&&"set"in r&&r.set(this,o,"value")!==t||(this.value=o))});if(o)return r=x.valHooks[o.type]||x.valHooks[o.nodeName.toLowerCase()],r&&"get"in r&&(n=r.get(o,"value"))!==t?n:(n=o.value,"string"==typeof n?n.replace(V,""):null==n?"":n)}}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:e.text}},select:{get:function(e){var t,n,r=e.options,i=e.selectedIndex,o="select-one"===e.type||0>i,a=o?null:[],s=o?i+1:r.length,l=0>i?s:o?i:0;for(;s>l;l++)if(n=r[l],!(!n.selected&&l!==i||(x.support.optDisabled?n.disabled:null!==n.getAttribute("disabled"))||n.parentNode.disabled&&x.nodeName(n.parentNode,"optgroup"))){if(t=x(n).val(),o)return t;a.push(t)}return a},set:function(e,t){var n,r,i=e.options,o=x.makeArray(t),a=i.length;while(a--)r=i[a],(r.selected=x.inArray(x(r).val(),o)>=0)&&(n=!0);return n||(e.selectedIndex=-1),o}}},attr:function(e,n,r){var o,a,s=e.nodeType;if(e&&3!==s&&8!==s&&2!==s)return typeof e.getAttribute===i?x.prop(e,n,r):(1===s&&x.isXMLDoc(e)||(n=n.toLowerCase(),o=x.attrHooks[n]||(x.expr.match.bool.test(n)?X:z)),r===t?o&&"get"in o&&null!==(a=o.get(e,n))?a:(a=x.find.attr(e,n),null==a?t:a):null!==r?o&&"set"in o&&(a=o.set(e,r,n))!==t?a:(e.setAttribute(n,r+""),r):(x.removeAttr(e,n),t))},removeAttr:function(e,t){var n,r,i=0,o=t&&t.match(T);if(o&&1===e.nodeType)while(n=o[i++])r=x.propFix[n]||n,x.expr.match.bool.test(n)?K&&Q||!G.test(n)?e[r]=!1:e[x.camelCase("default-"+n)]=e[r]=!1:x.attr(e,n,""),e.removeAttribute(Q?n:r)},attrHooks:{type:{set:function(e,t){if(!x.support.radioValue&&"radio"===t&&x.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},propFix:{"for":"htmlFor","class":"className"},prop:function(e,n,r){var i,o,a,s=e.nodeType;if(e&&3!==s&&8!==s&&2!==s)return a=1!==s||!x.isXMLDoc(e),a&&(n=x.propFix[n]||n,o=x.propHooks[n]),r!==t?o&&"set"in o&&(i=o.set(e,r,n))!==t?i:e[n]=r:o&&"get"in o&&null!==(i=o.get(e,n))?i:e[n]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):Y.test(e.nodeName)||J.test(e.nodeName)&&e.href?0:-1}}}}),X={set:function(e,t,n){return t===!1?x.removeAttr(e,n):K&&Q||!G.test(n)?e.setAttribute(!Q&&x.propFix[n]||n,n):e[x.camelCase("default-"+n)]=e[n]=!0,n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,n){var r=x.expr.attrHandle[n]||x.find.attr;x.expr.attrHandle[n]=K&&Q||!G.test(n)?function(e,n,i){var o=x.expr.attrHandle[n],a=i?t:(x.expr.attrHandle[n]=t)!=r(e,n,i)?n.toLowerCase():null;return x.expr.attrHandle[n]=o,a}:function(e,n,r){return r?t:e[x.camelCase("default-"+n)]?n.toLowerCase():null}}),K&&Q||(x.attrHooks.value={set:function(e,n,r){return x.nodeName(e,"input")?(e.defaultValue=n,t):z&&z.set(e,n,r)}}),Q||(z={set:function(e,n,r){var i=e.getAttributeNode(r);return i||e.setAttributeNode(i=e.ownerDocument.createAttribute(r)),i.value=n+="","value"===r||n===e.getAttribute(r)?n:t}},x.expr.attrHandle.id=x.expr.attrHandle.name=x.expr.attrHandle.coords=function(e,n,r){var i;return r?t:(i=e.getAttributeNode(n))&&""!==i.value?i.value:null},x.valHooks.button={get:function(e,n){var r=e.getAttributeNode(n);return r&&r.specified?r.value:t},set:z.set},x.attrHooks.contenteditable={set:function(e,t,n){z.set(e,""===t?!1:t,n)}},x.each(["width","height"],function(e,n){x.attrHooks[n]={set:function(e,r){return""===r?(e.setAttribute(n,"auto"),r):t}}})),x.support.hrefNormalized||x.each(["href","src"],function(e,t){x.propHooks[t]={get:function(e){return e.getAttribute(t,4)}}}),x.support.style||(x.attrHooks.style={get:function(e){return e.style.cssText||t},set:function(e,t){return e.style.cssText=t+""}}),x.support.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex),null}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.support.enctype||(x.propFix.enctype="encoding"),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,n){return x.isArray(n)?e.checked=x.inArray(x(e).val(),n)>=0:t}},x.support.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})});var Z=/^(?:input|select|textarea)$/i,et=/^key/,tt=/^(?:mouse|contextmenu)|click/,nt=/^(?:focusinfocus|focusoutblur)$/,rt=/^([^.]*)(?:\.(.+)|)$/;function it(){return!0}function ot(){return!1}function at(){try{return a.activeElement}catch(e){}}x.event={global:{},add:function(e,n,r,o,a){var s,l,u,c,p,f,d,h,g,m,y,v=x._data(e);if(v){r.handler&&(c=r,r=c.handler,a=c.selector),r.guid||(r.guid=x.guid++),(l=v.events)||(l=v.events={}),(f=v.handle)||(f=v.handle=function(e){return typeof x===i||e&&x.event.triggered===e.type?t:x.event.dispatch.apply(f.elem,arguments)},f.elem=e),n=(n||"").match(T)||[""],u=n.length;while(u--)s=rt.exec(n[u])||[],g=y=s[1],m=(s[2]||"").split(".").sort(),g&&(p=x.event.special[g]||{},g=(a?p.delegateType:p.bindType)||g,p=x.event.special[g]||{},d=x.extend({type:g,origType:y,data:o,handler:r,guid:r.guid,selector:a,needsContext:a&&x.expr.match.needsContext.test(a),namespace:m.join(".")},c),(h=l[g])||(h=l[g]=[],h.delegateCount=0,p.setup&&p.setup.call(e,o,m,f)!==!1||(e.addEventListener?e.addEventListener(g,f,!1):e.attachEvent&&e.attachEvent("on"+g,f))),p.add&&(p.add.call(e,d),d.handler.guid||(d.handler.guid=r.guid)),a?h.splice(h.delegateCount++,0,d):h.push(d),x.event.global[g]=!0);e=null}},remove:function(e,t,n,r,i){var o,a,s,l,u,c,p,f,d,h,g,m=x.hasData(e)&&x._data(e);if(m&&(c=m.events)){t=(t||"").match(T)||[""],u=t.length;while(u--)if(s=rt.exec(t[u])||[],d=g=s[1],h=(s[2]||"").split(".").sort(),d){p=x.event.special[d]||{},d=(r?p.delegateType:p.bindType)||d,f=c[d]||[],s=s[2]&&RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),l=o=f.length;while(o--)a=f[o],!i&&g!==a.origType||n&&n.guid!==a.guid||s&&!s.test(a.namespace)||r&&r!==a.selector&&("**"!==r||!a.selector)||(f.splice(o,1),a.selector&&f.delegateCount--,p.remove&&p.remove.call(e,a));l&&!f.length&&(p.teardown&&p.teardown.call(e,h,m.handle)!==!1||x.removeEvent(e,d,m.handle),delete c[d])}else for(d in c)x.event.remove(e,d+t[u],n,r,!0);x.isEmptyObject(c)&&(delete m.handle,x._removeData(e,"events"))}},trigger:function(n,r,i,o){var s,l,u,c,p,f,d,h=[i||a],g=v.call(n,"type")?n.type:n,m=v.call(n,"namespace")?n.namespace.split("."):[];if(u=f=i=i||a,3!==i.nodeType&&8!==i.nodeType&&!nt.test(g+x.event.triggered)&&(g.indexOf(".")>=0&&(m=g.split("."),g=m.shift(),m.sort()),l=0>g.indexOf(":")&&"on"+g,n=n[x.expando]?n:new x.Event(g,"object"==typeof n&&n),n.isTrigger=o?2:3,n.namespace=m.join("."),n.namespace_re=n.namespace?RegExp("(^|\\.)"+m.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,n.result=t,n.target||(n.target=i),r=null==r?[n]:x.makeArray(r,[n]),p=x.event.special[g]||{},o||!p.trigger||p.trigger.apply(i,r)!==!1)){if(!o&&!p.noBubble&&!x.isWindow(i)){for(c=p.delegateType||g,nt.test(c+g)||(u=u.parentNode);u;u=u.parentNode)h.push(u),f=u;f===(i.ownerDocument||a)&&h.push(f.defaultView||f.parentWindow||e)}d=0;while((u=h[d++])&&!n.isPropagationStopped())n.type=d>1?c:p.bindType||g,s=(x._data(u,"events")||{})[n.type]&&x._data(u,"handle"),s&&s.apply(u,r),s=l&&u[l],s&&x.acceptData(u)&&s.apply&&s.apply(u,r)===!1&&n.preventDefault();if(n.type=g,!o&&!n.isDefaultPrevented()&&(!p._default||p._default.apply(h.pop(),r)===!1)&&x.acceptData(i)&&l&&i[g]&&!x.isWindow(i)){f=i[l],f&&(i[l]=null),x.event.triggered=g;try{i[g]()}catch(y){}x.event.triggered=t,f&&(i[l]=f)}return n.result}},dispatch:function(e){e=x.event.fix(e);var n,r,i,o,a,s=[],l=g.call(arguments),u=(x._data(this,"events")||{})[e.type]||[],c=x.event.special[e.type]||{};if(l[0]=e,e.delegateTarget=this,!c.preDispatch||c.preDispatch.call(this,e)!==!1){s=x.event.handlers.call(this,e,u),n=0;while((o=s[n++])&&!e.isPropagationStopped()){e.currentTarget=o.elem,a=0;while((i=o.handlers[a++])&&!e.isImmediatePropagationStopped())(!e.namespace_re||e.namespace_re.test(i.namespace))&&(e.handleObj=i,e.data=i.data,r=((x.event.special[i.origType]||{}).handle||i.handler).apply(o.elem,l),r!==t&&(e.result=r)===!1&&(e.preventDefault(),e.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,e),e.result}},handlers:function(e,n){var r,i,o,a,s=[],l=n.delegateCount,u=e.target;if(l&&u.nodeType&&(!e.button||"click"!==e.type))for(;u!=this;u=u.parentNode||this)if(1===u.nodeType&&(u.disabled!==!0||"click"!==e.type)){for(o=[],a=0;l>a;a++)i=n[a],r=i.selector+" ",o[r]===t&&(o[r]=i.needsContext?x(r,this).index(u)>=0:x.find(r,this,null,[u]).length),o[r]&&o.push(i);o.length&&s.push({elem:u,handlers:o})}return n.length>l&&s.push({elem:this,handlers:n.slice(l)}),s},fix:function(e){if(e[x.expando])return e;var t,n,r,i=e.type,o=e,s=this.fixHooks[i];s||(this.fixHooks[i]=s=tt.test(i)?this.mouseHooks:et.test(i)?this.keyHooks:{}),r=s.props?this.props.concat(s.props):this.props,e=new x.Event(o),t=r.length;while(t--)n=r[t],e[n]=o[n];return e.target||(e.target=o.srcElement||a),3===e.target.nodeType&&(e.target=e.target.parentNode),e.metaKey=!!e.metaKey,s.filter?s.filter(e,o):e},props:"altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(e,t){return null==e.which&&(e.which=null!=t.charCode?t.charCode:t.keyCode),e}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(e,n){var r,i,o,s=n.button,l=n.fromElement;return null==e.pageX&&null!=n.clientX&&(i=e.target.ownerDocument||a,o=i.documentElement,r=i.body,e.pageX=n.clientX+(o&&o.scrollLeft||r&&r.scrollLeft||0)-(o&&o.clientLeft||r&&r.clientLeft||0),e.pageY=n.clientY+(o&&o.scrollTop||r&&r.scrollTop||0)-(o&&o.clientTop||r&&r.clientTop||0)),!e.relatedTarget&&l&&(e.relatedTarget=l===e.target?n.toElement:l),e.which||s===t||(e.which=1&s?1:2&s?3:4&s?2:0),e}},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==at()&&this.focus)try{return this.focus(),!1}catch(e){}},delegateType:"focusin"},blur:{trigger:function(){return this===at()&&this.blur?(this.blur(),!1):t},delegateType:"focusout"},click:{trigger:function(){return x.nodeName(this,"input")&&"checkbox"===this.type&&this.click?(this.click(),!1):t},_default:function(e){return x.nodeName(e.target,"a")}},beforeunload:{postDispatch:function(e){e.result!==t&&(e.originalEvent.returnValue=e.result)}}},simulate:function(e,t,n,r){var i=x.extend(new x.Event,n,{type:e,isSimulated:!0,originalEvent:{}});r?x.event.trigger(i,null,t):x.event.dispatch.call(t,i),i.isDefaultPrevented()&&n.preventDefault()}},x.removeEvent=a.removeEventListener?function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n,!1)}:function(e,t,n){var r="on"+t;e.detachEvent&&(typeof e[r]===i&&(e[r]=null),e.detachEvent(r,n))},x.Event=function(e,n){return this instanceof x.Event?(e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||e.returnValue===!1||e.getPreventDefault&&e.getPreventDefault()?it:ot):this.type=e,n&&x.extend(this,n),this.timeStamp=e&&e.timeStamp||x.now(),this[x.expando]=!0,t):new x.Event(e,n)},x.Event.prototype={isDefaultPrevented:ot,isPropagationStopped:ot,isImmediatePropagationStopped:ot,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=it,e&&(e.preventDefault?e.preventDefault():e.returnValue=!1)},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=it,e&&(e.stopPropagation&&e.stopPropagation(),e.cancelBubble=!0)},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=it,this.stopPropagation()}},x.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(e,t){x.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,i=e.relatedTarget,o=e.handleObj;return(!i||i!==r&&!x.contains(r,i))&&(e.type=o.origType,n=o.handler.apply(this,arguments),e.type=t),n}}}),x.support.submitBubbles||(x.event.special.submit={setup:function(){return x.nodeName(this,"form")?!1:(x.event.add(this,"click._submit keypress._submit",function(e){var n=e.target,r=x.nodeName(n,"input")||x.nodeName(n,"button")?n.form:t;r&&!x._data(r,"submitBubbles")&&(x.event.add(r,"submit._submit",function(e){e._submit_bubble=!0}),x._data(r,"submitBubbles",!0))}),t)},postDispatch:function(e){e._submit_bubble&&(delete e._submit_bubble,this.parentNode&&!e.isTrigger&&x.event.simulate("submit",this.parentNode,e,!0))},teardown:function(){return x.nodeName(this,"form")?!1:(x.event.remove(this,"._submit"),t)}}),x.support.changeBubbles||(x.event.special.change={setup:function(){return Z.test(this.nodeName)?(("checkbox"===this.type||"radio"===this.type)&&(x.event.add(this,"propertychange._change",function(e){"checked"===e.originalEvent.propertyName&&(this._just_changed=!0)}),x.event.add(this,"click._change",function(e){this._just_changed&&!e.isTrigger&&(this._just_changed=!1),x.event.simulate("change",this,e,!0)})),!1):(x.event.add(this,"beforeactivate._change",function(e){var t=e.target;Z.test(t.nodeName)&&!x._data(t,"changeBubbles")&&(x.event.add(t,"change._change",function(e){!this.parentNode||e.isSimulated||e.isTrigger||x.event.simulate("change",this.parentNode,e,!0)}),x._data(t,"changeBubbles",!0))}),t)},handle:function(e){var n=e.target;return this!==n||e.isSimulated||e.isTrigger||"radio"!==n.type&&"checkbox"!==n.type?e.handleObj.handler.apply(this,arguments):t},teardown:function(){return x.event.remove(this,"._change"),!Z.test(this.nodeName)}}),x.support.focusinBubbles||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=0,r=function(e){x.event.simulate(t,e.target,x.event.fix(e),!0)};x.event.special[t]={setup:function(){0===n++&&a.addEventListener(e,r,!0)},teardown:function(){0===--n&&a.removeEventListener(e,r,!0)}}}),x.fn.extend({on:function(e,n,r,i,o){var a,s;if("object"==typeof e){"string"!=typeof n&&(r=r||n,n=t);for(a in e)this.on(a,n,r,e[a],o);return this}if(null==r&&null==i?(i=n,r=n=t):null==i&&("string"==typeof n?(i=r,r=t):(i=r,r=n,n=t)),i===!1)i=ot;else if(!i)return this;return 1===o&&(s=i,i=function(e){return x().off(e),s.apply(this,arguments)},i.guid=s.guid||(s.guid=x.guid++)),this.each(function(){x.event.add(this,e,i,r,n)})},one:function(e,t,n,r){return this.on(e,t,n,r,1)},off:function(e,n,r){var i,o;if(e&&e.preventDefault&&e.handleObj)return i=e.handleObj,x(e.delegateTarget).off(i.namespace?i.origType+"."+i.namespace:i.origType,i.selector,i.handler),this;if("object"==typeof e){for(o in e)this.off(o,n,e[o]);return this}return(n===!1||"function"==typeof n)&&(r=n,n=t),r===!1&&(r=ot),this.each(function(){x.event.remove(this,e,r,n)})},trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,n){var r=this[0];return r?x.event.trigger(e,n,r,!0):t}});var st=/^.[^:#\[\.,]*$/,lt=/^(?:parents|prev(?:Until|All))/,ut=x.expr.match.needsContext,ct={children:!0,contents:!0,next:!0,prev:!0};x.fn.extend({find:function(e){var t,n=[],r=this,i=r.length;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;i>t;t++)if(x.contains(r[t],this))return!0}));for(t=0;i>t;t++)x.find(e,r[t],n);return n=this.pushStack(i>1?x.unique(n):n),n.selector=this.selector?this.selector+" "+e:e,n},has:function(e){var t,n=x(e,this),r=n.length;return this.filter(function(){for(t=0;r>t;t++)if(x.contains(this,n[t]))return!0})},not:function(e){return this.pushStack(ft(this,e||[],!0))},filter:function(e){return this.pushStack(ft(this,e||[],!1))},is:function(e){return!!ft(this,"string"==typeof e&&ut.test(e)?x(e):e||[],!1).length},closest:function(e,t){var n,r=0,i=this.length,o=[],a=ut.test(e)||"string"!=typeof e?x(e,t||this.context):0;for(;i>r;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(11>n.nodeType&&(a?a.index(n)>-1:1===n.nodeType&&x.find.matchesSelector(n,e))){n=o.push(n);break}return this.pushStack(o.length>1?x.unique(o):o)},index:function(e){return e?"string"==typeof e?x.inArray(this[0],x(e)):x.inArray(e.jquery?e[0]:e,this):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){var n="string"==typeof e?x(e,t):x.makeArray(e&&e.nodeType?[e]:e),r=x.merge(this.get(),n);return this.pushStack(x.unique(r))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}});function pt(e,t){do e=e[t];while(e&&1!==e.nodeType);return e}x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return x.dir(e,"parentNode")},parentsUntil:function(e,t,n){return x.dir(e,"parentNode",n)},next:function(e){return pt(e,"nextSibling")},prev:function(e){return pt(e,"previousSibling")},nextAll:function(e){return x.dir(e,"nextSibling")},prevAll:function(e){return x.dir(e,"previousSibling")},nextUntil:function(e,t,n){return x.dir(e,"nextSibling",n)},prevUntil:function(e,t,n){return x.dir(e,"previousSibling",n)},siblings:function(e){return x.sibling((e.parentNode||{}).firstChild,e)},children:function(e){return x.sibling(e.firstChild)},contents:function(e){return x.nodeName(e,"iframe")?e.contentDocument||e.contentWindow.document:x.merge([],e.childNodes)}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(ct[e]||(i=x.unique(i)),lt.test(e)&&(i=i.reverse())),this.pushStack(i)}}),x.extend({filter:function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},dir:function(e,n,r){var i=[],o=e[n];while(o&&9!==o.nodeType&&(r===t||1!==o.nodeType||!x(o).is(r)))1===o.nodeType&&i.push(o),o=o[n];return i},sibling:function(e,t){var n=[];for(;e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n}});function ft(e,t,n){if(x.isFunction(t))return x.grep(e,function(e,r){return!!t.call(e,r,e)!==n});if(t.nodeType)return x.grep(e,function(e){return e===t!==n});if("string"==typeof t){if(st.test(t))return x.filter(t,e,n);t=x.filter(t,e)}return x.grep(e,function(e){return x.inArray(e,t)>=0!==n})}function dt(e){var t=ht.split("|"),n=e.createDocumentFragment();if(n.createElement)while(t.length)n.createElement(t.pop());return n}var ht="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",gt=/ jQuery\d+="(?:null|\d+)"/g,mt=RegExp("<(?:"+ht+")[\\s/>]","i"),yt=/^\s+/,vt=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,bt=/<([\w:]+)/,xt=/<tbody/i,wt=/<|&#?\w+;/,Tt=/<(?:script|style|link)/i,Ct=/^(?:checkbox|radio)$/i,Nt=/checked\s*(?:[^=]|=\s*.checked.)/i,kt=/^$|\/(?:java|ecma)script/i,Et=/^true\/(.*)/,St=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g,At={option:[1,"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],area:[1,"<map>","</map>"],param:[1,"<object>","</object>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:x.support.htmlSerialize?[0,"",""]:[1,"X<div>","</div>"]},jt=dt(a),Dt=jt.appendChild(a.createElement("div"));At.optgroup=At.option,At.tbody=At.tfoot=At.colgroup=At.caption=At.thead,At.th=At.td,x.fn.extend({text:function(e){return x.access(this,function(e){return e===t?x.text(this):this.empty().append((this[0]&&this[0].ownerDocument||a).createTextNode(e))},null,e,arguments.length)},append:function(){return this.domManip(arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=Lt(this,e);t.appendChild(e)}})},prepend:function(){return this.domManip(arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=Lt(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return this.domManip(arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return this.domManip(arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},remove:function(e,t){var n,r=e?x.filter(e,this):this,i=0;for(;null!=(n=r[i]);i++)t||1!==n.nodeType||x.cleanData(Ft(n)),n.parentNode&&(t&&x.contains(n.ownerDocument,n)&&_t(Ft(n,"script")),n.parentNode.removeChild(n));return this},empty:function(){var e,t=0;for(;null!=(e=this[t]);t++){1===e.nodeType&&x.cleanData(Ft(e,!1));while(e.firstChild)e.removeChild(e.firstChild);e.options&&x.nodeName(e,"select")&&(e.options.length=0)}return this},clone:function(e,t){return e=null==e?!1:e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return x.access(this,function(e){var n=this[0]||{},r=0,i=this.length;if(e===t)return 1===n.nodeType?n.innerHTML.replace(gt,""):t;if(!("string"!=typeof e||Tt.test(e)||!x.support.htmlSerialize&&mt.test(e)||!x.support.leadingWhitespace&&yt.test(e)||At[(bt.exec(e)||["",""])[1].toLowerCase()])){e=e.replace(vt,"<$1></$2>");try{for(;i>r;r++)n=this[r]||{},1===n.nodeType&&(x.cleanData(Ft(n,!1)),n.innerHTML=e);n=0}catch(o){}}n&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=x.map(this,function(e){return[e.nextSibling,e.parentNode]}),t=0;return this.domManip(arguments,function(n){var r=e[t++],i=e[t++];i&&(r&&r.parentNode!==i&&(r=this.nextSibling),x(this).remove(),i.insertBefore(n,r))},!0),t?this:this.remove()},detach:function(e){return this.remove(e,!0)},domManip:function(e,t,n){e=d.apply([],e);var r,i,o,a,s,l,u=0,c=this.length,p=this,f=c-1,h=e[0],g=x.isFunction(h);if(g||!(1>=c||"string"!=typeof h||x.support.checkClone)&&Nt.test(h))return this.each(function(r){var i=p.eq(r);g&&(e[0]=h.call(this,r,i.html())),i.domManip(e,t,n)});if(c&&(l=x.buildFragment(e,this[0].ownerDocument,!1,!n&&this),r=l.firstChild,1===l.childNodes.length&&(l=r),r)){for(a=x.map(Ft(l,"script"),Ht),o=a.length;c>u;u++)i=l,u!==f&&(i=x.clone(i,!0,!0),o&&x.merge(a,Ft(i,"script"))),t.call(this[u],i,u);if(o)for(s=a[a.length-1].ownerDocument,x.map(a,qt),u=0;o>u;u++)i=a[u],kt.test(i.type||"")&&!x._data(i,"globalEval")&&x.contains(s,i)&&(i.src?x._evalUrl(i.src):x.globalEval((i.text||i.textContent||i.innerHTML||"").replace(St,"")));l=r=null}return this}});function Lt(e,t){return x.nodeName(e,"table")&&x.nodeName(1===t.nodeType?t:t.firstChild,"tr")?e.getElementsByTagName("tbody")[0]||e.appendChild(e.ownerDocument.createElement("tbody")):e}function Ht(e){return e.type=(null!==x.find.attr(e,"type"))+"/"+e.type,e}function qt(e){var t=Et.exec(e.type);return t?e.type=t[1]:e.removeAttribute("type"),e}function _t(e,t){var n,r=0;for(;null!=(n=e[r]);r++)x._data(n,"globalEval",!t||x._data(t[r],"globalEval"))}function Mt(e,t){if(1===t.nodeType&&x.hasData(e)){var n,r,i,o=x._data(e),a=x._data(t,o),s=o.events;if(s){delete a.handle,a.events={};for(n in s)for(r=0,i=s[n].length;i>r;r++)x.event.add(t,n,s[n][r])}a.data&&(a.data=x.extend({},a.data))}}function Ot(e,t){var n,r,i;if(1===t.nodeType){if(n=t.nodeName.toLowerCase(),!x.support.noCloneEvent&&t[x.expando]){i=x._data(t);for(r in i.events)x.removeEvent(t,r,i.handle);t.removeAttribute(x.expando)}"script"===n&&t.text!==e.text?(Ht(t).text=e.text,qt(t)):"object"===n?(t.parentNode&&(t.outerHTML=e.outerHTML),x.support.html5Clone&&e.innerHTML&&!x.trim(t.innerHTML)&&(t.innerHTML=e.innerHTML)):"input"===n&&Ct.test(e.type)?(t.defaultChecked=t.checked=e.checked,t.value!==e.value&&(t.value=e.value)):"option"===n?t.defaultSelected=t.selected=e.defaultSelected:("input"===n||"textarea"===n)&&(t.defaultValue=e.defaultValue)}}x.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){x.fn[e]=function(e){var n,r=0,i=[],o=x(e),a=o.length-1;for(;a>=r;r++)n=r===a?this:this.clone(!0),x(o[r])[t](n),h.apply(i,n.get());return this.pushStack(i)}});function Ft(e,n){var r,o,a=0,s=typeof e.getElementsByTagName!==i?e.getElementsByTagName(n||"*"):typeof e.querySelectorAll!==i?e.querySelectorAll(n||"*"):t;if(!s)for(s=[],r=e.childNodes||e;null!=(o=r[a]);a++)!n||x.nodeName(o,n)?s.push(o):x.merge(s,Ft(o,n));return n===t||n&&x.nodeName(e,n)?x.merge([e],s):s}function Bt(e){Ct.test(e.type)&&(e.defaultChecked=e.checked)}x.extend({clone:function(e,t,n){var r,i,o,a,s,l=x.contains(e.ownerDocument,e);if(x.support.html5Clone||x.isXMLDoc(e)||!mt.test("<"+e.nodeName+">")?o=e.cloneNode(!0):(Dt.innerHTML=e.outerHTML,Dt.removeChild(o=Dt.firstChild)),!(x.support.noCloneEvent&&x.support.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(r=Ft(o),s=Ft(e),a=0;null!=(i=s[a]);++a)r[a]&&Ot(i,r[a]);if(t)if(n)for(s=s||Ft(e),r=r||Ft(o),a=0;null!=(i=s[a]);a++)Mt(i,r[a]);else Mt(e,o);return r=Ft(o,"script"),r.length>0&&_t(r,!l&&Ft(e,"script")),r=s=i=null,o},buildFragment:function(e,t,n,r){var i,o,a,s,l,u,c,p=e.length,f=dt(t),d=[],h=0;for(;p>h;h++)if(o=e[h],o||0===o)if("object"===x.type(o))x.merge(d,o.nodeType?[o]:o);else if(wt.test(o)){s=s||f.appendChild(t.createElement("div")),l=(bt.exec(o)||["",""])[1].toLowerCase(),c=At[l]||At._default,s.innerHTML=c[1]+o.replace(vt,"<$1></$2>")+c[2],i=c[0];while(i--)s=s.lastChild;if(!x.support.leadingWhitespace&&yt.test(o)&&d.push(t.createTextNode(yt.exec(o)[0])),!x.support.tbody){o="table"!==l||xt.test(o)?"<table>"!==c[1]||xt.test(o)?0:s:s.firstChild,i=o&&o.childNodes.length;while(i--)x.nodeName(u=o.childNodes[i],"tbody")&&!u.childNodes.length&&o.removeChild(u)}x.merge(d,s.childNodes),s.textContent="";while(s.firstChild)s.removeChild(s.firstChild);s=f.lastChild}else d.push(t.createTextNode(o));s&&f.removeChild(s),x.support.appendChecked||x.grep(Ft(d,"input"),Bt),h=0;while(o=d[h++])if((!r||-1===x.inArray(o,r))&&(a=x.contains(o.ownerDocument,o),s=Ft(f.appendChild(o),"script"),a&&_t(s),n)){i=0;while(o=s[i++])kt.test(o.type||"")&&n.push(o)}return s=null,f},cleanData:function(e,t){var n,r,o,a,s=0,l=x.expando,u=x.cache,c=x.support.deleteExpando,f=x.event.special;for(;null!=(n=e[s]);s++)if((t||x.acceptData(n))&&(o=n[l],a=o&&u[o])){if(a.events)for(r in a.events)f[r]?x.event.remove(n,r):x.removeEvent(n,r,a.handle);
-u[o]&&(delete u[o],c?delete n[l]:typeof n.removeAttribute!==i?n.removeAttribute(l):n[l]=null,p.push(o))}},_evalUrl:function(e){return x.ajax({url:e,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0})}}),x.fn.extend({wrapAll:function(e){if(x.isFunction(e))return this.each(function(t){x(this).wrapAll(e.call(this,t))});if(this[0]){var t=x(e,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstChild&&1===e.firstChild.nodeType)e=e.firstChild;return e}).append(this)}return this},wrapInner:function(e){return x.isFunction(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=x.isFunction(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(){return this.parent().each(function(){x.nodeName(this,"body")||x(this).replaceWith(this.childNodes)}).end()}});var Pt,Rt,Wt,$t=/alpha\([^)]*\)/i,It=/opacity\s*=\s*([^)]*)/,zt=/^(top|right|bottom|left)$/,Xt=/^(none|table(?!-c[ea]).+)/,Ut=/^margin/,Vt=RegExp("^("+w+")(.*)$","i"),Yt=RegExp("^("+w+")(?!px)[a-z%]+$","i"),Jt=RegExp("^([+-])=("+w+")","i"),Gt={BODY:"block"},Qt={position:"absolute",visibility:"hidden",display:"block"},Kt={letterSpacing:0,fontWeight:400},Zt=["Top","Right","Bottom","Left"],en=["Webkit","O","Moz","ms"];function tn(e,t){if(t in e)return t;var n=t.charAt(0).toUpperCase()+t.slice(1),r=t,i=en.length;while(i--)if(t=en[i]+n,t in e)return t;return r}function nn(e,t){return e=t||e,"none"===x.css(e,"display")||!x.contains(e.ownerDocument,e)}function rn(e,t){var n,r,i,o=[],a=0,s=e.length;for(;s>a;a++)r=e[a],r.style&&(o[a]=x._data(r,"olddisplay"),n=r.style.display,t?(o[a]||"none"!==n||(r.style.display=""),""===r.style.display&&nn(r)&&(o[a]=x._data(r,"olddisplay",ln(r.nodeName)))):o[a]||(i=nn(r),(n&&"none"!==n||!i)&&x._data(r,"olddisplay",i?n:x.css(r,"display"))));for(a=0;s>a;a++)r=e[a],r.style&&(t&&"none"!==r.style.display&&""!==r.style.display||(r.style.display=t?o[a]||"":"none"));return e}x.fn.extend({css:function(e,n){return x.access(this,function(e,n,r){var i,o,a={},s=0;if(x.isArray(n)){for(o=Rt(e),i=n.length;i>s;s++)a[n[s]]=x.css(e,n[s],!1,o);return a}return r!==t?x.style(e,n,r):x.css(e,n)},e,n,arguments.length>1)},show:function(){return rn(this,!0)},hide:function(){return rn(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){nn(this)?x(this).show():x(this).hide()})}}),x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Wt(e,"opacity");return""===n?"1":n}}}},cssNumber:{columnCount:!0,fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":x.support.cssFloat?"cssFloat":"styleFloat"},style:function(e,n,r,i){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var o,a,s,l=x.camelCase(n),u=e.style;if(n=x.cssProps[l]||(x.cssProps[l]=tn(u,l)),s=x.cssHooks[n]||x.cssHooks[l],r===t)return s&&"get"in s&&(o=s.get(e,!1,i))!==t?o:u[n];if(a=typeof r,"string"===a&&(o=Jt.exec(r))&&(r=(o[1]+1)*o[2]+parseFloat(x.css(e,n)),a="number"),!(null==r||"number"===a&&isNaN(r)||("number"!==a||x.cssNumber[l]||(r+="px"),x.support.clearCloneStyle||""!==r||0!==n.indexOf("background")||(u[n]="inherit"),s&&"set"in s&&(r=s.set(e,r,i))===t)))try{u[n]=r}catch(c){}}},css:function(e,n,r,i){var o,a,s,l=x.camelCase(n);return n=x.cssProps[l]||(x.cssProps[l]=tn(e.style,l)),s=x.cssHooks[n]||x.cssHooks[l],s&&"get"in s&&(a=s.get(e,!0,r)),a===t&&(a=Wt(e,n,i)),"normal"===a&&n in Kt&&(a=Kt[n]),""===r||r?(o=parseFloat(a),r===!0||x.isNumeric(o)?o||0:a):a}}),e.getComputedStyle?(Rt=function(t){return e.getComputedStyle(t,null)},Wt=function(e,n,r){var i,o,a,s=r||Rt(e),l=s?s.getPropertyValue(n)||s[n]:t,u=e.style;return s&&(""!==l||x.contains(e.ownerDocument,e)||(l=x.style(e,n)),Yt.test(l)&&Ut.test(n)&&(i=u.width,o=u.minWidth,a=u.maxWidth,u.minWidth=u.maxWidth=u.width=l,l=s.width,u.width=i,u.minWidth=o,u.maxWidth=a)),l}):a.documentElement.currentStyle&&(Rt=function(e){return e.currentStyle},Wt=function(e,n,r){var i,o,a,s=r||Rt(e),l=s?s[n]:t,u=e.style;return null==l&&u&&u[n]&&(l=u[n]),Yt.test(l)&&!zt.test(n)&&(i=u.left,o=e.runtimeStyle,a=o&&o.left,a&&(o.left=e.currentStyle.left),u.left="fontSize"===n?"1em":l,l=u.pixelLeft+"px",u.left=i,a&&(o.left=a)),""===l?"auto":l});function on(e,t,n){var r=Vt.exec(t);return r?Math.max(0,r[1]-(n||0))+(r[2]||"px"):t}function an(e,t,n,r,i){var o=n===(r?"border":"content")?4:"width"===t?1:0,a=0;for(;4>o;o+=2)"margin"===n&&(a+=x.css(e,n+Zt[o],!0,i)),r?("content"===n&&(a-=x.css(e,"padding"+Zt[o],!0,i)),"margin"!==n&&(a-=x.css(e,"border"+Zt[o]+"Width",!0,i))):(a+=x.css(e,"padding"+Zt[o],!0,i),"padding"!==n&&(a+=x.css(e,"border"+Zt[o]+"Width",!0,i)));return a}function sn(e,t,n){var r=!0,i="width"===t?e.offsetWidth:e.offsetHeight,o=Rt(e),a=x.support.boxSizing&&"border-box"===x.css(e,"boxSizing",!1,o);if(0>=i||null==i){if(i=Wt(e,t,o),(0>i||null==i)&&(i=e.style[t]),Yt.test(i))return i;r=a&&(x.support.boxSizingReliable||i===e.style[t]),i=parseFloat(i)||0}return i+an(e,t,n||(a?"border":"content"),r,o)+"px"}function ln(e){var t=a,n=Gt[e];return n||(n=un(e,t),"none"!==n&&n||(Pt=(Pt||x("<iframe frameborder='0' width='0' height='0'/>").css("cssText","display:block !important")).appendTo(t.documentElement),t=(Pt[0].contentWindow||Pt[0].contentDocument).document,t.write("<!doctype html><html><body>"),t.close(),n=un(e,t),Pt.detach()),Gt[e]=n),n}function un(e,t){var n=x(t.createElement(e)).appendTo(t.body),r=x.css(n[0],"display");return n.remove(),r}x.each(["height","width"],function(e,n){x.cssHooks[n]={get:function(e,r,i){return r?0===e.offsetWidth&&Xt.test(x.css(e,"display"))?x.swap(e,Qt,function(){return sn(e,n,i)}):sn(e,n,i):t},set:function(e,t,r){var i=r&&Rt(e);return on(e,t,r?an(e,n,r,x.support.boxSizing&&"border-box"===x.css(e,"boxSizing",!1,i),i):0)}}}),x.support.opacity||(x.cssHooks.opacity={get:function(e,t){return It.test((t&&e.currentStyle?e.currentStyle.filter:e.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":t?"1":""},set:function(e,t){var n=e.style,r=e.currentStyle,i=x.isNumeric(t)?"alpha(opacity="+100*t+")":"",o=r&&r.filter||n.filter||"";n.zoom=1,(t>=1||""===t)&&""===x.trim(o.replace($t,""))&&n.removeAttribute&&(n.removeAttribute("filter"),""===t||r&&!r.filter)||(n.filter=$t.test(o)?o.replace($t,i):o+" "+i)}}),x(function(){x.support.reliableMarginRight||(x.cssHooks.marginRight={get:function(e,n){return n?x.swap(e,{display:"inline-block"},Wt,[e,"marginRight"]):t}}),!x.support.pixelPosition&&x.fn.position&&x.each(["top","left"],function(e,n){x.cssHooks[n]={get:function(e,r){return r?(r=Wt(e,n),Yt.test(r)?x(e).position()[n]+"px":r):t}}})}),x.expr&&x.expr.filters&&(x.expr.filters.hidden=function(e){return 0>=e.offsetWidth&&0>=e.offsetHeight||!x.support.reliableHiddenOffsets&&"none"===(e.style&&e.style.display||x.css(e,"display"))},x.expr.filters.visible=function(e){return!x.expr.filters.hidden(e)}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){var r=0,i={},o="string"==typeof n?n.split(" "):[n];for(;4>r;r++)i[e+Zt[r]+t]=o[r]||o[r-2]||o[0];return i}},Ut.test(e)||(x.cssHooks[e+t].set=on)});var cn=/%20/g,pn=/\[\]$/,fn=/\r?\n/g,dn=/^(?:submit|button|image|reset|file)$/i,hn=/^(?:input|select|textarea|keygen)/i;x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&hn.test(this.nodeName)&&!dn.test(e)&&(this.checked||!Ct.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:x.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(fn,"\r\n")}}):{name:t.name,value:n.replace(fn,"\r\n")}}).get()}}),x.param=function(e,n){var r,i=[],o=function(e,t){t=x.isFunction(t)?t():null==t?"":t,i[i.length]=encodeURIComponent(e)+"="+encodeURIComponent(t)};if(n===t&&(n=x.ajaxSettings&&x.ajaxSettings.traditional),x.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){o(this.name,this.value)});else for(r in e)gn(r,e[r],n,o);return i.join("&").replace(cn,"+")};function gn(e,t,n,r){var i;if(x.isArray(t))x.each(t,function(t,i){n||pn.test(e)?r(e,i):gn(e+"["+("object"==typeof i?t:"")+"]",i,n,r)});else if(n||"object"!==x.type(t))r(e,t);else for(i in t)gn(e+"["+i+"]",t[i],n,r)}x.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)},bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}});var mn,yn,vn=x.now(),bn=/\?/,xn=/#.*$/,wn=/([?&])_=[^&]*/,Tn=/^(.*?):[ \t]*([^\r\n]*)\r?$/gm,Cn=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Nn=/^(?:GET|HEAD)$/,kn=/^\/\//,En=/^([\w.+-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/,Sn=x.fn.load,An={},jn={},Dn="*/".concat("*");try{yn=o.href}catch(Ln){yn=a.createElement("a"),yn.href="",yn=yn.href}mn=En.exec(yn.toLowerCase())||[];function Hn(e){return function(t,n){"string"!=typeof t&&(n=t,t="*");var r,i=0,o=t.toLowerCase().match(T)||[];if(x.isFunction(n))while(r=o[i++])"+"===r[0]?(r=r.slice(1)||"*",(e[r]=e[r]||[]).unshift(n)):(e[r]=e[r]||[]).push(n)}}function qn(e,n,r,i){var o={},a=e===jn;function s(l){var u;return o[l]=!0,x.each(e[l]||[],function(e,l){var c=l(n,r,i);return"string"!=typeof c||a||o[c]?a?!(u=c):t:(n.dataTypes.unshift(c),s(c),!1)}),u}return s(n.dataTypes[0])||!o["*"]&&s("*")}function _n(e,n){var r,i,o=x.ajaxSettings.flatOptions||{};for(i in n)n[i]!==t&&((o[i]?e:r||(r={}))[i]=n[i]);return r&&x.extend(!0,e,r),e}x.fn.load=function(e,n,r){if("string"!=typeof e&&Sn)return Sn.apply(this,arguments);var i,o,a,s=this,l=e.indexOf(" ");return l>=0&&(i=e.slice(l,e.length),e=e.slice(0,l)),x.isFunction(n)?(r=n,n=t):n&&"object"==typeof n&&(a="POST"),s.length>0&&x.ajax({url:e,type:a,dataType:"html",data:n}).done(function(e){o=arguments,s.html(i?x("<div>").append(x.parseHTML(e)).find(i):e)}).complete(r&&function(e,t){s.each(r,o||[e.responseText,t,e])}),this},x.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){x.fn[t]=function(e){return this.on(t,e)}}),x.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:yn,type:"GET",isLocal:Cn.test(mn[1]),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Dn,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":x.parseJSON,"text xml":x.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?_n(_n(e,x.ajaxSettings),t):_n(x.ajaxSettings,e)},ajaxPrefilter:Hn(An),ajaxTransport:Hn(jn),ajax:function(e,n){"object"==typeof e&&(n=e,e=t),n=n||{};var r,i,o,a,s,l,u,c,p=x.ajaxSetup({},n),f=p.context||p,d=p.context&&(f.nodeType||f.jquery)?x(f):x.event,h=x.Deferred(),g=x.Callbacks("once memory"),m=p.statusCode||{},y={},v={},b=0,w="canceled",C={readyState:0,getResponseHeader:function(e){var t;if(2===b){if(!c){c={};while(t=Tn.exec(a))c[t[1].toLowerCase()]=t[2]}t=c[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return 2===b?a:null},setRequestHeader:function(e,t){var n=e.toLowerCase();return b||(e=v[n]=v[n]||e,y[e]=t),this},overrideMimeType:function(e){return b||(p.mimeType=e),this},statusCode:function(e){var t;if(e)if(2>b)for(t in e)m[t]=[m[t],e[t]];else C.always(e[C.status]);return this},abort:function(e){var t=e||w;return u&&u.abort(t),k(0,t),this}};if(h.promise(C).complete=g.add,C.success=C.done,C.error=C.fail,p.url=((e||p.url||yn)+"").replace(xn,"").replace(kn,mn[1]+"//"),p.type=n.method||n.type||p.method||p.type,p.dataTypes=x.trim(p.dataType||"*").toLowerCase().match(T)||[""],null==p.crossDomain&&(r=En.exec(p.url.toLowerCase()),p.crossDomain=!(!r||r[1]===mn[1]&&r[2]===mn[2]&&(r[3]||("http:"===r[1]?"80":"443"))===(mn[3]||("http:"===mn[1]?"80":"443")))),p.data&&p.processData&&"string"!=typeof p.data&&(p.data=x.param(p.data,p.traditional)),qn(An,p,n,C),2===b)return C;l=p.global,l&&0===x.active++&&x.event.trigger("ajaxStart"),p.type=p.type.toUpperCase(),p.hasContent=!Nn.test(p.type),o=p.url,p.hasContent||(p.data&&(o=p.url+=(bn.test(o)?"&":"?")+p.data,delete p.data),p.cache===!1&&(p.url=wn.test(o)?o.replace(wn,"$1_="+vn++):o+(bn.test(o)?"&":"?")+"_="+vn++)),p.ifModified&&(x.lastModified[o]&&C.setRequestHeader("If-Modified-Since",x.lastModified[o]),x.etag[o]&&C.setRequestHeader("If-None-Match",x.etag[o])),(p.data&&p.hasContent&&p.contentType!==!1||n.contentType)&&C.setRequestHeader("Content-Type",p.contentType),C.setRequestHeader("Accept",p.dataTypes[0]&&p.accepts[p.dataTypes[0]]?p.accepts[p.dataTypes[0]]+("*"!==p.dataTypes[0]?", "+Dn+"; q=0.01":""):p.accepts["*"]);for(i in p.headers)C.setRequestHeader(i,p.headers[i]);if(p.beforeSend&&(p.beforeSend.call(f,C,p)===!1||2===b))return C.abort();w="abort";for(i in{success:1,error:1,complete:1})C[i](p[i]);if(u=qn(jn,p,n,C)){C.readyState=1,l&&d.trigger("ajaxSend",[C,p]),p.async&&p.timeout>0&&(s=setTimeout(function(){C.abort("timeout")},p.timeout));try{b=1,u.send(y,k)}catch(N){if(!(2>b))throw N;k(-1,N)}}else k(-1,"No Transport");function k(e,n,r,i){var c,y,v,w,T,N=n;2!==b&&(b=2,s&&clearTimeout(s),u=t,a=i||"",C.readyState=e>0?4:0,c=e>=200&&300>e||304===e,r&&(w=Mn(p,C,r)),w=On(p,w,C,c),c?(p.ifModified&&(T=C.getResponseHeader("Last-Modified"),T&&(x.lastModified[o]=T),T=C.getResponseHeader("etag"),T&&(x.etag[o]=T)),204===e||"HEAD"===p.type?N="nocontent":304===e?N="notmodified":(N=w.state,y=w.data,v=w.error,c=!v)):(v=N,(e||!N)&&(N="error",0>e&&(e=0))),C.status=e,C.statusText=(n||N)+"",c?h.resolveWith(f,[y,N,C]):h.rejectWith(f,[C,N,v]),C.statusCode(m),m=t,l&&d.trigger(c?"ajaxSuccess":"ajaxError",[C,p,c?y:v]),g.fireWith(f,[C,N]),l&&(d.trigger("ajaxComplete",[C,p]),--x.active||x.event.trigger("ajaxStop")))}return C},getJSON:function(e,t,n){return x.get(e,t,n,"json")},getScript:function(e,n){return x.get(e,t,n,"script")}}),x.each(["get","post"],function(e,n){x[n]=function(e,r,i,o){return x.isFunction(r)&&(o=o||i,i=r,r=t),x.ajax({url:e,type:n,dataType:o,data:r,success:i})}});function Mn(e,n,r){var i,o,a,s,l=e.contents,u=e.dataTypes;while("*"===u[0])u.shift(),o===t&&(o=e.mimeType||n.getResponseHeader("Content-Type"));if(o)for(s in l)if(l[s]&&l[s].test(o)){u.unshift(s);break}if(u[0]in r)a=u[0];else{for(s in r){if(!u[0]||e.converters[s+" "+u[0]]){a=s;break}i||(i=s)}a=a||i}return a?(a!==u[0]&&u.unshift(a),r[a]):t}function On(e,t,n,r){var i,o,a,s,l,u={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)u[a.toLowerCase()]=e.converters[a];o=c.shift();while(o)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!l&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),l=o,o=c.shift())if("*"===o)o=l;else if("*"!==l&&l!==o){if(a=u[l+" "+o]||u["* "+o],!a)for(i in u)if(s=i.split(" "),s[1]===o&&(a=u[l+" "+s[0]]||u["* "+s[0]])){a===!0?a=u[i]:u[i]!==!0&&(o=s[0],c.unshift(s[1]));break}if(a!==!0)if(a&&e["throws"])t=a(t);else try{t=a(t)}catch(p){return{state:"parsererror",error:a?p:"No conversion from "+l+" to "+o}}}return{state:"success",data:t}}x.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/(?:java|ecma)script/},converters:{"text script":function(e){return x.globalEval(e),e}}}),x.ajaxPrefilter("script",function(e){e.cache===t&&(e.cache=!1),e.crossDomain&&(e.type="GET",e.global=!1)}),x.ajaxTransport("script",function(e){if(e.crossDomain){var n,r=a.head||x("head")[0]||a.documentElement;return{send:function(t,i){n=a.createElement("script"),n.async=!0,e.scriptCharset&&(n.charset=e.scriptCharset),n.src=e.url,n.onload=n.onreadystatechange=function(e,t){(t||!n.readyState||/loaded|complete/.test(n.readyState))&&(n.onload=n.onreadystatechange=null,n.parentNode&&n.parentNode.removeChild(n),n=null,t||i(200,"success"))},r.insertBefore(n,r.firstChild)},abort:function(){n&&n.onload(t,!0)}}}});var Fn=[],Bn=/(=)\?(?=&|$)|\?\?/;x.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Fn.pop()||x.expando+"_"+vn++;return this[e]=!0,e}}),x.ajaxPrefilter("json jsonp",function(n,r,i){var o,a,s,l=n.jsonp!==!1&&(Bn.test(n.url)?"url":"string"==typeof n.data&&!(n.contentType||"").indexOf("application/x-www-form-urlencoded")&&Bn.test(n.data)&&"data");return l||"jsonp"===n.dataTypes[0]?(o=n.jsonpCallback=x.isFunction(n.jsonpCallback)?n.jsonpCallback():n.jsonpCallback,l?n[l]=n[l].replace(Bn,"$1"+o):n.jsonp!==!1&&(n.url+=(bn.test(n.url)?"&":"?")+n.jsonp+"="+o),n.converters["script json"]=function(){return s||x.error(o+" was not called"),s[0]},n.dataTypes[0]="json",a=e[o],e[o]=function(){s=arguments},i.always(function(){e[o]=a,n[o]&&(n.jsonpCallback=r.jsonpCallback,Fn.push(o)),s&&x.isFunction(a)&&a(s[0]),s=a=t}),"script"):t});var Pn,Rn,Wn=0,$n=e.ActiveXObject&&function(){var e;for(e in Pn)Pn[e](t,!0)};function In(){try{return new e.XMLHttpRequest}catch(t){}}function zn(){try{return new e.ActiveXObject("Microsoft.XMLHTTP")}catch(t){}}x.ajaxSettings.xhr=e.ActiveXObject?function(){return!this.isLocal&&In()||zn()}:In,Rn=x.ajaxSettings.xhr(),x.support.cors=!!Rn&&"withCredentials"in Rn,Rn=x.support.ajax=!!Rn,Rn&&x.ajaxTransport(function(n){if(!n.crossDomain||x.support.cors){var r;return{send:function(i,o){var a,s,l=n.xhr();if(n.username?l.open(n.type,n.url,n.async,n.username,n.password):l.open(n.type,n.url,n.async),n.xhrFields)for(s in n.xhrFields)l[s]=n.xhrFields[s];n.mimeType&&l.overrideMimeType&&l.overrideMimeType(n.mimeType),n.crossDomain||i["X-Requested-With"]||(i["X-Requested-With"]="XMLHttpRequest");try{for(s in i)l.setRequestHeader(s,i[s])}catch(u){}l.send(n.hasContent&&n.data||null),r=function(e,i){var s,u,c,p;try{if(r&&(i||4===l.readyState))if(r=t,a&&(l.onreadystatechange=x.noop,$n&&delete Pn[a]),i)4!==l.readyState&&l.abort();else{p={},s=l.status,u=l.getAllResponseHeaders(),"string"==typeof l.responseText&&(p.text=l.responseText);try{c=l.statusText}catch(f){c=""}s||!n.isLocal||n.crossDomain?1223===s&&(s=204):s=p.text?200:404}}catch(d){i||o(-1,d)}p&&o(s,c,p,u)},n.async?4===l.readyState?setTimeout(r):(a=++Wn,$n&&(Pn||(Pn={},x(e).unload($n)),Pn[a]=r),l.onreadystatechange=r):r()},abort:function(){r&&r(t,!0)}}}});var Xn,Un,Vn=/^(?:toggle|show|hide)$/,Yn=RegExp("^(?:([+-])=|)("+w+")([a-z%]*)$","i"),Jn=/queueHooks$/,Gn=[nr],Qn={"*":[function(e,t){var n=this.createTween(e,t),r=n.cur(),i=Yn.exec(t),o=i&&i[3]||(x.cssNumber[e]?"":"px"),a=(x.cssNumber[e]||"px"!==o&&+r)&&Yn.exec(x.css(n.elem,e)),s=1,l=20;if(a&&a[3]!==o){o=o||a[3],i=i||[],a=+r||1;do s=s||".5",a/=s,x.style(n.elem,e,a+o);while(s!==(s=n.cur()/r)&&1!==s&&--l)}return i&&(a=n.start=+a||+r||0,n.unit=o,n.end=i[1]?a+(i[1]+1)*i[2]:+i[2]),n}]};function Kn(){return setTimeout(function(){Xn=t}),Xn=x.now()}function Zn(e,t,n){var r,i=(Qn[t]||[]).concat(Qn["*"]),o=0,a=i.length;for(;a>o;o++)if(r=i[o].call(n,t,e))return r}function er(e,t,n){var r,i,o=0,a=Gn.length,s=x.Deferred().always(function(){delete l.elem}),l=function(){if(i)return!1;var t=Xn||Kn(),n=Math.max(0,u.startTime+u.duration-t),r=n/u.duration||0,o=1-r,a=0,l=u.tweens.length;for(;l>a;a++)u.tweens[a].run(o);return s.notifyWith(e,[u,o,n]),1>o&&l?n:(s.resolveWith(e,[u]),!1)},u=s.promise({elem:e,props:x.extend({},t),opts:x.extend(!0,{specialEasing:{}},n),originalProperties:t,originalOptions:n,startTime:Xn||Kn(),duration:n.duration,tweens:[],createTween:function(t,n){var r=x.Tween(e,u.opts,t,n,u.opts.specialEasing[t]||u.opts.easing);return u.tweens.push(r),r},stop:function(t){var n=0,r=t?u.tweens.length:0;if(i)return this;for(i=!0;r>n;n++)u.tweens[n].run(1);return t?s.resolveWith(e,[u,t]):s.rejectWith(e,[u,t]),this}}),c=u.props;for(tr(c,u.opts.specialEasing);a>o;o++)if(r=Gn[o].call(u,e,c,u.opts))return r;return x.map(c,Zn,u),x.isFunction(u.opts.start)&&u.opts.start.call(e,u),x.fx.timer(x.extend(l,{elem:e,anim:u,queue:u.opts.queue})),u.progress(u.opts.progress).done(u.opts.done,u.opts.complete).fail(u.opts.fail).always(u.opts.always)}function tr(e,t){var n,r,i,o,a;for(n in e)if(r=x.camelCase(n),i=t[r],o=e[n],x.isArray(o)&&(i=o[1],o=e[n]=o[0]),n!==r&&(e[r]=o,delete e[n]),a=x.cssHooks[r],a&&"expand"in a){o=a.expand(o),delete e[r];for(n in o)n in e||(e[n]=o[n],t[n]=i)}else t[r]=i}x.Animation=x.extend(er,{tweener:function(e,t){x.isFunction(e)?(t=e,e=["*"]):e=e.split(" ");var n,r=0,i=e.length;for(;i>r;r++)n=e[r],Qn[n]=Qn[n]||[],Qn[n].unshift(t)},prefilter:function(e,t){t?Gn.unshift(e):Gn.push(e)}});function nr(e,t,n){var r,i,o,a,s,l,u=this,c={},p=e.style,f=e.nodeType&&nn(e),d=x._data(e,"fxshow");n.queue||(s=x._queueHooks(e,"fx"),null==s.unqueued&&(s.unqueued=0,l=s.empty.fire,s.empty.fire=function(){s.unqueued||l()}),s.unqueued++,u.always(function(){u.always(function(){s.unqueued--,x.queue(e,"fx").length||s.empty.fire()})})),1===e.nodeType&&("height"in t||"width"in t)&&(n.overflow=[p.overflow,p.overflowX,p.overflowY],"inline"===x.css(e,"display")&&"none"===x.css(e,"float")&&(x.support.inlineBlockNeedsLayout&&"inline"!==ln(e.nodeName)?p.zoom=1:p.display="inline-block")),n.overflow&&(p.overflow="hidden",x.support.shrinkWrapBlocks||u.always(function(){p.overflow=n.overflow[0],p.overflowX=n.overflow[1],p.overflowY=n.overflow[2]}));for(r in t)if(i=t[r],Vn.exec(i)){if(delete t[r],o=o||"toggle"===i,i===(f?"hide":"show"))continue;c[r]=d&&d[r]||x.style(e,r)}if(!x.isEmptyObject(c)){d?"hidden"in d&&(f=d.hidden):d=x._data(e,"fxshow",{}),o&&(d.hidden=!f),f?x(e).show():u.done(function(){x(e).hide()}),u.done(function(){var t;x._removeData(e,"fxshow");for(t in c)x.style(e,t,c[t])});for(r in c)a=Zn(f?d[r]:0,r,u),r in d||(d[r]=a.start,f&&(a.end=a.start,a.start="width"===r||"height"===r?1:0))}}function rr(e,t,n,r,i){return new rr.prototype.init(e,t,n,r,i)}x.Tween=rr,rr.prototype={constructor:rr,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||"swing",this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(x.cssNumber[n]?"":"px")},cur:function(){var e=rr.propHooks[this.prop];return e&&e.get?e.get(this):rr.propHooks._default.get(this)},run:function(e){var t,n=rr.propHooks[this.prop];return this.pos=t=this.options.duration?x.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):rr.propHooks._default.set(this),this}},rr.prototype.init.prototype=rr.prototype,rr.propHooks={_default:{get:function(e){var t;return null==e.elem[e.prop]||e.elem.style&&null!=e.elem.style[e.prop]?(t=x.css(e.elem,e.prop,""),t&&"auto"!==t?t:0):e.elem[e.prop]},set:function(e){x.fx.step[e.prop]?x.fx.step[e.prop](e):e.elem.style&&(null!=e.elem.style[x.cssProps[e.prop]]||x.cssHooks[e.prop])?x.style(e.elem,e.prop,e.now+e.unit):e.elem[e.prop]=e.now}}},rr.propHooks.scrollTop=rr.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},x.each(["toggle","show","hide"],function(e,t){var n=x.fn[t];x.fn[t]=function(e,r,i){return null==e||"boolean"==typeof e?n.apply(this,arguments):this.animate(ir(t,!0),e,r,i)}}),x.fn.extend({fadeTo:function(e,t,n,r){return this.filter(nn).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){var i=x.isEmptyObject(e),o=x.speed(t,n,r),a=function(){var t=er(this,x.extend({},e),o);(i||x._data(this,"finish"))&&t.stop(!0)};return a.finish=a,i||o.queue===!1?this.each(a):this.queue(o.queue,a)},stop:function(e,n,r){var i=function(e){var t=e.stop;delete e.stop,t(r)};return"string"!=typeof e&&(r=n,n=e,e=t),n&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,n=null!=e&&e+"queueHooks",o=x.timers,a=x._data(this);if(n)a[n]&&a[n].stop&&i(a[n]);else for(n in a)a[n]&&a[n].stop&&Jn.test(n)&&i(a[n]);for(n=o.length;n--;)o[n].elem!==this||null!=e&&o[n].queue!==e||(o[n].anim.stop(r),t=!1,o.splice(n,1));(t||!r)&&x.dequeue(this,e)})},finish:function(e){return e!==!1&&(e=e||"fx"),this.each(function(){var t,n=x._data(this),r=n[e+"queue"],i=n[e+"queueHooks"],o=x.timers,a=r?r.length:0;for(n.finish=!0,x.queue(this,e,[]),i&&i.stop&&i.stop.call(this,!0),t=o.length;t--;)o[t].elem===this&&o[t].queue===e&&(o[t].anim.stop(!0),o.splice(t,1));for(t=0;a>t;t++)r[t]&&r[t].finish&&r[t].finish.call(this);delete n.finish})}});function ir(e,t){var n,r={height:e},i=0;for(t=t?1:0;4>i;i+=2-t)n=Zt[i],r["margin"+n]=r["padding"+n]=e;return t&&(r.opacity=r.width=e),r}x.each({slideDown:ir("show"),slideUp:ir("hide"),slideToggle:ir("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){x.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),x.speed=function(e,t,n){var r=e&&"object"==typeof e?x.extend({},e):{complete:n||!n&&t||x.isFunction(e)&&e,duration:e,easing:n&&t||t&&!x.isFunction(t)&&t};return r.duration=x.fx.off?0:"number"==typeof r.duration?r.duration:r.duration in x.fx.speeds?x.fx.speeds[r.duration]:x.fx.speeds._default,(null==r.queue||r.queue===!0)&&(r.queue="fx"),r.old=r.complete,r.complete=function(){x.isFunction(r.old)&&r.old.call(this),r.queue&&x.dequeue(this,r.queue)},r},x.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2}},x.timers=[],x.fx=rr.prototype.init,x.fx.tick=function(){var e,n=x.timers,r=0;for(Xn=x.now();n.length>r;r++)e=n[r],e()||n[r]!==e||n.splice(r--,1);n.length||x.fx.stop(),Xn=t},x.fx.timer=function(e){e()&&x.timers.push(e)&&x.fx.start()},x.fx.interval=13,x.fx.start=function(){Un||(Un=setInterval(x.fx.tick,x.fx.interval))},x.fx.stop=function(){clearInterval(Un),Un=null},x.fx.speeds={slow:600,fast:200,_default:400},x.fx.step={},x.expr&&x.expr.filters&&(x.expr.filters.animated=function(e){return x.grep(x.timers,function(t){return e===t.elem}).length}),x.fn.offset=function(e){if(arguments.length)return e===t?this:this.each(function(t){x.offset.setOffset(this,e,t)});var n,r,o={top:0,left:0},a=this[0],s=a&&a.ownerDocument;if(s)return n=s.documentElement,x.contains(n,a)?(typeof a.getBoundingClientRect!==i&&(o=a.getBoundingClientRect()),r=or(s),{top:o.top+(r.pageYOffset||n.scrollTop)-(n.clientTop||0),left:o.left+(r.pageXOffset||n.scrollLeft)-(n.clientLeft||0)}):o},x.offset={setOffset:function(e,t,n){var r=x.css(e,"position");"static"===r&&(e.style.position="relative");var i=x(e),o=i.offset(),a=x.css(e,"top"),s=x.css(e,"left"),l=("absolute"===r||"fixed"===r)&&x.inArray("auto",[a,s])>-1,u={},c={},p,f;l?(c=i.position(),p=c.top,f=c.left):(p=parseFloat(a)||0,f=parseFloat(s)||0),x.isFunction(t)&&(t=t.call(e,n,o)),null!=t.top&&(u.top=t.top-o.top+p),null!=t.left&&(u.left=t.left-o.left+f),"using"in t?t.using.call(e,u):i.css(u)}},x.fn.extend({position:function(){if(this[0]){var e,t,n={top:0,left:0},r=this[0];return"fixed"===x.css(r,"position")?t=r.getBoundingClientRect():(e=this.offsetParent(),t=this.offset(),x.nodeName(e[0],"html")||(n=e.offset()),n.top+=x.css(e[0],"borderTopWidth",!0),n.left+=x.css(e[0],"borderLeftWidth",!0)),{top:t.top-n.top-x.css(r,"marginTop",!0),left:t.left-n.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent||s;while(e&&!x.nodeName(e,"html")&&"static"===x.css(e,"position"))e=e.offsetParent;return e||s})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,n){var r=/Y/.test(n);x.fn[e]=function(i){return x.access(this,function(e,i,o){var a=or(e);return o===t?a?n in a?a[n]:a.document.documentElement[i]:e[i]:(a?a.scrollTo(r?x(a).scrollLeft():o,r?o:x(a).scrollTop()):e[i]=o,t)},e,i,arguments.length,null)}});function or(e){return x.isWindow(e)?e:9===e.nodeType?e.defaultView||e.parentWindow:!1}x.each({Height:"height",Width:"width"},function(e,n){x.each({padding:"inner"+e,content:n,"":"outer"+e},function(r,i){x.fn[i]=function(i,o){var a=arguments.length&&(r||"boolean"!=typeof i),s=r||(i===!0||o===!0?"margin":"border");return x.access(this,function(n,r,i){var o;return x.isWindow(n)?n.document.documentElement["client"+e]:9===n.nodeType?(o=n.documentElement,Math.max(n.body["scroll"+e],o["scroll"+e],n.body["offset"+e],o["offset"+e],o["client"+e])):i===t?x.css(n,r,s):x.style(n,r,i,s)},n,a?i:t,a,null)}})}),x.fn.size=function(){return this.length},x.fn.andSelf=x.fn.addBack,"object"==typeof module&&module&&"object"==typeof module.exports?module.exports=x:(e.jQuery=e.$=x,"function"==typeof define&&define.amd&&define("jquery",[],function(){return x}))})(window);
diff --git a/docs/languages/ada/concepts.md b/docs/languages/ada/concepts.md
new file mode 100644
index 0000000..28443ca
--- /dev/null
+++ b/docs/languages/ada/concepts.md
@@ -0,0 +1,29 @@
+# Ada Concepts
+
+The SOCI-Ada library borrows its concepts and naming from the main SOCI project. They are shortly explained here in the bottom-up fashion.
+
+One of the main properties of the library is that the data objects which are bound for transfer to and from the database server are managed by the library itself and are not directly visible from the user code. This ensures that no aliasing of objects occurs between Ada and underlying C++ code, which makes the inter-language interface easier and more resilient to the differences in how compilers handle the linkage. As a direct result of this design choice, users of SOCI-Ada need to instruct the library to internally create all objects that will be subject to data transfer.
+
+There are two kinds of objects that can be managed by the SOCI-Ada library:
+
+* *Into elements*, which are data objects that are transferred from the database to the user program as a result of executing a query. There are single into elements for binding single rows of results and vector into elements for binding whole bunches of data corresponding to whole result sets or their subranges. The into elements are identified by their *position*.
+
+* *Use elements*, which are data objects that are transferred from the user program to the database as parameters of the query (and, if supported by the target database, that can be modified by the database server and transferred back to the user program). There are single use elements for binding parameters of single-row queries and vector use elements for binding whole bunches of data for transfer. The use elements are identified by their *name*.
+
+The user program can read the current value of into and use elements and assign new values to use elements. Elements are strongly typed and the following types are currently supported:
+
+* `String`
+* `SOCI.DB_Integer`, which is defined by the library in terms of `Interfaces.C.int`
+* `SOCI.DB_Long_Long_Integer`, which is defined in terms of `Interfaces.Integer_64`
+* `SOCI.DB_Long_Float`, which is defined in terms of `Interfaces.C.double`
+* `Ada.Calendar.Time`
+
+Both into and use elements are managed for a single *statement*, which can be prepared once and executed once or many times, with data transfer handled during execution or fetch phase.
+
+Statements can be managed explicitly, which is required if they are to be used repeteadly or when data transfer is needed or implicitly, which is a shorthand notation that is particularly useful with simple queries or DDL commands.
+
+All statements are handled within the context of some *session*, which also supports *transactions*.
+
+Sessions can be managed in isolation or as a group called *connection pool*, which helps to decouple tasking design choices from the concurrency policies at the database connection level. Sessions are *leased* from the pool for some time during which no other task can access them and returned back when no longer needed, where they can be acquired again by other tasks.
+
+All potential problems are signalled via exceptions that have some descriptive message attached to them.
diff --git a/docs/languages/ada/concepts/index.html b/docs/languages/ada/concepts/index.html
deleted file mode 100644
index b6a79e6..0000000
--- a/docs/languages/ada/concepts/index.html
+++ /dev/null
@@ -1,364 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../../img/favicon.ico">
-        <title>Ada Concepts - SOCI (4.0.3)</title>
-        <link href="../../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="./" class="dropdown-item active">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../idioms/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/languages/ada/concepts.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#ada-concepts" class="nav-link">Ada Concepts</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="ada-concepts">Ada Concepts</h1>
-<p>The SOCI-Ada library borrows its concepts and naming from the main SOCI project. They are shortly explained here in the bottom-up fashion.</p>
-<p>One of the main properties of the library is that the data objects which are bound for transfer to and from the database server are managed by the library itself and are not directly visible from the user code. This ensures that no aliasing of objects occurs between Ada and underlying C++ code, which makes the inter-language interface easier and more resilient to the differences in how compilers handle the linkage. As a direct result of this design choice, users of SOCI-Ada need to instruct the library to internally create all objects that will be subject to data transfer.</p>
-<p>There are two kinds of objects that can be managed by the SOCI-Ada library:</p>
-<ul>
-<li>
-<p><em>Into elements</em>, which are data objects that are transferred from the database to the user program as a result of executing a query. There are single into elements for binding single rows of results and vector into elements for binding whole bunches of data corresponding to whole result sets or their subranges. The into elements are identified by their <em>position</em>.</p>
-</li>
-<li>
-<p><em>Use elements</em>, which are data objects that are transferred from the user program to the database as parameters of the query (and, if supported by the target database, that can be modified by the database server and transferred back to the user program). There are single use elements for binding parameters of single-row queries and vector use elements for binding whole bunches of data for transfer. The use elements are identified by their <em>name</em>.</p>
-</li>
-</ul>
-<p>The user program can read the current value of into and use elements and assign new values to use elements. Elements are strongly typed and the following types are currently supported:</p>
-<ul>
-<li><code>String</code></li>
-<li><code>SOCI.DB_Integer</code>, which is defined by the library in terms of <code>Interfaces.C.int</code></li>
-<li><code>SOCI.DB_Long_Long_Integer</code>, which is defined in terms of <code>Interfaces.Integer_64</code></li>
-<li><code>SOCI.DB_Long_Float</code>, which is defined in terms of <code>Interfaces.C.double</code></li>
-<li><code>Ada.Calendar.Time</code></li>
-</ul>
-<p>Both into and use elements are managed for a single <em>statement</em>, which can be prepared once and executed once or many times, with data transfer handled during execution or fetch phase.</p>
-<p>Statements can be managed explicitly, which is required if they are to be used repeteadly or when data transfer is needed or implicitly, which is a shorthand notation that is particularly useful with simple queries or DDL commands.</p>
-<p>All statements are handled within the context of some <em>session</em>, which also supports <em>transactions</em>.</p>
-<p>Sessions can be managed in isolation or as a group called <em>connection pool</em>, which helps to decouple tasking design choices from the concurrency policies at the database connection level. Sessions are <em>leased</em> from the pool for some time during which no other task can access them and returned back when no longer needed, where they can be acquired again by other tasks.</p>
-<p>All potential problems are signalled via exceptions that have some descriptive message attached to them.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../../js/base.js" defer></script>
-        <script src="../../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/languages/ada/idioms.md b/docs/languages/ada/idioms.md
new file mode 100644
index 0000000..e210aa1
--- /dev/null
+++ b/docs/languages/ada/idioms.md
@@ -0,0 +1,242 @@
+# Ada Idioms
+
+As any other library, SOCI-Ada has its set of idioms that ensure optimal work in terms of performance and resource usage. Still, the optimal use will depend on the concrete usage scenario - the places where programmer choices are needed will be described explicitly.
+
+The idioms below are provided as *complete programs* with the intent to make them more understandable and to give complete context of use for each idiom. The programs assume that the target database is PostgreSQL, but this can be changed by a different connection string in each place where the sessions are established. The programs use the Ada 2005 interface and some minor changes will be required to adapt them for Ada 95 compilers.
+
+## Single query without data transfer
+
+This type of query is useful for DDL commands and can be executed directly on the given session, without explicit statement management.
+
+```ada
+with SOCI;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+
+begin
+
+    SQL.Execute ("drop table some_table");
+
+end My_Program;
+
+```
+
+Note: The session object is initialized by a constructor function call. An alternative would be to declare it without initialization and later use the `Open` operation to establish a physical connection with the database.
+
+## Simple query without parameters resulting in one row of data
+
+This type of query requires only single into elements, which together with the statement have to be manipulated explicitly.
+
+```ada
+with SOCI;
+with Ada.Text_IO;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+    St : SOCI.Statement := SOCI.Make_Statement (SQL);
+    Pos : SOCI.Into_Position;
+
+    Num_Of_Persons : SOCI.DB_Integer;
+
+begin
+
+    Pos := St.Into_Integer;
+    St.Prepare ("select count(*) from persons");
+    St.Execute (True);
+
+    Num_Of_Persons := St.Get_Into_Integer (Pos);
+
+    Ada.Text_IO.Put_Line ("Number of persons: " & SOCI.DB_Integer'Image (Num_Of_Persons));
+
+end My_Program;
+```
+
+Note: The into element is inspected by providing the position value that was obtained at the time if was created. No operations are defined for the position type. There can be many into elements with a single query.
+
+## Simple query with parameters and without results
+
+This type of query requires only use elements.
+
+```ada
+with SOCI;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+    St : SOCI.Statement := SOCI.Make_Statement (SQL);
+
+begin
+
+    St.Use_Integer ("increase");
+    St.Set_Use_Integer ("increase", 1000);
+
+    St.Prepare ("update persons set salary = salary + :increase");
+    St.Execute (True);
+
+end My_Program;
+```
+
+Note: The "`:increase`" in the query is a placeholder variable. There can be many such variables and each of them needs to be filled in by respective use element.
+
+## Repeated query with parameters and without results
+
+This type of query requires only use elements, but they can be set differently for each statement execution.
+
+```ada
+with SOCI;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+    St : SOCI.Statement := SOCI.Make_Statement (SQL);
+
+begin
+
+    St.Use_String ("name");
+
+    St.Prepare ("insert into countries(country_name) values(:name)");
+
+    St.Set_Use_String ("name", "Poland");
+    St.Execute (True);
+
+    St.Set_Use_String ("name", "Switzerland");
+    St.Execute (True);
+
+    St.Set_Use_String ("name", "France");
+    St.Execute (True);
+
+end My_Program;
+```
+
+Note: Each time the query is executed, the *current* values of use elements are transferred to the database.
+
+## Batch query with parameters and without results
+
+This type of query requires vector use elements. Compare with the previous example.
+
+```ada
+with SOCI;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+    St : SOCI.Statement := SOCI.Make_Statement (SQL);
+    First : SOCI.Vector_Index;
+
+    use type SOCI.Vector_Index;
+
+begin
+
+    St.Use_Vector_String ("name");
+
+    St.Use_Vectors_Resize (3);
+
+    First := St.Use_Vectors_First_Index;
+
+    St.Set_Use_Vector_String ("name", First + 0, "Poland");
+    St.Set_Use_Vector_String ("name", First + 1, "Switzerland");
+    St.Set_Use_Vector_String ("name", First + 2, "France");
+
+    St.Prepare ("insert into countries(country_name) values(:name)");
+    St.Execute (True);
+
+end My_Program;
+```
+
+Note:
+
+The whole bunch of data is transferred to the database if the target database server supports it and the statement is automatically repeated otherwise. This is the preferred way to transfer many rows of data to the server when the data for all rows are known before executing the query.
+
+Note:
+
+The query can be executed many times and each time a new batch of data can be transferred to the server. The size of the batch (set by calling `Use_Vectors_Resize`) can be different each time the query is executed, but cannot be larger than the size that was used the first time. The size of the batch defines a tradeoff between the amount of data being transmitted in a single step (this influences the memory used by the user program and the time of a single call) and the number of executions required to handle big data sets. The optimal size of the batch will therefore differ depending on the application, but in general tens of thousands is a reasonable limit for a batch size - the performance of the whole operation is usually not affected above this value so there is no need to imply higher memory usage at the client side.
+
+## Simple query with many rows of results
+
+This type of query requires simple into elements.
+
+```ada
+with SOCI;
+with Ada.Text_IO;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+    St : SOCI.Statement := SOCI.Make_Statement (SQL);
+    Pos : SOCI.Into_Position;
+
+begin
+
+    Pos := St.Into_String;
+
+    St.Prepare ("select country_name from countries");
+    St.Execute;
+
+    while St.Fetch loop
+
+        Ada.Text_IO.Put_Line (St.Get_Into_String (Pos));
+
+    end loop;
+
+end My_Program;
+```
+
+Note:
+
+The loop above executes as many times as there are rows in the result. After each row is read, the into elements contain the respective values from that row. The `Execute` operation is called without parameter, which is `False` by default, meaning that no data transfer is intended. The data is being transferred only during the `Fetch` operation, which returns `False` when no data has been retrieved and the result is exhausted.
+
+This type of query can have simple parameters which are fixed at the execution time.
+
+## Batch query with many rows of results
+
+This type of query requires vector into elements. Compare with previous example.
+
+```ada
+with SOCI;
+with Ada.Text_IO;
+
+procedure My_Program is
+
+    SQL : SOCI.Session := SOCI.Make_Session ("postgresql://dbname=my_database");
+    St : SOCI.Statement := SOCI.Make_Statement (SQL);
+    Pos : SOCI.Into_Position;
+
+    Batch_Size : constant := 10;
+
+begin
+
+    Pos := St.Into_Vector_String;
+    St.Into_Vectors_Resize (Batch_Size);
+
+    St.Prepare ("select country_name from countries");
+    St.Execute;
+
+    while St.Fetch loop
+
+        for I in St.Into_Vectors_First_Index .. St.Into_Vectors_Last_Index loop
+
+            Ada.Text_IO.Put_Line (St.Get_Into_Vector_String (Pos, I));
+
+        end loop;
+
+        St.Into_Vectors_Resize (Batch_Size);
+
+    end loop;
+
+end My_Program;
+```
+
+Note:
+
+The loop above is nested. The outer `while` loop fetches consecutive batches of rows from the database with requested batch size; the returned batch can be smaller than requested (the into vector elements are downsized automatically if needed) and the intended batch size is requested again before repeating the `Fetch` operation. For each returned batch, the into vector elements are inspected in the inner `for` loop. This scheme ensures correct operation independently on the size of returned batch and is therefore a recommended idiom for efficiently returning many rows of data.
+
+There is a tradeoff between efficiency and memory usage and this tradeoff is controlled by the requested batch size. Similarly to one of the examples above, there is no benefit from using batches bigger than tens of thousands of rows.
+
+This type of query can have simple (not vectors) parameters that are fixed at execution time.
+
+## Final note
+
+Follow good database usage principles and avoid constructing queries by concatenating strings computed at run-time. Thanks to a good type system Ada is much better in preventing various SQL-injection attacks than weaker languages like PHP, but there is still a potential for vulnerability or at least performance loss. As a rule of thumb, rely on *use elements* to parameterize your queries and to provide clean separation between data and code. This will prevent many security vulnerabilities and will allow some servers to optimize their work by reusing already cached execution plans.
diff --git a/docs/languages/ada/idioms/index.html b/docs/languages/ada/idioms/index.html
deleted file mode 100644
index ce361f9..0000000
--- a/docs/languages/ada/idioms/index.html
+++ /dev/null
@@ -1,566 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../../img/favicon.ico">
-        <title>Ada Idioms - SOCI (4.0.3)</title>
-        <link href="../../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="./" class="dropdown-item active">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../concepts/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../reference/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/languages/ada/idioms.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#ada-idioms" class="nav-link">Ada Idioms</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#single-query-without-data-transfer" class="nav-link">Single query without data transfer</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#simple-query-without-parameters-resulting-in-one-row-of-data" class="nav-link">Simple query without parameters resulting in one row of data</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#simple-query-with-parameters-and-without-results" class="nav-link">Simple query with parameters and without results</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#repeated-query-with-parameters-and-without-results" class="nav-link">Repeated query with parameters and without results</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#batch-query-with-parameters-and-without-results" class="nav-link">Batch query with parameters and without results</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#simple-query-with-many-rows-of-results" class="nav-link">Simple query with many rows of results</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#batch-query-with-many-rows-of-results" class="nav-link">Batch query with many rows of results</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#final-note" class="nav-link">Final note</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="ada-idioms">Ada Idioms</h1>
-<p>As any other library, SOCI-Ada has its set of idioms that ensure optimal work in terms of performance and resource usage. Still, the optimal use will depend on the concrete usage scenario - the places where programmer choices are needed will be described explicitly.</p>
-<p>The idioms below are provided as <em>complete programs</em> with the intent to make them more understandable and to give complete context of use for each idiom. The programs assume that the target database is PostgreSQL, but this can be changed by a different connection string in each place where the sessions are established. The programs use the Ada 2005 interface and some minor changes will be required to adapt them for Ada 95 compilers.</p>
-<h2 id="single-query-without-data-transfer">Single query without data transfer</h2>
-<p>This type of query is useful for DDL commands and can be executed directly on the given session, without explicit statement management.</p>
-<pre><code class="language-ada">with SOCI;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-
-begin
-
-    SQL.Execute (&quot;drop table some_table&quot;);
-
-end My_Program;
-
-</code></pre>
-<p>Note: The session object is initialized by a constructor function call. An alternative would be to declare it without initialization and later use the <code>Open</code> operation to establish a physical connection with the database.</p>
-<h2 id="simple-query-without-parameters-resulting-in-one-row-of-data">Simple query without parameters resulting in one row of data</h2>
-<p>This type of query requires only single into elements, which together with the statement have to be manipulated explicitly.</p>
-<pre><code class="language-ada">with SOCI;
-with Ada.Text_IO;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-    St : SOCI.Statement := SOCI.Make_Statement (SQL);
-    Pos : SOCI.Into_Position;
-
-    Num_Of_Persons : SOCI.DB_Integer;
-
-begin
-
-    Pos := St.Into_Integer;
-    St.Prepare (&quot;select count(*) from persons&quot;);
-    St.Execute (True);
-
-    Num_Of_Persons := St.Get_Into_Integer (Pos);
-
-    Ada.Text_IO.Put_Line (&quot;Number of persons: &quot; &amp; SOCI.DB_Integer'Image (Num_Of_Persons));
-
-end My_Program;
-</code></pre>
-<p>Note: The into element is inspected by providing the position value that was obtained at the time if was created. No operations are defined for the position type. There can be many into elements with a single query.</p>
-<h2 id="simple-query-with-parameters-and-without-results">Simple query with parameters and without results</h2>
-<p>This type of query requires only use elements.</p>
-<pre><code class="language-ada">with SOCI;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-    St : SOCI.Statement := SOCI.Make_Statement (SQL);
-
-begin
-
-    St.Use_Integer (&quot;increase&quot;);
-    St.Set_Use_Integer (&quot;increase&quot;, 1000);
-
-    St.Prepare (&quot;update persons set salary = salary + :increase&quot;);
-    St.Execute (True);
-
-end My_Program;
-</code></pre>
-<p>Note: The "<code>:increase</code>" in the query is a placeholder variable. There can be many such variables and each of them needs to be filled in by respective use element.</p>
-<h2 id="repeated-query-with-parameters-and-without-results">Repeated query with parameters and without results</h2>
-<p>This type of query requires only use elements, but they can be set differently for each statement execution.</p>
-<pre><code class="language-ada">with SOCI;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-    St : SOCI.Statement := SOCI.Make_Statement (SQL);
-
-begin
-
-    St.Use_String (&quot;name&quot;);
-
-    St.Prepare (&quot;insert into countries(country_name) values(:name)&quot;);
-
-    St.Set_Use_String (&quot;name&quot;, &quot;Poland&quot;);
-    St.Execute (True);
-
-    St.Set_Use_String (&quot;name&quot;, &quot;Switzerland&quot;);
-    St.Execute (True);
-
-    St.Set_Use_String (&quot;name&quot;, &quot;France&quot;);
-    St.Execute (True);
-
-end My_Program;
-</code></pre>
-<p>Note: Each time the query is executed, the <em>current</em> values of use elements are transferred to the database.</p>
-<h2 id="batch-query-with-parameters-and-without-results">Batch query with parameters and without results</h2>
-<p>This type of query requires vector use elements. Compare with the previous example.</p>
-<pre><code class="language-ada">with SOCI;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-    St : SOCI.Statement := SOCI.Make_Statement (SQL);
-    First : SOCI.Vector_Index;
-
-    use type SOCI.Vector_Index;
-
-begin
-
-    St.Use_Vector_String (&quot;name&quot;);
-
-    St.Use_Vectors_Resize (3);
-
-    First := St.Use_Vectors_First_Index;
-
-    St.Set_Use_Vector_String (&quot;name&quot;, First + 0, &quot;Poland&quot;);
-    St.Set_Use_Vector_String (&quot;name&quot;, First + 1, &quot;Switzerland&quot;);
-    St.Set_Use_Vector_String (&quot;name&quot;, First + 2, &quot;France&quot;);
-
-    St.Prepare (&quot;insert into countries(country_name) values(:name)&quot;);
-    St.Execute (True);
-
-end My_Program;
-</code></pre>
-<p>Note:</p>
-<p>The whole bunch of data is transferred to the database if the target database server supports it and the statement is automatically repeated otherwise. This is the preferred way to transfer many rows of data to the server when the data for all rows are known before executing the query.</p>
-<p>Note:</p>
-<p>The query can be executed many times and each time a new batch of data can be transferred to the server. The size of the batch (set by calling <code>Use_Vectors_Resize</code>) can be different each time the query is executed, but cannot be larger than the size that was used the first time. The size of the batch defines a tradeoff between the amount of data being transmitted in a single step (this influences the memory used by the user program and the time of a single call) and the number of executions required to handle big data sets. The optimal size of the batch will therefore differ depending on the application, but in general tens of thousands is a reasonable limit for a batch size - the performance of the whole operation is usually not affected above this value so there is no need to imply higher memory usage at the client side.</p>
-<h2 id="simple-query-with-many-rows-of-results">Simple query with many rows of results</h2>
-<p>This type of query requires simple into elements.</p>
-<pre><code class="language-ada">with SOCI;
-with Ada.Text_IO;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-    St : SOCI.Statement := SOCI.Make_Statement (SQL);
-    Pos : SOCI.Into_Position;
-
-begin
-
-    Pos := St.Into_String;
-
-    St.Prepare (&quot;select country_name from countries&quot;);
-    St.Execute;
-
-    while St.Fetch loop
-
-        Ada.Text_IO.Put_Line (St.Get_Into_String (Pos));
-
-    end loop;
-
-end My_Program;
-</code></pre>
-<p>Note:</p>
-<p>The loop above executes as many times as there are rows in the result. After each row is read, the into elements contain the respective values from that row. The <code>Execute</code> operation is called without parameter, which is <code>False</code> by default, meaning that no data transfer is intended. The data is being transferred only during the <code>Fetch</code> operation, which returns <code>False</code> when no data has been retrieved and the result is exhausted.</p>
-<p>This type of query can have simple parameters which are fixed at the execution time.</p>
-<h2 id="batch-query-with-many-rows-of-results">Batch query with many rows of results</h2>
-<p>This type of query requires vector into elements. Compare with previous example.</p>
-<pre><code class="language-ada">with SOCI;
-with Ada.Text_IO;
-
-procedure My_Program is
-
-    SQL : SOCI.Session := SOCI.Make_Session (&quot;postgresql://dbname=my_database&quot;);
-    St : SOCI.Statement := SOCI.Make_Statement (SQL);
-    Pos : SOCI.Into_Position;
-
-    Batch_Size : constant := 10;
-
-begin
-
-    Pos := St.Into_Vector_String;
-    St.Into_Vectors_Resize (Batch_Size);
-
-    St.Prepare (&quot;select country_name from countries&quot;);
-    St.Execute;
-
-    while St.Fetch loop
-
-        for I in St.Into_Vectors_First_Index .. St.Into_Vectors_Last_Index loop
-
-            Ada.Text_IO.Put_Line (St.Get_Into_Vector_String (Pos, I));
-
-        end loop;
-
-        St.Into_Vectors_Resize (Batch_Size);
-
-    end loop;
-
-end My_Program;
-</code></pre>
-<p>Note:</p>
-<p>The loop above is nested. The outer <code>while</code> loop fetches consecutive batches of rows from the database with requested batch size; the returned batch can be smaller than requested (the into vector elements are downsized automatically if needed) and the intended batch size is requested again before repeating the <code>Fetch</code> operation. For each returned batch, the into vector elements are inspected in the inner <code>for</code> loop. This scheme ensures correct operation independently on the size of returned batch and is therefore a recommended idiom for efficiently returning many rows of data.</p>
-<p>There is a tradeoff between efficiency and memory usage and this tradeoff is controlled by the requested batch size. Similarly to one of the examples above, there is no benefit from using batches bigger than tens of thousands of rows.</p>
-<p>This type of query can have simple (not vectors) parameters that are fixed at execution time.</p>
-<h2 id="final-note">Final note</h2>
-<p>Follow good database usage principles and avoid constructing queries by concatenating strings computed at run-time. Thanks to a good type system Ada is much better in preventing various SQL-injection attacks than weaker languages like PHP, but there is still a potential for vulnerability or at least performance loss. As a rule of thumb, rely on <em>use elements</em> to parameterize your queries and to provide clean separation between data and code. This will prevent many security vulnerabilities and will allow some servers to optimize their work by reusing already cached execution plans.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../../js/base.js" defer></script>
-        <script src="../../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/languages/ada/index.html b/docs/languages/ada/index.html
deleted file mode 100644
index 6f6fdc9..0000000
--- a/docs/languages/ada/index.html
+++ /dev/null
@@ -1,376 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../img/favicon.ico">
-        <title>Ada Bindings - SOCI (4.0.3)</title>
-        <link href="../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="./" class="dropdown-item active">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../../api/backend/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="concepts/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/languages/ada/index.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#ada-bindings" class="nav-link">Ada Bindings</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#introduction" class="nav-link">Introduction</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#compilation" class="nav-link">Compilation</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="ada-bindings">Ada Bindings</h1>
-<ul>
-<li><a href="concepts/">Concepts</a></li>
-<li><a href="idioms/">Idioms</a></li>
-<li><a href="reference/">API Reference</a></li>
-</ul>
-<h2 id="introduction">Introduction</h2>
-<p>SOCI-Ada is a database access library for Ada.</p>
-<p>The library itself is a wrapper for the selected functionality of the SOCI library, which is a C++ database access library recognized for its high quality and innovative interface.</p>
-<p>The SOCI-Ada library offers the following features to the Ada community:</p>
-<ul>
-<li>Modular design based on dynamic backend loading. Thanks to this feature, new backends implemented within the context of the main SOCI project are immediately available for Ada programmers without any additional work. A large community of C++ users can help ensure that the new backends are well tested in a variety of environments and usage scenarios.</li>
-<li>Native backends for major database servers ensure optimal performance and minimize configuration overhead and complexity that is usually associated with other database access methods.</li>
-<li>Direct support for bulk operations allow to achieve high performance with queries that operate on large data sets.</li>
-<li>Very liberal open-source license (<a href="http://www.opensource.org/licenses/bsl1.0.html">Boost, accepted by Open Source Initiative</a>) that encourages both commercial and non-commercial use.</li>
-<li>Easy to use and compact interface.</li>
-</ul>
-<p>Currently the following database servers are directly supported via their native interfaces:</p>
-<ul>
-<li>Oracle</li>
-<li>PostgreSQL</li>
-<li>MySQL</li>
-</ul>
-<p>Other backends exist in the SOCI Git repository and can be provided with future version of the library.</p>
-<h2 id="compilation">Compilation</h2>
-<p>In order to use SOCI-Ada, compile the C++ parts first (core and required backends).</p>
-<p><em>Note:</em> SOCI header files are not needed to use SOCI-Ada, only compiled SOCI libraries (core and relevant backend) need to exist to build and use SOCI-Ada programs.</p>
-<p>The SOCI-Ada library itself is a single package named <code>SOCI</code>. This package can be just imported in the target project as is or pre-built to the binary form if required.</p>
-<p>In order to link the user programs the <code>-lsoci_core -lstdc++</code> linker options need to be provided on the Unix/Linux platforms.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../js/base.js" defer></script>
-        <script src="../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/languages/ada/index.md b/docs/languages/ada/index.md
new file mode 100644
index 0000000..afebb2c
--- /dev/null
+++ b/docs/languages/ada/index.md
@@ -0,0 +1,37 @@
+# Ada Bindings
+
+* [Concepts](concepts.md)
+* [Idioms](idioms.md)
+* [API Reference](reference.md)
+
+## Introduction
+
+SOCI-Ada is a database access library for Ada.
+
+The library itself is a wrapper for the selected functionality of the SOCI library, which is a C++ database access library recognized for its high quality and innovative interface.
+
+The SOCI-Ada library offers the following features to the Ada community:
+
+* Modular design based on dynamic backend loading. Thanks to this feature, new backends implemented within the context of the main SOCI project are immediately available for Ada programmers without any additional work. A large community of C++ users can help ensure that the new backends are well tested in a variety of environments and usage scenarios.
+* Native backends for major database servers ensure optimal performance and minimize configuration overhead and complexity that is usually associated with other database access methods.
+* Direct support for bulk operations allow to achieve high performance with queries that operate on large data sets.
+* Very liberal open-source license ([Boost, accepted by Open Source Initiative](http://www.opensource.org/licenses/bsl1.0.html)) that encourages both commercial and non-commercial use.
+* Easy to use and compact interface.
+
+Currently the following database servers are directly supported via their native interfaces:
+
+* Oracle
+* PostgreSQL
+* MySQL
+
+Other backends exist in the SOCI Git repository and can be provided with future version of the library.
+
+## Compilation
+
+In order to use SOCI-Ada, compile the C++ parts first (core and required backends).
+
+*Note:* SOCI header files are not needed to use SOCI-Ada, only compiled SOCI libraries (core and relevant backend) need to exist to build and use SOCI-Ada programs.
+
+The SOCI-Ada library itself is a single package named `SOCI`. This package can be just imported in the target project as is or pre-built to the binary form if required.
+
+In order to link the user programs the `-lsoci_core -lstdc++` linker options need to be provided on the Unix/Linux platforms.
diff --git a/docs/languages/ada/reference.md b/docs/languages/ada/reference.md
new file mode 100644
index 0000000..0f5ffe4
--- /dev/null
+++ b/docs/languages/ada/reference.md
@@ -0,0 +1,522 @@
+# Ada API Reference
+
+The SOCI-Ada library is entirely implemented as a single package named `SOCI`. Additional child packages contain single procedures for static registration of backends - these child packages are not necessary for typical use, but can be useful to force static linking of backend code.
+
+The following describes all publicly visible elements of this package:
+
+```ada
+--
+--  General exception related to database and library usage.
+--
+
+Database_Error : exception;
+```
+
+Each problem related to the interaction with the database or to the incorrect usage of the library itself is signalled by raising this exception. Each occurrence of this exception has some human-readable error message that can be obtained by a call to `Ada.Exceptions.Exception_Message`.
+
+```ada
+--
+--  Session.
+--
+
+type Session is tagged limited private;
+
+not overriding
+function Make_Session (Connection_String : in String) return Session;
+
+not overriding
+procedure Open (This : in out Session; Connection_String : in String);
+
+not overriding
+procedure Close (This : in out Session);
+
+not overriding
+function Is_Open (This : in Session) return Boolean;
+```
+
+The `Session` object can exist in two states: "connected" (or "open") and "disconnected". It can be created as connected at initialization time with a call to the constructor function `Make_Session` or left default-initialized in the disconnected state and later changed to connected with `Open` (the latter option is the only that is available in the Ada 95 version of the library). `Session` objects can be also associated with the connection pool, see below.
+
+The `Connection_String` should have the form `"backendname://parameters"`, where `backendname` is used to construct the name of the dynamically loadable library that will be used to provide specific database services. Backends included in the current distribution of the main SOCI library are:
+
+* `oracle` (implemented as `libsoci_oracle.so` or `libsoci_oracle.dll`)
+* `postgresql` (implemented as `libsoci_postgresql.so` or `libsoci_postgresql.dll`)
+* `mysql` (implemented as `libsoci_mysql.so` or `libsoci_mysql.dll`)
+
+Other backends can be added to the library in the future or by the user himself, please see the documentation of the main SOCI library for details.
+
+The `parameters` component of the `Connection_String` depends on the given backend, please see the documentation of the main SOCI project for the meaning and recognized options. The web pages related to the backends above are:
+
+* [Oracle](../../backends/oracle.md)
+* [PostgreSQL](../../backends/postgresql.md)
+* [MySQL](../../backends/mysql.md)
+
+The `Open` operation can be called only in the disconnected state (which changes the state of `Session` object to connected). The `Close` operation can be called in any state (provided that the session is not associated with the connection pool, see below) and after that the `Session` is in the disconnected state.
+
+`Session` objects are closed automatically as part of their finalization. If the `Session` object is associated with the connection pool, the finalizer detaches from the pool without closing the connection.
+
+```ada
+--  Transaction management.
+
+not overriding
+procedure Start (This : in Session);
+
+not overriding
+procedure Commit (This : in Session);
+
+not overriding
+procedure Rollback (This : in Session);
+```
+
+These operations handle transactions. The exact meaning of transactions and whether transactions are automatic for some kinds of statements (and which ones) depend on the target database.
+
+```ada
+--  Immediate query execution.
+not overriding
+procedure Execute (This : in Session; Query : in String);
+```
+
+This operation allows to create implicit statement, prepare it for the given `Query` and execute it.
+
+```ada
+--
+--  Connection pool management.
+--
+
+type Connection_Pool (Size : Positive) is tagged limited private;
+
+not overriding
+procedure Open
+    (This : in out Connection_Pool;
+    Position : in Positive;
+    Connection_String : in String);
+
+not overriding
+procedure Close (This : in out Connection_Pool; Position : in Positive);
+
+not overriding
+procedure Lease (This : in out Connection_Pool; S : in out Session'Class);
+```
+
+The `Connection_Pool` encapsulates a fixed-size collection of sessions. Individual sessions are indexed from `1` to `Size` (provided as discriminant) and can be `Open`ed and `Close`d explicitly. Each connection in the pool can be created with different `Connection_String`, if needed.
+
+The `Lease` operation allows to associate a given `Session` object (that has to be in the disconnected state itself) with one connection from the pool. The pool guarantees that at most one task can lease a given connection from the pool. If there are no free connections in the pool, the `Lease` operation will block waiting until some connection is freed.
+
+The `Session` object that is associated with a connection from the pool automatically gives it back to pool as part of the `Session`'s finalizer. There is no other way to "detach" from the pool.
+
+Note:
+
+It is assumed that the lifetime of `Connection_Pool` encloses the lifetimes of all `Session` objects that are leased from it. There is no particular protection against it and it is possible to construct a code example with allocators that create partially overlapping `Connection_Pool` and `Session`, but this is considered obscure and not representative to the actual use scenarios. To avoid any potential problems, create `Connection_Pool` in the scope that encloses the scopes of leased `Session`s.
+
+```ada
+--
+--  Statement.
+--
+
+type Statement (&lt;&gt;) is tagged limited private;
+
+type Data_State is (Data_Null, Data_Not_Null);
+
+type Into_Position is private;
+
+type Vector_Index is new Natural;
+```
+
+The `Statement` type and supporting types. `Data_State` is used to indicate null values in the database sense - each value of into or use elements has a state from this type.
+
+```ada
+--  Statement preparation and execution.
+
+not overriding
+procedure Prepare (This : in Statement; Query : in String);
+
+not overriding
+procedure Execute
+    (This : in Statement;
+    With_Data_Exchange : in Boolean := False);
+
+not overriding
+function Execute
+    (This : in Statement;
+    With_Data_Exchange : in Boolean := False) return Boolean;
+
+not overriding
+function Fetch (This : in Statement) return Boolean;
+
+not overriding
+function Got_Data (This : in Statement) return Boolean;
+```
+
+The `Prepare` operation needs to be called before any other operation in the above group and it prepares the execution for the given `Query`. No into and use elements can be created after this operation is called.
+
+The `Execute` operations cause the statement to execute, which might be combined with data exchange if requested. The function version of this operation returns `True` if some data has been returned back from the database server.
+
+The `Fetch` function is used to transfer next portion of data (a single row or a whole bunch) from the database server and returns `True` if some data has been fetched. If this function returns `False` it means that no new data will be ever fetched for this statement and indicates the end-of-row condition.
+
+The `Got_Data` function returns `True` if the last execution or fetch resulted in some data being transmitted from the database server.
+
+```ada
+--
+--  Data items handling.
+--
+
+--  Database-specific types.
+--  These types are most likely identical to standard Integer,
+--  Long_Long_Integer and Long_Float, but are defined distinctly
+--  to avoid interfacing problems with other compilers.
+
+type DB_Integer is new Interfaces.C.int;
+type DB_Long_Long_Integer is new Interfaces.Integer_64;
+type DB_Long_Float is new Interfaces.C.double;
+```
+
+The data types used for interaction with the database are:
+
+* `String`
+* `DB_Integer`, defined above
+* `DB_Long_Long_Integer`, defined above
+* `DB_Long_Float`, defined above
+* `Ada.Calendar.Time`
+
+```ada
+--  Creation of single into elements.
+
+not overriding
+function Into_String (This : in Statement) return Into_Position;
+
+not overriding
+function Into_Integer (This : in Statement) return Into_Position;
+
+not overriding
+function Into_Long_Long_Integer (This : in Statement) return Into_Position;
+
+not overriding
+function Into_Long_Float (This : in Statement) return Into_Position;
+
+not overriding
+function Into_Time (This : in Statement) return Into_Position;
+```
+
+These functions instruct the library to create internal simple into elements of the relevant type. They return the position of the into element, which can be later used to identify it.
+
+Note: Simple into elements cannot be created together with vector into elements for the same statement.
+
+Note: Simple into elements cannot be created together with vector into elements for the same statement.
+
+```ada
+--  Inspection of single into elements.
+
+not overriding
+function Get_Into_State
+    (This : in Statement;
+    Position : in Into_Position)
+    return Data_State;
+
+not overriding
+function Get_Into_String
+    (This : in Statement;
+    Position : in Into_Position)
+    return String;
+
+not overriding
+function Get_Into_Integer
+    (This : in Statement;
+    Position : in Into_Position)
+    return DB_Integer;
+
+not overriding
+function Get_Into_Long_Long_Integer
+    (This : in Statement;
+    Position : in Into_Position)
+    return DB_Long_Long_Integer;
+
+not overriding
+function Get_Into_Long_Float
+    (This : in Statement;
+    Position : in Into_Position)
+    return DB_Long_Float;
+
+not overriding
+function Get_Into_Time
+    (This : in Statement;
+    Position : in Into_Position)
+    return Ada.Calendar.Time;
+```
+
+These functions allow to inspect the state and value of the simple into element identified by its position. If the state of the given element is `Data_Null`, the data-reading functions raise exceptions for that element.
+
+```ada
+--  Inspection of vector into elements.
+
+not overriding
+function Get_Into_Vectors_Size (This : in Statement) return Natural;
+
+not overriding
+function Into_Vectors_First_Index (This : in Statement) return Vector_Index;
+
+not overriding
+function Into_Vectors_Last_Index (This : in Statement) return Vector_Index;
+
+not overriding
+procedure Into_Vectors_Resize (This : in Statement; New_Size : in Natural);
+```
+
+The `Get_Into_Vectors_Size` returns the number of entries in any of the vector into elements for the given statement.
+
+The `Into_Vectors_First_Index` returns the lowest index value for vector into elements (which is always `0`, even if the vectors are empty). The `Into_Vectors_Last_Index` returns the last index of into vectors, and raises the `CONSTRAINT_ERROR` exception if the vectors are empty.
+
+The `Into_Vectors_Resize` procedure allows to change the size of all use vectors for the given statement.
+
+```ada
+not overriding
+function Get_Into_Vector_State
+    (This : in Statement;
+    Position : in Into_Position;
+    Index : in Vector_Index)
+    return Data_State;
+
+not overriding
+function Get_Into_Vector_String
+    (This : in Statement;
+    Position : in Into_Position;
+    Index : in Vector_Index)
+    return String;
+
+not overriding
+function Get_Into_Vector_Integer
+    (This : in Statement;
+    Position : in Into_Position;
+    Index : in Vector_Index)
+    return DB_Integer;
+
+not overriding
+function Get_Into_Vector_Long_Long_Integer
+    (This : in Statement;
+    Position : in Into_Position;
+    Index : in Vector_Index)
+    return DB_Long_Long_Integer;
+
+not overriding
+function Get_Into_Vector_Long_Float
+    (This : in Statement;
+    Position : in Into_Position;
+    Index : in Vector_Index)
+    return DB_Long_Float;
+
+not overriding
+function Get_Into_Vector_Time
+    (This : in Statement;
+    Position : in Into_Position;
+    Index : in Vector_Index)
+    return Ada.Calendar.Time;
+```
+
+These functions allow to inspect the state and value of the vector use element identified by its position and index. If the state of the given element is `Data_Null`, the data-reading functions raise exceptions for that element.
+
+```ada
+--  Creation of single use elements.
+
+not overriding
+procedure Use_String (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Integer (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Long_Long_Integer (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Long_Float (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Time (This : in Statement; Name : in String);
+```
+
+These functions instruct the library to create internal simple use elements of the relevant type, identified by the given `Name`.
+
+Note:
+
+* Simple use elements cannot be created together with vector use elements for the same statement.
+* Vector use elements cannot be created together with any into elements for the same statement.
+
+```ada
+--  Creation of vector use elements.
+
+not overriding
+procedure Use_Vector_String (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Vector_Integer (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Vector_Long_Long_Integer (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Vector_Long_Float (This : in Statement; Name : in String);
+
+not overriding
+procedure Use_Vector_Time (This : in Statement; Name : in String);
+```
+
+These functions instruct the library to create internal vector use elements of the relevant type, identified by the given `Name`.
+
+Note:
+
+* Simple use elements cannot be created together with vector use elements for the same statement.
+* Vector use elements cannot be created together with any into elements for the same statement.
+
+```ada
+--  Modifiers for single use elements.
+
+not overriding
+procedure Set_Use_State
+    (This : in Statement;
+    Name : in String;
+    State : in Data_State);
+
+not overriding
+procedure Set_Use_String
+    (This : in Statement;
+    Name : in String;
+    Value : in String);
+
+not overriding
+procedure Set_Use_Integer
+    (This : in Statement;
+    Name : in String;
+    Value : in DB_Integer);
+
+not overriding
+procedure Set_Use_Long_Long_Integer
+    (This : in Statement;
+    Name : in String;
+    Value : in DB_Long_Long_Integer);
+
+not overriding
+procedure Set_Use_Long_Float
+    (This : in Statement;
+    Name : in String;
+    Value : in DB_Long_Float);
+
+not overriding
+procedure Set_Use_Time
+    (This : in Statement;
+    Name : in String;
+    Value : in Ada.Calendar.Time);
+```
+
+These operations allow to modify the state and value of simple use elements. Setting the value of use element automatically sets its state to `Data_Not_Null`.
+
+```ada
+--  Modifiers for vector use elements.
+
+not overriding
+function Get_Use_Vectors_Size (This : in Statement) return Natural;
+
+not overriding
+function Use_Vectors_First_Index (This : in Statement) return Vector_Index;
+
+not overriding
+function Use_Vectors_Last_Index (This : in Statement) return Vector_Index;
+
+not overriding
+procedure Use_Vectors_Resize (This : in Statement; New_Size : in Natural);
+```
+
+The `Get_Use_Vectors_Size` returns the number of entries in any of the vector use elements for the given statement.
+
+The `Use_Vectors_First_Index` returns the lowest index value for vector use elements (which is always `0`, even if the vectors are empty). The `Use_Vectors_Last_Index` returns the last index of use vectors, and raises the `CONSTRAINT_ERROR` exception if the vectors are empty.
+
+The `Use_Vectors_Resize` procedure allows to change the size of all use vectors for the given statement.
+
+```ada
+not overriding
+procedure Set_Use_Vector_State
+    (This : in Statement;
+    Name : in String;
+    Index : in Vector_Index;
+    State : in Data_State);
+
+not overriding
+procedure Set_Use_Vector_String
+    (This : in Statement;
+    Name : in String;
+    Index : in Vector_Index;
+    Value : in String);
+
+not overriding
+procedure Set_Use_Vector_Integer
+    (This : in Statement;
+    Name : in String;
+    Index : in Vector_Index;
+    Value : in DB_Integer);
+
+not overriding
+procedure Set_Use_Vector_Long_Long_Integer
+    (This : in Statement;
+    Name : in String;
+    Index : in Vector_Index;
+    Value : in DB_Long_Long_Integer);
+
+not overriding
+procedure Set_Use_Vector_Long_Float
+    (This : in Statement;
+    Name : in String;
+    Index : in Vector_Index;
+    Value : in DB_Long_Float);
+
+not overriding
+procedure Set_Use_Vector_Time
+    (This : in Statement;
+    Name : in String;
+    Index : in Vector_Index;
+    Value : in Ada.Calendar.Time);
+```
+
+These operations allow to modify the state and value of vector use elements. Setting the value of use element automatically sets its state to `Data_Not_Null`.
+
+```ada
+--  Inspection of single use elements.
+--
+--  Note: Use elements can be modified by the database if they
+--        are bound to out and inout parameters of stored procedures
+--        (although this is not supported by all database backends).
+--        This feature is available only for single use elements.
+
+not overriding
+function Get_Use_State
+    (This : in Statement;
+    Name : in String)
+    return Data_State;
+
+not overriding
+function Get_Use_String
+    (This : in Statement;
+    Name : in String)
+    return String;
+
+not overriding
+function Get_Use_Integer
+    (This : in Statement;
+    Name : in String)
+    return DB_Integer;
+
+not overriding
+function Get_Use_Long_Long_Integer
+    (This : in Statement;
+    Name : in String)
+    return DB_Long_Long_Integer;
+
+not overriding
+function Get_Use_Long_Float
+    (This : in Statement;
+    Name : in String)
+    return DB_Long_Float;
+
+not overriding
+function Get_Use_Time
+    (This : in Statement;
+    Name : in String)
+    return Ada.Calendar.Time;
+```
+
+These functions allow to inspect the state and value of the simple use element identified by its name. If the state of the given element is `Data_Null`, the data-reading functions raise exceptions for that element.
diff --git a/docs/languages/ada/reference/index.html b/docs/languages/ada/reference/index.html
deleted file mode 100644
index 164ab45..0000000
--- a/docs/languages/ada/reference/index.html
+++ /dev/null
@@ -1,790 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../../../img/favicon.ico">
-        <title>Ada API Reference - SOCI (4.0.3)</title>
-        <link href="../../../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../../../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../../../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../../../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../../../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="../../..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href="../../.." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../../../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../../../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../../../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../../../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../../../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../../../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../../../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../../../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../../../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../../../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../../../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../../../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../../../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../../../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../../../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../../../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../../../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../../../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../../../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../../../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../../../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="./" class="dropdown-item active">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../idioms/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" class="nav-link disabled">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/languages/ada/reference.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#ada-api-reference" class="nav-link">Ada API Reference</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="ada-api-reference">Ada API Reference</h1>
-<p>The SOCI-Ada library is entirely implemented as a single package named <code>SOCI</code>. Additional child packages contain single procedures for static registration of backends - these child packages are not necessary for typical use, but can be useful to force static linking of backend code.</p>
-<p>The following describes all publicly visible elements of this package:</p>
-<pre><code class="language-ada">--
---  General exception related to database and library usage.
---
-
-Database_Error : exception;
-</code></pre>
-<p>Each problem related to the interaction with the database or to the incorrect usage of the library itself is signalled by raising this exception. Each occurrence of this exception has some human-readable error message that can be obtained by a call to <code>Ada.Exceptions.Exception_Message</code>.</p>
-<pre><code class="language-ada">--
---  Session.
---
-
-type Session is tagged limited private;
-
-not overriding
-function Make_Session (Connection_String : in String) return Session;
-
-not overriding
-procedure Open (This : in out Session; Connection_String : in String);
-
-not overriding
-procedure Close (This : in out Session);
-
-not overriding
-function Is_Open (This : in Session) return Boolean;
-</code></pre>
-<p>The <code>Session</code> object can exist in two states: "connected" (or "open") and "disconnected". It can be created as connected at initialization time with a call to the constructor function <code>Make_Session</code> or left default-initialized in the disconnected state and later changed to connected with <code>Open</code> (the latter option is the only that is available in the Ada 95 version of the library). <code>Session</code> objects can be also associated with the connection pool, see below.</p>
-<p>The <code>Connection_String</code> should have the form <code>"backendname://parameters"</code>, where <code>backendname</code> is used to construct the name of the dynamically loadable library that will be used to provide specific database services. Backends included in the current distribution of the main SOCI library are:</p>
-<ul>
-<li><code>oracle</code> (implemented as <code>libsoci_oracle.so</code> or <code>libsoci_oracle.dll</code>)</li>
-<li><code>postgresql</code> (implemented as <code>libsoci_postgresql.so</code> or <code>libsoci_postgresql.dll</code>)</li>
-<li><code>mysql</code> (implemented as <code>libsoci_mysql.so</code> or <code>libsoci_mysql.dll</code>)</li>
-</ul>
-<p>Other backends can be added to the library in the future or by the user himself, please see the documentation of the main SOCI library for details.</p>
-<p>The <code>parameters</code> component of the <code>Connection_String</code> depends on the given backend, please see the documentation of the main SOCI project for the meaning and recognized options. The web pages related to the backends above are:</p>
-<ul>
-<li><a href="../../../backends/oracle/">Oracle</a></li>
-<li><a href="../../../backends/postgresql/">PostgreSQL</a></li>
-<li><a href="../../../backends/mysql/">MySQL</a></li>
-</ul>
-<p>The <code>Open</code> operation can be called only in the disconnected state (which changes the state of <code>Session</code> object to connected). The <code>Close</code> operation can be called in any state (provided that the session is not associated with the connection pool, see below) and after that the <code>Session</code> is in the disconnected state.</p>
-<p><code>Session</code> objects are closed automatically as part of their finalization. If the <code>Session</code> object is associated with the connection pool, the finalizer detaches from the pool without closing the connection.</p>
-<pre><code class="language-ada">--  Transaction management.
-
-not overriding
-procedure Start (This : in Session);
-
-not overriding
-procedure Commit (This : in Session);
-
-not overriding
-procedure Rollback (This : in Session);
-</code></pre>
-<p>These operations handle transactions. The exact meaning of transactions and whether transactions are automatic for some kinds of statements (and which ones) depend on the target database.</p>
-<pre><code class="language-ada">--  Immediate query execution.
-not overriding
-procedure Execute (This : in Session; Query : in String);
-</code></pre>
-<p>This operation allows to create implicit statement, prepare it for the given <code>Query</code> and execute it.</p>
-<pre><code class="language-ada">--
---  Connection pool management.
---
-
-type Connection_Pool (Size : Positive) is tagged limited private;
-
-not overriding
-procedure Open
-    (This : in out Connection_Pool;
-    Position : in Positive;
-    Connection_String : in String);
-
-not overriding
-procedure Close (This : in out Connection_Pool; Position : in Positive);
-
-not overriding
-procedure Lease (This : in out Connection_Pool; S : in out Session'Class);
-</code></pre>
-<p>The <code>Connection_Pool</code> encapsulates a fixed-size collection of sessions. Individual sessions are indexed from <code>1</code> to <code>Size</code> (provided as discriminant) and can be <code>Open</code>ed and <code>Close</code>d explicitly. Each connection in the pool can be created with different <code>Connection_String</code>, if needed.</p>
-<p>The <code>Lease</code> operation allows to associate a given <code>Session</code> object (that has to be in the disconnected state itself) with one connection from the pool. The pool guarantees that at most one task can lease a given connection from the pool. If there are no free connections in the pool, the <code>Lease</code> operation will block waiting until some connection is freed.</p>
-<p>The <code>Session</code> object that is associated with a connection from the pool automatically gives it back to pool as part of the <code>Session</code>'s finalizer. There is no other way to "detach" from the pool.</p>
-<p>Note:</p>
-<p>It is assumed that the lifetime of <code>Connection_Pool</code> encloses the lifetimes of all <code>Session</code> objects that are leased from it. There is no particular protection against it and it is possible to construct a code example with allocators that create partially overlapping <code>Connection_Pool</code> and <code>Session</code>, but this is considered obscure and not representative to the actual use scenarios. To avoid any potential problems, create <code>Connection_Pool</code> in the scope that encloses the scopes of leased <code>Session</code>s.</p>
-<pre><code class="language-ada">--
---  Statement.
---
-
-type Statement (&amp;lt;&amp;gt;) is tagged limited private;
-
-type Data_State is (Data_Null, Data_Not_Null);
-
-type Into_Position is private;
-
-type Vector_Index is new Natural;
-</code></pre>
-<p>The <code>Statement</code> type and supporting types. <code>Data_State</code> is used to indicate null values in the database sense - each value of into or use elements has a state from this type.</p>
-<pre><code class="language-ada">--  Statement preparation and execution.
-
-not overriding
-procedure Prepare (This : in Statement; Query : in String);
-
-not overriding
-procedure Execute
-    (This : in Statement;
-    With_Data_Exchange : in Boolean := False);
-
-not overriding
-function Execute
-    (This : in Statement;
-    With_Data_Exchange : in Boolean := False) return Boolean;
-
-not overriding
-function Fetch (This : in Statement) return Boolean;
-
-not overriding
-function Got_Data (This : in Statement) return Boolean;
-</code></pre>
-<p>The <code>Prepare</code> operation needs to be called before any other operation in the above group and it prepares the execution for the given <code>Query</code>. No into and use elements can be created after this operation is called.</p>
-<p>The <code>Execute</code> operations cause the statement to execute, which might be combined with data exchange if requested. The function version of this operation returns <code>True</code> if some data has been returned back from the database server.</p>
-<p>The <code>Fetch</code> function is used to transfer next portion of data (a single row or a whole bunch) from the database server and returns <code>True</code> if some data has been fetched. If this function returns <code>False</code> it means that no new data will be ever fetched for this statement and indicates the end-of-row condition.</p>
-<p>The <code>Got_Data</code> function returns <code>True</code> if the last execution or fetch resulted in some data being transmitted from the database server.</p>
-<pre><code class="language-ada">--
---  Data items handling.
---
-
---  Database-specific types.
---  These types are most likely identical to standard Integer,
---  Long_Long_Integer and Long_Float, but are defined distinctly
---  to avoid interfacing problems with other compilers.
-
-type DB_Integer is new Interfaces.C.int;
-type DB_Long_Long_Integer is new Interfaces.Integer_64;
-type DB_Long_Float is new Interfaces.C.double;
-</code></pre>
-<p>The data types used for interaction with the database are:</p>
-<ul>
-<li><code>String</code></li>
-<li><code>DB_Integer</code>, defined above</li>
-<li><code>DB_Long_Long_Integer</code>, defined above</li>
-<li><code>DB_Long_Float</code>, defined above</li>
-<li><code>Ada.Calendar.Time</code></li>
-</ul>
-<pre><code class="language-ada">--  Creation of single into elements.
-
-not overriding
-function Into_String (This : in Statement) return Into_Position;
-
-not overriding
-function Into_Integer (This : in Statement) return Into_Position;
-
-not overriding
-function Into_Long_Long_Integer (This : in Statement) return Into_Position;
-
-not overriding
-function Into_Long_Float (This : in Statement) return Into_Position;
-
-not overriding
-function Into_Time (This : in Statement) return Into_Position;
-</code></pre>
-<p>These functions instruct the library to create internal simple into elements of the relevant type. They return the position of the into element, which can be later used to identify it.</p>
-<p>Note: Simple into elements cannot be created together with vector into elements for the same statement.</p>
-<p>Note: Simple into elements cannot be created together with vector into elements for the same statement.</p>
-<pre><code class="language-ada">--  Inspection of single into elements.
-
-not overriding
-function Get_Into_State
-    (This : in Statement;
-    Position : in Into_Position)
-    return Data_State;
-
-not overriding
-function Get_Into_String
-    (This : in Statement;
-    Position : in Into_Position)
-    return String;
-
-not overriding
-function Get_Into_Integer
-    (This : in Statement;
-    Position : in Into_Position)
-    return DB_Integer;
-
-not overriding
-function Get_Into_Long_Long_Integer
-    (This : in Statement;
-    Position : in Into_Position)
-    return DB_Long_Long_Integer;
-
-not overriding
-function Get_Into_Long_Float
-    (This : in Statement;
-    Position : in Into_Position)
-    return DB_Long_Float;
-
-not overriding
-function Get_Into_Time
-    (This : in Statement;
-    Position : in Into_Position)
-    return Ada.Calendar.Time;
-</code></pre>
-<p>These functions allow to inspect the state and value of the simple into element identified by its position. If the state of the given element is <code>Data_Null</code>, the data-reading functions raise exceptions for that element.</p>
-<pre><code class="language-ada">--  Inspection of vector into elements.
-
-not overriding
-function Get_Into_Vectors_Size (This : in Statement) return Natural;
-
-not overriding
-function Into_Vectors_First_Index (This : in Statement) return Vector_Index;
-
-not overriding
-function Into_Vectors_Last_Index (This : in Statement) return Vector_Index;
-
-not overriding
-procedure Into_Vectors_Resize (This : in Statement; New_Size : in Natural);
-</code></pre>
-<p>The <code>Get_Into_Vectors_Size</code> returns the number of entries in any of the vector into elements for the given statement.</p>
-<p>The <code>Into_Vectors_First_Index</code> returns the lowest index value for vector into elements (which is always <code>0</code>, even if the vectors are empty). The <code>Into_Vectors_Last_Index</code> returns the last index of into vectors, and raises the <code>CONSTRAINT_ERROR</code> exception if the vectors are empty.</p>
-<p>The <code>Into_Vectors_Resize</code> procedure allows to change the size of all use vectors for the given statement.</p>
-<pre><code class="language-ada">not overriding
-function Get_Into_Vector_State
-    (This : in Statement;
-    Position : in Into_Position;
-    Index : in Vector_Index)
-    return Data_State;
-
-not overriding
-function Get_Into_Vector_String
-    (This : in Statement;
-    Position : in Into_Position;
-    Index : in Vector_Index)
-    return String;
-
-not overriding
-function Get_Into_Vector_Integer
-    (This : in Statement;
-    Position : in Into_Position;
-    Index : in Vector_Index)
-    return DB_Integer;
-
-not overriding
-function Get_Into_Vector_Long_Long_Integer
-    (This : in Statement;
-    Position : in Into_Position;
-    Index : in Vector_Index)
-    return DB_Long_Long_Integer;
-
-not overriding
-function Get_Into_Vector_Long_Float
-    (This : in Statement;
-    Position : in Into_Position;
-    Index : in Vector_Index)
-    return DB_Long_Float;
-
-not overriding
-function Get_Into_Vector_Time
-    (This : in Statement;
-    Position : in Into_Position;
-    Index : in Vector_Index)
-    return Ada.Calendar.Time;
-</code></pre>
-<p>These functions allow to inspect the state and value of the vector use element identified by its position and index. If the state of the given element is <code>Data_Null</code>, the data-reading functions raise exceptions for that element.</p>
-<pre><code class="language-ada">--  Creation of single use elements.
-
-not overriding
-procedure Use_String (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Integer (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Long_Long_Integer (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Long_Float (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Time (This : in Statement; Name : in String);
-</code></pre>
-<p>These functions instruct the library to create internal simple use elements of the relevant type, identified by the given <code>Name</code>.</p>
-<p>Note:</p>
-<ul>
-<li>Simple use elements cannot be created together with vector use elements for the same statement.</li>
-<li>Vector use elements cannot be created together with any into elements for the same statement.</li>
-</ul>
-<pre><code class="language-ada">--  Creation of vector use elements.
-
-not overriding
-procedure Use_Vector_String (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Vector_Integer (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Vector_Long_Long_Integer (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Vector_Long_Float (This : in Statement; Name : in String);
-
-not overriding
-procedure Use_Vector_Time (This : in Statement; Name : in String);
-</code></pre>
-<p>These functions instruct the library to create internal vector use elements of the relevant type, identified by the given <code>Name</code>.</p>
-<p>Note:</p>
-<ul>
-<li>Simple use elements cannot be created together with vector use elements for the same statement.</li>
-<li>Vector use elements cannot be created together with any into elements for the same statement.</li>
-</ul>
-<pre><code class="language-ada">--  Modifiers for single use elements.
-
-not overriding
-procedure Set_Use_State
-    (This : in Statement;
-    Name : in String;
-    State : in Data_State);
-
-not overriding
-procedure Set_Use_String
-    (This : in Statement;
-    Name : in String;
-    Value : in String);
-
-not overriding
-procedure Set_Use_Integer
-    (This : in Statement;
-    Name : in String;
-    Value : in DB_Integer);
-
-not overriding
-procedure Set_Use_Long_Long_Integer
-    (This : in Statement;
-    Name : in String;
-    Value : in DB_Long_Long_Integer);
-
-not overriding
-procedure Set_Use_Long_Float
-    (This : in Statement;
-    Name : in String;
-    Value : in DB_Long_Float);
-
-not overriding
-procedure Set_Use_Time
-    (This : in Statement;
-    Name : in String;
-    Value : in Ada.Calendar.Time);
-</code></pre>
-<p>These operations allow to modify the state and value of simple use elements. Setting the value of use element automatically sets its state to <code>Data_Not_Null</code>.</p>
-<pre><code class="language-ada">--  Modifiers for vector use elements.
-
-not overriding
-function Get_Use_Vectors_Size (This : in Statement) return Natural;
-
-not overriding
-function Use_Vectors_First_Index (This : in Statement) return Vector_Index;
-
-not overriding
-function Use_Vectors_Last_Index (This : in Statement) return Vector_Index;
-
-not overriding
-procedure Use_Vectors_Resize (This : in Statement; New_Size : in Natural);
-</code></pre>
-<p>The <code>Get_Use_Vectors_Size</code> returns the number of entries in any of the vector use elements for the given statement.</p>
-<p>The <code>Use_Vectors_First_Index</code> returns the lowest index value for vector use elements (which is always <code>0</code>, even if the vectors are empty). The <code>Use_Vectors_Last_Index</code> returns the last index of use vectors, and raises the <code>CONSTRAINT_ERROR</code> exception if the vectors are empty.</p>
-<p>The <code>Use_Vectors_Resize</code> procedure allows to change the size of all use vectors for the given statement.</p>
-<pre><code class="language-ada">not overriding
-procedure Set_Use_Vector_State
-    (This : in Statement;
-    Name : in String;
-    Index : in Vector_Index;
-    State : in Data_State);
-
-not overriding
-procedure Set_Use_Vector_String
-    (This : in Statement;
-    Name : in String;
-    Index : in Vector_Index;
-    Value : in String);
-
-not overriding
-procedure Set_Use_Vector_Integer
-    (This : in Statement;
-    Name : in String;
-    Index : in Vector_Index;
-    Value : in DB_Integer);
-
-not overriding
-procedure Set_Use_Vector_Long_Long_Integer
-    (This : in Statement;
-    Name : in String;
-    Index : in Vector_Index;
-    Value : in DB_Long_Long_Integer);
-
-not overriding
-procedure Set_Use_Vector_Long_Float
-    (This : in Statement;
-    Name : in String;
-    Index : in Vector_Index;
-    Value : in DB_Long_Float);
-
-not overriding
-procedure Set_Use_Vector_Time
-    (This : in Statement;
-    Name : in String;
-    Index : in Vector_Index;
-    Value : in Ada.Calendar.Time);
-</code></pre>
-<p>These operations allow to modify the state and value of vector use elements. Setting the value of use element automatically sets its state to <code>Data_Not_Null</code>.</p>
-<pre><code class="language-ada">--  Inspection of single use elements.
---
---  Note: Use elements can be modified by the database if they
---        are bound to out and inout parameters of stored procedures
---        (although this is not supported by all database backends).
---        This feature is available only for single use elements.
-
-not overriding
-function Get_Use_State
-    (This : in Statement;
-    Name : in String)
-    return Data_State;
-
-not overriding
-function Get_Use_String
-    (This : in Statement;
-    Name : in String)
-    return String;
-
-not overriding
-function Get_Use_Integer
-    (This : in Statement;
-    Name : in String)
-    return DB_Integer;
-
-not overriding
-function Get_Use_Long_Long_Integer
-    (This : in Statement;
-    Name : in String)
-    return DB_Long_Long_Integer;
-
-not overriding
-function Get_Use_Long_Float
-    (This : in Statement;
-    Name : in String)
-    return DB_Long_Float;
-
-not overriding
-function Get_Use_Time
-    (This : in Statement;
-    Name : in String)
-    return Ada.Calendar.Time;
-</code></pre>
-<p>These functions allow to inspect the state and value of the simple use element identified by its name. If the state of the given element is <code>Data_Null</code>, the data-reading functions raise exceptions for that element.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "../../..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../../../js/base.js" defer></script>
-        <script src="../../../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/languages/index.html b/docs/languages/index.html
deleted file mode 100644
index b9687ea..0000000
--- a/docs/languages/index.html
+++ /dev/null
@@ -1,333 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Language bindings - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/languages/index.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#language-bindings" class="nav-link">Language bindings</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="language-bindings">Language bindings</h1>
-<ul>
-<li><a href="ada/">Ada</a></li>
-</ul></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/languages/index.md b/docs/languages/index.md
new file mode 100644
index 0000000..cf09638
--- /dev/null
+++ b/docs/languages/index.md
@@ -0,0 +1,3 @@
+# Language bindings
+
+* [Ada](ada/index.md)
diff --git a/docs/license.md b/docs/license.md
new file mode 100644
index 0000000..18aef88
--- /dev/null
+++ b/docs/license.md
@@ -0,0 +1,29 @@
+# License
+
+The SOCI library is distributed under the terms of the [Boost Software License](http://www.boost.org/LICENSE_1_0.txt).
+
+## Boost Software License
+
+Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
diff --git a/docs/license/index.html b/docs/license/index.html
deleted file mode 100644
index f487f94..0000000
--- a/docs/license/index.html
+++ /dev/null
@@ -1,366 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>License - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../structure/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../faq/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/license.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#license" class="nav-link">License</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#boost-software-license" class="nav-link">Boost Software License</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="license">License</h1>
-<p>The SOCI library is distributed under the terms of the <a href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License</a>.</p>
-<h2 id="boost-software-license">Boost Software License</h2>
-<p>Version 1.0 - August 17th, 2003</p>
-<p>Permission is hereby granted, free of charge, to any person or organization
-obtaining a copy of the software and accompanying documentation covered by
-this license (the "Software") to use, reproduce, display, distribute,
-execute, and transmit the Software, and to prepare derivative works of the
-Software, and to permit third-parties to whom the Software is furnished to
-do so, all subject to the following:</p>
-<p>The copyright notices in the Software and this entire statement, including
-the above license grant, this restriction and the following disclaimer,
-must be included in all copies of the Software, in whole or in part, and
-all derivative works of the Software, unless such copies or derivative
-works are solely in the form of machine-executable object code generated by
-a source language processor.</p>
-<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
-SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
-FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
-ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/lobs.md b/docs/lobs.md
new file mode 100644
index 0000000..a627326
--- /dev/null
+++ b/docs/lobs.md
@@ -0,0 +1,71 @@
+# Large Objects (LOBs)
+
+## Binary (BLOBs)
+
+The SOCI library provides also an interface for basic operations on large objects (BLOBs - Binary Large OBjects).
+
+    blob b(sql); // sql is a session object
+    sql << "select mp3 from mymusic where id = 123", into(b);
+
+The following functions are provided in the `blob` interface, mimicking the file-like operations:
+
+* `std::size_t get_len();`
+* `std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0);`
+* `std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0);`
+* `std::size_t append(char const *buf, std::size_t toWrite);`
+* `void trim(std::size_t newLen);`
+
+The `offset` parameter is always counted from the beginning of the BLOB's data.
+
+### Portability notes
+
+* The way to define BLOB table columns and create or destroy BLOB objects in the database varies between different database engines.
+  Please see the SQL documentation relevant for the given server to learn how this is actually done. The test programs provided with the SOCI library can be also a simple source of full working examples.
+* The `trim` function is not currently available for the PostgreSQL backend.
+
+## Long strings and XML
+
+The SOCI library recognizes the fact that long string values are not handled portably and in some databases long string values need to be stored as a different data type.
+Similar concerns relate to the use of XML values, which are essentially strings at the application level, but can be stored in special database-level field types.
+
+In order to facilitate handling of long strings and XML values the following wrapper types are defined:
+
+    struct xml_type
+    {
+        std::string value;
+    };
+
+    struct long_string
+    {
+        std::string value;
+    };
+
+Values of these wrapper types can be used with `into` and `use` elements with the database target type that is specifically intended to handle XML and long strings data types.
+
+For Oracle, these database-side types are, respectively:
+
+* `XMLType`,
+* `CLOB`
+
+For PostgreSQL, these types are:
+
+* `XML`
+* `text`
+
+For Firebird, there is no special XML support, but `BLOB SUB_TYPE TEXT` can be
+used for storing it, as well as long strings.
+
+For ODBC backend, these types depend on the type of the database connected to.
+In particularly important special case of Microsoft SQL Server, these types
+are:
+
+* `xml`
+* `text`
+
+When using ODBC backend to connect to a PostgreSQL database, please be aware
+that by default PostgreSQL ODBC driver truncates all "unknown" types, such as
+XML, to maximal varchar type size which is just 256 bytes and so is often
+insufficient for XML values in practice. It is advised to set the
+`UnknownsAsLongVarchar` connection option to 1 to avoid truncating XML strings
+or use PostgreSQL ODBC driver 9.6.300 or later, which allows the backend to set
+this option to 1 automatically on connection.
diff --git a/docs/lobs/index.html b/docs/lobs/index.html
deleted file mode 100644
index fbaf018..0000000
--- a/docs/lobs/index.html
+++ /dev/null
@@ -1,409 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>LOBs - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../types/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../statements/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/lobs.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#large-objects-lobs" class="nav-link">Large Objects (LOBs)</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#binary-blobs" class="nav-link">Binary (BLOBs)</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#long-strings-and-xml" class="nav-link">Long strings and XML</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="large-objects-lobs">Large Objects (LOBs)</h1>
-<h2 id="binary-blobs">Binary (BLOBs)</h2>
-<p>The SOCI library provides also an interface for basic operations on large objects (BLOBs - Binary Large OBjects).</p>
-<pre><code>blob b(sql); // sql is a session object
-sql &lt;&lt; "select mp3 from mymusic where id = 123", into(b);
-</code></pre>
-<p>The following functions are provided in the <code>blob</code> interface, mimicking the file-like operations:</p>
-<ul>
-<li><code>std::size_t get_len();</code></li>
-<li><code>std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0);</code></li>
-<li><code>std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0);</code></li>
-<li><code>std::size_t append(char const *buf, std::size_t toWrite);</code></li>
-<li><code>void trim(std::size_t newLen);</code></li>
-</ul>
-<p>The <code>offset</code> parameter is always counted from the beginning of the BLOB's data.</p>
-<h3 id="portability-notes">Portability notes</h3>
-<ul>
-<li>The way to define BLOB table columns and create or destroy BLOB objects in the database varies between different database engines.
-  Please see the SQL documentation relevant for the given server to learn how this is actually done. The test programs provided with the SOCI library can be also a simple source of full working examples.</li>
-<li>The <code>trim</code> function is not currently available for the PostgreSQL backend.</li>
-</ul>
-<h2 id="long-strings-and-xml">Long strings and XML</h2>
-<p>The SOCI library recognizes the fact that long string values are not handled portably and in some databases long string values need to be stored as a different data type.
-Similar concerns relate to the use of XML values, which are essentially strings at the application level, but can be stored in special database-level field types.</p>
-<p>In order to facilitate handling of long strings and XML values the following wrapper types are defined:</p>
-<pre><code>struct xml_type
-{
-    std::string value;
-};
-
-struct long_string
-{
-    std::string value;
-};
-</code></pre>
-<p>Values of these wrapper types can be used with <code>into</code> and <code>use</code> elements with the database target type that is specifically intended to handle XML and long strings data types.</p>
-<p>For Oracle, these database-side types are, respectively:</p>
-<ul>
-<li><code>XMLType</code>,</li>
-<li><code>CLOB</code></li>
-</ul>
-<p>For PostgreSQL, these types are:</p>
-<ul>
-<li><code>XML</code></li>
-<li><code>text</code></li>
-</ul>
-<p>For Firebird, there is no special XML support, but <code>BLOB SUB_TYPE TEXT</code> can be
-used for storing it, as well as long strings.</p>
-<p>For ODBC backend, these types depend on the type of the database connected to.
-In particularly important special case of Microsoft SQL Server, these types
-are:</p>
-<ul>
-<li><code>xml</code></li>
-<li><code>text</code></li>
-</ul>
-<p>When using ODBC backend to connect to a PostgreSQL database, please be aware
-that by default PostgreSQL ODBC driver truncates all "unknown" types, such as
-XML, to maximal varchar type size which is just 256 bytes and so is often
-insufficient for XML values in practice. It is advised to set the
-<code>UnknownsAsLongVarchar</code> connection option to 1 to avoid truncating XML strings
-or use PostgreSQL ODBC driver 9.6.300 or later, which allows the backend to set
-this option to 1 automatically on connection.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/logging.md b/docs/logging.md
new file mode 100644
index 0000000..ca0a83a
--- /dev/null
+++ b/docs/logging.md
@@ -0,0 +1,59 @@
+# Logging
+
+SOCI provides a flexible, but requiring some effort to use, way to log all
+queries done by the library and a more limited but very simple way to do it.
+
+## Simple logging
+
+The following members of the `session` class support the basic logging functionality:
+
+* `void set_log_stream(std::ostream * s);`
+* `std::ostream * get_log_stream() const;`
+* `std::string get_last_query() const;`
+
+The first two functions allow to set the user-provided output stream object for logging.
+The `NULL` value, which is the default, means that there is no logging.
+
+An example use might be:
+
+    session sql(oracle, "...");
+
+    ofstream file("my_log.txt");
+    sql.set_log_stream(&file);
+
+    // ...
+
+Each statement logs its query string before the preparation step (whether explicit or implicit) and therefore logging is effective whether the query succeeds or not.
+Note that each prepared query is logged only once, independent on how many times it is executed.
+
+The `get_last_query` function allows to retrieve the last used query.
+
+## Flexible logging using custom loggers
+
+If the above is not enough, it is also possible to log the queries in exactly
+the way you want by deriving your own `my_log_impl` class from
+`soci::logger_impl` and implementing its pure virtual `start_query()` and
+`do_clone()` methods:
+
+    class my_log_impl : public soci::logger_impl
+    {
+    public:
+        virtual void start_query(std::string const & query)
+        {
+            ... log the given query ...
+        }
+
+    private:
+        virtual logger_impl* do_clone() const
+        {
+            return new my_log_impl(...);
+        }
+    };
+
+Then simply pass a new, heap-allocated instance of this class to the `session`
+object:
+
+    soci::session sql(...);
+    sql.set_logger(new my_log_impl(...));
+
+and `start_query()` method of the logger will be called for all queries.
diff --git a/docs/logging/index.html b/docs/logging/index.html
deleted file mode 100644
index 500ef4e..0000000
--- a/docs/logging/index.html
+++ /dev/null
@@ -1,396 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Logging - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../errors/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../interfaces/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/logging.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#logging" class="nav-link">Logging</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#simple-logging" class="nav-link">Simple logging</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#flexible-logging-using-custom-loggers" class="nav-link">Flexible logging using custom loggers</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="logging">Logging</h1>
-<p>SOCI provides a flexible, but requiring some effort to use, way to log all
-queries done by the library and a more limited but very simple way to do it.</p>
-<h2 id="simple-logging">Simple logging</h2>
-<p>The following members of the <code>session</code> class support the basic logging functionality:</p>
-<ul>
-<li><code>void set_log_stream(std::ostream * s);</code></li>
-<li><code>std::ostream * get_log_stream() const;</code></li>
-<li><code>std::string get_last_query() const;</code></li>
-</ul>
-<p>The first two functions allow to set the user-provided output stream object for logging.
-The <code>NULL</code> value, which is the default, means that there is no logging.</p>
-<p>An example use might be:</p>
-<pre><code>session sql(oracle, "...");
-
-ofstream file("my_log.txt");
-sql.set_log_stream(&amp;file);
-
-// ...
-</code></pre>
-<p>Each statement logs its query string before the preparation step (whether explicit or implicit) and therefore logging is effective whether the query succeeds or not.
-Note that each prepared query is logged only once, independent on how many times it is executed.</p>
-<p>The <code>get_last_query</code> function allows to retrieve the last used query.</p>
-<h2 id="flexible-logging-using-custom-loggers">Flexible logging using custom loggers</h2>
-<p>If the above is not enough, it is also possible to log the queries in exactly
-the way you want by deriving your own <code>my_log_impl</code> class from
-<code>soci::logger_impl</code> and implementing its pure virtual <code>start_query()</code> and
-<code>do_clone()</code> methods:</p>
-<pre><code>class my_log_impl : public soci::logger_impl
-{
-public:
-    virtual void start_query(std::string const &amp; query)
-    {
-        ... log the given query ...
-    }
-
-private:
-    virtual logger_impl* do_clone() const
-    {
-        return new my_log_impl(...);
-    }
-};
-</code></pre>
-<p>Then simply pass a new, heap-allocated instance of this class to the <code>session</code>
-object:</p>
-<pre><code>soci::session sql(...);
-sql.set_logger(new my_log_impl(...));
-</code></pre>
-<p>and <code>start_query()</code> method of the logger will be called for all queries.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/multithreading.md b/docs/multithreading.md
new file mode 100644
index 0000000..757f3ff
--- /dev/null
+++ b/docs/multithreading.md
@@ -0,0 +1,47 @@
+# Multithreading
+
+The general rule for multithreading is that SOCI classes are *not* thread-safe, meaning that their instances should not be used concurrently by multiple threads.
+
+The simplest solution for multithreaded code is to set up a separate `session` object for each thread that needs to inteact with the database.
+Depending on the design of the client application this might be also the most straightforward approach.
+
+For some applications, however, it might be preferable to decouple the set of threads from the set of sessions, so that they can be optimized separately with different resources in mind.
+The `connection_pool` class is provided for this purpose:
+
+```cpp
+// phase 1: preparation
+
+const size_t poolSize = 10;
+connection_pool pool(poolSize);
+
+for (size_t i = 0; i != poolSize; ++i)
+{
+    session & sql = pool.at(i);
+
+    sql.open("postgresql://dbname=mydb");
+}
+
+// phase 2: usage from working threads
+
+{
+    session sql(pool);
+
+    sql << "select something from somewhere...";
+
+} // session is returned to the pool automatically
+```
+
+The `connection_pool`'s constructor expects the size of the pool and internally creates an array of `session`s in the disconnected state.
+Later, the `at` function provides *non-synchronized* access to each element of the array.
+Note that this function is *not* thread-safe and exists only to make it easier to set up the pool in the initialization phase.
+
+Note that it is not obligatory to use the same connection parameters for all sessions in the pool, although this will be most likely the usual case.
+
+The working threads that need to *lease* a single session from the pool use the dedicated constructor of the `session` class - this constructor blocks until some session object becomes available in the pool and attaches to it, so that all further uses will be forwarded to the `session` object managed by the pool.
+As long as the local `session` object exists, the associated session in the pool is *locked* and no other thread will gain access to it.
+When the local `session` variable goes out of scope, the related entry in the pool's internal array is released, so that it can be used by other threads.
+This way, the connection pool guarantees that its session objects are never used by more than one thread at a time.
+
+Note that the above scheme is the simplest way to use the connection pool, but it is also constraining in the fact that the `session`'s constructor can *block* waiting for the availability of some entry in the pool.
+For more demanding users there are also low-level functions that allow to lease sessions from the pool with timeout on wait.
+Please consult the [reference](api/client.md) for details.
diff --git a/docs/multithreading/index.html b/docs/multithreading/index.html
deleted file mode 100644
index 4dbda6a..0000000
--- a/docs/multithreading/index.html
+++ /dev/null
@@ -1,377 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Multi-threading - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../beyond/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../boost/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/multithreading.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#multithreading" class="nav-link">Multithreading</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="multithreading">Multithreading</h1>
-<p>The general rule for multithreading is that SOCI classes are <em>not</em> thread-safe, meaning that their instances should not be used concurrently by multiple threads.</p>
-<p>The simplest solution for multithreaded code is to set up a separate <code>session</code> object for each thread that needs to inteact with the database.
-Depending on the design of the client application this might be also the most straightforward approach.</p>
-<p>For some applications, however, it might be preferable to decouple the set of threads from the set of sessions, so that they can be optimized separately with different resources in mind.
-The <code>connection_pool</code> class is provided for this purpose:</p>
-<pre><code class="language-cpp">// phase 1: preparation
-
-const size_t poolSize = 10;
-connection_pool pool(poolSize);
-
-for (size_t i = 0; i != poolSize; ++i)
-{
-    session &amp; sql = pool.at(i);
-
-    sql.open(&quot;postgresql://dbname=mydb&quot;);
-}
-
-// phase 2: usage from working threads
-
-{
-    session sql(pool);
-
-    sql &lt;&lt; &quot;select something from somewhere...&quot;;
-
-} // session is returned to the pool automatically
-</code></pre>
-<p>The <code>connection_pool</code>'s constructor expects the size of the pool and internally creates an array of <code>session</code>s in the disconnected state.
-Later, the <code>at</code> function provides <em>non-synchronized</em> access to each element of the array.
-Note that this function is <em>not</em> thread-safe and exists only to make it easier to set up the pool in the initialization phase.</p>
-<p>Note that it is not obligatory to use the same connection parameters for all sessions in the pool, although this will be most likely the usual case.</p>
-<p>The working threads that need to <em>lease</em> a single session from the pool use the dedicated constructor of the <code>session</code> class - this constructor blocks until some session object becomes available in the pool and attaches to it, so that all further uses will be forwarded to the <code>session</code> object managed by the pool.
-As long as the local <code>session</code> object exists, the associated session in the pool is <em>locked</em> and no other thread will gain access to it.
-When the local <code>session</code> variable goes out of scope, the related entry in the pool's internal array is released, so that it can be used by other threads.
-This way, the connection pool guarantees that its session objects are never used by more than one thread at a time.</p>
-<p>Note that the above scheme is the simplest way to use the connection pool, but it is also constraining in the fact that the <code>session</code>'s constructor can <em>block</em> waiting for the availability of some entry in the pool.
-For more demanding users there are also low-level functions that allow to lease sessions from the pool with timeout on wait.
-Please consult the <a href="../api/client/">reference</a> for details.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/procedures.md b/docs/procedures.md
new file mode 100644
index 0000000..b7473b9
--- /dev/null
+++ b/docs/procedures.md
@@ -0,0 +1,20 @@
+# Stored Procedures
+
+The `procedure` class provides a convenient mechanism for calling stored procedures:
+
+```cpp
+sql << "create or replace procedure echo(output out varchar2,"
+        "input in varchar2) as "
+        "begin output := input; end;";
+
+std::string in("my message");
+std::string out;
+procedure proc = (sql.prepare << "echo(:output, :input)", use(out, "output"), use(in, "input"));
+proc.execute(true);
+assert(out == "my message");
+```
+
+## Portability note
+
+The above way of calling stored procedures is provided for portability of the code that might need it.
+It is of course still possible to call procedures or functions using the syntax supported by the given database server.
diff --git a/docs/procedures/index.html b/docs/procedures/index.html
deleted file mode 100644
index d85f244..0000000
--- a/docs/procedures/index.html
+++ /dev/null
@@ -1,358 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Procedures - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../transactions/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../errors/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/procedures.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#stored-procedures" class="nav-link">Stored Procedures</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#portability-note" class="nav-link">Portability note</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="stored-procedures">Stored Procedures</h1>
-<p>The <code>procedure</code> class provides a convenient mechanism for calling stored procedures:</p>
-<pre><code class="language-cpp">sql &lt;&lt; &quot;create or replace procedure echo(output out varchar2,&quot;
-        &quot;input in varchar2) as &quot;
-        &quot;begin output := input; end;&quot;;
-
-std::string in(&quot;my message&quot;);
-std::string out;
-procedure proc = (sql.prepare &lt;&lt; &quot;echo(:output, :input)&quot;, use(out, &quot;output&quot;), use(in, &quot;input&quot;));
-proc.execute(true);
-assert(out == &quot;my message&quot;);
-</code></pre>
-<h2 id="portability-note">Portability note</h2>
-<p>The above way of calling stored procedures is provided for portability of the code that might need it.
-It is of course still possible to call procedures or functions using the syntax supported by the given database server.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/queries.md b/docs/queries.md
new file mode 100644
index 0000000..1ed437a
--- /dev/null
+++ b/docs/queries.md
@@ -0,0 +1,94 @@
+# Queries
+
+## Simple SQL statements
+
+In many cases, the SQL query is intended to be executed only once, which means that statement parsing and execution can go together. The `session` class provides a special `once` member, which triggers parsing and execution of such one-time statements:
+
+```cpp
+sql.once << "drop table persons";
+```
+
+For shorter syntax, the following form is also allowed:
+
+```cpp
+sql << "drop table persons";
+```
+
+The IOStream-like interface is exactly what it looks like, so that the statement text can be composed of many parts, involving anything that is *streamable* (including custom classes, if they have appropriate `operator<<`):
+
+```cpp
+string tableName = "persons";
+sql << "drop table " << tableName;
+
+int id = 123;
+sql << "delete from companies where id = " << id;
+```
+
+## Query transformation
+
+In SOCI 3.2.0, query transformation mechanism was introduced.
+
+Query transformation is specified as user-defined unary function or callable function object with input parameter of type `std::string` which returns object of type `std::string` as well.
+
+The query transformation function is registered for current database session using dedicated `session::set_query_transformation` method. Then, the transformation function is called with query string as argument just before the query is sent to database backend for execution or for preparation.
+
+For one-time statements, query transformation is performed before each execution of statement. For prepared statements, query is transformed only once, before preparation, regardless how many times it is executed.
+
+A few short examples how to use query transformation:
+
+* defined as free function:
+
+```cpp
+std::string less_than_ten(std::string query)
+{
+    return query + " WHERE price < 10";
+}
+
+session sql(postgresql, "dbname=mydb");
+sql.set_query_transformation(less_than_ten);
+sql << "DELETE FROM item";
+```
+
+* defined as function object:
+
+```cpp
+struct order
+{
+    order(std::string const& by) : by_(by) {}
+
+    std::string operator()(std::string const& query) const
+    {
+        return query + " ORDER BY " + by_;
+    }
+
+    std::string by_;
+};
+
+char const* query = "SELECT * FROM product";
+sql.set_query_transformation(order("price"));
+sql << query;
+sql.set_query_transformation(order("id"));
+sql << query;
+```
+
+* defined as lambda function (since C++11):
+
+```cpp
+std::string dep = "sales";
+sql.set_query_transformation(
+    [&dep](std::string const& query) {
+        return query + " WHERE department = '" + dep + "'";
+});
+sql << "SELECT * FROM employee";
+```
+
+Query transformations enable users with simple mechanism to apply extra requirements to or interact with SQL statement being executed and that is without changing the SQL statement itself which may be passed from different
+parts of application.
+
+For example, the query transformation may be used to:
+
+* modify or add clauses of SQL statements (i.e. `WHERE` clause with new condition)
+* prefix table names with new schema to allow namespaces switch
+* validate SQL statements
+* perform sanitization checking for any unverified input
+* apply database-specific features like add optimization hints to SQL statements (i.e. `SELECT /*+RULE*/ A FROM C` in Oracle 9)
diff --git a/docs/queries/index.html b/docs/queries/index.html
deleted file mode 100644
index 3490357..0000000
--- a/docs/queries/index.html
+++ /dev/null
@@ -1,421 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Queries - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../connections/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../binding/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/queries.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#queries" class="nav-link">Queries</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#simple-sql-statements" class="nav-link">Simple SQL statements</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#query-transformation" class="nav-link">Query transformation</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="queries">Queries</h1>
-<h2 id="simple-sql-statements">Simple SQL statements</h2>
-<p>In many cases, the SQL query is intended to be executed only once, which means that statement parsing and execution can go together. The <code>session</code> class provides a special <code>once</code> member, which triggers parsing and execution of such one-time statements:</p>
-<pre><code class="language-cpp">sql.once &lt;&lt; &quot;drop table persons&quot;;
-</code></pre>
-<p>For shorter syntax, the following form is also allowed:</p>
-<pre><code class="language-cpp">sql &lt;&lt; &quot;drop table persons&quot;;
-</code></pre>
-<p>The IOStream-like interface is exactly what it looks like, so that the statement text can be composed of many parts, involving anything that is <em>streamable</em> (including custom classes, if they have appropriate <code>operator&lt;&lt;</code>):</p>
-<pre><code class="language-cpp">string tableName = &quot;persons&quot;;
-sql &lt;&lt; &quot;drop table &quot; &lt;&lt; tableName;
-
-int id = 123;
-sql &lt;&lt; &quot;delete from companies where id = &quot; &lt;&lt; id;
-</code></pre>
-<h2 id="query-transformation">Query transformation</h2>
-<p>In SOCI 3.2.0, query transformation mechanism was introduced.</p>
-<p>Query transformation is specified as user-defined unary function or callable function object with input parameter of type <code>std::string</code> which returns object of type <code>std::string</code> as well.</p>
-<p>The query transformation function is registered for current database session using dedicated <code>session::set_query_transformation</code> method. Then, the transformation function is called with query string as argument just before the query is sent to database backend for execution or for preparation.</p>
-<p>For one-time statements, query transformation is performed before each execution of statement. For prepared statements, query is transformed only once, before preparation, regardless how many times it is executed.</p>
-<p>A few short examples how to use query transformation:</p>
-<ul>
-<li>defined as free function:</li>
-</ul>
-<pre><code class="language-cpp">std::string less_than_ten(std::string query)
-{
-    return query + &quot; WHERE price &lt; 10&quot;;
-}
-
-session sql(postgresql, &quot;dbname=mydb&quot;);
-sql.set_query_transformation(less_than_ten);
-sql &lt;&lt; &quot;DELETE FROM item&quot;;
-</code></pre>
-<ul>
-<li>defined as function object:</li>
-</ul>
-<pre><code class="language-cpp">struct order
-{
-    order(std::string const&amp; by) : by_(by) {}
-
-    std::string operator()(std::string const&amp; query) const
-    {
-        return query + &quot; ORDER BY &quot; + by_;
-    }
-
-    std::string by_;
-};
-
-char const* query = &quot;SELECT * FROM product&quot;;
-sql.set_query_transformation(order(&quot;price&quot;));
-sql &lt;&lt; query;
-sql.set_query_transformation(order(&quot;id&quot;));
-sql &lt;&lt; query;
-</code></pre>
-<ul>
-<li>defined as lambda function (since C++11):</li>
-</ul>
-<pre><code class="language-cpp">std::string dep = &quot;sales&quot;;
-sql.set_query_transformation(
-    [&amp;dep](std::string const&amp; query) {
-        return query + &quot; WHERE department = '&quot; + dep + &quot;'&quot;;
-});
-sql &lt;&lt; &quot;SELECT * FROM employee&quot;;
-</code></pre>
-<p>Query transformations enable users with simple mechanism to apply extra requirements to or interact with SQL statement being executed and that is without changing the SQL statement itself which may be passed from different
-parts of application.</p>
-<p>For example, the query transformation may be used to:</p>
-<ul>
-<li>modify or add clauses of SQL statements (i.e. <code>WHERE</code> clause with new condition)</li>
-<li>prefix table names with new schema to allow namespaces switch</li>
-<li>validate SQL statements</li>
-<li>perform sanitization checking for any unverified input</li>
-<li>apply database-specific features like add optimization hints to SQL statements (i.e. <code>SELECT /*+RULE*/ A FROM C</code> in Oracle 9)</li>
-</ul></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/quickstart.md b/docs/quickstart.md
new file mode 100644
index 0000000..4d03348
--- /dev/null
+++ b/docs/quickstart.md
@@ -0,0 +1,56 @@
+# Quickstart
+
+The following (complete!) example is purposedly provided without any explanation.
+
+```cpp
+#include "soci.h"
+#include "soci-oracle.h"
+#include <iostream>
+#include <istream>
+#include <ostream>
+#include <string>
+#include <exception>
+
+using namespace soci;
+using namespace std;
+
+bool get_name(string &name) {
+    cout << "Enter name: ";
+    return cin >> name;
+}
+
+int main()
+{
+    try
+    {
+        session sql(oracle, "service=mydb user=john password=secret");
+
+        int count;
+        sql << "select count(*) from phonebook", into(count);
+
+        cout << "We have " << count << " entries in the phonebook.\n";
+
+        string name;
+        while (get_name(name))
+        {
+            string phone;
+            indicator ind;
+            sql << "select phone from phonebook where name = :name",
+                into(phone, ind), use(name);
+
+            if (ind == i_ok)
+            {
+                cout << "The phone number is " << phone << '\n';
+            }
+            else
+            {
+                cout << "There is no phone for " << name << '\n';
+            }
+        }
+    }
+    catch (exception const &e)
+    {
+        cerr << "Error: " << e.what() << '\n';
+    }
+}
+```
diff --git a/docs/quickstart/index.html b/docs/quickstart/index.html
deleted file mode 100644
index f9e50fa..0000000
--- a/docs/quickstart/index.html
+++ /dev/null
@@ -1,392 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Getting Started - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href=".." class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../installation/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/quickstart.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#quickstart" class="nav-link">Quickstart</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="quickstart">Quickstart</h1>
-<p>The following (complete!) example is purposedly provided without any explanation.</p>
-<pre><code class="language-cpp">#include &quot;soci.h&quot;
-#include &quot;soci-oracle.h&quot;
-#include &lt;iostream&gt;
-#include &lt;istream&gt;
-#include &lt;ostream&gt;
-#include &lt;string&gt;
-#include &lt;exception&gt;
-
-using namespace soci;
-using namespace std;
-
-bool get_name(string &amp;name) {
-    cout &lt;&lt; &quot;Enter name: &quot;;
-    return cin &gt;&gt; name;
-}
-
-int main()
-{
-    try
-    {
-        session sql(oracle, &quot;service=mydb user=john password=secret&quot;);
-
-        int count;
-        sql &lt;&lt; &quot;select count(*) from phonebook&quot;, into(count);
-
-        cout &lt;&lt; &quot;We have &quot; &lt;&lt; count &lt;&lt; &quot; entries in the phonebook.\n&quot;;
-
-        string name;
-        while (get_name(name))
-        {
-            string phone;
-            indicator ind;
-            sql &lt;&lt; &quot;select phone from phonebook where name = :name&quot;,
-                into(phone, ind), use(name);
-
-            if (ind == i_ok)
-            {
-                cout &lt;&lt; &quot;The phone number is &quot; &lt;&lt; phone &lt;&lt; '\n';
-            }
-            else
-            {
-                cout &lt;&lt; &quot;There is no phone for &quot; &lt;&lt; name &lt;&lt; '\n';
-            }
-        }
-    }
-    catch (exception const &amp;e)
-    {
-        cerr &lt;&lt; &quot;Error: &quot; &lt;&lt; e.what() &lt;&lt; '\n';
-    }
-}
-</code></pre></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/search/lunr.js b/docs/search/lunr.js
deleted file mode 100644
index 6aa370f..0000000
--- a/docs/search/lunr.js
+++ /dev/null
@@ -1,3475 +0,0 @@
-/**
- * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9
- * Copyright (C) 2020 Oliver Nightingale
- * @license MIT
- */
-
-;(function(){
-
-/**
- * A convenience function for configuring and constructing
- * a new lunr Index.
- *
- * A lunr.Builder instance is created and the pipeline setup
- * with a trimmer, stop word filter and stemmer.
- *
- * This builder object is yielded to the configuration function
- * that is passed as a parameter, allowing the list of fields
- * and other builder parameters to be customised.
- *
- * All documents _must_ be added within the passed config function.
- *
- * @example
- * var idx = lunr(function () {
- *   this.field('title')
- *   this.field('body')
- *   this.ref('id')
- *
- *   documents.forEach(function (doc) {
- *     this.add(doc)
- *   }, this)
- * })
- *
- * @see {@link lunr.Builder}
- * @see {@link lunr.Pipeline}
- * @see {@link lunr.trimmer}
- * @see {@link lunr.stopWordFilter}
- * @see {@link lunr.stemmer}
- * @namespace {function} lunr
- */
-var lunr = function (config) {
-  var builder = new lunr.Builder
-
-  builder.pipeline.add(
-    lunr.trimmer,
-    lunr.stopWordFilter,
-    lunr.stemmer
-  )
-
-  builder.searchPipeline.add(
-    lunr.stemmer
-  )
-
-  config.call(builder, builder)
-  return builder.build()
-}
-
-lunr.version = "2.3.9"
-/*!
- * lunr.utils
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * A namespace containing utils for the rest of the lunr library
- * @namespace lunr.utils
- */
-lunr.utils = {}
-
-/**
- * Print a warning message to the console.
- *
- * @param {String} message The message to be printed.
- * @memberOf lunr.utils
- * @function
- */
-lunr.utils.warn = (function (global) {
-  /* eslint-disable no-console */
-  return function (message) {
-    if (global.console && console.warn) {
-      console.warn(message)
-    }
-  }
-  /* eslint-enable no-console */
-})(this)
-
-/**
- * Convert an object to a string.
- *
- * In the case of `null` and `undefined` the function returns
- * the empty string, in all other cases the result of calling
- * `toString` on the passed object is returned.
- *
- * @param {Any} obj The object to convert to a string.
- * @return {String} string representation of the passed object.
- * @memberOf lunr.utils
- */
-lunr.utils.asString = function (obj) {
-  if (obj === void 0 || obj === null) {
-    return ""
-  } else {
-    return obj.toString()
-  }
-}
-
-/**
- * Clones an object.
- *
- * Will create a copy of an existing object such that any mutations
- * on the copy cannot affect the original.
- *
- * Only shallow objects are supported, passing a nested object to this
- * function will cause a TypeError.
- *
- * Objects with primitives, and arrays of primitives are supported.
- *
- * @param {Object} obj The object to clone.
- * @return {Object} a clone of the passed object.
- * @throws {TypeError} when a nested object is passed.
- * @memberOf Utils
- */
-lunr.utils.clone = function (obj) {
-  if (obj === null || obj === undefined) {
-    return obj
-  }
-
-  var clone = Object.create(null),
-      keys = Object.keys(obj)
-
-  for (var i = 0; i < keys.length; i++) {
-    var key = keys[i],
-        val = obj[key]
-
-    if (Array.isArray(val)) {
-      clone[key] = val.slice()
-      continue
-    }
-
-    if (typeof val === 'string' ||
-        typeof val === 'number' ||
-        typeof val === 'boolean') {
-      clone[key] = val
-      continue
-    }
-
-    throw new TypeError("clone is not deep and does not support nested objects")
-  }
-
-  return clone
-}
-lunr.FieldRef = function (docRef, fieldName, stringValue) {
-  this.docRef = docRef
-  this.fieldName = fieldName
-  this._stringValue = stringValue
-}
-
-lunr.FieldRef.joiner = "/"
-
-lunr.FieldRef.fromString = function (s) {
-  var n = s.indexOf(lunr.FieldRef.joiner)
-
-  if (n === -1) {
-    throw "malformed field ref string"
-  }
-
-  var fieldRef = s.slice(0, n),
-      docRef = s.slice(n + 1)
-
-  return new lunr.FieldRef (docRef, fieldRef, s)
-}
-
-lunr.FieldRef.prototype.toString = function () {
-  if (this._stringValue == undefined) {
-    this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef
-  }
-
-  return this._stringValue
-}
-/*!
- * lunr.Set
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * A lunr set.
- *
- * @constructor
- */
-lunr.Set = function (elements) {
-  this.elements = Object.create(null)
-
-  if (elements) {
-    this.length = elements.length
-
-    for (var i = 0; i < this.length; i++) {
-      this.elements[elements[i]] = true
-    }
-  } else {
-    this.length = 0
-  }
-}
-
-/**
- * A complete set that contains all elements.
- *
- * @static
- * @readonly
- * @type {lunr.Set}
- */
-lunr.Set.complete = {
-  intersect: function (other) {
-    return other
-  },
-
-  union: function () {
-    return this
-  },
-
-  contains: function () {
-    return true
-  }
-}
-
-/**
- * An empty set that contains no elements.
- *
- * @static
- * @readonly
- * @type {lunr.Set}
- */
-lunr.Set.empty = {
-  intersect: function () {
-    return this
-  },
-
-  union: function (other) {
-    return other
-  },
-
-  contains: function () {
-    return false
-  }
-}
-
-/**
- * Returns true if this set contains the specified object.
- *
- * @param {object} object - Object whose presence in this set is to be tested.
- * @returns {boolean} - True if this set contains the specified object.
- */
-lunr.Set.prototype.contains = function (object) {
-  return !!this.elements[object]
-}
-
-/**
- * Returns a new set containing only the elements that are present in both
- * this set and the specified set.
- *
- * @param {lunr.Set} other - set to intersect with this set.
- * @returns {lunr.Set} a new set that is the intersection of this and the specified set.
- */
-
-lunr.Set.prototype.intersect = function (other) {
-  var a, b, elements, intersection = []
-
-  if (other === lunr.Set.complete) {
-    return this
-  }
-
-  if (other === lunr.Set.empty) {
-    return other
-  }
-
-  if (this.length < other.length) {
-    a = this
-    b = other
-  } else {
-    a = other
-    b = this
-  }
-
-  elements = Object.keys(a.elements)
-
-  for (var i = 0; i < elements.length; i++) {
-    var element = elements[i]
-    if (element in b.elements) {
-      intersection.push(element)
-    }
-  }
-
-  return new lunr.Set (intersection)
-}
-
-/**
- * Returns a new set combining the elements of this and the specified set.
- *
- * @param {lunr.Set} other - set to union with this set.
- * @return {lunr.Set} a new set that is the union of this and the specified set.
- */
-
-lunr.Set.prototype.union = function (other) {
-  if (other === lunr.Set.complete) {
-    return lunr.Set.complete
-  }
-
-  if (other === lunr.Set.empty) {
-    return this
-  }
-
-  return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements)))
-}
-/**
- * A function to calculate the inverse document frequency for
- * a posting. This is shared between the builder and the index
- *
- * @private
- * @param {object} posting - The posting for a given term
- * @param {number} documentCount - The total number of documents.
- */
-lunr.idf = function (posting, documentCount) {
-  var documentsWithTerm = 0
-
-  for (var fieldName in posting) {
-    if (fieldName == '_index') continue // Ignore the term index, its not a field
-    documentsWithTerm += Object.keys(posting[fieldName]).length
-  }
-
-  var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5)
-
-  return Math.log(1 + Math.abs(x))
-}
-
-/**
- * A token wraps a string representation of a token
- * as it is passed through the text processing pipeline.
- *
- * @constructor
- * @param {string} [str=''] - The string token being wrapped.
- * @param {object} [metadata={}] - Metadata associated with this token.
- */
-lunr.Token = function (str, metadata) {
-  this.str = str || ""
-  this.metadata = metadata || {}
-}
-
-/**
- * Returns the token string that is being wrapped by this object.
- *
- * @returns {string}
- */
-lunr.Token.prototype.toString = function () {
-  return this.str
-}
-
-/**
- * A token update function is used when updating or optionally
- * when cloning a token.
- *
- * @callback lunr.Token~updateFunction
- * @param {string} str - The string representation of the token.
- * @param {Object} metadata - All metadata associated with this token.
- */
-
-/**
- * Applies the given function to the wrapped string token.
- *
- * @example
- * token.update(function (str, metadata) {
- *   return str.toUpperCase()
- * })
- *
- * @param {lunr.Token~updateFunction} fn - A function to apply to the token string.
- * @returns {lunr.Token}
- */
-lunr.Token.prototype.update = function (fn) {
-  this.str = fn(this.str, this.metadata)
-  return this
-}
-
-/**
- * Creates a clone of this token. Optionally a function can be
- * applied to the cloned token.
- *
- * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token.
- * @returns {lunr.Token}
- */
-lunr.Token.prototype.clone = function (fn) {
-  fn = fn || function (s) { return s }
-  return new lunr.Token (fn(this.str, this.metadata), this.metadata)
-}
-/*!
- * lunr.tokenizer
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * A function for splitting a string into tokens ready to be inserted into
- * the search index. Uses `lunr.tokenizer.separator` to split strings, change
- * the value of this property to change how strings are split into tokens.
- *
- * This tokenizer will convert its parameter to a string by calling `toString` and
- * then will split this string on the character in `lunr.tokenizer.separator`.
- * Arrays will have their elements converted to strings and wrapped in a lunr.Token.
- *
- * Optional metadata can be passed to the tokenizer, this metadata will be cloned and
- * added as metadata to every token that is created from the object to be tokenized.
- *
- * @static
- * @param {?(string|object|object[])} obj - The object to convert into tokens
- * @param {?object} metadata - Optional metadata to associate with every token
- * @returns {lunr.Token[]}
- * @see {@link lunr.Pipeline}
- */
-lunr.tokenizer = function (obj, metadata) {
-  if (obj == null || obj == undefined) {
-    return []
-  }
-
-  if (Array.isArray(obj)) {
-    return obj.map(function (t) {
-      return new lunr.Token(
-        lunr.utils.asString(t).toLowerCase(),
-        lunr.utils.clone(metadata)
-      )
-    })
-  }
-
-  var str = obj.toString().toLowerCase(),
-      len = str.length,
-      tokens = []
-
-  for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {
-    var char = str.charAt(sliceEnd),
-        sliceLength = sliceEnd - sliceStart
-
-    if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) {
-
-      if (sliceLength > 0) {
-        var tokenMetadata = lunr.utils.clone(metadata) || {}
-        tokenMetadata["position"] = [sliceStart, sliceLength]
-        tokenMetadata["index"] = tokens.length
-
-        tokens.push(
-          new lunr.Token (
-            str.slice(sliceStart, sliceEnd),
-            tokenMetadata
-          )
-        )
-      }
-
-      sliceStart = sliceEnd + 1
-    }
-
-  }
-
-  return tokens
-}
-
-/**
- * The separator used to split a string into tokens. Override this property to change the behaviour of
- * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens.
- *
- * @static
- * @see lunr.tokenizer
- */
-lunr.tokenizer.separator = /[\s\-]+/
-/*!
- * lunr.Pipeline
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * lunr.Pipelines maintain an ordered list of functions to be applied to all
- * tokens in documents entering the search index and queries being ran against
- * the index.
- *
- * An instance of lunr.Index created with the lunr shortcut will contain a
- * pipeline with a stop word filter and an English language stemmer. Extra
- * functions can be added before or after either of these functions or these
- * default functions can be removed.
- *
- * When run the pipeline will call each function in turn, passing a token, the
- * index of that token in the original list of all tokens and finally a list of
- * all the original tokens.
- *
- * The output of functions in the pipeline will be passed to the next function
- * in the pipeline. To exclude a token from entering the index the function
- * should return undefined, the rest of the pipeline will not be called with
- * this token.
- *
- * For serialisation of pipelines to work, all functions used in an instance of
- * a pipeline should be registered with lunr.Pipeline. Registered functions can
- * then be loaded. If trying to load a serialised pipeline that uses functions
- * that are not registered an error will be thrown.
- *
- * If not planning on serialising the pipeline then registering pipeline functions
- * is not necessary.
- *
- * @constructor
- */
-lunr.Pipeline = function () {
-  this._stack = []
-}
-
-lunr.Pipeline.registeredFunctions = Object.create(null)
-
-/**
- * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token
- * string as well as all known metadata. A pipeline function can mutate the token string
- * or mutate (or add) metadata for a given token.
- *
- * A pipeline function can indicate that the passed token should be discarded by returning
- * null, undefined or an empty string. This token will not be passed to any downstream pipeline
- * functions and will not be added to the index.
- *
- * Multiple tokens can be returned by returning an array of tokens. Each token will be passed
- * to any downstream pipeline functions and all will returned tokens will be added to the index.
- *
- * Any number of pipeline functions may be chained together using a lunr.Pipeline.
- *
- * @interface lunr.PipelineFunction
- * @param {lunr.Token} token - A token from the document being processed.
- * @param {number} i - The index of this token in the complete list of tokens for this document/field.
- * @param {lunr.Token[]} tokens - All tokens for this document/field.
- * @returns {(?lunr.Token|lunr.Token[])}
- */
-
-/**
- * Register a function with the pipeline.
- *
- * Functions that are used in the pipeline should be registered if the pipeline
- * needs to be serialised, or a serialised pipeline needs to be loaded.
- *
- * Registering a function does not add it to a pipeline, functions must still be
- * added to instances of the pipeline for them to be used when running a pipeline.
- *
- * @param {lunr.PipelineFunction} fn - The function to check for.
- * @param {String} label - The label to register this function with
- */
-lunr.Pipeline.registerFunction = function (fn, label) {
-  if (label in this.registeredFunctions) {
-    lunr.utils.warn('Overwriting existing registered function: ' + label)
-  }
-
-  fn.label = label
-  lunr.Pipeline.registeredFunctions[fn.label] = fn
-}
-
-/**
- * Warns if the function is not registered as a Pipeline function.
- *
- * @param {lunr.PipelineFunction} fn - The function to check for.
- * @private
- */
-lunr.Pipeline.warnIfFunctionNotRegistered = function (fn) {
-  var isRegistered = fn.label && (fn.label in this.registeredFunctions)
-
-  if (!isRegistered) {
-    lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\n', fn)
-  }
-}
-
-/**
- * Loads a previously serialised pipeline.
- *
- * All functions to be loaded must already be registered with lunr.Pipeline.
- * If any function from the serialised data has not been registered then an
- * error will be thrown.
- *
- * @param {Object} serialised - The serialised pipeline to load.
- * @returns {lunr.Pipeline}
- */
-lunr.Pipeline.load = function (serialised) {
-  var pipeline = new lunr.Pipeline
-
-  serialised.forEach(function (fnName) {
-    var fn = lunr.Pipeline.registeredFunctions[fnName]
-
-    if (fn) {
-      pipeline.add(fn)
-    } else {
-      throw new Error('Cannot load unregistered function: ' + fnName)
-    }
-  })
-
-  return pipeline
-}
-
-/**
- * Adds new functions to the end of the pipeline.
- *
- * Logs a warning if the function has not been registered.
- *
- * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline.
- */
-lunr.Pipeline.prototype.add = function () {
-  var fns = Array.prototype.slice.call(arguments)
-
-  fns.forEach(function (fn) {
-    lunr.Pipeline.warnIfFunctionNotRegistered(fn)
-    this._stack.push(fn)
-  }, this)
-}
-
-/**
- * Adds a single function after a function that already exists in the
- * pipeline.
- *
- * Logs a warning if the function has not been registered.
- *
- * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.
- * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.
- */
-lunr.Pipeline.prototype.after = function (existingFn, newFn) {
-  lunr.Pipeline.warnIfFunctionNotRegistered(newFn)
-
-  var pos = this._stack.indexOf(existingFn)
-  if (pos == -1) {
-    throw new Error('Cannot find existingFn')
-  }
-
-  pos = pos + 1
-  this._stack.splice(pos, 0, newFn)
-}
-
-/**
- * Adds a single function before a function that already exists in the
- * pipeline.
- *
- * Logs a warning if the function has not been registered.
- *
- * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.
- * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.
- */
-lunr.Pipeline.prototype.before = function (existingFn, newFn) {
-  lunr.Pipeline.warnIfFunctionNotRegistered(newFn)
-
-  var pos = this._stack.indexOf(existingFn)
-  if (pos == -1) {
-    throw new Error('Cannot find existingFn')
-  }
-
-  this._stack.splice(pos, 0, newFn)
-}
-
-/**
- * Removes a function from the pipeline.
- *
- * @param {lunr.PipelineFunction} fn The function to remove from the pipeline.
- */
-lunr.Pipeline.prototype.remove = function (fn) {
-  var pos = this._stack.indexOf(fn)
-  if (pos == -1) {
-    return
-  }
-
-  this._stack.splice(pos, 1)
-}
-
-/**
- * Runs the current list of functions that make up the pipeline against the
- * passed tokens.
- *
- * @param {Array} tokens The tokens to run through the pipeline.
- * @returns {Array}
- */
-lunr.Pipeline.prototype.run = function (tokens) {
-  var stackLength = this._stack.length
-
-  for (var i = 0; i < stackLength; i++) {
-    var fn = this._stack[i]
-    var memo = []
-
-    for (var j = 0; j < tokens.length; j++) {
-      var result = fn(tokens[j], j, tokens)
-
-      if (result === null || result === void 0 || result === '') continue
-
-      if (Array.isArray(result)) {
-        for (var k = 0; k < result.length; k++) {
-          memo.push(result[k])
-        }
-      } else {
-        memo.push(result)
-      }
-    }
-
-    tokens = memo
-  }
-
-  return tokens
-}
-
-/**
- * Convenience method for passing a string through a pipeline and getting
- * strings out. This method takes care of wrapping the passed string in a
- * token and mapping the resulting tokens back to strings.
- *
- * @param {string} str - The string to pass through the pipeline.
- * @param {?object} metadata - Optional metadata to associate with the token
- * passed to the pipeline.
- * @returns {string[]}
- */
-lunr.Pipeline.prototype.runString = function (str, metadata) {
-  var token = new lunr.Token (str, metadata)
-
-  return this.run([token]).map(function (t) {
-    return t.toString()
-  })
-}
-
-/**
- * Resets the pipeline by removing any existing processors.
- *
- */
-lunr.Pipeline.prototype.reset = function () {
-  this._stack = []
-}
-
-/**
- * Returns a representation of the pipeline ready for serialisation.
- *
- * Logs a warning if the function has not been registered.
- *
- * @returns {Array}
- */
-lunr.Pipeline.prototype.toJSON = function () {
-  return this._stack.map(function (fn) {
-    lunr.Pipeline.warnIfFunctionNotRegistered(fn)
-
-    return fn.label
-  })
-}
-/*!
- * lunr.Vector
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * A vector is used to construct the vector space of documents and queries. These
- * vectors support operations to determine the similarity between two documents or
- * a document and a query.
- *
- * Normally no parameters are required for initializing a vector, but in the case of
- * loading a previously dumped vector the raw elements can be provided to the constructor.
- *
- * For performance reasons vectors are implemented with a flat array, where an elements
- * index is immediately followed by its value. E.g. [index, value, index, value]. This
- * allows the underlying array to be as sparse as possible and still offer decent
- * performance when being used for vector calculations.
- *
- * @constructor
- * @param {Number[]} [elements] - The flat list of element index and element value pairs.
- */
-lunr.Vector = function (elements) {
-  this._magnitude = 0
-  this.elements = elements || []
-}
-
-
-/**
- * Calculates the position within the vector to insert a given index.
- *
- * This is used internally by insert and upsert. If there are duplicate indexes then
- * the position is returned as if the value for that index were to be updated, but it
- * is the callers responsibility to check whether there is a duplicate at that index
- *
- * @param {Number} insertIdx - The index at which the element should be inserted.
- * @returns {Number}
- */
-lunr.Vector.prototype.positionForIndex = function (index) {
-  // For an empty vector the tuple can be inserted at the beginning
-  if (this.elements.length == 0) {
-    return 0
-  }
-
-  var start = 0,
-      end = this.elements.length / 2,
-      sliceLength = end - start,
-      pivotPoint = Math.floor(sliceLength / 2),
-      pivotIndex = this.elements[pivotPoint * 2]
-
-  while (sliceLength > 1) {
-    if (pivotIndex < index) {
-      start = pivotPoint
-    }
-
-    if (pivotIndex > index) {
-      end = pivotPoint
-    }
-
-    if (pivotIndex == index) {
-      break
-    }
-
-    sliceLength = end - start
-    pivotPoint = start + Math.floor(sliceLength / 2)
-    pivotIndex = this.elements[pivotPoint * 2]
-  }
-
-  if (pivotIndex == index) {
-    return pivotPoint * 2
-  }
-
-  if (pivotIndex > index) {
-    return pivotPoint * 2
-  }
-
-  if (pivotIndex < index) {
-    return (pivotPoint + 1) * 2
-  }
-}
-
-/**
- * Inserts an element at an index within the vector.
- *
- * Does not allow duplicates, will throw an error if there is already an entry
- * for this index.
- *
- * @param {Number} insertIdx - The index at which the element should be inserted.
- * @param {Number} val - The value to be inserted into the vector.
- */
-lunr.Vector.prototype.insert = function (insertIdx, val) {
-  this.upsert(insertIdx, val, function () {
-    throw "duplicate index"
-  })
-}
-
-/**
- * Inserts or updates an existing index within the vector.
- *
- * @param {Number} insertIdx - The index at which the element should be inserted.
- * @param {Number} val - The value to be inserted into the vector.
- * @param {function} fn - A function that is called for updates, the existing value and the
- * requested value are passed as arguments
- */
-lunr.Vector.prototype.upsert = function (insertIdx, val, fn) {
-  this._magnitude = 0
-  var position = this.positionForIndex(insertIdx)
-
-  if (this.elements[position] == insertIdx) {
-    this.elements[position + 1] = fn(this.elements[position + 1], val)
-  } else {
-    this.elements.splice(position, 0, insertIdx, val)
-  }
-}
-
-/**
- * Calculates the magnitude of this vector.
- *
- * @returns {Number}
- */
-lunr.Vector.prototype.magnitude = function () {
-  if (this._magnitude) return this._magnitude
-
-  var sumOfSquares = 0,
-      elementsLength = this.elements.length
-
-  for (var i = 1; i < elementsLength; i += 2) {
-    var val = this.elements[i]
-    sumOfSquares += val * val
-  }
-
-  return this._magnitude = Math.sqrt(sumOfSquares)
-}
-
-/**
- * Calculates the dot product of this vector and another vector.
- *
- * @param {lunr.Vector} otherVector - The vector to compute the dot product with.
- * @returns {Number}
- */
-lunr.Vector.prototype.dot = function (otherVector) {
-  var dotProduct = 0,
-      a = this.elements, b = otherVector.elements,
-      aLen = a.length, bLen = b.length,
-      aVal = 0, bVal = 0,
-      i = 0, j = 0
-
-  while (i < aLen && j < bLen) {
-    aVal = a[i], bVal = b[j]
-    if (aVal < bVal) {
-      i += 2
-    } else if (aVal > bVal) {
-      j += 2
-    } else if (aVal == bVal) {
-      dotProduct += a[i + 1] * b[j + 1]
-      i += 2
-      j += 2
-    }
-  }
-
-  return dotProduct
-}
-
-/**
- * Calculates the similarity between this vector and another vector.
- *
- * @param {lunr.Vector} otherVector - The other vector to calculate the
- * similarity with.
- * @returns {Number}
- */
-lunr.Vector.prototype.similarity = function (otherVector) {
-  return this.dot(otherVector) / this.magnitude() || 0
-}
-
-/**
- * Converts the vector to an array of the elements within the vector.
- *
- * @returns {Number[]}
- */
-lunr.Vector.prototype.toArray = function () {
-  var output = new Array (this.elements.length / 2)
-
-  for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) {
-    output[j] = this.elements[i]
-  }
-
-  return output
-}
-
-/**
- * A JSON serializable representation of the vector.
- *
- * @returns {Number[]}
- */
-lunr.Vector.prototype.toJSON = function () {
-  return this.elements
-}
-/* eslint-disable */
-/*!
- * lunr.stemmer
- * Copyright (C) 2020 Oliver Nightingale
- * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt
- */
-
-/**
- * lunr.stemmer is an english language stemmer, this is a JavaScript
- * implementation of the PorterStemmer taken from http://tartarus.org/~martin
- *
- * @static
- * @implements {lunr.PipelineFunction}
- * @param {lunr.Token} token - The string to stem
- * @returns {lunr.Token}
- * @see {@link lunr.Pipeline}
- * @function
- */
-lunr.stemmer = (function(){
-  var step2list = {
-      "ational" : "ate",
-      "tional" : "tion",
-      "enci" : "ence",
-      "anci" : "ance",
-      "izer" : "ize",
-      "bli" : "ble",
-      "alli" : "al",
-      "entli" : "ent",
-      "eli" : "e",
-      "ousli" : "ous",
-      "ization" : "ize",
-      "ation" : "ate",
-      "ator" : "ate",
-      "alism" : "al",
-      "iveness" : "ive",
-      "fulness" : "ful",
-      "ousness" : "ous",
-      "aliti" : "al",
-      "iviti" : "ive",
-      "biliti" : "ble",
-      "logi" : "log"
-    },
-
-    step3list = {
-      "icate" : "ic",
-      "ative" : "",
-      "alize" : "al",
-      "iciti" : "ic",
-      "ical" : "ic",
-      "ful" : "",
-      "ness" : ""
-    },
-
-    c = "[^aeiou]",          // consonant
-    v = "[aeiouy]",          // vowel
-    C = c + "[^aeiouy]*",    // consonant sequence
-    V = v + "[aeiou]*",      // vowel sequence
-
-    mgr0 = "^(" + C + ")?" + V + C,               // [C]VC... is m>0
-    meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$",  // [C]VC[V] is m=1
-    mgr1 = "^(" + C + ")?" + V + C + V + C,       // [C]VCVC... is m>1
-    s_v = "^(" + C + ")?" + v;                   // vowel in stem
-
-  var re_mgr0 = new RegExp(mgr0);
-  var re_mgr1 = new RegExp(mgr1);
-  var re_meq1 = new RegExp(meq1);
-  var re_s_v = new RegExp(s_v);
-
-  var re_1a = /^(.+?)(ss|i)es$/;
-  var re2_1a = /^(.+?)([^s])s$/;
-  var re_1b = /^(.+?)eed$/;
-  var re2_1b = /^(.+?)(ed|ing)$/;
-  var re_1b_2 = /.$/;
-  var re2_1b_2 = /(at|bl|iz)$/;
-  var re3_1b_2 = new RegExp("([^aeiouylsz])\\1$");
-  var re4_1b_2 = new RegExp("^" + C + v + "[^aeiouwxy]$");
-
-  var re_1c = /^(.+?[^aeiou])y$/;
-  var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
-
-  var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
-
-  var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
-  var re2_4 = /^(.+?)(s|t)(ion)$/;
-
-  var re_5 = /^(.+?)e$/;
-  var re_5_1 = /ll$/;
-  var re3_5 = new RegExp("^" + C + v + "[^aeiouwxy]$");
-
-  var porterStemmer = function porterStemmer(w) {
-    var stem,
-      suffix,
-      firstch,
-      re,
-      re2,
-      re3,
-      re4;
-
-    if (w.length < 3) { return w; }
-
-    firstch = w.substr(0,1);
-    if (firstch == "y") {
-      w = firstch.toUpperCase() + w.substr(1);
-    }
-
-    // Step 1a
-    re = re_1a
-    re2 = re2_1a;
-
-    if (re.test(w)) { w = w.replace(re,"$1$2"); }
-    else if (re2.test(w)) { w = w.replace(re2,"$1$2"); }
-
-    // Step 1b
-    re = re_1b;
-    re2 = re2_1b;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      re = re_mgr0;
-      if (re.test(fp[1])) {
-        re = re_1b_2;
-        w = w.replace(re,"");
-      }
-    } else if (re2.test(w)) {
-      var fp = re2.exec(w);
-      stem = fp[1];
-      re2 = re_s_v;
-      if (re2.test(stem)) {
-        w = stem;
-        re2 = re2_1b_2;
-        re3 = re3_1b_2;
-        re4 = re4_1b_2;
-        if (re2.test(w)) { w = w + "e"; }
-        else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,""); }
-        else if (re4.test(w)) { w = w + "e"; }
-      }
-    }
-
-    // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say)
-    re = re_1c;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      w = stem + "i";
-    }
-
-    // Step 2
-    re = re_2;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      suffix = fp[2];
-      re = re_mgr0;
-      if (re.test(stem)) {
-        w = stem + step2list[suffix];
-      }
-    }
-
-    // Step 3
-    re = re_3;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      suffix = fp[2];
-      re = re_mgr0;
-      if (re.test(stem)) {
-        w = stem + step3list[suffix];
-      }
-    }
-
-    // Step 4
-    re = re_4;
-    re2 = re2_4;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      re = re_mgr1;
-      if (re.test(stem)) {
-        w = stem;
-      }
-    } else if (re2.test(w)) {
-      var fp = re2.exec(w);
-      stem = fp[1] + fp[2];
-      re2 = re_mgr1;
-      if (re2.test(stem)) {
-        w = stem;
-      }
-    }
-
-    // Step 5
-    re = re_5;
-    if (re.test(w)) {
-      var fp = re.exec(w);
-      stem = fp[1];
-      re = re_mgr1;
-      re2 = re_meq1;
-      re3 = re3_5;
-      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) {
-        w = stem;
-      }
-    }
-
-    re = re_5_1;
-    re2 = re_mgr1;
-    if (re.test(w) && re2.test(w)) {
-      re = re_1b_2;
-      w = w.replace(re,"");
-    }
-
-    // and turn initial Y back to y
-
-    if (firstch == "y") {
-      w = firstch.toLowerCase() + w.substr(1);
-    }
-
-    return w;
-  };
-
-  return function (token) {
-    return token.update(porterStemmer);
-  }
-})();
-
-lunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer')
-/*!
- * lunr.stopWordFilter
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * lunr.generateStopWordFilter builds a stopWordFilter function from the provided
- * list of stop words.
- *
- * The built in lunr.stopWordFilter is built using this generator and can be used
- * to generate custom stopWordFilters for applications or non English languages.
- *
- * @function
- * @param {Array} token The token to pass through the filter
- * @returns {lunr.PipelineFunction}
- * @see lunr.Pipeline
- * @see lunr.stopWordFilter
- */
-lunr.generateStopWordFilter = function (stopWords) {
-  var words = stopWords.reduce(function (memo, stopWord) {
-    memo[stopWord] = stopWord
-    return memo
-  }, {})
-
-  return function (token) {
-    if (token && words[token.toString()] !== token.toString()) return token
-  }
-}
-
-/**
- * lunr.stopWordFilter is an English language stop word list filter, any words
- * contained in the list will not be passed through the filter.
- *
- * This is intended to be used in the Pipeline. If the token does not pass the
- * filter then undefined will be returned.
- *
- * @function
- * @implements {lunr.PipelineFunction}
- * @params {lunr.Token} token - A token to check for being a stop word.
- * @returns {lunr.Token}
- * @see {@link lunr.Pipeline}
- */
-lunr.stopWordFilter = lunr.generateStopWordFilter([
-  'a',
-  'able',
-  'about',
-  'across',
-  'after',
-  'all',
-  'almost',
-  'also',
-  'am',
-  'among',
-  'an',
-  'and',
-  'any',
-  'are',
-  'as',
-  'at',
-  'be',
-  'because',
-  'been',
-  'but',
-  'by',
-  'can',
-  'cannot',
-  'could',
-  'dear',
-  'did',
-  'do',
-  'does',
-  'either',
-  'else',
-  'ever',
-  'every',
-  'for',
-  'from',
-  'get',
-  'got',
-  'had',
-  'has',
-  'have',
-  'he',
-  'her',
-  'hers',
-  'him',
-  'his',
-  'how',
-  'however',
-  'i',
-  'if',
-  'in',
-  'into',
-  'is',
-  'it',
-  'its',
-  'just',
-  'least',
-  'let',
-  'like',
-  'likely',
-  'may',
-  'me',
-  'might',
-  'most',
-  'must',
-  'my',
-  'neither',
-  'no',
-  'nor',
-  'not',
-  'of',
-  'off',
-  'often',
-  'on',
-  'only',
-  'or',
-  'other',
-  'our',
-  'own',
-  'rather',
-  'said',
-  'say',
-  'says',
-  'she',
-  'should',
-  'since',
-  'so',
-  'some',
-  'than',
-  'that',
-  'the',
-  'their',
-  'them',
-  'then',
-  'there',
-  'these',
-  'they',
-  'this',
-  'tis',
-  'to',
-  'too',
-  'twas',
-  'us',
-  'wants',
-  'was',
-  'we',
-  'were',
-  'what',
-  'when',
-  'where',
-  'which',
-  'while',
-  'who',
-  'whom',
-  'why',
-  'will',
-  'with',
-  'would',
-  'yet',
-  'you',
-  'your'
-])
-
-lunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter')
-/*!
- * lunr.trimmer
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * lunr.trimmer is a pipeline function for trimming non word
- * characters from the beginning and end of tokens before they
- * enter the index.
- *
- * This implementation may not work correctly for non latin
- * characters and should either be removed or adapted for use
- * with languages with non-latin characters.
- *
- * @static
- * @implements {lunr.PipelineFunction}
- * @param {lunr.Token} token The token to pass through the filter
- * @returns {lunr.Token}
- * @see lunr.Pipeline
- */
-lunr.trimmer = function (token) {
-  return token.update(function (s) {
-    return s.replace(/^\W+/, '').replace(/\W+$/, '')
-  })
-}
-
-lunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer')
-/*!
- * lunr.TokenSet
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * A token set is used to store the unique list of all tokens
- * within an index. Token sets are also used to represent an
- * incoming query to the index, this query token set and index
- * token set are then intersected to find which tokens to look
- * up in the inverted index.
- *
- * A token set can hold multiple tokens, as in the case of the
- * index token set, or it can hold a single token as in the
- * case of a simple query token set.
- *
- * Additionally token sets are used to perform wildcard matching.
- * Leading, contained and trailing wildcards are supported, and
- * from this edit distance matching can also be provided.
- *
- * Token sets are implemented as a minimal finite state automata,
- * where both common prefixes and suffixes are shared between tokens.
- * This helps to reduce the space used for storing the token set.
- *
- * @constructor
- */
-lunr.TokenSet = function () {
-  this.final = false
-  this.edges = {}
-  this.id = lunr.TokenSet._nextId
-  lunr.TokenSet._nextId += 1
-}
-
-/**
- * Keeps track of the next, auto increment, identifier to assign
- * to a new tokenSet.
- *
- * TokenSets require a unique identifier to be correctly minimised.
- *
- * @private
- */
-lunr.TokenSet._nextId = 1
-
-/**
- * Creates a TokenSet instance from the given sorted array of words.
- *
- * @param {String[]} arr - A sorted array of strings to create the set from.
- * @returns {lunr.TokenSet}
- * @throws Will throw an error if the input array is not sorted.
- */
-lunr.TokenSet.fromArray = function (arr) {
-  var builder = new lunr.TokenSet.Builder
-
-  for (var i = 0, len = arr.length; i < len; i++) {
-    builder.insert(arr[i])
-  }
-
-  builder.finish()
-  return builder.root
-}
-
-/**
- * Creates a token set from a query clause.
- *
- * @private
- * @param {Object} clause - A single clause from lunr.Query.
- * @param {string} clause.term - The query clause term.
- * @param {number} [clause.editDistance] - The optional edit distance for the term.
- * @returns {lunr.TokenSet}
- */
-lunr.TokenSet.fromClause = function (clause) {
-  if ('editDistance' in clause) {
-    return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance)
-  } else {
-    return lunr.TokenSet.fromString(clause.term)
-  }
-}
-
-/**
- * Creates a token set representing a single string with a specified
- * edit distance.
- *
- * Insertions, deletions, substitutions and transpositions are each
- * treated as an edit distance of 1.
- *
- * Increasing the allowed edit distance will have a dramatic impact
- * on the performance of both creating and intersecting these TokenSets.
- * It is advised to keep the edit distance less than 3.
- *
- * @param {string} str - The string to create the token set from.
- * @param {number} editDistance - The allowed edit distance to match.
- * @returns {lunr.Vector}
- */
-lunr.TokenSet.fromFuzzyString = function (str, editDistance) {
-  var root = new lunr.TokenSet
-
-  var stack = [{
-    node: root,
-    editsRemaining: editDistance,
-    str: str
-  }]
-
-  while (stack.length) {
-    var frame = stack.pop()
-
-    // no edit
-    if (frame.str.length > 0) {
-      var char = frame.str.charAt(0),
-          noEditNode
-
-      if (char in frame.node.edges) {
-        noEditNode = frame.node.edges[char]
-      } else {
-        noEditNode = new lunr.TokenSet
-        frame.node.edges[char] = noEditNode
-      }
-
-      if (frame.str.length == 1) {
-        noEditNode.final = true
-      }
-
-      stack.push({
-        node: noEditNode,
-        editsRemaining: frame.editsRemaining,
-        str: frame.str.slice(1)
-      })
-    }
-
-    if (frame.editsRemaining == 0) {
-      continue
-    }
-
-    // insertion
-    if ("*" in frame.node.edges) {
-      var insertionNode = frame.node.edges["*"]
-    } else {
-      var insertionNode = new lunr.TokenSet
-      frame.node.edges["*"] = insertionNode
-    }
-
-    if (frame.str.length == 0) {
-      insertionNode.final = true
-    }
-
-    stack.push({
-      node: insertionNode,
-      editsRemaining: frame.editsRemaining - 1,
-      str: frame.str
-    })
-
-    // deletion
-    // can only do a deletion if we have enough edits remaining
-    // and if there are characters left to delete in the string
-    if (frame.str.length > 1) {
-      stack.push({
-        node: frame.node,
-        editsRemaining: frame.editsRemaining - 1,
-        str: frame.str.slice(1)
-      })
-    }
-
-    // deletion
-    // just removing the last character from the str
-    if (frame.str.length == 1) {
-      frame.node.final = true
-    }
-
-    // substitution
-    // can only do a substitution if we have enough edits remaining
-    // and if there are characters left to substitute
-    if (frame.str.length >= 1) {
-      if ("*" in frame.node.edges) {
-        var substitutionNode = frame.node.edges["*"]
-      } else {
-        var substitutionNode = new lunr.TokenSet
-        frame.node.edges["*"] = substitutionNode
-      }
-
-      if (frame.str.length == 1) {
-        substitutionNode.final = true
-      }
-
-      stack.push({
-        node: substitutionNode,
-        editsRemaining: frame.editsRemaining - 1,
-        str: frame.str.slice(1)
-      })
-    }
-
-    // transposition
-    // can only do a transposition if there are edits remaining
-    // and there are enough characters to transpose
-    if (frame.str.length > 1) {
-      var charA = frame.str.charAt(0),
-          charB = frame.str.charAt(1),
-          transposeNode
-
-      if (charB in frame.node.edges) {
-        transposeNode = frame.node.edges[charB]
-      } else {
-        transposeNode = new lunr.TokenSet
-        frame.node.edges[charB] = transposeNode
-      }
-
-      if (frame.str.length == 1) {
-        transposeNode.final = true
-      }
-
-      stack.push({
-        node: transposeNode,
-        editsRemaining: frame.editsRemaining - 1,
-        str: charA + frame.str.slice(2)
-      })
-    }
-  }
-
-  return root
-}
-
-/**
- * Creates a TokenSet from a string.
- *
- * The string may contain one or more wildcard characters (*)
- * that will allow wildcard matching when intersecting with
- * another TokenSet.
- *
- * @param {string} str - The string to create a TokenSet from.
- * @returns {lunr.TokenSet}
- */
-lunr.TokenSet.fromString = function (str) {
-  var node = new lunr.TokenSet,
-      root = node
-
-  /*
-   * Iterates through all characters within the passed string
-   * appending a node for each character.
-   *
-   * When a wildcard character is found then a self
-   * referencing edge is introduced to continually match
-   * any number of any characters.
-   */
-  for (var i = 0, len = str.length; i < len; i++) {
-    var char = str[i],
-        final = (i == len - 1)
-
-    if (char == "*") {
-      node.edges[char] = node
-      node.final = final
-
-    } else {
-      var next = new lunr.TokenSet
-      next.final = final
-
-      node.edges[char] = next
-      node = next
-    }
-  }
-
-  return root
-}
-
-/**
- * Converts this TokenSet into an array of strings
- * contained within the TokenSet.
- *
- * This is not intended to be used on a TokenSet that
- * contains wildcards, in these cases the results are
- * undefined and are likely to cause an infinite loop.
- *
- * @returns {string[]}
- */
-lunr.TokenSet.prototype.toArray = function () {
-  var words = []
-
-  var stack = [{
-    prefix: "",
-    node: this
-  }]
-
-  while (stack.length) {
-    var frame = stack.pop(),
-        edges = Object.keys(frame.node.edges),
-        len = edges.length
-
-    if (frame.node.final) {
-      /* In Safari, at this point the prefix is sometimes corrupted, see:
-       * https://github.com/olivernn/lunr.js/issues/279 Calling any
-       * String.prototype method forces Safari to "cast" this string to what
-       * it's supposed to be, fixing the bug. */
-      frame.prefix.charAt(0)
-      words.push(frame.prefix)
-    }
-
-    for (var i = 0; i < len; i++) {
-      var edge = edges[i]
-
-      stack.push({
-        prefix: frame.prefix.concat(edge),
-        node: frame.node.edges[edge]
-      })
-    }
-  }
-
-  return words
-}
-
-/**
- * Generates a string representation of a TokenSet.
- *
- * This is intended to allow TokenSets to be used as keys
- * in objects, largely to aid the construction and minimisation
- * of a TokenSet. As such it is not designed to be a human
- * friendly representation of the TokenSet.
- *
- * @returns {string}
- */
-lunr.TokenSet.prototype.toString = function () {
-  // NOTE: Using Object.keys here as this.edges is very likely
-  // to enter 'hash-mode' with many keys being added
-  //
-  // avoiding a for-in loop here as it leads to the function
-  // being de-optimised (at least in V8). From some simple
-  // benchmarks the performance is comparable, but allowing
-  // V8 to optimize may mean easy performance wins in the future.
-
-  if (this._str) {
-    return this._str
-  }
-
-  var str = this.final ? '1' : '0',
-      labels = Object.keys(this.edges).sort(),
-      len = labels.length
-
-  for (var i = 0; i < len; i++) {
-    var label = labels[i],
-        node = this.edges[label]
-
-    str = str + label + node.id
-  }
-
-  return str
-}
-
-/**
- * Returns a new TokenSet that is the intersection of
- * this TokenSet and the passed TokenSet.
- *
- * This intersection will take into account any wildcards
- * contained within the TokenSet.
- *
- * @param {lunr.TokenSet} b - An other TokenSet to intersect with.
- * @returns {lunr.TokenSet}
- */
-lunr.TokenSet.prototype.intersect = function (b) {
-  var output = new lunr.TokenSet,
-      frame = undefined
-
-  var stack = [{
-    qNode: b,
-    output: output,
-    node: this
-  }]
-
-  while (stack.length) {
-    frame = stack.pop()
-
-    // NOTE: As with the #toString method, we are using
-    // Object.keys and a for loop instead of a for-in loop
-    // as both of these objects enter 'hash' mode, causing
-    // the function to be de-optimised in V8
-    var qEdges = Object.keys(frame.qNode.edges),
-        qLen = qEdges.length,
-        nEdges = Object.keys(frame.node.edges),
-        nLen = nEdges.length
-
-    for (var q = 0; q < qLen; q++) {
-      var qEdge = qEdges[q]
-
-      for (var n = 0; n < nLen; n++) {
-        var nEdge = nEdges[n]
-
-        if (nEdge == qEdge || qEdge == '*') {
-          var node = frame.node.edges[nEdge],
-              qNode = frame.qNode.edges[qEdge],
-              final = node.final && qNode.final,
-              next = undefined
-
-          if (nEdge in frame.output.edges) {
-            // an edge already exists for this character
-            // no need to create a new node, just set the finality
-            // bit unless this node is already final
-            next = frame.output.edges[nEdge]
-            next.final = next.final || final
-
-          } else {
-            // no edge exists yet, must create one
-            // set the finality bit and insert it
-            // into the output
-            next = new lunr.TokenSet
-            next.final = final
-            frame.output.edges[nEdge] = next
-          }
-
-          stack.push({
-            qNode: qNode,
-            output: next,
-            node: node
-          })
-        }
-      }
-    }
-  }
-
-  return output
-}
-lunr.TokenSet.Builder = function () {
-  this.previousWord = ""
-  this.root = new lunr.TokenSet
-  this.uncheckedNodes = []
-  this.minimizedNodes = {}
-}
-
-lunr.TokenSet.Builder.prototype.insert = function (word) {
-  var node,
-      commonPrefix = 0
-
-  if (word < this.previousWord) {
-    throw new Error ("Out of order word insertion")
-  }
-
-  for (var i = 0; i < word.length && i < this.previousWord.length; i++) {
-    if (word[i] != this.previousWord[i]) break
-    commonPrefix++
-  }
-
-  this.minimize(commonPrefix)
-
-  if (this.uncheckedNodes.length == 0) {
-    node = this.root
-  } else {
-    node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child
-  }
-
-  for (var i = commonPrefix; i < word.length; i++) {
-    var nextNode = new lunr.TokenSet,
-        char = word[i]
-
-    node.edges[char] = nextNode
-
-    this.uncheckedNodes.push({
-      parent: node,
-      char: char,
-      child: nextNode
-    })
-
-    node = nextNode
-  }
-
-  node.final = true
-  this.previousWord = word
-}
-
-lunr.TokenSet.Builder.prototype.finish = function () {
-  this.minimize(0)
-}
-
-lunr.TokenSet.Builder.prototype.minimize = function (downTo) {
-  for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) {
-    var node = this.uncheckedNodes[i],
-        childKey = node.child.toString()
-
-    if (childKey in this.minimizedNodes) {
-      node.parent.edges[node.char] = this.minimizedNodes[childKey]
-    } else {
-      // Cache the key for this node since
-      // we know it can't change anymore
-      node.child._str = childKey
-
-      this.minimizedNodes[childKey] = node.child
-    }
-
-    this.uncheckedNodes.pop()
-  }
-}
-/*!
- * lunr.Index
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * An index contains the built index of all documents and provides a query interface
- * to the index.
- *
- * Usually instances of lunr.Index will not be created using this constructor, instead
- * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be
- * used to load previously built and serialized indexes.
- *
- * @constructor
- * @param {Object} attrs - The attributes of the built search index.
- * @param {Object} attrs.invertedIndex - An index of term/field to document reference.
- * @param {Object<string, lunr.Vector>} attrs.fieldVectors - Field vectors
- * @param {lunr.TokenSet} attrs.tokenSet - An set of all corpus tokens.
- * @param {string[]} attrs.fields - The names of indexed document fields.
- * @param {lunr.Pipeline} attrs.pipeline - The pipeline to use for search terms.
- */
-lunr.Index = function (attrs) {
-  this.invertedIndex = attrs.invertedIndex
-  this.fieldVectors = attrs.fieldVectors
-  this.tokenSet = attrs.tokenSet
-  this.fields = attrs.fields
-  this.pipeline = attrs.pipeline
-}
-
-/**
- * A result contains details of a document matching a search query.
- * @typedef {Object} lunr.Index~Result
- * @property {string} ref - The reference of the document this result represents.
- * @property {number} score - A number between 0 and 1 representing how similar this document is to the query.
- * @property {lunr.MatchData} matchData - Contains metadata about this match including which term(s) caused the match.
- */
-
-/**
- * Although lunr provides the ability to create queries using lunr.Query, it also provides a simple
- * query language which itself is parsed into an instance of lunr.Query.
- *
- * For programmatically building queries it is advised to directly use lunr.Query, the query language
- * is best used for human entered text rather than program generated text.
- *
- * At its simplest queries can just be a single term, e.g. `hello`, multiple terms are also supported
- * and will be combined with OR, e.g `hello world` will match documents that contain either 'hello'
- * or 'world', though those that contain both will rank higher in the results.
- *
- * Wildcards can be included in terms to match one or more unspecified characters, these wildcards can
- * be inserted anywhere within the term, and more than one wildcard can exist in a single term. Adding
- * wildcards will increase the number of documents that will be found but can also have a negative
- * impact on query performance, especially with wildcards at the beginning of a term.
- *
- * Terms can be restricted to specific fields, e.g. `title:hello`, only documents with the term
- * hello in the title field will match this query. Using a field not present in the index will lead
- * to an error being thrown.
- *
- * Modifiers can also be added to terms, lunr supports edit distance and boost modifiers on terms. A term
- * boost will make documents matching that term score higher, e.g. `foo^5`. Edit distance is also supported
- * to provide fuzzy matching, e.g. 'hello~2' will match documents with hello with an edit distance of 2.
- * Avoid large values for edit distance to improve query performance.
- *
- * Each term also supports a presence modifier. By default a term's presence in document is optional, however
- * this can be changed to either required or prohibited. For a term's presence to be required in a document the
- * term should be prefixed with a '+', e.g. `+foo bar` is a search for documents that must contain 'foo' and
- * optionally contain 'bar'. Conversely a leading '-' sets the terms presence to prohibited, i.e. it must not
- * appear in a document, e.g. `-foo bar` is a search for documents that do not contain 'foo' but may contain 'bar'.
- *
- * To escape special characters the backslash character '\' can be used, this allows searches to include
- * characters that would normally be considered modifiers, e.g. `foo\~2` will search for a term "foo~2" instead
- * of attempting to apply a boost of 2 to the search term "foo".
- *
- * @typedef {string} lunr.Index~QueryString
- * @example <caption>Simple single term query</caption>
- * hello
- * @example <caption>Multiple term query</caption>
- * hello world
- * @example <caption>term scoped to a field</caption>
- * title:hello
- * @example <caption>term with a boost of 10</caption>
- * hello^10
- * @example <caption>term with an edit distance of 2</caption>
- * hello~2
- * @example <caption>terms with presence modifiers</caption>
- * -foo +bar baz
- */
-
-/**
- * Performs a search against the index using lunr query syntax.
- *
- * Results will be returned sorted by their score, the most relevant results
- * will be returned first.  For details on how the score is calculated, please see
- * the {@link https://lunrjs.com/guides/searching.html#scoring|guide}.
- *
- * For more programmatic querying use lunr.Index#query.
- *
- * @param {lunr.Index~QueryString} queryString - A string containing a lunr query.
- * @throws {lunr.QueryParseError} If the passed query string cannot be parsed.
- * @returns {lunr.Index~Result[]}
- */
-lunr.Index.prototype.search = function (queryString) {
-  return this.query(function (query) {
-    var parser = new lunr.QueryParser(queryString, query)
-    parser.parse()
-  })
-}
-
-/**
- * A query builder callback provides a query object to be used to express
- * the query to perform on the index.
- *
- * @callback lunr.Index~queryBuilder
- * @param {lunr.Query} query - The query object to build up.
- * @this lunr.Query
- */
-
-/**
- * Performs a query against the index using the yielded lunr.Query object.
- *
- * If performing programmatic queries against the index, this method is preferred
- * over lunr.Index#search so as to avoid the additional query parsing overhead.
- *
- * A query object is yielded to the supplied function which should be used to
- * express the query to be run against the index.
- *
- * Note that although this function takes a callback parameter it is _not_ an
- * asynchronous operation, the callback is just yielded a query object to be
- * customized.
- *
- * @param {lunr.Index~queryBuilder} fn - A function that is used to build the query.
- * @returns {lunr.Index~Result[]}
- */
-lunr.Index.prototype.query = function (fn) {
-  // for each query clause
-  // * process terms
-  // * expand terms from token set
-  // * find matching documents and metadata
-  // * get document vectors
-  // * score documents
-
-  var query = new lunr.Query(this.fields),
-      matchingFields = Object.create(null),
-      queryVectors = Object.create(null),
-      termFieldCache = Object.create(null),
-      requiredMatches = Object.create(null),
-      prohibitedMatches = Object.create(null)
-
-  /*
-   * To support field level boosts a query vector is created per
-   * field. An empty vector is eagerly created to support negated
-   * queries.
-   */
-  for (var i = 0; i < this.fields.length; i++) {
-    queryVectors[this.fields[i]] = new lunr.Vector
-  }
-
-  fn.call(query, query)
-
-  for (var i = 0; i < query.clauses.length; i++) {
-    /*
-     * Unless the pipeline has been disabled for this term, which is
-     * the case for terms with wildcards, we need to pass the clause
-     * term through the search pipeline. A pipeline returns an array
-     * of processed terms. Pipeline functions may expand the passed
-     * term, which means we may end up performing multiple index lookups
-     * for a single query term.
-     */
-    var clause = query.clauses[i],
-        terms = null,
-        clauseMatches = lunr.Set.empty
-
-    if (clause.usePipeline) {
-      terms = this.pipeline.runString(clause.term, {
-        fields: clause.fields
-      })
-    } else {
-      terms = [clause.term]
-    }
-
-    for (var m = 0; m < terms.length; m++) {
-      var term = terms[m]
-
-      /*
-       * Each term returned from the pipeline needs to use the same query
-       * clause object, e.g. the same boost and or edit distance. The
-       * simplest way to do this is to re-use the clause object but mutate
-       * its term property.
-       */
-      clause.term = term
-
-      /*
-       * From the term in the clause we create a token set which will then
-       * be used to intersect the indexes token set to get a list of terms
-       * to lookup in the inverted index
-       */
-      var termTokenSet = lunr.TokenSet.fromClause(clause),
-          expandedTerms = this.tokenSet.intersect(termTokenSet).toArray()
-
-      /*
-       * If a term marked as required does not exist in the tokenSet it is
-       * impossible for the search to return any matches. We set all the field
-       * scoped required matches set to empty and stop examining any further
-       * clauses.
-       */
-      if (expandedTerms.length === 0 && clause.presence === lunr.Query.presence.REQUIRED) {
-        for (var k = 0; k < clause.fields.length; k++) {
-          var field = clause.fields[k]
-          requiredMatches[field] = lunr.Set.empty
-        }
-
-        break
-      }
-
-      for (var j = 0; j < expandedTerms.length; j++) {
-        /*
-         * For each term get the posting and termIndex, this is required for
-         * building the query vector.
-         */
-        var expandedTerm = expandedTerms[j],
-            posting = this.invertedIndex[expandedTerm],
-            termIndex = posting._index
-
-        for (var k = 0; k < clause.fields.length; k++) {
-          /*
-           * For each field that this query term is scoped by (by default
-           * all fields are in scope) we need to get all the document refs
-           * that have this term in that field.
-           *
-           * The posting is the entry in the invertedIndex for the matching
-           * term from above.
-           */
-          var field = clause.fields[k],
-              fieldPosting = posting[field],
-              matchingDocumentRefs = Object.keys(fieldPosting),
-              termField = expandedTerm + "/" + field,
-              matchingDocumentsSet = new lunr.Set(matchingDocumentRefs)
-
-          /*
-           * if the presence of this term is required ensure that the matching
-           * documents are added to the set of required matches for this clause.
-           *
-           */
-          if (clause.presence == lunr.Query.presence.REQUIRED) {
-            clauseMatches = clauseMatches.union(matchingDocumentsSet)
-
-            if (requiredMatches[field] === undefined) {
-              requiredMatches[field] = lunr.Set.complete
-            }
-          }
-
-          /*
-           * if the presence of this term is prohibited ensure that the matching
-           * documents are added to the set of prohibited matches for this field,
-           * creating that set if it does not yet exist.
-           */
-          if (clause.presence == lunr.Query.presence.PROHIBITED) {
-            if (prohibitedMatches[field] === undefined) {
-              prohibitedMatches[field] = lunr.Set.empty
-            }
-
-            prohibitedMatches[field] = prohibitedMatches[field].union(matchingDocumentsSet)
-
-            /*
-             * Prohibited matches should not be part of the query vector used for
-             * similarity scoring and no metadata should be extracted so we continue
-             * to the next field
-             */
-            continue
-          }
-
-          /*
-           * The query field vector is populated using the termIndex found for
-           * the term and a unit value with the appropriate boost applied.
-           * Using upsert because there could already be an entry in the vector
-           * for the term we are working with. In that case we just add the scores
-           * together.
-           */
-          queryVectors[field].upsert(termIndex, clause.boost, function (a, b) { return a + b })
-
-          /**
-           * If we've already seen this term, field combo then we've already collected
-           * the matching documents and metadata, no need to go through all that again
-           */
-          if (termFieldCache[termField]) {
-            continue
-          }
-
-          for (var l = 0; l < matchingDocumentRefs.length; l++) {
-            /*
-             * All metadata for this term/field/document triple
-             * are then extracted and collected into an instance
-             * of lunr.MatchData ready to be returned in the query
-             * results
-             */
-            var matchingDocumentRef = matchingDocumentRefs[l],
-                matchingFieldRef = new lunr.FieldRef (matchingDocumentRef, field),
-                metadata = fieldPosting[matchingDocumentRef],
-                fieldMatch
-
-            if ((fieldMatch = matchingFields[matchingFieldRef]) === undefined) {
-              matchingFields[matchingFieldRef] = new lunr.MatchData (expandedTerm, field, metadata)
-            } else {
-              fieldMatch.add(expandedTerm, field, metadata)
-            }
-
-          }
-
-          termFieldCache[termField] = true
-        }
-      }
-    }
-
-    /**
-     * If the presence was required we need to update the requiredMatches field sets.
-     * We do this after all fields for the term have collected their matches because
-     * the clause terms presence is required in _any_ of the fields not _all_ of the
-     * fields.
-     */
-    if (clause.presence === lunr.Query.presence.REQUIRED) {
-      for (var k = 0; k < clause.fields.length; k++) {
-        var field = clause.fields[k]
-        requiredMatches[field] = requiredMatches[field].intersect(clauseMatches)
-      }
-    }
-  }
-
-  /**
-   * Need to combine the field scoped required and prohibited
-   * matching documents into a global set of required and prohibited
-   * matches
-   */
-  var allRequiredMatches = lunr.Set.complete,
-      allProhibitedMatches = lunr.Set.empty
-
-  for (var i = 0; i < this.fields.length; i++) {
-    var field = this.fields[i]
-
-    if (requiredMatches[field]) {
-      allRequiredMatches = allRequiredMatches.intersect(requiredMatches[field])
-    }
-
-    if (prohibitedMatches[field]) {
-      allProhibitedMatches = allProhibitedMatches.union(prohibitedMatches[field])
-    }
-  }
-
-  var matchingFieldRefs = Object.keys(matchingFields),
-      results = [],
-      matches = Object.create(null)
-
-  /*
-   * If the query is negated (contains only prohibited terms)
-   * we need to get _all_ fieldRefs currently existing in the
-   * index. This is only done when we know that the query is
-   * entirely prohibited terms to avoid any cost of getting all
-   * fieldRefs unnecessarily.
-   *
-   * Additionally, blank MatchData must be created to correctly
-   * populate the results.
-   */
-  if (query.isNegated()) {
-    matchingFieldRefs = Object.keys(this.fieldVectors)
-
-    for (var i = 0; i < matchingFieldRefs.length; i++) {
-      var matchingFieldRef = matchingFieldRefs[i]
-      var fieldRef = lunr.FieldRef.fromString(matchingFieldRef)
-      matchingFields[matchingFieldRef] = new lunr.MatchData
-    }
-  }
-
-  for (var i = 0; i < matchingFieldRefs.length; i++) {
-    /*
-     * Currently we have document fields that match the query, but we
-     * need to return documents. The matchData and scores are combined
-     * from multiple fields belonging to the same document.
-     *
-     * Scores are calculated by field, using the query vectors created
-     * above, and combined into a final document score using addition.
-     */
-    var fieldRef = lunr.FieldRef.fromString(matchingFieldRefs[i]),
-        docRef = fieldRef.docRef
-
-    if (!allRequiredMatches.contains(docRef)) {
-      continue
-    }
-
-    if (allProhibitedMatches.contains(docRef)) {
-      continue
-    }
-
-    var fieldVector = this.fieldVectors[fieldRef],
-        score = queryVectors[fieldRef.fieldName].similarity(fieldVector),
-        docMatch
-
-    if ((docMatch = matches[docRef]) !== undefined) {
-      docMatch.score += score
-      docMatch.matchData.combine(matchingFields[fieldRef])
-    } else {
-      var match = {
-        ref: docRef,
-        score: score,
-        matchData: matchingFields[fieldRef]
-      }
-      matches[docRef] = match
-      results.push(match)
-    }
-  }
-
-  /*
-   * Sort the results objects by score, highest first.
-   */
-  return results.sort(function (a, b) {
-    return b.score - a.score
-  })
-}
-
-/**
- * Prepares the index for JSON serialization.
- *
- * The schema for this JSON blob will be described in a
- * separate JSON schema file.
- *
- * @returns {Object}
- */
-lunr.Index.prototype.toJSON = function () {
-  var invertedIndex = Object.keys(this.invertedIndex)
-    .sort()
-    .map(function (term) {
-      return [term, this.invertedIndex[term]]
-    }, this)
-
-  var fieldVectors = Object.keys(this.fieldVectors)
-    .map(function (ref) {
-      return [ref, this.fieldVectors[ref].toJSON()]
-    }, this)
-
-  return {
-    version: lunr.version,
-    fields: this.fields,
-    fieldVectors: fieldVectors,
-    invertedIndex: invertedIndex,
-    pipeline: this.pipeline.toJSON()
-  }
-}
-
-/**
- * Loads a previously serialized lunr.Index
- *
- * @param {Object} serializedIndex - A previously serialized lunr.Index
- * @returns {lunr.Index}
- */
-lunr.Index.load = function (serializedIndex) {
-  var attrs = {},
-      fieldVectors = {},
-      serializedVectors = serializedIndex.fieldVectors,
-      invertedIndex = Object.create(null),
-      serializedInvertedIndex = serializedIndex.invertedIndex,
-      tokenSetBuilder = new lunr.TokenSet.Builder,
-      pipeline = lunr.Pipeline.load(serializedIndex.pipeline)
-
-  if (serializedIndex.version != lunr.version) {
-    lunr.utils.warn("Version mismatch when loading serialised index. Current version of lunr '" + lunr.version + "' does not match serialized index '" + serializedIndex.version + "'")
-  }
-
-  for (var i = 0; i < serializedVectors.length; i++) {
-    var tuple = serializedVectors[i],
-        ref = tuple[0],
-        elements = tuple[1]
-
-    fieldVectors[ref] = new lunr.Vector(elements)
-  }
-
-  for (var i = 0; i < serializedInvertedIndex.length; i++) {
-    var tuple = serializedInvertedIndex[i],
-        term = tuple[0],
-        posting = tuple[1]
-
-    tokenSetBuilder.insert(term)
-    invertedIndex[term] = posting
-  }
-
-  tokenSetBuilder.finish()
-
-  attrs.fields = serializedIndex.fields
-
-  attrs.fieldVectors = fieldVectors
-  attrs.invertedIndex = invertedIndex
-  attrs.tokenSet = tokenSetBuilder.root
-  attrs.pipeline = pipeline
-
-  return new lunr.Index(attrs)
-}
-/*!
- * lunr.Builder
- * Copyright (C) 2020 Oliver Nightingale
- */
-
-/**
- * lunr.Builder performs indexing on a set of documents and
- * returns instances of lunr.Index ready for querying.
- *
- * All configuration of the index is done via the builder, the
- * fields to index, the document reference, the text processing
- * pipeline and document scoring parameters are all set on the
- * builder before indexing.
- *
- * @constructor
- * @property {string} _ref - Internal reference to the document reference field.
- * @property {string[]} _fields - Internal reference to the document fields to index.
- * @property {object} invertedIndex - The inverted index maps terms to document fields.
- * @property {object} documentTermFrequencies - Keeps track of document term frequencies.
- * @property {object} documentLengths - Keeps track of the length of documents added to the index.
- * @property {lunr.tokenizer} tokenizer - Function for splitting strings into tokens for indexing.
- * @property {lunr.Pipeline} pipeline - The pipeline performs text processing on tokens before indexing.
- * @property {lunr.Pipeline} searchPipeline - A pipeline for processing search terms before querying the index.
- * @property {number} documentCount - Keeps track of the total number of documents indexed.
- * @property {number} _b - A parameter to control field length normalization, setting this to 0 disabled normalization, 1 fully normalizes field lengths, the default value is 0.75.
- * @property {number} _k1 - A parameter to control how quickly an increase in term frequency results in term frequency saturation, the default value is 1.2.
- * @property {number} termIndex - A counter incremented for each unique term, used to identify a terms position in the vector space.
- * @property {array} metadataWhitelist - A list of metadata keys that have been whitelisted for entry in the index.
- */
-lunr.Builder = function () {
-  this._ref = "id"
-  this._fields = Object.create(null)
-  this._documents = Object.create(null)
-  this.invertedIndex = Object.create(null)
-  this.fieldTermFrequencies = {}
-  this.fieldLengths = {}
-  this.tokenizer = lunr.tokenizer
-  this.pipeline = new lunr.Pipeline
-  this.searchPipeline = new lunr.Pipeline
-  this.documentCount = 0
-  this._b = 0.75
-  this._k1 = 1.2
-  this.termIndex = 0
-  this.metadataWhitelist = []
-}
-
-/**
- * Sets the document field used as the document reference. Every document must have this field.
- * The type of this field in the document should be a string, if it is not a string it will be
- * coerced into a string by calling toString.
- *
- * The default ref is 'id'.
- *
- * The ref should _not_ be changed during indexing, it should be set before any documents are
- * added to the index. Changing it during indexing can lead to inconsistent results.
- *
- * @param {string} ref - The name of the reference field in the document.
- */
-lunr.Builder.prototype.ref = function (ref) {
-  this._ref = ref
-}
-
-/**
- * A function that is used to extract a field from a document.
- *
- * Lunr expects a field to be at the top level of a document, if however the field
- * is deeply nested within a document an extractor function can be used to extract
- * the right field for indexing.
- *
- * @callback fieldExtractor
- * @param {object} doc - The document being added to the index.
- * @returns {?(string|object|object[])} obj - The object that will be indexed for this field.
- * @example <caption>Extracting a nested field</caption>
- * function (doc) { return doc.nested.field }
- */
-
-/**
- * Adds a field to the list of document fields that will be indexed. Every document being
- * indexed should have this field. Null values for this field in indexed documents will
- * not cause errors but will limit the chance of that document being retrieved by searches.
- *
- * All fields should be added before adding documents to the index. Adding fields after
- * a document has been indexed will have no effect on already indexed documents.
- *
- * Fields can be boosted at build time. This allows terms within that field to have more
- * importance when ranking search results. Use a field boost to specify that matches within
- * one field are more important than other fields.
- *
- * @param {string} fieldName - The name of a field to index in all documents.
- * @param {object} attributes - Optional attributes associated with this field.
- * @param {number} [attributes.boost=1] - Boost applied to all terms within this field.
- * @param {fieldExtractor} [attributes.extractor] - Function to extract a field from a document.
- * @throws {RangeError} fieldName cannot contain unsupported characters '/'
- */
-lunr.Builder.prototype.field = function (fieldName, attributes) {
-  if (/\//.test(fieldName)) {
-    throw new RangeError ("Field '" + fieldName + "' contains illegal character '/'")
-  }
-
-  this._fields[fieldName] = attributes || {}
-}
-
-/**
- * A parameter to tune the amount of field length normalisation that is applied when
- * calculating relevance scores. A value of 0 will completely disable any normalisation
- * and a value of 1 will fully normalise field lengths. The default is 0.75. Values of b
- * will be clamped to the range 0 - 1.
- *
- * @param {number} number - The value to set for this tuning parameter.
- */
-lunr.Builder.prototype.b = function (number) {
-  if (number < 0) {
-    this._b = 0
-  } else if (number > 1) {
-    this._b = 1
-  } else {
-    this._b = number
-  }
-}
-
-/**
- * A parameter that controls the speed at which a rise in term frequency results in term
- * frequency saturation. The default value is 1.2. Setting this to a higher value will give
- * slower saturation levels, a lower value will result in quicker saturation.
- *
- * @param {number} number - The value to set for this tuning parameter.
- */
-lunr.Builder.prototype.k1 = function (number) {
-  this._k1 = number
-}
-
-/**
- * Adds a document to the index.
- *
- * Before adding fields to the index the index should have been fully setup, with the document
- * ref and all fields to index already having been specified.
- *
- * The document must have a field name as specified by the ref (by default this is 'id') and
- * it should have all fields defined for indexing, though null or undefined values will not
- * cause errors.
- *
- * Entire documents can be boosted at build time. Applying a boost to a document indicates that
- * this document should rank higher in search results than other documents.
- *
- * @param {object} doc - The document to add to the index.
- * @param {object} attributes - Optional attributes associated with this document.
- * @param {number} [attributes.boost=1] - Boost applied to all terms within this document.
- */
-lunr.Builder.prototype.add = function (doc, attributes) {
-  var docRef = doc[this._ref],
-      fields = Object.keys(this._fields)
-
-  this._documents[docRef] = attributes || {}
-  this.documentCount += 1
-
-  for (var i = 0; i < fields.length; i++) {
-    var fieldName = fields[i],
-        extractor = this._fields[fieldName].extractor,
-        field = extractor ? extractor(doc) : doc[fieldName],
-        tokens = this.tokenizer(field, {
-          fields: [fieldName]
-        }),
-        terms = this.pipeline.run(tokens),
-        fieldRef = new lunr.FieldRef (docRef, fieldName),
-        fieldTerms = Object.create(null)
-
-    this.fieldTermFrequencies[fieldRef] = fieldTerms
-    this.fieldLengths[fieldRef] = 0
-
-    // store the length of this field for this document
-    this.fieldLengths[fieldRef] += terms.length
-
-    // calculate term frequencies for this field
-    for (var j = 0; j < terms.length; j++) {
-      var term = terms[j]
-
-      if (fieldTerms[term] == undefined) {
-        fieldTerms[term] = 0
-      }
-
-      fieldTerms[term] += 1
-
-      // add to inverted index
-      // create an initial posting if one doesn't exist
-      if (this.invertedIndex[term] == undefined) {
-        var posting = Object.create(null)
-        posting["_index"] = this.termIndex
-        this.termIndex += 1
-
-        for (var k = 0; k < fields.length; k++) {
-          posting[fields[k]] = Object.create(null)
-        }
-
-        this.invertedIndex[term] = posting
-      }
-
-      // add an entry for this term/fieldName/docRef to the invertedIndex
-      if (this.invertedIndex[term][fieldName][docRef] == undefined) {
-        this.invertedIndex[term][fieldName][docRef] = Object.create(null)
-      }
-
-      // store all whitelisted metadata about this token in the
-      // inverted index
-      for (var l = 0; l < this.metadataWhitelist.length; l++) {
-        var metadataKey = this.metadataWhitelist[l],
-            metadata = term.metadata[metadataKey]
-
-        if (this.invertedIndex[term][fieldName][docRef][metadataKey] == undefined) {
-          this.invertedIndex[term][fieldName][docRef][metadataKey] = []
-        }
-
-        this.invertedIndex[term][fieldName][docRef][metadataKey].push(metadata)
-      }
-    }
-
-  }
-}
-
-/**
- * Calculates the average document length for this index
- *
- * @private
- */
-lunr.Builder.prototype.calculateAverageFieldLengths = function () {
-
-  var fieldRefs = Object.keys(this.fieldLengths),
-      numberOfFields = fieldRefs.length,
-      accumulator = {},
-      documentsWithField = {}
-
-  for (var i = 0; i < numberOfFields; i++) {
-    var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),
-        field = fieldRef.fieldName
-
-    documentsWithField[field] || (documentsWithField[field] = 0)
-    documentsWithField[field] += 1
-
-    accumulator[field] || (accumulator[field] = 0)
-    accumulator[field] += this.fieldLengths[fieldRef]
-  }
-
-  var fields = Object.keys(this._fields)
-
-  for (var i = 0; i < fields.length; i++) {
-    var fieldName = fields[i]
-    accumulator[fieldName] = accumulator[fieldName] / documentsWithField[fieldName]
-  }
-
-  this.averageFieldLength = accumulator
-}
-
-/**
- * Builds a vector space model of every document using lunr.Vector
- *
- * @private
- */
-lunr.Builder.prototype.createFieldVectors = function () {
-  var fieldVectors = {},
-      fieldRefs = Object.keys(this.fieldTermFrequencies),
-      fieldRefsLength = fieldRefs.length,
-      termIdfCache = Object.create(null)
-
-  for (var i = 0; i < fieldRefsLength; i++) {
-    var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),
-        fieldName = fieldRef.fieldName,
-        fieldLength = this.fieldLengths[fieldRef],
-        fieldVector = new lunr.Vector,
-        termFrequencies = this.fieldTermFrequencies[fieldRef],
-        terms = Object.keys(termFrequencies),
-        termsLength = terms.length
-
-
-    var fieldBoost = this._fields[fieldName].boost || 1,
-        docBoost = this._documents[fieldRef.docRef].boost || 1
-
-    for (var j = 0; j < termsLength; j++) {
-      var term = terms[j],
-          tf = termFrequencies[term],
-          termIndex = this.invertedIndex[term]._index,
-          idf, score, scoreWithPrecision
-
-      if (termIdfCache[term] === undefined) {
-        idf = lunr.idf(this.invertedIndex[term], this.documentCount)
-        termIdfCache[term] = idf
-      } else {
-        idf = termIdfCache[term]
-      }
-
-      score = idf * ((this._k1 + 1) * tf) / (this._k1 * (1 - this._b + this._b * (fieldLength / this.averageFieldLength[fieldName])) + tf)
-      score *= fieldBoost
-      score *= docBoost
-      scoreWithPrecision = Math.round(score * 1000) / 1000
-      // Converts 1.23456789 to 1.234.
-      // Reducing the precision so that the vectors take up less
-      // space when serialised. Doing it now so that they behave
-      // the same before and after serialisation. Also, this is
-      // the fastest approach to reducing a number's precision in
-      // JavaScript.
-
-      fieldVector.insert(termIndex, scoreWithPrecision)
-    }
-
-    fieldVectors[fieldRef] = fieldVector
-  }
-
-  this.fieldVectors = fieldVectors
-}
-
-/**
- * Creates a token set of all tokens in the index using lunr.TokenSet
- *
- * @private
- */
-lunr.Builder.prototype.createTokenSet = function () {
-  this.tokenSet = lunr.TokenSet.fromArray(
-    Object.keys(this.invertedIndex).sort()
-  )
-}
-
-/**
- * Builds the index, creating an instance of lunr.Index.
- *
- * This completes the indexing process and should only be called
- * once all documents have been added to the index.
- *
- * @returns {lunr.Index}
- */
-lunr.Builder.prototype.build = function () {
-  this.calculateAverageFieldLengths()
-  this.createFieldVectors()
-  this.createTokenSet()
-
-  return new lunr.Index({
-    invertedIndex: this.invertedIndex,
-    fieldVectors: this.fieldVectors,
-    tokenSet: this.tokenSet,
-    fields: Object.keys(this._fields),
-    pipeline: this.searchPipeline
-  })
-}
-
-/**
- * Applies a plugin to the index builder.
- *
- * A plugin is a function that is called with the index builder as its context.
- * Plugins can be used to customise or extend the behaviour of the index
- * in some way. A plugin is just a function, that encapsulated the custom
- * behaviour that should be applied when building the index.
- *
- * The plugin function will be called with the index builder as its argument, additional
- * arguments can also be passed when calling use. The function will be called
- * with the index builder as its context.
- *
- * @param {Function} plugin The plugin to apply.
- */
-lunr.Builder.prototype.use = function (fn) {
-  var args = Array.prototype.slice.call(arguments, 1)
-  args.unshift(this)
-  fn.apply(this, args)
-}
-/**
- * Contains and collects metadata about a matching document.
- * A single instance of lunr.MatchData is returned as part of every
- * lunr.Index~Result.
- *
- * @constructor
- * @param {string} term - The term this match data is associated with
- * @param {string} field - The field in which the term was found
- * @param {object} metadata - The metadata recorded about this term in this field
- * @property {object} metadata - A cloned collection of metadata associated with this document.
- * @see {@link lunr.Index~Result}
- */
-lunr.MatchData = function (term, field, metadata) {
-  var clonedMetadata = Object.create(null),
-      metadataKeys = Object.keys(metadata || {})
-
-  // Cloning the metadata to prevent the original
-  // being mutated during match data combination.
-  // Metadata is kept in an array within the inverted
-  // index so cloning the data can be done with
-  // Array#slice
-  for (var i = 0; i < metadataKeys.length; i++) {
-    var key = metadataKeys[i]
-    clonedMetadata[key] = metadata[key].slice()
-  }
-
-  this.metadata = Object.create(null)
-
-  if (term !== undefined) {
-    this.metadata[term] = Object.create(null)
-    this.metadata[term][field] = clonedMetadata
-  }
-}
-
-/**
- * An instance of lunr.MatchData will be created for every term that matches a
- * document. However only one instance is required in a lunr.Index~Result. This
- * method combines metadata from another instance of lunr.MatchData with this
- * objects metadata.
- *
- * @param {lunr.MatchData} otherMatchData - Another instance of match data to merge with this one.
- * @see {@link lunr.Index~Result}
- */
-lunr.MatchData.prototype.combine = function (otherMatchData) {
-  var terms = Object.keys(otherMatchData.metadata)
-
-  for (var i = 0; i < terms.length; i++) {
-    var term = terms[i],
-        fields = Object.keys(otherMatchData.metadata[term])
-
-    if (this.metadata[term] == undefined) {
-      this.metadata[term] = Object.create(null)
-    }
-
-    for (var j = 0; j < fields.length; j++) {
-      var field = fields[j],
-          keys = Object.keys(otherMatchData.metadata[term][field])
-
-      if (this.metadata[term][field] == undefined) {
-        this.metadata[term][field] = Object.create(null)
-      }
-
-      for (var k = 0; k < keys.length; k++) {
-        var key = keys[k]
-
-        if (this.metadata[term][field][key] == undefined) {
-          this.metadata[term][field][key] = otherMatchData.metadata[term][field][key]
-        } else {
-          this.metadata[term][field][key] = this.metadata[term][field][key].concat(otherMatchData.metadata[term][field][key])
-        }
-
-      }
-    }
-  }
-}
-
-/**
- * Add metadata for a term/field pair to this instance of match data.
- *
- * @param {string} term - The term this match data is associated with
- * @param {string} field - The field in which the term was found
- * @param {object} metadata - The metadata recorded about this term in this field
- */
-lunr.MatchData.prototype.add = function (term, field, metadata) {
-  if (!(term in this.metadata)) {
-    this.metadata[term] = Object.create(null)
-    this.metadata[term][field] = metadata
-    return
-  }
-
-  if (!(field in this.metadata[term])) {
-    this.metadata[term][field] = metadata
-    return
-  }
-
-  var metadataKeys = Object.keys(metadata)
-
-  for (var i = 0; i < metadataKeys.length; i++) {
-    var key = metadataKeys[i]
-
-    if (key in this.metadata[term][field]) {
-      this.metadata[term][field][key] = this.metadata[term][field][key].concat(metadata[key])
-    } else {
-      this.metadata[term][field][key] = metadata[key]
-    }
-  }
-}
-/**
- * A lunr.Query provides a programmatic way of defining queries to be performed
- * against a {@link lunr.Index}.
- *
- * Prefer constructing a lunr.Query using the {@link lunr.Index#query} method
- * so the query object is pre-initialized with the right index fields.
- *
- * @constructor
- * @property {lunr.Query~Clause[]} clauses - An array of query clauses.
- * @property {string[]} allFields - An array of all available fields in a lunr.Index.
- */
-lunr.Query = function (allFields) {
-  this.clauses = []
-  this.allFields = allFields
-}
-
-/**
- * Constants for indicating what kind of automatic wildcard insertion will be used when constructing a query clause.
- *
- * This allows wildcards to be added to the beginning and end of a term without having to manually do any string
- * concatenation.
- *
- * The wildcard constants can be bitwise combined to select both leading and trailing wildcards.
- *
- * @constant
- * @default
- * @property {number} wildcard.NONE - The term will have no wildcards inserted, this is the default behaviour
- * @property {number} wildcard.LEADING - Prepend the term with a wildcard, unless a leading wildcard already exists
- * @property {number} wildcard.TRAILING - Append a wildcard to the term, unless a trailing wildcard already exists
- * @see lunr.Query~Clause
- * @see lunr.Query#clause
- * @see lunr.Query#term
- * @example <caption>query term with trailing wildcard</caption>
- * query.term('foo', { wildcard: lunr.Query.wildcard.TRAILING })
- * @example <caption>query term with leading and trailing wildcard</caption>
- * query.term('foo', {
- *   wildcard: lunr.Query.wildcard.LEADING | lunr.Query.wildcard.TRAILING
- * })
- */
-
-lunr.Query.wildcard = new String ("*")
-lunr.Query.wildcard.NONE = 0
-lunr.Query.wildcard.LEADING = 1
-lunr.Query.wildcard.TRAILING = 2
-
-/**
- * Constants for indicating what kind of presence a term must have in matching documents.
- *
- * @constant
- * @enum {number}
- * @see lunr.Query~Clause
- * @see lunr.Query#clause
- * @see lunr.Query#term
- * @example <caption>query term with required presence</caption>
- * query.term('foo', { presence: lunr.Query.presence.REQUIRED })
- */
-lunr.Query.presence = {
-  /**
-   * Term's presence in a document is optional, this is the default value.
-   */
-  OPTIONAL: 1,
-
-  /**
-   * Term's presence in a document is required, documents that do not contain
-   * this term will not be returned.
-   */
-  REQUIRED: 2,
-
-  /**
-   * Term's presence in a document is prohibited, documents that do contain
-   * this term will not be returned.
-   */
-  PROHIBITED: 3
-}
-
-/**
- * A single clause in a {@link lunr.Query} contains a term and details on how to
- * match that term against a {@link lunr.Index}.
- *
- * @typedef {Object} lunr.Query~Clause
- * @property {string[]} fields - The fields in an index this clause should be matched against.
- * @property {number} [boost=1] - Any boost that should be applied when matching this clause.
- * @property {number} [editDistance] - Whether the term should have fuzzy matching applied, and how fuzzy the match should be.
- * @property {boolean} [usePipeline] - Whether the term should be passed through the search pipeline.
- * @property {number} [wildcard=lunr.Query.wildcard.NONE] - Whether the term should have wildcards appended or prepended.
- * @property {number} [presence=lunr.Query.presence.OPTIONAL] - The terms presence in any matching documents.
- */
-
-/**
- * Adds a {@link lunr.Query~Clause} to this query.
- *
- * Unless the clause contains the fields to be matched all fields will be matched. In addition
- * a default boost of 1 is applied to the clause.
- *
- * @param {lunr.Query~Clause} clause - The clause to add to this query.
- * @see lunr.Query~Clause
- * @returns {lunr.Query}
- */
-lunr.Query.prototype.clause = function (clause) {
-  if (!('fields' in clause)) {
-    clause.fields = this.allFields
-  }
-
-  if (!('boost' in clause)) {
-    clause.boost = 1
-  }
-
-  if (!('usePipeline' in clause)) {
-    clause.usePipeline = true
-  }
-
-  if (!('wildcard' in clause)) {
-    clause.wildcard = lunr.Query.wildcard.NONE
-  }
-
-  if ((clause.wildcard & lunr.Query.wildcard.LEADING) && (clause.term.charAt(0) != lunr.Query.wildcard)) {
-    clause.term = "*" + clause.term
-  }
-
-  if ((clause.wildcard & lunr.Query.wildcard.TRAILING) && (clause.term.slice(-1) != lunr.Query.wildcard)) {
-    clause.term = "" + clause.term + "*"
-  }
-
-  if (!('presence' in clause)) {
-    clause.presence = lunr.Query.presence.OPTIONAL
-  }
-
-  this.clauses.push(clause)
-
-  return this
-}
-
-/**
- * A negated query is one in which every clause has a presence of
- * prohibited. These queries require some special processing to return
- * the expected results.
- *
- * @returns boolean
- */
-lunr.Query.prototype.isNegated = function () {
-  for (var i = 0; i < this.clauses.length; i++) {
-    if (this.clauses[i].presence != lunr.Query.presence.PROHIBITED) {
-      return false
-    }
-  }
-
-  return true
-}
-
-/**
- * Adds a term to the current query, under the covers this will create a {@link lunr.Query~Clause}
- * to the list of clauses that make up this query.
- *
- * The term is used as is, i.e. no tokenization will be performed by this method. Instead conversion
- * to a token or token-like string should be done before calling this method.
- *
- * The term will be converted to a string by calling `toString`. Multiple terms can be passed as an
- * array, each term in the array will share the same options.
- *
- * @param {object|object[]} term - The term(s) to add to the query.
- * @param {object} [options] - Any additional properties to add to the query clause.
- * @returns {lunr.Query}
- * @see lunr.Query#clause
- * @see lunr.Query~Clause
- * @example <caption>adding a single term to a query</caption>
- * query.term("foo")
- * @example <caption>adding a single term to a query and specifying search fields, term boost and automatic trailing wildcard</caption>
- * query.term("foo", {
- *   fields: ["title"],
- *   boost: 10,
- *   wildcard: lunr.Query.wildcard.TRAILING
- * })
- * @example <caption>using lunr.tokenizer to convert a string to tokens before using them as terms</caption>
- * query.term(lunr.tokenizer("foo bar"))
- */
-lunr.Query.prototype.term = function (term, options) {
-  if (Array.isArray(term)) {
-    term.forEach(function (t) { this.term(t, lunr.utils.clone(options)) }, this)
-    return this
-  }
-
-  var clause = options || {}
-  clause.term = term.toString()
-
-  this.clause(clause)
-
-  return this
-}
-lunr.QueryParseError = function (message, start, end) {
-  this.name = "QueryParseError"
-  this.message = message
-  this.start = start
-  this.end = end
-}
-
-lunr.QueryParseError.prototype = new Error
-lunr.QueryLexer = function (str) {
-  this.lexemes = []
-  this.str = str
-  this.length = str.length
-  this.pos = 0
-  this.start = 0
-  this.escapeCharPositions = []
-}
-
-lunr.QueryLexer.prototype.run = function () {
-  var state = lunr.QueryLexer.lexText
-
-  while (state) {
-    state = state(this)
-  }
-}
-
-lunr.QueryLexer.prototype.sliceString = function () {
-  var subSlices = [],
-      sliceStart = this.start,
-      sliceEnd = this.pos
-
-  for (var i = 0; i < this.escapeCharPositions.length; i++) {
-    sliceEnd = this.escapeCharPositions[i]
-    subSlices.push(this.str.slice(sliceStart, sliceEnd))
-    sliceStart = sliceEnd + 1
-  }
-
-  subSlices.push(this.str.slice(sliceStart, this.pos))
-  this.escapeCharPositions.length = 0
-
-  return subSlices.join('')
-}
-
-lunr.QueryLexer.prototype.emit = function (type) {
-  this.lexemes.push({
-    type: type,
-    str: this.sliceString(),
-    start: this.start,
-    end: this.pos
-  })
-
-  this.start = this.pos
-}
-
-lunr.QueryLexer.prototype.escapeCharacter = function () {
-  this.escapeCharPositions.push(this.pos - 1)
-  this.pos += 1
-}
-
-lunr.QueryLexer.prototype.next = function () {
-  if (this.pos >= this.length) {
-    return lunr.QueryLexer.EOS
-  }
-
-  var char = this.str.charAt(this.pos)
-  this.pos += 1
-  return char
-}
-
-lunr.QueryLexer.prototype.width = function () {
-  return this.pos - this.start
-}
-
-lunr.QueryLexer.prototype.ignore = function () {
-  if (this.start == this.pos) {
-    this.pos += 1
-  }
-
-  this.start = this.pos
-}
-
-lunr.QueryLexer.prototype.backup = function () {
-  this.pos -= 1
-}
-
-lunr.QueryLexer.prototype.acceptDigitRun = function () {
-  var char, charCode
-
-  do {
-    char = this.next()
-    charCode = char.charCodeAt(0)
-  } while (charCode > 47 && charCode < 58)
-
-  if (char != lunr.QueryLexer.EOS) {
-    this.backup()
-  }
-}
-
-lunr.QueryLexer.prototype.more = function () {
-  return this.pos < this.length
-}
-
-lunr.QueryLexer.EOS = 'EOS'
-lunr.QueryLexer.FIELD = 'FIELD'
-lunr.QueryLexer.TERM = 'TERM'
-lunr.QueryLexer.EDIT_DISTANCE = 'EDIT_DISTANCE'
-lunr.QueryLexer.BOOST = 'BOOST'
-lunr.QueryLexer.PRESENCE = 'PRESENCE'
-
-lunr.QueryLexer.lexField = function (lexer) {
-  lexer.backup()
-  lexer.emit(lunr.QueryLexer.FIELD)
-  lexer.ignore()
-  return lunr.QueryLexer.lexText
-}
-
-lunr.QueryLexer.lexTerm = function (lexer) {
-  if (lexer.width() > 1) {
-    lexer.backup()
-    lexer.emit(lunr.QueryLexer.TERM)
-  }
-
-  lexer.ignore()
-
-  if (lexer.more()) {
-    return lunr.QueryLexer.lexText
-  }
-}
-
-lunr.QueryLexer.lexEditDistance = function (lexer) {
-  lexer.ignore()
-  lexer.acceptDigitRun()
-  lexer.emit(lunr.QueryLexer.EDIT_DISTANCE)
-  return lunr.QueryLexer.lexText
-}
-
-lunr.QueryLexer.lexBoost = function (lexer) {
-  lexer.ignore()
-  lexer.acceptDigitRun()
-  lexer.emit(lunr.QueryLexer.BOOST)
-  return lunr.QueryLexer.lexText
-}
-
-lunr.QueryLexer.lexEOS = function (lexer) {
-  if (lexer.width() > 0) {
-    lexer.emit(lunr.QueryLexer.TERM)
-  }
-}
-
-// This matches the separator used when tokenising fields
-// within a document. These should match otherwise it is
-// not possible to search for some tokens within a document.
-//
-// It is possible for the user to change the separator on the
-// tokenizer so it _might_ clash with any other of the special
-// characters already used within the search string, e.g. :.
-//
-// This means that it is possible to change the separator in
-// such a way that makes some words unsearchable using a search
-// string.
-lunr.QueryLexer.termSeparator = lunr.tokenizer.separator
-
-lunr.QueryLexer.lexText = function (lexer) {
-  while (true) {
-    var char = lexer.next()
-
-    if (char == lunr.QueryLexer.EOS) {
-      return lunr.QueryLexer.lexEOS
-    }
-
-    // Escape character is '\'
-    if (char.charCodeAt(0) == 92) {
-      lexer.escapeCharacter()
-      continue
-    }
-
-    if (char == ":") {
-      return lunr.QueryLexer.lexField
-    }
-
-    if (char == "~") {
-      lexer.backup()
-      if (lexer.width() > 0) {
-        lexer.emit(lunr.QueryLexer.TERM)
-      }
-      return lunr.QueryLexer.lexEditDistance
-    }
-
-    if (char == "^") {
-      lexer.backup()
-      if (lexer.width() > 0) {
-        lexer.emit(lunr.QueryLexer.TERM)
-      }
-      return lunr.QueryLexer.lexBoost
-    }
-
-    // "+" indicates term presence is required
-    // checking for length to ensure that only
-    // leading "+" are considered
-    if (char == "+" && lexer.width() === 1) {
-      lexer.emit(lunr.QueryLexer.PRESENCE)
-      return lunr.QueryLexer.lexText
-    }
-
-    // "-" indicates term presence is prohibited
-    // checking for length to ensure that only
-    // leading "-" are considered
-    if (char == "-" && lexer.width() === 1) {
-      lexer.emit(lunr.QueryLexer.PRESENCE)
-      return lunr.QueryLexer.lexText
-    }
-
-    if (char.match(lunr.QueryLexer.termSeparator)) {
-      return lunr.QueryLexer.lexTerm
-    }
-  }
-}
-
-lunr.QueryParser = function (str, query) {
-  this.lexer = new lunr.QueryLexer (str)
-  this.query = query
-  this.currentClause = {}
-  this.lexemeIdx = 0
-}
-
-lunr.QueryParser.prototype.parse = function () {
-  this.lexer.run()
-  this.lexemes = this.lexer.lexemes
-
-  var state = lunr.QueryParser.parseClause
-
-  while (state) {
-    state = state(this)
-  }
-
-  return this.query
-}
-
-lunr.QueryParser.prototype.peekLexeme = function () {
-  return this.lexemes[this.lexemeIdx]
-}
-
-lunr.QueryParser.prototype.consumeLexeme = function () {
-  var lexeme = this.peekLexeme()
-  this.lexemeIdx += 1
-  return lexeme
-}
-
-lunr.QueryParser.prototype.nextClause = function () {
-  var completedClause = this.currentClause
-  this.query.clause(completedClause)
-  this.currentClause = {}
-}
-
-lunr.QueryParser.parseClause = function (parser) {
-  var lexeme = parser.peekLexeme()
-
-  if (lexeme == undefined) {
-    return
-  }
-
-  switch (lexeme.type) {
-    case lunr.QueryLexer.PRESENCE:
-      return lunr.QueryParser.parsePresence
-    case lunr.QueryLexer.FIELD:
-      return lunr.QueryParser.parseField
-    case lunr.QueryLexer.TERM:
-      return lunr.QueryParser.parseTerm
-    default:
-      var errorMessage = "expected either a field or a term, found " + lexeme.type
-
-      if (lexeme.str.length >= 1) {
-        errorMessage += " with value '" + lexeme.str + "'"
-      }
-
-      throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-}
-
-lunr.QueryParser.parsePresence = function (parser) {
-  var lexeme = parser.consumeLexeme()
-
-  if (lexeme == undefined) {
-    return
-  }
-
-  switch (lexeme.str) {
-    case "-":
-      parser.currentClause.presence = lunr.Query.presence.PROHIBITED
-      break
-    case "+":
-      parser.currentClause.presence = lunr.Query.presence.REQUIRED
-      break
-    default:
-      var errorMessage = "unrecognised presence operator'" + lexeme.str + "'"
-      throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-
-  var nextLexeme = parser.peekLexeme()
-
-  if (nextLexeme == undefined) {
-    var errorMessage = "expecting term or field, found nothing"
-    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-
-  switch (nextLexeme.type) {
-    case lunr.QueryLexer.FIELD:
-      return lunr.QueryParser.parseField
-    case lunr.QueryLexer.TERM:
-      return lunr.QueryParser.parseTerm
-    default:
-      var errorMessage = "expecting term or field, found '" + nextLexeme.type + "'"
-      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)
-  }
-}
-
-lunr.QueryParser.parseField = function (parser) {
-  var lexeme = parser.consumeLexeme()
-
-  if (lexeme == undefined) {
-    return
-  }
-
-  if (parser.query.allFields.indexOf(lexeme.str) == -1) {
-    var possibleFields = parser.query.allFields.map(function (f) { return "'" + f + "'" }).join(', '),
-        errorMessage = "unrecognised field '" + lexeme.str + "', possible fields: " + possibleFields
-
-    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-
-  parser.currentClause.fields = [lexeme.str]
-
-  var nextLexeme = parser.peekLexeme()
-
-  if (nextLexeme == undefined) {
-    var errorMessage = "expecting term, found nothing"
-    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-
-  switch (nextLexeme.type) {
-    case lunr.QueryLexer.TERM:
-      return lunr.QueryParser.parseTerm
-    default:
-      var errorMessage = "expecting term, found '" + nextLexeme.type + "'"
-      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)
-  }
-}
-
-lunr.QueryParser.parseTerm = function (parser) {
-  var lexeme = parser.consumeLexeme()
-
-  if (lexeme == undefined) {
-    return
-  }
-
-  parser.currentClause.term = lexeme.str.toLowerCase()
-
-  if (lexeme.str.indexOf("*") != -1) {
-    parser.currentClause.usePipeline = false
-  }
-
-  var nextLexeme = parser.peekLexeme()
-
-  if (nextLexeme == undefined) {
-    parser.nextClause()
-    return
-  }
-
-  switch (nextLexeme.type) {
-    case lunr.QueryLexer.TERM:
-      parser.nextClause()
-      return lunr.QueryParser.parseTerm
-    case lunr.QueryLexer.FIELD:
-      parser.nextClause()
-      return lunr.QueryParser.parseField
-    case lunr.QueryLexer.EDIT_DISTANCE:
-      return lunr.QueryParser.parseEditDistance
-    case lunr.QueryLexer.BOOST:
-      return lunr.QueryParser.parseBoost
-    case lunr.QueryLexer.PRESENCE:
-      parser.nextClause()
-      return lunr.QueryParser.parsePresence
-    default:
-      var errorMessage = "Unexpected lexeme type '" + nextLexeme.type + "'"
-      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)
-  }
-}
-
-lunr.QueryParser.parseEditDistance = function (parser) {
-  var lexeme = parser.consumeLexeme()
-
-  if (lexeme == undefined) {
-    return
-  }
-
-  var editDistance = parseInt(lexeme.str, 10)
-
-  if (isNaN(editDistance)) {
-    var errorMessage = "edit distance must be numeric"
-    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-
-  parser.currentClause.editDistance = editDistance
-
-  var nextLexeme = parser.peekLexeme()
-
-  if (nextLexeme == undefined) {
-    parser.nextClause()
-    return
-  }
-
-  switch (nextLexeme.type) {
-    case lunr.QueryLexer.TERM:
-      parser.nextClause()
-      return lunr.QueryParser.parseTerm
-    case lunr.QueryLexer.FIELD:
-      parser.nextClause()
-      return lunr.QueryParser.parseField
-    case lunr.QueryLexer.EDIT_DISTANCE:
-      return lunr.QueryParser.parseEditDistance
-    case lunr.QueryLexer.BOOST:
-      return lunr.QueryParser.parseBoost
-    case lunr.QueryLexer.PRESENCE:
-      parser.nextClause()
-      return lunr.QueryParser.parsePresence
-    default:
-      var errorMessage = "Unexpected lexeme type '" + nextLexeme.type + "'"
-      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)
-  }
-}
-
-lunr.QueryParser.parseBoost = function (parser) {
-  var lexeme = parser.consumeLexeme()
-
-  if (lexeme == undefined) {
-    return
-  }
-
-  var boost = parseInt(lexeme.str, 10)
-
-  if (isNaN(boost)) {
-    var errorMessage = "boost must be numeric"
-    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)
-  }
-
-  parser.currentClause.boost = boost
-
-  var nextLexeme = parser.peekLexeme()
-
-  if (nextLexeme == undefined) {
-    parser.nextClause()
-    return
-  }
-
-  switch (nextLexeme.type) {
-    case lunr.QueryLexer.TERM:
-      parser.nextClause()
-      return lunr.QueryParser.parseTerm
-    case lunr.QueryLexer.FIELD:
-      parser.nextClause()
-      return lunr.QueryParser.parseField
-    case lunr.QueryLexer.EDIT_DISTANCE:
-      return lunr.QueryParser.parseEditDistance
-    case lunr.QueryLexer.BOOST:
-      return lunr.QueryParser.parseBoost
-    case lunr.QueryLexer.PRESENCE:
-      parser.nextClause()
-      return lunr.QueryParser.parsePresence
-    default:
-      var errorMessage = "Unexpected lexeme type '" + nextLexeme.type + "'"
-      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)
-  }
-}
-
-  /**
-   * export the module via AMD, CommonJS or as a browser global
-   * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js
-   */
-  ;(function (root, factory) {
-    if (typeof define === 'function' && define.amd) {
-      // AMD. Register as an anonymous module.
-      define(factory)
-    } else if (typeof exports === 'object') {
-      /**
-       * Node. Does not work with strict CommonJS, but
-       * only CommonJS-like enviroments that support module.exports,
-       * like Node.
-       */
-      module.exports = factory()
-    } else {
-      // Browser globals (root is window)
-      root.lunr = factory()
-    }
-  }(this, function () {
-    /**
-     * Just return a value to define the module export.
-     * This example returns an object, but the module
-     * can return a function as the exported value.
-     */
-    return lunr
-  }))
-})();
diff --git a/docs/search/main.js b/docs/search/main.js
deleted file mode 100644
index c5ccfa6..0000000
--- a/docs/search/main.js
+++ /dev/null
@@ -1,102 +0,0 @@
-function getSearchTermFromLocation() {
-  var sPageURL = window.location.search.substring(1);
-  var sURLVariables = sPageURL.split('&');
-  for (var i = 0; i < sURLVariables.length; i++) {
-    var sParameterName = sURLVariables[i].split('=');
-    if (sParameterName[0] == 'q') {
-      return decodeURIComponent(sParameterName[1].replace(/\+/g, '%20'));
-    }
-  }
-}
-
-function joinUrl (base, path) {
-  if (path.substring(0, 1) === "/") {
-    // path starts with `/`. Thus it is absolute.
-    return path;
-  }
-  if (base.substring(base.length-1) === "/") {
-    // base ends with `/`
-    return base + path;
-  }
-  return base + "/" + path;
-}
-
-function formatResult (location, title, summary) {
-  return '<article><h3><a href="' + joinUrl(base_url, location) + '">'+ title + '</a></h3><p>' + summary +'</p></article>';
-}
-
-function displayResults (results) {
-  var search_results = document.getElementById("mkdocs-search-results");
-  while (search_results.firstChild) {
-    search_results.removeChild(search_results.firstChild);
-  }
-  if (results.length > 0){
-    for (var i=0; i < results.length; i++){
-      var result = results[i];
-      var html = formatResult(result.location, result.title, result.summary);
-      search_results.insertAdjacentHTML('beforeend', html);
-    }
-  } else {
-    var noResultsText = search_results.getAttribute('data-no-results-text');
-    if (!noResultsText) {
-      noResultsText = "No results found";
-    }
-    search_results.insertAdjacentHTML('beforeend', '<p>' + noResultsText + '</p>');
-  }
-}
-
-function doSearch () {
-  var query = document.getElementById('mkdocs-search-query').value;
-  if (query.length > min_search_length) {
-    if (!window.Worker) {
-      displayResults(search(query));
-    } else {
-      searchWorker.postMessage({query: query});
-    }
-  } else {
-    // Clear results for short queries
-    displayResults([]);
-  }
-}
-
-function initSearch () {
-  var search_input = document.getElementById('mkdocs-search-query');
-  if (search_input) {
-    search_input.addEventListener("keyup", doSearch);
-  }
-  var term = getSearchTermFromLocation();
-  if (term) {
-    search_input.value = term;
-    doSearch();
-  }
-}
-
-function onWorkerMessage (e) {
-  if (e.data.allowSearch) {
-    initSearch();
-  } else if (e.data.results) {
-    var results = e.data.results;
-    displayResults(results);
-  } else if (e.data.config) {
-    min_search_length = e.data.config.min_search_length-1;
-  }
-}
-
-if (!window.Worker) {
-  console.log('Web Worker API not supported');
-  // load index in main thread
-  $.getScript(joinUrl(base_url, "search/worker.js")).done(function () {
-    console.log('Loaded worker');
-    init();
-    window.postMessage = function (msg) {
-      onWorkerMessage({data: msg});
-    };
-  }).fail(function (jqxhr, settings, exception) {
-    console.error('Could not load worker.js');
-  });
-} else {
-  // Wrap search in a web worker
-  var searchWorker = new Worker(joinUrl(base_url, "search/worker.js"));
-  searchWorker.postMessage({init: true});
-  searchWorker.onmessage = onWorkerMessage;
-}
diff --git a/docs/search/search_index.json b/docs/search/search_index.json
deleted file mode 100644
index 5b0f1de..0000000
--- a/docs/search/search_index.json
+++ /dev/null
@@ -1 +0,0 @@
-{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"SOCI - The C++ Database Access Library SOCI is a database access library written in C++ that makes an illusion of embedding SQL queries in the regular C++ code, staying entirely within the Standard C++. The idea is to provide C++ programmers a way to access SQL databases in the most natural and intuitive way. If you find existing libraries too difficult for your needs or just distracting, SOCI can be a good alternative. Basic Syntax The simplest motivating code example for the SQL query that is supposed to retrieve a single row is: int id = ...; string name; int salary; sql << \"select name, salary from persons where id = \" << id, into(name), into(salary); Basic ORM The following benefits from extensive support for object-relational mapping: int id = ...; Person p; sql << \"select first_name, last_name, date_of_birth \" \"from persons where id = \" << id, into(p); Integrations Integration with STL is also supported: Rowset<string> rs = (sql.prepare << \"select name from persons\"); std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, \"\\n\")); SOCI offers also extensive integration with Boost datatypes (optional, tuple and fusion) and flexible support for user-defined datatypes. Database Backends Starting from its 2.0.0 release, SOCI uses the plug-in architecture for backends - this allows to target various database servers. Currently (SOCI 4.0.3), backends for following database systems are supported: DB2 Firebird MySQL ODBC (generic backend) Oracle PostgreSQL SQLite3 The intent of the library is to cover as many database technologies as possible. For this, the project has to rely on volunteer contributions from other programmers, who have expertise with the existing database interfaces and would like to help writing dedicated backends. Language Bindings Even though SOCI is mainly a C++ library, it also allows to use it from other programming languages. Currently the package contains the Ada binding, with more bindings likely to come in the future.","title":"Home"},{"location":"#soci-the-c-database-access-library","text":"SOCI is a database access library written in C++ that makes an illusion of embedding SQL queries in the regular C++ code, staying entirely within the Standard C++. The idea is to provide C++ programmers a way to access SQL databases in the most natural and intuitive way. If you find existing libraries too difficult for your needs or just distracting, SOCI can be a good alternative.","title":"SOCI - The C++ Database Access Library"},{"location":"#basic-syntax","text":"The simplest motivating code example for the SQL query that is supposed to retrieve a single row is: int id = ...; string name; int salary; sql << \"select name, salary from persons where id = \" << id, into(name), into(salary);","title":"Basic Syntax"},{"location":"#basic-orm","text":"The following benefits from extensive support for object-relational mapping: int id = ...; Person p; sql << \"select first_name, last_name, date_of_birth \" \"from persons where id = \" << id, into(p);","title":"Basic ORM"},{"location":"#integrations","text":"Integration with STL is also supported: Rowset<string> rs = (sql.prepare << \"select name from persons\"); std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, \"\\n\")); SOCI offers also extensive integration with Boost datatypes (optional, tuple and fusion) and flexible support for user-defined datatypes.","title":"Integrations"},{"location":"#database-backends","text":"Starting from its 2.0.0 release, SOCI uses the plug-in architecture for backends - this allows to target various database servers. Currently (SOCI 4.0.3), backends for following database systems are supported: DB2 Firebird MySQL ODBC (generic backend) Oracle PostgreSQL SQLite3 The intent of the library is to cover as many database technologies as possible. For this, the project has to rely on volunteer contributions from other programmers, who have expertise with the existing database interfaces and would like to help writing dedicated backends.","title":"Database Backends"},{"location":"#language-bindings","text":"Even though SOCI is mainly a C++ library, it also allows to use it from other programming languages. Currently the package contains the Ada binding, with more bindings likely to come in the future.","title":"Language Bindings"},{"location":"beyond/","text":"Beyond standard SQL Sometimes the standard SQL is not enough and database-specific syntax needs to be used. When possible and practical, SOCI provides wrappers hiding the differences between the backends and this section describes these wrappers. And, if this is still not enough, you can use the backend-specific methods directly as described below. Affected rows It can be useful to know how many rows were affected by the last SQL statement, most often when using INSERT , UPDATE or DELETE . SOCI provides statement::get_affected_rows() method allowing to do this: statement st = (sql.prepare << \"update some_table ...\"); st.execute(true); if ( !st.get_affected_rows() ) { ... investigate why no rows were modified ... } Portability note This method behaviour in case of partially executed update, i.e. when some records were updated or inserted while some other have failed to be updated or inserted, depends on the exact backend and, in the case of ODBC backend, on the exact ODBC driver used. It can return -1 , meaning that the number of rows is unknown, the number of rows actually updated or the total number of affected rows. Sequences It is common to have auto-incrementing database fields or fields whose value come from a sequence. In the latter case you need to retrieve the value of the field for a new row before inserting it into the database. In the former case, this is unnecessary but you may still want to know the value generated by the database, e.g. to use it as a foreign key in another table. So it would be useful to have a way to obtain the value of such a field. But, of course, to make life of database programmers more interesting, different products usually support either autoincrement fields or sequences but not both -- and they use different syntaxes for them, too. SOCI tries to help to deal with this unfortunate situation by providing two functions: session::get_next_sequence_value() and session::get_last_insert_id . If you know which kind of database you use, you may use only one of them: when working with sequences, the first one allows to generate the next value in a sequence and when working with autoincrement fields, the second one retrieves the last value generated for such a field for the given table. However if you use multiple SOCI backends or even just a single ODBC backend but support connecting to databases of different types, you actually must use both of them in the following way to insert a row: long long id; statement st; if ( sql.get_next_sequence_value(\"table_sequence\", id) ) { st << \"insert into table(id, f1, f2) values(:id, :f1, :f2)\", use(id), use(f1), use(f2); } else { // We're not using sequences, so don't specify the value, // it will be automatically generated by the database on insert. st << \"insert into table(f1, f2) value(:f1, :f2)\", use(f1), use(f2); // If the ID used for the above row is needed later, get it: if ( !sql.get_last_insert_id(\"table\", id) ) ... unexpected error, handle appropriately ... } Please note that, generally speaking, with the backends implementing get_last_insert_id() , it is impossible to predict the next auto-generated value before the row is actually inserted due to the possibility of concurrent access to the database from another client. However if the application has exclusive access to the database, it can be assumed that the next value will be equal to the sum of the last insert ID and the increment used for the column (in most cases the increment will be 1 and some databases only support using 1 as the increment, but others, e.g. Microsoft SQL Server with its IDENTITY(start, increment) columns, can use arbitrary values). In particular, calling get_last_insert_id() for the just created, and still empty, table returns 0 (or start - increment in the SQL Server case), so that adding the increment value to it still corresponds to the next value that will be used. Portability note These methods are currently only implemented in Firebird, MySQL, ODBC, PostgreSQL and SQLite3 backends. Beyond SOCI API As the original name of the library (Simple Oracle Call Interface) clearly stated, SOCI is intended to be a simple library, targeting the majority of needs in regular C++ application. We do not claim that everything can be done with SOCI and it was never the intent of the library. What is important, though, is that the simplicity of the library does not prevent the client applications from reaching into the low-level specifics of each database backend in order to achieve special configuration or performance goals. Most of the SOCI classes have the getBackEnd method, which returns the pointer to the actual backend object that implements the given functionality. The knowledge of the actual backend allows the client application to get access to all low-level details that are involved. blob b(sql); oracle_session_back_end * sessionBackEnd = static_cast<oracle_session_back_end *>(sql.get_back_end()); oracle_blob_back_end * blobBackEnd = static_cast<oracle_blob_back_end *>(b.get_back_end()); OCILobDisableBuffering(sessionBackEnd->svchp_, sessionBackEnd->errhp_, blobBackEnd->lobp_); The above example retrieves the rowid (\"something\" that identifies the row in the table) from the table and uses the get_back_end function to extract the actual object that implements this functionality. Assuming that it is the \"postgresql\" backend which is in use, the downcast is performed to use the postgresql_rowid_back_end interface to get the actual OID value that is a physical, low-level implementation of row identifier on PostgreSQL databases. In order for any of the above to compile, you have to explicitly #include the appropriate backend's header file. Please see the header file related to the given backend to learn what low-level handles and descriptors are available.","title":"Beyond SQL"},{"location":"beyond/#beyond-standard-sql","text":"Sometimes the standard SQL is not enough and database-specific syntax needs to be used. When possible and practical, SOCI provides wrappers hiding the differences between the backends and this section describes these wrappers. And, if this is still not enough, you can use the backend-specific methods directly as described below.","title":"Beyond standard SQL"},{"location":"beyond/#affected-rows","text":"It can be useful to know how many rows were affected by the last SQL statement, most often when using INSERT , UPDATE or DELETE . SOCI provides statement::get_affected_rows() method allowing to do this: statement st = (sql.prepare << \"update some_table ...\"); st.execute(true); if ( !st.get_affected_rows() ) { ... investigate why no rows were modified ... }","title":"Affected rows"},{"location":"beyond/#portability-note","text":"This method behaviour in case of partially executed update, i.e. when some records were updated or inserted while some other have failed to be updated or inserted, depends on the exact backend and, in the case of ODBC backend, on the exact ODBC driver used. It can return -1 , meaning that the number of rows is unknown, the number of rows actually updated or the total number of affected rows.","title":"Portability note"},{"location":"beyond/#sequences","text":"It is common to have auto-incrementing database fields or fields whose value come from a sequence. In the latter case you need to retrieve the value of the field for a new row before inserting it into the database. In the former case, this is unnecessary but you may still want to know the value generated by the database, e.g. to use it as a foreign key in another table. So it would be useful to have a way to obtain the value of such a field. But, of course, to make life of database programmers more interesting, different products usually support either autoincrement fields or sequences but not both -- and they use different syntaxes for them, too. SOCI tries to help to deal with this unfortunate situation by providing two functions: session::get_next_sequence_value() and session::get_last_insert_id . If you know which kind of database you use, you may use only one of them: when working with sequences, the first one allows to generate the next value in a sequence and when working with autoincrement fields, the second one retrieves the last value generated for such a field for the given table. However if you use multiple SOCI backends or even just a single ODBC backend but support connecting to databases of different types, you actually must use both of them in the following way to insert a row: long long id; statement st; if ( sql.get_next_sequence_value(\"table_sequence\", id) ) { st << \"insert into table(id, f1, f2) values(:id, :f1, :f2)\", use(id), use(f1), use(f2); } else { // We're not using sequences, so don't specify the value, // it will be automatically generated by the database on insert. st << \"insert into table(f1, f2) value(:f1, :f2)\", use(f1), use(f2); // If the ID used for the above row is needed later, get it: if ( !sql.get_last_insert_id(\"table\", id) ) ... unexpected error, handle appropriately ... } Please note that, generally speaking, with the backends implementing get_last_insert_id() , it is impossible to predict the next auto-generated value before the row is actually inserted due to the possibility of concurrent access to the database from another client. However if the application has exclusive access to the database, it can be assumed that the next value will be equal to the sum of the last insert ID and the increment used for the column (in most cases the increment will be 1 and some databases only support using 1 as the increment, but others, e.g. Microsoft SQL Server with its IDENTITY(start, increment) columns, can use arbitrary values). In particular, calling get_last_insert_id() for the just created, and still empty, table returns 0 (or start - increment in the SQL Server case), so that adding the increment value to it still corresponds to the next value that will be used.","title":"Sequences"},{"location":"beyond/#portability-note_1","text":"These methods are currently only implemented in Firebird, MySQL, ODBC, PostgreSQL and SQLite3 backends.","title":"Portability note"},{"location":"beyond/#beyond-soci-api","text":"As the original name of the library (Simple Oracle Call Interface) clearly stated, SOCI is intended to be a simple library, targeting the majority of needs in regular C++ application. We do not claim that everything can be done with SOCI and it was never the intent of the library. What is important, though, is that the simplicity of the library does not prevent the client applications from reaching into the low-level specifics of each database backend in order to achieve special configuration or performance goals. Most of the SOCI classes have the getBackEnd method, which returns the pointer to the actual backend object that implements the given functionality. The knowledge of the actual backend allows the client application to get access to all low-level details that are involved. blob b(sql); oracle_session_back_end * sessionBackEnd = static_cast<oracle_session_back_end *>(sql.get_back_end()); oracle_blob_back_end * blobBackEnd = static_cast<oracle_blob_back_end *>(b.get_back_end()); OCILobDisableBuffering(sessionBackEnd->svchp_, sessionBackEnd->errhp_, blobBackEnd->lobp_); The above example retrieves the rowid (\"something\" that identifies the row in the table) from the table and uses the get_back_end function to extract the actual object that implements this functionality. Assuming that it is the \"postgresql\" backend which is in use, the downcast is performed to use the postgresql_rowid_back_end interface to get the actual OID value that is a physical, low-level implementation of row identifier on PostgreSQL databases. In order for any of the above to compile, you have to explicitly #include the appropriate backend's header file. Please see the header file related to the given backend to learn what low-level handles and descriptors are available.","title":"Beyond SOCI API"},{"location":"binding/","text":"Data Binding SOCI provides mechanisms to bind local buffers for input and output data. Note: The Oracle documentation uses two terms: defining (for instructing the library where the output data should go) and binding (for the input data and input/output PL/SQL parameters). For the sake of simplicity, SOCI uses the term binding for both of these. Binding output data (into) The into expression is used to add binding information to the statement: int count; sql << \"select count(*) from person\", into(count); string name; sql << \"select name from person where id = 7\", into(name); In the above examples, some data is retrieved from the database and transmitted into the given local variable. There should be as many into elements as there are expected columns in the result (see dynamic resultset binding for the exception to this rule). Binding input data (use) The use expression associates the SQL placeholder (written with colon) with the local data: int val = 7; sql << \"insert into numbers(val) values(:val)\", use(val); In the above statement, the first \"val\" is a column name (assuming that there is appropriate table numbers with this column), the second \"val\" (with colon) is a placeholder and its name is ignored here, and the third \"val\" is a name of local variable. To better understand the meaning of each \"val\" above, consider also: int number = 7; sql << \"insert into numbers(val) values(:blabla)\", use(number); Both examples above will insert the value of some local variable into the table numbers - we say that the local variable is used in the SQL statement. There should be as many use elements as there are parameters used in the SQL query. Object lifetime and immutability SOCI assumes that local variables provided as use elements live at least as long at it takes to execute the whole statement. In short statement forms like above, the statement is executed sometime at the end of the full expression and the whole process is driven by the invisible temporary object handled by the library. If the data provided by user comes from another temporary variable, it might be possible for the compiler to arrange them in a way that the user data will be destroyed before the statement will have its chance to execute, referencing objects that no longer exist: // Dangerous code! string getNameFromSomewhere(); sql << \"insert into person(name) values(:n)\", use(getNameFromSomewhere()); In the above example, the data passed to the database comes from the temporary variable that is a result of call to getNameFromSomewhere - this should be avoided and named variables should be used to ensure safe lifetime relations: // Safe code string getNameFromSomewhere(); string name = getNameFromSomewhere(); sql << \"insert into person(name) values(:n)\", use(name); It is still possible to provide const data for use elements. Note that some database servers, like Oracle, allow PL/SQL procedures to modify their in/out parameters - this is detected by the SOCI library and an error is reported if the database attempts to modify the use element that holds const data. The above example can be ultimately written in the following way: // Safe and efficient code string getNameFromSomewhere(); string const& name = getNameFromSomewhere(); sql << \"insert into person(name) values(:n)\", use(name); Binding by position If there is more output or input \"holes\" in the single statement, it is possible to use many into and use expressions, separated by commas, where each expression will be responsible for the consecutive \"hole\" in the statement: string firstName = \"John\", lastName = \"Smith\"; int personId = 7; sql << \"insert into person(id, firstname, lastname) values(:id, :fn, :ln)\", use(personId), use(firstName), use(lastName); sql << \"select firstname, lastname from person where id = :id\", into(firstName), into(lastName), use(personId); In the code above, the order of \"holes\" in the SQL statement and the order of into and use expression should match. Binding by name The SQL placeholders that have their names (with colon) can be bound by name to clearly associate the local variable with the given placeholder. This explicit naming allows to use different order of elements: string firstName = \"John\", lastName = \"Smith\"; int personId = 7; sql << \"insert into person(id, firstname, lastname) values(:id, :fn, :ln)\", use(firstName, \"fn\"), use(lastName, \"ln\"), use(personId, \"id\"); or bind the same local data to many \"holes\" at the same time: string addr = \"...\"; sql << \"update person\" \" set mainaddress = :addr, contactaddress = :addr\" \" where id = 7\", use(addr, \"addr\"); Bulk operations Bulk operations allow the user to bind, as into or use element, whole vectors of objects. This allows the database backend to optimize access and data transfer and benefit from the fact that std::vector stores data in contiguous memory blocks (the actual optimization depends on the backend and the capability of the underlying data base server). It is possible to use the vector as a data source: std::vector<int> v; // ... sql << \"insert into t ...\", use(v); as well as a destination: std::vector<int> v; v.resize(100); sql << \"select ...\", into(v); In the latter case the initial size of the vector defines the maximum number of data elements that the user is willing to accept and after executing the query the vector will be automatically resized to reflect that actual number of rows that were read and transmitted. That is, the vector will be automatically shrunk if the amount of data that was available was smaller than requested. It is also possible to operate on the chosen sub-range of the vector: std::vector<int> v; // ... std::size_t begin = ...; std::size_t end = ...; sql << \"insert into t ...\", use(v, begin, end); // or: sql << \"select ...\", into(v, begin, end); Above, only the sub-range of the vector is used for data transfer and in the case of into operation, the end variable will be automatically adjusted to reflect the amount of data that was actually transmitted, but the vector object as a whole will retain its initial size. Bulk operations can also involve indicators, see below. Bulk operations support user-defined data types, if they have appropriate conversion routines defined.","title":"Data Binding"},{"location":"binding/#data-binding","text":"SOCI provides mechanisms to bind local buffers for input and output data. Note: The Oracle documentation uses two terms: defining (for instructing the library where the output data should go) and binding (for the input data and input/output PL/SQL parameters). For the sake of simplicity, SOCI uses the term binding for both of these.","title":"Data Binding"},{"location":"binding/#binding-output-data-into","text":"The into expression is used to add binding information to the statement: int count; sql << \"select count(*) from person\", into(count); string name; sql << \"select name from person where id = 7\", into(name); In the above examples, some data is retrieved from the database and transmitted into the given local variable. There should be as many into elements as there are expected columns in the result (see dynamic resultset binding for the exception to this rule).","title":"Binding output data (into)"},{"location":"binding/#binding-input-data-use","text":"The use expression associates the SQL placeholder (written with colon) with the local data: int val = 7; sql << \"insert into numbers(val) values(:val)\", use(val); In the above statement, the first \"val\" is a column name (assuming that there is appropriate table numbers with this column), the second \"val\" (with colon) is a placeholder and its name is ignored here, and the third \"val\" is a name of local variable. To better understand the meaning of each \"val\" above, consider also: int number = 7; sql << \"insert into numbers(val) values(:blabla)\", use(number); Both examples above will insert the value of some local variable into the table numbers - we say that the local variable is used in the SQL statement. There should be as many use elements as there are parameters used in the SQL query.","title":"Binding input data (use)"},{"location":"binding/#object-lifetime-and-immutability","text":"SOCI assumes that local variables provided as use elements live at least as long at it takes to execute the whole statement. In short statement forms like above, the statement is executed sometime at the end of the full expression and the whole process is driven by the invisible temporary object handled by the library. If the data provided by user comes from another temporary variable, it might be possible for the compiler to arrange them in a way that the user data will be destroyed before the statement will have its chance to execute, referencing objects that no longer exist: // Dangerous code! string getNameFromSomewhere(); sql << \"insert into person(name) values(:n)\", use(getNameFromSomewhere()); In the above example, the data passed to the database comes from the temporary variable that is a result of call to getNameFromSomewhere - this should be avoided and named variables should be used to ensure safe lifetime relations: // Safe code string getNameFromSomewhere(); string name = getNameFromSomewhere(); sql << \"insert into person(name) values(:n)\", use(name); It is still possible to provide const data for use elements. Note that some database servers, like Oracle, allow PL/SQL procedures to modify their in/out parameters - this is detected by the SOCI library and an error is reported if the database attempts to modify the use element that holds const data. The above example can be ultimately written in the following way: // Safe and efficient code string getNameFromSomewhere(); string const& name = getNameFromSomewhere(); sql << \"insert into person(name) values(:n)\", use(name);","title":"Object lifetime and immutability"},{"location":"binding/#binding-by-position","text":"If there is more output or input \"holes\" in the single statement, it is possible to use many into and use expressions, separated by commas, where each expression will be responsible for the consecutive \"hole\" in the statement: string firstName = \"John\", lastName = \"Smith\"; int personId = 7; sql << \"insert into person(id, firstname, lastname) values(:id, :fn, :ln)\", use(personId), use(firstName), use(lastName); sql << \"select firstname, lastname from person where id = :id\", into(firstName), into(lastName), use(personId); In the code above, the order of \"holes\" in the SQL statement and the order of into and use expression should match.","title":"Binding by position"},{"location":"binding/#binding-by-name","text":"The SQL placeholders that have their names (with colon) can be bound by name to clearly associate the local variable with the given placeholder. This explicit naming allows to use different order of elements: string firstName = \"John\", lastName = \"Smith\"; int personId = 7; sql << \"insert into person(id, firstname, lastname) values(:id, :fn, :ln)\", use(firstName, \"fn\"), use(lastName, \"ln\"), use(personId, \"id\"); or bind the same local data to many \"holes\" at the same time: string addr = \"...\"; sql << \"update person\" \" set mainaddress = :addr, contactaddress = :addr\" \" where id = 7\", use(addr, \"addr\");","title":"Binding by name"},{"location":"binding/#bulk-operations","text":"Bulk operations allow the user to bind, as into or use element, whole vectors of objects. This allows the database backend to optimize access and data transfer and benefit from the fact that std::vector stores data in contiguous memory blocks (the actual optimization depends on the backend and the capability of the underlying data base server). It is possible to use the vector as a data source: std::vector<int> v; // ... sql << \"insert into t ...\", use(v); as well as a destination: std::vector<int> v; v.resize(100); sql << \"select ...\", into(v); In the latter case the initial size of the vector defines the maximum number of data elements that the user is willing to accept and after executing the query the vector will be automatically resized to reflect that actual number of rows that were read and transmitted. That is, the vector will be automatically shrunk if the amount of data that was available was smaller than requested. It is also possible to operate on the chosen sub-range of the vector: std::vector<int> v; // ... std::size_t begin = ...; std::size_t end = ...; sql << \"insert into t ...\", use(v, begin, end); // or: sql << \"select ...\", into(v, begin, end); Above, only the sub-range of the vector is used for data transfer and in the case of into operation, the end variable will be automatically adjusted to reflect the amount of data that was actually transmitted, but the vector object as a whole will retain its initial size. Bulk operations can also involve indicators, see below. Bulk operations support user-defined data types, if they have appropriate conversion routines defined.","title":"Bulk operations"},{"location":"boost/","text":"Boost Integration The SOCI user code can be easily integrated with the Boost library thanks to the very flexible type conversion facility. The integration with Boost types is optional and is not enabled by default, which means that SOCI can also be compiled and used without any dependency on Boost. In order to enable the support for any of the above types, the user needs to either include one of these headers: #include <boost-optional.h> #include <boost-tuple.h> #include <boost-fusion.h> #include <boost-gregorian-date.h> or to define the SOCI_USE_BOOST macro before including the soci.h main header file. Boost.Optional boost::optional<T> provides an alternative way to support the null data condition and as such relieves the user from necessity to handle separate indicator values. The boost::optional<T> objects can be used everywhere where the regular user provided values are expected. Example: boost::optional<string> name; sql << \"select name from person where id = 7\", into(name); if (name.is_initialized()) { // OK, the name was retrieved and is not-null cout << \"The name is \" << name.get(); } else { // the name is null } The boost::optional<T> objects are fully supported for both into and use elements, in both single and vector forms. They can be also used for user-defined data types. Boost.Tuple boost::tuple<T1, ...> allows to work with whole rows of information and in some cases can be more convenient to use than the more dynamically-oriented row type. boost::tuple<string, string, int> person; sql << \"select name, phone, salary from persons where ...\", into(person); Tuples are supported for both into and use elements. They can be used with rowset as well. Tuples can be also composed with boost::optional<T> boost::tuple<string, boost::optional<string>, int> person; sql << \"select name, phone, salary from persons where ...\", into(person); if (person.get<1>().is_initialized()) { // the given person has a phone number } else { // this person does not have a phone number } Boost.Fusion The boost::fusion::vector types are supported in the same way as tuples. Note: Support for boost::fusion::vector is enabled only if the detected Boost version is at least 1.35. Boost.DateTime The boost::gregorian::date is provided as a conversion for base type std::tm and can be used as a replacement for it.","title":"Boost"},{"location":"boost/#boost-integration","text":"The SOCI user code can be easily integrated with the Boost library thanks to the very flexible type conversion facility. The integration with Boost types is optional and is not enabled by default, which means that SOCI can also be compiled and used without any dependency on Boost. In order to enable the support for any of the above types, the user needs to either include one of these headers: #include <boost-optional.h> #include <boost-tuple.h> #include <boost-fusion.h> #include <boost-gregorian-date.h> or to define the SOCI_USE_BOOST macro before including the soci.h main header file.","title":"Boost Integration"},{"location":"boost/#boostoptional","text":"boost::optional<T> provides an alternative way to support the null data condition and as such relieves the user from necessity to handle separate indicator values. The boost::optional<T> objects can be used everywhere where the regular user provided values are expected. Example: boost::optional<string> name; sql << \"select name from person where id = 7\", into(name); if (name.is_initialized()) { // OK, the name was retrieved and is not-null cout << \"The name is \" << name.get(); } else { // the name is null } The boost::optional<T> objects are fully supported for both into and use elements, in both single and vector forms. They can be also used for user-defined data types.","title":"Boost.Optional"},{"location":"boost/#boosttuple","text":"boost::tuple<T1, ...> allows to work with whole rows of information and in some cases can be more convenient to use than the more dynamically-oriented row type. boost::tuple<string, string, int> person; sql << \"select name, phone, salary from persons where ...\", into(person); Tuples are supported for both into and use elements. They can be used with rowset as well. Tuples can be also composed with boost::optional<T> boost::tuple<string, boost::optional<string>, int> person; sql << \"select name, phone, salary from persons where ...\", into(person); if (person.get<1>().is_initialized()) { // the given person has a phone number } else { // this person does not have a phone number }","title":"Boost.Tuple"},{"location":"boost/#boostfusion","text":"The boost::fusion::vector types are supported in the same way as tuples. Note: Support for boost::fusion::vector is enabled only if the detected Boost version is at least 1.35.","title":"Boost.Fusion"},{"location":"boost/#boostdatetime","text":"The boost::gregorian::date is provided as a conversion for base type std::tm and can be used as a replacement for it.","title":"Boost.DateTime"},{"location":"connections/","text":"Connections The session class encapsulates the database connection and other backend-related details, which are common to all the statements that will be later executed. It has a couple of overloaded constructors. Using backend factory The most basic one expects two parameters: the requested backend factory object and the generic connection string, which meaning is backend-dependent. Example: session sql(oracle, \"service=orcl user=scott password=tiger\"); Another example might be: session sql(postgresql, \"dbname=mydb\"); Above, the sql object is a local (automatic) object that encapsulates the connection. This session constructor either connects successfully, or throws an exception. Portability note In case of SOCI linked against DLLs on Windows, the factory objects are not exported from the DLLs. In order to avoid linker errors, access factory objects via dedicated backend functions provided (eg. factory_postgresql() ). Using loadable backends Dynamically loadable backends are compiled as shared libraries and allow to select backends at run-time by name. The usage is similar to the above, but instead of providing the factory object, the backend name is expected: session sql(\"postgresql\", \"dbname=mydb\"); For convenience, the URL-like form that combines both the backend name with connection parameters is supported as well: session sql(\"postgresql://dbname=mydb\"); The last two constructors described above try to locate the shared library with the name libsoci_ABC.so (or libsoci_ABC.dll on Windows), where ABC is the backend name. In the above examples, the expected library name will be libsoci_postgresql.so for Unix-like systems. The most general form of the constructor takes a single object of connection_parameters type which contains a pointer to the backend to use, the connection string and also any connection options. Using this constructor is the only way to pass any non-default options to the backend. For example, to suppress any interactive prompts when using ODBC backend you could do: connection_parameters parameters(\"odbc\", \"DSN=mydb\"); parameters.set_option(odbc_option_driver_complete, \"0\" /* SQL_DRIVER_NOPROMPT */); session sql(parameters); Notice that you need to #include<soci-odbc.h> to obtain the option name declaration. The existing options are described in the backend-specific part of the documentation. IBM DB2 driver for ODBC and CLI also support the driver completion requests. So, the DB2 backend provides similar option db2_option_driver_complete with #include <soci-db2.h> required to obtain the option name. Environment configuration The SOCI_BACKENDS_PATH environment variable defines the set of paths where the shared libraries will be searched for. There can be many paths, separated by colons, and they are used from left to right until the library with the appropriate name is found. If this variable is not set or is empty, the current directory is used as a default path for dynamically loaded backends. Using registered backends The run-time selection of backends is also supported with libraries linked statically. Each backend provides a separate function of the form register_factory_*name* , where *name* is a backend name. Thus: extern \"C\" void register_factory_postgresql(); // ... register_factory_postgresql(); session sql(\"postgresql://dbname=mydb\"); The above example registers the backend for PostgreSQL and later creates the session object for that backend. This form is provided for those projects that prefer static linking but still wish to benefit from run-time backend selection. An alternative way to set up the session is to create it in the disconnected state and connect later: session sql; // some time later: sql.open(postgresql, \"dbname=mydb\"); // or: sql.open(\"postgresql://dbname=mydb\"); // or also: connection_parameters parameters(\"postgresql\", \"dbname=mydb\"); sql.open(parameters); The rules for backend naming are the same as with the constructors described above. The session can be also explicitly close d and reconnect ed, which can help with basic session error recovery, e.g. the application could check if is_connected still returns true after getting an error and attempt to call reconnect if it doesn't. The reconnect function has no parameters and attempts to use the same values as those provided with earlier constructor or open calls. See also the page devoted to multithreading for a detailed description of connection pools. It is possible to have many active session s at the same time, even using different backends. Portability note The following backend factories are currently (as of 3.1.0 release) available: mysql (requires #include \"soci-mysql.h\" ) oracle (requires #include \"soci-oracle.h\" ) postgresql (requires #include \"soci-postgresql.h\" ) The following backends are also available, with various levels of completeness: sqlite3 (requires #include \"soci-sqlite3.h\" ) odbc (requires #include \"soci-odbc.h\" ) firebird (requires #include \"soci-firebird.h\" ) db2 (requires #include \"soci-db2.h\" ) Connection failover The failover_callback interface can be used as a callback channel for notifications of events that are automatically processed when the session is forcibly closed due to connectivity problems. The user can override the following methods: // Called when the failover operation has started, // after discovering connectivity problems. virtual void started(); // Called after successful failover and creating a new connection; // the sql parameter denotes the new connection and allows the user // to replay any initial sequence of commands (like session configuration). virtual void finished(session & sql); // Called when the attempt to reconnect failed, // if the user code sets the retry parameter to true, // then new connection will be attempted; // the newTarget connection string is a hint that can be ignored // by external means. virtual void failed(bool & retry, std::string & newTarget); // Called when there was a failure that prevents further failover attempts. virtual void aborted(); The user-provided callback implementation can be installed (or reset) with: sql.set_failover_callback(myCallback); Portability note The failover_callback functionality is currently supported only by PostgreSQL and Oracle backends (in the latter case the failover mechanism is governed by the Oracle-specific cluster configuration settings). Other backends allow the callback object to be installed, but will ignore it and will not generate notification calls.","title":"Connections"},{"location":"connections/#connections","text":"The session class encapsulates the database connection and other backend-related details, which are common to all the statements that will be later executed. It has a couple of overloaded constructors.","title":"Connections"},{"location":"connections/#using-backend-factory","text":"The most basic one expects two parameters: the requested backend factory object and the generic connection string, which meaning is backend-dependent. Example: session sql(oracle, \"service=orcl user=scott password=tiger\"); Another example might be: session sql(postgresql, \"dbname=mydb\"); Above, the sql object is a local (automatic) object that encapsulates the connection. This session constructor either connects successfully, or throws an exception.","title":"Using backend factory"},{"location":"connections/#portability-note","text":"In case of SOCI linked against DLLs on Windows, the factory objects are not exported from the DLLs. In order to avoid linker errors, access factory objects via dedicated backend functions provided (eg. factory_postgresql() ).","title":"Portability note"},{"location":"connections/#using-loadable-backends","text":"Dynamically loadable backends are compiled as shared libraries and allow to select backends at run-time by name. The usage is similar to the above, but instead of providing the factory object, the backend name is expected: session sql(\"postgresql\", \"dbname=mydb\"); For convenience, the URL-like form that combines both the backend name with connection parameters is supported as well: session sql(\"postgresql://dbname=mydb\"); The last two constructors described above try to locate the shared library with the name libsoci_ABC.so (or libsoci_ABC.dll on Windows), where ABC is the backend name. In the above examples, the expected library name will be libsoci_postgresql.so for Unix-like systems. The most general form of the constructor takes a single object of connection_parameters type which contains a pointer to the backend to use, the connection string and also any connection options. Using this constructor is the only way to pass any non-default options to the backend. For example, to suppress any interactive prompts when using ODBC backend you could do: connection_parameters parameters(\"odbc\", \"DSN=mydb\"); parameters.set_option(odbc_option_driver_complete, \"0\" /* SQL_DRIVER_NOPROMPT */); session sql(parameters); Notice that you need to #include<soci-odbc.h> to obtain the option name declaration. The existing options are described in the backend-specific part of the documentation. IBM DB2 driver for ODBC and CLI also support the driver completion requests. So, the DB2 backend provides similar option db2_option_driver_complete with #include <soci-db2.h> required to obtain the option name.","title":"Using loadable backends"},{"location":"connections/#environment-configuration","text":"The SOCI_BACKENDS_PATH environment variable defines the set of paths where the shared libraries will be searched for. There can be many paths, separated by colons, and they are used from left to right until the library with the appropriate name is found. If this variable is not set or is empty, the current directory is used as a default path for dynamically loaded backends.","title":"Environment configuration"},{"location":"connections/#using-registered-backends","text":"The run-time selection of backends is also supported with libraries linked statically. Each backend provides a separate function of the form register_factory_*name* , where *name* is a backend name. Thus: extern \"C\" void register_factory_postgresql(); // ... register_factory_postgresql(); session sql(\"postgresql://dbname=mydb\"); The above example registers the backend for PostgreSQL and later creates the session object for that backend. This form is provided for those projects that prefer static linking but still wish to benefit from run-time backend selection. An alternative way to set up the session is to create it in the disconnected state and connect later: session sql; // some time later: sql.open(postgresql, \"dbname=mydb\"); // or: sql.open(\"postgresql://dbname=mydb\"); // or also: connection_parameters parameters(\"postgresql\", \"dbname=mydb\"); sql.open(parameters); The rules for backend naming are the same as with the constructors described above. The session can be also explicitly close d and reconnect ed, which can help with basic session error recovery, e.g. the application could check if is_connected still returns true after getting an error and attempt to call reconnect if it doesn't. The reconnect function has no parameters and attempts to use the same values as those provided with earlier constructor or open calls. See also the page devoted to multithreading for a detailed description of connection pools. It is possible to have many active session s at the same time, even using different backends.","title":"Using registered backends"},{"location":"connections/#portability-note_1","text":"The following backend factories are currently (as of 3.1.0 release) available: mysql (requires #include \"soci-mysql.h\" ) oracle (requires #include \"soci-oracle.h\" ) postgresql (requires #include \"soci-postgresql.h\" ) The following backends are also available, with various levels of completeness: sqlite3 (requires #include \"soci-sqlite3.h\" ) odbc (requires #include \"soci-odbc.h\" ) firebird (requires #include \"soci-firebird.h\" ) db2 (requires #include \"soci-db2.h\" )","title":"Portability note"},{"location":"connections/#connection-failover","text":"The failover_callback interface can be used as a callback channel for notifications of events that are automatically processed when the session is forcibly closed due to connectivity problems. The user can override the following methods: // Called when the failover operation has started, // after discovering connectivity problems. virtual void started(); // Called after successful failover and creating a new connection; // the sql parameter denotes the new connection and allows the user // to replay any initial sequence of commands (like session configuration). virtual void finished(session & sql); // Called when the attempt to reconnect failed, // if the user code sets the retry parameter to true, // then new connection will be attempted; // the newTarget connection string is a hint that can be ignored // by external means. virtual void failed(bool & retry, std::string & newTarget); // Called when there was a failure that prevents further failover attempts. virtual void aborted(); The user-provided callback implementation can be installed (or reset) with: sql.set_failover_callback(myCallback);","title":"Connection failover"},{"location":"connections/#portability-note_2","text":"The failover_callback functionality is currently supported only by PostgreSQL and Oracle backends (in the latter case the failover mechanism is governed by the Oracle-specific cluster configuration settings). Other backends allow the callback object to be installed, but will ignore it and will not generate notification calls.","title":"Portability note"},{"location":"errors/","text":"Errors All DB-related errors manifest themselves as exceptions of type soci_error , which is derived from std::runtime_error . This allows to handle database errors within the standard exception framework: int main() { try { // regular code } catch (std::exception const & e) { cerr << \"Bang! \" << e.what() << endl; } } The soci_error class exposes two public functions: The get_error_message() const function returns std::string with a brief error message, without any additional information that can be present in the full error message returned by what() . The get_error_category() const function returns one of the error_category enumeration values, which allows the user to portably react to some subset of common errors. For example, connection_error or constraint_violation have meanings that are common across different database backends, even though the actual mechanics might differ. Portability Error categories are not universally supported and there is no claim that all possible errors that are reported by the database server are covered or interpreted. If the error category is not recognized by the backend, it defaults to unknown . MySQL The MySQL backend can throw instances of the mysql_soci_error , which is publicly derived from soci_error and has an additional public err_num_ member containing the MySQL error code (as returned by mysql_errno() ): int main() { try { // regular code } catch (soci::mysql_soci_error const & e) { cerr << \"MySQL error: \" << e.err_num_ << \" \" << e.what() << endl; } catch (soci::exception const & e) { cerr << \"Some other error: \" << e.what() << endl; } } Oracle The Oracle backend can also throw the instances of the oracle_soci_error , which is publicly derived from soci_error and has an additional public err_num_ member containing the Oracle error code: int main() { try { // regular code } catch (soci::oracle_soci_error const & e) { cerr << \"Oracle error: \" << e.err_num_ << \" \" << e.what() << endl; } catch (soci::exception const & e) { cerr << \"Some other error: \" << e.what() << endl; } } PostgreSQL The PostgreSQL backend can also throw the instances of the postgresql_soci_error , which is publicly derived from soci_error and has an additional public sqlstate() member function returning the five-character \"SQLSTATE\" error code: int main() { try { // regular code } catch (soci::postgresql_soci_error const & e) { cerr << \"PostgreSQL error: \" << e.sqlstate() << \" \" << e.what() << endl; } catch (soci::exception const & e) { cerr << \"Some other error: \" << e.what() << endl; } }","title":"Errors"},{"location":"errors/#errors","text":"All DB-related errors manifest themselves as exceptions of type soci_error , which is derived from std::runtime_error . This allows to handle database errors within the standard exception framework: int main() { try { // regular code } catch (std::exception const & e) { cerr << \"Bang! \" << e.what() << endl; } } The soci_error class exposes two public functions: The get_error_message() const function returns std::string with a brief error message, without any additional information that can be present in the full error message returned by what() . The get_error_category() const function returns one of the error_category enumeration values, which allows the user to portably react to some subset of common errors. For example, connection_error or constraint_violation have meanings that are common across different database backends, even though the actual mechanics might differ.","title":"Errors"},{"location":"errors/#portability","text":"Error categories are not universally supported and there is no claim that all possible errors that are reported by the database server are covered or interpreted. If the error category is not recognized by the backend, it defaults to unknown .","title":"Portability"},{"location":"errors/#mysql","text":"The MySQL backend can throw instances of the mysql_soci_error , which is publicly derived from soci_error and has an additional public err_num_ member containing the MySQL error code (as returned by mysql_errno() ): int main() { try { // regular code } catch (soci::mysql_soci_error const & e) { cerr << \"MySQL error: \" << e.err_num_ << \" \" << e.what() << endl; } catch (soci::exception const & e) { cerr << \"Some other error: \" << e.what() << endl; } }","title":"MySQL"},{"location":"errors/#oracle","text":"The Oracle backend can also throw the instances of the oracle_soci_error , which is publicly derived from soci_error and has an additional public err_num_ member containing the Oracle error code: int main() { try { // regular code } catch (soci::oracle_soci_error const & e) { cerr << \"Oracle error: \" << e.err_num_ << \" \" << e.what() << endl; } catch (soci::exception const & e) { cerr << \"Some other error: \" << e.what() << endl; } }","title":"Oracle"},{"location":"errors/#postgresql","text":"The PostgreSQL backend can also throw the instances of the postgresql_soci_error , which is publicly derived from soci_error and has an additional public sqlstate() member function returning the five-character \"SQLSTATE\" error code: int main() { try { // regular code } catch (soci::postgresql_soci_error const & e) { cerr << \"PostgreSQL error: \" << e.sqlstate() << \" \" << e.what() << endl; } catch (soci::exception const & e) { cerr << \"Some other error: \" << e.what() << endl; } }","title":"PostgreSQL"},{"location":"faq/","text":"FAQ This part of the documentation is supposed to gather in a single place the usual questions (and answers) about SOCI with regard to the design decisions that have shaped it. Q: Why \"SOCI\"? SOCI was initially developed in the environment where Oracle was the main database technology in use. As a wrapper for the native OCI API (Oracle Call Interface), the name \"Simple Oracle Call Interface\" was quite obvious - until the 2.0 release, when the internal architecture was largely redesigned to allow the use of backends that support other database servers. We have kept the same name to indicate that Oracle is the main supported technology in the sense that the library includes only those features that were naturally implemented in Oracle. With the 2.1 release of the library, two new backends were added (MySQL and SQLite3) and we decided to drop the original full name so that new users looking for a library supporting any of these simpler libraries are not discouraged by seeing \"Oracle\" somewhere in the name. The other possible interpretation was \"Syntax Oriented Call Interface\", which stresses the fact that SOCI was built to support the most natural and easy interface for the user that is similar to the Embedded SQL concept (see below). But on the other hand, SOCI also provides other features (like object-relational mapping) and as a whole it is not just \"emulator\" of the Embedded SQL. With all these considerations in mind, SOCI is just \"SOCI - The C++ Database Access Library\". Still, Oracle is considered to be the main driving server technology in terms of the set of features that are supported by the library. This also means that backends for other servers might need to work around some of the imposed idioms and protocols, but already available and well-working PostgreSQL, MySQL and SQLite3 backends show that it's actually not that bad and the abstractions provided by the library are actually very universal. Of course, some of the features that were provided for Oracle might not be supported for all other servers, but we think that it's better to have one leading technology (where at least one group is fully happy) instead of some \"common denominator\" for all databases (where nobody is happy). Q: Where the basic SOCI syntax comes from? The basic SOCI syntax was inspired by the Embedded SQL, which is part of the SQL standard, supported by the major DB technologies and even available as built-in part of the languages used in some DB-oriented integrated development environments. The term \"Embedded SQL\" is enough for Google to spit millions of references - one of the typical examples is: { int a; /* ... */ EXEC SQL SELECT salary INTO :a FROM Employee WHERE SSN=876543210; /* ... */ printf(\"The salary is %d\\n\", a); /* ... */ } The above is not a regular C (nor C++) code, of course. It's the mix of C and SQL and there is a separate, pecialized preprocessor needed to convert it to something that the actual C (or C++) compiler will be able to understand. This means that the compilation of the program using embedded SQL is two-phase: preprocess the embedded SQL part and compile the result. This two-phase development is quite troublesome, especially when it comes to debugging. Yet, the advantage of it is that the code expresses the programmer's intents in a very straightforward way: read something from the database and put it into the local variable. Just like that. The SOCI library was born as an answer to the following question: is it possible to have the same expressive power without the disadvantages of two-phase builds? The following was chosen to be the basic SOCI syntax that can mirror the above Embedded SQL example: int a; sql << \"SELECT salary FROM Employee WHERE SSN=876543210\", into(a); (as you see, SOCI changes the order of elements a little bit, so that the SQL query is separate and not mixed with other elements) Apart from mimicking the Embedded SQL techniques in the regular, fully standard C++ code, the above syntax has the following benefit: it is minimal with respect to what has to be said. Every single piece above is needed and expresses something important, like: which session should be used (the client can be connected to many databases at the same time) - here, the sql object encapsulates the session, what SQL query should be executed - here, it's the string literal, but it could be also a std::string variable, where to put the result - here, the local variable a will receive the result. Everything else is just a couple of operators that allow to treat the whole as a single expression. It's rather difficult to remove anything from this example. The fact that the basic SOCI syntax is minimal (but without being obscure at the same time, see below) means that the programmer does not need to bother with unnecessary noise that some other database libraries impose. We hope that after having written one line of code like above by themselves, most programmers will react with something like \"how obvious!\" instead of \"how advanced!\". Q: Why should I use SQL queries as strings in my program? I prefer the query to be generated or composed piece-by-piece by separate functions. First, you don't need to use SQL queries as string literals. In bigger projects it is a common practice to store SQL queries externally (in a file, or in a... database) and load them before use. This means that they are not necessarily expected to appear in the program code, as they do in our simple code examples and the advantage of separating them from the source code of the main program is, among others, the possibility to optimize and tune the SQL queries without recompilation and relinking of the whole program. What is the most important, though, is that SOCI does not try to mess with the text of the query (apart from very few cases), which means that the database server will get exactly the same text of the query as is used in the program. The advantage of this is that there is no new SQL-like (or even SQL- un like) syntax that you would need to learn, and also that it's much easier to convince a typical DBA to help with SQL tuning or other specialized activities, if he is given the material in the form that is not polluted with any foreign abstractions. Q: Why not some stream-like interface, which is well-known to all C++ programmers? An example of the stream-like interface might be something like this (this is imaginary syntax, not supported by SOCI): sql.exec(\"select a, b, c from some_table\"); while (!sql.eof()) { int a, b, c; sql >> a >> b >> c; // ... } We think that the data stored in the relational database should be treated as a set of relations - which is exactly what it is. This means that what is read from the database as a result of some SQL query is a set of rows . This set might be ordered, but it is still a set of rows, not a uniformly flat list of values. This distinction might seem to be unnecessarily low-level and that the uniform stream-like presentation of data is more preferable, but it's actually the other way round - the set of rows is something more structured - and that structure was designed into the database - than the flat stream and is therefore less prone to programming errors like miscounting the number of values that is expected in each row. Consider the following programming error: sql.exec(\"select a, b from some_table\"); // only TWO columns while (!sql.eof()) { int a, b, c; sql >> a >> b >> c; // this causes \"row-tearing\" // ... } \"How to detect the end of each line in a file\" is a common beginner's question that relates to the use of IOStreams - and this common question clearly shows that for the record-oriented data the stream is not an optimal abstraction. Of course, we don't claim that IOStreams is bad - but we do insist that the record-oriented data is better manipulated in a way that is also record-aware. Having said that, we have provided some form of the stream-like interface, but with the important limitation that the stream is always bound to the single row, so that the row-tearing effect is not possible. In other words, data returned from the database is still structured into rows, but each row can be separately traversed like a stream. We hope that it provides a good balance between convenience and code safety. Q: Why use indicators instead of some special value to discover that something is null? Some programmers are used to indicating the null value by using some special (which means: \"unlikely\" to be ever used) value - for example, to use the smallest integer value to indicate null integer. Or to use empty string to indicate null string. And so on. We think that it's completely wrong . Null (in the database sense) is an information about the data. It describes the state of the data and if it's null, then there's no data at all . Nothing. Null. It does not make any sense to talk about some special value if in fact there is no value at all - especially if we take into account that, for example, the smallest integer value (or whatever else you choose as the \"special\" value) might not be that special in the given application or domain. Thus, SOCI uses a separate indicators to describe the state of exchanged data. It also has an additional benefit of allowing the library to convey more than two states (null and not null). Indeed, the SOCI library uses indicators also to report that the data was read, but truncated (this applies to strings when reading to fixed-length character arrays). Truncation is also an information about the data and as such it's better to have it in addition to the data, not as part of it. Having said that, it is important to point at the Integration with Boost that allows to use boost::optional<T> to conveniently pack together the data and the information about its state. Q: Overloaded comma operator is just obfuscation, I don't like it. Well, consider the following: \"Send the query X to the server Y and put result into variable Z.\" Above, the \"and\" plays a role of the comma. Even if overloading the comma operator is not a very popular practice in C++, some libraries do this, achieving terse and easy to learn syntax. We are pretty sure that in SOCI the comma operator was overloaded with a good effect. Q: The operator<< provides a bad abstraction for the \"input\" statements. Indeed, the operator<< in the basic SOCI syntax shows that something (the query) is sent somewhere (to the server). Some people don't like this, especially when the \"select\" statements are involved. If the high-level idea is to read data from somewhere, then operator<< seems unintuitive to the die-hard IOStreams users. The fact is, however, that the code containing SQL statement already indicates that there is a client-server relationship with some other software component (very likely remote). In such code it does not make any sense to pretend that the communication is one-way only, because it's clear that even the \"select\" statements need to be sent somewhere. This approach is also more uniform and allows to cover other statements like \"drop table\" or alike, where no data is expected to be exchanged at all (and therefore the IOStreams analogies for data exchange have no sense at all). No matter what is the kind of the SQL statement, it is sent to the server and this \"sending\" justifies the choice of operator<< . Using different operators ( operator>> and operator<< ) as a way of distinguishing between different high-level ideas ( reading and writing from the data store, respectively) does make sense on much higher level of abstraction, where the SQL statement itself is already hidden - and we do encourage programmers to use SOCI for implementing such high-level abstractions. For this, the object-relational mapping facilities available in SOCI might prove to be a valuable tool as well, as an effective bridge between the low-level world of SQL statements and the high-level world of user-defined abstract data types. Q: Why the Boost license? We decided to use the Boost license , because it's well recognized in the C++ community, allows us to keep our minimum copyrights, and at the same time allows SOCI to be safely used in commercial projects, without imposing concerns (or just plainuncertainty) typical to other open source licenses, like GPL. We also hope that by choosing the Boost license we have made the life easier for both us and our users. It saves us from answering law-related questions that were already answered on the Boost license info page and it should also give more confidence to our users - especially to those of them, who already accepted the conditions of the Boost license - the just have one license less to analyze. Still, if for any reason the conditions of this license are not acceptable, we encourage the users to contact us directly (see links on the relevant SOCI page) to discuss any remaining concerns.","title":"FAQ"},{"location":"faq/#faq","text":"This part of the documentation is supposed to gather in a single place the usual questions (and answers) about SOCI with regard to the design decisions that have shaped it.","title":"FAQ"},{"location":"faq/#q-why-soci","text":"SOCI was initially developed in the environment where Oracle was the main database technology in use. As a wrapper for the native OCI API (Oracle Call Interface), the name \"Simple Oracle Call Interface\" was quite obvious - until the 2.0 release, when the internal architecture was largely redesigned to allow the use of backends that support other database servers. We have kept the same name to indicate that Oracle is the main supported technology in the sense that the library includes only those features that were naturally implemented in Oracle. With the 2.1 release of the library, two new backends were added (MySQL and SQLite3) and we decided to drop the original full name so that new users looking for a library supporting any of these simpler libraries are not discouraged by seeing \"Oracle\" somewhere in the name. The other possible interpretation was \"Syntax Oriented Call Interface\", which stresses the fact that SOCI was built to support the most natural and easy interface for the user that is similar to the Embedded SQL concept (see below). But on the other hand, SOCI also provides other features (like object-relational mapping) and as a whole it is not just \"emulator\" of the Embedded SQL. With all these considerations in mind, SOCI is just \"SOCI - The C++ Database Access Library\". Still, Oracle is considered to be the main driving server technology in terms of the set of features that are supported by the library. This also means that backends for other servers might need to work around some of the imposed idioms and protocols, but already available and well-working PostgreSQL, MySQL and SQLite3 backends show that it's actually not that bad and the abstractions provided by the library are actually very universal. Of course, some of the features that were provided for Oracle might not be supported for all other servers, but we think that it's better to have one leading technology (where at least one group is fully happy) instead of some \"common denominator\" for all databases (where nobody is happy).","title":"Q: Why \"SOCI\"?"},{"location":"faq/#q-where-the-basic-soci-syntax-comes-from","text":"The basic SOCI syntax was inspired by the Embedded SQL, which is part of the SQL standard, supported by the major DB technologies and even available as built-in part of the languages used in some DB-oriented integrated development environments. The term \"Embedded SQL\" is enough for Google to spit millions of references - one of the typical examples is: { int a; /* ... */ EXEC SQL SELECT salary INTO :a FROM Employee WHERE SSN=876543210; /* ... */ printf(\"The salary is %d\\n\", a); /* ... */ } The above is not a regular C (nor C++) code, of course. It's the mix of C and SQL and there is a separate, pecialized preprocessor needed to convert it to something that the actual C (or C++) compiler will be able to understand. This means that the compilation of the program using embedded SQL is two-phase: preprocess the embedded SQL part and compile the result. This two-phase development is quite troublesome, especially when it comes to debugging. Yet, the advantage of it is that the code expresses the programmer's intents in a very straightforward way: read something from the database and put it into the local variable. Just like that. The SOCI library was born as an answer to the following question: is it possible to have the same expressive power without the disadvantages of two-phase builds? The following was chosen to be the basic SOCI syntax that can mirror the above Embedded SQL example: int a; sql << \"SELECT salary FROM Employee WHERE SSN=876543210\", into(a); (as you see, SOCI changes the order of elements a little bit, so that the SQL query is separate and not mixed with other elements) Apart from mimicking the Embedded SQL techniques in the regular, fully standard C++ code, the above syntax has the following benefit: it is minimal with respect to what has to be said. Every single piece above is needed and expresses something important, like: which session should be used (the client can be connected to many databases at the same time) - here, the sql object encapsulates the session, what SQL query should be executed - here, it's the string literal, but it could be also a std::string variable, where to put the result - here, the local variable a will receive the result. Everything else is just a couple of operators that allow to treat the whole as a single expression. It's rather difficult to remove anything from this example. The fact that the basic SOCI syntax is minimal (but without being obscure at the same time, see below) means that the programmer does not need to bother with unnecessary noise that some other database libraries impose. We hope that after having written one line of code like above by themselves, most programmers will react with something like \"how obvious!\" instead of \"how advanced!\".","title":"Q: Where the basic SOCI syntax comes from?"},{"location":"faq/#q-why-should-i-use-sql-queries-as-strings-in-my-program-i-prefer-the-query-to-be-generated-or-composed-piece-by-piece-by-separate-functions","text":"First, you don't need to use SQL queries as string literals. In bigger projects it is a common practice to store SQL queries externally (in a file, or in a... database) and load them before use. This means that they are not necessarily expected to appear in the program code, as they do in our simple code examples and the advantage of separating them from the source code of the main program is, among others, the possibility to optimize and tune the SQL queries without recompilation and relinking of the whole program. What is the most important, though, is that SOCI does not try to mess with the text of the query (apart from very few cases), which means that the database server will get exactly the same text of the query as is used in the program. The advantage of this is that there is no new SQL-like (or even SQL- un like) syntax that you would need to learn, and also that it's much easier to convince a typical DBA to help with SQL tuning or other specialized activities, if he is given the material in the form that is not polluted with any foreign abstractions.","title":"Q: Why should I use SQL queries as strings in my program? I prefer the query to be generated or composed piece-by-piece by separate functions."},{"location":"faq/#q-why-not-some-stream-like-interface-which-is-well-known-to-all-c-programmers","text":"An example of the stream-like interface might be something like this (this is imaginary syntax, not supported by SOCI): sql.exec(\"select a, b, c from some_table\"); while (!sql.eof()) { int a, b, c; sql >> a >> b >> c; // ... } We think that the data stored in the relational database should be treated as a set of relations - which is exactly what it is. This means that what is read from the database as a result of some SQL query is a set of rows . This set might be ordered, but it is still a set of rows, not a uniformly flat list of values. This distinction might seem to be unnecessarily low-level and that the uniform stream-like presentation of data is more preferable, but it's actually the other way round - the set of rows is something more structured - and that structure was designed into the database - than the flat stream and is therefore less prone to programming errors like miscounting the number of values that is expected in each row. Consider the following programming error: sql.exec(\"select a, b from some_table\"); // only TWO columns while (!sql.eof()) { int a, b, c; sql >> a >> b >> c; // this causes \"row-tearing\" // ... } \"How to detect the end of each line in a file\" is a common beginner's question that relates to the use of IOStreams - and this common question clearly shows that for the record-oriented data the stream is not an optimal abstraction. Of course, we don't claim that IOStreams is bad - but we do insist that the record-oriented data is better manipulated in a way that is also record-aware. Having said that, we have provided some form of the stream-like interface, but with the important limitation that the stream is always bound to the single row, so that the row-tearing effect is not possible. In other words, data returned from the database is still structured into rows, but each row can be separately traversed like a stream. We hope that it provides a good balance between convenience and code safety.","title":"Q: Why not some stream-like interface, which is well-known to all C++ programmers?"},{"location":"faq/#q-why-use-indicators-instead-of-some-special-value-to-discover-that-something-is-null","text":"Some programmers are used to indicating the null value by using some special (which means: \"unlikely\" to be ever used) value - for example, to use the smallest integer value to indicate null integer. Or to use empty string to indicate null string. And so on. We think that it's completely wrong . Null (in the database sense) is an information about the data. It describes the state of the data and if it's null, then there's no data at all . Nothing. Null. It does not make any sense to talk about some special value if in fact there is no value at all - especially if we take into account that, for example, the smallest integer value (or whatever else you choose as the \"special\" value) might not be that special in the given application or domain. Thus, SOCI uses a separate indicators to describe the state of exchanged data. It also has an additional benefit of allowing the library to convey more than two states (null and not null). Indeed, the SOCI library uses indicators also to report that the data was read, but truncated (this applies to strings when reading to fixed-length character arrays). Truncation is also an information about the data and as such it's better to have it in addition to the data, not as part of it. Having said that, it is important to point at the Integration with Boost that allows to use boost::optional<T> to conveniently pack together the data and the information about its state.","title":"Q: Why use indicators instead of some special value to discover that something is null?"},{"location":"faq/#q-overloaded-comma-operator-is-just-obfuscation-i-dont-like-it","text":"Well, consider the following: \"Send the query X to the server Y and put result into variable Z.\" Above, the \"and\" plays a role of the comma. Even if overloading the comma operator is not a very popular practice in C++, some libraries do this, achieving terse and easy to learn syntax. We are pretty sure that in SOCI the comma operator was overloaded with a good effect.","title":"Q: Overloaded comma operator is just obfuscation, I don't like it."},{"location":"faq/#q-the-operator-provides-a-bad-abstraction-for-the-input-statements","text":"Indeed, the operator<< in the basic SOCI syntax shows that something (the query) is sent somewhere (to the server). Some people don't like this, especially when the \"select\" statements are involved. If the high-level idea is to read data from somewhere, then operator<< seems unintuitive to the die-hard IOStreams users. The fact is, however, that the code containing SQL statement already indicates that there is a client-server relationship with some other software component (very likely remote). In such code it does not make any sense to pretend that the communication is one-way only, because it's clear that even the \"select\" statements need to be sent somewhere. This approach is also more uniform and allows to cover other statements like \"drop table\" or alike, where no data is expected to be exchanged at all (and therefore the IOStreams analogies for data exchange have no sense at all). No matter what is the kind of the SQL statement, it is sent to the server and this \"sending\" justifies the choice of operator<< . Using different operators ( operator>> and operator<< ) as a way of distinguishing between different high-level ideas ( reading and writing from the data store, respectively) does make sense on much higher level of abstraction, where the SQL statement itself is already hidden - and we do encourage programmers to use SOCI for implementing such high-level abstractions. For this, the object-relational mapping facilities available in SOCI might prove to be a valuable tool as well, as an effective bridge between the low-level world of SQL statements and the high-level world of user-defined abstract data types.","title":"Q: The operator&lt;&lt; provides a bad abstraction for the \"input\" statements."},{"location":"faq/#q-why-the-boost-license","text":"We decided to use the Boost license , because it's well recognized in the C++ community, allows us to keep our minimum copyrights, and at the same time allows SOCI to be safely used in commercial projects, without imposing concerns (or just plainuncertainty) typical to other open source licenses, like GPL. We also hope that by choosing the Boost license we have made the life easier for both us and our users. It saves us from answering law-related questions that were already answered on the Boost license info page and it should also give more confidence to our users - especially to those of them, who already accepted the conditions of the Boost license - the just have one license less to analyze. Still, if for any reason the conditions of this license are not acceptable, we encourage the users to contact us directly (see links on the relevant SOCI page) to discuss any remaining concerns.","title":"Q: Why the Boost license?"},{"location":"indicators/","text":"Data Indicators In order to support SQL NULL values and other conditions which are not real errors, the concept of indicator is provided. Select with NULL values For example, when the following SQL query is executed: select name from person where id = 7 there are three possible outcomes: there is a person with id = 7 and her name is returned there is a person with id = 7, but she has no name (her name is null in the database table) there is no such person Whereas the first alternative is easy to handle, the other two are more complex. Moreover, they are not necessarily errors from the application's point of view and what's more interesting, they are different and the application may wish to detect which is the case. The following example does this: string name; indicator ind; sql << \"select name from person where id = 7\", into(name, ind); if (sql.got_data()) { switch (ind) { case i_ok: // the data was returned without problems break; case i_null: // there is a person, but he has no name (his name is null) break; case i_truncated: // the name was returned only in part, // because the provided buffer was too short // (not possible with std::string, but possible with char* and char[]) break; } } else { // no such person in the database: notice that indicator will have the // value i_null in this branch because often enough missing value can // be handled in the same way as a null one, but you may also distinguish // between the two cases if necessary, as done here by using got_data() } The use of indicator variable is optional, but if it is not used and the result would be i_null , then the exception is thrown. This means that you should use indicator variables everywhere where the application logic (and database schema) allow the \"attribute not set\" condition. Insert with NULL values Indicator variables can be also used when binding input data, to control whether the data is to be used as provided, or explicitly overridden to be null: int id = 7; string name; indicator ind = i_null; sql << \"insert into person(id, name) values(:id, :name)\", use(id), use(name, ind); In the above example, the row is inserted with name attribute set to null. Bulk operations with NULL values Indicator variables can also be used in conjunction with vector based insert, update, and select statements: vector<string> names(100); vector<indicator> inds; sql << \"select name from person where id = 7\", into(names, inds); The above example retrieves first 100 rows of data (or less). The initial size of names vector provides the (maximum) number of rows that should be read. Both vectors will be automatically resized according to the number of rows that were actually read. The following example inserts null for each value of name: vector<int> ids; vector<string> names; vector<indicator> nameIndicators; for (int i = 0; i != 10; ++i) { ids.push_back(i); names.push_back(\"\"); nameIndicators.push_back(i_null); } sql << \"insert into person(id, name) values(:id, :name)\", use(ids), use(name, nameIndicators); See also Integration with Boost to learn how the Boost.Optional library can be used to handle null data conditions in a more natural way.","title":"Data Indicators"},{"location":"indicators/#data-indicators","text":"In order to support SQL NULL values and other conditions which are not real errors, the concept of indicator is provided.","title":"Data Indicators"},{"location":"indicators/#select-with-null-values","text":"For example, when the following SQL query is executed: select name from person where id = 7 there are three possible outcomes: there is a person with id = 7 and her name is returned there is a person with id = 7, but she has no name (her name is null in the database table) there is no such person Whereas the first alternative is easy to handle, the other two are more complex. Moreover, they are not necessarily errors from the application's point of view and what's more interesting, they are different and the application may wish to detect which is the case. The following example does this: string name; indicator ind; sql << \"select name from person where id = 7\", into(name, ind); if (sql.got_data()) { switch (ind) { case i_ok: // the data was returned without problems break; case i_null: // there is a person, but he has no name (his name is null) break; case i_truncated: // the name was returned only in part, // because the provided buffer was too short // (not possible with std::string, but possible with char* and char[]) break; } } else { // no such person in the database: notice that indicator will have the // value i_null in this branch because often enough missing value can // be handled in the same way as a null one, but you may also distinguish // between the two cases if necessary, as done here by using got_data() } The use of indicator variable is optional, but if it is not used and the result would be i_null , then the exception is thrown. This means that you should use indicator variables everywhere where the application logic (and database schema) allow the \"attribute not set\" condition.","title":"Select with NULL values"},{"location":"indicators/#insert-with-null-values","text":"Indicator variables can be also used when binding input data, to control whether the data is to be used as provided, or explicitly overridden to be null: int id = 7; string name; indicator ind = i_null; sql << \"insert into person(id, name) values(:id, :name)\", use(id), use(name, ind); In the above example, the row is inserted with name attribute set to null.","title":"Insert with NULL values"},{"location":"indicators/#bulk-operations-with-null-values","text":"Indicator variables can also be used in conjunction with vector based insert, update, and select statements: vector<string> names(100); vector<indicator> inds; sql << \"select name from person where id = 7\", into(names, inds); The above example retrieves first 100 rows of data (or less). The initial size of names vector provides the (maximum) number of rows that should be read. Both vectors will be automatically resized according to the number of rows that were actually read. The following example inserts null for each value of name: vector<int> ids; vector<string> names; vector<indicator> nameIndicators; for (int i = 0; i != 10; ++i) { ids.push_back(i); names.push_back(\"\"); nameIndicators.push_back(i_null); } sql << \"insert into person(id, name) values(:id, :name)\", use(ids), use(name, nameIndicators); See also Integration with Boost to learn how the Boost.Optional library can be used to handle null data conditions in a more natural way.","title":"Bulk operations with NULL values"},{"location":"installation/","text":"Installation Requirements Below is an overall list of SOCI core: C++ compiler: GCC , Microsoft Visual C++ , LLVM/clang CMake 2.8+ - in order to use build configuration for CMake Boost C++ Libraries : DateTime, Fusion, Optional, Preprocessor, Tuple and backend-specific dependencies: DB2 Call Level Interface (CLI) Firebird client library mysqlclient - C API to MySQL ODBC (Open Database Connectivity) implementation: Microsoft ODBC iODBC , unixODBC Oracle Call Interface (OCI) libpq - C API to PostgreSQL SQLite 3 library Downloads Download package with latest release of the SOCI source code: soci-X.Y.Z , where X.Y.Z is the version number. Unpack the archive. You can always clone SOCI from the Git repository: git clone git://github.com/SOCI/soci.git Building with CMake SOCI is configured to build using CMake system in version 2.8+. The build configuration allows to control various aspects of compilation and installation by setting common CMake variables that change behaviour, describe system or control build (see CMake help ) as well as SOCI-specific variables described below. All these variables are available regardless of platform or compilation toolset used. Running CMake from the command line allows to set variables in the CMake cache with the following syntax: -DVARIABLE:TYPE=VALUE . If you are new to CMake, you may find the tutorial Running CMake helpful. Running CMake on Unix Steps outline using GNU Make Makefile -s: mkdir build cd build cmake -G \"Unix Makefiles\" -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) /path/to/soci-X.Y.Z make make install Running CMake on Windows Steps outline using Visual Studio 2010 and MSBuild: mkdir build cd build cmake -G \"Visual Studio 10\" -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) C:\\path\\to\\soci-X.Y.Z msbuild.exe SOCI.sln CMake configuration By default, CMake will try to determine availability of all dependencies automatically. If you are lucky, you will not need to specify any of the CMake variables explained below. However, if CMake reports some of the core or backend-specific dependencies as missing, you will need specify relevant variables to tell CMake where to look for the required components. CMake configures SOCI build performing sequence of steps. Each subsequent step is dependant on result of previous steps corresponding with particular feature. First, CMake checks system platform and compilation toolset. Next, CMake tries to find all external dependencies. Then, depending on the results of the dependency check, CMake determines SOCI backends which are possible to build. The SOCI-specific variables described below provide users with basic control of this behaviour. The following sections provide summary of variables accepted by CMake scripts configuring SOCI build. The lists consist of common variables for SOCI core and all backends as well as variables specific to SOCI backends and their direct dependencies. List of a few essential CMake variables: CMAKE_BUILD_TYPE - string - Specifies the build type for make based generators (see CMake help ). CMAKE_INSTALL_PREFIX - path - Install directory used by install command (see CMake help ). CMAKE_VERBOSE_MAKEFILE - boolean - If ON, create verbose makefile (see CMake help ). List of variables to control common SOCI features and dependencies: SOCI_CXX11 - boolean - Request to compile in C++11 compatibility mode. Default is OFF , unless CMAKE_CXX_STANDARD with version 11 or later is given in the command line. SOCI_SHARED - boolean - Request to build shared libraries for SOCI core and all successfully configured backends. Default is ON . SOCI_STATIC - boolean - Request to build static libraries for SOCI core and all successfully configured backends. Default is ON . SOCI_TESTS - boolean - Request to build regression tests for SOCI core and all successfully configured backends. WITH_BOOST - boolean - Should CMake try to detect Boost C++ Libraries . If ON, CMake will try to find Boost headers and binaries of Boost.Date_Time library. Some other build options: SOCI_ASAN - boolean - Build with address sanitizer (ASAN) support. Useful for finding problems when debugging, but shouldn't be used for the production builds due to extra overhead. Default is OFF . SOCI_LTO - boolean - Build with link-time optimizations, if supported. This produces noticeably smaller libraries. Default is OFF , but turning it on is recommended for the production builds. SOCI_VISIBILITY - boolean - Use hidden ELF visibility for private symbols if supported by the platform. This option produces smaller libraries by avoiding exporting internal function symbols. Default is ON . Empty (sample backend) SOCI_EMPTY - boolean - Builds the sample backend called Empty. Always ON by default. SOCI_EMPTY_TEST_CONNSTR - string - Connection string used to run regression tests of the Empty backend. It is a dummy value. Example: -DSOCI_EMPTY_TEST_CONNSTR=\"dummy connection\" IBM DB2 WITH_DB2 - boolean - Should CMake try to detect IBM DB2 Call Level Interface (CLI) library. DB2_INCLUDE_DIR - string - Path to DB2 CLI include directories where CMake should look for sqlcli1.h header. DB2_LIBRARIES - string - Full paths to db2 or db2api libraries to link SOCI against to enable the backend support. SOCI_DB2 - boolean - Requests to build DB2 backend. Automatically switched on, if WITH_DB2 is set to ON. SOCI_DB2_TEST_CONNSTR - string - See DB2 backend reference for details. Example: -DSOCI_DB2_TEST_CONNSTR:STRING=\"DSN=SAMPLE;Uid=db2inst1;Pwd=db2inst1;autocommit=off\" Firebird WITH_FIREBIRD - boolean - Should CMake try to detect Firebird client library. FIREBIRD_INCLUDE_DIR - string - Path to Firebird include directories where CMake should look for ibase.h header. FIREBIRD_LIBRARIES - string - Full paths to Firebird fbclient or fbclient_ms libraries to link SOCI against to enable the backend support. SOCI_FIREBIRD - boolean - Requests to build Firebird backend. Automatically switched on, if WITH_FIREBIRD is set to ON. SOCI_FIREBIRD_TEST_CONNSTR - string - See Firebird backend reference for details. Example: -DSOCI_FIREBIRD_TEST_CONNSTR:STRING=\"service=LOCALHOST:/tmp/soci_test.fdb user=SYSDBA password=masterkey\" MySQL WITH_MYSQL - boolean - Should CMake try to detect mysqlclient libraries providing MySQL C API. Note, currently the mysql_config program is not being used. MYSQL_DIR - string - Path to MySQL installation root directory. CMake will scan subdirectories MYSQL_DIR/include and MYSQL_DIR/lib respectively for MySQL headers and libraries. MYSQL_INCLUDE_DIR - string - Path to MySQL include directory where CMake should look for mysql.h header. MYSQL_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_MYSQL - boolean - Requests to build MySQL backend. Automatically switched on, if WITH_MYSQL is set to ON. SOCI_MYSQL_TEST_CONNSTR - string - Connection string to MySQL test database. Format of the string is explained MySQL backend reference . Example: -DSOCI_MYSQL_TEST_CONNSTR:STRING=\"db=mydb user=mloskot password=secret\" ODBC WITH_ODBC - boolean - Should CMake try to detect ODBC libraries. On Unix systems, CMake tries to find unixODBC or iODBC implementations. ODBC_INCLUDE_DIR - string - Path to ODBC implementation include directories where CMake should look for sql.h header. ODBC_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_ODBC - boolean - Requests to build ODBC backend. Automatically switched on, if WITH_ODBC is set to ON. SOCI_ODBC_TEST_{database}_CONNSTR - string - ODBC Data Source Name (DSN) or ODBC File Data Source Name (FILEDSN) to test database: Microsoft Access (.mdb), Microsoft SQL Server, MySQL, PostgreSQL or any other ODBC SQL data source. {database} is placeholder for name of database driver ACCESS, MYSQL, POSTGRESQL, etc. See ODBC backend reference for details. Example: -DSOCI_ODBC_TEST_POSTGRESQL_CONNSTR=\"FILEDSN=/home/mloskot/soci/build/test-postgresql.dsn\" Oracle WITH_ORACLE - boolean - Should CMake try to detect Oracle Call Interface (OCI) libraries. ORACLE_INCLUDE_DIR - string - Path to Oracle include directory where CMake should look for oci.h header. ORACLE_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_ORACLE - boolean - Requests to build Oracle backend. Automatically switched on, if WITH_ORACLE is set to ON. SOCI_ORACLE_TEST_CONNSTR - string - Connection string to Oracle test database. Format of the string is explained Oracle backend reference . Example: -DSOCI_ORACLE_TEST_CONNSTR:STRING=\"service=orcl user=scott password=tiger\" PostgreSQL WITH_POSTGRESQL - boolean - Should CMake try to detect PostgreSQL client interface libraries. SOCI relies on libpq C library. POSTGRESQL_INCLUDE_DIR - string - Path to PostgreSQL include directory where CMake should look for libpq-fe.h header. POSTGRESQL_LIBRARY - string - Full paths to libraries to link SOCI against to enable the backend support. The POSTGRESQL_LIBRARIES will be set with PostgreSQL libraries needed for linking. SOCI_POSTGRESQL - boolean - Requests to build PostgreSQL backend. Automatically switched on, if WITH_POSTGRESQL is set to ON. SOCI_POSTGRESQL_TEST_CONNSTR - string - Connection string to PostgreSQL test database. Format of the string is explained PostgreSQL backend reference. Example: -DSOCI_POSTGRESQL_TEST_CONNSTR:STRING=\"dbname=mydb user=scott\" SQLite 3 WITH_SQLITE3 - boolean - Should CMake try to detect SQLite C/C++ library. As bonus, the configuration tries OSGeo4W distribution if OSGEO4W_ROOT environment variable is set. SQLITE3_INCLUDE_DIR - string - Path to SQLite 3 include directory where CMake should look for sqlite3.h header. SQLITE3_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_SQLITE3 - boolean - Requests to build SQLite3 backend. Automatically switched on, if WITH_SQLITE3 is set to ON. SOCI_SQLITE3_TEST_CONNSTR - string - Connection string is simply a file path where SQLite3 test database will be created (e.g. /home/john/soci_test.db). Check SQLite3 backend reference for details. Example: -DSOCI_SQLITE3_TEST_CONNSTR=\"my.db\" or -DSOCI_SQLITE3_TEST_CONNSTR=\":memory:\" . Building with Makefiles on Unix NOTE: These (classic) Makefiles have not been maintained for long time. The officially maintained build configuration is CMake. If you still want to use these Makefiles, you've been warned that you may need to patch them. The classic set of Makefiles for Unix/Linux systems is provided for those users who need complete control over the whole processand who can benefit from the basic scaffolding that they can extend on their own. In this sense, the basic Makefiles are supposed to provide a minimal starting point for custom experimentation and are not intended to be a complete build/installation solution. At the same time, they are complete in the sense that they can compile the library with all test programs and for some users this level of support will be just fine. The core directory of the library distribution contains the Makefile.basic that can be used to compile the core part of the library. Run make -f Makefile.basic or make -f Makefile.basic shared to get the static and shared versions, respectively. Similarly, the backends/<i>name</i> directory contains the backend part for each supported backend with the appropriate Makefile.basic and the backends/<i>name</i>/test directory contains the test program for the given backend. For example, the simplest way to compile the static version of the library and the test program for PostgreSQL is: cd src/core make -f Makefile.basic cd ../backends/postgresql make -f Makefile.basic cd test make -f Makefile.basic For each backend and its test program, the Makefile.basic s contain the variables that can have values specific to the given environment - they usually name the include and library paths. These variables are placed at the beginning of the Makefile.basic s. Please review their values in case of any compilation problems. The Makefiles for test programs can be a good starting point to find out correct compiler and linker options. Building with Conan SOCI is available as a Conan package since February 2021 for the version 4.0.1 for the follwoiing backends: sqlite3, odbc, mysql, and postgresql, and with the following flag enabled: SOCI_CXX11=True . This section lists the steps required to use SOCI in a CMake project with Conan: Install Conan Install Conan if it is not installed yet: pip3 install conan Create conanfile.txt Create a conanfile.txt in the same directory of the CMakeLists.txt , with a reference to a recipe (which is a string with the library name and the version to use), the build options, and the CMake generator: # conanfile.txt [requires] soci/4.0.1 [options] soci:shared = True soci:with_sqlite3 = True [generators] cmake The option soci:with_sqlite3 = True indicates that the sqlite3 backend will be downloaded and used. Update CMakeLists.txt Add the following Conan-specific lines to the CMakeLists.txt of your project: include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake) conan_basic_setup(TARGETS) conan_target_link_libraries(${PROJECT_NAME} ${CONAN_LIBS}) The command conan_target_link_libraries replaces target_link_libraries . Run Conan Run conan install to install SOCI, and then build your project as usual: mkdir build cd build conan install .. --build=soci cmake .. cmake . --build Running tests The process of running regression tests highly depends on user's environment and build configuration, so it may be quite involving process. The CMake configuration provides variables to allow users willing to run the tests to configure build and specify database connection parameters (see the lists above for variable names). In order to run regression tests, configure and build desired SOCI backends and prepare working database instances for them. While configuring build with CMake, specify SOCI_TESTS=ON to enable building regression tests. Also, specify SOCI_{backend name}_TEST_CONNSTR variables to tell the tests runner how to connect with your test databases. Dedicated make test target can be used to execute regression tests on build completion: mkdir build cd build cmake -G \"Unix Makefiles\" \\ -DWITH_BOOST=OFF \\ -DSOCI_TESTS=ON \\ -DSOCI_EMPTY_TEST_CONNSTR=\"dummy connection\" \\ -DSOCI_SQLITE3_TEST_CONNSTR=\"test.db\" \\ (...) ../soci-X.Y.Z make make test make install In the example above, regression tests for the sample Empty backend and SQLite 3 backend are configured for execution by make test target. Using library CMake build produces set of shared and static libraries for SOCI core and backends separately. On Unix, for example, build/lib directory will consist of the static libraries named like libsoci_core.a , libsoci_sqlite3.a and shared libraries with names like libsoci_core.so.4.0.0 , libsoci_sqlite3.so.4.0.0 , and so on. If your project also uses CMake, you can simply use find_package(SOCI) to check for SOCI availability and target_link_libraries() to link with the SOCI libraries available under the names SOCI::soci_core and SOCI::soci_<backend> and ensure that SOCI headers can be included (i.e. there is no need to use target_include_directories() explicitly). An example of a very simple CMake-based project using SOCI is provided in the examples/connect directory. \\ Alternatively, you can add SOCI as a subdirectory to your project and include it via add_subdirectory() . As before, target_link_libraries() is used to link with the SOCI libraries available under the names soci_core and soci_<backend> (note: the alias SOCI:: has to be omitted here). In order for SOCI to also find its header files that get generated by CMake, target_include_directories() needs to add SOCI's built include directory ${CMAKE_BINARY_DIR/path/to/soci/include} . An example of this can be found in the directory examples/subdir-include . If you don't use CMake but want to use SOCI in your program, you need to specify the paths to the SOCI headers and libraries in your build configuration and to tell the linker to link against the libraries you want to use in your program.","title":"Installation"},{"location":"installation/#installation","text":"","title":"Installation"},{"location":"installation/#requirements","text":"Below is an overall list of SOCI core: C++ compiler: GCC , Microsoft Visual C++ , LLVM/clang CMake 2.8+ - in order to use build configuration for CMake Boost C++ Libraries : DateTime, Fusion, Optional, Preprocessor, Tuple and backend-specific dependencies: DB2 Call Level Interface (CLI) Firebird client library mysqlclient - C API to MySQL ODBC (Open Database Connectivity) implementation: Microsoft ODBC iODBC , unixODBC Oracle Call Interface (OCI) libpq - C API to PostgreSQL SQLite 3 library","title":"Requirements"},{"location":"installation/#downloads","text":"Download package with latest release of the SOCI source code: soci-X.Y.Z , where X.Y.Z is the version number. Unpack the archive. You can always clone SOCI from the Git repository: git clone git://github.com/SOCI/soci.git","title":"Downloads"},{"location":"installation/#building-with-cmake","text":"SOCI is configured to build using CMake system in version 2.8+. The build configuration allows to control various aspects of compilation and installation by setting common CMake variables that change behaviour, describe system or control build (see CMake help ) as well as SOCI-specific variables described below. All these variables are available regardless of platform or compilation toolset used. Running CMake from the command line allows to set variables in the CMake cache with the following syntax: -DVARIABLE:TYPE=VALUE . If you are new to CMake, you may find the tutorial Running CMake helpful.","title":"Building with CMake"},{"location":"installation/#running-cmake-on-unix","text":"Steps outline using GNU Make Makefile -s: mkdir build cd build cmake -G \"Unix Makefiles\" -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) /path/to/soci-X.Y.Z make make install","title":"Running CMake on Unix"},{"location":"installation/#running-cmake-on-windows","text":"Steps outline using Visual Studio 2010 and MSBuild: mkdir build cd build cmake -G \"Visual Studio 10\" -DWITH_BOOST=OFF -DWITH_ORACLE=OFF (...) C:\\path\\to\\soci-X.Y.Z msbuild.exe SOCI.sln","title":"Running CMake on Windows"},{"location":"installation/#cmake-configuration","text":"By default, CMake will try to determine availability of all dependencies automatically. If you are lucky, you will not need to specify any of the CMake variables explained below. However, if CMake reports some of the core or backend-specific dependencies as missing, you will need specify relevant variables to tell CMake where to look for the required components. CMake configures SOCI build performing sequence of steps. Each subsequent step is dependant on result of previous steps corresponding with particular feature. First, CMake checks system platform and compilation toolset. Next, CMake tries to find all external dependencies. Then, depending on the results of the dependency check, CMake determines SOCI backends which are possible to build. The SOCI-specific variables described below provide users with basic control of this behaviour. The following sections provide summary of variables accepted by CMake scripts configuring SOCI build. The lists consist of common variables for SOCI core and all backends as well as variables specific to SOCI backends and their direct dependencies. List of a few essential CMake variables: CMAKE_BUILD_TYPE - string - Specifies the build type for make based generators (see CMake help ). CMAKE_INSTALL_PREFIX - path - Install directory used by install command (see CMake help ). CMAKE_VERBOSE_MAKEFILE - boolean - If ON, create verbose makefile (see CMake help ). List of variables to control common SOCI features and dependencies: SOCI_CXX11 - boolean - Request to compile in C++11 compatibility mode. Default is OFF , unless CMAKE_CXX_STANDARD with version 11 or later is given in the command line. SOCI_SHARED - boolean - Request to build shared libraries for SOCI core and all successfully configured backends. Default is ON . SOCI_STATIC - boolean - Request to build static libraries for SOCI core and all successfully configured backends. Default is ON . SOCI_TESTS - boolean - Request to build regression tests for SOCI core and all successfully configured backends. WITH_BOOST - boolean - Should CMake try to detect Boost C++ Libraries . If ON, CMake will try to find Boost headers and binaries of Boost.Date_Time library. Some other build options: SOCI_ASAN - boolean - Build with address sanitizer (ASAN) support. Useful for finding problems when debugging, but shouldn't be used for the production builds due to extra overhead. Default is OFF . SOCI_LTO - boolean - Build with link-time optimizations, if supported. This produces noticeably smaller libraries. Default is OFF , but turning it on is recommended for the production builds. SOCI_VISIBILITY - boolean - Use hidden ELF visibility for private symbols if supported by the platform. This option produces smaller libraries by avoiding exporting internal function symbols. Default is ON .","title":"CMake configuration"},{"location":"installation/#empty-sample-backend","text":"SOCI_EMPTY - boolean - Builds the sample backend called Empty. Always ON by default. SOCI_EMPTY_TEST_CONNSTR - string - Connection string used to run regression tests of the Empty backend. It is a dummy value. Example: -DSOCI_EMPTY_TEST_CONNSTR=\"dummy connection\"","title":"Empty (sample backend)"},{"location":"installation/#ibm-db2","text":"WITH_DB2 - boolean - Should CMake try to detect IBM DB2 Call Level Interface (CLI) library. DB2_INCLUDE_DIR - string - Path to DB2 CLI include directories where CMake should look for sqlcli1.h header. DB2_LIBRARIES - string - Full paths to db2 or db2api libraries to link SOCI against to enable the backend support. SOCI_DB2 - boolean - Requests to build DB2 backend. Automatically switched on, if WITH_DB2 is set to ON. SOCI_DB2_TEST_CONNSTR - string - See DB2 backend reference for details. Example: -DSOCI_DB2_TEST_CONNSTR:STRING=\"DSN=SAMPLE;Uid=db2inst1;Pwd=db2inst1;autocommit=off\"","title":"IBM DB2"},{"location":"installation/#firebird","text":"WITH_FIREBIRD - boolean - Should CMake try to detect Firebird client library. FIREBIRD_INCLUDE_DIR - string - Path to Firebird include directories where CMake should look for ibase.h header. FIREBIRD_LIBRARIES - string - Full paths to Firebird fbclient or fbclient_ms libraries to link SOCI against to enable the backend support. SOCI_FIREBIRD - boolean - Requests to build Firebird backend. Automatically switched on, if WITH_FIREBIRD is set to ON. SOCI_FIREBIRD_TEST_CONNSTR - string - See Firebird backend reference for details. Example: -DSOCI_FIREBIRD_TEST_CONNSTR:STRING=\"service=LOCALHOST:/tmp/soci_test.fdb user=SYSDBA password=masterkey\"","title":"Firebird"},{"location":"installation/#mysql","text":"WITH_MYSQL - boolean - Should CMake try to detect mysqlclient libraries providing MySQL C API. Note, currently the mysql_config program is not being used. MYSQL_DIR - string - Path to MySQL installation root directory. CMake will scan subdirectories MYSQL_DIR/include and MYSQL_DIR/lib respectively for MySQL headers and libraries. MYSQL_INCLUDE_DIR - string - Path to MySQL include directory where CMake should look for mysql.h header. MYSQL_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_MYSQL - boolean - Requests to build MySQL backend. Automatically switched on, if WITH_MYSQL is set to ON. SOCI_MYSQL_TEST_CONNSTR - string - Connection string to MySQL test database. Format of the string is explained MySQL backend reference . Example: -DSOCI_MYSQL_TEST_CONNSTR:STRING=\"db=mydb user=mloskot password=secret\"","title":"MySQL"},{"location":"installation/#odbc","text":"WITH_ODBC - boolean - Should CMake try to detect ODBC libraries. On Unix systems, CMake tries to find unixODBC or iODBC implementations. ODBC_INCLUDE_DIR - string - Path to ODBC implementation include directories where CMake should look for sql.h header. ODBC_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_ODBC - boolean - Requests to build ODBC backend. Automatically switched on, if WITH_ODBC is set to ON. SOCI_ODBC_TEST_{database}_CONNSTR - string - ODBC Data Source Name (DSN) or ODBC File Data Source Name (FILEDSN) to test database: Microsoft Access (.mdb), Microsoft SQL Server, MySQL, PostgreSQL or any other ODBC SQL data source. {database} is placeholder for name of database driver ACCESS, MYSQL, POSTGRESQL, etc. See ODBC backend reference for details. Example: -DSOCI_ODBC_TEST_POSTGRESQL_CONNSTR=\"FILEDSN=/home/mloskot/soci/build/test-postgresql.dsn\"","title":"ODBC"},{"location":"installation/#oracle","text":"WITH_ORACLE - boolean - Should CMake try to detect Oracle Call Interface (OCI) libraries. ORACLE_INCLUDE_DIR - string - Path to Oracle include directory where CMake should look for oci.h header. ORACLE_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_ORACLE - boolean - Requests to build Oracle backend. Automatically switched on, if WITH_ORACLE is set to ON. SOCI_ORACLE_TEST_CONNSTR - string - Connection string to Oracle test database. Format of the string is explained Oracle backend reference . Example: -DSOCI_ORACLE_TEST_CONNSTR:STRING=\"service=orcl user=scott password=tiger\"","title":"Oracle"},{"location":"installation/#postgresql","text":"WITH_POSTGRESQL - boolean - Should CMake try to detect PostgreSQL client interface libraries. SOCI relies on libpq C library. POSTGRESQL_INCLUDE_DIR - string - Path to PostgreSQL include directory where CMake should look for libpq-fe.h header. POSTGRESQL_LIBRARY - string - Full paths to libraries to link SOCI against to enable the backend support. The POSTGRESQL_LIBRARIES will be set with PostgreSQL libraries needed for linking. SOCI_POSTGRESQL - boolean - Requests to build PostgreSQL backend. Automatically switched on, if WITH_POSTGRESQL is set to ON. SOCI_POSTGRESQL_TEST_CONNSTR - string - Connection string to PostgreSQL test database. Format of the string is explained PostgreSQL backend reference. Example: -DSOCI_POSTGRESQL_TEST_CONNSTR:STRING=\"dbname=mydb user=scott\"","title":"PostgreSQL"},{"location":"installation/#sqlite-3","text":"WITH_SQLITE3 - boolean - Should CMake try to detect SQLite C/C++ library. As bonus, the configuration tries OSGeo4W distribution if OSGEO4W_ROOT environment variable is set. SQLITE3_INCLUDE_DIR - string - Path to SQLite 3 include directory where CMake should look for sqlite3.h header. SQLITE3_LIBRARIES - string - Full paths to libraries to link SOCI against to enable the backend support. SOCI_SQLITE3 - boolean - Requests to build SQLite3 backend. Automatically switched on, if WITH_SQLITE3 is set to ON. SOCI_SQLITE3_TEST_CONNSTR - string - Connection string is simply a file path where SQLite3 test database will be created (e.g. /home/john/soci_test.db). Check SQLite3 backend reference for details. Example: -DSOCI_SQLITE3_TEST_CONNSTR=\"my.db\" or -DSOCI_SQLITE3_TEST_CONNSTR=\":memory:\" .","title":"SQLite 3"},{"location":"installation/#building-with-makefiles-on-unix","text":"NOTE: These (classic) Makefiles have not been maintained for long time. The officially maintained build configuration is CMake. If you still want to use these Makefiles, you've been warned that you may need to patch them. The classic set of Makefiles for Unix/Linux systems is provided for those users who need complete control over the whole processand who can benefit from the basic scaffolding that they can extend on their own. In this sense, the basic Makefiles are supposed to provide a minimal starting point for custom experimentation and are not intended to be a complete build/installation solution. At the same time, they are complete in the sense that they can compile the library with all test programs and for some users this level of support will be just fine. The core directory of the library distribution contains the Makefile.basic that can be used to compile the core part of the library. Run make -f Makefile.basic or make -f Makefile.basic shared to get the static and shared versions, respectively. Similarly, the backends/<i>name</i> directory contains the backend part for each supported backend with the appropriate Makefile.basic and the backends/<i>name</i>/test directory contains the test program for the given backend. For example, the simplest way to compile the static version of the library and the test program for PostgreSQL is: cd src/core make -f Makefile.basic cd ../backends/postgresql make -f Makefile.basic cd test make -f Makefile.basic For each backend and its test program, the Makefile.basic s contain the variables that can have values specific to the given environment - they usually name the include and library paths. These variables are placed at the beginning of the Makefile.basic s. Please review their values in case of any compilation problems. The Makefiles for test programs can be a good starting point to find out correct compiler and linker options.","title":"Building with Makefiles on Unix"},{"location":"installation/#building-with-conan","text":"SOCI is available as a Conan package since February 2021 for the version 4.0.1 for the follwoiing backends: sqlite3, odbc, mysql, and postgresql, and with the following flag enabled: SOCI_CXX11=True . This section lists the steps required to use SOCI in a CMake project with Conan:","title":"Building with Conan"},{"location":"installation/#install-conan","text":"Install Conan if it is not installed yet: pip3 install conan","title":"Install Conan"},{"location":"installation/#create-conanfiletxt","text":"Create a conanfile.txt in the same directory of the CMakeLists.txt , with a reference to a recipe (which is a string with the library name and the version to use), the build options, and the CMake generator: # conanfile.txt [requires] soci/4.0.1 [options] soci:shared = True soci:with_sqlite3 = True [generators] cmake The option soci:with_sqlite3 = True indicates that the sqlite3 backend will be downloaded and used.","title":"Create conanfile.txt"},{"location":"installation/#update-cmakeliststxt","text":"Add the following Conan-specific lines to the CMakeLists.txt of your project: include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake) conan_basic_setup(TARGETS) conan_target_link_libraries(${PROJECT_NAME} ${CONAN_LIBS}) The command conan_target_link_libraries replaces target_link_libraries .","title":"Update CMakeLists.txt"},{"location":"installation/#run-conan","text":"Run conan install to install SOCI, and then build your project as usual: mkdir build cd build conan install .. --build=soci cmake .. cmake . --build","title":"Run Conan"},{"location":"installation/#running-tests","text":"The process of running regression tests highly depends on user's environment and build configuration, so it may be quite involving process. The CMake configuration provides variables to allow users willing to run the tests to configure build and specify database connection parameters (see the lists above for variable names). In order to run regression tests, configure and build desired SOCI backends and prepare working database instances for them. While configuring build with CMake, specify SOCI_TESTS=ON to enable building regression tests. Also, specify SOCI_{backend name}_TEST_CONNSTR variables to tell the tests runner how to connect with your test databases. Dedicated make test target can be used to execute regression tests on build completion: mkdir build cd build cmake -G \"Unix Makefiles\" \\ -DWITH_BOOST=OFF \\ -DSOCI_TESTS=ON \\ -DSOCI_EMPTY_TEST_CONNSTR=\"dummy connection\" \\ -DSOCI_SQLITE3_TEST_CONNSTR=\"test.db\" \\ (...) ../soci-X.Y.Z make make test make install In the example above, regression tests for the sample Empty backend and SQLite 3 backend are configured for execution by make test target.","title":"Running tests"},{"location":"installation/#using-library","text":"CMake build produces set of shared and static libraries for SOCI core and backends separately. On Unix, for example, build/lib directory will consist of the static libraries named like libsoci_core.a , libsoci_sqlite3.a and shared libraries with names like libsoci_core.so.4.0.0 , libsoci_sqlite3.so.4.0.0 , and so on. If your project also uses CMake, you can simply use find_package(SOCI) to check for SOCI availability and target_link_libraries() to link with the SOCI libraries available under the names SOCI::soci_core and SOCI::soci_<backend> and ensure that SOCI headers can be included (i.e. there is no need to use target_include_directories() explicitly). An example of a very simple CMake-based project using SOCI is provided in the examples/connect directory. \\ Alternatively, you can add SOCI as a subdirectory to your project and include it via add_subdirectory() . As before, target_link_libraries() is used to link with the SOCI libraries available under the names soci_core and soci_<backend> (note: the alias SOCI:: has to be omitted here). In order for SOCI to also find its header files that get generated by CMake, target_include_directories() needs to add SOCI's built include directory ${CMAKE_BINARY_DIR/path/to/soci/include} . An example of this can be found in the directory examples/subdir-include . If you don't use CMake but want to use SOCI in your program, you need to specify the paths to the SOCI headers and libraries in your build configuration and to tell the linker to link against the libraries you want to use in your program.","title":"Using library"},{"location":"interfaces/","text":"Interfaces One of the major features of SOCI, although not immediately visible, is the variety of interfaces (APIs) that are available for the user. These can be divided into sugar , core and simple . Sugar The most exposed and promoted interface supports the syntax sugar that makes SOCI similar in look and feel to embedded SQL. The example of application code using this interface is: session sql(\"postgresql://dbname=mydb\"); int id = 123; string name; sql << \"select name from persons where id = :id\", into(name), use(id); Core The above example is equivalent to the following, more explicit sequence of calls: session sql(\"postgresql://dbname=mydb\"); int id = 123; string name; statement st(sql); st.exchange(into(name)); st.exchange(use(id)); st.alloc(); st.prepare(\"select name from persons where id = :id\"); st.define_and_bind(); st.execute(true); The value of the core interface is that it is the basis for all other interfaces, and can be also used by developers to easily prepare their own convenience interfaces. Users who cannot or for some reason do not want to use the natural sugar interface should try the core one as the foundation and access point to all SOCI functionality. Note that the sugar interface wraps only those parts of the core that are related to data binding and query streaming. Simple The simple interface is provided specifically to allow easy integration of the SOCI library with other languages that have the ability to link with binaries using the \"C\" calling convention. To facilitate this integration, the simple interface does not use any pointers to data except C-style strings and opaque handles, but the consequence of this is that user data is managed by SOCI and not by user code. To avoid exceptions passing the module boundaries, all errors are reported as state variables of relevant objects. The above examples can be rewritten as (without error-handling): #include <soci-simple.h> // ... session_handle sql = soci_create_session(\"postgresql://dbname=mydb\"); statement_handle st = soci_create_statement(sql); soci_use_int(st, \"id\"); soci_set_use_int(st, \"id\", 123); int namePosition = soci_into_string(st); soci_prepare(st, \"select name from persons where id = :id\"); soci_execute(st, true); char const * name = soci_get_into_string(st, namePosition); printf(\"name is %s\\n\", name); soci_destroy_statement(st); soci_destroy_session(sql); The simple interface supports single and bulk data exchange for static binding. Dynamic row description is not supported in this release. See Simple client interface reference documentation for more details. Low-level backend interface The low-level backend interface allows to interact with backends directly and in principle allows to access the database without involving any other component. There is no particular reason to use this interface in the user code.","title":"Interfaces"},{"location":"interfaces/#interfaces","text":"One of the major features of SOCI, although not immediately visible, is the variety of interfaces (APIs) that are available for the user. These can be divided into sugar , core and simple .","title":"Interfaces"},{"location":"interfaces/#sugar","text":"The most exposed and promoted interface supports the syntax sugar that makes SOCI similar in look and feel to embedded SQL. The example of application code using this interface is: session sql(\"postgresql://dbname=mydb\"); int id = 123; string name; sql << \"select name from persons where id = :id\", into(name), use(id);","title":"Sugar"},{"location":"interfaces/#core","text":"The above example is equivalent to the following, more explicit sequence of calls: session sql(\"postgresql://dbname=mydb\"); int id = 123; string name; statement st(sql); st.exchange(into(name)); st.exchange(use(id)); st.alloc(); st.prepare(\"select name from persons where id = :id\"); st.define_and_bind(); st.execute(true); The value of the core interface is that it is the basis for all other interfaces, and can be also used by developers to easily prepare their own convenience interfaces. Users who cannot or for some reason do not want to use the natural sugar interface should try the core one as the foundation and access point to all SOCI functionality. Note that the sugar interface wraps only those parts of the core that are related to data binding and query streaming.","title":"Core"},{"location":"interfaces/#simple","text":"The simple interface is provided specifically to allow easy integration of the SOCI library with other languages that have the ability to link with binaries using the \"C\" calling convention. To facilitate this integration, the simple interface does not use any pointers to data except C-style strings and opaque handles, but the consequence of this is that user data is managed by SOCI and not by user code. To avoid exceptions passing the module boundaries, all errors are reported as state variables of relevant objects. The above examples can be rewritten as (without error-handling): #include <soci-simple.h> // ... session_handle sql = soci_create_session(\"postgresql://dbname=mydb\"); statement_handle st = soci_create_statement(sql); soci_use_int(st, \"id\"); soci_set_use_int(st, \"id\", 123); int namePosition = soci_into_string(st); soci_prepare(st, \"select name from persons where id = :id\"); soci_execute(st, true); char const * name = soci_get_into_string(st, namePosition); printf(\"name is %s\\n\", name); soci_destroy_statement(st); soci_destroy_session(sql); The simple interface supports single and bulk data exchange for static binding. Dynamic row description is not supported in this release. See Simple client interface reference documentation for more details.","title":"Simple"},{"location":"interfaces/#low-level-backend-interface","text":"The low-level backend interface allows to interact with backends directly and in principle allows to access the database without involving any other component. There is no particular reason to use this interface in the user code.","title":"Low-level backend interface"},{"location":"license/","text":"License The SOCI library is distributed under the terms of the Boost Software License . Boost Software License Version 1.0 - August 17th, 2003 Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the \"Software\") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following: The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.","title":"License"},{"location":"license/#license","text":"The SOCI library is distributed under the terms of the Boost Software License .","title":"License"},{"location":"license/#boost-software-license","text":"Version 1.0 - August 17th, 2003 Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the \"Software\") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following: The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.","title":"Boost Software License"},{"location":"lobs/","text":"Large Objects (LOBs) Binary (BLOBs) The SOCI library provides also an interface for basic operations on large objects (BLOBs - Binary Large OBjects). blob b(sql); // sql is a session object sql << \"select mp3 from mymusic where id = 123\", into(b); The following functions are provided in the blob interface, mimicking the file-like operations: std::size_t get_len(); std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0); std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0); std::size_t append(char const *buf, std::size_t toWrite); void trim(std::size_t newLen); The offset parameter is always counted from the beginning of the BLOB's data. Portability notes The way to define BLOB table columns and create or destroy BLOB objects in the database varies between different database engines. Please see the SQL documentation relevant for the given server to learn how this is actually done. The test programs provided with the SOCI library can be also a simple source of full working examples. The trim function is not currently available for the PostgreSQL backend. Long strings and XML The SOCI library recognizes the fact that long string values are not handled portably and in some databases long string values need to be stored as a different data type. Similar concerns relate to the use of XML values, which are essentially strings at the application level, but can be stored in special database-level field types. In order to facilitate handling of long strings and XML values the following wrapper types are defined: struct xml_type { std::string value; }; struct long_string { std::string value; }; Values of these wrapper types can be used with into and use elements with the database target type that is specifically intended to handle XML and long strings data types. For Oracle, these database-side types are, respectively: XMLType , CLOB For PostgreSQL, these types are: XML text For Firebird, there is no special XML support, but BLOB SUB_TYPE TEXT can be used for storing it, as well as long strings. For ODBC backend, these types depend on the type of the database connected to. In particularly important special case of Microsoft SQL Server, these types are: xml text When using ODBC backend to connect to a PostgreSQL database, please be aware that by default PostgreSQL ODBC driver truncates all \"unknown\" types, such as XML, to maximal varchar type size which is just 256 bytes and so is often insufficient for XML values in practice. It is advised to set the UnknownsAsLongVarchar connection option to 1 to avoid truncating XML strings or use PostgreSQL ODBC driver 9.6.300 or later, which allows the backend to set this option to 1 automatically on connection.","title":"LOBs"},{"location":"lobs/#large-objects-lobs","text":"","title":"Large Objects (LOBs)"},{"location":"lobs/#binary-blobs","text":"The SOCI library provides also an interface for basic operations on large objects (BLOBs - Binary Large OBjects). blob b(sql); // sql is a session object sql << \"select mp3 from mymusic where id = 123\", into(b); The following functions are provided in the blob interface, mimicking the file-like operations: std::size_t get_len(); std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0); std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0); std::size_t append(char const *buf, std::size_t toWrite); void trim(std::size_t newLen); The offset parameter is always counted from the beginning of the BLOB's data.","title":"Binary (BLOBs)"},{"location":"lobs/#portability-notes","text":"The way to define BLOB table columns and create or destroy BLOB objects in the database varies between different database engines. Please see the SQL documentation relevant for the given server to learn how this is actually done. The test programs provided with the SOCI library can be also a simple source of full working examples. The trim function is not currently available for the PostgreSQL backend.","title":"Portability notes"},{"location":"lobs/#long-strings-and-xml","text":"The SOCI library recognizes the fact that long string values are not handled portably and in some databases long string values need to be stored as a different data type. Similar concerns relate to the use of XML values, which are essentially strings at the application level, but can be stored in special database-level field types. In order to facilitate handling of long strings and XML values the following wrapper types are defined: struct xml_type { std::string value; }; struct long_string { std::string value; }; Values of these wrapper types can be used with into and use elements with the database target type that is specifically intended to handle XML and long strings data types. For Oracle, these database-side types are, respectively: XMLType , CLOB For PostgreSQL, these types are: XML text For Firebird, there is no special XML support, but BLOB SUB_TYPE TEXT can be used for storing it, as well as long strings. For ODBC backend, these types depend on the type of the database connected to. In particularly important special case of Microsoft SQL Server, these types are: xml text When using ODBC backend to connect to a PostgreSQL database, please be aware that by default PostgreSQL ODBC driver truncates all \"unknown\" types, such as XML, to maximal varchar type size which is just 256 bytes and so is often insufficient for XML values in practice. It is advised to set the UnknownsAsLongVarchar connection option to 1 to avoid truncating XML strings or use PostgreSQL ODBC driver 9.6.300 or later, which allows the backend to set this option to 1 automatically on connection.","title":"Long strings and XML"},{"location":"logging/","text":"Logging SOCI provides a flexible, but requiring some effort to use, way to log all queries done by the library and a more limited but very simple way to do it. Simple logging The following members of the session class support the basic logging functionality: void set_log_stream(std::ostream * s); std::ostream * get_log_stream() const; std::string get_last_query() const; The first two functions allow to set the user-provided output stream object for logging. The NULL value, which is the default, means that there is no logging. An example use might be: session sql(oracle, \"...\"); ofstream file(\"my_log.txt\"); sql.set_log_stream(&file); // ... Each statement logs its query string before the preparation step (whether explicit or implicit) and therefore logging is effective whether the query succeeds or not. Note that each prepared query is logged only once, independent on how many times it is executed. The get_last_query function allows to retrieve the last used query. Flexible logging using custom loggers If the above is not enough, it is also possible to log the queries in exactly the way you want by deriving your own my_log_impl class from soci::logger_impl and implementing its pure virtual start_query() and do_clone() methods: class my_log_impl : public soci::logger_impl { public: virtual void start_query(std::string const & query) { ... log the given query ... } private: virtual logger_impl* do_clone() const { return new my_log_impl(...); } }; Then simply pass a new, heap-allocated instance of this class to the session object: soci::session sql(...); sql.set_logger(new my_log_impl(...)); and start_query() method of the logger will be called for all queries.","title":"Logging"},{"location":"logging/#logging","text":"SOCI provides a flexible, but requiring some effort to use, way to log all queries done by the library and a more limited but very simple way to do it.","title":"Logging"},{"location":"logging/#simple-logging","text":"The following members of the session class support the basic logging functionality: void set_log_stream(std::ostream * s); std::ostream * get_log_stream() const; std::string get_last_query() const; The first two functions allow to set the user-provided output stream object for logging. The NULL value, which is the default, means that there is no logging. An example use might be: session sql(oracle, \"...\"); ofstream file(\"my_log.txt\"); sql.set_log_stream(&file); // ... Each statement logs its query string before the preparation step (whether explicit or implicit) and therefore logging is effective whether the query succeeds or not. Note that each prepared query is logged only once, independent on how many times it is executed. The get_last_query function allows to retrieve the last used query.","title":"Simple logging"},{"location":"logging/#flexible-logging-using-custom-loggers","text":"If the above is not enough, it is also possible to log the queries in exactly the way you want by deriving your own my_log_impl class from soci::logger_impl and implementing its pure virtual start_query() and do_clone() methods: class my_log_impl : public soci::logger_impl { public: virtual void start_query(std::string const & query) { ... log the given query ... } private: virtual logger_impl* do_clone() const { return new my_log_impl(...); } }; Then simply pass a new, heap-allocated instance of this class to the session object: soci::session sql(...); sql.set_logger(new my_log_impl(...)); and start_query() method of the logger will be called for all queries.","title":"Flexible logging using custom loggers"},{"location":"multithreading/","text":"Multithreading The general rule for multithreading is that SOCI classes are not thread-safe, meaning that their instances should not be used concurrently by multiple threads. The simplest solution for multithreaded code is to set up a separate session object for each thread that needs to inteact with the database. Depending on the design of the client application this might be also the most straightforward approach. For some applications, however, it might be preferable to decouple the set of threads from the set of sessions, so that they can be optimized separately with different resources in mind. The connection_pool class is provided for this purpose: // phase 1: preparation const size_t poolSize = 10; connection_pool pool(poolSize); for (size_t i = 0; i != poolSize; ++i) { session & sql = pool.at(i); sql.open(\"postgresql://dbname=mydb\"); } // phase 2: usage from working threads { session sql(pool); sql << \"select something from somewhere...\"; } // session is returned to the pool automatically The connection_pool 's constructor expects the size of the pool and internally creates an array of session s in the disconnected state. Later, the at function provides non-synchronized access to each element of the array. Note that this function is not thread-safe and exists only to make it easier to set up the pool in the initialization phase. Note that it is not obligatory to use the same connection parameters for all sessions in the pool, although this will be most likely the usual case. The working threads that need to lease a single session from the pool use the dedicated constructor of the session class - this constructor blocks until some session object becomes available in the pool and attaches to it, so that all further uses will be forwarded to the session object managed by the pool. As long as the local session object exists, the associated session in the pool is locked and no other thread will gain access to it. When the local session variable goes out of scope, the related entry in the pool's internal array is released, so that it can be used by other threads. This way, the connection pool guarantees that its session objects are never used by more than one thread at a time. Note that the above scheme is the simplest way to use the connection pool, but it is also constraining in the fact that the session 's constructor can block waiting for the availability of some entry in the pool. For more demanding users there are also low-level functions that allow to lease sessions from the pool with timeout on wait. Please consult the reference for details.","title":"Multi-threading"},{"location":"multithreading/#multithreading","text":"The general rule for multithreading is that SOCI classes are not thread-safe, meaning that their instances should not be used concurrently by multiple threads. The simplest solution for multithreaded code is to set up a separate session object for each thread that needs to inteact with the database. Depending on the design of the client application this might be also the most straightforward approach. For some applications, however, it might be preferable to decouple the set of threads from the set of sessions, so that they can be optimized separately with different resources in mind. The connection_pool class is provided for this purpose: // phase 1: preparation const size_t poolSize = 10; connection_pool pool(poolSize); for (size_t i = 0; i != poolSize; ++i) { session & sql = pool.at(i); sql.open(\"postgresql://dbname=mydb\"); } // phase 2: usage from working threads { session sql(pool); sql << \"select something from somewhere...\"; } // session is returned to the pool automatically The connection_pool 's constructor expects the size of the pool and internally creates an array of session s in the disconnected state. Later, the at function provides non-synchronized access to each element of the array. Note that this function is not thread-safe and exists only to make it easier to set up the pool in the initialization phase. Note that it is not obligatory to use the same connection parameters for all sessions in the pool, although this will be most likely the usual case. The working threads that need to lease a single session from the pool use the dedicated constructor of the session class - this constructor blocks until some session object becomes available in the pool and attaches to it, so that all further uses will be forwarded to the session object managed by the pool. As long as the local session object exists, the associated session in the pool is locked and no other thread will gain access to it. When the local session variable goes out of scope, the related entry in the pool's internal array is released, so that it can be used by other threads. This way, the connection pool guarantees that its session objects are never used by more than one thread at a time. Note that the above scheme is the simplest way to use the connection pool, but it is also constraining in the fact that the session 's constructor can block waiting for the availability of some entry in the pool. For more demanding users there are also low-level functions that allow to lease sessions from the pool with timeout on wait. Please consult the reference for details.","title":"Multithreading"},{"location":"procedures/","text":"Stored Procedures The procedure class provides a convenient mechanism for calling stored procedures: sql << \"create or replace procedure echo(output out varchar2,\" \"input in varchar2) as \" \"begin output := input; end;\"; std::string in(\"my message\"); std::string out; procedure proc = (sql.prepare << \"echo(:output, :input)\", use(out, \"output\"), use(in, \"input\")); proc.execute(true); assert(out == \"my message\"); Portability note The above way of calling stored procedures is provided for portability of the code that might need it. It is of course still possible to call procedures or functions using the syntax supported by the given database server.","title":"Procedures"},{"location":"procedures/#stored-procedures","text":"The procedure class provides a convenient mechanism for calling stored procedures: sql << \"create or replace procedure echo(output out varchar2,\" \"input in varchar2) as \" \"begin output := input; end;\"; std::string in(\"my message\"); std::string out; procedure proc = (sql.prepare << \"echo(:output, :input)\", use(out, \"output\"), use(in, \"input\")); proc.execute(true); assert(out == \"my message\");","title":"Stored Procedures"},{"location":"procedures/#portability-note","text":"The above way of calling stored procedures is provided for portability of the code that might need it. It is of course still possible to call procedures or functions using the syntax supported by the given database server.","title":"Portability note"},{"location":"queries/","text":"Queries Simple SQL statements In many cases, the SQL query is intended to be executed only once, which means that statement parsing and execution can go together. The session class provides a special once member, which triggers parsing and execution of such one-time statements: sql.once << \"drop table persons\"; For shorter syntax, the following form is also allowed: sql << \"drop table persons\"; The IOStream-like interface is exactly what it looks like, so that the statement text can be composed of many parts, involving anything that is streamable (including custom classes, if they have appropriate operator<< ): string tableName = \"persons\"; sql << \"drop table \" << tableName; int id = 123; sql << \"delete from companies where id = \" << id; Query transformation In SOCI 3.2.0, query transformation mechanism was introduced. Query transformation is specified as user-defined unary function or callable function object with input parameter of type std::string which returns object of type std::string as well. The query transformation function is registered for current database session using dedicated session::set_query_transformation method. Then, the transformation function is called with query string as argument just before the query is sent to database backend for execution or for preparation. For one-time statements, query transformation is performed before each execution of statement. For prepared statements, query is transformed only once, before preparation, regardless how many times it is executed. A few short examples how to use query transformation: defined as free function: std::string less_than_ten(std::string query) { return query + \" WHERE price < 10\"; } session sql(postgresql, \"dbname=mydb\"); sql.set_query_transformation(less_than_ten); sql << \"DELETE FROM item\"; defined as function object: struct order { order(std::string const& by) : by_(by) {} std::string operator()(std::string const& query) const { return query + \" ORDER BY \" + by_; } std::string by_; }; char const* query = \"SELECT * FROM product\"; sql.set_query_transformation(order(\"price\")); sql << query; sql.set_query_transformation(order(\"id\")); sql << query; defined as lambda function (since C++11): std::string dep = \"sales\"; sql.set_query_transformation( [&dep](std::string const& query) { return query + \" WHERE department = '\" + dep + \"'\"; }); sql << \"SELECT * FROM employee\"; Query transformations enable users with simple mechanism to apply extra requirements to or interact with SQL statement being executed and that is without changing the SQL statement itself which may be passed from different parts of application. For example, the query transformation may be used to: modify or add clauses of SQL statements (i.e. WHERE clause with new condition) prefix table names with new schema to allow namespaces switch validate SQL statements perform sanitization checking for any unverified input apply database-specific features like add optimization hints to SQL statements (i.e. SELECT /*+RULE*/ A FROM C in Oracle 9)","title":"Queries"},{"location":"queries/#queries","text":"","title":"Queries"},{"location":"queries/#simple-sql-statements","text":"In many cases, the SQL query is intended to be executed only once, which means that statement parsing and execution can go together. The session class provides a special once member, which triggers parsing and execution of such one-time statements: sql.once << \"drop table persons\"; For shorter syntax, the following form is also allowed: sql << \"drop table persons\"; The IOStream-like interface is exactly what it looks like, so that the statement text can be composed of many parts, involving anything that is streamable (including custom classes, if they have appropriate operator<< ): string tableName = \"persons\"; sql << \"drop table \" << tableName; int id = 123; sql << \"delete from companies where id = \" << id;","title":"Simple SQL statements"},{"location":"queries/#query-transformation","text":"In SOCI 3.2.0, query transformation mechanism was introduced. Query transformation is specified as user-defined unary function or callable function object with input parameter of type std::string which returns object of type std::string as well. The query transformation function is registered for current database session using dedicated session::set_query_transformation method. Then, the transformation function is called with query string as argument just before the query is sent to database backend for execution or for preparation. For one-time statements, query transformation is performed before each execution of statement. For prepared statements, query is transformed only once, before preparation, regardless how many times it is executed. A few short examples how to use query transformation: defined as free function: std::string less_than_ten(std::string query) { return query + \" WHERE price < 10\"; } session sql(postgresql, \"dbname=mydb\"); sql.set_query_transformation(less_than_ten); sql << \"DELETE FROM item\"; defined as function object: struct order { order(std::string const& by) : by_(by) {} std::string operator()(std::string const& query) const { return query + \" ORDER BY \" + by_; } std::string by_; }; char const* query = \"SELECT * FROM product\"; sql.set_query_transformation(order(\"price\")); sql << query; sql.set_query_transformation(order(\"id\")); sql << query; defined as lambda function (since C++11): std::string dep = \"sales\"; sql.set_query_transformation( [&dep](std::string const& query) { return query + \" WHERE department = '\" + dep + \"'\"; }); sql << \"SELECT * FROM employee\"; Query transformations enable users with simple mechanism to apply extra requirements to or interact with SQL statement being executed and that is without changing the SQL statement itself which may be passed from different parts of application. For example, the query transformation may be used to: modify or add clauses of SQL statements (i.e. WHERE clause with new condition) prefix table names with new schema to allow namespaces switch validate SQL statements perform sanitization checking for any unverified input apply database-specific features like add optimization hints to SQL statements (i.e. SELECT /*+RULE*/ A FROM C in Oracle 9)","title":"Query transformation"},{"location":"quickstart/","text":"Quickstart The following (complete!) example is purposedly provided without any explanation. #include \"soci.h\" #include \"soci-oracle.h\" #include <iostream> #include <istream> #include <ostream> #include <string> #include <exception> using namespace soci; using namespace std; bool get_name(string &name) { cout << \"Enter name: \"; return cin >> name; } int main() { try { session sql(oracle, \"service=mydb user=john password=secret\"); int count; sql << \"select count(*) from phonebook\", into(count); cout << \"We have \" << count << \" entries in the phonebook.\\n\"; string name; while (get_name(name)) { string phone; indicator ind; sql << \"select phone from phonebook where name = :name\", into(phone, ind), use(name); if (ind == i_ok) { cout << \"The phone number is \" << phone << '\\n'; } else { cout << \"There is no phone for \" << name << '\\n'; } } } catch (exception const &e) { cerr << \"Error: \" << e.what() << '\\n'; } }","title":"Getting Started"},{"location":"quickstart/#quickstart","text":"The following (complete!) example is purposedly provided without any explanation. #include \"soci.h\" #include \"soci-oracle.h\" #include <iostream> #include <istream> #include <ostream> #include <string> #include <exception> using namespace soci; using namespace std; bool get_name(string &name) { cout << \"Enter name: \"; return cin >> name; } int main() { try { session sql(oracle, \"service=mydb user=john password=secret\"); int count; sql << \"select count(*) from phonebook\", into(count); cout << \"We have \" << count << \" entries in the phonebook.\\n\"; string name; while (get_name(name)) { string phone; indicator ind; sql << \"select phone from phonebook where name = :name\", into(phone, ind), use(name); if (ind == i_ok) { cout << \"The phone number is \" << phone << '\\n'; } else { cout << \"There is no phone for \" << name << '\\n'; } } } catch (exception const &e) { cerr << \"Error: \" << e.what() << '\\n'; } }","title":"Quickstart"},{"location":"statements/","text":"Statements Prepared statement Consider the following examples: // Example 1. for (int i = 0; i != 100; ++i) { sql << \"insert into numbers(value) values(\" << i << \")\"; } // Example 2. for (int i = 0; i != 100; ++i) { sql << \"insert into numbers(value) values(:val)\", use(i); } Both examples will populate the table numbers with the values from 0 to 99 . The problem is that in both examples, not only the statement execution is repeated 100 times, but also the statement parsing and preparation. This means unnecessary overhead, even if some of the database servers are likely to optimize the second case. In fact, more complicated queries are likely to suffer in terms of lower performance, because finding the optimal execution plan is quite expensive and here it would be needlessly repeated. Statement preparation The following example uses the class statement explicitly, by preparing the statement only once and repeating its execution with changing data (note the use of prepare member of session class): int i; statement st = (sql.prepare << \"insert into numbers(value) values(:val)\", use(i)); for (i = 0; i != 100; ++i) { st.execute(true); } The true parameter given to the execute method indicates that the actual data exchange is wanted, so that the meaning of the whole example is \"prepare the statement and exchange the data for each value of variable i \". Portability note: The above syntax is supported for all backends, even if some database server does not actually provide this functionality - in which case the library will internally execute the query in a single phase, without really separating the statement preparation from execution. Rowset and iterator The rowset class provides an alternative means of executing queries and accessing results using STL-like iterator interface. The rowset_iterator type is compatible with requirements defined for input iterator category and is available via iterator and const_iterator definitions in the rowset class. The rowset itself can be used only with select queries. The following example creates an instance of the rowset class and binds query results into elements of int type - in this query only one result column is expected. After executing the query the code iterates through the query result using rowset_iterator : rowset<int> rs = (sql.prepare << \"select values from numbers\"); for (rowset<int>::const_iterator it = rs.begin(); it != rs.end(); ++it) { cout << *it << '\\n'; } Another example shows how to retrieve more complex results, where rowset elements are of type row and therefore use dynamic bindings : // person table has 4 columns rowset<row> rs = (sql.prepare << \"select id, firstname, lastname, gender from person\"); // iteration through the resultset: for (rowset<row>::const_iterator it = rs.begin(); it != rs.end(); ++it) { row const& row = *it; // dynamic data extraction from each row: cout << \"Id: \" << row.get<int>(0) << '\\n' << \"Name: \" << row.get<string>(1) << \" \" << row.get<string>(2) << '\\n' << \"Gender: \" << row.get<string>(3) << endl; } The rowset_iterator can be used with standard algorithms as well: rowset<string> rs = (sql.prepare << \"select firstname from person\"); std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, \"\\n\")); Above, the query result contains a single column which is bound to rowset element of type of std::string . All records are sent to standard output using the std::copy algorithm. If you need to use the Core interface with rowset , the following example shows how: row r; statement st(sql); st.alloc(); st.prepare(\"select values from numbers\"); st.define_and_bind(); // after define_and_bind and before execute st.exchange_for_rowset(into(r)); st.execute(false); rowset_iterator<row> it(st, r); rowset_iterator<row> end; for (; it != end; ++it) { // ... access *it } Bulk operations When using some databases, further performance improvements may be possible by having the underlying database API group operations together to reduce network roundtrips. SOCI makes such bulk operations possible by supporting std::vector based types. The following example presents how to insert 100 records in 4 batches. It is also important to note, that size of vector remains equal in every batch interaction. This ensures vector is not reallocated and, what's crucial for the bulk trick, new data should be pushed to the vector before every call to statement::execute : // Example 3. void fill_ids(std::vector<int>& ids) { for (std::size_t i = 0; i < ids.size(); ++i) ids[i] = i; // mimics source of a new ID } const int BATCH_SIZE = 25; std::vector<int> ids(BATCH_SIZE); statement st = (sql.prepare << \"insert into numbers(value) values(:val)\", use(ids)); for (int i = 0; i != 4; ++i) { fill_ids(ids); st.execute(true); } Given batch size is 25, this example should insert 4 x 25 = 100 records. (Of course, the size of the vector that will achieve optimum performance will vary, depending on many environmental factors, such as network speed.) It is also possible to read all the numbers written in the above examples: int i; statement st = (sql.prepare << \"select value from numbers order by value\", into(i)); st.execute(); while (st.fetch()) { cout << i << '\\n'; } In the above example, the execute method is called with the default parameter false . This means that the statement should be executed, but the actual data exchange will be performed later. Further fetch calls perform the actual data retrieval and cursor traversal. The end-of-cursor condition is indicated by the fetch function returning false . The above code example should be treated as an idiomatic way of reading many rows of data, one at a time . It is further possible to select records in batches into std::vector based types, with the size of the vector specifying the number of records to retrieve in each round trip: std::vector<int> valsOut(100); sql << \"select val from numbers\", into(valsOut); Above, the value 100 indicates that no more values should be retrieved, even if it would be otherwise possible. If there are less rows than asked for, the vector will be appropriately down-sized. The statement::execute() and statement::fetch() functions can also be used to repeatedly select all rows returned by a query into a vector based type: const int BATCH_SIZE = 30; std::vector<int> valsOut(BATCH_SIZE); statement st = (sql.prepare << \"select value from numbers\", into(valsOut)); st.execute(); while (st.fetch()) { std::vector<int>::iterator pos; for(pos = valsOut.begin(); pos != valsOut.end(); ++pos) { cout << *pos << '\\n'; } valsOut.resize(BATCH_SIZE); } Assuming there are 100 rows returned by the query, the above code will retrieve and print all of them. Since the output vector was created with size 30, it will take (at least) 4 calls to fetch() to retrieve all 100 values. Each call to fetch() can potentially resize the vector to a size less than its initial size - how often this happens depends on the underlying database implementation. This explains why the resize(BATCH_SIZE) operation is needed - it is there to ensure that each time the fetch() is called, the vector is ready to accept the next bunch of values. Without this operation, the vector might be getting smaller with subsequent iterations of the loop, forcing more iterations to be performed (because all rows will be read anyway), than really needed. Note the following details about the above examples: After performing fetch() , the vector's size might be less than requested, but fetch() returning true means that there was at least one row retrieved. It is forbidden to manually resize the vector to the size higher than it was initially (this can cause the vector to reallocate its internal buffer and the library can lose track of it). Taking these points under consideration, the above code example should be treated as an idiomatic way of reading many rows by bunches of requested size. Portability note Actually, all supported backends guarantee that the requested number of rows will be read with each fetch and that the vector will never be down-sized, unless for the last fetch, when the end of rowset condition is met. This means that the manual vector resizing is in practice not needed - the vector will keep its size until the end of rowset. The above idiom, however, is provided with future backends in mind, where the constant size of the vector might be too expensive to guarantee and where allowing fetch to down-size the vector even before reaching the end of rowset might buy some performance gains. Statement caching Some backends have some facilities to improve statement parsing and compilation to limit overhead when creating commonly used query. But for backends that does not support this kind optimization you can keep prepared statement and use it later with new references. To do such, prepare a statement as usual, you have to use exchange to bind new variables to statement object, then execute statement and finish by cleaning bound references with bind_clean_up . sql << \"CREATE TABLE test(a INTEGER)\"; { // prepare statement soci::statement stmt = (db.prepare << \"INSERT INTO numbers(value) VALUES(:val)\"); { // first insert int a0 = 0; // update reference stmt.exchange(soci::use(a0)); stmt.define_and_bind(); stmt.execute(true); stmt.bind_clean_up(); } { // come later, second insert int a1 = 1; // update reference stmt.exchange(soci::use(a1)); stmt.define_and_bind(); stmt.execute(true); stmt.bind_clean_up(); } } { std::vector<int> v(10); db << \"SELECT value FROM numbers\", soci::into(v); for (int i = 0; i < v.size(); ++i) std::cout << \"value \" << i << \": \" << v[i] << std::endl; }","title":"Statements"},{"location":"statements/#statements","text":"","title":"Statements"},{"location":"statements/#prepared-statement","text":"Consider the following examples: // Example 1. for (int i = 0; i != 100; ++i) { sql << \"insert into numbers(value) values(\" << i << \")\"; } // Example 2. for (int i = 0; i != 100; ++i) { sql << \"insert into numbers(value) values(:val)\", use(i); } Both examples will populate the table numbers with the values from 0 to 99 . The problem is that in both examples, not only the statement execution is repeated 100 times, but also the statement parsing and preparation. This means unnecessary overhead, even if some of the database servers are likely to optimize the second case. In fact, more complicated queries are likely to suffer in terms of lower performance, because finding the optimal execution plan is quite expensive and here it would be needlessly repeated.","title":"Prepared statement"},{"location":"statements/#statement-preparation","text":"The following example uses the class statement explicitly, by preparing the statement only once and repeating its execution with changing data (note the use of prepare member of session class): int i; statement st = (sql.prepare << \"insert into numbers(value) values(:val)\", use(i)); for (i = 0; i != 100; ++i) { st.execute(true); } The true parameter given to the execute method indicates that the actual data exchange is wanted, so that the meaning of the whole example is \"prepare the statement and exchange the data for each value of variable i \".","title":"Statement preparation"},{"location":"statements/#portability-note","text":"The above syntax is supported for all backends, even if some database server does not actually provide this functionality - in which case the library will internally execute the query in a single phase, without really separating the statement preparation from execution.","title":"Portability note:"},{"location":"statements/#rowset-and-iterator","text":"The rowset class provides an alternative means of executing queries and accessing results using STL-like iterator interface. The rowset_iterator type is compatible with requirements defined for input iterator category and is available via iterator and const_iterator definitions in the rowset class. The rowset itself can be used only with select queries. The following example creates an instance of the rowset class and binds query results into elements of int type - in this query only one result column is expected. After executing the query the code iterates through the query result using rowset_iterator : rowset<int> rs = (sql.prepare << \"select values from numbers\"); for (rowset<int>::const_iterator it = rs.begin(); it != rs.end(); ++it) { cout << *it << '\\n'; } Another example shows how to retrieve more complex results, where rowset elements are of type row and therefore use dynamic bindings : // person table has 4 columns rowset<row> rs = (sql.prepare << \"select id, firstname, lastname, gender from person\"); // iteration through the resultset: for (rowset<row>::const_iterator it = rs.begin(); it != rs.end(); ++it) { row const& row = *it; // dynamic data extraction from each row: cout << \"Id: \" << row.get<int>(0) << '\\n' << \"Name: \" << row.get<string>(1) << \" \" << row.get<string>(2) << '\\n' << \"Gender: \" << row.get<string>(3) << endl; } The rowset_iterator can be used with standard algorithms as well: rowset<string> rs = (sql.prepare << \"select firstname from person\"); std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, \"\\n\")); Above, the query result contains a single column which is bound to rowset element of type of std::string . All records are sent to standard output using the std::copy algorithm. If you need to use the Core interface with rowset , the following example shows how: row r; statement st(sql); st.alloc(); st.prepare(\"select values from numbers\"); st.define_and_bind(); // after define_and_bind and before execute st.exchange_for_rowset(into(r)); st.execute(false); rowset_iterator<row> it(st, r); rowset_iterator<row> end; for (; it != end; ++it) { // ... access *it }","title":"Rowset and iterator"},{"location":"statements/#bulk-operations","text":"When using some databases, further performance improvements may be possible by having the underlying database API group operations together to reduce network roundtrips. SOCI makes such bulk operations possible by supporting std::vector based types. The following example presents how to insert 100 records in 4 batches. It is also important to note, that size of vector remains equal in every batch interaction. This ensures vector is not reallocated and, what's crucial for the bulk trick, new data should be pushed to the vector before every call to statement::execute : // Example 3. void fill_ids(std::vector<int>& ids) { for (std::size_t i = 0; i < ids.size(); ++i) ids[i] = i; // mimics source of a new ID } const int BATCH_SIZE = 25; std::vector<int> ids(BATCH_SIZE); statement st = (sql.prepare << \"insert into numbers(value) values(:val)\", use(ids)); for (int i = 0; i != 4; ++i) { fill_ids(ids); st.execute(true); } Given batch size is 25, this example should insert 4 x 25 = 100 records. (Of course, the size of the vector that will achieve optimum performance will vary, depending on many environmental factors, such as network speed.) It is also possible to read all the numbers written in the above examples: int i; statement st = (sql.prepare << \"select value from numbers order by value\", into(i)); st.execute(); while (st.fetch()) { cout << i << '\\n'; } In the above example, the execute method is called with the default parameter false . This means that the statement should be executed, but the actual data exchange will be performed later. Further fetch calls perform the actual data retrieval and cursor traversal. The end-of-cursor condition is indicated by the fetch function returning false . The above code example should be treated as an idiomatic way of reading many rows of data, one at a time . It is further possible to select records in batches into std::vector based types, with the size of the vector specifying the number of records to retrieve in each round trip: std::vector<int> valsOut(100); sql << \"select val from numbers\", into(valsOut); Above, the value 100 indicates that no more values should be retrieved, even if it would be otherwise possible. If there are less rows than asked for, the vector will be appropriately down-sized. The statement::execute() and statement::fetch() functions can also be used to repeatedly select all rows returned by a query into a vector based type: const int BATCH_SIZE = 30; std::vector<int> valsOut(BATCH_SIZE); statement st = (sql.prepare << \"select value from numbers\", into(valsOut)); st.execute(); while (st.fetch()) { std::vector<int>::iterator pos; for(pos = valsOut.begin(); pos != valsOut.end(); ++pos) { cout << *pos << '\\n'; } valsOut.resize(BATCH_SIZE); } Assuming there are 100 rows returned by the query, the above code will retrieve and print all of them. Since the output vector was created with size 30, it will take (at least) 4 calls to fetch() to retrieve all 100 values. Each call to fetch() can potentially resize the vector to a size less than its initial size - how often this happens depends on the underlying database implementation. This explains why the resize(BATCH_SIZE) operation is needed - it is there to ensure that each time the fetch() is called, the vector is ready to accept the next bunch of values. Without this operation, the vector might be getting smaller with subsequent iterations of the loop, forcing more iterations to be performed (because all rows will be read anyway), than really needed. Note the following details about the above examples: After performing fetch() , the vector's size might be less than requested, but fetch() returning true means that there was at least one row retrieved. It is forbidden to manually resize the vector to the size higher than it was initially (this can cause the vector to reallocate its internal buffer and the library can lose track of it). Taking these points under consideration, the above code example should be treated as an idiomatic way of reading many rows by bunches of requested size.","title":"Bulk operations"},{"location":"statements/#portability-note_1","text":"Actually, all supported backends guarantee that the requested number of rows will be read with each fetch and that the vector will never be down-sized, unless for the last fetch, when the end of rowset condition is met. This means that the manual vector resizing is in practice not needed - the vector will keep its size until the end of rowset. The above idiom, however, is provided with future backends in mind, where the constant size of the vector might be too expensive to guarantee and where allowing fetch to down-size the vector even before reaching the end of rowset might buy some performance gains.","title":"Portability note"},{"location":"statements/#statement-caching","text":"Some backends have some facilities to improve statement parsing and compilation to limit overhead when creating commonly used query. But for backends that does not support this kind optimization you can keep prepared statement and use it later with new references. To do such, prepare a statement as usual, you have to use exchange to bind new variables to statement object, then execute statement and finish by cleaning bound references with bind_clean_up . sql << \"CREATE TABLE test(a INTEGER)\"; { // prepare statement soci::statement stmt = (db.prepare << \"INSERT INTO numbers(value) VALUES(:val)\"); { // first insert int a0 = 0; // update reference stmt.exchange(soci::use(a0)); stmt.define_and_bind(); stmt.execute(true); stmt.bind_clean_up(); } { // come later, second insert int a1 = 1; // update reference stmt.exchange(soci::use(a1)); stmt.define_and_bind(); stmt.execute(true); stmt.bind_clean_up(); } } { std::vector<int> v(10); db << \"SELECT value FROM numbers\", soci::into(v); for (int i = 0; i < v.size(); ++i) std::cout << \"value \" << i << \": \" << v[i] << std::endl; }","title":"Statement caching"},{"location":"structure/","text":"Structure The picture below presents the structure of the library, together with its clients and servers. The boxes filled with cyan represent components that are part of the library distribution. The SOCI library is extensible in the following ways: More backends can be added to target various database servers. More interfaces can be defined on top of common backend interface. Other languages can use the simple interface , which was designed specifically for the \"C\" calling convention to ensure easy binding. The core part of the library and the backend interface definition are placed in the core directory of the library distribution. The soci-backend.h file is an internal abstract interface to the actual backends, which are needed to perform operations on the given database server. Normally, the C++ client program needs to interface with the soci.h header and the header(s) relevant to the given backend(s) (for example, soci-oracle.h ), although with dynamic backend loading this can be avoided. It is possible for the same program to use many backends at the same time. Everything in SOCI is declared in the namespace soci . All code examples presented in this documentation assume that your code begins with something like: #include <soci/soci.h> // other includes if necessary using namespace soci; // ... Note: In simple programs, #include for the relevant backend is needed only in the file where the session object is created with explicit name of the backend factory. The example program on the previous page shows the appropriate #include directive for the Oracle backend. It is also possible to name backends at run-time as part of the connection string, in which case no backend-specific #include directive is necessary.","title":"Library Structure"},{"location":"structure/#structure","text":"The picture below presents the structure of the library, together with its clients and servers. The boxes filled with cyan represent components that are part of the library distribution. The SOCI library is extensible in the following ways: More backends can be added to target various database servers. More interfaces can be defined on top of common backend interface. Other languages can use the simple interface , which was designed specifically for the \"C\" calling convention to ensure easy binding. The core part of the library and the backend interface definition are placed in the core directory of the library distribution. The soci-backend.h file is an internal abstract interface to the actual backends, which are needed to perform operations on the given database server. Normally, the C++ client program needs to interface with the soci.h header and the header(s) relevant to the given backend(s) (for example, soci-oracle.h ), although with dynamic backend loading this can be avoided. It is possible for the same program to use many backends at the same time. Everything in SOCI is declared in the namespace soci . All code examples presented in this documentation assume that your code begins with something like: #include <soci/soci.h> // other includes if necessary using namespace soci; // ... Note: In simple programs, #include for the relevant backend is needed only in the file where the session object is created with explicit name of the backend factory. The example program on the previous page shows the appropriate #include directive for the Oracle backend. It is also possible to name backends at run-time as part of the connection string, in which case no backend-specific #include directive is necessary.","title":"Structure"},{"location":"transactions/","text":"Transactions The SOCI library provides the following members of the session class for transaction management: void begin(); void commit(); void rollback(); In addition to the above there is a RAII wrapper that allows to associate the transaction with the given scope of code: class transaction { public: explicit transaction(session & sql); ~transaction(); void commit(); void rollback(); private: // ... }; The object of class transaction will roll back automatically when the object is destroyed (usually as a result of leaving the scope) and when the transaction was not explicitly committed before that. A typical usage pattern for this class might be: { transaction tr(sql); sql << \"insert into ...\"; sql << \"more sql queries ...\"; // ... tr.commit(); } With the above pattern the transaction is committed only when the code successfully reaches the end of block. If some exception is thrown before that, the scope will be left without reaching the final statement and the transaction object will automatically roll back in its destructor.","title":"Transactions"},{"location":"transactions/#transactions","text":"The SOCI library provides the following members of the session class for transaction management: void begin(); void commit(); void rollback(); In addition to the above there is a RAII wrapper that allows to associate the transaction with the given scope of code: class transaction { public: explicit transaction(session & sql); ~transaction(); void commit(); void rollback(); private: // ... }; The object of class transaction will roll back automatically when the object is destroyed (usually as a result of leaving the scope) and when the transaction was not explicitly committed before that. A typical usage pattern for this class might be: { transaction tr(sql); sql << \"insert into ...\"; sql << \"more sql queries ...\"; // ... tr.commit(); } With the above pattern the transaction is committed only when the code successfully reaches the end of block. If some exception is thrown before that, the scope will be left without reaching the final statement and the transaction object will automatically roll back in its destructor.","title":"Transactions"},{"location":"types/","text":"Data Types Static binding The static binding for types is most useful when the types used in the database are known at compile time - this was already presented above with the help of into and use functions. The following types are currently supported for use with into and use expressions: char (for character values) short , int , unsigned long , long long , double (for numeric values) std::string (for string values) std::tm (for datetime values) soci::statement (for nested statements and PL/SQL cursors) soci::blob (for Binary Large OBjects) soci::row_id (for row identifiers) See the test code that accompanies the library to see how each of these types is used. Static binding for bulk operations Bulk inserts, updates, and selects are supported through the following std::vector based into and use types: std::vector<char> std::vector<short> std::vector<int> std::vector<unsigned long> std::vector<long long> std::vector<double> std::vector<std::string> std::vector<std::tm> Use of the vector based types mirrors that of the standard types, with the size of the vector used to specify the number of records to process at a time. See below for examples. Bulk operations are supported also for std::vector s of the user-provided types that have appropriate conversion routines defines. Dynamic binding For certain applications it is desirable to be able to select data from arbitrarily structured tables (e.g. via \" select * from ... \") and format the resulting data based upon its type. SOCI supports binding dynamic resultset through the soci::row and soci::column_properties classes. Data is selected into a row object, which holds column_properties objects describing the attributes of data contained in each column. Once the data type for each column is known, the data can be formatted appropriately. For example, the code below creates an XML document from a selected row of data from an arbitrary table: row r; sql << \"select * from some_table\", into(r); std::ostringstream doc; doc << \"<row>\" << std::endl; for(std::size_t i = 0; i != r.size(); ++i) { const column_properties & props = r.get_properties(i); doc << '<' << props.get_name() << '>'; switch(props.get_data_type()) { case dt_string: doc << r.get<std::string>(i); break; case dt_double: doc << r.get<double>(i); break; case dt_integer: doc << r.get<int>(i); break; case dt_long_long: doc << r.get<long long>(i); break; case dt_unsigned_long_long: doc << r.get<unsigned long long>(i); break; case dt_date: std::tm when = r.get<std::tm>(i); doc << asctime(&when); break; } doc << \"</\" << props.get_name() << '>' << std::endl; } doc << \"</row>\"; The type T parameter that should be passed to row::get<T>() depends on the SOCI data type that is returned from column_properties::get_data_type() . row::get<T>() throws an exception of type std::bad_cast if an incorrect type T is requested. SOCI Data Type row::get<T> specialization dt_double double dt_integer int dt_long_long long long dt_unsigned_long_long unsigned long long dt_string std::string dt_date std::tm The mapping of underlying database column types to SOCI datatypes is database specific. See the backend documentation for details. The row also provides access to indicators for each column: row r; sql << \"select name from some_table where id = 1\", into(r); if (r.get_indicator(0) != soci::i_null) { std::cout << r.get<std::string>(0); } It is also possible to extract data from the row object using its stream-like interface, where each extracted variable should have matching type respective to its position in the chain: row r; sql << \"select name, address, age from persons where id = 123\", into(r); string name, address; int age; r >> name >> address >> age; Note, however, that this interface is not compatible with the standard std::istream class and that it is only possible to extract a single row at a time - for \"safety\" reasons the row boundary is preserved and it is necessary to perform the fetch operation explicitly for each consecutive row. User-defined C++ types SOCI can be easily extended with support for user-defined datatypes. The extension mechanism relies on appropriate specialization of the type_conversion structure that converts to and from one of the following SOCI base types: double int long long unsigned long long std::string char std::tm There are three required class members for a valid type_conversion specialization: the base_type type definition, aliasing either one of the base types or another ser-defined type the from_base() static member function, converting from the base type the to_base() static member function, converting to the base type Note that no database-specific code is required to define user conversion. The following example shows how the user can extend SOCI to support his own type MyInt , which here is some wrapper for the fundamental int type: class MyInt { public: MyInt() {} MyInt(int i) : i_(i) {} void set(int i) { i_ = i; } int get() const { return i_; } private: int i_; }; namespace soci { template <> struct type_conversion<MyInt> { typedef int base_type; static void from_base(int i, indicator ind, MyInt & mi) { if (ind == i_null) { throw soci_error(\"Null value not allowed for this type\"); } mi.set(i); } static void to_base(const MyInt & mi, int & i, indicator & ind) { i = mi.get(); ind = i_ok; } }; } The above specialization for soci::type_conversion<MyInt> is enough to enable the following: MyInt i; sql << \"select count(*) from person\", into(i); cout << \"We have \" << i.get() << \" persons in the database.\\n\"; Note that there is a number of types from the Boost library integrated with SOCI out of the box, see Integration with Boost for complete description. Use these as examples of conversions for more complext data types. Another possibility to extend SOCI with custom data types is to use the into_type<T> and use_type<T> class templates, which specializations can be user-provided. These specializations need to implement the interface defined by, respectively, the into_type_base and use_type_base classes. Note that when specializing these template classes the only convention is that when the indicator variable is used (see below), it should appear in the second position. Please refer to the library source code to see how this is done for the standard types. Object-Relational Mapping SOCI provides a class called values specifically to enable object-relational mapping via type_conversion specializations. For example, the following code maps a Person object to and from a database table containing columns \"ID\" , \"FIRST_NAME\" , \"LAST_NAME\" , and \"GENDER\" . Note that the mapping is non-invasive - the Person object itself does not contain any SOCI-specific code: struct Person { int id; std::string firstName; std::string lastName; std::string gender; }; namespace soci { template<> struct type_conversion<Person> { typedef values base_type; static void from_base(values const & v, indicator /* ind */, Person & p) { p.id = v.get<int>(\"ID\"); p.firstName = v.get<std::string>(\"FIRST_NAME\"); p.lastName = v.get<std::string>(\"LAST_NAME\"); // p.gender will be set to the default value \"unknown\" // when the column is null: p.gender = v.get<std::string>(\"GENDER\", \"unknown\"); // alternatively, the indicator can be tested directly: // if (v.indicator(\"GENDER\") == i_null) // { // p.gender = \"unknown\"; // } // else // { // p.gender = v.get<std::string>(\"GENDER\"); // } } static void to_base(const Person & p, values & v, indicator & ind) { v.set(\"ID\", p.id); v.set(\"FIRST_NAME\", p.firstName); v.set(\"LAST_NAME\", p.lastName); v.set(\"GENDER\", p.gender, p.gender.empty() ? i_null : i_ok); ind = i_ok; } }; } With the above type_conversion specialization in place, it is possible to use Person directly with SOCI: session sql(oracle, \"service=db1 user=scott password=tiger\"); Person p; p.id = 1; p.lastName = \"Smith\"; p.firstName = \"Pat\"; sql << \"insert into person(id, first_name, last_name) \" \"values(:ID, :FIRST_NAME, :LAST_NAME)\", use(p); Person p1; sql << \"select * from person\", into(p1); assert(p1.id == 1); assert(p1.firstName + p.lastName == \"PatSmith\"); assert(p1.gender == \"unknown\"); p.firstName = \"Patricia\"; sql << \"update person set first_name = :FIRST_NAME \" \"where id = :ID\", use(p); Note: The values class is currently not suited for use outside of type_conversion specializations. It is specially designed to facilitate object-relational mapping when used as shown above.","title":"Data Types"},{"location":"types/#data-types","text":"","title":"Data Types"},{"location":"types/#static-binding","text":"The static binding for types is most useful when the types used in the database are known at compile time - this was already presented above with the help of into and use functions. The following types are currently supported for use with into and use expressions: char (for character values) short , int , unsigned long , long long , double (for numeric values) std::string (for string values) std::tm (for datetime values) soci::statement (for nested statements and PL/SQL cursors) soci::blob (for Binary Large OBjects) soci::row_id (for row identifiers) See the test code that accompanies the library to see how each of these types is used.","title":"Static binding"},{"location":"types/#static-binding-for-bulk-operations","text":"Bulk inserts, updates, and selects are supported through the following std::vector based into and use types: std::vector<char> std::vector<short> std::vector<int> std::vector<unsigned long> std::vector<long long> std::vector<double> std::vector<std::string> std::vector<std::tm> Use of the vector based types mirrors that of the standard types, with the size of the vector used to specify the number of records to process at a time. See below for examples. Bulk operations are supported also for std::vector s of the user-provided types that have appropriate conversion routines defines.","title":"Static binding for bulk operations"},{"location":"types/#dynamic-binding","text":"For certain applications it is desirable to be able to select data from arbitrarily structured tables (e.g. via \" select * from ... \") and format the resulting data based upon its type. SOCI supports binding dynamic resultset through the soci::row and soci::column_properties classes. Data is selected into a row object, which holds column_properties objects describing the attributes of data contained in each column. Once the data type for each column is known, the data can be formatted appropriately. For example, the code below creates an XML document from a selected row of data from an arbitrary table: row r; sql << \"select * from some_table\", into(r); std::ostringstream doc; doc << \"<row>\" << std::endl; for(std::size_t i = 0; i != r.size(); ++i) { const column_properties & props = r.get_properties(i); doc << '<' << props.get_name() << '>'; switch(props.get_data_type()) { case dt_string: doc << r.get<std::string>(i); break; case dt_double: doc << r.get<double>(i); break; case dt_integer: doc << r.get<int>(i); break; case dt_long_long: doc << r.get<long long>(i); break; case dt_unsigned_long_long: doc << r.get<unsigned long long>(i); break; case dt_date: std::tm when = r.get<std::tm>(i); doc << asctime(&when); break; } doc << \"</\" << props.get_name() << '>' << std::endl; } doc << \"</row>\"; The type T parameter that should be passed to row::get<T>() depends on the SOCI data type that is returned from column_properties::get_data_type() . row::get<T>() throws an exception of type std::bad_cast if an incorrect type T is requested. SOCI Data Type row::get<T> specialization dt_double double dt_integer int dt_long_long long long dt_unsigned_long_long unsigned long long dt_string std::string dt_date std::tm The mapping of underlying database column types to SOCI datatypes is database specific. See the backend documentation for details. The row also provides access to indicators for each column: row r; sql << \"select name from some_table where id = 1\", into(r); if (r.get_indicator(0) != soci::i_null) { std::cout << r.get<std::string>(0); } It is also possible to extract data from the row object using its stream-like interface, where each extracted variable should have matching type respective to its position in the chain: row r; sql << \"select name, address, age from persons where id = 123\", into(r); string name, address; int age; r >> name >> address >> age; Note, however, that this interface is not compatible with the standard std::istream class and that it is only possible to extract a single row at a time - for \"safety\" reasons the row boundary is preserved and it is necessary to perform the fetch operation explicitly for each consecutive row.","title":"Dynamic binding"},{"location":"types/#user-defined-c-types","text":"SOCI can be easily extended with support for user-defined datatypes. The extension mechanism relies on appropriate specialization of the type_conversion structure that converts to and from one of the following SOCI base types: double int long long unsigned long long std::string char std::tm There are three required class members for a valid type_conversion specialization: the base_type type definition, aliasing either one of the base types or another ser-defined type the from_base() static member function, converting from the base type the to_base() static member function, converting to the base type Note that no database-specific code is required to define user conversion. The following example shows how the user can extend SOCI to support his own type MyInt , which here is some wrapper for the fundamental int type: class MyInt { public: MyInt() {} MyInt(int i) : i_(i) {} void set(int i) { i_ = i; } int get() const { return i_; } private: int i_; }; namespace soci { template <> struct type_conversion<MyInt> { typedef int base_type; static void from_base(int i, indicator ind, MyInt & mi) { if (ind == i_null) { throw soci_error(\"Null value not allowed for this type\"); } mi.set(i); } static void to_base(const MyInt & mi, int & i, indicator & ind) { i = mi.get(); ind = i_ok; } }; } The above specialization for soci::type_conversion<MyInt> is enough to enable the following: MyInt i; sql << \"select count(*) from person\", into(i); cout << \"We have \" << i.get() << \" persons in the database.\\n\"; Note that there is a number of types from the Boost library integrated with SOCI out of the box, see Integration with Boost for complete description. Use these as examples of conversions for more complext data types. Another possibility to extend SOCI with custom data types is to use the into_type<T> and use_type<T> class templates, which specializations can be user-provided. These specializations need to implement the interface defined by, respectively, the into_type_base and use_type_base classes. Note that when specializing these template classes the only convention is that when the indicator variable is used (see below), it should appear in the second position. Please refer to the library source code to see how this is done for the standard types.","title":"User-defined C++ types"},{"location":"types/#object-relational-mapping","text":"SOCI provides a class called values specifically to enable object-relational mapping via type_conversion specializations. For example, the following code maps a Person object to and from a database table containing columns \"ID\" , \"FIRST_NAME\" , \"LAST_NAME\" , and \"GENDER\" . Note that the mapping is non-invasive - the Person object itself does not contain any SOCI-specific code: struct Person { int id; std::string firstName; std::string lastName; std::string gender; }; namespace soci { template<> struct type_conversion<Person> { typedef values base_type; static void from_base(values const & v, indicator /* ind */, Person & p) { p.id = v.get<int>(\"ID\"); p.firstName = v.get<std::string>(\"FIRST_NAME\"); p.lastName = v.get<std::string>(\"LAST_NAME\"); // p.gender will be set to the default value \"unknown\" // when the column is null: p.gender = v.get<std::string>(\"GENDER\", \"unknown\"); // alternatively, the indicator can be tested directly: // if (v.indicator(\"GENDER\") == i_null) // { // p.gender = \"unknown\"; // } // else // { // p.gender = v.get<std::string>(\"GENDER\"); // } } static void to_base(const Person & p, values & v, indicator & ind) { v.set(\"ID\", p.id); v.set(\"FIRST_NAME\", p.firstName); v.set(\"LAST_NAME\", p.lastName); v.set(\"GENDER\", p.gender, p.gender.empty() ? i_null : i_ok); ind = i_ok; } }; } With the above type_conversion specialization in place, it is possible to use Person directly with SOCI: session sql(oracle, \"service=db1 user=scott password=tiger\"); Person p; p.id = 1; p.lastName = \"Smith\"; p.firstName = \"Pat\"; sql << \"insert into person(id, first_name, last_name) \" \"values(:ID, :FIRST_NAME, :LAST_NAME)\", use(p); Person p1; sql << \"select * from person\", into(p1); assert(p1.id == 1); assert(p1.firstName + p.lastName == \"PatSmith\"); assert(p1.gender == \"unknown\"); p.firstName = \"Patricia\"; sql << \"update person set first_name = :FIRST_NAME \" \"where id = :ID\", use(p); Note: The values class is currently not suited for use outside of type_conversion specializations. It is specially designed to facilitate object-relational mapping when used as shown above.","title":"Object-Relational Mapping"},{"location":"utilities/","text":"Utilities SOCI provides a portable abstraction for selection of database queries. DDL SOCI supports some basic methods to construct portable DDL queries. That is, instead of writing explicit SQL statement for creating or modifying tables, it is possible to use dedicated SOCI functions, which prepare appropriate DDL statements behind the scenes, thus enabling the user application to create basic database structures in a way that is portable across different database servers. Note that the actual support for these functions depends on the actual backend implementation. It is possible to create a new table in a single statement: sql.create_table(\"t1\").column(\"i\", soci::dt_integer).column(\"j\", soci::dt_integer); Above, table \"t1\" will be created with two columns (\"i\", \"j\") of type integer. It is also possible to build similar statements piece by piece, which is useful if the table structure is computed dynamically: { soci::ddl_type ddl = sql.create_table(\"t2\"); ddl.column(\"i\", soci::dt_integer); ddl.column(\"j\", soci::dt_integer); ddl.column(\"k\", soci::dt_integer)(\"not null\"); ddl.primary_key(\"t2_pk\", \"j\"); } The actual statement is executed at the end of above block, when the ddl object goes out of scope. The \"not null\" constraint was added to the definition of column \"k\" explicitly and in fact any piece of SQL can be inserted this way - with the obvious caveat of having limited portability (the \"not null\" piece seems to be universaly portable). Columns can be added to and dropped from already existing tables as well: sql.add_column(\"t1\", \"k\", soci::dt_integer); // or with constraint: //sql.add_column(\"t1\", \"k\", soci::dt_integer)(\"not null\"); sql.drop_column(\"t1\", \"i\"); If needed, precision and scale can be defined with additional integer arguments to functions that create columns: sql.add_column(\"t1\", \"s\", soci::dt_string, precision); sql.add_column(\"t1\", \"d\", soci::dt_double, precision, scale); Tables with foreign keys to each other can be also created: { soci::ddl_type ddl = sql.create_table(\"t3\"); ddl.column(\"x\", soci::dt_integer); ddl.column(\"y\", soci::dt_integer); ddl.foreign_key(\"t3_fk\", \"x\", \"t2\", \"j\"); } Tables can be dropped, too: sql.drop_table(\"t1\"); sql.drop_table(\"t3\"); sql.drop_table(\"t2\"); Note that due to the differences in the set of types that are actually supported on the target database server, the type mappings, as well as precision and scales, might be different, even in the way that makes them impossible to portably recover with metadata queries. In the category of portability utilities, the following functions are also available: sql.empty_blob() the above call returns the string containing expression that represents an empty BLOB value in the given target backend. This expression can be used as part of a bigger SQL statement, for example: sql << \"insert into my_table (x) values (\" + sql.empty_blob() + \")\"; and: sql.nvl() the above call returns the string containing the name of the SQL function that implements the NVL or COALESCE operation in the given target backend, for example: sql << \"select name, \" + sql.nvl() + \"(phone, \\'UNKNOWN\\') from phone_book\"; Note: empty_blob and nvl are implemented in Oracle, PostgreSQL and SQLite3 backends; for other backends their behaviour is as for PostgreSQL. DML Only two related functions are currently available in this category: get_dummy_from_clause() can be used to construct select statements that don't operate on any table in a portable way, as while some databases allow simply omitting the from clause in this case, others -- e.g. Oracle -- still require providing some syntactically valid from clause even if it is not used. To use this function, simply append the result of this function to the statement: double databasePi; session << (\"select 4*atan(1)\" + session.get_dummy_from_clause()), into(databasePi); If just the name of the dummy table is needed, and not the full clause, you can use get_dummy_from_table() to obtain it. Notice that both functions require the session to be connected as their result depends on the database it is connected to. Database Metadata It is possible to portably query the database server to obtain basic metadata information. In order to get the list of table names in the current schema: std::vector<std::string> names(100); sql.get_table_names(), into(names); alternatively: std::string name; soci::statement st = (sql.prepare_table_names(), into(name)); st.execute(); while (st.fetch()) { // ... } Similarly, to get the description of all columns in the given table: soci::column_info ci; soci::statement st = (sql.prepare_column_descriptions(table_name), into(ci)); st.execute(); while (st.fetch()) { // ci fields describe each column in turn }","title":"Utilities"},{"location":"utilities/#utilities","text":"SOCI provides a portable abstraction for selection of database queries.","title":"Utilities"},{"location":"utilities/#ddl","text":"SOCI supports some basic methods to construct portable DDL queries. That is, instead of writing explicit SQL statement for creating or modifying tables, it is possible to use dedicated SOCI functions, which prepare appropriate DDL statements behind the scenes, thus enabling the user application to create basic database structures in a way that is portable across different database servers. Note that the actual support for these functions depends on the actual backend implementation. It is possible to create a new table in a single statement: sql.create_table(\"t1\").column(\"i\", soci::dt_integer).column(\"j\", soci::dt_integer); Above, table \"t1\" will be created with two columns (\"i\", \"j\") of type integer. It is also possible to build similar statements piece by piece, which is useful if the table structure is computed dynamically: { soci::ddl_type ddl = sql.create_table(\"t2\"); ddl.column(\"i\", soci::dt_integer); ddl.column(\"j\", soci::dt_integer); ddl.column(\"k\", soci::dt_integer)(\"not null\"); ddl.primary_key(\"t2_pk\", \"j\"); } The actual statement is executed at the end of above block, when the ddl object goes out of scope. The \"not null\" constraint was added to the definition of column \"k\" explicitly and in fact any piece of SQL can be inserted this way - with the obvious caveat of having limited portability (the \"not null\" piece seems to be universaly portable). Columns can be added to and dropped from already existing tables as well: sql.add_column(\"t1\", \"k\", soci::dt_integer); // or with constraint: //sql.add_column(\"t1\", \"k\", soci::dt_integer)(\"not null\"); sql.drop_column(\"t1\", \"i\"); If needed, precision and scale can be defined with additional integer arguments to functions that create columns: sql.add_column(\"t1\", \"s\", soci::dt_string, precision); sql.add_column(\"t1\", \"d\", soci::dt_double, precision, scale); Tables with foreign keys to each other can be also created: { soci::ddl_type ddl = sql.create_table(\"t3\"); ddl.column(\"x\", soci::dt_integer); ddl.column(\"y\", soci::dt_integer); ddl.foreign_key(\"t3_fk\", \"x\", \"t2\", \"j\"); } Tables can be dropped, too: sql.drop_table(\"t1\"); sql.drop_table(\"t3\"); sql.drop_table(\"t2\"); Note that due to the differences in the set of types that are actually supported on the target database server, the type mappings, as well as precision and scales, might be different, even in the way that makes them impossible to portably recover with metadata queries. In the category of portability utilities, the following functions are also available: sql.empty_blob() the above call returns the string containing expression that represents an empty BLOB value in the given target backend. This expression can be used as part of a bigger SQL statement, for example: sql << \"insert into my_table (x) values (\" + sql.empty_blob() + \")\"; and: sql.nvl() the above call returns the string containing the name of the SQL function that implements the NVL or COALESCE operation in the given target backend, for example: sql << \"select name, \" + sql.nvl() + \"(phone, \\'UNKNOWN\\') from phone_book\"; Note: empty_blob and nvl are implemented in Oracle, PostgreSQL and SQLite3 backends; for other backends their behaviour is as for PostgreSQL.","title":"DDL"},{"location":"utilities/#dml","text":"Only two related functions are currently available in this category: get_dummy_from_clause() can be used to construct select statements that don't operate on any table in a portable way, as while some databases allow simply omitting the from clause in this case, others -- e.g. Oracle -- still require providing some syntactically valid from clause even if it is not used. To use this function, simply append the result of this function to the statement: double databasePi; session << (\"select 4*atan(1)\" + session.get_dummy_from_clause()), into(databasePi); If just the name of the dummy table is needed, and not the full clause, you can use get_dummy_from_table() to obtain it. Notice that both functions require the session to be connected as their result depends on the database it is connected to.","title":"DML"},{"location":"utilities/#database-metadata","text":"It is possible to portably query the database server to obtain basic metadata information. In order to get the list of table names in the current schema: std::vector<std::string> names(100); sql.get_table_names(), into(names); alternatively: std::string name; soci::statement st = (sql.prepare_table_names(), into(name)); st.execute(); while (st.fetch()) { // ... } Similarly, to get the description of all columns in the given table: soci::column_info ci; soci::statement st = (sql.prepare_column_descriptions(table_name), into(ci)); st.execute(); while (st.fetch()) { // ci fields describe each column in turn }","title":"Database Metadata"},{"location":"vagrant/","text":"Vagrant SOCI Vagrant used to build and provision virtual environments for hassle-free SOCI development. Features Ubuntu 14.04 (Trusty) virtual machine Multi-machine set-up with three VMs: soci , oracle , db2 . Support networking between the configured machines. soci.vm : hostname: vmsoci.local build essentials core dependencies backend dependencies FOSS databases installed with sample soci user and instance pre-configured during provision, automatically clones and builds SOCI from master branch. db2.vm : hostname: vmdb2.local IBM DB2 Express-C 9.7 installed from archive.canonical.com packages. oracle.vm : TODO : provision with Oracle XE SOCI local git repository (aka $SOCI_HOME ) is automatically shared on host and all guest machines. Prerequisites Speedy broadband, time and coffee. Recommended 4GB or much more RAM (tested with 16GB only). SOCI DB2 backend The soci.vm will be configured properly to build the DB2 backend only if it is provisioned with complete DB2 CLI client (libraries and headers). You need to download \"IBM Data Server Driver Package (DS Driver)\" manually and make it visible to Vagrant: Go to IBM Data Server Client Packages . Download \"IBM Data Server Driver Package (DS Driver)\". Copy the package to ${SOCI_HOME}/tmp directory, on host machine. Usage Below, simple and easy development workflow with Vagrant is outlined: Boot vagrant up or boot VMs selectively: vagrant up {soci|db2} First time you run it, be patient as Vagrant downloads VM box and provisions it installing all the necessary packages. You can SSH into the machine vagrant ssh {soci|db2} Run git commands can either from host or VM soci (once connected via SSH) cd /vagrant # aka $SOCI_HOME git pull origin master You can edit source code on both, on host or VM soci . For example, edit in your favourite editor on host machine, then build, run, test and debug on guest machine from command line. Alternatively, edit and build on host machine using your favourite IDE, then test and debug connecting to DBs on guest machines via network. Build on VM soci vagrant ssh soci cd /vagrant # aka $SOCI_HOME cd soci-build # aka $SOCI_BUILD make You can also execute the build.h script provided to run CMake and make vagrant ssh soci cd $SOCI_BUILD /vagrant/scripts/vagrant/build.sh Debug, only on VM soci , for example, with gdb or remotely Visual Studio 2017. Teardown vagrant {suspend|halt|destroy} {soci|db2} Check Vagrant command-line interface for complete list of commands. Environment variables All variables available to the vagrant user on the VMs are defined in and sourced from /vagrant/scripts/vagrant/common.env : SOCI_HOME where SOCI master is cloned ( /vagrant on VM soci ) SOCI_BUILD where CMake generates build configuration ( /home/vagrant/soci-build on VM soci ) SOCI_HOST network accessible VM soci hostname ( ping vmsoci.local ) SOCI_USER default database user and database name SOCI_PASS default database password for both, SOCI_USER and root/sysdba of particular database. SOCI_DB2_HOST network accessible VM db2 hostname ( ping vmdb2.local ) SOCI_DB2_USER admin username to DB2 instance. SOCI_DB2_USER admin password to DB2 instance. Note, those variables are also used by provision scripts to set up databases. Troubleshooting Analyze vagrant up output. On Windows, prefer vagrant ssh from inside MinGW Shell where ssh.exe is available or learn how to use Vagrant with PuTTY. If you modify any of scripts/vagrant/*.sh scripts, ensure they have unified end-of-line characters to LF only. Otherwise, provisioning steps may fail.","title":"Vagrant"},{"location":"vagrant/#vagrant-soci","text":"Vagrant used to build and provision virtual environments for hassle-free SOCI development.","title":"Vagrant SOCI"},{"location":"vagrant/#features","text":"Ubuntu 14.04 (Trusty) virtual machine Multi-machine set-up with three VMs: soci , oracle , db2 . Support networking between the configured machines. soci.vm : hostname: vmsoci.local build essentials core dependencies backend dependencies FOSS databases installed with sample soci user and instance pre-configured during provision, automatically clones and builds SOCI from master branch. db2.vm : hostname: vmdb2.local IBM DB2 Express-C 9.7 installed from archive.canonical.com packages. oracle.vm : TODO : provision with Oracle XE SOCI local git repository (aka $SOCI_HOME ) is automatically shared on host and all guest machines.","title":"Features"},{"location":"vagrant/#prerequisites","text":"Speedy broadband, time and coffee. Recommended 4GB or much more RAM (tested with 16GB only).","title":"Prerequisites"},{"location":"vagrant/#soci-db2-backend","text":"The soci.vm will be configured properly to build the DB2 backend only if it is provisioned with complete DB2 CLI client (libraries and headers). You need to download \"IBM Data Server Driver Package (DS Driver)\" manually and make it visible to Vagrant: Go to IBM Data Server Client Packages . Download \"IBM Data Server Driver Package (DS Driver)\". Copy the package to ${SOCI_HOME}/tmp directory, on host machine.","title":"SOCI DB2 backend"},{"location":"vagrant/#usage","text":"Below, simple and easy development workflow with Vagrant is outlined: Boot vagrant up or boot VMs selectively: vagrant up {soci|db2} First time you run it, be patient as Vagrant downloads VM box and provisions it installing all the necessary packages. You can SSH into the machine vagrant ssh {soci|db2} Run git commands can either from host or VM soci (once connected via SSH) cd /vagrant # aka $SOCI_HOME git pull origin master You can edit source code on both, on host or VM soci . For example, edit in your favourite editor on host machine, then build, run, test and debug on guest machine from command line. Alternatively, edit and build on host machine using your favourite IDE, then test and debug connecting to DBs on guest machines via network. Build on VM soci vagrant ssh soci cd /vagrant # aka $SOCI_HOME cd soci-build # aka $SOCI_BUILD make You can also execute the build.h script provided to run CMake and make vagrant ssh soci cd $SOCI_BUILD /vagrant/scripts/vagrant/build.sh Debug, only on VM soci , for example, with gdb or remotely Visual Studio 2017. Teardown vagrant {suspend|halt|destroy} {soci|db2} Check Vagrant command-line interface for complete list of commands.","title":"Usage"},{"location":"vagrant/#environment-variables","text":"All variables available to the vagrant user on the VMs are defined in and sourced from /vagrant/scripts/vagrant/common.env : SOCI_HOME where SOCI master is cloned ( /vagrant on VM soci ) SOCI_BUILD where CMake generates build configuration ( /home/vagrant/soci-build on VM soci ) SOCI_HOST network accessible VM soci hostname ( ping vmsoci.local ) SOCI_USER default database user and database name SOCI_PASS default database password for both, SOCI_USER and root/sysdba of particular database. SOCI_DB2_HOST network accessible VM db2 hostname ( ping vmdb2.local ) SOCI_DB2_USER admin username to DB2 instance. SOCI_DB2_USER admin password to DB2 instance. Note, those variables are also used by provision scripts to set up databases.","title":"Environment variables"},{"location":"vagrant/#troubleshooting","text":"Analyze vagrant up output. On Windows, prefer vagrant ssh from inside MinGW Shell where ssh.exe is available or learn how to use Vagrant with PuTTY. If you modify any of scripts/vagrant/*.sh scripts, ensure they have unified end-of-line characters to LF only. Otherwise, provisioning steps may fail.","title":"Troubleshooting"},{"location":"api/backend/","text":"Backends reference This part of the documentation is provided for those who want towrite (and contribute!) their own backends. It is anyway recommendedthat authors of new backend see the code of some existing backend forhints on how things are really done. The backend interface is a set of base classes that the actual backendsare supposed to specialize. The main SOCI interface uses only theinterface and respecting the protocol (for example, the order of function calls) described here. Note that both the interface and theprotocol were initially designed with the Oracle database in mind, which means that whereas it is quite natural with respect to the way Oracle API (OCI) works, it might impose some implementation burden on otherbackends, where things are done differently and therefore have to beadjusted, cached, converted, etc. The interface to the common SOCI interface is defined in the core/soci-backend.h header file. This file is dissected below. All names are defined in either soci or soci::details namespace. // data types, as seen by the user enum data_type { dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long }; // the enum type for indicator variables enum indicator { i_ok, i_null, i_truncated }; // data types, as used to describe exchange format enum exchange_type { x_char, x_stdstring, x_short, x_integer, x_long_long, x_unsigned_long_long, x_double, x_stdtm, x_statement, x_rowid, x_blob }; struct cstring_descriptor { cstring_descriptor(char * str, std::size_t bufSize) : str_(str), bufSize_(bufSize) {} char * str_; std::size_t bufSize_; }; // actually in error.h: class soci_error : public std::runtime_error { public: soci_error(std::string const & msg); }; The data_type enumeration type defines all types that form the core type support for SOCI. The enum itself can be used by clients when dealing with dynamic rowset description. The indicator enumeration type defines all recognized states of data. The i_truncated state is provided for the case where the string is retrieved from the database into the char buffer that is not long enough to hold the whole value. The exchange_type enumeration type defines all possible types that can be used with the into and use elements. The cstring_descriptor is a helper class that allows to store the address of char buffer together with its size. The objects of this class are passed to the backend when the x_cstring type is involved. The soci_error class is an exception type used for database-related (and also usage-related) errors. The backends should throw exceptions of this or derived type only. class standard_into_type_backend { public: standard_into_type_backend() {} virtual ~standard_into_type_backend() {} virtual void define_by_pos(int& position, void* data, exchange_type type) = 0; virtual void pre_fetch() = 0; virtual void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) = 0; virtual void clean_up() = 0; }; The standard_into_type_back_end class implements the dynamic interactions with the simple (non-bulk) into elements. The objects of this class (or, rather, of the derived class implemented by the actual backend) are created by the statement object when the into element is bound - in terms of lifetime management, statement is the master of this class. define_by_pos - Called when the into element is bound, once and before the statement is executed. The data pointer points to the variable used for into element (or to the cstring_descriptor object, which is artificially created when the plain char buffer is used for data exchange). The position parameter is a \"column number\", assigned by the library. The backend should increase this parameter, according to the number of fields actually taken (usually 1). pre_fetch - Called before each row is fetched. post_fetch - Called after each row is fetched. The gotData parameter is true if the fetch operation really retrievedsome data and false otherwise; calledFromFetch is true when the call is from the fetch operation and false if it is from the execute operation (this is also the case for simple, one-time queries). In particular, (calledFromFetch && !gotData) indicates that there is an end-of-rowset condition. ind points to the indicator provided by the user, or is NULL , if there is no indicator. clean_up - Called once when the statement is destroyed. The intended use of pre_fetch and post_fetch functions is to manage any internal buffer and/or data conversion foreach value retrieved from the database. If the given server supportsbinary data transmission and the data format for the given type agreeswith what is used on the client machine, then these two functions neednot do anything; otherwise buffer management and data conversionsshould go there. class vector_into_type_backend { public: vector_into_type_backend() {} virtual ~vector_into_type_backend() {} virtual void define_by_pos(int& position, void* data, exchange_type type) = 0; virtual void pre_fetch() = 0; virtual void post_fetch(bool gotData, indicator* ind) = 0; virtual void resize(std::size_t sz) = 0; virtual std::size_t size() = 0; virtual void clean_up() = 0; }; The vector_into_type_back_end has similar structure and purpose as the previous one, but is used for vectors (bulk data retrieval). The data pointer points to the variable of type std::vector<T>; (and not to its internal buffer), resize is supposed to really resize the user-provided vector and size is supposed to return the current size of this vector. The important difference with regard to the previous class is that ind points (if not NULL ) to the beginning of the array of indicators. The backend should fill this array according to the actual state of the retrieved data. bind_by_pos - Called for each use element, once and before the statement is executed - for those use elements that do not provide explicit names for parameter binding. The meaning of parameters is same as in previous classes. bind_by_name - Called for those use elements that provide the explicit name. pre_use - Called before the data is transmitted to the server (this means before the statement is executed, which can happen many times for the prepared statement). ind points to the indicator provided by the user (or is NULL ). post_use - Called after statement execution. gotData and ind have the same meaning as in standard_into_type_back_end::post_fetch , and this can be used by those backends whose respective servers support two-way data exchange (like in/out parameters in stored procedures). The intended use for pre_use and post_use methods is to manage any internal buffers and/or data conversion. They can be called many times with the same statement. class vector_use_type_backend { public: virtual ~vector_use_type_backend() {} virtual void bind_by_pos(int& position, void* data, exchange_type type) = 0; virtual void bind_by_name(std::string const& name, void* data, exchange_type type) = 0; virtual void pre_use(indicator const* ind) = 0; virtual std::size_t size() = 0; virtual void clean_up() = 0; }; Objects of this type (or rather of type derived from this one) are used to implement interactions with user-provided vector (bulk) use elements and are managed by the statement object. The data pointer points to the whole vector object provided by the user (and not to its internal buffer); ind points to the beginning of the array of indicators (or is NULL ). The meaning of this interface is analogous to those presented above. class statement_backend { public: statement_backend() {} virtual ~statement_backend() {} virtual void alloc() = 0; virtual void clean_up() = 0; virtual void prepare(std::string const& query, statement_type eType) = 0; enum exec_fetch_result { ef_success, ef_no_data }; virtual exec_fetch_result execute(int number) = 0; virtual exec_fetch_result fetch(int number) = 0; virtual long long get_affected_rows() = 0; virtual int get_number_of_rows() = 0; virtual std::string rewrite_for_procedure_call(std::string const& query) = 0; virtual int prepare_for_describe() = 0; virtual void describe_column(int colNum, data_type& dtype, std::string& column_name) = 0; virtual standard_into_type_backend* make_into_type_backend() = 0; virtual standard_use_type_backend* make_use_type_backend() = 0; virtual vector_into_type_backend* make_vector_into_type_backend() = 0; virtual vector_use_type_backend* make_vector_use_type_backend() = 0; }; The statement_backend type implements the internals of the statement objects. The objects of this class are created by the session object. alloc - Called once to allocate everything that is needed for the statement to work correctly. clean_up - Supposed to clean up the resources, called once. prepare - Called once with the text of the SQL query. For servers that support explicit query preparation, this is the place to do it. execute - Called to execute the query; if number is zero, the intent is not to exchange data with the user-provided objects ( into and use elements); positive values mean the number of rows to exchange (more than 1 is used only for bulk operations). fetch - Called to fetch next bunch of rows; number is positive and determines the requested number of rows (more than 1 is used only for bulk operations). get_affected_rows - Called to determine the actual number of rows affected by data modifying statement. get_number_of_rows - Called to determine the actual number of rows retrieved by the previous call to execute or fetch . rewrite_for_procedure_call - Used when the procedure is used instead of statement , to call the stored procedure. This function should rewrite the SQL query (if necessary) to the form that will allow to execute the given procedure. prepare_for_describe - Called once when the into element is used with the row type, which means that dynamic rowset description should be performed. It is supposed to do whatever is needed to later describe the column properties and should return the number of columns. describe_column - Called once for each column (column numbers - colNum - start from 1), should fill its parameters according to the column properties. make_into_type_backend , make_use_type_backend , make_vector_into_type_backend , make_vector_use_type_backend - Called once for each into or use element, to create the objects of appropriate classes (described above). Notes: Whether the query is executed using the simple one-time syntax or is prepared, the alloc , prepare and execute functions are always called, in this order. All into and use elements are bound (their define_by_pos or bind_by_pos / bind_by_name functions are called) between statement preparation and execution. class rowid_backend { public: virtual ~rowid_backend() {} }; The rowid_backend class is a hook for the backends to provide their own state for the row identifier. It has no functions, since the only portable interaction with the row identifier object is to use it with into and use elements. class blob_backend { public: virtual ~blob_backend() {} virtual std::size_t get_len() = 0; virtual std::size_t read(std::size_t offset, char * buf, std::size_t toRead) = 0; virtual std::size_t write(std::size_t offset, char const * buf, std::size_t toWrite) = 0; virtual std::size_t append(char const * buf, std::size_t toWrite) = 0; virtual void trim(std::size_t newLen) = 0; }; The blob_backend interface provides the entry points for the blob methods. class session_backend { public: virtual ~session_backend() {} virtual void begin() = 0; virtual void commit() = 0; virtual void rollback() = 0; virtual bool get_next_sequence_value(session&, std::string const&, long long&); virtual bool get_last_insert_id(session&, std::string const&, long long&); virtual std::string get_backend_name() const = 0; virtual statement_backend * make_statement_backend() = 0; virtual rowid_backend * make_rowid_backend() = 0; virtual blob_backend * make_blob_backend() = 0; }; The object of the class derived from session_backend implements the internals of the session object. begin , commit , rollback - Forward-called when the same functions of session are called by user. get_next_sequence_value , get_last_insert_id - Called to retrieve sequences or auto-generated values and every backend should define at least one of them to allow the code using auto-generated values to work. make_statement_backend , make_rowid_backend , make_blob_backend - Called to create respective implementations for the statement , rowid and blob classes. struct backend_factory { virtual ~backend_factory() {} virtual details::session_backend * make_session( std::string const& connectString) const = 0; }; The backend_factory is a base class for backend-provided factory class that is able to create valid sessions. The connectString parameter passed to make_session is provided here by the session constructor and contains only the backend-related parameters, without the backend name (if the dynamic backend loading is used). The actual backend factory object is supposed to be provided by the backend implementation and declared in its header file. In addition to this, the factory_ABC function with the \"C\" calling convention and returning the pointer to concrete factory object should be provided, where ABC is the backend name. The following example is taken from soci-postgresql.h , which declares entities of the PostgreSQL backend: struct postgresql_backend_factory : backend_factory { virtual postgresql_session_backend* make_session( std::string const& connectString) const; }; extern postgresql_backend_factory const postgresql; extern \"C\" { // for dynamic backend loading backend_factory const * factory_postgresql(); } // extern \"C\" With the above declarations, it is enough to pass the postgresql factory name to the constructor of the session object, which will use this factory to create concrete implementations for any other objects that are needed, with the help of appropriate make_XYZ functions. Alternatively, the factory_postgresql function will be called automatically by the backend loader if the backend name is provided at run-time instead. Note that the backend source code is placed in the backends/*name* directory (for example, backends/oracle ) and the test driver is in backends/*name*/test . There is also backends/empty directory provided as a skeleton for development of new backends and their tests. It is recommended that all backends respect naming conventions by just appending their name to the base-class names. The backend name used for the global factory object should clearly identify the given database engine, like oracle , postgresql , mysql , and so on.","title":"Backend API"},{"location":"api/backend/#backends-reference","text":"This part of the documentation is provided for those who want towrite (and contribute!) their own backends. It is anyway recommendedthat authors of new backend see the code of some existing backend forhints on how things are really done. The backend interface is a set of base classes that the actual backendsare supposed to specialize. The main SOCI interface uses only theinterface and respecting the protocol (for example, the order of function calls) described here. Note that both the interface and theprotocol were initially designed with the Oracle database in mind, which means that whereas it is quite natural with respect to the way Oracle API (OCI) works, it might impose some implementation burden on otherbackends, where things are done differently and therefore have to beadjusted, cached, converted, etc. The interface to the common SOCI interface is defined in the core/soci-backend.h header file. This file is dissected below. All names are defined in either soci or soci::details namespace. // data types, as seen by the user enum data_type { dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long }; // the enum type for indicator variables enum indicator { i_ok, i_null, i_truncated }; // data types, as used to describe exchange format enum exchange_type { x_char, x_stdstring, x_short, x_integer, x_long_long, x_unsigned_long_long, x_double, x_stdtm, x_statement, x_rowid, x_blob }; struct cstring_descriptor { cstring_descriptor(char * str, std::size_t bufSize) : str_(str), bufSize_(bufSize) {} char * str_; std::size_t bufSize_; }; // actually in error.h: class soci_error : public std::runtime_error { public: soci_error(std::string const & msg); }; The data_type enumeration type defines all types that form the core type support for SOCI. The enum itself can be used by clients when dealing with dynamic rowset description. The indicator enumeration type defines all recognized states of data. The i_truncated state is provided for the case where the string is retrieved from the database into the char buffer that is not long enough to hold the whole value. The exchange_type enumeration type defines all possible types that can be used with the into and use elements. The cstring_descriptor is a helper class that allows to store the address of char buffer together with its size. The objects of this class are passed to the backend when the x_cstring type is involved. The soci_error class is an exception type used for database-related (and also usage-related) errors. The backends should throw exceptions of this or derived type only. class standard_into_type_backend { public: standard_into_type_backend() {} virtual ~standard_into_type_backend() {} virtual void define_by_pos(int& position, void* data, exchange_type type) = 0; virtual void pre_fetch() = 0; virtual void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) = 0; virtual void clean_up() = 0; }; The standard_into_type_back_end class implements the dynamic interactions with the simple (non-bulk) into elements. The objects of this class (or, rather, of the derived class implemented by the actual backend) are created by the statement object when the into element is bound - in terms of lifetime management, statement is the master of this class. define_by_pos - Called when the into element is bound, once and before the statement is executed. The data pointer points to the variable used for into element (or to the cstring_descriptor object, which is artificially created when the plain char buffer is used for data exchange). The position parameter is a \"column number\", assigned by the library. The backend should increase this parameter, according to the number of fields actually taken (usually 1). pre_fetch - Called before each row is fetched. post_fetch - Called after each row is fetched. The gotData parameter is true if the fetch operation really retrievedsome data and false otherwise; calledFromFetch is true when the call is from the fetch operation and false if it is from the execute operation (this is also the case for simple, one-time queries). In particular, (calledFromFetch && !gotData) indicates that there is an end-of-rowset condition. ind points to the indicator provided by the user, or is NULL , if there is no indicator. clean_up - Called once when the statement is destroyed. The intended use of pre_fetch and post_fetch functions is to manage any internal buffer and/or data conversion foreach value retrieved from the database. If the given server supportsbinary data transmission and the data format for the given type agreeswith what is used on the client machine, then these two functions neednot do anything; otherwise buffer management and data conversionsshould go there. class vector_into_type_backend { public: vector_into_type_backend() {} virtual ~vector_into_type_backend() {} virtual void define_by_pos(int& position, void* data, exchange_type type) = 0; virtual void pre_fetch() = 0; virtual void post_fetch(bool gotData, indicator* ind) = 0; virtual void resize(std::size_t sz) = 0; virtual std::size_t size() = 0; virtual void clean_up() = 0; }; The vector_into_type_back_end has similar structure and purpose as the previous one, but is used for vectors (bulk data retrieval). The data pointer points to the variable of type std::vector<T>; (and not to its internal buffer), resize is supposed to really resize the user-provided vector and size is supposed to return the current size of this vector. The important difference with regard to the previous class is that ind points (if not NULL ) to the beginning of the array of indicators. The backend should fill this array according to the actual state of the retrieved data. bind_by_pos - Called for each use element, once and before the statement is executed - for those use elements that do not provide explicit names for parameter binding. The meaning of parameters is same as in previous classes. bind_by_name - Called for those use elements that provide the explicit name. pre_use - Called before the data is transmitted to the server (this means before the statement is executed, which can happen many times for the prepared statement). ind points to the indicator provided by the user (or is NULL ). post_use - Called after statement execution. gotData and ind have the same meaning as in standard_into_type_back_end::post_fetch , and this can be used by those backends whose respective servers support two-way data exchange (like in/out parameters in stored procedures). The intended use for pre_use and post_use methods is to manage any internal buffers and/or data conversion. They can be called many times with the same statement. class vector_use_type_backend { public: virtual ~vector_use_type_backend() {} virtual void bind_by_pos(int& position, void* data, exchange_type type) = 0; virtual void bind_by_name(std::string const& name, void* data, exchange_type type) = 0; virtual void pre_use(indicator const* ind) = 0; virtual std::size_t size() = 0; virtual void clean_up() = 0; }; Objects of this type (or rather of type derived from this one) are used to implement interactions with user-provided vector (bulk) use elements and are managed by the statement object. The data pointer points to the whole vector object provided by the user (and not to its internal buffer); ind points to the beginning of the array of indicators (or is NULL ). The meaning of this interface is analogous to those presented above. class statement_backend { public: statement_backend() {} virtual ~statement_backend() {} virtual void alloc() = 0; virtual void clean_up() = 0; virtual void prepare(std::string const& query, statement_type eType) = 0; enum exec_fetch_result { ef_success, ef_no_data }; virtual exec_fetch_result execute(int number) = 0; virtual exec_fetch_result fetch(int number) = 0; virtual long long get_affected_rows() = 0; virtual int get_number_of_rows() = 0; virtual std::string rewrite_for_procedure_call(std::string const& query) = 0; virtual int prepare_for_describe() = 0; virtual void describe_column(int colNum, data_type& dtype, std::string& column_name) = 0; virtual standard_into_type_backend* make_into_type_backend() = 0; virtual standard_use_type_backend* make_use_type_backend() = 0; virtual vector_into_type_backend* make_vector_into_type_backend() = 0; virtual vector_use_type_backend* make_vector_use_type_backend() = 0; }; The statement_backend type implements the internals of the statement objects. The objects of this class are created by the session object. alloc - Called once to allocate everything that is needed for the statement to work correctly. clean_up - Supposed to clean up the resources, called once. prepare - Called once with the text of the SQL query. For servers that support explicit query preparation, this is the place to do it. execute - Called to execute the query; if number is zero, the intent is not to exchange data with the user-provided objects ( into and use elements); positive values mean the number of rows to exchange (more than 1 is used only for bulk operations). fetch - Called to fetch next bunch of rows; number is positive and determines the requested number of rows (more than 1 is used only for bulk operations). get_affected_rows - Called to determine the actual number of rows affected by data modifying statement. get_number_of_rows - Called to determine the actual number of rows retrieved by the previous call to execute or fetch . rewrite_for_procedure_call - Used when the procedure is used instead of statement , to call the stored procedure. This function should rewrite the SQL query (if necessary) to the form that will allow to execute the given procedure. prepare_for_describe - Called once when the into element is used with the row type, which means that dynamic rowset description should be performed. It is supposed to do whatever is needed to later describe the column properties and should return the number of columns. describe_column - Called once for each column (column numbers - colNum - start from 1), should fill its parameters according to the column properties. make_into_type_backend , make_use_type_backend , make_vector_into_type_backend , make_vector_use_type_backend - Called once for each into or use element, to create the objects of appropriate classes (described above). Notes: Whether the query is executed using the simple one-time syntax or is prepared, the alloc , prepare and execute functions are always called, in this order. All into and use elements are bound (their define_by_pos or bind_by_pos / bind_by_name functions are called) between statement preparation and execution. class rowid_backend { public: virtual ~rowid_backend() {} }; The rowid_backend class is a hook for the backends to provide their own state for the row identifier. It has no functions, since the only portable interaction with the row identifier object is to use it with into and use elements. class blob_backend { public: virtual ~blob_backend() {} virtual std::size_t get_len() = 0; virtual std::size_t read(std::size_t offset, char * buf, std::size_t toRead) = 0; virtual std::size_t write(std::size_t offset, char const * buf, std::size_t toWrite) = 0; virtual std::size_t append(char const * buf, std::size_t toWrite) = 0; virtual void trim(std::size_t newLen) = 0; }; The blob_backend interface provides the entry points for the blob methods. class session_backend { public: virtual ~session_backend() {} virtual void begin() = 0; virtual void commit() = 0; virtual void rollback() = 0; virtual bool get_next_sequence_value(session&, std::string const&, long long&); virtual bool get_last_insert_id(session&, std::string const&, long long&); virtual std::string get_backend_name() const = 0; virtual statement_backend * make_statement_backend() = 0; virtual rowid_backend * make_rowid_backend() = 0; virtual blob_backend * make_blob_backend() = 0; }; The object of the class derived from session_backend implements the internals of the session object. begin , commit , rollback - Forward-called when the same functions of session are called by user. get_next_sequence_value , get_last_insert_id - Called to retrieve sequences or auto-generated values and every backend should define at least one of them to allow the code using auto-generated values to work. make_statement_backend , make_rowid_backend , make_blob_backend - Called to create respective implementations for the statement , rowid and blob classes. struct backend_factory { virtual ~backend_factory() {} virtual details::session_backend * make_session( std::string const& connectString) const = 0; }; The backend_factory is a base class for backend-provided factory class that is able to create valid sessions. The connectString parameter passed to make_session is provided here by the session constructor and contains only the backend-related parameters, without the backend name (if the dynamic backend loading is used). The actual backend factory object is supposed to be provided by the backend implementation and declared in its header file. In addition to this, the factory_ABC function with the \"C\" calling convention and returning the pointer to concrete factory object should be provided, where ABC is the backend name. The following example is taken from soci-postgresql.h , which declares entities of the PostgreSQL backend: struct postgresql_backend_factory : backend_factory { virtual postgresql_session_backend* make_session( std::string const& connectString) const; }; extern postgresql_backend_factory const postgresql; extern \"C\" { // for dynamic backend loading backend_factory const * factory_postgresql(); } // extern \"C\" With the above declarations, it is enough to pass the postgresql factory name to the constructor of the session object, which will use this factory to create concrete implementations for any other objects that are needed, with the help of appropriate make_XYZ functions. Alternatively, the factory_postgresql function will be called automatically by the backend loader if the backend name is provided at run-time instead. Note that the backend source code is placed in the backends/*name* directory (for example, backends/oracle ) and the test driver is in backends/*name*/test . There is also backends/empty directory provided as a skeleton for development of new backends and their tests. It is recommended that all backends respect naming conventions by just appending their name to the base-class names. The backend name used for the global factory object should clearly identify the given database engine, like oracle , postgresql , mysql , and so on.","title":"Backends reference"},{"location":"api/client/","text":"API Reference The core client interface is a set of classes and free functions declared in the soci.h header file. All names are dbeclared in the soci namespace. There are also additional names declared in the soci::details namespace, but they are not supposed to be directly used by the users of the library and are therefore not documented here. When such types are used in the declarations that are part of the \"public\" interface, they are replaced by \"IT\", which means \"internal type\". Types related to the backend interface are named here. Commonly used types The following types are commonly used in the rest of the interface: // data types, as seen by the user enum data_type { dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long }; // the enum type for indicator variables enum indicator { i_ok, i_null, i_truncated }; // the type used for reporting exceptions class soci_error : public std::runtime_error { /* ... */ }; The data_type type defines the basic SOCI data types. User provided data types need to be associated with one of these basic types. The indicator type defines the possible states of data. The soci_error type is used for error reporting. class session The session class encapsulates the connection to the database. class session { public: session(); explicit session(connection_parameters const & parameters); session(backend_factory const & factory, std::string const & connectString); session(std::string const & backendName, std::string const & connectString); explicit session(std::string const & connectString); explicit session(connection_pool & pool); ~session(); void open(backend_factory const & factory, std::string const & connectString); void open(std::string const & backendName, std::string const & connectString); void open(std::string const & connectString); void close(); void reconnect(); bool is_connected() const; void begin(); void commit(); void rollback(); *IT* once; *IT* prepare; template <typename T> *IT* operator<<(T const & t); bool got_data() const; bool get_next_sequence_value(std::string const & sequence, long long & value); bool get_last_insert_id(std::string const & table, long long & value); std::ostringstream & get_query_stream(); void set_log_stream(std::ostream * s); std::ostream * get_log_stream() const; std::string get_last_query() const; void uppercase_column_names(bool forceToUpper); std::string get_dummy_from_table() const; std::string get_dummy_from_clause() const; details::session_backend * get_backend(); std::string get_backend_name() const; }; This class contains the following members: Various constructors. The default one creates the session in the disconnected state. The others expect the backend factory object, or the backend name, or the URL-like composed connection string or the special parameters object containing both the backend and the connection string as well as possibly other connection options. The last constructor creates a session proxy associated with the session that is available in the given pool and releases it back to the pool when its lifetime ends. Example: session sql(postgresql, \"dbname=mydb\"); session sql(\"postgresql\", \"dbname=mydb\"); session sql(\"postgresql://dbname=mydb\"); The constructors that take backend name as string load the shared library (if not yet loaded) with name computed as libsoci_ABC.so (or libsoci_ABC.dll on Windows) where ABC is the given backend name. open , close and reconnect functions for reusing the same session object many times; the reconnect function attempts to establish the connection with the same parameters as most recently used with constructor or open . The arguments for open are treated in the same way as for constructors. is_connected can be used to check if there is an existing usable connection. begin , commit and rollback functions for transaction control. once member, which is used for performing instant queries that do not need to be separately prepared. Example: sql.once << \"drop table persons\"; prepare member, which is used for statement preparation - the result of the statement preparation must be provided to the constructor of the statement class. Example: int i; statement st = (sql.prepare << \"insert into numbers(value) values(:val)\", use(i)); operator<< that is a shortcut forwarder to the equivalent operator of the once member. Example: sql << \"drop table persons\"; got_data returns true if the last executed query had non-empty result. get_next_sequence_value returns true if the next value of the sequence with the specified name was generated and returned in its second argument. Unless you can be sure that your program will use only databases that support sequences, consider using this method in conjunction with get_last_insert_id() as explained in \"Working with sequences\" section. get_last_insert_id returns true if it could retrieve the last value automatically generated by the database for an auto-incremented field. Notice that although this method takes the table name, for some databases, such as Microsoft SQL Server and SQLite, this value is actually global, so you should attempt to retrieve it immediately after performing an insertion. get_query_stream provides direct access to the stream object that is used to accumulate the query text and exists in particular to allow the user to imbue specific locale to this stream. set_log_stream and get_log_stream functions for setting and getting the current stream object used for basic query logging. By default, it is NULL , which means no logging The string value that is actually logged into the stream is one-line verbatim copy of the query string provided by the user, without including any data from the use elements. The query is logged exactly once, before the preparation step. get_last_query retrieves the text of the last used query. uppercase_column_names allows to force all column names to uppercase in dynamic row description; this function is particularly useful for portability, since various database servers report column names differently (some preserve case, some change it). get_dummy_from_table and get_dummy_from_clause() : helpers for writing portable DML statements, see DML helpers for more details. get_backend returns the internal pointer to the concrete backend implementation of the session. This is provided for advanced users that need access to the functionality that is not otherwise available. get_backend_name is a convenience forwarder to the same function of the backend object. See connection and queries for more examples. class connection_parameters The connection_parameters class is a simple container for the backend pointer, connection string and any other connection options. It is used together with session constructor and open() method. class connection_parameters { public: connection_parameters(); connection_parameters(backend_factory const & factory, std::string const & connectString); connection_parameters(std::string const & backendName, std::string const & connectString); explicit connection_parameters(std::string const & fullConnectString); void set_option(const char * name, std::string const & value); bool get_option(const char * name, std::string & value) const; bool is_option_on(const char * name) const; }; The methods of this class are: Default constructor is rarely used as it creates an uninitialized object and the only way to initialize it later is to assign another, valid, connection_parameters object to this one. The other constructors correspond to the similar constructors of the session class and specify both the backend, either as a pointer to it or by name, and the connection string. set_option can be used to set the value of an option with the given name. Currently all option values are strings, so if you need to set a numeric option you need to convert it to a string first. If an option with the given name had been already set before, its old value is overwritten. get_option can be used to query the value of an option and returns false if there is no such option, while is_option_on simply checks if the option is specified with the value soci::option_true (which is a symbolic constant standing for the string \"1\" ). class connection_pool The connection_pool class encapsulates the thread-safe pool of connections and ensures that only one thread at a time has access to any connection that it manages. class connection_pool { public: explicit connection_pool(std::size_t size); ~connection_pool(); session & at(std::size_t pos); std::size_t lease(); bool try_lease(std::size_t & pos, int timeout); void give_back(std::size_t pos); }; The operations of the pool are: Constructor that takes the intended size of the pool. After construction, the pool contains regular session objects in disconnected state. at function that provides direct access to any given entryin the pool. This function is non-synchronized . lease function waits until some entry is available (which means that it is not used) and returns the position of that entry in the pool, marking it as locked . try_lease acts like lease , but allows to set up a time-out (relative, in milliseconds) on waiting. Negative time-out value means no time-out. Returns true if the entry was obtained, in which case its position is written to the pos parametr, and false if no entry was available before the time-out. give_back should be called when the entry on the given position is no longer in use and can be passed to other requesting thread. class transaction The class transaction can be used for associating the transaction with some code scope. It is a RAII wrapper for regular transaction operations that automatically rolls back in its destructor if the transaction was not explicitly committed before. class transaction { public: explicit transaction(session & sql); ~transaction(); void commit(); void rollback(); private: // ... }; Note that objects of this class are not notified of other transaction related operations that might be executed by user code explicitly or hidden inside SQL queries. It is not recommended to mix different ways of managing transactions. function into The function into is used for binding local output data (in other words, it defines where the results of the query are stored). template <typename T> IT into(T & t); template <typename T, typename T1> IT into(T & t, T1 p1); template <typename T> IT into(T & t, indicator & ind); template <typename T, typename T1> IT into(T & t, indicator & ind, T1 p1); template <typename T> IT into(T & t, std::vector<indicator> & ind); Example: int count; sql << \"select count(*) from person\", into(count); See Binding output data for more examples function use The function use is used for binding local input data (in other words, it defines where the parameters of the query come from). template <typename T> *IT* use(T & t); template <typename T, typename T1> *IT* use(T & t, T1 p1); template <typename T> *IT* use(T & t, indicator & ind); template <typename T, typename T1> *IT* use(T & t, indicator & ind, T1 p1); template <typename T> *IT* use(T & t, std::vector<indicator> const & ind); template <typename T, typename T1> *IT* use(T & t, std::vector<indicator> const & ind, T1 p1); Example: int val = 7; sql << \"insert into numbers(val) values(:val)\", use(val); See Binding input data for more examples. class statement The statement class encapsulates the prepared statement. class statement { public: statement(session & s); statement(*IT* const & prep); ~statement(); statement(statement const & other); void operator=(statement const & other); void alloc(); void bind(values & v); void exchange(*IT* const & i); void exchange(*IT* const & u); void clean_up(); void bind_clean_up(); void prepare(std::string const & query); void define_and_bind(); bool execute(bool withDataExchange = false); long long get_affected_rows(); bool fetch(); bool got_data() const; void describe(); void set_row(row * r); void exchange_for_rowset(*IT* const & i); details::statement_backend * get_backend(); }; This class contains the following members: Constructor accepting the session object. This can be used for later query preparation. Example: statement stmt(sql); Constructor accepting the result of using prepare on the session object, see example provided above for the session class. Copy operations. alloc function, which allocates necessary internal resources. bind function, which is used to bind the values object - this is used in the object-relational mapping and normally called automatically. exchange functions for registering the binding of local data - they expect the result of calling the into or use functions and are normally invoked automatically. clean_up function for cleaning up resources, normally called automatically. bind_clean_up function for cleaning up any bound references. It allows to keep statement in cache and reuse it later with new references by calling exchange for each new bind variable. prepare function for preparing the statement for repeated execution. define_and_bind function for actually executing the registered bindings, normally called automatically. execute function for executing the statement. If its parameter is false then there is no data exchange with locally bound variables (this form should be used if later fetch of multiple rows is foreseen). Returns true if there was at least one row of data returned. get_affected_rows function returns the number of rows affected by the last statement. Returns -1 if it's not implemented by the backend being used. fetch function for retrieving the next portion of the result. Returns true if there was new data. got_data return true if the most recent execution returned any rows. describe function for extracting the type information for the result ( Note: no data is exchanged). This is normally called automatically and only when dynamic resultset binding is used. set_row function for associating the statement and row objects, normally called automatically. exchange_for_rowset as a special case for binding rowset objects. get_backend function that returns the internal pointer to the concrete backend implementation of the statement object. This is provided for advanced users that need access to the functionality that is not otherwise available. See Statement preparation and repeated execution for example uses. Most of the functions from the statement class interface are called automatically, but can be also used explicitly. See Interfaces for the description of various way to use this interface. class procedure The procedure class encapsulates the call to the stored procedure and is aimed for higher portability of the client code. class procedure { public: procedure(*IT* const & prep); bool execute(bool withDataExchange = false); bool fetch(); bool got_data() const; }; The constructor expects the result of using prepare on the session object. See Stored procedures for examples. class type_conversion The type_conversion class is a traits class that is supposed to be provided (specialized) by the user for defining conversions to and from one of the basic SOCI types. template <typename T> struct type_conversion { typedef T base_type; static void from_base(base_type const & in, indicator ind, T & out); static void to_base(T const & in, base_type & out, indicator & ind); }; Users are supposed to properly implement the from_base and to_base functions in their specializations of this template class. See Extending SOCI to support custom (user-defined) C++ types . class row The row class encapsulates the data and type information retrieved for the single row when the dynamic rowset binding is used. class row { public: row(); ~row(); void uppercase_column_names(bool forceToUpper); std::size_t size() const; indicator get_indicator(std::size_t pos) const; indicator get_indicator(std::string const & name) const; column_properties const & get_properties (std::size_t pos) const; column_properties const & get_properties (std::string const & name) const; template <typename T> T get(std::size_t pos) const; template <typename T> T get(std::size_t pos, T const & nullValue) const; template <typename T> T get(std::string const & name) const; template <typename T> T get(std::string const & name, T const & nullValue) const; template <typename T> row const & operator>>(T & value) const; void skip(std::size_t num = 1) const; void reset_get_counter() const }; This class contains the following members: Default constructor that allows to declare a row variable. uppercase_column_names - see the same function in the session class. size function that returns the number of columns in the row. get_indicator function that returns the indicator value for the given column (column is specified by position - starting from 0 - or by name). get_properties function that returns the properties of the column given by position (starting from 0) or by name. get functions that return the value of the column given by position or name. If the column contains null, then these functions either return the provided \"default\" nullValue or throw an exception. operator>> for convenience stream-like extraction interface. Subsequent calls to this function are equivalent to calling get with increasing position parameter, starting from the beginning. skip and reset_get_counter allow to change the order of data extraction for the above operator. See Dynamic resultset binding for examples. class column_properties The column_properties class provides the type and name information about the particular column in a rowset. class column_properties { public: std::string get_name() const; data_type get_data_type() const; }; This class contains the following members: get_name function that returns the name of the column. get_data_type that returns the type of the column. See Dynamic resultset binding for examples. class values The values class encapsulates the data and type information and is used for object-relational mapping. class values { public: values(); void uppercase_column_names(bool forceToUpper); indicator get_indicator(std::size_t pos) const; indicator get_indicator(std::string const & name) const; template <typename T> T get(std::size_t pos) const; template <typename T> T get(std::size_t pos, T const & nullValue) const; template <typename T> T get(std::string const & name) const; template <typename T> T get(std::string const & name, T const & nullValue) const; template <typename T> values const & operator>>(T & value) const; void skip(std::size_t num = 1) const; void reset_get_counter() const; template <typename T> void set(std::string const & name, T const & value, indicator indic = i_ok); template <typename T> void set(const T & value, indicator indic = i_ok); template <typename T> values & operator<<(T const & value); }; This class contains the same members as the row class (with the same meaning) plus: set function for storing values in named columns or in subsequent positions. operator<< for convenience. See Object-relational mapping for examples. class blob The blob class encapsulates the \"large object\" functionality. class blob { public: explicit blob(session & s); ~blob(); std::size_t getLen(); std::size_t read(std::size_t offset, char * buf, std::size_t toRead); std::size_t write(std::size_t offset, char const * buf, std::size_t toWrite); std::size_t append(char const * buf, std::size_t toWrite); void trim(std::size_t newLen); details::blob_backend * get_backend(); }; This class contains the following members: Constructor associating the blob object with the session object. get_len function that returns the size of the BLOB object. read function that reads the BLOB data into provided buffer. write function that writes the BLOB data from provided buffer. append function that appends to the existing BLOB data. trim function that truncates the existing data to the new length. get_backend function that returns the internal pointer to the concrete backend implementation of the BLOB object. This is provided for advanced users that need access to the functionality that is not otherwise available. See Large objects (BLOBs) for more discussion. class rowid The rowid class encapsulates the \"row identifier\" object. class rowid { public: explicit rowid(Session & s); ~rowid(); details::rowid_backend * get_backend(); }; This class contains the following members: Constructor associating the rowid object with the session object. get_backend function that returns the internal pointer to the concrete backend implementation of the rowid object. class backend_factory The backend_factory class provides the abstract interface for concrete backend factories. struct backend_factory { virtual details::session_backend * make_session( std::string const & connectString) const = 0; }; The only member of this class is the make_session function that is supposed to create concrete backend implementation of the session object. Objects of this type are declared by each backend and should be provided to the constructor of the session class. In simple programs users do not need to use this class directly, but the example use is: backend_factory & factory = postgresql; std::string connectionParameters = \"dbname=mydb\"; session sql(factory, parameters); Simple Client Interface The simple client interface is provided with other languages in mind, to allow easy integration of the SOCI library with script interpreters and those languages that have the ability to link directly with object files using the \"C\" calling convention. The functionality of this interface is limited and in particular the dynamic rowset description and type conversions are not supported in this release. On the other hand, the important feature of this interface is that it does not require passing pointers to data managed by the user, because all data is handled at the SOCI side. This should make it easier to integrate SOCI with languages that have constrained ability to understand the C type system. Users of this interface need to explicitly #include <soci-simple.h> . typedef void * session_handle; session_handle soci_create_session(char const * connectionString); void soci_destroy_session(session_handle s); void soci_begin(session_handle s); void soci_commit(session_handle s); void soci_rollback(session_handle s); int soci_session_state(session_handle s); char const * soci_session_error_message(session_handle s); The functions above provide the session abstraction with the help of opaque handle. The soci_session_state function returns 1 if there was no error during the most recently executed function and 0 otherwise, in which case the soci_session_error_message can be used to obtain a human-readable error description. Note that the only function that cannot report all errors this way is soci_create_session , which returns NULL if it was not possible to create an internal object representing the session. However, if the proxy object was created, but the connection could not be established for whatever reason, the error message can be obtained in the regular way. typedef void *blob_handle; blob_handle soci_create_blob(session_handle s); void soci_destroy_blob(blob_handle b); int soci_blob_get_len(blob_handle b); int soci_blob_read(blob_handle b, int offset, char *buf, int toRead); int soci_blob_write(blob_handle b, int offset, char const *buf, int toWrite); int soci_blob_append(blob_handle b, char const *buf, int toWrite); int soci_blob_trim(blob_handle b, int newLen); int soci_blob_state(blob_handle b); char const * soci_blob_error_message(blob_handle b); The functions above provide the blob abstraction with the help of opaque handle. The soci_blob_state function returns 1 if there was no error during the most recently executed function and 0 otherwise, in which case the soci_session_error_message can be used to obtain a human-readable error description. For easy error testing, functions soci_blob_read , soci_blob_write , soci_blob_append , and soci_blob_trim return -1 in case of error and soci_session_error_message can be used to obtain a human-readable error description. Note that the only function that cannot report all errors this way is soci_create_blob , which returns NULL if it was not possible to create an internal object representing the blob. typedef void * statement_handle; statement_handle soci_create_statement(session_handle s); void soci_destroy_statement(statement_handle st); int soci_statement_state(statement_handle s); char const * soci_statement_error_message(statement_handle s); The functions above create and destroy the statement object. If the statement cannot be created by the soci_create_statement function, the error condition is set up in the related session object; for all other functions the error condition is set in the statement object itself. int soci_into_string (statement_handle st); int soci_into_int (statement_handle st); int soci_into_long_long(statement_handle st); int soci_into_double (statement_handle st); int soci_into_date (statement_handle st); int soci_into_blob (statement_handle st); int soci_into_string_v (statement_handle st); int soci_into_int_v (statement_handle st); int soci_into_long_long_v(statement_handle st); int soci_into_double_v (statement_handle st); int soci_into_date_v (statement_handle st); These functions create new data items for storing query results ( into elements ). These elements can be later identified by their position, which is counted from 0. For convenience, these function return the position of the currently added element. In case of error, -1 is returned and the error condition is set in the statement object. The _v versions create a vector into elements, which can be used to retrieve whole arrays of results. int soci_get_into_state(statement_handle st, int position); int soci_get_into_state_v(statement_handle st, int position, int index); This function returns 1 if the into element at the given position has non-null value and 0 otherwise. The _v version works with vector elements and expects an array index. char const * soci_get_into_string (statement_handle st, int position); int soci_get_into_int (statement_handle st, int position); long long soci_get_into_long_long(statement_handle st, int position); double soci_get_into_double (statement_handle st, int position); char const * soci_get_into_date (statement_handle st, int position); blob_handle soci_get_into_blob (statement_handle st, int position); char const * soci_get_into_string_v (statement_handle st, int position, int index); int soci_get_into_int_v (statement_handle st, int position, int index); long long soci_get_into_long_long_v(statement_handle st, int position, int index); double soci_get_into_double_v (statement_handle st, int position, int index); char const * soci_get_into_date_v (statement_handle st, int position, int index); The functions above allow to retrieve the current value of the given into element. Note: The date function returns the date value in the \" YYYY MM DD HH mm ss \" string format. void soci_use_string (statement_handle st, char const * name); void soci_use_int (statement_handle st, char const * name); void soci_use_long_long(statement_handle st, char const * name); void soci_use_double (statement_handle st, char const * name); void soci_use_date (statement_handle st, char const * name); void soci_use_blob (statement_handle st, char const * name); void soci_use_string_v (statement_handle st, char const * name); void soci_use_int_v (statement_handle st, char const * name); void soci_use_long_long_v(statement_handle st, char const * name); void soci_use_double_v (statement_handle st, char const * name); void soci_use_date_v (statement_handle st, char const * name); The functions above allow to create new data elements that will be used to provide data to the query ( use elements ). The new elements can be later identified by given name, which must be unique for the given statement. void soci_set_use_state(statement_handle st, char const * name, int state); The soci_set_use_state function allows to set the state of the given use element. If the state parameter is set to non-zero the use element is considered non-null (which is also the default state after creating the use element). int soci_use_get_size_v(statement_handle st); void soci_use_resize_v (statement_handle st, int new_size); These functions get and set the size of vector use elements (see comments for vector into elements above). void soci_set_use_string (statement_handle st, char const * name, char const * val); void soci_set_use_int (statement_handle st, char const * name, int val); void soci_set_use_long_long(statement_handle st, char const * name, long long val); void soci_set_use_double (statement_handle st, char const * name, double val); void soci_set_use_date (statement_handle st, char const * name, char const * val); void soci_set_use_blob (statement_handle st, char const * name, blob_handle blob); void soci_set_use_state_v (statement_handle st, char const * name, int index, int state); void soci_set_use_string_v (statement_handle st, char const * name, int index, char const * val); void soci_set_use_int_v (statement_handle st, char const * name, int index, int val); void soci_set_use_long_long_v(statement_handle st, char const * name, int index, long long val); void soci_set_use_double_v (statement_handle st, char const * name, int index, double val); void soci_set_use_date_v (statement_handle st, char const * name, int index, char const * val); The functions above set the value of the given use element, for both single and vector elements. Note: The expected format for the data values is \" YYYY MM DD HH mm ss \". int soci_get_use_state (statement_handle st, char const * name); char const * soci_get_use_string (statement_handle st, char const * name); int soci_get_use_int (statement_handle st, char const * name); long long soci_get_use_long_long(statement_handle st, char const * name); double soci_get_use_double (statement_handle st, char const * name); char const * soci_get_use_date (statement_handle st, char const * name); blob_handle soci_get_use_blob (statement_handle st, char const * name); These functions allow to inspect the state and value of named use elements. Note: these functions are provide only for single use elements, not for vectors; the rationale for this is that modifiable use elements are not supported for bulk operations. void soci_prepare(statement_handle st, char const * query); int soci_execute(statement_handle st, int withDataExchange); int soci_fetch(statement_handle st); int soci_got_data(statement_handle st); The functions above provide the core execution functionality for the statement object and their meaning is equivalent to the respective functions in the core C++ interface described above.","title":"Client API"},{"location":"api/client/#api-reference","text":"The core client interface is a set of classes and free functions declared in the soci.h header file. All names are dbeclared in the soci namespace. There are also additional names declared in the soci::details namespace, but they are not supposed to be directly used by the users of the library and are therefore not documented here. When such types are used in the declarations that are part of the \"public\" interface, they are replaced by \"IT\", which means \"internal type\". Types related to the backend interface are named here.","title":"API Reference"},{"location":"api/client/#commonly-used-types","text":"The following types are commonly used in the rest of the interface: // data types, as seen by the user enum data_type { dt_string, dt_date, dt_double, dt_integer, dt_long_long, dt_unsigned_long_long }; // the enum type for indicator variables enum indicator { i_ok, i_null, i_truncated }; // the type used for reporting exceptions class soci_error : public std::runtime_error { /* ... */ }; The data_type type defines the basic SOCI data types. User provided data types need to be associated with one of these basic types. The indicator type defines the possible states of data. The soci_error type is used for error reporting.","title":"Commonly used types"},{"location":"api/client/#class-session","text":"The session class encapsulates the connection to the database. class session { public: session(); explicit session(connection_parameters const & parameters); session(backend_factory const & factory, std::string const & connectString); session(std::string const & backendName, std::string const & connectString); explicit session(std::string const & connectString); explicit session(connection_pool & pool); ~session(); void open(backend_factory const & factory, std::string const & connectString); void open(std::string const & backendName, std::string const & connectString); void open(std::string const & connectString); void close(); void reconnect(); bool is_connected() const; void begin(); void commit(); void rollback(); *IT* once; *IT* prepare; template <typename T> *IT* operator<<(T const & t); bool got_data() const; bool get_next_sequence_value(std::string const & sequence, long long & value); bool get_last_insert_id(std::string const & table, long long & value); std::ostringstream & get_query_stream(); void set_log_stream(std::ostream * s); std::ostream * get_log_stream() const; std::string get_last_query() const; void uppercase_column_names(bool forceToUpper); std::string get_dummy_from_table() const; std::string get_dummy_from_clause() const; details::session_backend * get_backend(); std::string get_backend_name() const; }; This class contains the following members: Various constructors. The default one creates the session in the disconnected state. The others expect the backend factory object, or the backend name, or the URL-like composed connection string or the special parameters object containing both the backend and the connection string as well as possibly other connection options. The last constructor creates a session proxy associated with the session that is available in the given pool and releases it back to the pool when its lifetime ends. Example: session sql(postgresql, \"dbname=mydb\"); session sql(\"postgresql\", \"dbname=mydb\"); session sql(\"postgresql://dbname=mydb\"); The constructors that take backend name as string load the shared library (if not yet loaded) with name computed as libsoci_ABC.so (or libsoci_ABC.dll on Windows) where ABC is the given backend name. open , close and reconnect functions for reusing the same session object many times; the reconnect function attempts to establish the connection with the same parameters as most recently used with constructor or open . The arguments for open are treated in the same way as for constructors. is_connected can be used to check if there is an existing usable connection. begin , commit and rollback functions for transaction control. once member, which is used for performing instant queries that do not need to be separately prepared. Example: sql.once << \"drop table persons\"; prepare member, which is used for statement preparation - the result of the statement preparation must be provided to the constructor of the statement class. Example: int i; statement st = (sql.prepare << \"insert into numbers(value) values(:val)\", use(i)); operator<< that is a shortcut forwarder to the equivalent operator of the once member. Example: sql << \"drop table persons\"; got_data returns true if the last executed query had non-empty result. get_next_sequence_value returns true if the next value of the sequence with the specified name was generated and returned in its second argument. Unless you can be sure that your program will use only databases that support sequences, consider using this method in conjunction with get_last_insert_id() as explained in \"Working with sequences\" section. get_last_insert_id returns true if it could retrieve the last value automatically generated by the database for an auto-incremented field. Notice that although this method takes the table name, for some databases, such as Microsoft SQL Server and SQLite, this value is actually global, so you should attempt to retrieve it immediately after performing an insertion. get_query_stream provides direct access to the stream object that is used to accumulate the query text and exists in particular to allow the user to imbue specific locale to this stream. set_log_stream and get_log_stream functions for setting and getting the current stream object used for basic query logging. By default, it is NULL , which means no logging The string value that is actually logged into the stream is one-line verbatim copy of the query string provided by the user, without including any data from the use elements. The query is logged exactly once, before the preparation step. get_last_query retrieves the text of the last used query. uppercase_column_names allows to force all column names to uppercase in dynamic row description; this function is particularly useful for portability, since various database servers report column names differently (some preserve case, some change it). get_dummy_from_table and get_dummy_from_clause() : helpers for writing portable DML statements, see DML helpers for more details. get_backend returns the internal pointer to the concrete backend implementation of the session. This is provided for advanced users that need access to the functionality that is not otherwise available. get_backend_name is a convenience forwarder to the same function of the backend object. See connection and queries for more examples.","title":"class session"},{"location":"api/client/#class-connection_parameters","text":"The connection_parameters class is a simple container for the backend pointer, connection string and any other connection options. It is used together with session constructor and open() method. class connection_parameters { public: connection_parameters(); connection_parameters(backend_factory const & factory, std::string const & connectString); connection_parameters(std::string const & backendName, std::string const & connectString); explicit connection_parameters(std::string const & fullConnectString); void set_option(const char * name, std::string const & value); bool get_option(const char * name, std::string & value) const; bool is_option_on(const char * name) const; }; The methods of this class are: Default constructor is rarely used as it creates an uninitialized object and the only way to initialize it later is to assign another, valid, connection_parameters object to this one. The other constructors correspond to the similar constructors of the session class and specify both the backend, either as a pointer to it or by name, and the connection string. set_option can be used to set the value of an option with the given name. Currently all option values are strings, so if you need to set a numeric option you need to convert it to a string first. If an option with the given name had been already set before, its old value is overwritten. get_option can be used to query the value of an option and returns false if there is no such option, while is_option_on simply checks if the option is specified with the value soci::option_true (which is a symbolic constant standing for the string \"1\" ).","title":"class connection_parameters"},{"location":"api/client/#class-connection_pool","text":"The connection_pool class encapsulates the thread-safe pool of connections and ensures that only one thread at a time has access to any connection that it manages. class connection_pool { public: explicit connection_pool(std::size_t size); ~connection_pool(); session & at(std::size_t pos); std::size_t lease(); bool try_lease(std::size_t & pos, int timeout); void give_back(std::size_t pos); }; The operations of the pool are: Constructor that takes the intended size of the pool. After construction, the pool contains regular session objects in disconnected state. at function that provides direct access to any given entryin the pool. This function is non-synchronized . lease function waits until some entry is available (which means that it is not used) and returns the position of that entry in the pool, marking it as locked . try_lease acts like lease , but allows to set up a time-out (relative, in milliseconds) on waiting. Negative time-out value means no time-out. Returns true if the entry was obtained, in which case its position is written to the pos parametr, and false if no entry was available before the time-out. give_back should be called when the entry on the given position is no longer in use and can be passed to other requesting thread.","title":"class connection_pool"},{"location":"api/client/#class-transaction","text":"The class transaction can be used for associating the transaction with some code scope. It is a RAII wrapper for regular transaction operations that automatically rolls back in its destructor if the transaction was not explicitly committed before. class transaction { public: explicit transaction(session & sql); ~transaction(); void commit(); void rollback(); private: // ... }; Note that objects of this class are not notified of other transaction related operations that might be executed by user code explicitly or hidden inside SQL queries. It is not recommended to mix different ways of managing transactions.","title":"class transaction"},{"location":"api/client/#function-into","text":"The function into is used for binding local output data (in other words, it defines where the results of the query are stored). template <typename T> IT into(T & t); template <typename T, typename T1> IT into(T & t, T1 p1); template <typename T> IT into(T & t, indicator & ind); template <typename T, typename T1> IT into(T & t, indicator & ind, T1 p1); template <typename T> IT into(T & t, std::vector<indicator> & ind); Example: int count; sql << \"select count(*) from person\", into(count); See Binding output data for more examples","title":"function into"},{"location":"api/client/#function-use","text":"The function use is used for binding local input data (in other words, it defines where the parameters of the query come from). template <typename T> *IT* use(T & t); template <typename T, typename T1> *IT* use(T & t, T1 p1); template <typename T> *IT* use(T & t, indicator & ind); template <typename T, typename T1> *IT* use(T & t, indicator & ind, T1 p1); template <typename T> *IT* use(T & t, std::vector<indicator> const & ind); template <typename T, typename T1> *IT* use(T & t, std::vector<indicator> const & ind, T1 p1); Example: int val = 7; sql << \"insert into numbers(val) values(:val)\", use(val); See Binding input data for more examples.","title":"function use"},{"location":"api/client/#class-statement","text":"The statement class encapsulates the prepared statement. class statement { public: statement(session & s); statement(*IT* const & prep); ~statement(); statement(statement const & other); void operator=(statement const & other); void alloc(); void bind(values & v); void exchange(*IT* const & i); void exchange(*IT* const & u); void clean_up(); void bind_clean_up(); void prepare(std::string const & query); void define_and_bind(); bool execute(bool withDataExchange = false); long long get_affected_rows(); bool fetch(); bool got_data() const; void describe(); void set_row(row * r); void exchange_for_rowset(*IT* const & i); details::statement_backend * get_backend(); }; This class contains the following members: Constructor accepting the session object. This can be used for later query preparation. Example: statement stmt(sql); Constructor accepting the result of using prepare on the session object, see example provided above for the session class. Copy operations. alloc function, which allocates necessary internal resources. bind function, which is used to bind the values object - this is used in the object-relational mapping and normally called automatically. exchange functions for registering the binding of local data - they expect the result of calling the into or use functions and are normally invoked automatically. clean_up function for cleaning up resources, normally called automatically. bind_clean_up function for cleaning up any bound references. It allows to keep statement in cache and reuse it later with new references by calling exchange for each new bind variable. prepare function for preparing the statement for repeated execution. define_and_bind function for actually executing the registered bindings, normally called automatically. execute function for executing the statement. If its parameter is false then there is no data exchange with locally bound variables (this form should be used if later fetch of multiple rows is foreseen). Returns true if there was at least one row of data returned. get_affected_rows function returns the number of rows affected by the last statement. Returns -1 if it's not implemented by the backend being used. fetch function for retrieving the next portion of the result. Returns true if there was new data. got_data return true if the most recent execution returned any rows. describe function for extracting the type information for the result ( Note: no data is exchanged). This is normally called automatically and only when dynamic resultset binding is used. set_row function for associating the statement and row objects, normally called automatically. exchange_for_rowset as a special case for binding rowset objects. get_backend function that returns the internal pointer to the concrete backend implementation of the statement object. This is provided for advanced users that need access to the functionality that is not otherwise available. See Statement preparation and repeated execution for example uses. Most of the functions from the statement class interface are called automatically, but can be also used explicitly. See Interfaces for the description of various way to use this interface.","title":"class statement"},{"location":"api/client/#class-procedure","text":"The procedure class encapsulates the call to the stored procedure and is aimed for higher portability of the client code. class procedure { public: procedure(*IT* const & prep); bool execute(bool withDataExchange = false); bool fetch(); bool got_data() const; }; The constructor expects the result of using prepare on the session object. See Stored procedures for examples.","title":"class procedure"},{"location":"api/client/#class-type_conversion","text":"The type_conversion class is a traits class that is supposed to be provided (specialized) by the user for defining conversions to and from one of the basic SOCI types. template <typename T> struct type_conversion { typedef T base_type; static void from_base(base_type const & in, indicator ind, T & out); static void to_base(T const & in, base_type & out, indicator & ind); }; Users are supposed to properly implement the from_base and to_base functions in their specializations of this template class. See Extending SOCI to support custom (user-defined) C++ types .","title":"class type_conversion"},{"location":"api/client/#class-row","text":"The row class encapsulates the data and type information retrieved for the single row when the dynamic rowset binding is used. class row { public: row(); ~row(); void uppercase_column_names(bool forceToUpper); std::size_t size() const; indicator get_indicator(std::size_t pos) const; indicator get_indicator(std::string const & name) const; column_properties const & get_properties (std::size_t pos) const; column_properties const & get_properties (std::string const & name) const; template <typename T> T get(std::size_t pos) const; template <typename T> T get(std::size_t pos, T const & nullValue) const; template <typename T> T get(std::string const & name) const; template <typename T> T get(std::string const & name, T const & nullValue) const; template <typename T> row const & operator>>(T & value) const; void skip(std::size_t num = 1) const; void reset_get_counter() const }; This class contains the following members: Default constructor that allows to declare a row variable. uppercase_column_names - see the same function in the session class. size function that returns the number of columns in the row. get_indicator function that returns the indicator value for the given column (column is specified by position - starting from 0 - or by name). get_properties function that returns the properties of the column given by position (starting from 0) or by name. get functions that return the value of the column given by position or name. If the column contains null, then these functions either return the provided \"default\" nullValue or throw an exception. operator>> for convenience stream-like extraction interface. Subsequent calls to this function are equivalent to calling get with increasing position parameter, starting from the beginning. skip and reset_get_counter allow to change the order of data extraction for the above operator. See Dynamic resultset binding for examples.","title":"class row"},{"location":"api/client/#class-column_properties","text":"The column_properties class provides the type and name information about the particular column in a rowset. class column_properties { public: std::string get_name() const; data_type get_data_type() const; }; This class contains the following members: get_name function that returns the name of the column. get_data_type that returns the type of the column. See Dynamic resultset binding for examples.","title":"class column_properties"},{"location":"api/client/#class-values","text":"The values class encapsulates the data and type information and is used for object-relational mapping. class values { public: values(); void uppercase_column_names(bool forceToUpper); indicator get_indicator(std::size_t pos) const; indicator get_indicator(std::string const & name) const; template <typename T> T get(std::size_t pos) const; template <typename T> T get(std::size_t pos, T const & nullValue) const; template <typename T> T get(std::string const & name) const; template <typename T> T get(std::string const & name, T const & nullValue) const; template <typename T> values const & operator>>(T & value) const; void skip(std::size_t num = 1) const; void reset_get_counter() const; template <typename T> void set(std::string const & name, T const & value, indicator indic = i_ok); template <typename T> void set(const T & value, indicator indic = i_ok); template <typename T> values & operator<<(T const & value); }; This class contains the same members as the row class (with the same meaning) plus: set function for storing values in named columns or in subsequent positions. operator<< for convenience. See Object-relational mapping for examples.","title":"class values"},{"location":"api/client/#class-blob","text":"The blob class encapsulates the \"large object\" functionality. class blob { public: explicit blob(session & s); ~blob(); std::size_t getLen(); std::size_t read(std::size_t offset, char * buf, std::size_t toRead); std::size_t write(std::size_t offset, char const * buf, std::size_t toWrite); std::size_t append(char const * buf, std::size_t toWrite); void trim(std::size_t newLen); details::blob_backend * get_backend(); }; This class contains the following members: Constructor associating the blob object with the session object. get_len function that returns the size of the BLOB object. read function that reads the BLOB data into provided buffer. write function that writes the BLOB data from provided buffer. append function that appends to the existing BLOB data. trim function that truncates the existing data to the new length. get_backend function that returns the internal pointer to the concrete backend implementation of the BLOB object. This is provided for advanced users that need access to the functionality that is not otherwise available. See Large objects (BLOBs) for more discussion.","title":"class blob"},{"location":"api/client/#class-rowid","text":"The rowid class encapsulates the \"row identifier\" object. class rowid { public: explicit rowid(Session & s); ~rowid(); details::rowid_backend * get_backend(); }; This class contains the following members: Constructor associating the rowid object with the session object. get_backend function that returns the internal pointer to the concrete backend implementation of the rowid object.","title":"class rowid"},{"location":"api/client/#class-backend_factory","text":"The backend_factory class provides the abstract interface for concrete backend factories. struct backend_factory { virtual details::session_backend * make_session( std::string const & connectString) const = 0; }; The only member of this class is the make_session function that is supposed to create concrete backend implementation of the session object. Objects of this type are declared by each backend and should be provided to the constructor of the session class. In simple programs users do not need to use this class directly, but the example use is: backend_factory & factory = postgresql; std::string connectionParameters = \"dbname=mydb\"; session sql(factory, parameters);","title":"class backend_factory"},{"location":"api/client/#simple-client-interface","text":"The simple client interface is provided with other languages in mind, to allow easy integration of the SOCI library with script interpreters and those languages that have the ability to link directly with object files using the \"C\" calling convention. The functionality of this interface is limited and in particular the dynamic rowset description and type conversions are not supported in this release. On the other hand, the important feature of this interface is that it does not require passing pointers to data managed by the user, because all data is handled at the SOCI side. This should make it easier to integrate SOCI with languages that have constrained ability to understand the C type system. Users of this interface need to explicitly #include <soci-simple.h> . typedef void * session_handle; session_handle soci_create_session(char const * connectionString); void soci_destroy_session(session_handle s); void soci_begin(session_handle s); void soci_commit(session_handle s); void soci_rollback(session_handle s); int soci_session_state(session_handle s); char const * soci_session_error_message(session_handle s); The functions above provide the session abstraction with the help of opaque handle. The soci_session_state function returns 1 if there was no error during the most recently executed function and 0 otherwise, in which case the soci_session_error_message can be used to obtain a human-readable error description. Note that the only function that cannot report all errors this way is soci_create_session , which returns NULL if it was not possible to create an internal object representing the session. However, if the proxy object was created, but the connection could not be established for whatever reason, the error message can be obtained in the regular way. typedef void *blob_handle; blob_handle soci_create_blob(session_handle s); void soci_destroy_blob(blob_handle b); int soci_blob_get_len(blob_handle b); int soci_blob_read(blob_handle b, int offset, char *buf, int toRead); int soci_blob_write(blob_handle b, int offset, char const *buf, int toWrite); int soci_blob_append(blob_handle b, char const *buf, int toWrite); int soci_blob_trim(blob_handle b, int newLen); int soci_blob_state(blob_handle b); char const * soci_blob_error_message(blob_handle b); The functions above provide the blob abstraction with the help of opaque handle. The soci_blob_state function returns 1 if there was no error during the most recently executed function and 0 otherwise, in which case the soci_session_error_message can be used to obtain a human-readable error description. For easy error testing, functions soci_blob_read , soci_blob_write , soci_blob_append , and soci_blob_trim return -1 in case of error and soci_session_error_message can be used to obtain a human-readable error description. Note that the only function that cannot report all errors this way is soci_create_blob , which returns NULL if it was not possible to create an internal object representing the blob. typedef void * statement_handle; statement_handle soci_create_statement(session_handle s); void soci_destroy_statement(statement_handle st); int soci_statement_state(statement_handle s); char const * soci_statement_error_message(statement_handle s); The functions above create and destroy the statement object. If the statement cannot be created by the soci_create_statement function, the error condition is set up in the related session object; for all other functions the error condition is set in the statement object itself. int soci_into_string (statement_handle st); int soci_into_int (statement_handle st); int soci_into_long_long(statement_handle st); int soci_into_double (statement_handle st); int soci_into_date (statement_handle st); int soci_into_blob (statement_handle st); int soci_into_string_v (statement_handle st); int soci_into_int_v (statement_handle st); int soci_into_long_long_v(statement_handle st); int soci_into_double_v (statement_handle st); int soci_into_date_v (statement_handle st); These functions create new data items for storing query results ( into elements ). These elements can be later identified by their position, which is counted from 0. For convenience, these function return the position of the currently added element. In case of error, -1 is returned and the error condition is set in the statement object. The _v versions create a vector into elements, which can be used to retrieve whole arrays of results. int soci_get_into_state(statement_handle st, int position); int soci_get_into_state_v(statement_handle st, int position, int index); This function returns 1 if the into element at the given position has non-null value and 0 otherwise. The _v version works with vector elements and expects an array index. char const * soci_get_into_string (statement_handle st, int position); int soci_get_into_int (statement_handle st, int position); long long soci_get_into_long_long(statement_handle st, int position); double soci_get_into_double (statement_handle st, int position); char const * soci_get_into_date (statement_handle st, int position); blob_handle soci_get_into_blob (statement_handle st, int position); char const * soci_get_into_string_v (statement_handle st, int position, int index); int soci_get_into_int_v (statement_handle st, int position, int index); long long soci_get_into_long_long_v(statement_handle st, int position, int index); double soci_get_into_double_v (statement_handle st, int position, int index); char const * soci_get_into_date_v (statement_handle st, int position, int index); The functions above allow to retrieve the current value of the given into element. Note: The date function returns the date value in the \" YYYY MM DD HH mm ss \" string format. void soci_use_string (statement_handle st, char const * name); void soci_use_int (statement_handle st, char const * name); void soci_use_long_long(statement_handle st, char const * name); void soci_use_double (statement_handle st, char const * name); void soci_use_date (statement_handle st, char const * name); void soci_use_blob (statement_handle st, char const * name); void soci_use_string_v (statement_handle st, char const * name); void soci_use_int_v (statement_handle st, char const * name); void soci_use_long_long_v(statement_handle st, char const * name); void soci_use_double_v (statement_handle st, char const * name); void soci_use_date_v (statement_handle st, char const * name); The functions above allow to create new data elements that will be used to provide data to the query ( use elements ). The new elements can be later identified by given name, which must be unique for the given statement. void soci_set_use_state(statement_handle st, char const * name, int state); The soci_set_use_state function allows to set the state of the given use element. If the state parameter is set to non-zero the use element is considered non-null (which is also the default state after creating the use element). int soci_use_get_size_v(statement_handle st); void soci_use_resize_v (statement_handle st, int new_size); These functions get and set the size of vector use elements (see comments for vector into elements above). void soci_set_use_string (statement_handle st, char const * name, char const * val); void soci_set_use_int (statement_handle st, char const * name, int val); void soci_set_use_long_long(statement_handle st, char const * name, long long val); void soci_set_use_double (statement_handle st, char const * name, double val); void soci_set_use_date (statement_handle st, char const * name, char const * val); void soci_set_use_blob (statement_handle st, char const * name, blob_handle blob); void soci_set_use_state_v (statement_handle st, char const * name, int index, int state); void soci_set_use_string_v (statement_handle st, char const * name, int index, char const * val); void soci_set_use_int_v (statement_handle st, char const * name, int index, int val); void soci_set_use_long_long_v(statement_handle st, char const * name, int index, long long val); void soci_set_use_double_v (statement_handle st, char const * name, int index, double val); void soci_set_use_date_v (statement_handle st, char const * name, int index, char const * val); The functions above set the value of the given use element, for both single and vector elements. Note: The expected format for the data values is \" YYYY MM DD HH mm ss \". int soci_get_use_state (statement_handle st, char const * name); char const * soci_get_use_string (statement_handle st, char const * name); int soci_get_use_int (statement_handle st, char const * name); long long soci_get_use_long_long(statement_handle st, char const * name); double soci_get_use_double (statement_handle st, char const * name); char const * soci_get_use_date (statement_handle st, char const * name); blob_handle soci_get_use_blob (statement_handle st, char const * name); These functions allow to inspect the state and value of named use elements. Note: these functions are provide only for single use elements, not for vectors; the rationale for this is that modifiable use elements are not supported for bulk operations. void soci_prepare(statement_handle st, char const * query); int soci_execute(statement_handle st, int withDataExchange); int soci_fetch(statement_handle st); int soci_got_data(statement_handle st); The functions above provide the core execution functionality for the statement object and their meaning is equivalent to the respective functions in the core C++ interface described above.","title":"Simple Client Interface"},{"location":"backends/","text":"Supported Backends and Features Follow the links to learn more about each backend and detailed supported features. Oracle PostgreSQL MySQL SQLite3 Firebird ODBC DB2 Binding by Name YES YES (\u22658.0) YES YES YES YES YES Dynamic Binding YES YES YES YES YES YES Bulk Operations YES YES YES YES YES YES YES Transactions YES YES YES (\u22654.0) YES YES YES YES BLOB Data Type YES YES YES (mapped to std::string ) YES YES NO NO RowID Data Type YES YES NO NO NO NO NO Nested Statements YES NO NO NO NO NO YES Stored Procedures YES YES NO (but stored functions, YES) NO YES NO YES","title":"Features"},{"location":"backends/#supported-backends-and-features","text":"Follow the links to learn more about each backend and detailed supported features. Oracle PostgreSQL MySQL SQLite3 Firebird ODBC DB2 Binding by Name YES YES (\u22658.0) YES YES YES YES YES Dynamic Binding YES YES YES YES YES YES Bulk Operations YES YES YES YES YES YES YES Transactions YES YES YES (\u22654.0) YES YES YES YES BLOB Data Type YES YES YES (mapped to std::string ) YES YES NO NO RowID Data Type YES YES NO NO NO NO NO Nested Statements YES NO NO NO NO NO YES Stored Procedures YES YES NO (but stored functions, YES) NO YES NO YES","title":"Supported Backends and Features"},{"location":"backends/db2/","text":"DB2 Backend Reference SOCI backend for accessing IBM DB2 database. Prerequisites Supported Versions See Tested Platforms . Tested Platforms DB2 OS Compiler - Linux PPC64 GCC 9.1 Linux GCC 9.5 Linux GCC 9.7 Linux GCC 10.1 Linux GCC 10.1 Windows 8 Visual Studio 2012 10.5.0.5 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The SOCI DB2 backend requires client library from the IBM Data Server Driver Package (DS Driver) . Connecting to the Database On Unix, before using the DB2 backend please make sure, that you have sourced DB2 profile into your environment: . ~/db2inst1/sqllib/db2profile To establish a connection to the DB2 database, create a session object using the DB2 backend factory together with the database file name: soci::session sql(soci::db2, \"your DB2 connection string here\"); SOCI Feature Support Dynamic Binding TODO Bulk Operations Supported, but with caution as it hasn't been extensively tested. Transactions Currently, not supported. BLOB Data Type Currently, not supported. Nested Statements Nesting statements are not processed by SOCI in any special way and they work as implemented by the DB2 database. Stored Procedures Stored procedures are supported, with CALL statement. Native API Access TODO Backend-specific extensions None. Configuration options This backend supports db2_option_driver_complete option which can be passed to it via connection_parameters class. The value of this option is passed to SQLDriverConnect() function as \"driver completion\" parameter and so must be one of SQL_DRIVER_XXX values, in the string form. The default value of this option is SQL_DRIVER_PROMPT meaning that the driver will query the user for the user name and/or the password if they are not stored together with the connection. If this is undesirable for some reason, you can use SQL_DRIVER_NOPROMPT value for this option to suppress showing the message box: connection_parameters parameters(\"db2\", \"DSN=sample\"); parameters.set_option(db2_option_driver_complete, \"0\" /* SQL_DRIVER_NOPROMPT */); session sql(parameters); Note, db2_option_driver_complete controls driver completion specific to the IBM DB2 driver for ODBC and CLI.","title":"DB2"},{"location":"backends/db2/#db2-backend-reference","text":"SOCI backend for accessing IBM DB2 database.","title":"DB2 Backend Reference"},{"location":"backends/db2/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/db2/#supported-versions","text":"See Tested Platforms .","title":"Supported Versions"},{"location":"backends/db2/#tested-platforms","text":"DB2 OS Compiler - Linux PPC64 GCC 9.1 Linux GCC 9.5 Linux GCC 9.7 Linux GCC 10.1 Linux GCC 10.1 Windows 8 Visual Studio 2012 10.5.0.5 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/db2/#required-client-libraries","text":"The SOCI DB2 backend requires client library from the IBM Data Server Driver Package (DS Driver) .","title":"Required Client Libraries"},{"location":"backends/db2/#connecting-to-the-database","text":"On Unix, before using the DB2 backend please make sure, that you have sourced DB2 profile into your environment: . ~/db2inst1/sqllib/db2profile To establish a connection to the DB2 database, create a session object using the DB2 backend factory together with the database file name: soci::session sql(soci::db2, \"your DB2 connection string here\");","title":"Connecting to the Database"},{"location":"backends/db2/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/db2/#dynamic-binding","text":"TODO","title":"Dynamic Binding"},{"location":"backends/db2/#bulk-operations","text":"Supported, but with caution as it hasn't been extensively tested.","title":"Bulk Operations"},{"location":"backends/db2/#transactions","text":"Currently, not supported.","title":"Transactions"},{"location":"backends/db2/#blob-data-type","text":"Currently, not supported.","title":"BLOB Data Type"},{"location":"backends/db2/#nested-statements","text":"Nesting statements are not processed by SOCI in any special way and they work as implemented by the DB2 database.","title":"Nested Statements"},{"location":"backends/db2/#stored-procedures","text":"Stored procedures are supported, with CALL statement.","title":"Stored Procedures"},{"location":"backends/db2/#native-api-access","text":"TODO","title":"Native API Access"},{"location":"backends/db2/#backend-specific-extensions","text":"None.","title":"Backend-specific extensions"},{"location":"backends/db2/#configuration-options","text":"This backend supports db2_option_driver_complete option which can be passed to it via connection_parameters class. The value of this option is passed to SQLDriverConnect() function as \"driver completion\" parameter and so must be one of SQL_DRIVER_XXX values, in the string form. The default value of this option is SQL_DRIVER_PROMPT meaning that the driver will query the user for the user name and/or the password if they are not stored together with the connection. If this is undesirable for some reason, you can use SQL_DRIVER_NOPROMPT value for this option to suppress showing the message box: connection_parameters parameters(\"db2\", \"DSN=sample\"); parameters.set_option(db2_option_driver_complete, \"0\" /* SQL_DRIVER_NOPROMPT */); session sql(parameters); Note, db2_option_driver_complete controls driver completion specific to the IBM DB2 driver for ODBC and CLI.","title":"Configuration options"},{"location":"backends/firebird/","text":"Firebird Backend Reference SOCI backend for accessing Firebird database. Prerequisites Supported Versions The SOCI Firebird backend supports versions of Firebird from 1.5 to 2.5 and can be used with either the client-server or embedded Firebird libraries. The former is the default, to select the latter set SOCI_FIREBIRD_EMBEDDED CMake option to ON value when building. Tested Platforms Firebird OS Compiler 1.5.2.4731 SunOS 5.10 g++ 3.4.3 1.5.2.4731 Windows XP Visual C++ 8.0 1.5.3.4870 Windows XP Visual C++ 8.0 Professional 2.5.2.26540 Debian GNU/Linux 7 g++ 4.7.2 2.5.8.27089 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The Firebird backend requires Firebird's libfbclient client library. For example, on Ubuntu Linux, for example, firebird-dev package and its dependencies are required. Connecting to the Database To establish a connection to a Firebird database, create a Session object using the firebird backend factory together with a connection string: BackEndFactory const &backEnd = firebird; session sql(backEnd, \"service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey\"); or simply: session sql(firebird, \"service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey\"); The set of parameters used in the connection string for Firebird is: service user password role charset The following parameters have to be provided as part of the connection string : service , user , password . Role and charset parameters are optional. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from user_tables\", into(count); (See the connection and data binding documentation for general information on using the session class.) SOCI Feature Support Dynamic Binding The Firebird backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the Firebird backend, this type mapping is: Firebird Data Type SOCI Data Type row::get<T> specializations numeric, decimal (where scale > 0) dt_double double numeric, decimal [^1] (where scale = 0) dt_integer, dt_double int, double double precision, float dt_double double smallint, integer dt_integer int char, varchar dt_string std::string date, time, timestamp dt_date std::tm [^1] There is also 64bit integer type for larger values which is currently not supported. (See the dynamic resultset binding documentation for general information on using the Row class.) Binding by Name In addition to binding by position , the Firebird backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") It should be noted that parameter binding by name is supported only by means of emulation, since the underlying API used by the backend doesn't provide this feature. Bulk Operations The Firebird backend has full support for SOCI bulk operations interface. This feature is also supported by emulation. Transactions Transactions are also fully supported by the Firebird backend. In fact, an implicit transaction is always started when using this backend if one hadn't been started by explicitly calling begin() before. The current transaction is automatically committed in session destructor. BLOB Data Type The Firebird backend supports working with data stored in columns of type Blob, via SOCI BLOB class. It should by noted, that entire Blob data is fetched from database to allow random read and write access. This is because Firebird itself allows only writing to a new Blob or reading from existing one - modifications of existing Blob means creating a new one. Firebird backend hides those details from user. RowID Data Type This feature is not supported by Firebird backend. Nested Statements This feature is not supported by Firebird backend. Stored Procedures Firebird stored procedures can be executed by using SOCI Procedure class. Native API Access SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the Beyond SOCI documentation. The Firebird backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend * session::get_backend() firebird_session_backend statement_backend * statement::get_backend() firebird_statement_backend blob_backend * blob::get_backend() firebird_blob_backend rowid_backend * rowid::get_backend() Backend-specific extensions firebird_soci_error The Firebird backend can throw instances of class firebird_soci_error , which is publicly derived from soci_error and has an additional public status_ member containing the Firebird status vector.","title":"Firebird"},{"location":"backends/firebird/#firebird-backend-reference","text":"SOCI backend for accessing Firebird database.","title":"Firebird Backend Reference"},{"location":"backends/firebird/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/firebird/#supported-versions","text":"The SOCI Firebird backend supports versions of Firebird from 1.5 to 2.5 and can be used with either the client-server or embedded Firebird libraries. The former is the default, to select the latter set SOCI_FIREBIRD_EMBEDDED CMake option to ON value when building.","title":"Supported Versions"},{"location":"backends/firebird/#tested-platforms","text":"Firebird OS Compiler 1.5.2.4731 SunOS 5.10 g++ 3.4.3 1.5.2.4731 Windows XP Visual C++ 8.0 1.5.3.4870 Windows XP Visual C++ 8.0 Professional 2.5.2.26540 Debian GNU/Linux 7 g++ 4.7.2 2.5.8.27089 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/firebird/#required-client-libraries","text":"The Firebird backend requires Firebird's libfbclient client library. For example, on Ubuntu Linux, for example, firebird-dev package and its dependencies are required.","title":"Required Client Libraries"},{"location":"backends/firebird/#connecting-to-the-database","text":"To establish a connection to a Firebird database, create a Session object using the firebird backend factory together with a connection string: BackEndFactory const &backEnd = firebird; session sql(backEnd, \"service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey\"); or simply: session sql(firebird, \"service=/usr/local/firbird/db/test.fdb user=SYSDBA password=masterkey\"); The set of parameters used in the connection string for Firebird is: service user password role charset The following parameters have to be provided as part of the connection string : service , user , password . Role and charset parameters are optional. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from user_tables\", into(count); (See the connection and data binding documentation for general information on using the session class.)","title":"Connecting to the Database"},{"location":"backends/firebird/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/firebird/#dynamic-binding","text":"The Firebird backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the Firebird backend, this type mapping is: Firebird Data Type SOCI Data Type row::get<T> specializations numeric, decimal (where scale > 0) dt_double double numeric, decimal [^1] (where scale = 0) dt_integer, dt_double int, double double precision, float dt_double double smallint, integer dt_integer int char, varchar dt_string std::string date, time, timestamp dt_date std::tm [^1] There is also 64bit integer type for larger values which is currently not supported. (See the dynamic resultset binding documentation for general information on using the Row class.)","title":"Dynamic Binding"},{"location":"backends/firebird/#binding-by-name","text":"In addition to binding by position , the Firebird backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") It should be noted that parameter binding by name is supported only by means of emulation, since the underlying API used by the backend doesn't provide this feature.","title":"Binding by Name"},{"location":"backends/firebird/#bulk-operations","text":"The Firebird backend has full support for SOCI bulk operations interface. This feature is also supported by emulation.","title":"Bulk Operations"},{"location":"backends/firebird/#transactions","text":"Transactions are also fully supported by the Firebird backend. In fact, an implicit transaction is always started when using this backend if one hadn't been started by explicitly calling begin() before. The current transaction is automatically committed in session destructor.","title":"Transactions"},{"location":"backends/firebird/#blob-data-type","text":"The Firebird backend supports working with data stored in columns of type Blob, via SOCI BLOB class. It should by noted, that entire Blob data is fetched from database to allow random read and write access. This is because Firebird itself allows only writing to a new Blob or reading from existing one - modifications of existing Blob means creating a new one. Firebird backend hides those details from user.","title":"BLOB Data Type"},{"location":"backends/firebird/#rowid-data-type","text":"This feature is not supported by Firebird backend.","title":"RowID Data Type"},{"location":"backends/firebird/#nested-statements","text":"This feature is not supported by Firebird backend.","title":"Nested Statements"},{"location":"backends/firebird/#stored-procedures","text":"Firebird stored procedures can be executed by using SOCI Procedure class.","title":"Stored Procedures"},{"location":"backends/firebird/#native-api-access","text":"SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the Beyond SOCI documentation. The Firebird backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend * session::get_backend() firebird_session_backend statement_backend * statement::get_backend() firebird_statement_backend blob_backend * blob::get_backend() firebird_blob_backend rowid_backend * rowid::get_backend()","title":"Native API Access"},{"location":"backends/firebird/#backend-specific-extensions","text":"","title":"Backend-specific extensions"},{"location":"backends/firebird/#firebird_soci_error","text":"The Firebird backend can throw instances of class firebird_soci_error , which is publicly derived from soci_error and has an additional public status_ member containing the Firebird status vector.","title":"firebird_soci_error"},{"location":"backends/mysql/","text":"MySQL Backend Reference SOCI backend for accessing MySQL database. Prerequisites Supported Versions The SOCI MySQL backend should in principle work with every version of MySQL 5.x. Some of the features (transactions, stored functions) are not available when MySQL server doesn't support them. Tested Platforms MySQL OS Compiler 8.0.1 Windows 10 Visual Studio 2017 (15.3.3) 5.5.28 OS X 10.8.2 Apple LLVM version 4.2 (clang-425.0.24) 5.0.96 Ubuntu 8.04.4 LTS (Hardy Heron) g++ (GCC) 4.2.4 (Ubuntu 4.2.4-1ubuntu4) 5.7.22 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The SOCI MySQL backend requires MySQL's libmysqlclient client library from the MySQL Connector/C . Note that the SOCI library itself depends also on libdl , so the minimum set of libraries needed to compile a basic client program is: -lsoci_core -lsoci_mysql -ldl -lmysqlclient Connecting to the Database To establish a connection to a MySQL server, create a session object using the mysql backend factory together with a connection string: session sql(mysql, \"db=test user=root password='Ala ma kota'\"); // or: session sql(\"mysql\", \"db=test user=root password='Ala ma kota'\"); // or: session sql(\"mysql://db=test user=root password='Ala ma kota'\"); The set of parameters used in the connection string for MySQL is: dbname or db or service (required) user password or pass host port unix_socket sslca sslcert local_infile - should be 0 or 1 , 1 means MYSQL_OPT_LOCAL_INFILE will be set. charset reconnect - if set to 1, set MYSQL_OPT_RECONNECT to reconnect on connection loss. connect_timeout - should be positive integer value that means seconds corresponding to MYSQL_OPT_CONNECT_TIMEOUT . read_timeout - should be positive integer value that means seconds corresponding to MYSQL_OPT_READ_TIMEOUT . write_timeout - should be positive integer value that means seconds corresponding to MYSQL_OPT_WRITE_TIMEOUT . Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.) SOCI Feature Support Dynamic Binding The MySQL backend supports the use of the SOCI row class, which facilitates retrieval of data which type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the MySQL backend, this type mapping is: MySQL Data Type SOCI Data Type row::get<T> specializations FLOAT, DOUBLE, DECIMAL and synonyms dt_double double TINYINT, TINYINT UNSIGNED, SMALLINT, SMALLINT UNSIGNED, INT dt_integer int INT UNSIGNED dt_long_long long long or unsigned BIGINT dt_long_long long long BIGINT UNSIGNED dt_unsigned_long_long unsigned long long CHAR, VARCHAR, BINARY, VARBINARY, TINYBLOB, MEDIUMBLOB, BLOB,LONGBLOB, TINYTEXT, MEDIUMTEXT, TEXT, LONGTEXT, ENUM dt_string std::string TIMESTAMP (works only with MySQL >= 5.0), DATE, TIME, DATETIME dt_date std::tm (See the dynamic resultset binding documentation for general information on using the Row class.) Binding by Name In addition to binding by position , the MySQL backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") It should be noted that parameter binding of any kind is supported only by means of emulation, since the underlying API used by the backend doesn't provide this feature. Bulk Operations Transactions Transactions are also supported by the MySQL backend. Please note, however, that transactions can only be used when the MySQL server supports them (it depends on options used during the compilation of the server; typically, but not always, servers >=4.0 support transactions and earlier versions do not) and only with appropriate table types. BLOB Data Type SOCI blob interface is not supported by the MySQL backend. Note that this does not mean you cannot use MySQL's BLOB types. They can be selected using the usual SQL syntax and read into std::string on the C++ side, so no special interface is required. RowID Data Type The rowid functionality is not supported by the MySQL backend. Nested Statements Nested statements are not supported by the MySQL backend. Stored Procedures MySQL version 5.0 and later supports two kinds of stored routines: stored procedures and stored functions (for details, please consult the Defining Stored Programs ). Stored functions can be executed by using SOCI's procedure class . There is currently no support for stored procedures. Native API Access SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the Beyond SOCI documentation. The MySQL backend provides the following concrete classes for native API access: Accessor Function Concrete Class session_backend * session::get_backend() mysql_session_backend statement_backend * statement::get_backend() mysql_statement_backend Backend-specific extensions None. Configuration options None.","title":"MySQL"},{"location":"backends/mysql/#mysql-backend-reference","text":"SOCI backend for accessing MySQL database.","title":"MySQL Backend Reference"},{"location":"backends/mysql/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/mysql/#supported-versions","text":"The SOCI MySQL backend should in principle work with every version of MySQL 5.x. Some of the features (transactions, stored functions) are not available when MySQL server doesn't support them.","title":"Supported Versions"},{"location":"backends/mysql/#tested-platforms","text":"MySQL OS Compiler 8.0.1 Windows 10 Visual Studio 2017 (15.3.3) 5.5.28 OS X 10.8.2 Apple LLVM version 4.2 (clang-425.0.24) 5.0.96 Ubuntu 8.04.4 LTS (Hardy Heron) g++ (GCC) 4.2.4 (Ubuntu 4.2.4-1ubuntu4) 5.7.22 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/mysql/#required-client-libraries","text":"The SOCI MySQL backend requires MySQL's libmysqlclient client library from the MySQL Connector/C . Note that the SOCI library itself depends also on libdl , so the minimum set of libraries needed to compile a basic client program is: -lsoci_core -lsoci_mysql -ldl -lmysqlclient","title":"Required Client Libraries"},{"location":"backends/mysql/#connecting-to-the-database","text":"To establish a connection to a MySQL server, create a session object using the mysql backend factory together with a connection string: session sql(mysql, \"db=test user=root password='Ala ma kota'\"); // or: session sql(\"mysql\", \"db=test user=root password='Ala ma kota'\"); // or: session sql(\"mysql://db=test user=root password='Ala ma kota'\"); The set of parameters used in the connection string for MySQL is: dbname or db or service (required) user password or pass host port unix_socket sslca sslcert local_infile - should be 0 or 1 , 1 means MYSQL_OPT_LOCAL_INFILE will be set. charset reconnect - if set to 1, set MYSQL_OPT_RECONNECT to reconnect on connection loss. connect_timeout - should be positive integer value that means seconds corresponding to MYSQL_OPT_CONNECT_TIMEOUT . read_timeout - should be positive integer value that means seconds corresponding to MYSQL_OPT_READ_TIMEOUT . write_timeout - should be positive integer value that means seconds corresponding to MYSQL_OPT_WRITE_TIMEOUT . Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.)","title":"Connecting to the Database"},{"location":"backends/mysql/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/mysql/#dynamic-binding","text":"The MySQL backend supports the use of the SOCI row class, which facilitates retrieval of data which type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the MySQL backend, this type mapping is: MySQL Data Type SOCI Data Type row::get<T> specializations FLOAT, DOUBLE, DECIMAL and synonyms dt_double double TINYINT, TINYINT UNSIGNED, SMALLINT, SMALLINT UNSIGNED, INT dt_integer int INT UNSIGNED dt_long_long long long or unsigned BIGINT dt_long_long long long BIGINT UNSIGNED dt_unsigned_long_long unsigned long long CHAR, VARCHAR, BINARY, VARBINARY, TINYBLOB, MEDIUMBLOB, BLOB,LONGBLOB, TINYTEXT, MEDIUMTEXT, TEXT, LONGTEXT, ENUM dt_string std::string TIMESTAMP (works only with MySQL >= 5.0), DATE, TIME, DATETIME dt_date std::tm (See the dynamic resultset binding documentation for general information on using the Row class.)","title":"Dynamic Binding"},{"location":"backends/mysql/#binding-by-name","text":"In addition to binding by position , the MySQL backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") It should be noted that parameter binding of any kind is supported only by means of emulation, since the underlying API used by the backend doesn't provide this feature.","title":"Binding by Name"},{"location":"backends/mysql/#bulk-operations","text":"","title":"Bulk Operations"},{"location":"backends/mysql/#transactions","text":"Transactions are also supported by the MySQL backend. Please note, however, that transactions can only be used when the MySQL server supports them (it depends on options used during the compilation of the server; typically, but not always, servers >=4.0 support transactions and earlier versions do not) and only with appropriate table types.","title":"Transactions"},{"location":"backends/mysql/#blob-data-type","text":"SOCI blob interface is not supported by the MySQL backend. Note that this does not mean you cannot use MySQL's BLOB types. They can be selected using the usual SQL syntax and read into std::string on the C++ side, so no special interface is required.","title":"BLOB Data Type"},{"location":"backends/mysql/#rowid-data-type","text":"The rowid functionality is not supported by the MySQL backend.","title":"RowID Data Type"},{"location":"backends/mysql/#nested-statements","text":"Nested statements are not supported by the MySQL backend.","title":"Nested Statements"},{"location":"backends/mysql/#stored-procedures","text":"MySQL version 5.0 and later supports two kinds of stored routines: stored procedures and stored functions (for details, please consult the Defining Stored Programs ). Stored functions can be executed by using SOCI's procedure class . There is currently no support for stored procedures.","title":"Stored Procedures"},{"location":"backends/mysql/#native-api-access","text":"SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the Beyond SOCI documentation. The MySQL backend provides the following concrete classes for native API access: Accessor Function Concrete Class session_backend * session::get_backend() mysql_session_backend statement_backend * statement::get_backend() mysql_statement_backend","title":"Native API Access"},{"location":"backends/mysql/#backend-specific-extensions","text":"None.","title":"Backend-specific extensions"},{"location":"backends/mysql/#configuration-options","text":"None.","title":"Configuration options"},{"location":"backends/odbc/","text":"ODBC Backend Reference SOCI backend for accessing variety of databases via ODBC API. Prerequisites Supported Versions The SOCI ODBC backend is supported for use with ODBC 3. Tested Platforms ODBC OS Compiler 3 Linux (Ubuntu 12.04) g++ 4.6.3 3 Linux (Ubuntu 12.04) clang 3.2 3.8 Windows 8 Visual Studio 2012 3 Windows 7 Visual Studio 2010 3 Windows XP Visual Studio 2005 (express) 3 Windows XP Visual C++ 8.0 Professional 3 Windows XP g++ 3.3.4 (Cygwin) 3 (unixodbc 2.3.6) macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The SOCI ODBC backend requires the ODBC client library. Connecting to the Database To establish a connection to the ODBC database, create a Session object using the ODBC backend factory together with a connection string: backend_factory const&amp; backEnd = odbc; session sql(backEnd, \"filedsn=c:\\\\my.dsn\"); or simply: session sql(odbc, \"filedsn=c:\\\\my.dsn\"); The set of parameters used in the connection string for ODBC is the same as accepted by the SQLDriverConnect function from the ODBC library. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.) SOCI Feature Support Dynamic Binding The ODBC backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the ODBC backend, this type mapping is: ODBC Data Type SOCI Data Type row::get<T> specializations SQL_DOUBLE, SQL_DECIMAL, SQL_REAL, SQL_FLOAT, SQL_NUMERIC dt_double double SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT dt_integer int SQL_CHAR, SQL_VARCHAR dt_string std::string SQL_TYPE_DATE, SQL_TYPE_TIME, SQL_TYPE_TIMESTAMP dt_date std::tm Not all ODBC drivers support all datatypes. (See the dynamic resultset binding documentation for general information on using the row class.) Binding by Name In addition to binding by position , the ODBC backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") Apart from the portable \"colon-name\" syntax above, which is achieved by rewriting the query string, the backend also supports the ODBC ? syntax: int i = 7; int j = 8; sql << \"insert into t(x, y) values(?, ?)\", use(i), use(j); Bulk Operations The ODBC backend has support for SOCI's bulk operations interface. Not all ODBC drivers support bulk operations, the following is a list of some tested backends: ODBC Driver Bulk Read Bulk Insert MS SQL Server 2005 YES YES MS Access 2003 YES NO PostgresQL 8.1 YES YES MySQL 4.1 NO NO Transactions Transactions are also fully supported by the ODBC backend, provided that they are supported by the underlying database. BLOB Data Type Not currently supported. RowID Data Type Not currently supported. Nested Statements Not currently supported. Stored Procedures Not currently supported. Native API Access SOCI provides access to underlying datbabase APIs via several getBackEnd() functions, as described in the beyond SOCI documentation. The ODBC backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend* session::get_backend() odbc_session_backend statement_backend* statement::get_backend() odbc_statement_backend rowid_backend* rowid::get_backend() odbc_rowid_backend Backend-specific extensions odbc_soci_error The ODBC backend can throw instances of class odbc_soci_error , which is publicly derived from soci_error and has additional public members containing the ODBC error code, the Native database error code, and the message returned from ODBC: int main() { try { // regular code } catch (soci::odbc_soci_error const&amp; e) { cerr << \"ODBC Error Code: \" << e.odbc_error_code() << endl << \"Native Error Code: \" << e.native_error_code() << endl << \"SOCI Message: \" << e.what() << std::endl << \"ODBC Message: \" << e.odbc_error_message() << endl; } catch (exception const &amp;e) { cerr << \"Some other error: \" << e.what() << endl; } } get_connection_string() The odbc_session_backend class provides std::string get_connection_string() const method that returns fully expanded connection string as returned by the SQLDriverConnect function. Configuration options This backend supports odbc_option_driver_complete option which can be passed to it via connection_parameters class. The value of this option is passed to SQLDriverConnect() function as \"driver completion\" parameter and so must be one of SQL_DRIVER_XXX values, in the string form. The default value of this option is SQL_DRIVER_PROMPT meaning that the driver will query the user for the user name and/or the password if they are not stored together with the connection. If this is undesirable for some reason, you can use SQL_DRIVER_NOPROMPT value for this option to suppress showing the message box: connection_parameters parameters(\"odbc\", \"DSN=mydb\"); parameters.set_option(odbc_option_driver_complete, \"0\" /* SQL_DRIVER_NOPROMPT */); session sql(parameters);","title":"ODBC"},{"location":"backends/odbc/#odbc-backend-reference","text":"SOCI backend for accessing variety of databases via ODBC API.","title":"ODBC Backend Reference"},{"location":"backends/odbc/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/odbc/#supported-versions","text":"The SOCI ODBC backend is supported for use with ODBC 3.","title":"Supported Versions"},{"location":"backends/odbc/#tested-platforms","text":"ODBC OS Compiler 3 Linux (Ubuntu 12.04) g++ 4.6.3 3 Linux (Ubuntu 12.04) clang 3.2 3.8 Windows 8 Visual Studio 2012 3 Windows 7 Visual Studio 2010 3 Windows XP Visual Studio 2005 (express) 3 Windows XP Visual C++ 8.0 Professional 3 Windows XP g++ 3.3.4 (Cygwin) 3 (unixodbc 2.3.6) macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/odbc/#required-client-libraries","text":"The SOCI ODBC backend requires the ODBC client library.","title":"Required Client Libraries"},{"location":"backends/odbc/#connecting-to-the-database","text":"To establish a connection to the ODBC database, create a Session object using the ODBC backend factory together with a connection string: backend_factory const&amp; backEnd = odbc; session sql(backEnd, \"filedsn=c:\\\\my.dsn\"); or simply: session sql(odbc, \"filedsn=c:\\\\my.dsn\"); The set of parameters used in the connection string for ODBC is the same as accepted by the SQLDriverConnect function from the ODBC library. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.)","title":"Connecting to the Database"},{"location":"backends/odbc/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/odbc/#dynamic-binding","text":"The ODBC backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the ODBC backend, this type mapping is: ODBC Data Type SOCI Data Type row::get<T> specializations SQL_DOUBLE, SQL_DECIMAL, SQL_REAL, SQL_FLOAT, SQL_NUMERIC dt_double double SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT dt_integer int SQL_CHAR, SQL_VARCHAR dt_string std::string SQL_TYPE_DATE, SQL_TYPE_TIME, SQL_TYPE_TIMESTAMP dt_date std::tm Not all ODBC drivers support all datatypes. (See the dynamic resultset binding documentation for general information on using the row class.)","title":"Dynamic Binding"},{"location":"backends/odbc/#binding-by-name","text":"In addition to binding by position , the ODBC backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") Apart from the portable \"colon-name\" syntax above, which is achieved by rewriting the query string, the backend also supports the ODBC ? syntax: int i = 7; int j = 8; sql << \"insert into t(x, y) values(?, ?)\", use(i), use(j);","title":"Binding by Name"},{"location":"backends/odbc/#bulk-operations","text":"The ODBC backend has support for SOCI's bulk operations interface. Not all ODBC drivers support bulk operations, the following is a list of some tested backends: ODBC Driver Bulk Read Bulk Insert MS SQL Server 2005 YES YES MS Access 2003 YES NO PostgresQL 8.1 YES YES MySQL 4.1 NO NO","title":"Bulk Operations"},{"location":"backends/odbc/#transactions","text":"Transactions are also fully supported by the ODBC backend, provided that they are supported by the underlying database.","title":"Transactions"},{"location":"backends/odbc/#blob-data-type","text":"Not currently supported.","title":"BLOB Data Type"},{"location":"backends/odbc/#rowid-data-type","text":"Not currently supported.","title":"RowID Data Type"},{"location":"backends/odbc/#nested-statements","text":"Not currently supported.","title":"Nested Statements"},{"location":"backends/odbc/#stored-procedures","text":"Not currently supported.","title":"Stored Procedures"},{"location":"backends/odbc/#native-api-access","text":"SOCI provides access to underlying datbabase APIs via several getBackEnd() functions, as described in the beyond SOCI documentation. The ODBC backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend* session::get_backend() odbc_session_backend statement_backend* statement::get_backend() odbc_statement_backend rowid_backend* rowid::get_backend() odbc_rowid_backend","title":"Native API Access"},{"location":"backends/odbc/#backend-specific-extensions","text":"","title":"Backend-specific extensions"},{"location":"backends/odbc/#odbc_soci_error","text":"The ODBC backend can throw instances of class odbc_soci_error , which is publicly derived from soci_error and has additional public members containing the ODBC error code, the Native database error code, and the message returned from ODBC: int main() { try { // regular code } catch (soci::odbc_soci_error const&amp; e) { cerr << \"ODBC Error Code: \" << e.odbc_error_code() << endl << \"Native Error Code: \" << e.native_error_code() << endl << \"SOCI Message: \" << e.what() << std::endl << \"ODBC Message: \" << e.odbc_error_message() << endl; } catch (exception const &amp;e) { cerr << \"Some other error: \" << e.what() << endl; } }","title":"odbc_soci_error"},{"location":"backends/odbc/#get_connection_string","text":"The odbc_session_backend class provides std::string get_connection_string() const method that returns fully expanded connection string as returned by the SQLDriverConnect function.","title":"get_connection_string()"},{"location":"backends/odbc/#configuration-options","text":"This backend supports odbc_option_driver_complete option which can be passed to it via connection_parameters class. The value of this option is passed to SQLDriverConnect() function as \"driver completion\" parameter and so must be one of SQL_DRIVER_XXX values, in the string form. The default value of this option is SQL_DRIVER_PROMPT meaning that the driver will query the user for the user name and/or the password if they are not stored together with the connection. If this is undesirable for some reason, you can use SQL_DRIVER_NOPROMPT value for this option to suppress showing the message box: connection_parameters parameters(\"odbc\", \"DSN=mydb\"); parameters.set_option(odbc_option_driver_complete, \"0\" /* SQL_DRIVER_NOPROMPT */); session sql(parameters);","title":"Configuration options"},{"location":"backends/oracle/","text":"Oracle Backend Reference SOCI backend for accessing Oracle database. Prerequisites Supported Versions The SOCI Oracle backend is currently supported for use with Oracle 10 or later. Older versions of Oracle may work as well, but they have not been tested by the SOCI team. Tested Platforms Oracle OS Compiler 10.2.0 (XE) RedHat 5 g++ 4.3 11.2.0 (XE) Ubuntu 12.04 g++ 4.6.3 12.2.0.1 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The SOCI Oracle backend requires Oracle's libclntsh client library. Depending on the particular system, the libnnz10 library might be needed as well. Note that the SOCI library itself depends also on libdl , so the minimum set of libraries needed to compile a basic client program is: -lsoci_core -lsoci_oracle -ldl -lclntsh -lnnz10 Connecting to the Database To establish a connection to an Oracle database, create a session object using the oracle backend factory together with a connection string: session sql(oracle, \"service=orcl user=scott password=tiger\"); // or: session sql(\"oracle\", \"service=orcl user=scott password=tiger\"); // or: session sql(\"oracle://service=orcl user=scott password=tiger\"); // or: session sql(oracle, \"service=//your_host:1521/your_sid user=scott password=tiger\"); The set of parameters used in the connection string for Oracle is: service user password mode (optional; valid values are sysdba , sysoper and default ) charset and ncharset (optional; valid values are utf8 , utf16 , we8mswin1252 and win1252 ) If both user and password are provided, the session will authenticate using the database credentials, whereas if none of them is set, then external Oracle credentials will be used - this allows integration with so called Oracle wallet authentication. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from user_tables\", into(count); (See the connection and data binding documentation for general information on using the session class.) SOCI Feature Support Dynamic Binding The Oracle backend supports the use of the SOCI row class, which facilitates retrieval of data which type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the Oracle backend, this type mapping is: Oracle Data Type SOCI Data Type row::get<T> specializations number (where scale > 0) dt_double double number(where scale = 0 and precision \u2264 std::numeric_limits<int>::digits10 ) dt_integer int number dt_long_long long long char, varchar, varchar2 dt_string std::string date dt_date std::tm (See the dynamic resultset binding documentation for general information on using the row class.) Binding by Name In addition to binding by position , the Oracle backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") SOCI's use of ':' to indicate a value to be bound within a SQL string is consistent with the underlying Oracle client library syntax. Bulk Operations The Oracle backend has full support for SOCI's bulk operations interface. Transactions Transactions are also fully supported by the Oracle backend, although transactions with non-default isolation levels have to be managed by explicit SQL statements. blob Data Type The Oracle backend supports working with data stored in columns of type Blob, via SOCI's blob class. rowid Data Type Oracle rowid's are accessible via SOCI's rowid class. Nested Statements The Oracle backend supports selecting into objects of type statement , so that you may work with nested sql statements and PL/SQL cursors: statement stInner(sql); statement stOuter = (sql.prepare << \"select cursor(select name from person order by id)\" \" from person where id = 1\", into(stInner)); stInner.exchange(into(name)); stOuter.execute(); stOuter.fetch(); while (stInner.fetch()) { std::cout << name << '\\n'; } Stored Procedures Oracle stored procedures can be executed by using SOCI's procedure class. Native API Access SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the Beyond SOCI documentation. The Oracle backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend * session::get_backend() oracle_session_backend statement_backend * statement::get_backend() oracle_statement_backend blob_backend * blob::get_backend() oracle_blob_backend rowid_backend * rowid::get_backend() oracle_rowid_backend Backend-specific extensions oracle_soci_error The Oracle backend can throw instances of class oracle_soci_error , which is publicly derived from soci_error and has an additional public err_num_ member containing the Oracle error code: int main() { try { // regular code } catch (oracle_soci_error const & e) { cerr << \"Oracle error: \" << e.err_num_ << \" \" << e.what() << endl; } catch (exception const & e) { cerr << \"Some other error: \"<< e.what() << endl; } }","title":"Oracle"},{"location":"backends/oracle/#oracle-backend-reference","text":"SOCI backend for accessing Oracle database.","title":"Oracle Backend Reference"},{"location":"backends/oracle/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/oracle/#supported-versions","text":"The SOCI Oracle backend is currently supported for use with Oracle 10 or later. Older versions of Oracle may work as well, but they have not been tested by the SOCI team.","title":"Supported Versions"},{"location":"backends/oracle/#tested-platforms","text":"Oracle OS Compiler 10.2.0 (XE) RedHat 5 g++ 4.3 11.2.0 (XE) Ubuntu 12.04 g++ 4.6.3 12.2.0.1 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/oracle/#required-client-libraries","text":"The SOCI Oracle backend requires Oracle's libclntsh client library. Depending on the particular system, the libnnz10 library might be needed as well. Note that the SOCI library itself depends also on libdl , so the minimum set of libraries needed to compile a basic client program is: -lsoci_core -lsoci_oracle -ldl -lclntsh -lnnz10","title":"Required Client Libraries"},{"location":"backends/oracle/#connecting-to-the-database","text":"To establish a connection to an Oracle database, create a session object using the oracle backend factory together with a connection string: session sql(oracle, \"service=orcl user=scott password=tiger\"); // or: session sql(\"oracle\", \"service=orcl user=scott password=tiger\"); // or: session sql(\"oracle://service=orcl user=scott password=tiger\"); // or: session sql(oracle, \"service=//your_host:1521/your_sid user=scott password=tiger\"); The set of parameters used in the connection string for Oracle is: service user password mode (optional; valid values are sysdba , sysoper and default ) charset and ncharset (optional; valid values are utf8 , utf16 , we8mswin1252 and win1252 ) If both user and password are provided, the session will authenticate using the database credentials, whereas if none of them is set, then external Oracle credentials will be used - this allows integration with so called Oracle wallet authentication. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from user_tables\", into(count); (See the connection and data binding documentation for general information on using the session class.)","title":"Connecting to the Database"},{"location":"backends/oracle/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/oracle/#dynamic-binding","text":"The Oracle backend supports the use of the SOCI row class, which facilitates retrieval of data which type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the Oracle backend, this type mapping is: Oracle Data Type SOCI Data Type row::get<T> specializations number (where scale > 0) dt_double double number(where scale = 0 and precision \u2264 std::numeric_limits<int>::digits10 ) dt_integer int number dt_long_long long long char, varchar, varchar2 dt_string std::string date dt_date std::tm (See the dynamic resultset binding documentation for general information on using the row class.)","title":"Dynamic Binding"},{"location":"backends/oracle/#binding-by-name","text":"In addition to binding by position , the Oracle backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") SOCI's use of ':' to indicate a value to be bound within a SQL string is consistent with the underlying Oracle client library syntax.","title":"Binding by Name"},{"location":"backends/oracle/#bulk-operations","text":"The Oracle backend has full support for SOCI's bulk operations interface.","title":"Bulk Operations"},{"location":"backends/oracle/#transactions","text":"Transactions are also fully supported by the Oracle backend, although transactions with non-default isolation levels have to be managed by explicit SQL statements.","title":"Transactions"},{"location":"backends/oracle/#blob-data-type","text":"The Oracle backend supports working with data stored in columns of type Blob, via SOCI's blob class.","title":"blob Data Type"},{"location":"backends/oracle/#rowid-data-type","text":"Oracle rowid's are accessible via SOCI's rowid class.","title":"rowid Data Type"},{"location":"backends/oracle/#nested-statements","text":"The Oracle backend supports selecting into objects of type statement , so that you may work with nested sql statements and PL/SQL cursors: statement stInner(sql); statement stOuter = (sql.prepare << \"select cursor(select name from person order by id)\" \" from person where id = 1\", into(stInner)); stInner.exchange(into(name)); stOuter.execute(); stOuter.fetch(); while (stInner.fetch()) { std::cout << name << '\\n'; }","title":"Nested Statements"},{"location":"backends/oracle/#stored-procedures","text":"Oracle stored procedures can be executed by using SOCI's procedure class.","title":"Stored Procedures"},{"location":"backends/oracle/#native-api-access","text":"SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the Beyond SOCI documentation. The Oracle backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend * session::get_backend() oracle_session_backend statement_backend * statement::get_backend() oracle_statement_backend blob_backend * blob::get_backend() oracle_blob_backend rowid_backend * rowid::get_backend() oracle_rowid_backend","title":"Native API Access"},{"location":"backends/oracle/#backend-specific-extensions","text":"","title":"Backend-specific extensions"},{"location":"backends/oracle/#oracle_soci_error","text":"The Oracle backend can throw instances of class oracle_soci_error , which is publicly derived from soci_error and has an additional public err_num_ member containing the Oracle error code: int main() { try { // regular code } catch (oracle_soci_error const & e) { cerr << \"Oracle error: \" << e.err_num_ << \" \" << e.what() << endl; } catch (exception const & e) { cerr << \"Some other error: \"<< e.what() << endl; } }","title":"oracle_soci_error"},{"location":"backends/postgresql/","text":"PostgreSQL Backend Reference SOCI backend for accessing PostgreSQL database. Prerequisites Supported Versions The SOCI PostgreSQL backend is supported for use with PostgreSQL >= 7.3, although versions older than 8.0 will suffer from limited feature support. See below for details. Tested Platforms PostgreSQL OS Compiler 9.6 Windows Server 2016 MSVC++ 14.1 9.4 Windows Server 2012 R2 MSVC++ 14.0 9.4 Windows Server 2012 R2 MSVC++ 12.0 9.4 Windows Server 2012 R2 MSVC++ 11.0 9.4 Windows Server 2012 R2 Mingw-w64/GCC 4.8 9.3 Ubuntu 12.04 g++ 4.6.3 9.0 Mac OS X 10.6.6 g++ 4.2 8.4 FreeBSD 8.2 g++ 4.1 8.4 Debian 6 g++ 4.3 8.4 RedHat 5 g++ 4.3 10.03 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The SOCI PostgreSQL backend requires PostgreSQL's libpq client library. Note that the SOCI library itself depends also on libdl , so the minimum set of libraries needed to compile a basic client program is: -lsoci_core -lsoci_postgresql -ldl -lpq Connecting to the Database To establish a connection to the PostgreSQL database, create a session object using the postgresql backend factory together with a connection string: session sql(postgresql, \"dbname=mydatabase\"); // or: session sql(\"postgresql\", \"dbname=mydatabase\"); // or: session sql(\"postgresql://dbname=mydatabase\"); The set of parameters used in the connection string for PostgreSQL is the same as accepted by the PQconnectdb function from the libpq library. In addition to standard PostgreSQL connection parameters, the following can be set: singlerow or singlerows For example: session sql(postgresql, \"dbname=mydatabase singlerows=true\"); If the singlerows parameter is set to true or yes , then queries will be executed in the single-row mode, which prevents the client library from loading full query result set into memory and instead fetches rows one by one, as they are requested by the statement's fetch() function. This mode can be of interest to those users who want to make their client applications more responsive (with more fine-grained operation) by avoiding potentially long blocking times when complete query results are loaded to client's memory. Note that in the single-row operation: bulk queries are not supported, and in order to fulfill the expectations of the underlying client library, the complete rowset has to be exhausted before executing further queries on the same session. Also please note that single rows mode requires PostgreSQL 9 or later, both at compile- and run-time. If you need to support earlier versions of PostgreSQL, you can define SOCI_POSTGRESQL_NOSINGLEROWMODE when building the library to disable it. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.) SOCI Feature Support Dynamic Binding The PostgreSQL backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the PostgreSQL backend, this type mapping is: PostgreSQL Data Type SOCI Data Type row::get<T> specializations numeric, real, double dt_double double boolean, smallint, integer dt_integer int int8 dt_long_long long long oid dt_integer unsigned long char, varchar, text, cstring, bpchar dt_string std::string abstime, reltime, date, time, timestamp, timestamptz, timetz dt_date std::tm (See the dynamic resultset binding documentation for general information on using the row class.) Binding by Name In addition to binding by position , the PostgreSQL backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") Bulk Operations The PostgreSQL backend has full support for SOCI's bulk operations interface. Transactions Transactions are also fully supported by the PostgreSQL backend. blob Data Type The PostgreSQL backend supports working with data stored in columns of type Blob, via SOCI's blob class with the exception that trimming is not supported. rowid Data Type The concept of row identifier (OID in PostgreSQL) is supported via SOCI's rowid class. Nested Statements Nested statements are not supported by PostgreSQL backend. Stored Procedures PostgreSQL stored procedures can be executed by using SOCI's procedure class. Native API Access SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the beyond SOCI documentation. The PostgreSQL backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend * session::get_backend() postgresql_session_backend statement_backend * statement::get_backend() postgresql_statement_backend blob_backend * blob::get_backend() postgresql_blob_backend rowid_backend * rowid::get_backend() postgresql_rowid_backend Backend-specific extensions uuid Data Type The PostgreSQL backend supports working with data stored in columns of type UUID via simple string operations. All string representations of UUID supported by PostgreSQL are accepted on input, the backend will return the standard format of UUID on output. See the test test_uuid_column_type_support for usage examples. Configuration options To support older PostgreSQL versions, the following configuration macros are recognized: SOCI_POSTGRESQL_NOSINLGEROWMODE - disable single mode retrieving query results row-by-row. It is necessary for PostgreSQL prior to version 9.","title":"PostgreSQL"},{"location":"backends/postgresql/#postgresql-backend-reference","text":"SOCI backend for accessing PostgreSQL database.","title":"PostgreSQL Backend Reference"},{"location":"backends/postgresql/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/postgresql/#supported-versions","text":"The SOCI PostgreSQL backend is supported for use with PostgreSQL >= 7.3, although versions older than 8.0 will suffer from limited feature support. See below for details.","title":"Supported Versions"},{"location":"backends/postgresql/#tested-platforms","text":"PostgreSQL OS Compiler 9.6 Windows Server 2016 MSVC++ 14.1 9.4 Windows Server 2012 R2 MSVC++ 14.0 9.4 Windows Server 2012 R2 MSVC++ 12.0 9.4 Windows Server 2012 R2 MSVC++ 11.0 9.4 Windows Server 2012 R2 Mingw-w64/GCC 4.8 9.3 Ubuntu 12.04 g++ 4.6.3 9.0 Mac OS X 10.6.6 g++ 4.2 8.4 FreeBSD 8.2 g++ 4.1 8.4 Debian 6 g++ 4.3 8.4 RedHat 5 g++ 4.3 10.03 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/postgresql/#required-client-libraries","text":"The SOCI PostgreSQL backend requires PostgreSQL's libpq client library. Note that the SOCI library itself depends also on libdl , so the minimum set of libraries needed to compile a basic client program is: -lsoci_core -lsoci_postgresql -ldl -lpq","title":"Required Client Libraries"},{"location":"backends/postgresql/#connecting-to-the-database","text":"To establish a connection to the PostgreSQL database, create a session object using the postgresql backend factory together with a connection string: session sql(postgresql, \"dbname=mydatabase\"); // or: session sql(\"postgresql\", \"dbname=mydatabase\"); // or: session sql(\"postgresql://dbname=mydatabase\"); The set of parameters used in the connection string for PostgreSQL is the same as accepted by the PQconnectdb function from the libpq library. In addition to standard PostgreSQL connection parameters, the following can be set: singlerow or singlerows For example: session sql(postgresql, \"dbname=mydatabase singlerows=true\"); If the singlerows parameter is set to true or yes , then queries will be executed in the single-row mode, which prevents the client library from loading full query result set into memory and instead fetches rows one by one, as they are requested by the statement's fetch() function. This mode can be of interest to those users who want to make their client applications more responsive (with more fine-grained operation) by avoiding potentially long blocking times when complete query results are loaded to client's memory. Note that in the single-row operation: bulk queries are not supported, and in order to fulfill the expectations of the underlying client library, the complete rowset has to be exhausted before executing further queries on the same session. Also please note that single rows mode requires PostgreSQL 9 or later, both at compile- and run-time. If you need to support earlier versions of PostgreSQL, you can define SOCI_POSTGRESQL_NOSINGLEROWMODE when building the library to disable it. Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.)","title":"Connecting to the Database"},{"location":"backends/postgresql/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/postgresql/#dynamic-binding","text":"The PostgreSQL backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the PostgreSQL backend, this type mapping is: PostgreSQL Data Type SOCI Data Type row::get<T> specializations numeric, real, double dt_double double boolean, smallint, integer dt_integer int int8 dt_long_long long long oid dt_integer unsigned long char, varchar, text, cstring, bpchar dt_string std::string abstime, reltime, date, time, timestamp, timestamptz, timetz dt_date std::tm (See the dynamic resultset binding documentation for general information on using the row class.)","title":"Dynamic Binding"},{"location":"backends/postgresql/#binding-by-name","text":"In addition to binding by position , the PostgreSQL backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\")","title":"Binding by Name"},{"location":"backends/postgresql/#bulk-operations","text":"The PostgreSQL backend has full support for SOCI's bulk operations interface.","title":"Bulk Operations"},{"location":"backends/postgresql/#transactions","text":"Transactions are also fully supported by the PostgreSQL backend.","title":"Transactions"},{"location":"backends/postgresql/#blob-data-type","text":"The PostgreSQL backend supports working with data stored in columns of type Blob, via SOCI's blob class with the exception that trimming is not supported.","title":"blob Data Type"},{"location":"backends/postgresql/#rowid-data-type","text":"The concept of row identifier (OID in PostgreSQL) is supported via SOCI's rowid class.","title":"rowid Data Type"},{"location":"backends/postgresql/#nested-statements","text":"Nested statements are not supported by PostgreSQL backend.","title":"Nested Statements"},{"location":"backends/postgresql/#stored-procedures","text":"PostgreSQL stored procedures can be executed by using SOCI's procedure class.","title":"Stored Procedures"},{"location":"backends/postgresql/#native-api-access","text":"SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the beyond SOCI documentation. The PostgreSQL backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend * session::get_backend() postgresql_session_backend statement_backend * statement::get_backend() postgresql_statement_backend blob_backend * blob::get_backend() postgresql_blob_backend rowid_backend * rowid::get_backend() postgresql_rowid_backend","title":"Native API Access"},{"location":"backends/postgresql/#backend-specific-extensions","text":"","title":"Backend-specific extensions"},{"location":"backends/postgresql/#uuid-data-type","text":"The PostgreSQL backend supports working with data stored in columns of type UUID via simple string operations. All string representations of UUID supported by PostgreSQL are accepted on input, the backend will return the standard format of UUID on output. See the test test_uuid_column_type_support for usage examples.","title":"uuid Data Type"},{"location":"backends/postgresql/#configuration-options","text":"To support older PostgreSQL versions, the following configuration macros are recognized: SOCI_POSTGRESQL_NOSINLGEROWMODE - disable single mode retrieving query results row-by-row. It is necessary for PostgreSQL prior to version 9.","title":"Configuration options"},{"location":"backends/sqlite3/","text":"SQLite3 Backend Reference SOCI backend for accessing SQLite 3 database. Prerequisites Supported Versions The SOCI SQLite3 backend is supported for use with SQLite3 >= 3.1 Tested Platforms SQLite3 OS Compiler 3.12.1 Windows Server 2016 MSVC++ 14.1 3.12.1 Windows Server 2012 R2 MSVC++ 14.0 3.12.1 Windows Server 2012 R2 MSVC++ 12.0 3.12.1 Windows Server 2012 R2 MSVC++ 11.0 3.12.1 Windows Server 2012 R2 Mingw-w64/GCC 4.8 3.7.9 Ubuntu 12.04 g++ 4.6.3 3.4.0 Windows XP (cygwin) g++ 3.4.4 3.4.0 Windows XP Visual C++ 2005 Express Edition 3.3.8 Windows XP Visual C++ 2005 Professional 3.5.2 Mac OS X 10.5 g++ 4.0.1 3.3.4 Ubuntu 5.1 g++ 4.0.2 3.3.4 Windows XP (cygwin) g++ 3.3.4 3.3.4 Windows XP Visual C++ 2005 Express Edition 3.2.1 Linux i686 2.6.10-gentoo-r6 g++ 3.4.5 3.1.3 Mac OS X 10.4 g++ 4.0.1 3.24.0 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039 Required Client Libraries The SOCI SQLite3 backend requires SQLite3's libsqlite3 client library. Connecting to the Database To establish a connection to the SQLite3 database, create a Session object using the SQLite3 backend factory together with the database file name: session sql(sqlite3, \"database_filename\"); // or: session sql(\"sqlite3\", \"db=db.sqlite timeout=2 shared_cache=true\"); The set of parameters used in the connection string for SQLite is: dbname or db timeout - set sqlite busy timeout (in seconds) ( link ) readonly - open database in read-only mode instead of the default read-write (note that the database file must already exist in this case, see the documentation ) synchronous - set the pragma synchronous flag ( link ) shared_cache - should be true ( link ) vfs - set the SQLite VFS used to as OS interface. The VFS should be registered before opening the connection, see the documenation Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.) SOCI Feature Support Dynamic Binding The SQLite3 backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the SQLite3 backend, this type mapping is complicated by the fact the SQLite3 does not enforce [types][INTEGER_PRIMARY_KEY] and makes no attempt to validate the type names used in table creation or alteration statements. SQLite3 will return the type as a string, SOCI will recognize the following strings and match them the corresponding SOCI types: SQLite3 Data Type SOCI Data Type row::get<T> specializations float , double dt_double double int8 , bigint dt_long_long long long unsigned big int dt_unsigned_long_long unsigned long long int , boolean dt_integer int text, char* dt_string std::string date , time dt_date std::tm [INTEGER_PRIMARY_KEY] : There is one case where SQLite3 enforces type. If a column is declared as \"integer primary key\", then SQLite3 uses that as an alias to the internal ROWID column that exists for every table. Only integers are allowed in this column. (See the dynamic resultset binding documentation for general information on using the row class.) Binding by Name In addition to binding by position , the SQLite3 backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") The backend also supports the SQLite3 native numbered syntax, \"one or more literals can be replace by a parameter \"?\" or \":AAA\" or \"@AAA\" or \"$VVV\" where AAA is an alphanumeric identifier and VVV is a variable name according to the syntax rules of the TCL programming language.\" [1] : int i = 7; int j = 8; sql << \"insert into t(x, y) values(?, ?)\", use(i), use(j); Bulk Operations The SQLite3 backend has full support for SOCI's bulk operations interface. However, this support is emulated and is not native. Transactions Transactions are also fully supported by the SQLite3 backend. BLOB Data Type The SQLite3 backend supports working with data stored in columns of type Blob, via SOCI's BLOB class. Because of SQLite3 general typelessness the column does not have to be declared any particular type. RowID Data Type In SQLite3 RowID is an integer. \"Each entry in an SQLite table has a unique integer key called the \"rowid\". The rowid is always available as an undeclared column named ROWID, OID, or ROWID . If the table has a column of type INTEGER PRIMARY KEY then that column is another an alias for the rowid.\" [2] Nested Statements Nested statements are not supported by SQLite3 backend. Stored Procedures Stored procedures are not supported by SQLite3 backend Native API Access SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the beyond SOCI documentation. The SQLite3 backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend* session::get_backend() sqlie3_session_backend statement_backend* statement::get_backend() sqlite3_statement_backend rowid_backend* rowid::get_backend() sqlite3_rowid_backend Backend-specific extensions SQLite3 result code support SQLite3 result code is provided via the backend specific sqlite3_soci_error class. Catching the backend specific error yields the value of SQLite3 result code via the result() method. Configuration options None","title":"SQLite3"},{"location":"backends/sqlite3/#sqlite3-backend-reference","text":"SOCI backend for accessing SQLite 3 database.","title":"SQLite3 Backend Reference"},{"location":"backends/sqlite3/#prerequisites","text":"","title":"Prerequisites"},{"location":"backends/sqlite3/#supported-versions","text":"The SOCI SQLite3 backend is supported for use with SQLite3 >= 3.1","title":"Supported Versions"},{"location":"backends/sqlite3/#tested-platforms","text":"SQLite3 OS Compiler 3.12.1 Windows Server 2016 MSVC++ 14.1 3.12.1 Windows Server 2012 R2 MSVC++ 14.0 3.12.1 Windows Server 2012 R2 MSVC++ 12.0 3.12.1 Windows Server 2012 R2 MSVC++ 11.0 3.12.1 Windows Server 2012 R2 Mingw-w64/GCC 4.8 3.7.9 Ubuntu 12.04 g++ 4.6.3 3.4.0 Windows XP (cygwin) g++ 3.4.4 3.4.0 Windows XP Visual C++ 2005 Express Edition 3.3.8 Windows XP Visual C++ 2005 Professional 3.5.2 Mac OS X 10.5 g++ 4.0.1 3.3.4 Ubuntu 5.1 g++ 4.0.2 3.3.4 Windows XP (cygwin) g++ 3.3.4 3.3.4 Windows XP Visual C++ 2005 Express Edition 3.2.1 Linux i686 2.6.10-gentoo-r6 g++ 3.4.5 3.1.3 Mac OS X 10.4 g++ 4.0.1 3.24.0 macOS High Sierra 10.13.5 AppleClang 9.1.0.9020039","title":"Tested Platforms"},{"location":"backends/sqlite3/#required-client-libraries","text":"The SOCI SQLite3 backend requires SQLite3's libsqlite3 client library.","title":"Required Client Libraries"},{"location":"backends/sqlite3/#connecting-to-the-database","text":"To establish a connection to the SQLite3 database, create a Session object using the SQLite3 backend factory together with the database file name: session sql(sqlite3, \"database_filename\"); // or: session sql(\"sqlite3\", \"db=db.sqlite timeout=2 shared_cache=true\"); The set of parameters used in the connection string for SQLite is: dbname or db timeout - set sqlite busy timeout (in seconds) ( link ) readonly - open database in read-only mode instead of the default read-write (note that the database file must already exist in this case, see the documentation ) synchronous - set the pragma synchronous flag ( link ) shared_cache - should be true ( link ) vfs - set the SQLite VFS used to as OS interface. The VFS should be registered before opening the connection, see the documenation Once you have created a session object as shown above, you can use it to access the database, for example: int count; sql << \"select count(*) from invoices\", into(count); (See the connection and data binding documentation for general information on using the session class.)","title":"Connecting to the Database"},{"location":"backends/sqlite3/#soci-feature-support","text":"","title":"SOCI Feature Support"},{"location":"backends/sqlite3/#dynamic-binding","text":"The SQLite3 backend supports the use of the SOCI row class, which facilitates retrieval of data whose type is not known at compile time. When calling row::get<T>() , the type you should pass as T depends upon the underlying database type. For the SQLite3 backend, this type mapping is complicated by the fact the SQLite3 does not enforce [types][INTEGER_PRIMARY_KEY] and makes no attempt to validate the type names used in table creation or alteration statements. SQLite3 will return the type as a string, SOCI will recognize the following strings and match them the corresponding SOCI types: SQLite3 Data Type SOCI Data Type row::get<T> specializations float , double dt_double double int8 , bigint dt_long_long long long unsigned big int dt_unsigned_long_long unsigned long long int , boolean dt_integer int text, char* dt_string std::string date , time dt_date std::tm [INTEGER_PRIMARY_KEY] : There is one case where SQLite3 enforces type. If a column is declared as \"integer primary key\", then SQLite3 uses that as an alias to the internal ROWID column that exists for every table. Only integers are allowed in this column. (See the dynamic resultset binding documentation for general information on using the row class.)","title":"Dynamic Binding"},{"location":"backends/sqlite3/#binding-by-name","text":"In addition to binding by position , the SQLite3 backend supports binding by name , via an overload of the use() function: int id = 7; sql << \"select name from person where id = :id\", use(id, \"id\") The backend also supports the SQLite3 native numbered syntax, \"one or more literals can be replace by a parameter \"?\" or \":AAA\" or \"@AAA\" or \"$VVV\" where AAA is an alphanumeric identifier and VVV is a variable name according to the syntax rules of the TCL programming language.\" [1] : int i = 7; int j = 8; sql << \"insert into t(x, y) values(?, ?)\", use(i), use(j);","title":"Binding by Name"},{"location":"backends/sqlite3/#bulk-operations","text":"The SQLite3 backend has full support for SOCI's bulk operations interface. However, this support is emulated and is not native.","title":"Bulk Operations"},{"location":"backends/sqlite3/#transactions","text":"Transactions are also fully supported by the SQLite3 backend.","title":"Transactions"},{"location":"backends/sqlite3/#blob-data-type","text":"The SQLite3 backend supports working with data stored in columns of type Blob, via SOCI's BLOB class. Because of SQLite3 general typelessness the column does not have to be declared any particular type.","title":"BLOB Data Type"},{"location":"backends/sqlite3/#rowid-data-type","text":"In SQLite3 RowID is an integer. \"Each entry in an SQLite table has a unique integer key called the \"rowid\". The rowid is always available as an undeclared column named ROWID, OID, or ROWID . If the table has a column of type INTEGER PRIMARY KEY then that column is another an alias for the rowid.\" [2]","title":"RowID Data Type"},{"location":"backends/sqlite3/#nested-statements","text":"Nested statements are not supported by SQLite3 backend.","title":"Nested Statements"},{"location":"backends/sqlite3/#stored-procedures","text":"Stored procedures are not supported by SQLite3 backend","title":"Stored Procedures"},{"location":"backends/sqlite3/#native-api-access","text":"SOCI provides access to underlying datbabase APIs via several get_backend() functions, as described in the beyond SOCI documentation. The SQLite3 backend provides the following concrete classes for navite API access: Accessor Function Concrete Class session_backend* session::get_backend() sqlie3_session_backend statement_backend* statement::get_backend() sqlite3_statement_backend rowid_backend* rowid::get_backend() sqlite3_rowid_backend","title":"Native API Access"},{"location":"backends/sqlite3/#backend-specific-extensions","text":"","title":"Backend-specific extensions"},{"location":"backends/sqlite3/#sqlite3-result-code-support","text":"SQLite3 result code is provided via the backend specific sqlite3_soci_error class. Catching the backend specific error yields the value of SQLite3 result code via the result() method.","title":"SQLite3 result code support"},{"location":"backends/sqlite3/#configuration-options","text":"None","title":"Configuration options"},{"location":"languages/","text":"Language bindings Ada","title":"Language bindings"},{"location":"languages/#language-bindings","text":"Ada","title":"Language bindings"},{"location":"languages/ada/","text":"Ada Bindings Concepts Idioms API Reference Introduction SOCI-Ada is a database access library for Ada. The library itself is a wrapper for the selected functionality of the SOCI library, which is a C++ database access library recognized for its high quality and innovative interface. The SOCI-Ada library offers the following features to the Ada community: Modular design based on dynamic backend loading. Thanks to this feature, new backends implemented within the context of the main SOCI project are immediately available for Ada programmers without any additional work. A large community of C++ users can help ensure that the new backends are well tested in a variety of environments and usage scenarios. Native backends for major database servers ensure optimal performance and minimize configuration overhead and complexity that is usually associated with other database access methods. Direct support for bulk operations allow to achieve high performance with queries that operate on large data sets. Very liberal open-source license ( Boost, accepted by Open Source Initiative ) that encourages both commercial and non-commercial use. Easy to use and compact interface. Currently the following database servers are directly supported via their native interfaces: Oracle PostgreSQL MySQL Other backends exist in the SOCI Git repository and can be provided with future version of the library. Compilation In order to use SOCI-Ada, compile the C++ parts first (core and required backends). Note: SOCI header files are not needed to use SOCI-Ada, only compiled SOCI libraries (core and relevant backend) need to exist to build and use SOCI-Ada programs. The SOCI-Ada library itself is a single package named SOCI . This package can be just imported in the target project as is or pre-built to the binary form if required. In order to link the user programs the -lsoci_core -lstdc++ linker options need to be provided on the Unix/Linux platforms.","title":"Ada Bindings"},{"location":"languages/ada/#ada-bindings","text":"Concepts Idioms API Reference","title":"Ada Bindings"},{"location":"languages/ada/#introduction","text":"SOCI-Ada is a database access library for Ada. The library itself is a wrapper for the selected functionality of the SOCI library, which is a C++ database access library recognized for its high quality and innovative interface. The SOCI-Ada library offers the following features to the Ada community: Modular design based on dynamic backend loading. Thanks to this feature, new backends implemented within the context of the main SOCI project are immediately available for Ada programmers without any additional work. A large community of C++ users can help ensure that the new backends are well tested in a variety of environments and usage scenarios. Native backends for major database servers ensure optimal performance and minimize configuration overhead and complexity that is usually associated with other database access methods. Direct support for bulk operations allow to achieve high performance with queries that operate on large data sets. Very liberal open-source license ( Boost, accepted by Open Source Initiative ) that encourages both commercial and non-commercial use. Easy to use and compact interface. Currently the following database servers are directly supported via their native interfaces: Oracle PostgreSQL MySQL Other backends exist in the SOCI Git repository and can be provided with future version of the library.","title":"Introduction"},{"location":"languages/ada/#compilation","text":"In order to use SOCI-Ada, compile the C++ parts first (core and required backends). Note: SOCI header files are not needed to use SOCI-Ada, only compiled SOCI libraries (core and relevant backend) need to exist to build and use SOCI-Ada programs. The SOCI-Ada library itself is a single package named SOCI . This package can be just imported in the target project as is or pre-built to the binary form if required. In order to link the user programs the -lsoci_core -lstdc++ linker options need to be provided on the Unix/Linux platforms.","title":"Compilation"},{"location":"languages/ada/concepts/","text":"Ada Concepts The SOCI-Ada library borrows its concepts and naming from the main SOCI project. They are shortly explained here in the bottom-up fashion. One of the main properties of the library is that the data objects which are bound for transfer to and from the database server are managed by the library itself and are not directly visible from the user code. This ensures that no aliasing of objects occurs between Ada and underlying C++ code, which makes the inter-language interface easier and more resilient to the differences in how compilers handle the linkage. As a direct result of this design choice, users of SOCI-Ada need to instruct the library to internally create all objects that will be subject to data transfer. There are two kinds of objects that can be managed by the SOCI-Ada library: Into elements , which are data objects that are transferred from the database to the user program as a result of executing a query. There are single into elements for binding single rows of results and vector into elements for binding whole bunches of data corresponding to whole result sets or their subranges. The into elements are identified by their position . Use elements , which are data objects that are transferred from the user program to the database as parameters of the query (and, if supported by the target database, that can be modified by the database server and transferred back to the user program). There are single use elements for binding parameters of single-row queries and vector use elements for binding whole bunches of data for transfer. The use elements are identified by their name . The user program can read the current value of into and use elements and assign new values to use elements. Elements are strongly typed and the following types are currently supported: String SOCI.DB_Integer , which is defined by the library in terms of Interfaces.C.int SOCI.DB_Long_Long_Integer , which is defined in terms of Interfaces.Integer_64 SOCI.DB_Long_Float , which is defined in terms of Interfaces.C.double Ada.Calendar.Time Both into and use elements are managed for a single statement , which can be prepared once and executed once or many times, with data transfer handled during execution or fetch phase. Statements can be managed explicitly, which is required if they are to be used repeteadly or when data transfer is needed or implicitly, which is a shorthand notation that is particularly useful with simple queries or DDL commands. All statements are handled within the context of some session , which also supports transactions . Sessions can be managed in isolation or as a group called connection pool , which helps to decouple tasking design choices from the concurrency policies at the database connection level. Sessions are leased from the pool for some time during which no other task can access them and returned back when no longer needed, where they can be acquired again by other tasks. All potential problems are signalled via exceptions that have some descriptive message attached to them.","title":"Ada Concepts"},{"location":"languages/ada/concepts/#ada-concepts","text":"The SOCI-Ada library borrows its concepts and naming from the main SOCI project. They are shortly explained here in the bottom-up fashion. One of the main properties of the library is that the data objects which are bound for transfer to and from the database server are managed by the library itself and are not directly visible from the user code. This ensures that no aliasing of objects occurs between Ada and underlying C++ code, which makes the inter-language interface easier and more resilient to the differences in how compilers handle the linkage. As a direct result of this design choice, users of SOCI-Ada need to instruct the library to internally create all objects that will be subject to data transfer. There are two kinds of objects that can be managed by the SOCI-Ada library: Into elements , which are data objects that are transferred from the database to the user program as a result of executing a query. There are single into elements for binding single rows of results and vector into elements for binding whole bunches of data corresponding to whole result sets or their subranges. The into elements are identified by their position . Use elements , which are data objects that are transferred from the user program to the database as parameters of the query (and, if supported by the target database, that can be modified by the database server and transferred back to the user program). There are single use elements for binding parameters of single-row queries and vector use elements for binding whole bunches of data for transfer. The use elements are identified by their name . The user program can read the current value of into and use elements and assign new values to use elements. Elements are strongly typed and the following types are currently supported: String SOCI.DB_Integer , which is defined by the library in terms of Interfaces.C.int SOCI.DB_Long_Long_Integer , which is defined in terms of Interfaces.Integer_64 SOCI.DB_Long_Float , which is defined in terms of Interfaces.C.double Ada.Calendar.Time Both into and use elements are managed for a single statement , which can be prepared once and executed once or many times, with data transfer handled during execution or fetch phase. Statements can be managed explicitly, which is required if they are to be used repeteadly or when data transfer is needed or implicitly, which is a shorthand notation that is particularly useful with simple queries or DDL commands. All statements are handled within the context of some session , which also supports transactions . Sessions can be managed in isolation or as a group called connection pool , which helps to decouple tasking design choices from the concurrency policies at the database connection level. Sessions are leased from the pool for some time during which no other task can access them and returned back when no longer needed, where they can be acquired again by other tasks. All potential problems are signalled via exceptions that have some descriptive message attached to them.","title":"Ada Concepts"},{"location":"languages/ada/idioms/","text":"Ada Idioms As any other library, SOCI-Ada has its set of idioms that ensure optimal work in terms of performance and resource usage. Still, the optimal use will depend on the concrete usage scenario - the places where programmer choices are needed will be described explicitly. The idioms below are provided as complete programs with the intent to make them more understandable and to give complete context of use for each idiom. The programs assume that the target database is PostgreSQL, but this can be changed by a different connection string in each place where the sessions are established. The programs use the Ada 2005 interface and some minor changes will be required to adapt them for Ada 95 compilers. Single query without data transfer This type of query is useful for DDL commands and can be executed directly on the given session, without explicit statement management. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); begin SQL.Execute (\"drop table some_table\"); end My_Program; Note: The session object is initialized by a constructor function call. An alternative would be to declare it without initialization and later use the Open operation to establish a physical connection with the database. Simple query without parameters resulting in one row of data This type of query requires only single into elements, which together with the statement have to be manipulated explicitly. with SOCI; with Ada.Text_IO; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); Pos : SOCI.Into_Position; Num_Of_Persons : SOCI.DB_Integer; begin Pos := St.Into_Integer; St.Prepare (\"select count(*) from persons\"); St.Execute (True); Num_Of_Persons := St.Get_Into_Integer (Pos); Ada.Text_IO.Put_Line (\"Number of persons: \" & SOCI.DB_Integer'Image (Num_Of_Persons)); end My_Program; Note: The into element is inspected by providing the position value that was obtained at the time if was created. No operations are defined for the position type. There can be many into elements with a single query. Simple query with parameters and without results This type of query requires only use elements. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); begin St.Use_Integer (\"increase\"); St.Set_Use_Integer (\"increase\", 1000); St.Prepare (\"update persons set salary = salary + :increase\"); St.Execute (True); end My_Program; Note: The \" :increase \" in the query is a placeholder variable. There can be many such variables and each of them needs to be filled in by respective use element. Repeated query with parameters and without results This type of query requires only use elements, but they can be set differently for each statement execution. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); begin St.Use_String (\"name\"); St.Prepare (\"insert into countries(country_name) values(:name)\"); St.Set_Use_String (\"name\", \"Poland\"); St.Execute (True); St.Set_Use_String (\"name\", \"Switzerland\"); St.Execute (True); St.Set_Use_String (\"name\", \"France\"); St.Execute (True); end My_Program; Note: Each time the query is executed, the current values of use elements are transferred to the database. Batch query with parameters and without results This type of query requires vector use elements. Compare with the previous example. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); First : SOCI.Vector_Index; use type SOCI.Vector_Index; begin St.Use_Vector_String (\"name\"); St.Use_Vectors_Resize (3); First := St.Use_Vectors_First_Index; St.Set_Use_Vector_String (\"name\", First + 0, \"Poland\"); St.Set_Use_Vector_String (\"name\", First + 1, \"Switzerland\"); St.Set_Use_Vector_String (\"name\", First + 2, \"France\"); St.Prepare (\"insert into countries(country_name) values(:name)\"); St.Execute (True); end My_Program; Note: The whole bunch of data is transferred to the database if the target database server supports it and the statement is automatically repeated otherwise. This is the preferred way to transfer many rows of data to the server when the data for all rows are known before executing the query. Note: The query can be executed many times and each time a new batch of data can be transferred to the server. The size of the batch (set by calling Use_Vectors_Resize ) can be different each time the query is executed, but cannot be larger than the size that was used the first time. The size of the batch defines a tradeoff between the amount of data being transmitted in a single step (this influences the memory used by the user program and the time of a single call) and the number of executions required to handle big data sets. The optimal size of the batch will therefore differ depending on the application, but in general tens of thousands is a reasonable limit for a batch size - the performance of the whole operation is usually not affected above this value so there is no need to imply higher memory usage at the client side. Simple query with many rows of results This type of query requires simple into elements. with SOCI; with Ada.Text_IO; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); Pos : SOCI.Into_Position; begin Pos := St.Into_String; St.Prepare (\"select country_name from countries\"); St.Execute; while St.Fetch loop Ada.Text_IO.Put_Line (St.Get_Into_String (Pos)); end loop; end My_Program; Note: The loop above executes as many times as there are rows in the result. After each row is read, the into elements contain the respective values from that row. The Execute operation is called without parameter, which is False by default, meaning that no data transfer is intended. The data is being transferred only during the Fetch operation, which returns False when no data has been retrieved and the result is exhausted. This type of query can have simple parameters which are fixed at the execution time. Batch query with many rows of results This type of query requires vector into elements. Compare with previous example. with SOCI; with Ada.Text_IO; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); Pos : SOCI.Into_Position; Batch_Size : constant := 10; begin Pos := St.Into_Vector_String; St.Into_Vectors_Resize (Batch_Size); St.Prepare (\"select country_name from countries\"); St.Execute; while St.Fetch loop for I in St.Into_Vectors_First_Index .. St.Into_Vectors_Last_Index loop Ada.Text_IO.Put_Line (St.Get_Into_Vector_String (Pos, I)); end loop; St.Into_Vectors_Resize (Batch_Size); end loop; end My_Program; Note: The loop above is nested. The outer while loop fetches consecutive batches of rows from the database with requested batch size; the returned batch can be smaller than requested (the into vector elements are downsized automatically if needed) and the intended batch size is requested again before repeating the Fetch operation. For each returned batch, the into vector elements are inspected in the inner for loop. This scheme ensures correct operation independently on the size of returned batch and is therefore a recommended idiom for efficiently returning many rows of data. There is a tradeoff between efficiency and memory usage and this tradeoff is controlled by the requested batch size. Similarly to one of the examples above, there is no benefit from using batches bigger than tens of thousands of rows. This type of query can have simple (not vectors) parameters that are fixed at execution time. Final note Follow good database usage principles and avoid constructing queries by concatenating strings computed at run-time. Thanks to a good type system Ada is much better in preventing various SQL-injection attacks than weaker languages like PHP, but there is still a potential for vulnerability or at least performance loss. As a rule of thumb, rely on use elements to parameterize your queries and to provide clean separation between data and code. This will prevent many security vulnerabilities and will allow some servers to optimize their work by reusing already cached execution plans.","title":"Ada Idioms"},{"location":"languages/ada/idioms/#ada-idioms","text":"As any other library, SOCI-Ada has its set of idioms that ensure optimal work in terms of performance and resource usage. Still, the optimal use will depend on the concrete usage scenario - the places where programmer choices are needed will be described explicitly. The idioms below are provided as complete programs with the intent to make them more understandable and to give complete context of use for each idiom. The programs assume that the target database is PostgreSQL, but this can be changed by a different connection string in each place where the sessions are established. The programs use the Ada 2005 interface and some minor changes will be required to adapt them for Ada 95 compilers.","title":"Ada Idioms"},{"location":"languages/ada/idioms/#single-query-without-data-transfer","text":"This type of query is useful for DDL commands and can be executed directly on the given session, without explicit statement management. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); begin SQL.Execute (\"drop table some_table\"); end My_Program; Note: The session object is initialized by a constructor function call. An alternative would be to declare it without initialization and later use the Open operation to establish a physical connection with the database.","title":"Single query without data transfer"},{"location":"languages/ada/idioms/#simple-query-without-parameters-resulting-in-one-row-of-data","text":"This type of query requires only single into elements, which together with the statement have to be manipulated explicitly. with SOCI; with Ada.Text_IO; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); Pos : SOCI.Into_Position; Num_Of_Persons : SOCI.DB_Integer; begin Pos := St.Into_Integer; St.Prepare (\"select count(*) from persons\"); St.Execute (True); Num_Of_Persons := St.Get_Into_Integer (Pos); Ada.Text_IO.Put_Line (\"Number of persons: \" & SOCI.DB_Integer'Image (Num_Of_Persons)); end My_Program; Note: The into element is inspected by providing the position value that was obtained at the time if was created. No operations are defined for the position type. There can be many into elements with a single query.","title":"Simple query without parameters resulting in one row of data"},{"location":"languages/ada/idioms/#simple-query-with-parameters-and-without-results","text":"This type of query requires only use elements. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); begin St.Use_Integer (\"increase\"); St.Set_Use_Integer (\"increase\", 1000); St.Prepare (\"update persons set salary = salary + :increase\"); St.Execute (True); end My_Program; Note: The \" :increase \" in the query is a placeholder variable. There can be many such variables and each of them needs to be filled in by respective use element.","title":"Simple query with parameters and without results"},{"location":"languages/ada/idioms/#repeated-query-with-parameters-and-without-results","text":"This type of query requires only use elements, but they can be set differently for each statement execution. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); begin St.Use_String (\"name\"); St.Prepare (\"insert into countries(country_name) values(:name)\"); St.Set_Use_String (\"name\", \"Poland\"); St.Execute (True); St.Set_Use_String (\"name\", \"Switzerland\"); St.Execute (True); St.Set_Use_String (\"name\", \"France\"); St.Execute (True); end My_Program; Note: Each time the query is executed, the current values of use elements are transferred to the database.","title":"Repeated query with parameters and without results"},{"location":"languages/ada/idioms/#batch-query-with-parameters-and-without-results","text":"This type of query requires vector use elements. Compare with the previous example. with SOCI; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); First : SOCI.Vector_Index; use type SOCI.Vector_Index; begin St.Use_Vector_String (\"name\"); St.Use_Vectors_Resize (3); First := St.Use_Vectors_First_Index; St.Set_Use_Vector_String (\"name\", First + 0, \"Poland\"); St.Set_Use_Vector_String (\"name\", First + 1, \"Switzerland\"); St.Set_Use_Vector_String (\"name\", First + 2, \"France\"); St.Prepare (\"insert into countries(country_name) values(:name)\"); St.Execute (True); end My_Program; Note: The whole bunch of data is transferred to the database if the target database server supports it and the statement is automatically repeated otherwise. This is the preferred way to transfer many rows of data to the server when the data for all rows are known before executing the query. Note: The query can be executed many times and each time a new batch of data can be transferred to the server. The size of the batch (set by calling Use_Vectors_Resize ) can be different each time the query is executed, but cannot be larger than the size that was used the first time. The size of the batch defines a tradeoff between the amount of data being transmitted in a single step (this influences the memory used by the user program and the time of a single call) and the number of executions required to handle big data sets. The optimal size of the batch will therefore differ depending on the application, but in general tens of thousands is a reasonable limit for a batch size - the performance of the whole operation is usually not affected above this value so there is no need to imply higher memory usage at the client side.","title":"Batch query with parameters and without results"},{"location":"languages/ada/idioms/#simple-query-with-many-rows-of-results","text":"This type of query requires simple into elements. with SOCI; with Ada.Text_IO; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); Pos : SOCI.Into_Position; begin Pos := St.Into_String; St.Prepare (\"select country_name from countries\"); St.Execute; while St.Fetch loop Ada.Text_IO.Put_Line (St.Get_Into_String (Pos)); end loop; end My_Program; Note: The loop above executes as many times as there are rows in the result. After each row is read, the into elements contain the respective values from that row. The Execute operation is called without parameter, which is False by default, meaning that no data transfer is intended. The data is being transferred only during the Fetch operation, which returns False when no data has been retrieved and the result is exhausted. This type of query can have simple parameters which are fixed at the execution time.","title":"Simple query with many rows of results"},{"location":"languages/ada/idioms/#batch-query-with-many-rows-of-results","text":"This type of query requires vector into elements. Compare with previous example. with SOCI; with Ada.Text_IO; procedure My_Program is SQL : SOCI.Session := SOCI.Make_Session (\"postgresql://dbname=my_database\"); St : SOCI.Statement := SOCI.Make_Statement (SQL); Pos : SOCI.Into_Position; Batch_Size : constant := 10; begin Pos := St.Into_Vector_String; St.Into_Vectors_Resize (Batch_Size); St.Prepare (\"select country_name from countries\"); St.Execute; while St.Fetch loop for I in St.Into_Vectors_First_Index .. St.Into_Vectors_Last_Index loop Ada.Text_IO.Put_Line (St.Get_Into_Vector_String (Pos, I)); end loop; St.Into_Vectors_Resize (Batch_Size); end loop; end My_Program; Note: The loop above is nested. The outer while loop fetches consecutive batches of rows from the database with requested batch size; the returned batch can be smaller than requested (the into vector elements are downsized automatically if needed) and the intended batch size is requested again before repeating the Fetch operation. For each returned batch, the into vector elements are inspected in the inner for loop. This scheme ensures correct operation independently on the size of returned batch and is therefore a recommended idiom for efficiently returning many rows of data. There is a tradeoff between efficiency and memory usage and this tradeoff is controlled by the requested batch size. Similarly to one of the examples above, there is no benefit from using batches bigger than tens of thousands of rows. This type of query can have simple (not vectors) parameters that are fixed at execution time.","title":"Batch query with many rows of results"},{"location":"languages/ada/idioms/#final-note","text":"Follow good database usage principles and avoid constructing queries by concatenating strings computed at run-time. Thanks to a good type system Ada is much better in preventing various SQL-injection attacks than weaker languages like PHP, but there is still a potential for vulnerability or at least performance loss. As a rule of thumb, rely on use elements to parameterize your queries and to provide clean separation between data and code. This will prevent many security vulnerabilities and will allow some servers to optimize their work by reusing already cached execution plans.","title":"Final note"},{"location":"languages/ada/reference/","text":"Ada API Reference The SOCI-Ada library is entirely implemented as a single package named SOCI . Additional child packages contain single procedures for static registration of backends - these child packages are not necessary for typical use, but can be useful to force static linking of backend code. The following describes all publicly visible elements of this package: -- -- General exception related to database and library usage. -- Database_Error : exception; Each problem related to the interaction with the database or to the incorrect usage of the library itself is signalled by raising this exception. Each occurrence of this exception has some human-readable error message that can be obtained by a call to Ada.Exceptions.Exception_Message . -- -- Session. -- type Session is tagged limited private; not overriding function Make_Session (Connection_String : in String) return Session; not overriding procedure Open (This : in out Session; Connection_String : in String); not overriding procedure Close (This : in out Session); not overriding function Is_Open (This : in Session) return Boolean; The Session object can exist in two states: \"connected\" (or \"open\") and \"disconnected\". It can be created as connected at initialization time with a call to the constructor function Make_Session or left default-initialized in the disconnected state and later changed to connected with Open (the latter option is the only that is available in the Ada 95 version of the library). Session objects can be also associated with the connection pool, see below. The Connection_String should have the form \"backendname://parameters\" , where backendname is used to construct the name of the dynamically loadable library that will be used to provide specific database services. Backends included in the current distribution of the main SOCI library are: oracle (implemented as libsoci_oracle.so or libsoci_oracle.dll ) postgresql (implemented as libsoci_postgresql.so or libsoci_postgresql.dll ) mysql (implemented as libsoci_mysql.so or libsoci_mysql.dll ) Other backends can be added to the library in the future or by the user himself, please see the documentation of the main SOCI library for details. The parameters component of the Connection_String depends on the given backend, please see the documentation of the main SOCI project for the meaning and recognized options. The web pages related to the backends above are: Oracle PostgreSQL MySQL The Open operation can be called only in the disconnected state (which changes the state of Session object to connected). The Close operation can be called in any state (provided that the session is not associated with the connection pool, see below) and after that the Session is in the disconnected state. Session objects are closed automatically as part of their finalization. If the Session object is associated with the connection pool, the finalizer detaches from the pool without closing the connection. -- Transaction management. not overriding procedure Start (This : in Session); not overriding procedure Commit (This : in Session); not overriding procedure Rollback (This : in Session); These operations handle transactions. The exact meaning of transactions and whether transactions are automatic for some kinds of statements (and which ones) depend on the target database. -- Immediate query execution. not overriding procedure Execute (This : in Session; Query : in String); This operation allows to create implicit statement, prepare it for the given Query and execute it. -- -- Connection pool management. -- type Connection_Pool (Size : Positive) is tagged limited private; not overriding procedure Open (This : in out Connection_Pool; Position : in Positive; Connection_String : in String); not overriding procedure Close (This : in out Connection_Pool; Position : in Positive); not overriding procedure Lease (This : in out Connection_Pool; S : in out Session'Class); The Connection_Pool encapsulates a fixed-size collection of sessions. Individual sessions are indexed from 1 to Size (provided as discriminant) and can be Open ed and Close d explicitly. Each connection in the pool can be created with different Connection_String , if needed. The Lease operation allows to associate a given Session object (that has to be in the disconnected state itself) with one connection from the pool. The pool guarantees that at most one task can lease a given connection from the pool. If there are no free connections in the pool, the Lease operation will block waiting until some connection is freed. The Session object that is associated with a connection from the pool automatically gives it back to pool as part of the Session 's finalizer. There is no other way to \"detach\" from the pool. Note: It is assumed that the lifetime of Connection_Pool encloses the lifetimes of all Session objects that are leased from it. There is no particular protection against it and it is possible to construct a code example with allocators that create partially overlapping Connection_Pool and Session , but this is considered obscure and not representative to the actual use scenarios. To avoid any potential problems, create Connection_Pool in the scope that encloses the scopes of leased Session s. -- -- Statement. -- type Statement (&lt;&gt;) is tagged limited private; type Data_State is (Data_Null, Data_Not_Null); type Into_Position is private; type Vector_Index is new Natural; The Statement type and supporting types. Data_State is used to indicate null values in the database sense - each value of into or use elements has a state from this type. -- Statement preparation and execution. not overriding procedure Prepare (This : in Statement; Query : in String); not overriding procedure Execute (This : in Statement; With_Data_Exchange : in Boolean := False); not overriding function Execute (This : in Statement; With_Data_Exchange : in Boolean := False) return Boolean; not overriding function Fetch (This : in Statement) return Boolean; not overriding function Got_Data (This : in Statement) return Boolean; The Prepare operation needs to be called before any other operation in the above group and it prepares the execution for the given Query . No into and use elements can be created after this operation is called. The Execute operations cause the statement to execute, which might be combined with data exchange if requested. The function version of this operation returns True if some data has been returned back from the database server. The Fetch function is used to transfer next portion of data (a single row or a whole bunch) from the database server and returns True if some data has been fetched. If this function returns False it means that no new data will be ever fetched for this statement and indicates the end-of-row condition. The Got_Data function returns True if the last execution or fetch resulted in some data being transmitted from the database server. -- -- Data items handling. -- -- Database-specific types. -- These types are most likely identical to standard Integer, -- Long_Long_Integer and Long_Float, but are defined distinctly -- to avoid interfacing problems with other compilers. type DB_Integer is new Interfaces.C.int; type DB_Long_Long_Integer is new Interfaces.Integer_64; type DB_Long_Float is new Interfaces.C.double; The data types used for interaction with the database are: String DB_Integer , defined above DB_Long_Long_Integer , defined above DB_Long_Float , defined above Ada.Calendar.Time -- Creation of single into elements. not overriding function Into_String (This : in Statement) return Into_Position; not overriding function Into_Integer (This : in Statement) return Into_Position; not overriding function Into_Long_Long_Integer (This : in Statement) return Into_Position; not overriding function Into_Long_Float (This : in Statement) return Into_Position; not overriding function Into_Time (This : in Statement) return Into_Position; These functions instruct the library to create internal simple into elements of the relevant type. They return the position of the into element, which can be later used to identify it. Note: Simple into elements cannot be created together with vector into elements for the same statement. Note: Simple into elements cannot be created together with vector into elements for the same statement. -- Inspection of single into elements. not overriding function Get_Into_State (This : in Statement; Position : in Into_Position) return Data_State; not overriding function Get_Into_String (This : in Statement; Position : in Into_Position) return String; not overriding function Get_Into_Integer (This : in Statement; Position : in Into_Position) return DB_Integer; not overriding function Get_Into_Long_Long_Integer (This : in Statement; Position : in Into_Position) return DB_Long_Long_Integer; not overriding function Get_Into_Long_Float (This : in Statement; Position : in Into_Position) return DB_Long_Float; not overriding function Get_Into_Time (This : in Statement; Position : in Into_Position) return Ada.Calendar.Time; These functions allow to inspect the state and value of the simple into element identified by its position. If the state of the given element is Data_Null , the data-reading functions raise exceptions for that element. -- Inspection of vector into elements. not overriding function Get_Into_Vectors_Size (This : in Statement) return Natural; not overriding function Into_Vectors_First_Index (This : in Statement) return Vector_Index; not overriding function Into_Vectors_Last_Index (This : in Statement) return Vector_Index; not overriding procedure Into_Vectors_Resize (This : in Statement; New_Size : in Natural); The Get_Into_Vectors_Size returns the number of entries in any of the vector into elements for the given statement. The Into_Vectors_First_Index returns the lowest index value for vector into elements (which is always 0 , even if the vectors are empty). The Into_Vectors_Last_Index returns the last index of into vectors, and raises the CONSTRAINT_ERROR exception if the vectors are empty. The Into_Vectors_Resize procedure allows to change the size of all use vectors for the given statement. not overriding function Get_Into_Vector_State (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return Data_State; not overriding function Get_Into_Vector_String (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return String; not overriding function Get_Into_Vector_Integer (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return DB_Integer; not overriding function Get_Into_Vector_Long_Long_Integer (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return DB_Long_Long_Integer; not overriding function Get_Into_Vector_Long_Float (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return DB_Long_Float; not overriding function Get_Into_Vector_Time (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return Ada.Calendar.Time; These functions allow to inspect the state and value of the vector use element identified by its position and index. If the state of the given element is Data_Null , the data-reading functions raise exceptions for that element. -- Creation of single use elements. not overriding procedure Use_String (This : in Statement; Name : in String); not overriding procedure Use_Integer (This : in Statement; Name : in String); not overriding procedure Use_Long_Long_Integer (This : in Statement; Name : in String); not overriding procedure Use_Long_Float (This : in Statement; Name : in String); not overriding procedure Use_Time (This : in Statement; Name : in String); These functions instruct the library to create internal simple use elements of the relevant type, identified by the given Name . Note: Simple use elements cannot be created together with vector use elements for the same statement. Vector use elements cannot be created together with any into elements for the same statement. -- Creation of vector use elements. not overriding procedure Use_Vector_String (This : in Statement; Name : in String); not overriding procedure Use_Vector_Integer (This : in Statement; Name : in String); not overriding procedure Use_Vector_Long_Long_Integer (This : in Statement; Name : in String); not overriding procedure Use_Vector_Long_Float (This : in Statement; Name : in String); not overriding procedure Use_Vector_Time (This : in Statement; Name : in String); These functions instruct the library to create internal vector use elements of the relevant type, identified by the given Name . Note: Simple use elements cannot be created together with vector use elements for the same statement. Vector use elements cannot be created together with any into elements for the same statement. -- Modifiers for single use elements. not overriding procedure Set_Use_State (This : in Statement; Name : in String; State : in Data_State); not overriding procedure Set_Use_String (This : in Statement; Name : in String; Value : in String); not overriding procedure Set_Use_Integer (This : in Statement; Name : in String; Value : in DB_Integer); not overriding procedure Set_Use_Long_Long_Integer (This : in Statement; Name : in String; Value : in DB_Long_Long_Integer); not overriding procedure Set_Use_Long_Float (This : in Statement; Name : in String; Value : in DB_Long_Float); not overriding procedure Set_Use_Time (This : in Statement; Name : in String; Value : in Ada.Calendar.Time); These operations allow to modify the state and value of simple use elements. Setting the value of use element automatically sets its state to Data_Not_Null . -- Modifiers for vector use elements. not overriding function Get_Use_Vectors_Size (This : in Statement) return Natural; not overriding function Use_Vectors_First_Index (This : in Statement) return Vector_Index; not overriding function Use_Vectors_Last_Index (This : in Statement) return Vector_Index; not overriding procedure Use_Vectors_Resize (This : in Statement; New_Size : in Natural); The Get_Use_Vectors_Size returns the number of entries in any of the vector use elements for the given statement. The Use_Vectors_First_Index returns the lowest index value for vector use elements (which is always 0 , even if the vectors are empty). The Use_Vectors_Last_Index returns the last index of use vectors, and raises the CONSTRAINT_ERROR exception if the vectors are empty. The Use_Vectors_Resize procedure allows to change the size of all use vectors for the given statement. not overriding procedure Set_Use_Vector_State (This : in Statement; Name : in String; Index : in Vector_Index; State : in Data_State); not overriding procedure Set_Use_Vector_String (This : in Statement; Name : in String; Index : in Vector_Index; Value : in String); not overriding procedure Set_Use_Vector_Integer (This : in Statement; Name : in String; Index : in Vector_Index; Value : in DB_Integer); not overriding procedure Set_Use_Vector_Long_Long_Integer (This : in Statement; Name : in String; Index : in Vector_Index; Value : in DB_Long_Long_Integer); not overriding procedure Set_Use_Vector_Long_Float (This : in Statement; Name : in String; Index : in Vector_Index; Value : in DB_Long_Float); not overriding procedure Set_Use_Vector_Time (This : in Statement; Name : in String; Index : in Vector_Index; Value : in Ada.Calendar.Time); These operations allow to modify the state and value of vector use elements. Setting the value of use element automatically sets its state to Data_Not_Null . -- Inspection of single use elements. -- -- Note: Use elements can be modified by the database if they -- are bound to out and inout parameters of stored procedures -- (although this is not supported by all database backends). -- This feature is available only for single use elements. not overriding function Get_Use_State (This : in Statement; Name : in String) return Data_State; not overriding function Get_Use_String (This : in Statement; Name : in String) return String; not overriding function Get_Use_Integer (This : in Statement; Name : in String) return DB_Integer; not overriding function Get_Use_Long_Long_Integer (This : in Statement; Name : in String) return DB_Long_Long_Integer; not overriding function Get_Use_Long_Float (This : in Statement; Name : in String) return DB_Long_Float; not overriding function Get_Use_Time (This : in Statement; Name : in String) return Ada.Calendar.Time; These functions allow to inspect the state and value of the simple use element identified by its name. If the state of the given element is Data_Null , the data-reading functions raise exceptions for that element.","title":"Ada API Reference"},{"location":"languages/ada/reference/#ada-api-reference","text":"The SOCI-Ada library is entirely implemented as a single package named SOCI . Additional child packages contain single procedures for static registration of backends - these child packages are not necessary for typical use, but can be useful to force static linking of backend code. The following describes all publicly visible elements of this package: -- -- General exception related to database and library usage. -- Database_Error : exception; Each problem related to the interaction with the database or to the incorrect usage of the library itself is signalled by raising this exception. Each occurrence of this exception has some human-readable error message that can be obtained by a call to Ada.Exceptions.Exception_Message . -- -- Session. -- type Session is tagged limited private; not overriding function Make_Session (Connection_String : in String) return Session; not overriding procedure Open (This : in out Session; Connection_String : in String); not overriding procedure Close (This : in out Session); not overriding function Is_Open (This : in Session) return Boolean; The Session object can exist in two states: \"connected\" (or \"open\") and \"disconnected\". It can be created as connected at initialization time with a call to the constructor function Make_Session or left default-initialized in the disconnected state and later changed to connected with Open (the latter option is the only that is available in the Ada 95 version of the library). Session objects can be also associated with the connection pool, see below. The Connection_String should have the form \"backendname://parameters\" , where backendname is used to construct the name of the dynamically loadable library that will be used to provide specific database services. Backends included in the current distribution of the main SOCI library are: oracle (implemented as libsoci_oracle.so or libsoci_oracle.dll ) postgresql (implemented as libsoci_postgresql.so or libsoci_postgresql.dll ) mysql (implemented as libsoci_mysql.so or libsoci_mysql.dll ) Other backends can be added to the library in the future or by the user himself, please see the documentation of the main SOCI library for details. The parameters component of the Connection_String depends on the given backend, please see the documentation of the main SOCI project for the meaning and recognized options. The web pages related to the backends above are: Oracle PostgreSQL MySQL The Open operation can be called only in the disconnected state (which changes the state of Session object to connected). The Close operation can be called in any state (provided that the session is not associated with the connection pool, see below) and after that the Session is in the disconnected state. Session objects are closed automatically as part of their finalization. If the Session object is associated with the connection pool, the finalizer detaches from the pool without closing the connection. -- Transaction management. not overriding procedure Start (This : in Session); not overriding procedure Commit (This : in Session); not overriding procedure Rollback (This : in Session); These operations handle transactions. The exact meaning of transactions and whether transactions are automatic for some kinds of statements (and which ones) depend on the target database. -- Immediate query execution. not overriding procedure Execute (This : in Session; Query : in String); This operation allows to create implicit statement, prepare it for the given Query and execute it. -- -- Connection pool management. -- type Connection_Pool (Size : Positive) is tagged limited private; not overriding procedure Open (This : in out Connection_Pool; Position : in Positive; Connection_String : in String); not overriding procedure Close (This : in out Connection_Pool; Position : in Positive); not overriding procedure Lease (This : in out Connection_Pool; S : in out Session'Class); The Connection_Pool encapsulates a fixed-size collection of sessions. Individual sessions are indexed from 1 to Size (provided as discriminant) and can be Open ed and Close d explicitly. Each connection in the pool can be created with different Connection_String , if needed. The Lease operation allows to associate a given Session object (that has to be in the disconnected state itself) with one connection from the pool. The pool guarantees that at most one task can lease a given connection from the pool. If there are no free connections in the pool, the Lease operation will block waiting until some connection is freed. The Session object that is associated with a connection from the pool automatically gives it back to pool as part of the Session 's finalizer. There is no other way to \"detach\" from the pool. Note: It is assumed that the lifetime of Connection_Pool encloses the lifetimes of all Session objects that are leased from it. There is no particular protection against it and it is possible to construct a code example with allocators that create partially overlapping Connection_Pool and Session , but this is considered obscure and not representative to the actual use scenarios. To avoid any potential problems, create Connection_Pool in the scope that encloses the scopes of leased Session s. -- -- Statement. -- type Statement (&lt;&gt;) is tagged limited private; type Data_State is (Data_Null, Data_Not_Null); type Into_Position is private; type Vector_Index is new Natural; The Statement type and supporting types. Data_State is used to indicate null values in the database sense - each value of into or use elements has a state from this type. -- Statement preparation and execution. not overriding procedure Prepare (This : in Statement; Query : in String); not overriding procedure Execute (This : in Statement; With_Data_Exchange : in Boolean := False); not overriding function Execute (This : in Statement; With_Data_Exchange : in Boolean := False) return Boolean; not overriding function Fetch (This : in Statement) return Boolean; not overriding function Got_Data (This : in Statement) return Boolean; The Prepare operation needs to be called before any other operation in the above group and it prepares the execution for the given Query . No into and use elements can be created after this operation is called. The Execute operations cause the statement to execute, which might be combined with data exchange if requested. The function version of this operation returns True if some data has been returned back from the database server. The Fetch function is used to transfer next portion of data (a single row or a whole bunch) from the database server and returns True if some data has been fetched. If this function returns False it means that no new data will be ever fetched for this statement and indicates the end-of-row condition. The Got_Data function returns True if the last execution or fetch resulted in some data being transmitted from the database server. -- -- Data items handling. -- -- Database-specific types. -- These types are most likely identical to standard Integer, -- Long_Long_Integer and Long_Float, but are defined distinctly -- to avoid interfacing problems with other compilers. type DB_Integer is new Interfaces.C.int; type DB_Long_Long_Integer is new Interfaces.Integer_64; type DB_Long_Float is new Interfaces.C.double; The data types used for interaction with the database are: String DB_Integer , defined above DB_Long_Long_Integer , defined above DB_Long_Float , defined above Ada.Calendar.Time -- Creation of single into elements. not overriding function Into_String (This : in Statement) return Into_Position; not overriding function Into_Integer (This : in Statement) return Into_Position; not overriding function Into_Long_Long_Integer (This : in Statement) return Into_Position; not overriding function Into_Long_Float (This : in Statement) return Into_Position; not overriding function Into_Time (This : in Statement) return Into_Position; These functions instruct the library to create internal simple into elements of the relevant type. They return the position of the into element, which can be later used to identify it. Note: Simple into elements cannot be created together with vector into elements for the same statement. Note: Simple into elements cannot be created together with vector into elements for the same statement. -- Inspection of single into elements. not overriding function Get_Into_State (This : in Statement; Position : in Into_Position) return Data_State; not overriding function Get_Into_String (This : in Statement; Position : in Into_Position) return String; not overriding function Get_Into_Integer (This : in Statement; Position : in Into_Position) return DB_Integer; not overriding function Get_Into_Long_Long_Integer (This : in Statement; Position : in Into_Position) return DB_Long_Long_Integer; not overriding function Get_Into_Long_Float (This : in Statement; Position : in Into_Position) return DB_Long_Float; not overriding function Get_Into_Time (This : in Statement; Position : in Into_Position) return Ada.Calendar.Time; These functions allow to inspect the state and value of the simple into element identified by its position. If the state of the given element is Data_Null , the data-reading functions raise exceptions for that element. -- Inspection of vector into elements. not overriding function Get_Into_Vectors_Size (This : in Statement) return Natural; not overriding function Into_Vectors_First_Index (This : in Statement) return Vector_Index; not overriding function Into_Vectors_Last_Index (This : in Statement) return Vector_Index; not overriding procedure Into_Vectors_Resize (This : in Statement; New_Size : in Natural); The Get_Into_Vectors_Size returns the number of entries in any of the vector into elements for the given statement. The Into_Vectors_First_Index returns the lowest index value for vector into elements (which is always 0 , even if the vectors are empty). The Into_Vectors_Last_Index returns the last index of into vectors, and raises the CONSTRAINT_ERROR exception if the vectors are empty. The Into_Vectors_Resize procedure allows to change the size of all use vectors for the given statement. not overriding function Get_Into_Vector_State (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return Data_State; not overriding function Get_Into_Vector_String (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return String; not overriding function Get_Into_Vector_Integer (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return DB_Integer; not overriding function Get_Into_Vector_Long_Long_Integer (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return DB_Long_Long_Integer; not overriding function Get_Into_Vector_Long_Float (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return DB_Long_Float; not overriding function Get_Into_Vector_Time (This : in Statement; Position : in Into_Position; Index : in Vector_Index) return Ada.Calendar.Time; These functions allow to inspect the state and value of the vector use element identified by its position and index. If the state of the given element is Data_Null , the data-reading functions raise exceptions for that element. -- Creation of single use elements. not overriding procedure Use_String (This : in Statement; Name : in String); not overriding procedure Use_Integer (This : in Statement; Name : in String); not overriding procedure Use_Long_Long_Integer (This : in Statement; Name : in String); not overriding procedure Use_Long_Float (This : in Statement; Name : in String); not overriding procedure Use_Time (This : in Statement; Name : in String); These functions instruct the library to create internal simple use elements of the relevant type, identified by the given Name . Note: Simple use elements cannot be created together with vector use elements for the same statement. Vector use elements cannot be created together with any into elements for the same statement. -- Creation of vector use elements. not overriding procedure Use_Vector_String (This : in Statement; Name : in String); not overriding procedure Use_Vector_Integer (This : in Statement; Name : in String); not overriding procedure Use_Vector_Long_Long_Integer (This : in Statement; Name : in String); not overriding procedure Use_Vector_Long_Float (This : in Statement; Name : in String); not overriding procedure Use_Vector_Time (This : in Statement; Name : in String); These functions instruct the library to create internal vector use elements of the relevant type, identified by the given Name . Note: Simple use elements cannot be created together with vector use elements for the same statement. Vector use elements cannot be created together with any into elements for the same statement. -- Modifiers for single use elements. not overriding procedure Set_Use_State (This : in Statement; Name : in String; State : in Data_State); not overriding procedure Set_Use_String (This : in Statement; Name : in String; Value : in String); not overriding procedure Set_Use_Integer (This : in Statement; Name : in String; Value : in DB_Integer); not overriding procedure Set_Use_Long_Long_Integer (This : in Statement; Name : in String; Value : in DB_Long_Long_Integer); not overriding procedure Set_Use_Long_Float (This : in Statement; Name : in String; Value : in DB_Long_Float); not overriding procedure Set_Use_Time (This : in Statement; Name : in String; Value : in Ada.Calendar.Time); These operations allow to modify the state and value of simple use elements. Setting the value of use element automatically sets its state to Data_Not_Null . -- Modifiers for vector use elements. not overriding function Get_Use_Vectors_Size (This : in Statement) return Natural; not overriding function Use_Vectors_First_Index (This : in Statement) return Vector_Index; not overriding function Use_Vectors_Last_Index (This : in Statement) return Vector_Index; not overriding procedure Use_Vectors_Resize (This : in Statement; New_Size : in Natural); The Get_Use_Vectors_Size returns the number of entries in any of the vector use elements for the given statement. The Use_Vectors_First_Index returns the lowest index value for vector use elements (which is always 0 , even if the vectors are empty). The Use_Vectors_Last_Index returns the last index of use vectors, and raises the CONSTRAINT_ERROR exception if the vectors are empty. The Use_Vectors_Resize procedure allows to change the size of all use vectors for the given statement. not overriding procedure Set_Use_Vector_State (This : in Statement; Name : in String; Index : in Vector_Index; State : in Data_State); not overriding procedure Set_Use_Vector_String (This : in Statement; Name : in String; Index : in Vector_Index; Value : in String); not overriding procedure Set_Use_Vector_Integer (This : in Statement; Name : in String; Index : in Vector_Index; Value : in DB_Integer); not overriding procedure Set_Use_Vector_Long_Long_Integer (This : in Statement; Name : in String; Index : in Vector_Index; Value : in DB_Long_Long_Integer); not overriding procedure Set_Use_Vector_Long_Float (This : in Statement; Name : in String; Index : in Vector_Index; Value : in DB_Long_Float); not overriding procedure Set_Use_Vector_Time (This : in Statement; Name : in String; Index : in Vector_Index; Value : in Ada.Calendar.Time); These operations allow to modify the state and value of vector use elements. Setting the value of use element automatically sets its state to Data_Not_Null . -- Inspection of single use elements. -- -- Note: Use elements can be modified by the database if they -- are bound to out and inout parameters of stored procedures -- (although this is not supported by all database backends). -- This feature is available only for single use elements. not overriding function Get_Use_State (This : in Statement; Name : in String) return Data_State; not overriding function Get_Use_String (This : in Statement; Name : in String) return String; not overriding function Get_Use_Integer (This : in Statement; Name : in String) return DB_Integer; not overriding function Get_Use_Long_Long_Integer (This : in Statement; Name : in String) return DB_Long_Long_Integer; not overriding function Get_Use_Long_Float (This : in Statement; Name : in String) return DB_Long_Float; not overriding function Get_Use_Time (This : in Statement; Name : in String) return Ada.Calendar.Time; These functions allow to inspect the state and value of the simple use element identified by its name. If the state of the given element is Data_Null , the data-reading functions raise exceptions for that element.","title":"Ada API Reference"}]}
\ No newline at end of file
diff --git a/docs/search/worker.js b/docs/search/worker.js
deleted file mode 100644
index 8628dbc..0000000
--- a/docs/search/worker.js
+++ /dev/null
@@ -1,133 +0,0 @@
-var base_path = 'function' === typeof importScripts ? '.' : '/search/';
-var allowSearch = false;
-var index;
-var documents = {};
-var lang = ['en'];
-var data;
-
-function getScript(script, callback) {
-  console.log('Loading script: ' + script);
-  $.getScript(base_path + script).done(function () {
-    callback();
-  }).fail(function (jqxhr, settings, exception) {
-    console.log('Error: ' + exception);
-  });
-}
-
-function getScriptsInOrder(scripts, callback) {
-  if (scripts.length === 0) {
-    callback();
-    return;
-  }
-  getScript(scripts[0], function() {
-    getScriptsInOrder(scripts.slice(1), callback);
-  });
-}
-
-function loadScripts(urls, callback) {
-  if( 'function' === typeof importScripts ) {
-    importScripts.apply(null, urls);
-    callback();
-  } else {
-    getScriptsInOrder(urls, callback);
-  }
-}
-
-function onJSONLoaded () {
-  data = JSON.parse(this.responseText);
-  var scriptsToLoad = ['lunr.js'];
-  if (data.config && data.config.lang && data.config.lang.length) {
-    lang = data.config.lang;
-  }
-  if (lang.length > 1 || lang[0] !== "en") {
-    scriptsToLoad.push('lunr.stemmer.support.js');
-    if (lang.length > 1) {
-      scriptsToLoad.push('lunr.multi.js');
-    }
-    if (lang.includes("ja") || lang.includes("jp")) {
-      scriptsToLoad.push('tinyseg.js');
-    }
-    for (var i=0; i < lang.length; i++) {
-      if (lang[i] != 'en') {
-        scriptsToLoad.push(['lunr', lang[i], 'js'].join('.'));
-      }
-    }
-  }
-  loadScripts(scriptsToLoad, onScriptsLoaded);
-}
-
-function onScriptsLoaded () {
-  console.log('All search scripts loaded, building Lunr index...');
-  if (data.config && data.config.separator && data.config.separator.length) {
-    lunr.tokenizer.separator = new RegExp(data.config.separator);
-  }
-
-  if (data.index) {
-    index = lunr.Index.load(data.index);
-    data.docs.forEach(function (doc) {
-      documents[doc.location] = doc;
-    });
-    console.log('Lunr pre-built index loaded, search ready');
-  } else {
-    index = lunr(function () {
-      if (lang.length === 1 && lang[0] !== "en" && lunr[lang[0]]) {
-        this.use(lunr[lang[0]]);
-      } else if (lang.length > 1) {
-        this.use(lunr.multiLanguage.apply(null, lang));  // spread operator not supported in all browsers: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator#Browser_compatibility
-      }
-      this.field('title');
-      this.field('text');
-      this.ref('location');
-
-      for (var i=0; i < data.docs.length; i++) {
-        var doc = data.docs[i];
-        this.add(doc);
-        documents[doc.location] = doc;
-      }
-    });
-    console.log('Lunr index built, search ready');
-  }
-  allowSearch = true;
-  postMessage({config: data.config});
-  postMessage({allowSearch: allowSearch});
-}
-
-function init () {
-  var oReq = new XMLHttpRequest();
-  oReq.addEventListener("load", onJSONLoaded);
-  var index_path = base_path + '/search_index.json';
-  if( 'function' === typeof importScripts ){
-      index_path = 'search_index.json';
-  }
-  oReq.open("GET", index_path);
-  oReq.send();
-}
-
-function search (query) {
-  if (!allowSearch) {
-    console.error('Assets for search still loading');
-    return;
-  }
-
-  var resultDocuments = [];
-  var results = index.search(query);
-  for (var i=0; i < results.length; i++){
-    var result = results[i];
-    doc = documents[result.ref];
-    doc.summary = doc.text.substring(0, 200);
-    resultDocuments.push(doc);
-  }
-  return resultDocuments;
-}
-
-if( 'function' === typeof importScripts ) {
-  onmessage = function (e) {
-    if (e.data.init) {
-      init();
-    } else if (e.data.query) {
-      postMessage({ results: search(e.data.query) });
-    } else {
-      console.error("Worker - Unrecognized message: " + e);
-    }
-  };
-}
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
deleted file mode 100644
index a97ee41..0000000
--- a/docs/sitemap.xml
+++ /dev/null
@@ -1,193 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2022-02-10</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-</urlset>
\ No newline at end of file
diff --git a/docs/sitemap.xml.gz b/docs/sitemap.xml.gz
deleted file mode 100644
index d2c3a0b..0000000
Binary files a/docs/sitemap.xml.gz and /dev/null differ
diff --git a/docs/statements.md b/docs/statements.md
new file mode 100644
index 0000000..59ecc28
--- /dev/null
+++ b/docs/statements.md
@@ -0,0 +1,268 @@
+# Statements
+
+## Prepared statement
+
+Consider the following examples:
+
+```cpp
+// Example 1.
+for (int i = 0; i != 100; ++i)
+{
+    sql << "insert into numbers(value) values(" << i << ")";
+}
+
+// Example 2.
+for (int i = 0; i != 100; ++i)
+{
+    sql << "insert into numbers(value) values(:val)", use(i);
+}
+```
+
+Both examples will populate the table `numbers` with the values from `0` to `99`.
+
+The problem is that in both examples, not only the statement execution is repeated 100 times, but also the statement parsing and preparation.
+This means unnecessary overhead, even if some of the database servers are likely to optimize the second case.
+In fact, more complicated queries are likely to suffer in terms of lower performance, because finding the optimal execution plan is quite expensive and here it would be needlessly repeated.
+
+### Statement preparation
+
+The following example uses the class `statement` explicitly, by preparing the statement only once and repeating its execution with changing data (note the use of `prepare` member of `session` class):
+
+```cpp
+int i;
+statement st = (sql.prepare <<
+                "insert into numbers(value) values(:val)",
+                use(i));
+for (i = 0; i != 100; ++i)
+{
+    st.execute(true);
+}
+```
+
+The `true` parameter given to the `execute` method indicates that the actual data exchange is wanted, so that the meaning of the whole example is
+
+> "prepare the statement and exchange the data for each value of variable `i`".
+
+### Portability note:
+
+The above syntax is supported for all backends, even if some database server does not actually provide this functionality - in which case the library will internally execute the query in a single phase, without really separating the statement preparation from execution.
+
+## Rowset and iterator
+
+The `rowset` class provides an alternative means of executing queries and accessing results using STL-like iterator interface.
+
+The `rowset_iterator` type is compatible with requirements defined for input iterator category and is available via `iterator` and `const_iterator` definitions in the `rowset` class.
+
+The `rowset` itself can be used only with select queries.
+
+The following example creates an instance of the `rowset` class and binds query results into elements of `int` type - in this query only one result column is expected.
+After executing the query the code iterates through the query result using `rowset_iterator`:
+
+```cpp
+rowset<int> rs = (sql.prepare << "select values from numbers");
+
+for (rowset<int>::const_iterator it = rs.begin(); it != rs.end(); ++it)
+{
+        cout << *it << '\n';
+}
+```
+
+Another example shows how to retrieve more complex results, where `rowset` elements are of type `row` and therefore use [dynamic bindings](types.md#dynamic-binding):
+
+```cpp
+// person table has 4 columns
+
+rowset<row> rs = (sql.prepare << "select id, firstname, lastname, gender from person");
+
+// iteration through the resultset:
+for (rowset<row>::const_iterator it = rs.begin(); it != rs.end(); ++it)
+{
+    row const& row = *it;
+
+    // dynamic data extraction from each row:
+    cout << "Id: " << row.get<int>(0) << '\n'
+            << "Name: " << row.get<string>(1) << " " << row.get<string>(2) << '\n'
+            << "Gender: " << row.get<string>(3) << endl;
+}
+```
+
+The `rowset_iterator` can be used with standard algorithms as well:
+
+```cpp
+rowset<string> rs = (sql.prepare << "select firstname from person");
+
+std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, "\n"));
+```
+
+Above, the query result contains a single column which is bound to `rowset` element of type of `std::string`.
+All records are sent to standard output using the `std::copy` algorithm.
+
+If you need to use the Core interface with `rowset`, the following example shows how:
+
+```cpp
+row r;
+
+statement st(sql);
+st.alloc();
+st.prepare("select values from numbers");
+st.define_and_bind();
+
+// after define_and_bind and before execute
+st.exchange_for_rowset(into(r));
+
+st.execute(false);
+
+rowset_iterator<row> it(st, r);
+rowset_iterator<row> end;
+for (; it != end; ++it) {
+    // ... access *it
+}
+```
+
+## Bulk operations
+
+When using some databases, further performance improvements may be possible by having the underlying database API group operations together to reduce network roundtrips.
+SOCI makes such bulk operations possible by supporting `std::vector` based types.
+
+The following example presents how to insert 100 records in 4 batches.
+It is also important to note, that size of vector remains equal in every batch interaction.
+This ensures vector is not reallocated and, what's crucial for the bulk trick, new data should be pushed to the vector before every call to `statement::execute`:
+
+```cpp
+// Example 3.
+void fill_ids(std::vector<int>& ids)
+{
+    for (std::size_t i = 0; i < ids.size(); ++i)
+        ids[i] = i; // mimics source of a new ID
+}
+
+const int BATCH_SIZE = 25;
+std::vector<int> ids(BATCH_SIZE);
+
+statement st = (sql.prepare << "insert into numbers(value) values(:val)", use(ids));
+for (int i = 0; i != 4; ++i)
+{
+    fill_ids(ids);
+    st.execute(true);
+}
+```
+
+Given batch size is 25, this example should insert 4 x 25 = 100 records.
+
+(Of course, the size of the vector that will achieve optimum performance will vary, depending on many environmental factors, such as network speed.)
+
+It is also possible to read all the numbers written in the above examples:
+
+```cpp
+int i;
+statement st = (sql.prepare << "select value from numbers order by value", into(i));
+st.execute();
+while (st.fetch())
+{
+    cout << i << '\n';
+}
+```
+
+In the above example, the `execute` method is called with the default parameter `false`.
+This means that the statement should be executed, but the actual data exchange will be performed later.
+
+Further `fetch` calls perform the actual data retrieval and cursor traversal.
+The *end-of-cursor* condition is indicated by the `fetch` function returning `false`.
+
+The above code example should be treated as an idiomatic way of reading many rows of data, *one at a time*.
+
+It is further possible to select records in batches into `std::vector` based types, with the size of the vector specifying the number of records to retrieve in each round trip:
+
+```cpp
+std::vector<int> valsOut(100);
+sql << "select val from numbers", into(valsOut);
+```
+
+Above, the value `100` indicates that no more values should be retrieved, even if it would be otherwise possible.
+If there are less rows than asked for, the vector will be appropriately down-sized.
+
+The `statement::execute()` and `statement::fetch()` functions can also be used to repeatedly select all rows returned by a query into a vector based type:
+
+```cpp
+const int BATCH_SIZE = 30;
+std::vector<int> valsOut(BATCH_SIZE);
+statement st = (sql.prepare <<
+                "select value from numbers",
+                into(valsOut));
+st.execute();
+while (st.fetch())
+{
+    std::vector<int>::iterator pos;
+    for(pos = valsOut.begin(); pos != valsOut.end(); ++pos)
+    {
+        cout << *pos << '\n';
+    }
+
+    valsOut.resize(BATCH_SIZE);
+}
+```
+
+Assuming there are 100 rows returned by the query, the above code will retrieve and print all of them.
+Since the output vector was created with size 30, it will take (at least) 4 calls to `fetch()` to retrieve all 100 values.
+Each call to `fetch()` can potentially resize the vector to a size less than its initial size - how often this happens depends on the underlying database implementation.
+This explains why the `resize(BATCH_SIZE)` operation is needed - it is there to ensure that each time the `fetch()` is called, the vector is ready to accept the next bunch of values.
+Without this operation, the vector *might* be getting smaller with subsequent iterations of the loop, forcing more iterations to be performed (because *all* rows will be read anyway), than really needed.
+
+Note the following details about the above examples:
+
+* After performing `fetch()`, the vector's size might be *less* than requested, but `fetch()` returning true means that there was *at least one* row retrieved.
+* It is forbidden to manually resize the vector to the size *higher* than it was initially (this can cause the vector to reallocate its internal buffer and the library can lose track of it).
+
+Taking these points under consideration, the above code example should be treated as an idiomatic way of reading many rows by bunches of requested size.
+
+### Portability note
+
+Actually, all supported backends guarantee that the requested number of rows will be read with each fetch and that the vector will never be down-sized, unless for the last fetch, when the end of rowset condition is met.
+This means that the manual vector resizing is in practice not needed - the vector will keep its size until the end of rowset.
+The above idiom, however, is provided with future backends in mind, where the constant size of the vector might be too expensive to guarantee and where allowing `fetch` to down-size the vector even before reaching the end of rowset might buy some performance gains.
+
+## Statement caching
+
+Some backends have some facilities to improve statement parsing and compilation to limit overhead when creating commonly used query.
+But for backends that does not support this kind optimization you can keep prepared statement and use it later with new references.
+To do such, prepare a statement as usual, you have to use `exchange` to bind new variables to statement object, then `execute` statement and finish by cleaning bound references with `bind_clean_up`.
+
+```cpp
+sql << "CREATE TABLE test(a INTEGER)";
+
+{
+    // prepare statement
+    soci::statement stmt = (sql.prepare << "INSERT INTO numbers(value) VALUES(:val)");
+
+    {
+        // first insert
+        int a0 = 0;
+
+        // update reference
+        stmt.exchange(soci::use(a0));
+
+        stmt.define_and_bind();
+        stmt.execute(true);
+        stmt.bind_clean_up();
+    }
+
+    {
+        // come later, second insert
+        int a1 = 1;
+
+        // update reference
+        stmt.exchange(soci::use(a1));
+
+        stmt.define_and_bind();
+        stmt.execute(true);
+        stmt.bind_clean_up();
+    }
+}
+
+{
+    std::vector<int> v(10);
+    sql << "SELECT value FROM numbers", soci::into(v);
+    for (int i = 0; i < v.size(); ++i)
+        std::cout << "value " << i << ": " << v[i] << std::endl;
+}
+```
diff --git a/docs/statements/index.html b/docs/statements/index.html
deleted file mode 100644
index a984312..0000000
--- a/docs/statements/index.html
+++ /dev/null
@@ -1,566 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Statements - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../lobs/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../transactions/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/statements.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#statements" class="nav-link">Statements</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#prepared-statement" class="nav-link">Prepared statement</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#rowset-and-iterator" class="nav-link">Rowset and iterator</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#bulk-operations" class="nav-link">Bulk operations</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#statement-caching" class="nav-link">Statement caching</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="statements">Statements</h1>
-<h2 id="prepared-statement">Prepared statement</h2>
-<p>Consider the following examples:</p>
-<pre><code class="language-cpp">// Example 1.
-for (int i = 0; i != 100; ++i)
-{
-    sql &lt;&lt; &quot;insert into numbers(value) values(&quot; &lt;&lt; i &lt;&lt; &quot;)&quot;;
-}
-
-// Example 2.
-for (int i = 0; i != 100; ++i)
-{
-    sql &lt;&lt; &quot;insert into numbers(value) values(:val)&quot;, use(i);
-}
-</code></pre>
-<p>Both examples will populate the table <code>numbers</code> with the values from <code>0</code> to <code>99</code>.</p>
-<p>The problem is that in both examples, not only the statement execution is repeated 100 times, but also the statement parsing and preparation.
-This means unnecessary overhead, even if some of the database servers are likely to optimize the second case.
-In fact, more complicated queries are likely to suffer in terms of lower performance, because finding the optimal execution plan is quite expensive and here it would be needlessly repeated.</p>
-<h3 id="statement-preparation">Statement preparation</h3>
-<p>The following example uses the class <code>statement</code> explicitly, by preparing the statement only once and repeating its execution with changing data (note the use of <code>prepare</code> member of <code>session</code> class):</p>
-<pre><code class="language-cpp">int i;
-statement st = (sql.prepare &lt;&lt;
-                &quot;insert into numbers(value) values(:val)&quot;,
-                use(i));
-for (i = 0; i != 100; ++i)
-{
-    st.execute(true);
-}
-</code></pre>
-<p>The <code>true</code> parameter given to the <code>execute</code> method indicates that the actual data exchange is wanted, so that the meaning of the whole example is</p>
-<blockquote>
-<p>"prepare the statement and exchange the data for each value of variable <code>i</code>".</p>
-</blockquote>
-<h3 id="portability-note">Portability note:</h3>
-<p>The above syntax is supported for all backends, even if some database server does not actually provide this functionality - in which case the library will internally execute the query in a single phase, without really separating the statement preparation from execution.</p>
-<h2 id="rowset-and-iterator">Rowset and iterator</h2>
-<p>The <code>rowset</code> class provides an alternative means of executing queries and accessing results using STL-like iterator interface.</p>
-<p>The <code>rowset_iterator</code> type is compatible with requirements defined for input iterator category and is available via <code>iterator</code> and <code>const_iterator</code> definitions in the <code>rowset</code> class.</p>
-<p>The <code>rowset</code> itself can be used only with select queries.</p>
-<p>The following example creates an instance of the <code>rowset</code> class and binds query results into elements of <code>int</code> type - in this query only one result column is expected.
-After executing the query the code iterates through the query result using <code>rowset_iterator</code>:</p>
-<pre><code class="language-cpp">rowset&lt;int&gt; rs = (sql.prepare &lt;&lt; &quot;select values from numbers&quot;);
-
-for (rowset&lt;int&gt;::const_iterator it = rs.begin(); it != rs.end(); ++it)
-{
-        cout &lt;&lt; *it &lt;&lt; '\n';
-}
-</code></pre>
-<p>Another example shows how to retrieve more complex results, where <code>rowset</code> elements are of type <code>row</code> and therefore use <a href="../types/#dynamic-binding">dynamic bindings</a>:</p>
-<pre><code class="language-cpp">// person table has 4 columns
-
-rowset&lt;row&gt; rs = (sql.prepare &lt;&lt; &quot;select id, firstname, lastname, gender from person&quot;);
-
-// iteration through the resultset:
-for (rowset&lt;row&gt;::const_iterator it = rs.begin(); it != rs.end(); ++it)
-{
-    row const&amp; row = *it;
-
-    // dynamic data extraction from each row:
-    cout &lt;&lt; &quot;Id: &quot; &lt;&lt; row.get&lt;int&gt;(0) &lt;&lt; '\n'
-            &lt;&lt; &quot;Name: &quot; &lt;&lt; row.get&lt;string&gt;(1) &lt;&lt; &quot; &quot; &lt;&lt; row.get&lt;string&gt;(2) &lt;&lt; '\n'
-            &lt;&lt; &quot;Gender: &quot; &lt;&lt; row.get&lt;string&gt;(3) &lt;&lt; endl;
-}
-</code></pre>
-<p>The <code>rowset_iterator</code> can be used with standard algorithms as well:</p>
-<pre><code class="language-cpp">rowset&lt;string&gt; rs = (sql.prepare &lt;&lt; &quot;select firstname from person&quot;);
-
-std::copy(rs.begin(), rs.end(), std::ostream_iterator&lt;std::string&gt;(std::cout, &quot;\n&quot;));
-</code></pre>
-<p>Above, the query result contains a single column which is bound to <code>rowset</code> element of type of <code>std::string</code>.
-All records are sent to standard output using the <code>std::copy</code> algorithm.</p>
-<p>If you need to use the Core interface with <code>rowset</code>, the following example shows how:</p>
-<pre><code class="language-cpp">row r;
-
-statement st(sql);
-st.alloc();
-st.prepare(&quot;select values from numbers&quot;);
-st.define_and_bind();
-
-// after define_and_bind and before execute
-st.exchange_for_rowset(into(r));
-
-st.execute(false);
-
-rowset_iterator&lt;row&gt; it(st, r);
-rowset_iterator&lt;row&gt; end;
-for (; it != end; ++it) {
-    // ... access *it
-}
-</code></pre>
-<h2 id="bulk-operations">Bulk operations</h2>
-<p>When using some databases, further performance improvements may be possible by having the underlying database API group operations together to reduce network roundtrips.
-SOCI makes such bulk operations possible by supporting <code>std::vector</code> based types.</p>
-<p>The following example presents how to insert 100 records in 4 batches.
-It is also important to note, that size of vector remains equal in every batch interaction.
-This ensures vector is not reallocated and, what's crucial for the bulk trick, new data should be pushed to the vector before every call to <code>statement::execute</code>:</p>
-<pre><code class="language-cpp">// Example 3.
-void fill_ids(std::vector&lt;int&gt;&amp; ids)
-{
-    for (std::size_t i = 0; i &lt; ids.size(); ++i)
-        ids[i] = i; // mimics source of a new ID
-}
-
-const int BATCH_SIZE = 25;
-std::vector&lt;int&gt; ids(BATCH_SIZE);
-
-statement st = (sql.prepare &lt;&lt; &quot;insert into numbers(value) values(:val)&quot;, use(ids));
-for (int i = 0; i != 4; ++i)
-{
-    fill_ids(ids);
-    st.execute(true);
-}
-</code></pre>
-<p>Given batch size is 25, this example should insert 4 x 25 = 100 records.</p>
-<p>(Of course, the size of the vector that will achieve optimum performance will vary, depending on many environmental factors, such as network speed.)</p>
-<p>It is also possible to read all the numbers written in the above examples:</p>
-<pre><code class="language-cpp">int i;
-statement st = (sql.prepare &lt;&lt; &quot;select value from numbers order by value&quot;, into(i));
-st.execute();
-while (st.fetch())
-{
-    cout &lt;&lt; i &lt;&lt; '\n';
-}
-</code></pre>
-<p>In the above example, the <code>execute</code> method is called with the default parameter <code>false</code>.
-This means that the statement should be executed, but the actual data exchange will be performed later.</p>
-<p>Further <code>fetch</code> calls perform the actual data retrieval and cursor traversal.
-The <em>end-of-cursor</em> condition is indicated by the <code>fetch</code> function returning <code>false</code>.</p>
-<p>The above code example should be treated as an idiomatic way of reading many rows of data, <em>one at a time</em>.</p>
-<p>It is further possible to select records in batches into <code>std::vector</code> based types, with the size of the vector specifying the number of records to retrieve in each round trip:</p>
-<pre><code class="language-cpp">std::vector&lt;int&gt; valsOut(100);
-sql &lt;&lt; &quot;select val from numbers&quot;, into(valsOut);
-</code></pre>
-<p>Above, the value <code>100</code> indicates that no more values should be retrieved, even if it would be otherwise possible.
-If there are less rows than asked for, the vector will be appropriately down-sized.</p>
-<p>The <code>statement::execute()</code> and <code>statement::fetch()</code> functions can also be used to repeatedly select all rows returned by a query into a vector based type:</p>
-<pre><code class="language-cpp">const int BATCH_SIZE = 30;
-std::vector&lt;int&gt; valsOut(BATCH_SIZE);
-statement st = (sql.prepare &lt;&lt;
-                &quot;select value from numbers&quot;,
-                into(valsOut));
-st.execute();
-while (st.fetch())
-{
-    std::vector&lt;int&gt;::iterator pos;
-    for(pos = valsOut.begin(); pos != valsOut.end(); ++pos)
-    {
-        cout &lt;&lt; *pos &lt;&lt; '\n';
-    }
-
-    valsOut.resize(BATCH_SIZE);
-}
-</code></pre>
-<p>Assuming there are 100 rows returned by the query, the above code will retrieve and print all of them.
-Since the output vector was created with size 30, it will take (at least) 4 calls to <code>fetch()</code> to retrieve all 100 values.
-Each call to <code>fetch()</code> can potentially resize the vector to a size less than its initial size - how often this happens depends on the underlying database implementation.
-This explains why the <code>resize(BATCH_SIZE)</code> operation is needed - it is there to ensure that each time the <code>fetch()</code> is called, the vector is ready to accept the next bunch of values.
-Without this operation, the vector <em>might</em> be getting smaller with subsequent iterations of the loop, forcing more iterations to be performed (because <em>all</em> rows will be read anyway), than really needed.</p>
-<p>Note the following details about the above examples:</p>
-<ul>
-<li>After performing <code>fetch()</code>, the vector's size might be <em>less</em> than requested, but <code>fetch()</code> returning true means that there was <em>at least one</em> row retrieved.</li>
-<li>It is forbidden to manually resize the vector to the size <em>higher</em> than it was initially (this can cause the vector to reallocate its internal buffer and the library can lose track of it).</li>
-</ul>
-<p>Taking these points under consideration, the above code example should be treated as an idiomatic way of reading many rows by bunches of requested size.</p>
-<h3 id="portability-note_1">Portability note</h3>
-<p>Actually, all supported backends guarantee that the requested number of rows will be read with each fetch and that the vector will never be down-sized, unless for the last fetch, when the end of rowset condition is met.
-This means that the manual vector resizing is in practice not needed - the vector will keep its size until the end of rowset.
-The above idiom, however, is provided with future backends in mind, where the constant size of the vector might be too expensive to guarantee and where allowing <code>fetch</code> to down-size the vector even before reaching the end of rowset might buy some performance gains.</p>
-<h2 id="statement-caching">Statement caching</h2>
-<p>Some backends have some facilities to improve statement parsing and compilation to limit overhead when creating commonly used query.
-But for backends that does not support this kind optimization you can keep prepared statement and use it later with new references.
-To do such, prepare a statement as usual, you have to use <code>exchange</code> to bind new variables to statement object, then <code>execute</code> statement and finish by cleaning bound references with <code>bind_clean_up</code>.</p>
-<pre><code class="language-cpp">sql &lt;&lt; &quot;CREATE TABLE test(a INTEGER)&quot;;
-
-{
-    // prepare statement
-    soci::statement stmt = (db.prepare &lt;&lt; &quot;INSERT INTO numbers(value) VALUES(:val)&quot;);
-
-    {
-        // first insert
-        int a0 = 0;
-
-        // update reference
-        stmt.exchange(soci::use(a0));
-
-        stmt.define_and_bind();
-        stmt.execute(true);
-        stmt.bind_clean_up();
-    }
-
-    {
-        // come later, second insert
-        int a1 = 1;
-
-        // update reference
-        stmt.exchange(soci::use(a1));
-
-        stmt.define_and_bind();
-        stmt.execute(true);
-        stmt.bind_clean_up();
-    }
-}
-
-{
-    std::vector&lt;int&gt; v(10);
-    db &lt;&lt; &quot;SELECT value FROM numbers&quot;, soci::into(v);
-    for (int i = 0; i &lt; v.size(); ++i)
-        std::cout &lt;&lt; &quot;value &quot; &lt;&lt; i &lt;&lt; &quot;: &quot; &lt;&lt; v[i] &lt;&lt; std::endl;
-}
-</code></pre></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/structure.md b/docs/structure.md
new file mode 100644
index 0000000..ebdaa81
--- /dev/null
+++ b/docs/structure.md
@@ -0,0 +1,40 @@
+# Structure
+
+The picture below presents the structure of the library, together with its clients and servers.
+The boxes filled with cyan represent components that are part of the library distribution.
+
+![Structure Chart](images/structure.png)
+
+The SOCI library is extensible in the following ways:
+
+* More backends can be added to target various database servers.
+* More interfaces can be defined on top of common backend interface.
+* Other languages can use the [simple interface](interfaces.md), which was designed specifically for the "C" calling convention to ensure easy binding.
+
+The core part of the library and the backend interface definition are placed
+in the `core` directory of the library distribution. The `soci-backend.h` file
+is an internal abstract interface to the actual backends, which are needed to
+perform operations on the given database server. Normally, the C++ client
+program needs to interface with the `soci.h` header and the header(s) relevant
+to the given backend(s) (for example, `soci-oracle.h`), although with dynamic
+backend loading this can be avoided. It is possible for the same program to use
+many backends at the same time.
+
+Everything in SOCI is declared in the namespace `soci`. All code examples
+presented in this documentation assume that your code begins with something like:
+
+```cpp
+#include <soci/soci.h>
+// other includes if necessary
+
+using namespace soci;
+
+// ...
+```
+
+Note: In simple programs, `#include` for the relevant backend is needed only
+in the file where the `session` object is created with explicit name of
+the backend factory. The example program on the [previous page](index.md)
+shows the appropriate `#include` directive for the Oracle backend.
+It is also possible to name backends at run-time as part of the connection
+string, in which case no backend-specific `#include` directive is necessary.
diff --git a/docs/structure/index.html b/docs/structure/index.html
deleted file mode 100644
index 639f86c..0000000
--- a/docs/structure/index.html
+++ /dev/null
@@ -1,372 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Library Structure - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../installation/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../license/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/structure.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#structure" class="nav-link">Structure</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="structure">Structure</h1>
-<p>The picture below presents the structure of the library, together with its clients and servers.
-The boxes filled with cyan represent components that are part of the library distribution.</p>
-<p><img alt="Structure Chart" src="../images/structure.png" /></p>
-<p>The SOCI library is extensible in the following ways:</p>
-<ul>
-<li>More backends can be added to target various database servers.</li>
-<li>More interfaces can be defined on top of common backend interface.</li>
-<li>Other languages can use the <a href="../interfaces/">simple interface</a>, which was designed specifically for the "C" calling convention to ensure easy binding.</li>
-</ul>
-<p>The core part of the library and the backend interface definition are placed
-in the <code>core</code> directory of the library distribution. The <code>soci-backend.h</code> file
-is an internal abstract interface to the actual backends, which are needed to
-perform operations on the given database server. Normally, the C++ client
-program needs to interface with the <code>soci.h</code> header and the header(s) relevant
-to the given backend(s) (for example, <code>soci-oracle.h</code>), although with dynamic
-backend loading this can be avoided. It is possible for the same program to use
-many backends at the same time.</p>
-<p>Everything in SOCI is declared in the namespace <code>soci</code>. All code examples
-presented in this documentation assume that your code begins with something like:</p>
-<pre><code class="language-cpp">#include &lt;soci/soci.h&gt;
-// other includes if necessary
-
-using namespace soci;
-
-// ...
-</code></pre>
-<p>Note: In simple programs, <code>#include</code> for the relevant backend is needed only
-in the file where the <code>session</code> object is created with explicit name of
-the backend factory. The example program on the <a href="..">previous page</a>
-shows the appropriate <code>#include</code> directive for the Oracle backend.
-It is also possible to name backends at run-time as part of the connection
-string, in which case no backend-specific <code>#include</code> directive is necessary.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/transactions.md b/docs/transactions.md
new file mode 100644
index 0000000..fc25085
--- /dev/null
+++ b/docs/transactions.md
@@ -0,0 +1,45 @@
+# Transactions
+
+The SOCI library provides the following members of the `session` class for transaction management:
+
+* `void begin();`
+* `void commit();`
+* `void rollback();`
+
+In addition to the above there is a RAII wrapper that allows to associate the transaction with the given scope of code:
+
+```cpp
+class transaction
+{
+public:
+    explicit transaction(session & sql);
+
+    ~transaction();
+
+    void commit();
+    void rollback();
+
+private:
+    // ...
+};
+```
+
+The object of class `transaction` will roll back automatically when the object is destroyed
+(usually as a result of leaving the scope) *and* when the transaction was not explicitly committed before that.
+
+A typical usage pattern for this class might be:
+
+```cpp
+{
+    transaction tr(sql);
+
+    sql << "insert into ...";
+    sql << "more sql queries ...";
+    // ...
+
+    tr.commit();
+}
+```
+
+With the above pattern the transaction is committed only when the code successfully reaches the end of block.
+If some exception is thrown before that, the scope will be left without reaching the final statement and the transaction object will automatically roll back in its destructor.
diff --git a/docs/transactions/index.html b/docs/transactions/index.html
deleted file mode 100644
index c2f3f13..0000000
--- a/docs/transactions/index.html
+++ /dev/null
@@ -1,376 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Transactions - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../statements/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../procedures/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/transactions.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#transactions" class="nav-link">Transactions</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="transactions">Transactions</h1>
-<p>The SOCI library provides the following members of the <code>session</code> class for transaction management:</p>
-<ul>
-<li><code>void begin();</code></li>
-<li><code>void commit();</code></li>
-<li><code>void rollback();</code></li>
-</ul>
-<p>In addition to the above there is a RAII wrapper that allows to associate the transaction with the given scope of code:</p>
-<pre><code class="language-cpp">class transaction
-{
-public:
-    explicit transaction(session &amp; sql);
-
-    ~transaction();
-
-    void commit();
-    void rollback();
-
-private:
-    // ...
-};
-</code></pre>
-<p>The object of class <code>transaction</code> will roll back automatically when the object is destroyed
-(usually as a result of leaving the scope) <em>and</em> when the transaction was not explicitly committed before that.</p>
-<p>A typical usage pattern for this class might be:</p>
-<pre><code class="language-cpp">{
-    transaction tr(sql);
-
-    sql &lt;&lt; &quot;insert into ...&quot;;
-    sql &lt;&lt; &quot;more sql queries ...&quot;;
-    // ...
-
-    tr.commit();
-}
-</code></pre>
-<p>With the above pattern the transaction is committed only when the code successfully reaches the end of block.
-If some exception is thrown before that, the scope will be left without reaching the final statement and the transaction object will automatically roll back in its destructor.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/types.md b/docs/types.md
new file mode 100644
index 0000000..201fea4
--- /dev/null
+++ b/docs/types.md
@@ -0,0 +1,292 @@
+# Data Types
+
+## Static binding
+
+The static binding for types is most useful when the types used in the database are known at compile time - this was already presented above with the help of `into` and `use` functions.
+
+The following types are currently supported for use with `into` and `use` expressions:
+
+* `char` (for character values)
+* `short`, `int`, `unsigned long`, `long long`, `double` (for numeric values)
+* `std::string` (for string values)
+* `std::tm` (for datetime values)
+* `soci::statement` (for nested statements and PL/SQL cursors)
+* `soci::blob` (for Binary Large OBjects)
+* `soci::row_id` (for row identifiers)
+
+See the test code that accompanies the library to see how each of these types is used.
+
+### Static binding for bulk operations
+
+Bulk inserts, updates, and selects are supported through the following `std::vector` based into and use types:
+
+* `std::vector<char>`
+* `std::vector<short>`
+* `std::vector<int>`
+* `std::vector<unsigned long>`
+* `std::vector<long long>`
+* `std::vector<double>`
+* `std::vector<std::string>`
+* `std::vector<std::tm>`
+
+Use of the vector based types mirrors that of the standard types, with the size of the vector used to specify the number of records to process at a time.
+See below for examples.
+
+Bulk operations are supported also for `std::vector`s of the user-provided types that have appropriate conversion routines defines.
+
+## Dynamic binding
+
+For certain applications it is desirable to be able to select data from arbitrarily structured tables (e.g. via "`select * from ...`") and format the resulting data based upon its type.
+
+SOCI supports binding dynamic resultset through the `soci::row` and `soci::column_properties` classes.
+
+Data is selected into a `row` object, which holds `column_properties` objects describing the attributes of data contained in each column.
+Once the data type for each column is known, the data can be formatted appropriately.
+
+For example, the code below creates an XML document from a selected row of data from an arbitrary table:
+
+```cpp
+row r;
+sql << "select * from some_table", into(r);
+
+std::ostringstream doc;
+doc << "<row>" << std::endl;
+for(std::size_t i = 0; i != r.size(); ++i)
+{
+    const column_properties & props = r.get_properties(i);
+
+    doc << '<' << props.get_name() << '>';
+
+    switch(props.get_data_type())
+    {
+    case dt_string:
+        doc << r.get<std::string>(i);
+        break;
+    case dt_double:
+        doc << r.get<double>(i);
+        break;
+    case dt_integer:
+        doc << r.get<int>(i);
+        break;
+    case dt_long_long:
+        doc << r.get<long long>(i);
+        break;
+    case dt_unsigned_long_long:
+        doc << r.get<unsigned long long>(i);
+        break;
+    case dt_date:
+        std::tm when = r.get<std::tm>(i);
+        doc << asctime(&when);
+        break;
+    }
+
+    doc << "</" << props.get_name() << '>' << std::endl;
+}
+doc << "</row>";
+```
+
+The type `T` parameter that should be passed to `row::get<T>()` depends on the SOCI data type that is returned from `column_properties::get_data_type()`.
+
+`row::get<T>()` throws an exception of type `std::bad_cast` if an incorrect type `T` is requested.
+
+| SOCI Data Type | `row::get<T>` specialization |
+|----------------|------------------------------|
+| `dt_double`    | `double`                     |
+| `dt_integer`   | `int`                        |
+| `dt_long_long` | `long long`                  |
+| `dt_unsigned_long_long` | `unsigned long long`|
+| `dt_string`    | `std::string`                |
+| `dt_date`      | `std::tm`                    |
+
+The mapping of underlying database column types to SOCI datatypes is database specific.
+See the [backend documentation](backends/index.md) for details.
+
+The `row` also provides access to indicators for each column:
+
+```cpp
+row r;
+sql << "select name from some_table where id = 1", into(r);
+if (r.get_indicator(0) != soci::i_null)
+{
+    std::cout << r.get<std::string>(0);
+}
+```
+
+It is also possible to extract data from the `row` object using its stream-like interface, where each extracted variable should have matching type respective to its position in the chain:
+
+```cpp
+row r;
+sql << "select name, address, age from persons where id = 123", into(r);
+
+string name, address;
+int age;
+
+r >> name >> address >> age;
+```
+
+Note, however, that this interface is *not* compatible with the standard `std::istream` class and that it is only possible to extract a single row at a time - for "safety" reasons the row boundary is preserved and it is necessary to perform the `fetch` operation explicitly for each consecutive row.
+
+## User-defined C++ types
+
+SOCI can be easily extended with support for user-defined datatypes.
+
+The extension mechanism relies on appropriate specialization of the `type_conversion` structure that converts to and from one of the following SOCI base types:
+
+* `double`
+* `int`
+* `long long`
+* `unsigned long long`
+* `std::string`
+* `char`
+* `std::tm`
+
+There are three required class members for a valid `type_conversion` specialization:
+
+* the `base_type` type definition, aliasing either one of the base types *or another user-defined type*
+* the `from_base()` static member function, converting from the base type
+* the `to_base()` static member function, converting to the base type
+
+Note that no database-specific code is required to define user conversion.
+
+The following example shows how the user can extend SOCI to support his own type `MyInt`, which here is some wrapper for the fundamental `int` type:
+
+```cpp
+class MyInt
+{
+public:
+    MyInt() {}
+    MyInt(int i) : i_(i) {}
+
+    void set(int i) { i_ = i; }
+    int get() const { return i_; }
+
+private:
+    int i_;
+};
+
+namespace soci
+{
+    template <>
+    struct type_conversion<MyInt>
+    {
+        typedef int base_type;
+
+        static void from_base(int i, indicator ind, MyInt & mi)
+        {
+            if (ind == i_null)
+            {
+                throw soci_error("Null value not allowed for this type");
+            }
+
+            mi.set(i);
+        }
+
+        static void to_base(const MyInt & mi, int & i, indicator & ind)
+        {
+            i = mi.get();
+            ind = i_ok;
+        }
+    };
+}
+```
+
+The above specialization for `soci::type_conversion<MyInt>` is enough to enable the following:
+
+```cpp
+MyInt i;
+
+sql << "select count(*) from person", into(i);
+
+cout << "We have " << i.get() << " persons in the database.\n";
+```
+
+Note that there is a number of types from the Boost library integrated with SOCI out of the box, see [Integration with Boost](boost.md) for complete description. Use these as examples of conversions for more complext data types.
+
+Another possibility to extend SOCI with custom data types is to use the `into_type<T>` and `use_type<T>` class templates, which specializations can be user-provided. These specializations need to implement the interface defined by, respectively, the `into_type_base` and `use_type_base`
+classes.
+
+Note that when specializing these template classes the only convention is that when the indicator
+variable is used (see below), it should appear in the second position. Please refer to the library source code to see how this is done for the standard types.
+
+## Object-Relational Mapping
+
+SOCI provides a class called `values` specifically to enable object-relational mapping via `type_conversion` specializations.
+
+For example, the following code maps a `Person` object to and from a database table containing columns `"ID"`, `"FIRST_NAME"`, `"LAST_NAME"`, and `"GENDER"`.
+
+Note that the mapping is non-invasive - the `Person` object itself does not contain any SOCI-specific code:
+
+```cpp
+struct Person
+{
+    int id;
+    std::string firstName;
+    std::string lastName;
+    std::string gender;
+};
+
+namespace soci
+{
+    template<>
+    struct type_conversion<Person>
+    {
+        typedef values base_type;
+
+        static void from_base(values const & v, indicator /* ind */, Person & p)
+        {
+            p.id = v.get<int>("ID");
+            p.firstName = v.get<std::string>("FIRST_NAME");
+            p.lastName = v.get<std::string>("LAST_NAME");
+
+            // p.gender will be set to the default value "unknown"
+            // when the column is null:
+            p.gender = v.get<std::string>("GENDER", "unknown");
+
+            // alternatively, the indicator can be tested directly:
+            // if (v.indicator("GENDER") == i_null)
+            // {
+            //     p.gender = "unknown";
+            // }
+            // else
+            // {
+            //     p.gender = v.get<std::string>("GENDER");
+            // }
+        }
+
+        static void to_base(const Person & p, values & v, indicator & ind)
+        {
+            v.set("ID", p.id);
+            v.set("FIRST_NAME", p.firstName);
+            v.set("LAST_NAME", p.lastName);
+            v.set("GENDER", p.gender, p.gender.empty() ? i_null : i_ok);
+            ind = i_ok;
+        }
+    };
+}
+```
+
+With the above `type_conversion` specialization in place, it is possible to use `Person` directly with SOCI:
+
+```cpp
+session sql(oracle, "service=db1 user=scott password=tiger");
+
+Person p;
+p.id = 1;
+p.lastName = "Smith";
+p.firstName = "Pat";
+sql << "insert into person(id, first_name, last_name) "
+        "values(:ID, :FIRST_NAME, :LAST_NAME)", use(p);
+
+Person p1;
+sql << "select * from person", into(p1);
+assert(p1.id == 1);
+assert(p1.firstName + p.lastName == "PatSmith");
+assert(p1.gender == "unknown");
+
+p.firstName = "Patricia";
+sql << "update person set first_name = :FIRST_NAME "
+        "where id = :ID", use(p);
+```
+
+Note: The `values` class is currently not suited for use outside of `type_conversion`specializations.
+It is specially designed to facilitate object-relational mapping when used as shown above.
diff --git a/docs/types/index.html b/docs/types/index.html
deleted file mode 100644
index 9003ce0..0000000
--- a/docs/types/index.html
+++ /dev/null
@@ -1,627 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Data Types - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../indicators/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../lobs/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/types.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#data-types" class="nav-link">Data Types</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#static-binding" class="nav-link">Static binding</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#dynamic-binding" class="nav-link">Dynamic binding</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#user-defined-c-types" class="nav-link">User-defined C++ types</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#object-relational-mapping" class="nav-link">Object-Relational Mapping</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="data-types">Data Types</h1>
-<h2 id="static-binding">Static binding</h2>
-<p>The static binding for types is most useful when the types used in the database are known at compile time - this was already presented above with the help of <code>into</code> and <code>use</code> functions.</p>
-<p>The following types are currently supported for use with <code>into</code> and <code>use</code> expressions:</p>
-<ul>
-<li><code>char</code> (for character values)</li>
-<li><code>short</code>, <code>int</code>, <code>unsigned long</code>, <code>long long</code>, <code>double</code> (for numeric values)</li>
-<li><code>std::string</code> (for string values)</li>
-<li><code>std::tm</code> (for datetime values)</li>
-<li><code>soci::statement</code> (for nested statements and PL/SQL cursors)</li>
-<li><code>soci::blob</code> (for Binary Large OBjects)</li>
-<li><code>soci::row_id</code> (for row identifiers)</li>
-</ul>
-<p>See the test code that accompanies the library to see how each of these types is used.</p>
-<h3 id="static-binding-for-bulk-operations">Static binding for bulk operations</h3>
-<p>Bulk inserts, updates, and selects are supported through the following <code>std::vector</code> based into and use types:</p>
-<ul>
-<li><code>std::vector&lt;char&gt;</code></li>
-<li><code>std::vector&lt;short&gt;</code></li>
-<li><code>std::vector&lt;int&gt;</code></li>
-<li><code>std::vector&lt;unsigned long&gt;</code></li>
-<li><code>std::vector&lt;long long&gt;</code></li>
-<li><code>std::vector&lt;double&gt;</code></li>
-<li><code>std::vector&lt;std::string&gt;</code></li>
-<li><code>std::vector&lt;std::tm&gt;</code></li>
-</ul>
-<p>Use of the vector based types mirrors that of the standard types, with the size of the vector used to specify the number of records to process at a time.
-See below for examples.</p>
-<p>Bulk operations are supported also for <code>std::vector</code>s of the user-provided types that have appropriate conversion routines defines.</p>
-<h2 id="dynamic-binding">Dynamic binding</h2>
-<p>For certain applications it is desirable to be able to select data from arbitrarily structured tables (e.g. via "<code>select * from ...</code>") and format the resulting data based upon its type.</p>
-<p>SOCI supports binding dynamic resultset through the <code>soci::row</code> and <code>soci::column_properties</code> classes.</p>
-<p>Data is selected into a <code>row</code> object, which holds <code>column_properties</code> objects describing the attributes of data contained in each column.
-Once the data type for each column is known, the data can be formatted appropriately.</p>
-<p>For example, the code below creates an XML document from a selected row of data from an arbitrary table:</p>
-<pre><code class="language-cpp">row r;
-sql &lt;&lt; &quot;select * from some_table&quot;, into(r);
-
-std::ostringstream doc;
-doc &lt;&lt; &quot;&lt;row&gt;&quot; &lt;&lt; std::endl;
-for(std::size_t i = 0; i != r.size(); ++i)
-{
-    const column_properties &amp; props = r.get_properties(i);
-
-    doc &lt;&lt; '&lt;' &lt;&lt; props.get_name() &lt;&lt; '&gt;';
-
-    switch(props.get_data_type())
-    {
-    case dt_string:
-        doc &lt;&lt; r.get&lt;std::string&gt;(i);
-        break;
-    case dt_double:
-        doc &lt;&lt; r.get&lt;double&gt;(i);
-        break;
-    case dt_integer:
-        doc &lt;&lt; r.get&lt;int&gt;(i);
-        break;
-    case dt_long_long:
-        doc &lt;&lt; r.get&lt;long long&gt;(i);
-        break;
-    case dt_unsigned_long_long:
-        doc &lt;&lt; r.get&lt;unsigned long long&gt;(i);
-        break;
-    case dt_date:
-        std::tm when = r.get&lt;std::tm&gt;(i);
-        doc &lt;&lt; asctime(&amp;when);
-        break;
-    }
-
-    doc &lt;&lt; &quot;&lt;/&quot; &lt;&lt; props.get_name() &lt;&lt; '&gt;' &lt;&lt; std::endl;
-}
-doc &lt;&lt; &quot;&lt;/row&gt;&quot;;
-</code></pre>
-<p>The type <code>T</code> parameter that should be passed to <code>row::get&lt;T&gt;()</code> depends on the SOCI data type that is returned from <code>column_properties::get_data_type()</code>.</p>
-<p><code>row::get&lt;T&gt;()</code> throws an exception of type <code>std::bad_cast</code> if an incorrect type <code>T</code> is requested.</p>
-<table>
-<thead>
-<tr>
-<th>SOCI Data Type</th>
-<th><code>row::get&lt;T&gt;</code> specialization</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>dt_double</code></td>
-<td><code>double</code></td>
-</tr>
-<tr>
-<td><code>dt_integer</code></td>
-<td><code>int</code></td>
-</tr>
-<tr>
-<td><code>dt_long_long</code></td>
-<td><code>long long</code></td>
-</tr>
-<tr>
-<td><code>dt_unsigned_long_long</code></td>
-<td><code>unsigned long long</code></td>
-</tr>
-<tr>
-<td><code>dt_string</code></td>
-<td><code>std::string</code></td>
-</tr>
-<tr>
-<td><code>dt_date</code></td>
-<td><code>std::tm</code></td>
-</tr>
-</tbody>
-</table>
-<p>The mapping of underlying database column types to SOCI datatypes is database specific.
-See the <a href="../backends/">backend documentation</a> for details.</p>
-<p>The <code>row</code> also provides access to indicators for each column:</p>
-<pre><code class="language-cpp">row r;
-sql &lt;&lt; &quot;select name from some_table where id = 1&quot;, into(r);
-if (r.get_indicator(0) != soci::i_null)
-{
-    std::cout &lt;&lt; r.get&lt;std::string&gt;(0);
-}
-</code></pre>
-<p>It is also possible to extract data from the <code>row</code> object using its stream-like interface, where each extracted variable should have matching type respective to its position in the chain:</p>
-<pre><code class="language-cpp">row r;
-sql &lt;&lt; &quot;select name, address, age from persons where id = 123&quot;, into(r);
-
-string name, address;
-int age;
-
-r &gt;&gt; name &gt;&gt; address &gt;&gt; age;
-</code></pre>
-<p>Note, however, that this interface is <em>not</em> compatible with the standard <code>std::istream</code> class and that it is only possible to extract a single row at a time - for "safety" reasons the row boundary is preserved and it is necessary to perform the <code>fetch</code> operation explicitly for each consecutive row.</p>
-<h2 id="user-defined-c-types">User-defined C++ types</h2>
-<p>SOCI can be easily extended with support for user-defined datatypes.</p>
-<p>The extension mechanism relies on appropriate specialization of the <code>type_conversion</code> structure that converts to and from one of the following SOCI base types:</p>
-<ul>
-<li><code>double</code></li>
-<li><code>int</code></li>
-<li><code>long long</code></li>
-<li><code>unsigned long long</code></li>
-<li><code>std::string</code></li>
-<li><code>char</code></li>
-<li><code>std::tm</code></li>
-</ul>
-<p>There are three required class members for a valid <code>type_conversion</code> specialization:</p>
-<ul>
-<li>the <code>base_type</code> type definition, aliasing either one of the base types <em>or another ser-defined type</em></li>
-<li>the <code>from_base()</code> static member function, converting from the base type</li>
-<li>the <code>to_base()</code> static member function, converting to the base type</li>
-</ul>
-<p>Note that no database-specific code is required to define user conversion.</p>
-<p>The following example shows how the user can extend SOCI to support his own type <code>MyInt</code>, which here is some wrapper for the fundamental <code>int</code> type:</p>
-<pre><code class="language-cpp">class MyInt
-{
-public:
-    MyInt() {}
-    MyInt(int i) : i_(i) {}
-
-    void set(int i) { i_ = i; }
-    int get() const { return i_; }
-
-private:
-    int i_;
-};
-
-namespace soci
-{
-    template &lt;&gt;
-    struct type_conversion&lt;MyInt&gt;
-    {
-        typedef int base_type;
-
-        static void from_base(int i, indicator ind, MyInt &amp; mi)
-        {
-            if (ind == i_null)
-            {
-                throw soci_error(&quot;Null value not allowed for this type&quot;);
-            }
-
-            mi.set(i);
-        }
-
-        static void to_base(const MyInt &amp; mi, int &amp; i, indicator &amp; ind)
-        {
-            i = mi.get();
-            ind = i_ok;
-        }
-    };
-}
-</code></pre>
-<p>The above specialization for <code>soci::type_conversion&lt;MyInt&gt;</code> is enough to enable the following:</p>
-<pre><code class="language-cpp">MyInt i;
-
-sql &lt;&lt; &quot;select count(*) from person&quot;, into(i);
-
-cout &lt;&lt; &quot;We have &quot; &lt;&lt; i.get() &lt;&lt; &quot; persons in the database.\n&quot;;
-</code></pre>
-<p>Note that there is a number of types from the Boost library integrated with SOCI out of the box, see <a href="../boost/">Integration with Boost</a> for complete description. Use these as examples of conversions for more complext data types.</p>
-<p>Another possibility to extend SOCI with custom data types is to use the <code>into_type&lt;T&gt;</code> and <code>use_type&lt;T&gt;</code> class templates, which specializations can be user-provided. These specializations need to implement the interface defined by, respectively, the <code>into_type_base</code> and <code>use_type_base</code>
-classes.</p>
-<p>Note that when specializing these template classes the only convention is that when the indicator
-variable is used (see below), it should appear in the second position. Please refer to the library source code to see how this is done for the standard types.</p>
-<h2 id="object-relational-mapping">Object-Relational Mapping</h2>
-<p>SOCI provides a class called <code>values</code> specifically to enable object-relational mapping via <code>type_conversion</code> specializations.</p>
-<p>For example, the following code maps a <code>Person</code> object to and from a database table containing columns <code>"ID"</code>, <code>"FIRST_NAME"</code>, <code>"LAST_NAME"</code>, and <code>"GENDER"</code>.</p>
-<p>Note that the mapping is non-invasive - the <code>Person</code> object itself does not contain any SOCI-specific code:</p>
-<pre><code class="language-cpp">struct Person
-{
-    int id;
-    std::string firstName;
-    std::string lastName;
-    std::string gender;
-};
-
-namespace soci
-{
-    template&lt;&gt;
-    struct type_conversion&lt;Person&gt;
-    {
-        typedef values base_type;
-
-        static void from_base(values const &amp; v, indicator /* ind */, Person &amp; p)
-        {
-            p.id = v.get&lt;int&gt;(&quot;ID&quot;);
-            p.firstName = v.get&lt;std::string&gt;(&quot;FIRST_NAME&quot;);
-            p.lastName = v.get&lt;std::string&gt;(&quot;LAST_NAME&quot;);
-
-            // p.gender will be set to the default value &quot;unknown&quot;
-            // when the column is null:
-            p.gender = v.get&lt;std::string&gt;(&quot;GENDER&quot;, &quot;unknown&quot;);
-
-            // alternatively, the indicator can be tested directly:
-            // if (v.indicator(&quot;GENDER&quot;) == i_null)
-            // {
-            //     p.gender = &quot;unknown&quot;;
-            // }
-            // else
-            // {
-            //     p.gender = v.get&lt;std::string&gt;(&quot;GENDER&quot;);
-            // }
-        }
-
-        static void to_base(const Person &amp; p, values &amp; v, indicator &amp; ind)
-        {
-            v.set(&quot;ID&quot;, p.id);
-            v.set(&quot;FIRST_NAME&quot;, p.firstName);
-            v.set(&quot;LAST_NAME&quot;, p.lastName);
-            v.set(&quot;GENDER&quot;, p.gender, p.gender.empty() ? i_null : i_ok);
-            ind = i_ok;
-        }
-    };
-}
-</code></pre>
-<p>With the above <code>type_conversion</code> specialization in place, it is possible to use <code>Person</code> directly with SOCI:</p>
-<pre><code class="language-cpp">session sql(oracle, &quot;service=db1 user=scott password=tiger&quot;);
-
-Person p;
-p.id = 1;
-p.lastName = &quot;Smith&quot;;
-p.firstName = &quot;Pat&quot;;
-sql &lt;&lt; &quot;insert into person(id, first_name, last_name) &quot;
-        &quot;values(:ID, :FIRST_NAME, :LAST_NAME)&quot;, use(p);
-
-Person p1;
-sql &lt;&lt; &quot;select * from person&quot;, into(p1);
-assert(p1.id == 1);
-assert(p1.firstName + p.lastName == &quot;PatSmith&quot;);
-assert(p1.gender == &quot;unknown&quot;);
-
-p.firstName = &quot;Patricia&quot;;
-sql &lt;&lt; &quot;update person set first_name = :FIRST_NAME &quot;
-        &quot;where id = :ID&quot;, use(p);
-</code></pre>
-<p>Note: The <code>values</code> class is currently not suited for use outside of <code>type_conversion</code>specializations.
-It is specially designed to facilitate object-relational mapping when used as shown above.</p></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/utilities.md b/docs/utilities.md
new file mode 100644
index 0000000..110f0e1
--- /dev/null
+++ b/docs/utilities.md
@@ -0,0 +1,151 @@
+# Utilities
+
+SOCI provides a portable abstraction for selection of database queries.
+
+## DDL
+
+SOCI supports some basic methods to construct portable DDL queries. That is, instead of writing explicit SQL statement for creating or modifying tables, it is possible to use dedicated SOCI functions, which prepare appropriate DDL statements behind the scenes, thus enabling the user application to create basic database structures in a way that is portable across different database servers. Note that the actual support for these functions depends on the actual backend implementation.
+
+It is possible to create a new table in a single statement:
+
+```cpp
+sql.create_table("t1").column("i", soci::dt_integer).column("j", soci::dt_integer);
+```
+
+Above, table "t1" will be created with two columns ("i", "j") of type integer.
+
+It is also possible to build similar statements piece by piece, which is useful if the table structure is computed dynamically:
+
+```cpp
+{
+    soci::ddl_type ddl = sql.create_table("t2");
+    ddl.column("i", soci::dt_integer);
+    ddl.column("j", soci::dt_integer);
+    ddl.column("k", soci::dt_integer)("not null");
+    ddl.primary_key("t2_pk", "j");
+}
+```
+
+The actual statement is executed at the end of above block, when the ddl object goes out of scope. The "not null" constraint was added to the definition of column "k" explicitly and in fact any piece of SQL can be inserted this way - with the obvious caveat of having limited portability (the "not null" piece seems to be universaly portable).
+
+Columns can be added to and dropped from already existing tables as well:
+
+```cpp
+sql.add_column("t1", "k", soci::dt_integer);
+// or with constraint:
+//sql.add_column("t1", "k", soci::dt_integer)("not null");
+
+sql.drop_column("t1", "i");
+```
+
+If needed, precision and scale can be defined with additional integer arguments to functions that create columns:
+
+```cpp
+sql.add_column("t1", "s", soci::dt_string, precision);
+sql.add_column("t1", "d", soci::dt_double, precision, scale);
+```
+
+Tables with foreign keys to each other can be also created:
+
+```cpp
+{
+    soci::ddl_type ddl = sql.create_table("t3");
+    ddl.column("x", soci::dt_integer);
+    ddl.column("y", soci::dt_integer);
+    ddl.foreign_key("t3_fk", "x", "t2", "j");
+}
+```
+
+Tables can be dropped, too:
+
+```cpp
+sql.drop_table("t1");
+sql.drop_table("t3");
+sql.drop_table("t2");
+```
+
+Note that due to the differences in the set of types that are actually supported on the target database server, the type mappings, as well as precision and scales, might be different, even in the way that makes them impossible to portably recover with metadata queries.
+
+In the category of portability utilities, the following functions are also available:
+
+```cpp
+sql.empty_blob()
+```
+
+the above call returns the string containing expression that represents an empty BLOB value in the given target backend. This expression can be used as part of a bigger SQL statement, for example:
+
+```cpp
+sql << "insert into my_table (x) values (" + sql.empty_blob() + ")";
+```
+
+and:
+
+```cpp
+sql.nvl()
+```
+
+the above call returns the string containing the name of the SQL function that implements the NVL or COALESCE operation in the given target backend, for example:
+
+```cpp
+sql << "select name, " + sql.nvl() + "(phone, \'UNKNOWN\') from phone_book";
+```
+
+Note: `empty_blob` and `nvl` are implemented in Oracle, PostgreSQL and SQLite3 backends; for other backends their behaviour is as for PostgreSQL.
+
+## DML
+
+Only two related functions are currently available in this category:
+`get_dummy_from_clause()` can be used to construct select statements that don't
+operate on any table in a portable way, as while some databases allow simply
+omitting the from clause in this case, others -- e.g. Oracle -- still require
+providing some syntactically valid from clause even if it is not used. To use
+this function, simply append the result of this function to the statement:
+
+```cpp
+double databasePi;
+session << ("select 4*atan(1)" + session.get_dummy_from_clause()),
+            into(databasePi);
+```
+
+If just the name of the dummy table is needed, and not the full clause, you can
+use `get_dummy_from_table()` to obtain it.
+
+Notice that both functions require the session to be connected as their result
+depends on the database it is connected to.
+
+## Database Metadata
+
+It is possible to portably query the database server to obtain basic metadata information.
+
+In order to get the list of table names in the current schema:
+
+```cpp
+std::vector<std::string> names(100);
+sql.get_table_names(), into(names);
+```
+
+alternatively:
+
+```cpp
+std::string name;
+soci::statement st = (sql.prepare_table_names(), into(name));
+
+st.execute();
+while (st.fetch())
+{
+    // ...
+}
+```
+
+Similarly, to get the description of all columns in the given table:
+
+```cpp
+soci::column_info ci;
+soci::statement st = (sql.prepare_column_descriptions(table_name), into(ci));
+
+st.execute();
+while (st.fetch())
+{
+    // ci fields describe each column in turn
+}
+```
diff --git a/docs/utilities/index.html b/docs/utilities/index.html
deleted file mode 100644
index 83dcb40..0000000
--- a/docs/utilities/index.html
+++ /dev/null
@@ -1,448 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Utilities - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="../vagrant/" class="dropdown-item">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../boost/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../vagrant/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/utilities.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#utilities" class="nav-link">Utilities</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#ddl" class="nav-link">DDL</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#dml" class="nav-link">DML</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#database-metadata" class="nav-link">Database Metadata</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="utilities">Utilities</h1>
-<p>SOCI provides a portable abstraction for selection of database queries.</p>
-<h2 id="ddl">DDL</h2>
-<p>SOCI supports some basic methods to construct portable DDL queries. That is, instead of writing explicit SQL statement for creating or modifying tables, it is possible to use dedicated SOCI functions, which prepare appropriate DDL statements behind the scenes, thus enabling the user application to create basic database structures in a way that is portable across different database servers. Note that the actual support for these functions depends on the actual backend implementation.</p>
-<p>It is possible to create a new table in a single statement:</p>
-<pre><code class="language-cpp">sql.create_table(&quot;t1&quot;).column(&quot;i&quot;, soci::dt_integer).column(&quot;j&quot;, soci::dt_integer);
-</code></pre>
-<p>Above, table "t1" will be created with two columns ("i", "j") of type integer.</p>
-<p>It is also possible to build similar statements piece by piece, which is useful if the table structure is computed dynamically:</p>
-<pre><code class="language-cpp">{
-    soci::ddl_type ddl = sql.create_table(&quot;t2&quot;);
-    ddl.column(&quot;i&quot;, soci::dt_integer);
-    ddl.column(&quot;j&quot;, soci::dt_integer);
-    ddl.column(&quot;k&quot;, soci::dt_integer)(&quot;not null&quot;);
-    ddl.primary_key(&quot;t2_pk&quot;, &quot;j&quot;);
-}
-</code></pre>
-<p>The actual statement is executed at the end of above block, when the ddl object goes out of scope. The "not null" constraint was added to the definition of column "k" explicitly and in fact any piece of SQL can be inserted this way - with the obvious caveat of having limited portability (the "not null" piece seems to be universaly portable).</p>
-<p>Columns can be added to and dropped from already existing tables as well:</p>
-<pre><code class="language-cpp">sql.add_column(&quot;t1&quot;, &quot;k&quot;, soci::dt_integer);
-// or with constraint:
-//sql.add_column(&quot;t1&quot;, &quot;k&quot;, soci::dt_integer)(&quot;not null&quot;);
-
-sql.drop_column(&quot;t1&quot;, &quot;i&quot;);
-</code></pre>
-<p>If needed, precision and scale can be defined with additional integer arguments to functions that create columns:</p>
-<pre><code class="language-cpp">sql.add_column(&quot;t1&quot;, &quot;s&quot;, soci::dt_string, precision);
-sql.add_column(&quot;t1&quot;, &quot;d&quot;, soci::dt_double, precision, scale);
-</code></pre>
-<p>Tables with foreign keys to each other can be also created:</p>
-<pre><code class="language-cpp">{
-    soci::ddl_type ddl = sql.create_table(&quot;t3&quot;);
-    ddl.column(&quot;x&quot;, soci::dt_integer);
-    ddl.column(&quot;y&quot;, soci::dt_integer);
-    ddl.foreign_key(&quot;t3_fk&quot;, &quot;x&quot;, &quot;t2&quot;, &quot;j&quot;);
-}
-</code></pre>
-<p>Tables can be dropped, too:</p>
-<pre><code class="language-cpp">sql.drop_table(&quot;t1&quot;);
-sql.drop_table(&quot;t3&quot;);
-sql.drop_table(&quot;t2&quot;);
-</code></pre>
-<p>Note that due to the differences in the set of types that are actually supported on the target database server, the type mappings, as well as precision and scales, might be different, even in the way that makes them impossible to portably recover with metadata queries.</p>
-<p>In the category of portability utilities, the following functions are also available:</p>
-<pre><code class="language-cpp">sql.empty_blob()
-</code></pre>
-<p>the above call returns the string containing expression that represents an empty BLOB value in the given target backend. This expression can be used as part of a bigger SQL statement, for example:</p>
-<pre><code class="language-cpp">sql &lt;&lt; &quot;insert into my_table (x) values (&quot; + sql.empty_blob() + &quot;)&quot;;
-</code></pre>
-<p>and:</p>
-<pre><code class="language-cpp">sql.nvl()
-</code></pre>
-<p>the above call returns the string containing the name of the SQL function that implements the NVL or COALESCE operation in the given target backend, for example:</p>
-<pre><code class="language-cpp">sql &lt;&lt; &quot;select name, &quot; + sql.nvl() + &quot;(phone, \'UNKNOWN\') from phone_book&quot;;
-</code></pre>
-<p>Note: <code>empty_blob</code> and <code>nvl</code> are implemented in Oracle, PostgreSQL and SQLite3 backends; for other backends their behaviour is as for PostgreSQL.</p>
-<h2 id="dml">DML</h2>
-<p>Only two related functions are currently available in this category:
-<code>get_dummy_from_clause()</code> can be used to construct select statements that don't
-operate on any table in a portable way, as while some databases allow simply
-omitting the from clause in this case, others -- e.g. Oracle -- still require
-providing some syntactically valid from clause even if it is not used. To use
-this function, simply append the result of this function to the statement:</p>
-<pre><code class="language-cpp">double databasePi;
-session &lt;&lt; (&quot;select 4*atan(1)&quot; + session.get_dummy_from_clause()),
-            into(databasePi);
-</code></pre>
-<p>If just the name of the dummy table is needed, and not the full clause, you can
-use <code>get_dummy_from_table()</code> to obtain it.</p>
-<p>Notice that both functions require the session to be connected as their result
-depends on the database it is connected to.</p>
-<h2 id="database-metadata">Database Metadata</h2>
-<p>It is possible to portably query the database server to obtain basic metadata information.</p>
-<p>In order to get the list of table names in the current schema:</p>
-<pre><code class="language-cpp">std::vector&lt;std::string&gt; names(100);
-sql.get_table_names(), into(names);
-</code></pre>
-<p>alternatively:</p>
-<pre><code class="language-cpp">std::string name;
-soci::statement st = (sql.prepare_table_names(), into(name));
-
-st.execute();
-while (st.fetch())
-{
-    // ...
-}
-</code></pre>
-<p>Similarly, to get the description of all columns in the given table:</p>
-<pre><code class="language-cpp">soci::column_info ci;
-soci::statement st = (sql.prepare_column_descriptions(table_name), into(ci));
-
-st.execute();
-while (st.fetch())
-{
-    // ci fields describe each column in turn
-}
-</code></pre></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/docs/vagrant.md b/docs/vagrant.md
new file mode 100644
index 0000000..442a72b
--- /dev/null
+++ b/docs/vagrant.md
@@ -0,0 +1,125 @@
+# Vagrant SOCI
+
+[Vagrant](https://www.vagrantup.com/) used to build and provision
+virtual environments for **hassle-free** SOCI development.
+
+## Features
+
+* Ubuntu 14.04 (Trusty) virtual machine
+* Multi-machine set-up with three VMs: `soci`, `oracle`, `db2`.
+* Support networking between the configured machines.
+* `soci.vm`:
+  * hostname: `vmsoci.local`
+  * build essentials
+  * core dependencies
+  * backend dependencies
+  * FOSS databases installed with sample `soci` user and instance pre-configured
+  * during provision, automatically clones and builds SOCI from `master` branch.
+* `db2.vm`:
+  * hostname: `vmdb2.local`
+  * IBM DB2 Express-C 9.7 installed from [archive.canonical.com](http://archive.canonical.com) packages.
+* `oracle.vm`:
+  * *TODO*: provision with Oracle XE
+* SOCI local git repository (aka `$SOCI_HOME`) is automatically shared on host
+  and all guest machines.
+
+## Prerequisites
+
+* Speedy broadband, time and coffee.
+* Recommended 4GB or much more RAM (tested with 16GB only).
+
+### SOCI DB2 backend
+
+The `soci.vm` will be configured properly to build the DB2 backend only if
+it is provisioned with complete DB2 CLI client (libraries and headers).
+You need to download "IBM Data Server Driver Package (DS Driver)" manually
+and make it visible to Vagrant:
+
+1. Go to [IBM Data Server Client Packages](http://www-01.ibm.com/support/docview.wss?uid=swg21385217).
+2. Download "IBM Data Server Driver Package (DS Driver)".
+3. Copy the package to `${SOCI_HOME}/tmp` directory, on host machine.
+
+## Usage
+
+Below, simple and easy development workflow with Vagrant is outlined:
+
+* [Boot](https://docs.vagrantup.com/v2/getting-started/up.html)
+
+```console
+vagrant up
+```
+
+or boot VMs selectively:
+
+```console
+vagrant up {soci|db2}
+```
+
+First time you run it, be patient as Vagrant downloads VM box and
+provisions it installing all the necessary packages.
+
+* You can SSH into the machine
+
+```console
+vagrant ssh {soci|db2}
+```
+
+* Run git commands can either from host or VM `soci` (once connected via SSH)
+
+```console
+cd /vagrant # aka $SOCI_HOME
+git pull origin master
+```
+
+* You can edit source code on both, on host or VM `soci`.
+* For example, edit in your favourite editor on host machine, then build, run, test and debug on guest machine from command line.
+* Alternatively, edit and build on host machine using your favourite IDE, then test and debug connecting to DBs on guest machines via network.
+
+* Build on VM `soci`
+
+```console
+vagrant ssh soci
+cd /vagrant    # aka $SOCI_HOME
+cd soci-build  # aka $SOCI_BUILD
+make
+```
+
+You can also execute the `build.h` script provided to run CMake and make
+
+```console
+vagrant ssh soci
+cd $SOCI_BUILD
+/vagrant/scripts/vagrant/build.sh
+```
+
+* Debug, only on VM `soci`, for example, with gdb or remotely Visual Studio 2017.
+
+* [Teardown](https://docs.vagrantup.com/v2/getting-started/teardown.html)
+
+```console
+vagrant {suspend|halt|destroy} {soci|db2}
+```
+
+Check Vagrant [command-line interface](https://docs.vagrantup.com/v2/cli/index.html) for complete list of commands.
+
+### Environment variables
+
+All variables available to the `vagrant` user on the VMs are defined in and sourced from `/vagrant/scripts/vagrant/common.env`:
+
+* `SOCI_HOME` where SOCI master is cloned (`/vagrant` on VM `soci`)
+* `SOCI_BUILD` where CMake generates build configuration (`/home/vagrant/soci-build` on VM `soci`)
+* `SOCI_HOST` network accessible VM `soci` hostname (`ping vmsoci.local`)
+* `SOCI_USER` default database user and database name
+* `SOCI_PASS` default database password for both, `SOCI_USER` and root/sysdba
+  of particular database.
+* `SOCI_DB2_HOST` network accessible VM `db2` hostname (`ping vmdb2.local`)
+* `SOCI_DB2_USER` admin username to DB2 instance.
+* `SOCI_DB2_USER` admin password to DB2 instance.
+
+Note, those variables are also used by provision scripts to set up databases.
+
+## Troubleshooting
+
+* Analyze `vagrant up` output.
+* On Windows, prefer `vagrant ssh` from inside MinGW Shell where  `ssh.exe` is available or learn how to use Vagrant with PuTTY.
+* If you modify any of `scripts/vagrant/*.sh` scripts, **ensure** they have unified end-of-line characters to `LF` only. Otherwise, provisioning steps may fail.
diff --git a/docs/vagrant/index.html b/docs/vagrant/index.html
deleted file mode 100644
index 830c456..0000000
--- a/docs/vagrant/index.html
+++ /dev/null
@@ -1,467 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <meta charset="utf-8">
-        <meta http-equiv="X-UA-Compatible" content="IE=edge">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        
-        
-        
-        <link rel="shortcut icon" href="../img/favicon.ico">
-        <title>Vagrant - SOCI (4.0.3)</title>
-        <link href="../css/bootstrap.min.css" rel="stylesheet">
-        <link href="../css/font-awesome.min.css" rel="stylesheet">
-        <link href="../css/base.css" rel="stylesheet">
-        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css">
-
-        <script src="../js/jquery-1.10.2.min.js" defer></script>
-        <script src="../js/bootstrap.min.js" defer></script>
-        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-        <script>hljs.initHighlightingOnLoad();</script> 
-    </head>
-
-    <body>
-        <div class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
-            <div class="container">
-                <a class="navbar-brand" href="..">SOCI (4.0.3)</a>
-                <!-- Expander button -->
-                <button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
-                    <span class="navbar-toggler-icon"></span>
-                </button>
-
-                <!-- Expanded navigation -->
-                <div id="navbar-collapse" class="navbar-collapse collapse">
-                        <!-- Main navigation -->
-                        <ul class="nav navbar-nav">
-                            <li class="navitem">
-                                <a href=".." class="nav-link">Home</a>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../quickstart/" class="dropdown-item">Getting Started</a>
-</li>
-                                    
-<li>
-    <a href="../installation/" class="dropdown-item">Installation</a>
-</li>
-                                    
-<li>
-    <a href="../structure/" class="dropdown-item">Library Structure</a>
-</li>
-                                    
-<li>
-    <a href="../license/" class="dropdown-item">License</a>
-</li>
-                                    
-<li>
-    <a href="../faq/" class="dropdown-item">FAQ</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../connections/" class="dropdown-item">Connections</a>
-</li>
-                                    
-<li>
-    <a href="../queries/" class="dropdown-item">Queries</a>
-</li>
-                                    
-<li>
-    <a href="../binding/" class="dropdown-item">Data Binding</a>
-</li>
-                                    
-<li>
-    <a href="../indicators/" class="dropdown-item">Data Indicators</a>
-</li>
-                                    
-<li>
-    <a href="../types/" class="dropdown-item">Data Types</a>
-</li>
-                                    
-<li>
-    <a href="../lobs/" class="dropdown-item">LOBs</a>
-</li>
-                                    
-<li>
-    <a href="../statements/" class="dropdown-item">Statements</a>
-</li>
-                                    
-<li>
-    <a href="../transactions/" class="dropdown-item">Transactions</a>
-</li>
-                                    
-<li>
-    <a href="../procedures/" class="dropdown-item">Procedures</a>
-</li>
-                                    
-<li>
-    <a href="../errors/" class="dropdown-item">Errors</a>
-</li>
-                                    
-<li>
-    <a href="../logging/" class="dropdown-item">Logging</a>
-</li>
-                                    
-<li>
-    <a href="../interfaces/" class="dropdown-item">Interfaces</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Backends <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../backends/" class="dropdown-item">Features</a>
-</li>
-                                    
-<li>
-    <a href="../backends/db2/" class="dropdown-item">DB2</a>
-</li>
-                                    
-<li>
-    <a href="../backends/firebird/" class="dropdown-item">Firebird</a>
-</li>
-                                    
-<li>
-    <a href="../backends/mysql/" class="dropdown-item">MySQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/odbc/" class="dropdown-item">ODBC</a>
-</li>
-                                    
-<li>
-    <a href="../backends/oracle/" class="dropdown-item">Oracle</a>
-</li>
-                                    
-<li>
-    <a href="../backends/postgresql/" class="dropdown-item">PostgreSQL</a>
-</li>
-                                    
-<li>
-    <a href="../backends/sqlite3/" class="dropdown-item">SQLite3</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown active">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Miscellaneous <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../beyond/" class="dropdown-item">Beyond SQL</a>
-</li>
-                                    
-<li>
-    <a href="../multithreading/" class="dropdown-item">Multi-threading</a>
-</li>
-                                    
-<li>
-    <a href="../boost/" class="dropdown-item">Boost</a>
-</li>
-                                    
-<li>
-    <a href="../utilities/" class="dropdown-item">Utilities</a>
-</li>
-                                    
-<li>
-    <a href="./" class="dropdown-item active">Vagrant</a>
-</li>
-                                </ul>
-                            </li>
-                            <li class="dropdown">
-                                <a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">API <b class="caret"></b></a>
-                                <ul class="dropdown-menu">
-                                    
-<li>
-    <a href="../api/client/" class="dropdown-item">Client API</a>
-</li>
-                                    
-<li>
-    <a href="../api/backend/" class="dropdown-item">Backend API</a>
-</li>
-                                    
-  <li class="dropdown-submenu">
-    <a href="#" class="dropdown-item">Ada</a>
-    <ul class="dropdown-menu">
-            
-<li>
-    <a href="../languages/ada/" class="dropdown-item">Ada Bindings</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/concepts/" class="dropdown-item">Ada Concepts</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/idioms/" class="dropdown-item">Ada Idioms</a>
-</li>
-            
-<li>
-    <a href="../languages/ada/reference/" class="dropdown-item">Ada API Reference</a>
-</li>
-    </ul>
-  </li>
-                                </ul>
-                            </li>
-                        </ul>
-
-                    <ul class="nav navbar-nav ml-auto">
-                        <li class="nav-item">
-                            <a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
-                                <i class="fa fa-search"></i> Search
-                            </a>
-                        </li>
-                            <li class="nav-item">
-                                <a rel="prev" href="../utilities/" class="nav-link">
-                                    <i class="fa fa-arrow-left"></i> Previous
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a rel="next" href="../api/client/" class="nav-link">
-                                    Next <i class="fa fa-arrow-right"></i>
-                                </a>
-                            </li>
-                            <li class="nav-item">
-                                <a href="https://github.com/SOCI/soci/edit/master/docs/vagrant.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
-                            </li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-
-        <div class="container">
-            <div class="row">
-                    <div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
-    <div class="navbar-header">
-        <button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
-            <span class="fa fa-angle-down"></span>
-        </button>
-    </div>
-
-    
-    <div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
-        <ul class="nav flex-column">
-            
-            <li class="nav-item" data-level="1"><a href="#vagrant-soci" class="nav-link">Vagrant SOCI</a>
-              <ul class="nav flex-column">
-            <li class="nav-item" data-level="2"><a href="#features" class="nav-link">Features</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#prerequisites" class="nav-link">Prerequisites</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#usage" class="nav-link">Usage</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-            <li class="nav-item" data-level="2"><a href="#troubleshooting" class="nav-link">Troubleshooting</a>
-              <ul class="nav flex-column">
-              </ul>
-            </li>
-              </ul>
-            </li>
-        </ul>
-    </div>
-</div></div>
-                    <div class="col-md-9" role="main">
-
-<h1 id="vagrant-soci">Vagrant SOCI</h1>
-<p><a href="https://www.vagrantup.com/">Vagrant</a> used to build and provision
-virtual environments for <strong>hassle-free</strong> SOCI development.</p>
-<h2 id="features">Features</h2>
-<ul>
-<li>Ubuntu 14.04 (Trusty) virtual machine</li>
-<li>Multi-machine set-up with three VMs: <code>soci</code>, <code>oracle</code>, <code>db2</code>.</li>
-<li>Support networking between the configured machines.</li>
-<li><code>soci.vm</code>:</li>
-<li>hostname: <code>vmsoci.local</code></li>
-<li>build essentials</li>
-<li>core dependencies</li>
-<li>backend dependencies</li>
-<li>FOSS databases installed with sample <code>soci</code> user and instance pre-configured</li>
-<li>during provision, automatically clones and builds SOCI from <code>master</code> branch.</li>
-<li><code>db2.vm</code>:</li>
-<li>hostname: <code>vmdb2.local</code></li>
-<li>IBM DB2 Express-C 9.7 installed from <a href="http://archive.canonical.com">archive.canonical.com</a> packages.</li>
-<li><code>oracle.vm</code>:</li>
-<li><em>TODO</em>: provision with Oracle XE</li>
-<li>SOCI local git repository (aka <code>$SOCI_HOME</code>) is automatically shared on host
-  and all guest machines.</li>
-</ul>
-<h2 id="prerequisites">Prerequisites</h2>
-<ul>
-<li>Speedy broadband, time and coffee.</li>
-<li>Recommended 4GB or much more RAM (tested with 16GB only).</li>
-</ul>
-<h3 id="soci-db2-backend">SOCI DB2 backend</h3>
-<p>The <code>soci.vm</code> will be configured properly to build the DB2 backend only if
-it is provisioned with complete DB2 CLI client (libraries and headers).
-You need to download "IBM Data Server Driver Package (DS Driver)" manually
-and make it visible to Vagrant:</p>
-<ol>
-<li>Go to <a href="http://www-01.ibm.com/support/docview.wss?uid=swg21385217">IBM Data Server Client Packages</a>.</li>
-<li>Download "IBM Data Server Driver Package (DS Driver)".</li>
-<li>Copy the package to <code>${SOCI_HOME}/tmp</code> directory, on host machine.</li>
-</ol>
-<h2 id="usage">Usage</h2>
-<p>Below, simple and easy development workflow with Vagrant is outlined:</p>
-<ul>
-<li><a href="https://docs.vagrantup.com/v2/getting-started/up.html">Boot</a></li>
-</ul>
-<pre><code class="language-console">vagrant up
-</code></pre>
-<p>or boot VMs selectively:</p>
-<pre><code class="language-console">vagrant up {soci|db2}
-</code></pre>
-<p>First time you run it, be patient as Vagrant downloads VM box and
-provisions it installing all the necessary packages.</p>
-<ul>
-<li>You can SSH into the machine</li>
-</ul>
-<pre><code class="language-console">vagrant ssh {soci|db2}
-</code></pre>
-<ul>
-<li>Run git commands can either from host or VM <code>soci</code> (once connected via SSH)</li>
-</ul>
-<pre><code class="language-console">cd /vagrant # aka $SOCI_HOME
-git pull origin master
-</code></pre>
-<ul>
-<li>You can edit source code on both, on host or VM <code>soci</code>.</li>
-<li>For example, edit in your favourite editor on host machine, then build, run, test and debug on guest machine from command line.</li>
-<li>
-<p>Alternatively, edit and build on host machine using your favourite IDE, then test and debug connecting to DBs on guest machines via network.</p>
-</li>
-<li>
-<p>Build on VM <code>soci</code></p>
-</li>
-</ul>
-<pre><code class="language-console">vagrant ssh soci
-cd /vagrant    # aka $SOCI_HOME
-cd soci-build  # aka $SOCI_BUILD
-make
-</code></pre>
-<p>You can also execute the <code>build.h</code> script provided to run CMake and make</p>
-<pre><code class="language-console">vagrant ssh soci
-cd $SOCI_BUILD
-/vagrant/scripts/vagrant/build.sh
-</code></pre>
-<ul>
-<li>
-<p>Debug, only on VM <code>soci</code>, for example, with gdb or remotely Visual Studio 2017.</p>
-</li>
-<li>
-<p><a href="https://docs.vagrantup.com/v2/getting-started/teardown.html">Teardown</a></p>
-</li>
-</ul>
-<pre><code class="language-console">vagrant {suspend|halt|destroy} {soci|db2}
-</code></pre>
-<p>Check Vagrant <a href="https://docs.vagrantup.com/v2/cli/index.html">command-line interface</a> for complete list of commands.</p>
-<h3 id="environment-variables">Environment variables</h3>
-<p>All variables available to the <code>vagrant</code> user on the VMs are defined in and sourced from <code>/vagrant/scripts/vagrant/common.env</code>:</p>
-<ul>
-<li><code>SOCI_HOME</code> where SOCI master is cloned (<code>/vagrant</code> on VM <code>soci</code>)</li>
-<li><code>SOCI_BUILD</code> where CMake generates build configuration (<code>/home/vagrant/soci-build</code> on VM <code>soci</code>)</li>
-<li><code>SOCI_HOST</code> network accessible VM <code>soci</code> hostname (<code>ping vmsoci.local</code>)</li>
-<li><code>SOCI_USER</code> default database user and database name</li>
-<li><code>SOCI_PASS</code> default database password for both, <code>SOCI_USER</code> and root/sysdba
-  of particular database.</li>
-<li><code>SOCI_DB2_HOST</code> network accessible VM <code>db2</code> hostname (<code>ping vmdb2.local</code>)</li>
-<li><code>SOCI_DB2_USER</code> admin username to DB2 instance.</li>
-<li><code>SOCI_DB2_USER</code> admin password to DB2 instance.</li>
-</ul>
-<p>Note, those variables are also used by provision scripts to set up databases.</p>
-<h2 id="troubleshooting">Troubleshooting</h2>
-<ul>
-<li>Analyze <code>vagrant up</code> output.</li>
-<li>On Windows, prefer <code>vagrant ssh</code> from inside MinGW Shell where  <code>ssh.exe</code> is available or learn how to use Vagrant with PuTTY.</li>
-<li>If you modify any of <code>scripts/vagrant/*.sh</code> scripts, <strong>ensure</strong> they have unified end-of-line characters to <code>LF</code> only. Otherwise, provisioning steps may fail.</li>
-</ul></div>
-            </div>
-        </div>
-
-        <footer class="col-md-12">
-            <hr>
-                <p>Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.</p>
-            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
-        </footer>
-        <script>
-            var base_url = "..",
-                shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
-        </script>
-        <script src="../js/base.js" defer></script>
-        <script src="../search/main.js" defer></script>
-
-        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
-    <div class="modal-dialog modal-lg">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="searchModalLabel">Search</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-                <p>From here you can search these documents. Enter your search terms below.</p>
-                <form>
-                    <div class="form-group">
-                        <input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
-                    </div>
-                </form>
-                <div id="mkdocs-search-results" data-no-results-text="No results found"></div>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <div class="modal-header">
-                <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
-                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
-            </div>
-            <div class="modal-body">
-              <table class="table">
-                <thead>
-                  <tr>
-                    <th style="width: 20%;">Keys</th>
-                    <th>Action</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  <tr>
-                    <td class="help shortcut"><kbd>?</kbd></td>
-                    <td>Open this help</td>
-                  </tr>
-                  <tr>
-                    <td class="next shortcut"><kbd>n</kbd></td>
-                    <td>Next page</td>
-                  </tr>
-                  <tr>
-                    <td class="prev shortcut"><kbd>p</kbd></td>
-                    <td>Previous page</td>
-                  </tr>
-                  <tr>
-                    <td class="search shortcut"><kbd>s</kbd></td>
-                    <td>Search</td>
-                  </tr>
-                </tbody>
-              </table>
-            </div>
-            <div class="modal-footer">
-            </div>
-        </div>
-    </div>
-</div>
-
-    </body>
-</html>
diff --git a/examples/connect/CMakeLists.txt b/examples/connect/CMakeLists.txt
new file mode 100644
index 0000000..c315cc9
--- /dev/null
+++ b/examples/connect/CMakeLists.txt
@@ -0,0 +1,26 @@
+#
+# Copyright (C) 2021 Vadim Zeitlin
+# Distributed under the Boost Software License, Version 1.0.
+# (See accompanying file LICENSE_1_0.txt or copy at
+# http://www.boost.org/LICENSE_1_0.txt)
+#
+
+# This is a very simple example of using SOCI in a CMake-based project.
+
+cmake_minimum_required(VERSION 2.8 FATAL_ERROR)
+
+project(SOCIExampleConnect)
+
+find_package(Soci REQUIRED)
+
+add_executable(connect connect.cpp)
+
+# Note that depending on the SOCI library automatically pulls in the required
+# SOCI compilation options too, i.e. there is no need to explicitly use
+# target_include_directories().
+#
+# Linking with just soci_core is enough when using shared libraries, as the
+# required backends will be loaded dynamically during run-time, but when using
+# static libraries you would need to link with all the soci_<backend> libraries
+# needed too.
+target_link_libraries(connect PRIVATE SOCI::soci_core)
diff --git a/examples/connect/connect.cpp b/examples/connect/connect.cpp
new file mode 100644
index 0000000..94917f6
--- /dev/null
+++ b/examples/connect/connect.cpp
@@ -0,0 +1,52 @@
+//
+// Copyright (C) 2021 Vadim Zeitlin
+// Distributed under the Boost Software License, Version 1.0.
+// (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+//
+//
+
+// This is the simplest possible example of using SOCI: just connect to the
+// database using the provided command line argument.
+
+#include <soci/soci.h>
+
+#include <cstdlib>
+#include <iostream>
+
+int main(int argc, char* argv[])
+{
+    if (argc != 2)
+    {
+        std::cerr << "usage: " << argv[0] << " <connection-string>\n";
+        return EXIT_FAILURE;
+    }
+
+    char const* const connectString = argv[1];
+
+    try
+    {
+        soci::session sql(connectString);
+
+        std::cout << "Successfully connected to \"" << connectString << "\", "
+                  << "using \"" << sql.get_backend_name() << "\" backend.\n";
+
+        return EXIT_SUCCESS;
+    }
+    catch (soci::soci_error const& e)
+    {
+        std::cerr << "Connection to \"" << connectString << "\" failed: "
+                  << e.what() << "\n";
+    }
+    catch (std::runtime_error const& e)
+    {
+        std::cerr << "Unexpected standard exception occurred: "
+                  << e.what() << "\n";
+    }
+    catch (...)
+    {
+        std::cerr << "Unexpected unknown exception occurred.\n";
+    }
+
+    return EXIT_FAILURE;
+}
diff --git a/examples/subdir-include/CMakeLists.txt b/examples/subdir-include/CMakeLists.txt
new file mode 100644
index 0000000..6861bc5
--- /dev/null
+++ b/examples/subdir-include/CMakeLists.txt
@@ -0,0 +1,29 @@
+# This is a very simple example of using SOCI in a CMake-based project
+# when placing SOCI in a subdirectory lib/soci/ of your project.
+# For this example, the SOCI backend called Empty is used.
+
+cmake_minimum_required(VERSION 2.8 FATAL_ERROR)
+
+project(SOCIExampleSubdirectoryInclude)
+
+set(SOCI_BINARY_DIR ${CMAKE_CURRENT_BINARY_DIR}/soci)
+
+# All compile options need to be set before the SOCI directory gets included.
+# The backend you want to use needs to be enabled here.
+option(SOCI_EMPTY "Build the sample backend called Empty" ON)
+
+# This line needs to be changed to include the directory you placed SOCI in, e.g.
+#  add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/lib/soci ${SOCI_BINARY_DIR})
+add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/../.. ${SOCI_BINARY_DIR})
+
+add_executable(subdir_include subdir-include.cpp)
+
+# Link the soci_<backend> libraries you want to use here.
+# There is no need to explicitly use target_include_directories() for the
+# main headers or the generated header (soci/soci-config.h), because both
+# are automatically added as part of the Soci::core target.
+target_link_libraries(subdir_include
+    PRIVATE
+        Soci::core
+        Soci::empty
+)
diff --git a/examples/subdir-include/lib/soci/README.md b/examples/subdir-include/lib/soci/README.md
new file mode 100644
index 0000000..9228168
--- /dev/null
+++ b/examples/subdir-include/lib/soci/README.md
@@ -0,0 +1,3 @@
+# Example of using SOCI with CMake
+
+For this example, we assume, that the whole SOCI repository is located in this repository.
diff --git a/examples/subdir-include/subdir-include.cpp b/examples/subdir-include/subdir-include.cpp
new file mode 100644
index 0000000..d50a786
--- /dev/null
+++ b/examples/subdir-include/subdir-include.cpp
@@ -0,0 +1,44 @@
+#include <soci/soci.h>
+#include <soci/empty/soci-empty.h>
+
+#include <cstdlib>
+#include <iostream>
+#include <stdexcept>
+#include <string>
+
+int main(int argc, char* argv[])
+{
+    if (argc != 2)
+    {
+        std::cerr << "usage: " << argv[0] << " <connection-string>\n";
+        return EXIT_FAILURE;
+    }
+
+    std::string connectString{argv[1]};
+
+    try
+    {
+        soci::session sql(soci::empty, connectString);
+
+        std::cout << "Successfully connected to \"" << connectString << "\", "
+                  << "using \"" << sql.get_backend_name() << "\" backend.\n";
+
+        return EXIT_SUCCESS;
+    }
+    catch (const soci::soci_error& e)
+    {
+        std::cerr << "Connection to \"" << connectString << "\" failed: "
+                  << e.what() << "\n";
+    }
+    catch (const std::runtime_error& e)
+    {
+        std::cerr << "Unexpected standard exception occurred: "
+                  << e.what() << "\n";
+    }
+    catch (...)
+    {
+        std::cerr << "Unexpected unknown exception occurred.\n";
+    }
+
+    return EXIT_FAILURE;
+}
diff --git a/include/private/firebird/common.h b/include/private/firebird/common.h
index 0eab81e..94468bf 100644
--- a/include/private/firebird/common.h
+++ b/include/private/firebird/common.h
@@ -235,7 +235,7 @@ T1 from_isc(XSQLVAR * var)
         }
     }
 
-    GCC_WARNING_SUPPRESS(cast-align)
+    SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
     switch (var->sqltype & ~1)
     {
@@ -253,7 +253,7 @@ T1 from_isc(XSQLVAR * var)
         throw soci_error("Incorrect data type for numeric conversion");
     }
 
-    GCC_WARNING_RESTORE(cast-align)
+    SOCI_GCC_WARNING_RESTORE(cast-align)
 }
 
 } // namespace firebird
diff --git a/include/private/soci-autostatement.h b/include/private/soci-autostatement.h
index ee69862..65e25c8 100644
--- a/include/private/soci-autostatement.h
+++ b/include/private/soci-autostatement.h
@@ -29,7 +29,7 @@ struct auto_statement : Backend
         this->alloc();
     }
 
-    ~auto_statement() SOCI_OVERRIDE
+    ~auto_statement() override
     {
         this->clean_up();
     }
diff --git a/include/private/soci-compiler.h b/include/private/soci-compiler.h
index 42e52b5..8d5f31f 100644
--- a/include/private/soci-compiler.h
+++ b/include/private/soci-compiler.h
@@ -10,14 +10,14 @@
 
 #include "soci-cpp.h"
 
-// CHECK_GCC(major,minor) evaluates to 1 when using g++ of at least this
+// SOCI_CHECK_GCC(major,minor) evaluates to 1 when using g++ of at least this
 // version or 0 when using g++ of lesser version or not using g++ at all.
 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
-#   define CHECK_GCC(major, minor) \
+#   define SOCI_CHECK_GCC(major, minor) \
         ((__GNUC__ > (major)) \
             || (__GNUC__ == (major) && __GNUC_MINOR__ >= (minor)))
 #else
-#   define CHECK_GCC(major, minor) 0
+#   define SOCI_CHECK_GCC(major, minor) 0
 #endif
 
 // GCC_WARNING_{SUPPRESS,RESTORE} macros can be used to bracket the code
@@ -25,15 +25,15 @@
 //
 // They only work with g++ 4.6+ or clang, warnings are not disabled for earlier
 // g++ versions.
-#if defined(__clang__) || CHECK_GCC(4, 6)
-#   define GCC_WARNING_SUPPRESS(x) \
+#if defined(__clang__) || SOCI_CHECK_GCC(4, 6)
+#   define SOCI_GCC_WARNING_SUPPRESS(x) \
         _Pragma (SOCI_STRINGIZE(GCC diagnostic push)) \
         _Pragma (SOCI_STRINGIZE(GCC diagnostic ignored SOCI_STRINGIZE(SOCI_CONCAT(-W,x))))
-#   define GCC_WARNING_RESTORE(x) \
+#   define SOCI_GCC_WARNING_RESTORE(x) \
         _Pragma (SOCI_STRINGIZE(GCC diagnostic pop))
 #else /* gcc < 4.6 or not gcc and not clang at all */
-#   define GCC_WARNING_SUPPRESS(x)
-#   define GCC_WARNING_RESTORE(x)
+#   define SOCI_GCC_WARNING_SUPPRESS(x)
+#   define SOCI_GCC_WARNING_RESTORE(x)
 #endif
 
 #endif // SOCI_PRIVATE_SOCI_COMPILER_H_INCLUDED
diff --git a/include/private/soci-static-assert.h b/include/private/soci-static-assert.h
deleted file mode 100644
index ecb79b2..0000000
--- a/include/private/soci-static-assert.h
+++ /dev/null
@@ -1,19 +0,0 @@
-//
-// Copyright (C) 2015 Vadim Zeitlin.
-// Distributed under the Boost Software License, Version 1.0.
-// (See accompanying file LICENSE_1_0.txt or copy at
-// http://www.boost.org/LICENSE_1_0.txt)
-//
-
-#ifndef SOCI_PRIVATE_STATIC_ASSERT_H_INCLUDED
-#define SOCI_PRIVATE_STATIC_ASSERT_H_INCLUDED
-
-#include "soci-cpp.h"
-
-// This is a simple approximation for C++11 static_assert: generate a
-// compile-time error if the given expression evaluates to 0 and make the
-// identifier (not string!) msg appear in the error message.
-#define SOCI_STATIC_ASSERT(expr) \
-    struct SOCI_MAKE_UNIQUE_NAME(SociAssert) { unsigned msg: expr; }
-
-#endif // SOCI_PRIVATE_STATIC_ASSERT_H_INCLUDED
diff --git a/include/soci/.type-wrappers.h.swp b/include/soci/.type-wrappers.h.swp
deleted file mode 100644
index e6f5e0b..0000000
Binary files a/include/soci/.type-wrappers.h.swp and /dev/null differ
diff --git a/include/soci/blob.h b/include/soci/blob.h
index 67c0a15..868ea81 100644
--- a/include/soci/blob.h
+++ b/include/soci/blob.h
@@ -11,6 +11,7 @@
 #include "soci/soci-platform.h"
 // std
 #include <cstddef>
+#include <memory>
 
 namespace soci
 {
@@ -29,9 +30,13 @@ public:
     explicit blob(session & s);
     ~blob();
 
+    blob(blob &&other) = default;
+    blob &operator=(blob &&other) = default;
+
     std::size_t get_len();
 
     // offset is backend-specific
+    [[deprecated("Use read_from_start instead")]]
     std::size_t read(std::size_t offset, char * buf, std::size_t toRead);
 
     // offset starts from 0
@@ -39,6 +44,7 @@ public:
         std::size_t offset = 0);
 
     // offset is backend-specific
+    [[deprecated("Use write_from_start instead")]]
     std::size_t write(std::size_t offset, char const * buf,
         std::size_t toWrite);
 
@@ -50,10 +56,12 @@ public:
 
     void trim(std::size_t newLen);
 
-    details::blob_backend * get_backend() { return backEnd_; }
+    details::blob_backend * get_backend() { return backEnd_.get(); }
 
 private:
-    details::blob_backend * backEnd_;
+    SOCI_NOT_COPYABLE(blob)
+
+    std::unique_ptr<details::blob_backend> backEnd_;
 };
 
 } // namespace soci
diff --git a/include/soci/db2/soci-db2.h b/include/soci/db2/soci-db2.h
index 524ad45..fcd326d 100644
--- a/include/soci/db2/soci-db2.h
+++ b/include/soci/db2/soci-db2.h
@@ -57,7 +57,7 @@ namespace soci
 class SOCI_DB2_DECL db2_soci_error : public soci_error {
 public:
     db2_soci_error(std::string const & msg, SQLRETURN rc) : soci_error(msg),errorCode(rc) {};
-    ~db2_soci_error() SOCI_NOEXCEPT SOCI_OVERRIDE { };
+    ~db2_soci_error() noexcept override { };
 
     //We have to extract error information before exception throwing, cause CLI handles could be broken at the construction time
     static const std::string sqlState(std::string const & msg,const SQLSMALLINT htype,const SQLHANDLE hndl);
@@ -79,12 +79,12 @@ struct SOCI_DB2_DECL db2_standard_into_type_backend : details::standard_into_typ
         : statement_(st),buf(NULL)
     {}
 
-    void define_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void define_by_pos(int& position, void* data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     db2_statement_backend& statement_;
 
@@ -102,15 +102,15 @@ struct SOCI_DB2_DECL db2_vector_into_type_backend : details::vector_into_type_ba
         : statement_(st),buf(NULL)
     {}
 
-    void define_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void define_by_pos(int& position, void* data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator* ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator* ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     db2_statement_backend& statement_;
 
@@ -131,13 +131,13 @@ struct SOCI_DB2_DECL db2_standard_use_type_backend : details::standard_use_type_
         : statement_(st),buf(NULL),ind(0)
     {}
 
-    void bind_by_pos(int& position, void* data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
-    void bind_by_name(std::string const& name, void* data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+    void bind_by_pos(int& position, void* data, details::exchange_type type, bool readOnly) override;
+    void bind_by_name(std::string const& name, void* data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const* ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator* ind) SOCI_OVERRIDE;
+    void pre_use(indicator const* ind) override;
+    void post_use(bool gotData, indicator* ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     db2_statement_backend& statement_;
 
@@ -156,14 +156,14 @@ struct SOCI_DB2_DECL db2_vector_use_type_backend : details::vector_use_type_back
     db2_vector_use_type_backend(db2_statement_backend &st)
         : statement_(st),buf(NULL) {}
 
-    void bind_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
-    void bind_by_name(std::string const& name, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void bind_by_pos(int& position, void* data, details::exchange_type type) override;
+    void bind_by_name(std::string const& name, void* data, details::exchange_type type) override;
 
-    void pre_use(indicator const* ind) SOCI_OVERRIDE;
+    void pre_use(indicator const* ind) override;
 
-    std::size_t size() SOCI_OVERRIDE;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     db2_statement_backend& statement_;
 
@@ -183,27 +183,27 @@ struct SOCI_DB2_DECL db2_statement_backend : details::statement_backend
 {
     db2_statement_backend(db2_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
-    void prepare(std::string const& query, details::statement_type eType) SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
+    void prepare(std::string const& query, details::statement_type eType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const& query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const& query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
-    void describe_column(int colNum, data_type& dtype, std::string& columnName) SOCI_OVERRIDE;
+    int prepare_for_describe() override;
+    void describe_column(int colNum, data_type& dtype, std::string& columnName) override;
     size_t column_size(int col);
 
-    db2_standard_into_type_backend* make_into_type_backend() SOCI_OVERRIDE;
-    db2_standard_use_type_backend* make_use_type_backend() SOCI_OVERRIDE;
-    db2_vector_into_type_backend* make_vector_into_type_backend() SOCI_OVERRIDE;
-    db2_vector_use_type_backend* make_vector_use_type_backend() SOCI_OVERRIDE;
+    db2_standard_into_type_backend* make_into_type_backend() override;
+    db2_standard_use_type_backend* make_use_type_backend() override;
+    db2_vector_into_type_backend* make_vector_into_type_backend() override;
+    db2_vector_use_type_backend* make_vector_use_type_backend() override;
 
     db2_session_backend& session_;
 
@@ -219,20 +219,20 @@ struct db2_rowid_backend : details::rowid_backend
 {
     db2_rowid_backend(db2_session_backend &session);
 
-    ~db2_rowid_backend() SOCI_OVERRIDE;
+    ~db2_rowid_backend() override;
 };
 
 struct db2_blob_backend : details::blob_backend
 {
     db2_blob_backend(db2_session_backend& session);
 
-    ~db2_blob_backend() SOCI_OVERRIDE;
+    ~db2_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
-    std::size_t read(std::size_t offset, char* buf, std::size_t toRead) SOCI_OVERRIDE;
-    std::size_t write(std::size_t offset, char const* buf, std::size_t toWrite) SOCI_OVERRIDE;
-    std::size_t append(char const* buf, std::size_t toWrite) SOCI_OVERRIDE;
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    std::size_t get_len() override;
+    std::size_t read_from_start(char* buf, std::size_t toRead, std::size_t offset = 0) override;
+    std::size_t write_from_start(char const* buf, std::size_t toWrite, std::size_t offset = 0) override;
+    std::size_t append(char const* buf, std::size_t toWrite) override;
+    void trim(std::size_t newLen) override;
 
     db2_session_backend& session_;
 };
@@ -241,23 +241,23 @@ struct db2_session_backend : details::session_backend
 {
     db2_session_backend(connection_parameters const& parameters);
 
-    ~db2_session_backend() SOCI_OVERRIDE;
+    ~db2_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE;
+    bool is_connected() override;
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return "sysibm.sysdummy1"; }
+    std::string get_dummy_from_table() const override { return "sysibm.sysdummy1"; }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "DB2"; }
+    std::string get_backend_name() const override { return "DB2"; }
 
     void clean_up();
 
-    db2_statement_backend* make_statement_backend() SOCI_OVERRIDE;
-    db2_rowid_backend* make_rowid_backend() SOCI_OVERRIDE;
-    db2_blob_backend* make_blob_backend() SOCI_OVERRIDE;
+    db2_statement_backend* make_statement_backend() override;
+    db2_rowid_backend* make_rowid_backend() override;
+    db2_blob_backend* make_blob_backend() override;
 
     void parseConnectString(std::string const &);
     void parseKeyVal(std::string const &);
@@ -274,7 +274,7 @@ struct SOCI_DB2_DECL db2_backend_factory : backend_factory
 {
     db2_backend_factory() {}
     db2_session_backend* make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_DB2_DECL db2_backend_factory const db2;
diff --git a/include/soci/empty/soci-empty.h b/include/soci/empty/soci-empty.h
index 51b99ef..eb58e85 100644
--- a/include/soci/empty/soci-empty.h
+++ b/include/soci/empty/soci-empty.h
@@ -32,12 +32,12 @@ struct SOCI_EMPTY_DECL empty_standard_into_type_backend : details::standard_into
         : statement_(st)
     {}
 
-    void define_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void define_by_pos(int& position, void* data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, bool calledFromFetch, indicator* ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     empty_statement_backend& statement_;
 };
@@ -48,15 +48,15 @@ struct SOCI_EMPTY_DECL empty_vector_into_type_backend : details::vector_into_typ
         : statement_(st)
     {}
 
-    void define_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void define_by_pos(int& position, void* data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator* ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator* ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     empty_statement_backend& statement_;
 };
@@ -67,13 +67,13 @@ struct SOCI_EMPTY_DECL empty_standard_use_type_backend : details::standard_use_t
         : statement_(st)
     {}
 
-    void bind_by_pos(int& position, void* data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
-    void bind_by_name(std::string const& name, void* data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+    void bind_by_pos(int& position, void* data, details::exchange_type type, bool readOnly) override;
+    void bind_by_name(std::string const& name, void* data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const* ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator* ind) SOCI_OVERRIDE;
+    void pre_use(indicator const* ind) override;
+    void post_use(bool gotData, indicator* ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     empty_statement_backend& statement_;
 };
@@ -83,14 +83,14 @@ struct SOCI_EMPTY_DECL empty_vector_use_type_backend : details::vector_use_type_
     empty_vector_use_type_backend(empty_statement_backend &st)
         : statement_(st) {}
 
-    void bind_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
-    void bind_by_name(std::string const& name, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void bind_by_pos(int& position, void* data, details::exchange_type type) override;
+    void bind_by_name(std::string const& name, void* data, details::exchange_type type) override;
 
-    void pre_use(indicator const* ind) SOCI_OVERRIDE;
+    void pre_use(indicator const* ind) override;
 
-    std::size_t size() SOCI_OVERRIDE;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     empty_statement_backend& statement_;
 };
@@ -100,26 +100,26 @@ struct SOCI_EMPTY_DECL empty_statement_backend : details::statement_backend
 {
     empty_statement_backend(empty_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
-    void prepare(std::string const& query, details::statement_type eType) SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
+    void prepare(std::string const& query, details::statement_type eType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const& query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const& query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
-    void describe_column(int colNum, data_type& dtype, std::string& columnName) SOCI_OVERRIDE;
+    int prepare_for_describe() override;
+    void describe_column(int colNum, data_type& dtype, std::string& columnName) override;
 
-    empty_standard_into_type_backend* make_into_type_backend() SOCI_OVERRIDE;
-    empty_standard_use_type_backend* make_use_type_backend() SOCI_OVERRIDE;
-    empty_vector_into_type_backend* make_vector_into_type_backend() SOCI_OVERRIDE;
-    empty_vector_use_type_backend* make_vector_use_type_backend() SOCI_OVERRIDE;
+    empty_standard_into_type_backend* make_into_type_backend() override;
+    empty_standard_use_type_backend* make_use_type_backend() override;
+    empty_vector_into_type_backend* make_vector_into_type_backend() override;
+    empty_vector_use_type_backend* make_vector_use_type_backend() override;
 
     empty_session_backend& session_;
 };
@@ -128,20 +128,23 @@ struct empty_rowid_backend : details::rowid_backend
 {
     empty_rowid_backend(empty_session_backend &session);
 
-    ~empty_rowid_backend() SOCI_OVERRIDE;
+    ~empty_rowid_backend() override;
 };
 
 struct empty_blob_backend : details::blob_backend
 {
     empty_blob_backend(empty_session_backend& session);
 
-    ~empty_blob_backend() SOCI_OVERRIDE;
+    ~empty_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
-    std::size_t read(std::size_t offset, char* buf, std::size_t toRead) SOCI_OVERRIDE;
-    std::size_t write(std::size_t offset, char const* buf, std::size_t toWrite) SOCI_OVERRIDE;
-    std::size_t append(char const* buf, std::size_t toWrite) SOCI_OVERRIDE;
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    std::size_t get_len() override;
+
+    std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0) override;
+
+    std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0) override;
+
+    std::size_t append(char const* buf, std::size_t toWrite) override;
+    void trim(std::size_t newLen) override;
 
     empty_session_backend& session_;
 };
@@ -150,29 +153,29 @@ struct empty_session_backend : details::session_backend
 {
     empty_session_backend(connection_parameters const& parameters);
 
-    ~empty_session_backend() SOCI_OVERRIDE;
+    ~empty_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE { return true; }
+    bool is_connected() override { return true; }
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return std::string(); }
+    std::string get_dummy_from_table() const override { return std::string(); }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "empty"; }
+    std::string get_backend_name() const override { return "empty"; }
 
     void clean_up();
 
-    empty_statement_backend* make_statement_backend() SOCI_OVERRIDE;
-    empty_rowid_backend* make_rowid_backend() SOCI_OVERRIDE;
-    empty_blob_backend* make_blob_backend() SOCI_OVERRIDE;
+    empty_statement_backend* make_statement_backend() override;
+    empty_rowid_backend* make_rowid_backend() override;
+    empty_blob_backend* make_blob_backend() override;
 };
 
 struct SOCI_EMPTY_DECL empty_backend_factory : backend_factory
 {
     empty_backend_factory() {}
-    empty_session_backend* make_session(connection_parameters const& parameters) const SOCI_OVERRIDE;
+    empty_session_backend* make_session(connection_parameters const& parameters) const override;
 };
 
 extern SOCI_EMPTY_DECL empty_backend_factory const empty;
diff --git a/include/soci/error.h b/include/soci/error.h
index bd6766b..8edf5c8 100644
--- a/include/soci/error.h
+++ b/include/soci/error.h
@@ -25,14 +25,14 @@ public:
     soci_error(soci_error const& e);
     soci_error& operator=(soci_error const& e);
 
-    ~soci_error() SOCI_NOEXCEPT SOCI_OVERRIDE;
+    ~soci_error() noexcept override;
 
     // Returns just the error message itself, without the context.
     std::string get_error_message() const;
 
     // Returns the full error message combining the message given to the ctor
     // with all the available context records.
-    char const* what() const SOCI_NOEXCEPT SOCI_OVERRIDE;
+    char const* what() const noexcept override;
 
     // This is used only by SOCI itself to provide more information about the
     // exception as it bubbles up. It can be called multiple times, with the
diff --git a/include/soci/firebird/soci-firebird.h b/include/soci/firebird/soci-firebird.h
index ca0ddcf..61bc767 100644
--- a/include/soci/firebird/soci-firebird.h
+++ b/include/soci/firebird/soci-firebird.h
@@ -41,7 +41,7 @@ public:
     firebird_soci_error(std::string const & msg,
         ISC_STATUS const * status = 0);
 
-    ~firebird_soci_error() SOCI_NOEXCEPT SOCI_OVERRIDE {};
+    ~firebird_soci_error() noexcept override {};
 
     std::vector<ISC_STATUS> status_;
 };
@@ -60,13 +60,13 @@ struct firebird_standard_into_type_backend : details::standard_into_type_backend
     {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
+    void pre_fetch() override;
     void post_fetch(bool gotData, bool calledFromFetch,
-        indicator *ind) SOCI_OVERRIDE;
+        indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     firebird_statement_backend &statement_;
     virtual void exchangeData();
@@ -86,15 +86,15 @@ struct firebird_vector_into_type_backend : details::vector_into_type_backend
     {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator *ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     firebird_statement_backend &statement_;
     virtual void exchangeData(std::size_t row);
@@ -115,14 +115,14 @@ struct firebird_standard_use_type_backend : details::standard_use_type_backend
     {}
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
+    void post_use(bool gotData, indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     firebird_statement_backend &statement_;
     virtual void exchangeData();
@@ -151,15 +151,15 @@ struct firebird_vector_use_type_backend : details::vector_use_type_backend
     {}
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
 
-    std::size_t size() SOCI_OVERRIDE;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     firebird_statement_backend &statement_;
     virtual void exchangeData(std::size_t row);
@@ -186,28 +186,28 @@ struct firebird_statement_backend : details::statement_backend
 {
     firebird_statement_backend(firebird_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
     void prepare(std::string const &query,
-        details::statement_type eType) SOCI_OVERRIDE;
+        details::statement_type eType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const &query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const &query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
+    int prepare_for_describe() override;
     void describe_column(int colNum, data_type &dtype,
-        std::string &columnName) SOCI_OVERRIDE;
+        std::string &columnName) override;
 
-    firebird_standard_into_type_backend * make_into_type_backend() SOCI_OVERRIDE;
-    firebird_standard_use_type_backend * make_use_type_backend() SOCI_OVERRIDE;
-    firebird_vector_into_type_backend * make_vector_into_type_backend() SOCI_OVERRIDE;
-    firebird_vector_use_type_backend * make_vector_use_type_backend() SOCI_OVERRIDE;
+    firebird_standard_into_type_backend * make_into_type_backend() override;
+    firebird_standard_use_type_backend * make_use_type_backend() override;
+    firebird_vector_into_type_backend * make_vector_into_type_backend() override;
+    firebird_vector_use_type_backend * make_vector_use_type_backend() override;
 
     firebird_session_backend &session_;
 
@@ -253,15 +253,16 @@ struct firebird_blob_backend : details::blob_backend
 {
     firebird_blob_backend(firebird_session_backend &session);
 
-    ~firebird_blob_backend() SOCI_OVERRIDE;
+    ~firebird_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
-    std::size_t read(std::size_t offset, char *buf,
-        std::size_t toRead) SOCI_OVERRIDE;
-    std::size_t write(std::size_t offset, char const *buf,
-        std::size_t toWrite) SOCI_OVERRIDE;
-    std::size_t append(char const *buf, std::size_t toWrite) SOCI_OVERRIDE;
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    std::size_t get_len() override;
+
+    std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0) override;
+
+    std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0) override;
+
+    std::size_t append(char const *buf, std::size_t toWrite) override;
+    void trim(std::size_t newLen) override;
 
     firebird_session_backend &session_;
 
@@ -304,26 +305,26 @@ struct firebird_session_backend : details::session_backend
 {
     firebird_session_backend(connection_parameters const & parameters);
 
-    ~firebird_session_backend() SOCI_OVERRIDE;
+    ~firebird_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE;
+    bool is_connected() override;
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
     bool get_next_sequence_value(session & s,
-        std::string const & sequence, long long & value) SOCI_OVERRIDE;
+        std::string const & sequence, long long & value) override;
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return "rdb$database"; }
+    std::string get_dummy_from_table() const override { return "rdb$database"; }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "firebird"; }
+    std::string get_backend_name() const override { return "firebird"; }
 
     void cleanUp();
 
-    firebird_statement_backend * make_statement_backend() SOCI_OVERRIDE;
-    details::rowid_backend* make_rowid_backend() SOCI_OVERRIDE;
-    firebird_blob_backend * make_blob_backend() SOCI_OVERRIDE;
+    firebird_statement_backend * make_statement_backend() override;
+    details::rowid_backend* make_rowid_backend() override;
+    firebird_blob_backend * make_blob_backend() override;
 
     bool get_option_decimals_as_strings() { return decimals_as_strings_; }
 
@@ -344,7 +345,7 @@ struct firebird_backend_factory : backend_factory
 {
     firebird_backend_factory() {}
     firebird_session_backend * make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_FIREBIRD_DECL firebird_backend_factory const firebird;
diff --git a/include/soci/into-type.h b/include/soci/into-type.h
index 2efd9fd..f6bd43e 100644
--- a/include/soci/into-type.h
+++ b/include/soci/into-type.h
@@ -63,18 +63,18 @@ public:
         *ind_ = i_null;
     }
 
-    ~standard_into_type() SOCI_OVERRIDE;
+    ~standard_into_type() override;
 
 protected:
-    void post_fetch(bool gotData, bool calledFromFetch) SOCI_OVERRIDE;
+    void post_fetch(bool gotData, bool calledFromFetch) override;
 
 private:
-    void define(statement_impl & st, int & position) SOCI_OVERRIDE;
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void pre_fetch() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void define(statement_impl & st, int & position) override;
+    void pre_exec(int num) override;
+    void pre_fetch() override;
+    void clean_up() override;
 
-    std::size_t size() const SOCI_OVERRIDE { return 1; }
+    std::size_t size() const override { return 1; }
 
     // conversion hook (from base type to arbitrary user type)
     virtual void convert_from_base() {}
@@ -110,17 +110,17 @@ public:
         : data_(data), type_(type), indVec_(&ind),
         begin_(begin), end_(end), backEnd_(NULL) {}
 
-    ~vector_into_type() SOCI_OVERRIDE;
+    ~vector_into_type() override;
 
 protected:
-    void post_fetch(bool gotData, bool calledFromFetch) SOCI_OVERRIDE;
-
-    void define(statement_impl & st, int & position) SOCI_OVERRIDE;
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void pre_fetch() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() const SOCI_OVERRIDE;
+    void post_fetch(bool gotData, bool calledFromFetch) override;
+
+    void define(statement_impl & st, int & position) override;
+    void pre_exec(int num) override;
+    void pre_fetch() override;
+    void clean_up() override;
+    void resize(std::size_t sz) override;
+    std::size_t size() const override;
 
     void * data_;
     exchange_type type_;
diff --git a/include/soci/mysql/soci-mysql.h b/include/soci/mysql/soci-mysql.h
index 376bb7e..456b023 100644
--- a/include/soci/mysql/soci-mysql.h
+++ b/include/soci/mysql/soci-mysql.h
@@ -21,8 +21,26 @@
 #ifdef _WIN32
 #include <winsock.h> // SOCKET
 #endif // _WIN32
+
+// Some version of mysql.h contain trailing comma in an enum declaration that
+// trigger -Wpedantic, so suppress it as there is nothing to be done about it
+// using the macros defined in our private soci-compiler.h header, that we can
+// only include when building SOCI itself.
+#ifdef SOCI_MYSQL_SOURCE
+    #include "soci-compiler.h"
+#endif
+
+#ifdef SOCI_GCC_WARNING_SUPPRESS
+    SOCI_GCC_WARNING_SUPPRESS(pedantic)
+#endif
+
 #include <mysql.h> // MySQL Client
 #include <errmsg.h> // MySQL Error codes
+
+#ifdef SOCI_GCC_WARNING_RESTORE
+    SOCI_GCC_WARNING_RESTORE(pedantic)
+#endif
+
 #include <vector>
 
 
@@ -43,7 +61,7 @@ public:
             }
         }
 
-    error_category get_error_category() const SOCI_OVERRIDE { return cat_; }
+    error_category get_error_category() const override { return cat_; }
 
     unsigned int err_num_;
     error_category cat_;
@@ -56,13 +74,13 @@ struct mysql_standard_into_type_backend : details::standard_into_type_backend
         : statement_(st) {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
+    void pre_fetch() override;
     void post_fetch(bool gotData, bool calledFromFetch,
-        indicator *ind) SOCI_OVERRIDE;
+        indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     mysql_statement_backend &statement_;
 
@@ -77,15 +95,15 @@ struct mysql_vector_into_type_backend : details::vector_into_type_backend
         : statement_(st) {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator *ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     mysql_statement_backend &statement_;
 
@@ -100,14 +118,14 @@ struct mysql_standard_use_type_backend : details::standard_use_type_backend
         : statement_(st), position_(0), buf_(NULL) {}
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
+    void post_use(bool gotData, indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     mysql_statement_backend &statement_;
 
@@ -124,15 +142,15 @@ struct mysql_vector_use_type_backend : details::vector_use_type_backend
         : statement_(st), position_(0) {}
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
 
-    std::size_t size() SOCI_OVERRIDE;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     mysql_statement_backend &statement_;
 
@@ -148,28 +166,28 @@ struct mysql_statement_backend : details::statement_backend
 {
     mysql_statement_backend(mysql_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
     void prepare(std::string const &query,
-        details::statement_type eType) SOCI_OVERRIDE;
+        details::statement_type eType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const &query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const &query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
+    int prepare_for_describe() override;
     void describe_column(int colNum, data_type &dtype,
-        std::string &columnName) SOCI_OVERRIDE;
+        std::string &columnName) override;
 
-    mysql_standard_into_type_backend * make_into_type_backend() SOCI_OVERRIDE;
-    mysql_standard_use_type_backend * make_use_type_backend() SOCI_OVERRIDE;
-    mysql_vector_into_type_backend * make_vector_into_type_backend() SOCI_OVERRIDE;
-    mysql_vector_use_type_backend * make_vector_use_type_backend() SOCI_OVERRIDE;
+    mysql_standard_into_type_backend * make_into_type_backend() override;
+    mysql_standard_use_type_backend * make_use_type_backend() override;
+    mysql_vector_into_type_backend * make_vector_into_type_backend() override;
+    mysql_vector_use_type_backend * make_vector_use_type_backend() override;
 
     mysql_session_backend &session_;
 
@@ -214,22 +232,20 @@ struct mysql_rowid_backend : details::rowid_backend
 {
     mysql_rowid_backend(mysql_session_backend &session);
 
-    ~mysql_rowid_backend() SOCI_OVERRIDE;
+    ~mysql_rowid_backend() override;
 };
 
 struct mysql_blob_backend : details::blob_backend
 {
     mysql_blob_backend(mysql_session_backend &session);
 
-    ~mysql_blob_backend() SOCI_OVERRIDE;
+    ~mysql_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
-    std::size_t read(std::size_t offset, char *buf,
-        std::size_t toRead) SOCI_OVERRIDE;
-    std::size_t write(std::size_t offset, char const *buf,
-        std::size_t toWrite) SOCI_OVERRIDE;
-    std::size_t append(char const *buf, std::size_t toWrite) SOCI_OVERRIDE;
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    std::size_t get_len() override;
+    std::size_t read_from_start(char *buf, std::size_t toRead, std::size_t offset = 0) override;
+    std::size_t write_from_start(char const *buf, std::size_t toWrite, std::size_t offset = 0) override;
+    std::size_t append(char const *buf, std::size_t toWrite) override;
+    void trim(std::size_t newLen) override;
 
     mysql_session_backend &session_;
 };
@@ -238,29 +254,29 @@ struct mysql_session_backend : details::session_backend
 {
     mysql_session_backend(connection_parameters const & parameters);
 
-    ~mysql_session_backend() SOCI_OVERRIDE;
+    ~mysql_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE;
+    bool is_connected() override;
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
-    bool get_last_insert_id(session&, std::string const&, long long&) SOCI_OVERRIDE;
+    bool get_last_insert_id(session&, std::string const&, long long&) override;
 
     // Note that MySQL supports both "SELECT 2+2" and "SELECT 2+2 FROM DUAL"
     // syntaxes, but there doesn't seem to be any reason to use the longer one.
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return std::string(); }
+    std::string get_dummy_from_table() const override { return std::string(); }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "mysql"; }
+    std::string get_backend_name() const override { return "mysql"; }
 
     void clean_up();
 
-    mysql_statement_backend * make_statement_backend() SOCI_OVERRIDE;
-    mysql_rowid_backend * make_rowid_backend() SOCI_OVERRIDE;
-    mysql_blob_backend * make_blob_backend() SOCI_OVERRIDE;
+    mysql_statement_backend * make_statement_backend() override;
+    mysql_rowid_backend * make_rowid_backend() override;
+    mysql_blob_backend * make_blob_backend() override;
 
-    std::string get_table_names_query() const SOCI_OVERRIDE
+    std::string get_table_names_query() const override
     {
         return "SELECT table_name AS 'TABLE_NAME' FROM information_schema.tables WHERE table_schema = DATABASE()";
     }
@@ -273,7 +289,7 @@ struct mysql_backend_factory : backend_factory
 {
     mysql_backend_factory() {}
     mysql_session_backend * make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_MYSQL_DECL mysql_backend_factory const mysql;
diff --git a/include/soci/odbc/soci-odbc.h b/include/soci/odbc/soci-odbc.h
index 7b1706e..4c32ef2 100644
--- a/include/soci/odbc/soci-odbc.h
+++ b/include/soci/odbc/soci-odbc.h
@@ -92,13 +92,13 @@ struct odbc_standard_into_type_backend : details::standard_into_type_backend,
     {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
+    void pre_fetch() override;
     void post_fetch(bool gotData, bool calledFromFetch,
-        indicator *ind) SOCI_OVERRIDE;
+        indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     char *buf_;        // generic buffer
     void *data_;
@@ -118,15 +118,15 @@ struct odbc_vector_into_type_backend : details::vector_into_type_backend,
           data_(NULL), buf_(NULL), position_(0) {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator *ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     // Normally data retrieved from the database is handled in post_fetch(),
     // however we may need to call SQLFetch() multiple times, so we call this
@@ -159,14 +159,14 @@ struct odbc_standard_use_type_backend : details::standard_use_type_backend,
           position_(-1), data_(0), buf_(0), indHolder_(0) {}
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
+    void post_use(bool gotData, indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     // Return the pointer to the buffer containing data to be used by ODBC.
     // This can be either data_ itself or buf_, that is allocated by this
@@ -207,15 +207,15 @@ struct odbc_vector_use_type_backend : details::vector_use_type_backend,
     void* prepare_for_bind(SQLUINTEGER &size, SQLSMALLINT &sqlType, SQLSMALLINT &cType);
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
 
-    std::size_t size() SOCI_OVERRIDE;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     // IBM DB2 driver is not compliant to ODBC spec for indicators in 64bit
     // SQLLEN is still defined 32bit (int) but spec requires 64bit (long)
@@ -236,31 +236,31 @@ struct odbc_statement_backend : details::statement_backend
 {
     odbc_statement_backend(odbc_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
     void prepare(std::string const &query,
-        details::statement_type eType) SOCI_OVERRIDE;
+        details::statement_type eType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const &query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const &query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
+    int prepare_for_describe() override;
     void describe_column(int colNum, data_type &dtype,
-        std::string &columnName) SOCI_OVERRIDE;
+        std::string &columnName) override;
 
     // helper for defining into vector<string>
     std::size_t column_size(int position);
 
-    odbc_standard_into_type_backend * make_into_type_backend() SOCI_OVERRIDE;
-    odbc_standard_use_type_backend * make_use_type_backend() SOCI_OVERRIDE;
-    odbc_vector_into_type_backend * make_vector_into_type_backend() SOCI_OVERRIDE;
-    odbc_vector_use_type_backend * make_vector_use_type_backend() SOCI_OVERRIDE;
+    odbc_standard_into_type_backend * make_into_type_backend() override;
+    odbc_standard_use_type_backend * make_use_type_backend() override;
+    odbc_vector_into_type_backend * make_vector_into_type_backend() override;
+    odbc_vector_use_type_backend * make_vector_use_type_backend() override;
 
     odbc_session_backend &session_;
     SQLHSTMT hstmt_;
@@ -288,22 +288,20 @@ struct odbc_rowid_backend : details::rowid_backend
 {
     odbc_rowid_backend(odbc_session_backend &session);
 
-    ~odbc_rowid_backend() SOCI_OVERRIDE;
+    ~odbc_rowid_backend() override;
 };
 
 struct odbc_blob_backend : details::blob_backend
 {
     odbc_blob_backend(odbc_session_backend &session);
 
-    ~odbc_blob_backend() SOCI_OVERRIDE;
+    ~odbc_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
-    std::size_t read(std::size_t offset, char *buf,
-        std::size_t toRead) SOCI_OVERRIDE;
-    std::size_t write(std::size_t offset, char const *buf,
-        std::size_t toWrite) SOCI_OVERRIDE;
-    std::size_t append(char const *buf, std::size_t toWrite) SOCI_OVERRIDE;
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    std::size_t get_len() override;
+    std::size_t read_from_start(char *buf, std::size_t toRead, std::size_t offset = 0) override;
+    std::size_t write_from_start(char const *buf, std::size_t toWrite, std::size_t offset = 0) override;
+    std::size_t append(char const *buf, std::size_t toWrite) override;
+    void trim(std::size_t newLen) override;
 
     odbc_session_backend &session_;
 };
@@ -312,31 +310,31 @@ struct odbc_session_backend : details::session_backend
 {
     odbc_session_backend(connection_parameters const & parameters);
 
-    ~odbc_session_backend() SOCI_OVERRIDE;
+    ~odbc_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE;
+    bool is_connected() override;
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
     bool get_next_sequence_value(session & s,
-        std::string const & sequence, long long & value) SOCI_OVERRIDE;
+        std::string const & sequence, long long & value) override;
     bool get_last_insert_id(session & s,
-        std::string const & table, long long & value) SOCI_OVERRIDE;
+        std::string const & table, long long & value) override;
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE;
+    std::string get_dummy_from_table() const override;
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "odbc"; }
+    std::string get_backend_name() const override { return "odbc"; }
 
     void configure_connection();
     void reset_transaction();
 
     void clean_up();
 
-    odbc_statement_backend * make_statement_backend() SOCI_OVERRIDE;
-    odbc_rowid_backend * make_rowid_backend() SOCI_OVERRIDE;
-    odbc_blob_backend * make_blob_backend() SOCI_OVERRIDE;
+    odbc_statement_backend * make_statement_backend() override;
+    odbc_rowid_backend * make_rowid_backend() override;
+    odbc_blob_backend * make_blob_backend() override;
 
     enum database_product
     {
@@ -380,7 +378,7 @@ public:
     {
     }
 
-    error_category get_error_category() const SOCI_OVERRIDE
+    error_category get_error_category() const override
     {
         const char* const s = reinterpret_cast<const char*>(sqlstate_);
 
@@ -584,7 +582,7 @@ struct odbc_backend_factory : backend_factory
 {
     odbc_backend_factory() {}
     odbc_session_backend * make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_ODBC_DECL odbc_backend_factory const odbc;
diff --git a/include/soci/once-temp-type.h b/include/soci/once-temp-type.h
index 715855c..a6be094 100644
--- a/include/soci/once-temp-type.h
+++ b/include/soci/once-temp-type.h
@@ -31,7 +31,7 @@ public:
     once_temp_type(once_temp_type const & o);
     once_temp_type & operator=(once_temp_type const & o);
 
-    ~once_temp_type() SOCI_NOEXCEPT_FALSE;
+    ~once_temp_type() noexcept(false);
 
     template <typename T>
     once_temp_type & operator<<(T const & t)
@@ -122,7 +122,7 @@ public:
     ddl_type(const ddl_type & d);
     ddl_type & operator=(const ddl_type & d);
 
-    ~ddl_type() SOCI_NOEXCEPT_FALSE;
+    ~ddl_type() noexcept(false);
 
     void create_table(const std::string & tableName);
     void add_column(const std::string & tableName,
diff --git a/include/soci/oracle/soci-oracle.h b/include/soci/oracle/soci-oracle.h
index 88f7921..3dc5263 100644
--- a/include/soci/oracle/soci-oracle.h
+++ b/include/soci/oracle/soci-oracle.h
@@ -34,7 +34,7 @@ class SOCI_ORACLE_DECL oracle_soci_error : public soci_error
 public:
     oracle_soci_error(std::string const & msg, int errNum = 0);
 
-    error_category get_error_category() const SOCI_OVERRIDE { return cat_; }
+    error_category get_error_category() const override { return cat_; }
 
     int err_num_;
     error_category cat_;
@@ -49,14 +49,14 @@ struct oracle_standard_into_type_backend : details::standard_into_type_backend
           data_(NULL), buf_(NULL) {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE;
+        void *data, details::exchange_type type) override;
 
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void pre_fetch() SOCI_OVERRIDE;
+    void pre_exec(int num) override;
+    void pre_fetch() override;
     void post_fetch(bool gotData, bool calledFromFetch,
-        indicator *ind) SOCI_OVERRIDE;
+        indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     oracle_statement_backend &statement_;
 
@@ -77,7 +77,7 @@ struct oracle_vector_into_type_backend : details::vector_into_type_backend
         data_(NULL), buf_(NULL), user_ranges_(true) {}
 
     void define_by_pos(int &position,
-        void *data, details::exchange_type type) SOCI_OVERRIDE
+        void *data, details::exchange_type type) override
     {
         user_ranges_ = false;
         define_by_pos_bulk(position, data, type, 0, &end_var_);
@@ -85,17 +85,17 @@ struct oracle_vector_into_type_backend : details::vector_into_type_backend
 
     void define_by_pos_bulk(
         int & position, void * data, details::exchange_type type,
-        std::size_t begin, std::size_t * end) SOCI_OVERRIDE;
+        std::size_t begin, std::size_t * end) override;
 
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_exec(int num) override;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator *ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
     std::size_t full_size();
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     // helper function for preparing indicators and sizes_ vectors
     // (as part of the define_by_pos)
@@ -125,18 +125,18 @@ struct oracle_standard_use_type_backend : details::standard_use_type_backend
           data_(NULL), buf_(NULL) {}
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
 
     // common part for bind_by_pos and bind_by_name
     void prepare_for_bind(void *&data, sb4 &size, ub2 &oracleType, bool readOnly);
 
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_exec(int num) override;
+    void pre_use(indicator const *ind) override;
+    void post_use(bool gotData, indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     oracle_statement_backend &statement_;
 
@@ -156,24 +156,24 @@ struct oracle_vector_use_type_backend : details::vector_use_type_backend
           data_(NULL), buf_(NULL), bind_position_(0) {}
 
     void bind_by_pos(int & position,
-        void * data, details::exchange_type type) SOCI_OVERRIDE
+        void * data, details::exchange_type type) override
     {
         bind_by_pos_bulk(position, data, type, 0, &end_var_);
     }
 
     void bind_by_pos_bulk(int & position,
         void * data, details::exchange_type type,
-        std::size_t begin, std::size_t * end) SOCI_OVERRIDE;
+        std::size_t begin, std::size_t * end) override;
 
     void bind_by_name(const std::string & name,
-        void * data, details::exchange_type type) SOCI_OVERRIDE
+        void * data, details::exchange_type type) override
     {
         bind_by_name_bulk(name, data, type, 0, &end_var_);
     }
 
     void bind_by_name_bulk(std::string const &name,
         void *data, details::exchange_type type,
-        std::size_t begin, std::size_t * end) SOCI_OVERRIDE;
+        std::size_t begin, std::size_t * end) override;
 
     // pre_use() helper
     void prepare_for_bind(void *&data, sb4 &size, ub2 &oracleType);
@@ -182,12 +182,12 @@ struct oracle_vector_use_type_backend : details::vector_use_type_backend
     // (as part of the bind_by_pos and bind_by_name)
     void prepare_indicators(std::size_t size);
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
 
-    std::size_t size() SOCI_OVERRIDE; // active size (might be lower than full vector size)
+    std::size_t size() override; // active size (might be lower than full vector size)
     std::size_t full_size();    // actual size of the user-provided vector
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     oracle_statement_backend &statement_;
 
@@ -214,31 +214,31 @@ struct oracle_statement_backend : details::statement_backend
 {
     oracle_statement_backend(oracle_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
     void prepare(std::string const &query,
-        details::statement_type eType) SOCI_OVERRIDE;
+        details::statement_type eType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const &query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const &query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
+    int prepare_for_describe() override;
     void describe_column(int colNum, data_type &dtype,
-        std::string &columnName) SOCI_OVERRIDE;
+        std::string &columnName) override;
 
     // helper for defining into vector<string>
     std::size_t column_size(int position);
 
-    oracle_standard_into_type_backend * make_into_type_backend() SOCI_OVERRIDE;
-    oracle_standard_use_type_backend * make_use_type_backend() SOCI_OVERRIDE;
-    oracle_vector_into_type_backend * make_vector_into_type_backend() SOCI_OVERRIDE;
-    oracle_vector_use_type_backend * make_vector_use_type_backend() SOCI_OVERRIDE;
+    oracle_standard_into_type_backend * make_into_type_backend() override;
+    oracle_standard_use_type_backend * make_use_type_backend() override;
+    oracle_vector_into_type_backend * make_vector_into_type_backend() override;
+    oracle_vector_use_type_backend * make_vector_use_type_backend() override;
 
     oracle_session_backend &session_;
 
@@ -253,7 +253,7 @@ struct oracle_rowid_backend : details::rowid_backend
 {
     oracle_rowid_backend(oracle_session_backend &session);
 
-    ~oracle_rowid_backend() SOCI_OVERRIDE;
+    ~oracle_rowid_backend() override;
 
     OCIRowid *rowidp_;
 };
@@ -262,31 +262,31 @@ struct oracle_blob_backend : details::blob_backend
 {
     oracle_blob_backend(oracle_session_backend &session);
 
-    ~oracle_blob_backend() SOCI_OVERRIDE;
+    ~oracle_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
+    std::size_t get_len() override;
 
-    std::size_t read(std::size_t offset, char *buf,
-        std::size_t toRead) SOCI_OVERRIDE;
-
-    std::size_t read_from_start(char * buf, std::size_t toRead,
-        std::size_t offset) SOCI_OVERRIDE
+    [[deprecated("Use read_from_start instead")]]
+    std::size_t read(std::size_t offset, char *buf, std::size_t toRead) override
     {
-        return read(offset + 1, buf, toRead);
+        // Offsets are 1-based in Oracle
+        return read_from_start(buf, toRead, offset - 1);
     }
 
-    std::size_t write(std::size_t offset, char const *buf,
-        std::size_t toWrite) SOCI_OVERRIDE;
+    std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0) override;
 
-    std::size_t write_from_start(const char * buf, std::size_t toWrite,
-        std::size_t offset) SOCI_OVERRIDE
+    [[deprecated("Use write_from_start instead")]]
+    std::size_t write(std::size_t offset, char const *buf, std::size_t toWrite) override
     {
-        return write(offset + 1, buf, toWrite);
+        // Offsets are 1-based in Oracle
+        return write_from_start(buf, toWrite, offset - 1);
     }
 
-    std::size_t append(char const *buf, std::size_t toWrite) SOCI_OVERRIDE;
+    std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0) override;
+
+    std::size_t append(char const *buf, std::size_t toWrite) override;
 
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    void trim(std::size_t newLen) override;
 
     oracle_session_backend &session_;
 
@@ -303,21 +303,21 @@ struct oracle_session_backend : details::session_backend
         int charset = 0,
         int ncharset = 0);
 
-    ~oracle_session_backend() SOCI_OVERRIDE;
+    ~oracle_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE;
+    bool is_connected() override;
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
-    std::string get_table_names_query() const SOCI_OVERRIDE
+    std::string get_table_names_query() const override
     {
         return "select table_name"
             " from user_tables";
     }
 
-    std::string get_column_descriptions_query() const SOCI_OVERRIDE
+    std::string get_column_descriptions_query() const override
     {
         return "select column_name,"
             " data_type,"
@@ -330,7 +330,7 @@ struct oracle_session_backend : details::session_backend
     }
 
     std::string create_column_type(data_type dt,
-        int precision, int scale) SOCI_OVERRIDE
+        int precision, int scale) override
     {
         //  Oracle-specific SQL syntax:
 
@@ -402,39 +402,39 @@ struct oracle_session_backend : details::session_backend
     }
     std::string add_column(const std::string & tableName,
         const std::string & columnName, data_type dt,
-        int precision, int scale) SOCI_OVERRIDE
+        int precision, int scale) override
     {
         return "alter table " + tableName + " add " +
             columnName + " " + create_column_type(dt, precision, scale);
     }
     std::string alter_column(const std::string & tableName,
         const std::string & columnName, data_type dt,
-        int precision, int scale) SOCI_OVERRIDE
+        int precision, int scale) override
     {
         return "alter table " + tableName + " modify " +
             columnName + " " + create_column_type(dt, precision, scale);
     }
-    std::string empty_blob() SOCI_OVERRIDE
+    std::string empty_blob() override
     {
         return "empty_blob()";
     }
-    std::string nvl() SOCI_OVERRIDE
+    std::string nvl() override
     {
         return "nvl";
     }
 
     bool get_next_sequence_value(session &s,
-         std::string const &sequence, long long &value) SOCI_OVERRIDE;
+         std::string const &sequence, long long &value) override;
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return "dual"; }
+    std::string get_dummy_from_table() const override { return "dual"; }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "oracle"; }
+    std::string get_backend_name() const override { return "oracle"; }
 
     void clean_up();
 
-    oracle_statement_backend * make_statement_backend() SOCI_OVERRIDE;
-    oracle_rowid_backend * make_rowid_backend() SOCI_OVERRIDE;
-    oracle_blob_backend * make_blob_backend() SOCI_OVERRIDE;
+    oracle_statement_backend * make_statement_backend() override;
+    oracle_rowid_backend * make_rowid_backend() override;
+    oracle_blob_backend * make_blob_backend() override;
 
     bool get_option_decimals_as_strings() { return decimals_as_strings_; }
 
@@ -455,7 +455,7 @@ struct oracle_backend_factory : backend_factory
 {
 	  oracle_backend_factory() {}
     oracle_session_backend * make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_ORACLE_DECL oracle_backend_factory const oracle;
diff --git a/include/soci/postgresql/soci-postgresql.h b/include/soci/postgresql/soci-postgresql.h
index afd49e6..a239883 100644
--- a/include/soci/postgresql/soci-postgresql.h
+++ b/include/soci/postgresql/soci-postgresql.h
@@ -32,7 +32,7 @@ public:
 
     std::string sqlstate() const;
 
-    error_category get_error_category() const SOCI_OVERRIDE { return cat_; }
+    error_category get_error_category() const override { return cat_; }
 
 private:
     char sqlstate_[ 5 ];   // not std::string to keep copy-constructor no-throw
@@ -125,13 +125,13 @@ struct postgresql_standard_into_type_backend : details::standard_into_type_backe
         : statement_(st) {}
 
     void define_by_pos(int & position,
-        void * data, details::exchange_type type) SOCI_OVERRIDE;
+        void * data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
+    void pre_fetch() override;
     void post_fetch(bool gotData, bool calledFromFetch,
-        indicator * ind) SOCI_OVERRIDE;
+        indicator * ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     postgresql_statement_backend & statement_;
 
@@ -146,7 +146,7 @@ struct postgresql_vector_into_type_backend : details::vector_into_type_backend
         : statement_(st), user_ranges_(true) {}
 
     void define_by_pos(int & position,
-        void * data, details::exchange_type type) SOCI_OVERRIDE
+        void * data, details::exchange_type type) override
     {
         user_ranges_ = false;
         define_by_pos_bulk(position, data, type, 0, &end_var_);
@@ -154,16 +154,16 @@ struct postgresql_vector_into_type_backend : details::vector_into_type_backend
 
     void define_by_pos_bulk(int & position,
         void * data, details::exchange_type type,
-        std::size_t begin, std::size_t * end) SOCI_OVERRIDE;
+        std::size_t begin, std::size_t * end) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator * ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator * ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE; // active size (might be lower than full vector size)
+    void resize(std::size_t sz) override;
+    std::size_t size() override; // active size (might be lower than full vector size)
     std::size_t full_size();    // actual size of the user-provided vector
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     postgresql_statement_backend & statement_;
 
@@ -182,14 +182,14 @@ struct postgresql_standard_use_type_backend : details::standard_use_type_backend
         : statement_(st), position_(0), buf_(NULL) {}
 
     void bind_by_pos(int & position,
-        void * data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void * data, details::exchange_type type, bool readOnly) override;
     void bind_by_name(std::string const & name,
-        void * data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void * data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const * ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator * ind) SOCI_OVERRIDE;
+    void pre_use(indicator const * ind) override;
+    void post_use(bool gotData, indicator * ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     postgresql_statement_backend & statement_;
 
@@ -210,31 +210,31 @@ struct postgresql_vector_use_type_backend : details::vector_use_type_backend
         : statement_(st), position_(0) {}
 
     void bind_by_pos(int & position,
-        void * data, details::exchange_type type) SOCI_OVERRIDE
+        void * data, details::exchange_type type) override
     {
         bind_by_pos_bulk(position, data, type, 0, &end_var_);
     }
 
     void bind_by_pos_bulk(int & position,
         void * data, details::exchange_type type,
-        std::size_t begin, std::size_t * end) SOCI_OVERRIDE;
+        std::size_t begin, std::size_t * end) override;
 
     void bind_by_name(std::string const & name,
-        void * data, details::exchange_type type) SOCI_OVERRIDE
+        void * data, details::exchange_type type) override
     {
         bind_by_name_bulk(name, data, type, 0, &end_var_);
     }
 
     void bind_by_name_bulk(const std::string & name,
         void * data, details::exchange_type type,
-        std::size_t begin, std::size_t * end) SOCI_OVERRIDE;
+        std::size_t begin, std::size_t * end) override;
 
-    void pre_use(indicator const * ind) SOCI_OVERRIDE;
+    void pre_use(indicator const * ind) override;
 
-    std::size_t size() SOCI_OVERRIDE; // active size (might be lower than full vector size)
+    std::size_t size() override; // active size (might be lower than full vector size)
     std::size_t full_size();    // actual size of the user-provided vector
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     postgresql_statement_backend & statement_;
 
@@ -252,30 +252,30 @@ struct postgresql_statement_backend : details::statement_backend
 {
     postgresql_statement_backend(postgresql_session_backend & session,
         bool single_row_mode);
-    ~postgresql_statement_backend() SOCI_OVERRIDE;
+    ~postgresql_statement_backend() override;
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
     void prepare(std::string const & query,
-        details::statement_type stType) SOCI_OVERRIDE;
+        details::statement_type stType) override;
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const & query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const & query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
+    int prepare_for_describe() override;
     void describe_column(int colNum, data_type & dtype,
-        std::string & columnName) SOCI_OVERRIDE;
+        std::string & columnName) override;
 
-    postgresql_standard_into_type_backend * make_into_type_backend() SOCI_OVERRIDE;
-    postgresql_standard_use_type_backend * make_use_type_backend() SOCI_OVERRIDE;
-    postgresql_vector_into_type_backend * make_vector_into_type_backend() SOCI_OVERRIDE;
-    postgresql_vector_use_type_backend * make_vector_use_type_backend() SOCI_OVERRIDE;
+    postgresql_standard_into_type_backend * make_into_type_backend() override;
+    postgresql_standard_use_type_backend * make_use_type_backend() override;
+    postgresql_vector_into_type_backend * make_vector_into_type_backend() override;
+    postgresql_vector_use_type_backend * make_vector_use_type_backend() override;
 
     postgresql_session_backend & session_;
 
@@ -315,7 +315,7 @@ struct postgresql_rowid_backend : details::rowid_backend
 {
     postgresql_rowid_backend(postgresql_session_backend & session);
 
-    ~postgresql_rowid_backend() SOCI_OVERRIDE;
+    ~postgresql_rowid_backend() override;
 
     unsigned long value_;
 };
@@ -324,31 +324,17 @@ struct postgresql_blob_backend : details::blob_backend
 {
     postgresql_blob_backend(postgresql_session_backend & session);
 
-    ~postgresql_blob_backend() SOCI_OVERRIDE;
+    ~postgresql_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
+    std::size_t get_len() override;
 
-    std::size_t read(std::size_t offset, char * buf,
-        std::size_t toRead) SOCI_OVERRIDE;
+    std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0) override;
 
-    std::size_t read_from_start(char * buf, std::size_t toRead,
-        std::size_t offset) SOCI_OVERRIDE
-    {
-        return read(offset, buf, toRead);
-    }
-
-    std::size_t write(std::size_t offset, char const * buf,
-        std::size_t toWrite) SOCI_OVERRIDE;
-
-    std::size_t write_from_start(const char * buf, std::size_t toWrite,
-        std::size_t offset) SOCI_OVERRIDE
-    {
-        return write(offset, buf, toWrite);
-    }
+    std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0) override;
 
-    std::size_t append(char const * buf, std::size_t toWrite) SOCI_OVERRIDE;
+    std::size_t append(char const * buf, std::size_t toWrite) override;
 
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    void trim(std::size_t newLen) override;
 
     postgresql_session_backend & session_;
 
@@ -361,30 +347,30 @@ struct postgresql_session_backend : details::session_backend
     postgresql_session_backend(connection_parameters const & parameters,
         bool single_row_mode);
 
-    ~postgresql_session_backend() SOCI_OVERRIDE;
+    ~postgresql_session_backend() override;
 
     void connect(connection_parameters const & parameters);
 
-    bool is_connected() SOCI_OVERRIDE;
+    bool is_connected() override;
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
     void deallocate_prepared_statement(const std::string & statementName);
 
     bool get_next_sequence_value(session & s,
-        std::string const & sequence, long long & value) SOCI_OVERRIDE;
+        std::string const & sequence, long long & value) override;
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return std::string(); }
+    std::string get_dummy_from_table() const override { return std::string(); }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "postgresql"; }
+    std::string get_backend_name() const override { return "postgresql"; }
 
     void clean_up();
 
-    postgresql_statement_backend * make_statement_backend() SOCI_OVERRIDE;
-    postgresql_rowid_backend * make_rowid_backend() SOCI_OVERRIDE;
-    postgresql_blob_backend * make_blob_backend() SOCI_OVERRIDE;
+    postgresql_statement_backend * make_statement_backend() override;
+    postgresql_rowid_backend * make_rowid_backend() override;
+    postgresql_blob_backend * make_blob_backend() override;
 
     std::string get_next_statement_name();
 
@@ -399,7 +385,7 @@ struct postgresql_backend_factory : backend_factory
 {
     postgresql_backend_factory() {}
     postgresql_session_backend * make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_POSTGRESQL_DECL postgresql_backend_factory const postgresql;
diff --git a/include/soci/query_transformation.h b/include/soci/query_transformation.h
index 00a1cc0..4e2148e 100644
--- a/include/soci/query_transformation.h
+++ b/include/soci/query_transformation.h
@@ -41,7 +41,7 @@ public:
         : callback_(callback)
     {}
 
-    std::string operator()(std::string const& query) const SOCI_OVERRIDE
+    std::string operator()(std::string const& query) const override
     {
         return callback_(query);
     }
diff --git a/include/soci/ref-counted-prepare-info.h b/include/soci/ref-counted-prepare-info.h
index 10bafaa..9211b68 100644
--- a/include/soci/ref-counted-prepare-info.h
+++ b/include/soci/ref-counted-prepare-info.h
@@ -47,7 +47,7 @@ public:
     void exchange(into_container<T, Indicator> const &ic)
     { intos_.exchange(ic); }
 
-    void final_action() SOCI_OVERRIDE;
+    void final_action() override;
 
 private:
     friend class statement_impl;
diff --git a/include/soci/ref-counted-statement.h b/include/soci/ref-counted-statement.h
index 365b3ba..99cd69f 100644
--- a/include/soci/ref-counted-statement.h
+++ b/include/soci/ref-counted-statement.h
@@ -86,7 +86,7 @@ public:
     ref_counted_statement(session & s)
         : ref_counted_statement_base(s), st_(s) {}
 
-    void final_action() SOCI_OVERRIDE;
+    void final_action() override;
 
     template <typename T>
     void exchange(T &t) { st_.exchange(t); }
diff --git a/include/soci/row-exchange.h b/include/soci/row-exchange.h
index b94337f..ea8a1f5 100644
--- a/include/soci/row-exchange.h
+++ b/include/soci/row-exchange.h
@@ -33,7 +33,7 @@ public:
 
 private:
     // special handling for Row
-    void define(statement_impl & st, int & /* position */) SOCI_OVERRIDE
+    void define(statement_impl & st, int & /* position */) override
     {
         st.set_row(&r_);
 
@@ -41,9 +41,9 @@ private:
         // as part of the statement execute
     }
 
-    void pre_exec(int /* num */) SOCI_OVERRIDE {}
-    void pre_fetch() SOCI_OVERRIDE {}
-    void post_fetch(bool gotData, bool /* calledFromFetch */) SOCI_OVERRIDE
+    void pre_exec(int /* num */) override {}
+    void pre_fetch() override {}
+    void post_fetch(bool gotData, bool /* calledFromFetch */) override
     {
         r_.reset_get_counter();
 
@@ -56,9 +56,9 @@ private:
         }
     }
 
-    void clean_up() SOCI_OVERRIDE {}
+    void clean_up() override {}
 
-    std::size_t size() const SOCI_OVERRIDE { return 1; }
+    std::size_t size() const override { return 1; }
 
     virtual void convert_from_base() {}
 
diff --git a/include/soci/row.h b/include/soci/row.h
index 02cb60e..8cd816d 100644
--- a/include/soci/row.h
+++ b/include/soci/row.h
@@ -43,6 +43,9 @@ public:
     row();
     ~row();
 
+    row(row &&other) = default;
+    row &operator=(row &&other) = default;
+
     void uppercase_column_names(bool forceToUpper);
     void add_properties(column_properties const& cp);
     std::size_t size() const;
diff --git a/include/soci/rowset.h b/include/soci/rowset.h
index c15b3ab..cfe5ca2 100644
--- a/include/soci/rowset.h
+++ b/include/soci/rowset.h
@@ -148,8 +148,8 @@ private:
 
     unsigned int refs_;
 
-    const cxx_details::auto_ptr<statement> st_;
-    const cxx_details::auto_ptr<T> define_;
+    const std::unique_ptr<statement> st_;
+    const std::unique_ptr<T> define_;
     SOCI_NOT_COPYABLE(rowset_impl)
 }; // class rowset_impl
 
diff --git a/include/soci/session.h b/include/soci/session.h
index bcb1d7b..88207b4 100644
--- a/include/soci/session.h
+++ b/include/soci/session.h
@@ -43,7 +43,7 @@ class SOCI_DECL session
 {
 private:
 
-    void set_query_transformation_(cxx_details::auto_ptr<details::query_transformation_function>& qtf);
+    void set_query_transformation_(std::unique_ptr<details::query_transformation_function>&& qtf);
 
 
 
@@ -65,7 +65,7 @@ public:
     void reconnect();
 
     // check if we have a working connection to the database
-    bool is_connected() const SOCI_NOEXCEPT;
+    bool is_connected() const noexcept;
 
     void begin();
     void commit();
@@ -85,9 +85,7 @@ public:
     template <typename T>
     void set_query_transformation(T callback)
     {
-
-        cxx_details::auto_ptr<details::query_transformation_function> qtf(new details::query_transformation<T>(callback));
-        set_query_transformation_(qtf);
+        set_query_transformation_(std::make_unique<details::query_transformation<T>>(callback));
     }
 
     // Support for custom logging of database operations.
@@ -194,7 +192,7 @@ private:
     SOCI_NOT_COPYABLE(session)
 
     std::ostringstream query_stream_;
-    details::query_transformation_function* query_transformation_;
+    std::unique_ptr<details::query_transformation_function> query_transformation_;
 
     logger logger_;
 
diff --git a/include/soci/soci-backend.h b/include/soci/soci-backend.h
index 5073e3c..237f658 100644
--- a/include/soci/soci-backend.h
+++ b/include/soci/soci-backend.h
@@ -227,23 +227,15 @@ public:
 
     virtual std::size_t get_len() = 0;
 
-    virtual std::size_t read(std::size_t offset, char* buf,
-        std::size_t toRead) = 0;
+    [[deprecated("Use read_from_start instead")]]
+    virtual std::size_t read(std::size_t offset, char* buf, std::size_t toRead) { return read_from_start(buf, toRead, offset); }
 
-    virtual std::size_t read_from_start(char * /* buf */, std::size_t /* toRead */,
-        std::size_t /* offset */)
-    {
-        throw soci_error("read_from_start is not implemented for this backend");
-    }
+    virtual std::size_t read_from_start(char* buf, std::size_t toRead, std::size_t offset) = 0;
 
-    virtual std::size_t write(std::size_t offset, char const* buf,
-        std::size_t toWrite) = 0;
+    [[deprecated("Use write_from_start instead")]]
+    virtual std::size_t write(std::size_t offset, char const* buf, std::size_t toWrite) { return write_from_start(buf, toWrite, offset); }
 
-    virtual std::size_t write_from_start(const char * /* buf */, std::size_t /* toWrite */,
-        std::size_t /* offset */)
-    {
-        throw soci_error("write_from_start is not implemented for this backend");
-    }
+    virtual std::size_t write_from_start(const char* buf, std::size_t toWrite, std::size_t offset) = 0;
 
     virtual std::size_t append(char const* buf, std::size_t toWrite) = 0;
 
diff --git a/include/soci/soci-platform.h b/include/soci/soci-platform.h
index 443985f..3f94cb5 100644
--- a/include/soci/soci-platform.h
+++ b/include/soci/soci-platform.h
@@ -105,42 +105,55 @@ namespace std {
 // mode, we just need to check for the minimal compiler version supporting them
 // (see https://msdn.microsoft.com/en-us/library/hh567368.aspx).
 
-#if defined(SOCI_HAVE_CXX11) || (defined(_MSC_VER) && _MSC_VER >= 1800)
-# define SOCI_OVERRIDE override
+#ifdef _MSC_VER
+    #if _MSC_VER < 1900
+        #error This version of SOCI requires MSVS 2015 or later.
+    #endif
+    #if _MSVC_LANG >= 201703L
+        #define SOCI_HAVE_CXX17
+    #endif
 #else
-# define SOCI_OVERRIDE
+    #if __cplusplus < 201402L
+        #error This version of SOCI requires C++14.
+    #endif
+    #if __cplusplus >= 201703L
+        #define SOCI_HAVE_CXX17
+    #endif
 #endif
 
-namespace soci
-{
-
-namespace cxx_details
-{
-
-#if defined(SOCI_HAVE_CXX11) || (defined(_MSC_VER) && _MSC_VER >= 1800)
-    template <typename T>
-    using auto_ptr = std::unique_ptr<T>;
-#else // std::unique_ptr<> not available
-    using std::auto_ptr;
+// Define SOCI_ALLOW_DEPRECATED_BEGIN and SOCI_ALLOW_DEPRECATED_END
+// Ref.: https://www.fluentcpp.com/2019/08/30/how-to-disable-a-warning-in-cpp/
+#if defined(__GNUC__) || defined(__clang__)
+# define SOCI_ALLOW_DEPRECATED_BEGIN \
+    _Pragma("GCC diagnostic push") \
+    _Pragma("GCC diagnostic ignored \"-Wdeprecated\"") \
+    _Pragma("GCC diagnostic ignored \"-Wdeprecated-declarations\"")
+# define SOCI_ALLOW_DEPRECATED_END \
+    _Pragma("GCC diagnostic pop")
+#elif defined(_MSC_VER)
+# define SOCI_ALLOW_DEPRECATED_BEGIN \
+    __pragma(warning(push)) \
+    __pragma(warning(disable: 4973 )) \
+    __pragma(warning(disable: 4974 )) \
+    __pragma(warning(disable: 4995 )) \
+    __pragma(warning(disable: 4996 ))
+# define SOCI_ALLOW_DEPRECATED_END \
+    __pragma(warning(pop))
+# define SOCI_DONT_WARN(statement) statement
+#else
+# pragma message("WARNING: SOCI_ALLOW_DEPRECATED_* not available for this compilet")
+# define SOCI_ALLOW_DEPRECATED_BEGIN
+# define SOCI_ALLOW_DEPRECATED_END
 #endif
 
-} // namespace cxx_details
-
-} // namespace soci
-
-#if defined(SOCI_HAVE_CXX11) || (defined(_MSC_VER) && _MSC_VER >= 1800)
-    #define SOCI_NOT_ASSIGNABLE(classname) \
-        classname& operator=(const classname&) = delete;
-    #define SOCI_NOT_COPYABLE(classname) \
-        classname(const classname&) = delete; \
-        SOCI_NOT_ASSIGNABLE(classname)
-#else // no C++11 deleted members support
-    #define SOCI_NOT_ASSIGNABLE(classname) \
-        classname& operator=(const classname&);
-    #define SOCI_NOT_COPYABLE(classname) \
-        classname(const classname&); \
-        SOCI_NOT_ASSIGNABLE(classname)
-#endif // C++11 deleted members available
+#define SOCI_NOT_ASSIGNABLE(classname) \
+public: \
+    classname(const classname&) = default; \
+private: \
+    classname& operator=(const classname&) = delete;
+#define SOCI_NOT_COPYABLE(classname) \
+    classname(const classname&) = delete; \
+    classname& operator=(const classname&) = delete;
 
 #define SOCI_UNUSED(x) (void)x;
 
@@ -162,18 +175,4 @@ namespace cxx_details
     #define SOCI_DUMMY_RETURN(x) return x
 #endif
 
-#if defined(SOCI_HAVE_CXX11) || (defined(_MSC_VER) && _MSC_VER >= 1900)
-    #define SOCI_NOEXCEPT noexcept
-    #define SOCI_NOEXCEPT_FALSE noexcept(false)
-#else
-    #if defined(__cplusplus) && __cplusplus >= 201103L
-        // Otherwise throwing from a dtor not marked with noexcept(false) would
-        // simply result in terminating the program.
-        #error "SOCI must be configured with C++11 support when using C++11"
-    #endif
-
-    #define SOCI_NOEXCEPT throw()
-    #define SOCI_NOEXCEPT_FALSE
-#endif
-
 #endif // SOCI_PLATFORM_H_INCLUDED
diff --git a/include/soci/soci-simple.h b/include/soci/soci-simple.h
index 5eb1e6b..5771c44 100644
--- a/include/soci/soci-simple.h
+++ b/include/soci/soci-simple.h
@@ -36,8 +36,12 @@ SOCI_DECL blob_handle soci_create_blob(session_handle s);
 SOCI_DECL void soci_destroy_blob(blob_handle b);
 
 SOCI_DECL int soci_blob_get_len(blob_handle b);
+[[deprecated("Use soci_blob_read_from_start instead")]]
 SOCI_DECL int soci_blob_read(blob_handle b, int offset, char *buf, int toRead);
+SOCI_DECL int soci_blob_read_from_start(blob_handle b, char *buf, int toRead, int offset = 0);
+[[deprecated("Use soci_blob_write_from_start instead")]]
 SOCI_DECL int soci_blob_write(blob_handle b, int offset, char const *buf, int toWrite);
+SOCI_DECL int soci_blob_write_from_start(blob_handle b, char const *buf, int toWrite, int offset = 0);
 SOCI_DECL int soci_blob_append(blob_handle b, char const *buf, int toWrite);
 SOCI_DECL int soci_blob_trim(blob_handle b, int newLen);
 
diff --git a/include/soci/sqlite3/soci-sqlite3.h b/include/soci/sqlite3/soci-sqlite3.h
index 9bb9d56..2520dfd 100644
--- a/include/soci/sqlite3/soci-sqlite3.h
+++ b/include/soci/sqlite3/soci-sqlite3.h
@@ -69,13 +69,13 @@ struct sqlite3_standard_into_type_backend : details::standard_into_type_backend
     }
 
     void define_by_pos(int &position,
-                             void *data, details::exchange_type type) SOCI_OVERRIDE;
+                             void *data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
+    void pre_fetch() override;
     void post_fetch(bool gotData, bool calledFromFetch,
-                           indicator *ind) SOCI_OVERRIDE;
+                           indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     sqlite3_statement_backend &statement_;
 
@@ -91,15 +91,15 @@ struct sqlite3_vector_into_type_backend : details::vector_into_type_backend
     {
     }
 
-    void define_by_pos(int& position, void* data, details::exchange_type type) SOCI_OVERRIDE;
+    void define_by_pos(int& position, void* data, details::exchange_type type) override;
 
-    void pre_fetch() SOCI_OVERRIDE;
-    void post_fetch(bool gotData, indicator* ind) SOCI_OVERRIDE;
+    void pre_fetch() override;
+    void post_fetch(bool gotData, indicator* ind) override;
 
-    void resize(std::size_t sz) SOCI_OVERRIDE;
-    std::size_t size() SOCI_OVERRIDE;
+    void resize(std::size_t sz) override;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     sqlite3_statement_backend& statement_;
 
@@ -113,14 +113,14 @@ struct sqlite3_standard_use_type_backend : details::standard_use_type_backend
     sqlite3_standard_use_type_backend(sqlite3_statement_backend &st);
 
     void bind_by_pos(int &position,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
     void bind_by_name(std::string const &name,
-        void *data, details::exchange_type type, bool readOnly) SOCI_OVERRIDE;
+        void *data, details::exchange_type type, bool readOnly) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
-    void post_use(bool gotData, indicator *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
+    void post_use(bool gotData, indicator *ind) override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     sqlite3_statement_backend &statement_;
 
@@ -138,15 +138,15 @@ struct sqlite3_vector_use_type_backend : details::vector_use_type_backend
     }
 
     void bind_by_pos(int &position,
-                           void *data, details::exchange_type type) SOCI_OVERRIDE;
+                           void *data, details::exchange_type type) override;
     void bind_by_name(std::string const &name,
-                            void *data, details::exchange_type type) SOCI_OVERRIDE;
+                            void *data, details::exchange_type type) override;
 
-    void pre_use(indicator const *ind) SOCI_OVERRIDE;
+    void pre_use(indicator const *ind) override;
 
-    std::size_t size() SOCI_OVERRIDE;
+    std::size_t size() override;
 
-    void clean_up() SOCI_OVERRIDE;
+    void clean_up() override;
 
     sqlite3_statement_backend &statement_;
 
@@ -196,30 +196,30 @@ struct sqlite3_statement_backend : details::statement_backend
 {
     sqlite3_statement_backend(sqlite3_session_backend &session);
 
-    void alloc() SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
+    void alloc() override;
+    void clean_up() override;
     void prepare(std::string const &query,
-        details::statement_type eType) SOCI_OVERRIDE;
+        details::statement_type eType) override;
     void reset_if_needed();
     void reset();
 
-    exec_fetch_result execute(int number) SOCI_OVERRIDE;
-    exec_fetch_result fetch(int number) SOCI_OVERRIDE;
+    exec_fetch_result execute(int number) override;
+    exec_fetch_result fetch(int number) override;
 
-    long long get_affected_rows() SOCI_OVERRIDE;
-    int get_number_of_rows() SOCI_OVERRIDE;
-    std::string get_parameter_name(int index) const SOCI_OVERRIDE;
+    long long get_affected_rows() override;
+    int get_number_of_rows() override;
+    std::string get_parameter_name(int index) const override;
 
-    std::string rewrite_for_procedure_call(std::string const &query) SOCI_OVERRIDE;
+    std::string rewrite_for_procedure_call(std::string const &query) override;
 
-    int prepare_for_describe() SOCI_OVERRIDE;
+    int prepare_for_describe() override;
     void describe_column(int colNum, data_type &dtype,
-                                std::string &columnName) SOCI_OVERRIDE;
+                                std::string &columnName) override;
 
-    sqlite3_standard_into_type_backend * make_into_type_backend() SOCI_OVERRIDE;
-    sqlite3_standard_use_type_backend * make_use_type_backend() SOCI_OVERRIDE;
-    sqlite3_vector_into_type_backend * make_vector_into_type_backend() SOCI_OVERRIDE;
-    sqlite3_vector_use_type_backend * make_vector_use_type_backend() SOCI_OVERRIDE;
+    sqlite3_standard_into_type_backend * make_into_type_backend() override;
+    sqlite3_standard_use_type_backend * make_use_type_backend() override;
+    sqlite3_vector_into_type_backend * make_vector_into_type_backend() override;
+    sqlite3_vector_use_type_backend * make_vector_use_type_backend() override;
 
     sqlite3_session_backend &session_;
     sqlite_api::sqlite3_stmt *stmt_;
@@ -244,7 +244,7 @@ struct sqlite3_rowid_backend : details::rowid_backend
 {
     sqlite3_rowid_backend(sqlite3_session_backend &session);
 
-    ~sqlite3_rowid_backend() SOCI_OVERRIDE;
+    ~sqlite3_rowid_backend() override;
 
     unsigned long value_;
 };
@@ -253,15 +253,16 @@ struct sqlite3_blob_backend : details::blob_backend
 {
     sqlite3_blob_backend(sqlite3_session_backend &session);
 
-    ~sqlite3_blob_backend() SOCI_OVERRIDE;
+    ~sqlite3_blob_backend() override;
 
-    std::size_t get_len() SOCI_OVERRIDE;
-    std::size_t read(std::size_t offset, char *buf,
-                             std::size_t toRead) SOCI_OVERRIDE;
-    std::size_t write(std::size_t offset, char const *buf,
-                              std::size_t toWrite) SOCI_OVERRIDE;
-    std::size_t append(char const *buf, std::size_t toWrite) SOCI_OVERRIDE;
-    void trim(std::size_t newLen) SOCI_OVERRIDE;
+    std::size_t get_len() override;
+
+    std::size_t read_from_start(char * buf, std::size_t toRead, std::size_t offset = 0) override;
+
+    std::size_t write_from_start(const char * buf, std::size_t toWrite, std::size_t offset = 0) override;
+
+    std::size_t append(char const *buf, std::size_t toWrite) override;
+    void trim(std::size_t newLen) override;
 
     sqlite3_session_backend &session_;
 
@@ -277,37 +278,37 @@ struct sqlite3_session_backend : details::session_backend
 {
     sqlite3_session_backend(connection_parameters const & parameters);
 
-    ~sqlite3_session_backend() SOCI_OVERRIDE;
+    ~sqlite3_session_backend() override;
 
-    bool is_connected() SOCI_OVERRIDE { return true; }
+    bool is_connected() override { return true; }
 
-    void begin() SOCI_OVERRIDE;
-    void commit() SOCI_OVERRIDE;
-    void rollback() SOCI_OVERRIDE;
+    void begin() override;
+    void commit() override;
+    void rollback() override;
 
-    bool get_last_insert_id(session&, std::string const&, long long&) SOCI_OVERRIDE;
+    bool get_last_insert_id(session&, std::string const&, long long&) override;
 
-    std::string empty_blob() SOCI_OVERRIDE
+    std::string empty_blob() override
     {
         return "x\'\'";
     }
 
-    std::string get_dummy_from_table() const SOCI_OVERRIDE { return std::string(); }
+    std::string get_dummy_from_table() const override { return std::string(); }
 
-    std::string get_backend_name() const SOCI_OVERRIDE { return "sqlite3"; }
+    std::string get_backend_name() const override { return "sqlite3"; }
 
     void clean_up();
 
-    sqlite3_statement_backend * make_statement_backend() SOCI_OVERRIDE;
-    sqlite3_rowid_backend * make_rowid_backend() SOCI_OVERRIDE;
-    sqlite3_blob_backend * make_blob_backend() SOCI_OVERRIDE;
-    std::string get_table_names_query() const SOCI_OVERRIDE
+    sqlite3_statement_backend * make_statement_backend() override;
+    sqlite3_rowid_backend * make_rowid_backend() override;
+    sqlite3_blob_backend * make_blob_backend() override;
+    std::string get_table_names_query() const override
     {
         return "select name as \"TABLE_NAME\""
                 " from sqlite_master where type = 'table'";
     }
     std::string create_column_type(data_type dt,
-                                           int , int ) SOCI_OVERRIDE
+                                           int , int ) override
     {
         switch (dt)
         {
@@ -329,13 +330,17 @@ struct sqlite3_session_backend : details::session_backend
 
     }
     sqlite_api::sqlite3 *conn_;
+
+    // This flag is set to true if the internal sqlite_sequence table exists in
+    // the database.
+    bool sequence_table_exists_;
 };
 
 struct sqlite3_backend_factory : backend_factory
 {
     sqlite3_backend_factory() {}
     sqlite3_session_backend * make_session(
-        connection_parameters const & parameters) const SOCI_OVERRIDE;
+        connection_parameters const & parameters) const override;
 };
 
 extern SOCI_SQLITE3_DECL sqlite3_backend_factory const sqlite3;
diff --git a/include/soci/std-optional.h b/include/soci/std-optional.h
new file mode 100644
index 0000000..f6d7bcf
--- /dev/null
+++ b/include/soci/std-optional.h
@@ -0,0 +1,55 @@
+//
+// Copyright (C) 2004-2008 Maciej Sobczak, Stephen Hutton
+// Distributed under the Boost Software License, Version 1.0.
+// (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+//
+
+#ifndef SOCI_STD_OPTIONAL_H_INCLUDED
+#define SOCI_STD_OPTIONAL_H_INCLUDED
+
+#include "soci/type-conversion-traits.h"
+
+#include <optional>
+
+namespace soci
+{
+
+// simple fall-back for std::optional
+template <typename T>
+struct type_conversion<std::optional<T> >
+{
+    typedef typename type_conversion<T>::base_type base_type;
+
+    static void from_base(base_type const & in, indicator ind,
+        std::optional<T> & out)
+    {
+        if (ind == i_null)
+        {
+            out.reset();
+        }
+        else
+        {
+            T tmp = T();
+            type_conversion<T>::from_base(in, ind, tmp);
+            out = tmp;
+        }
+    }
+
+    static void to_base(std::optional<T> const & in,
+        base_type & out, indicator & ind)
+    {
+        if (in)
+        {
+            type_conversion<T>::to_base(*in, out, ind);
+        }
+        else
+        {
+            ind = i_null;
+        }
+    }
+};
+
+} // namespace soci
+
+#endif // SOCI_STD_OPTIONAL_H_INCLUDED
diff --git a/include/soci/type-conversion.h b/include/soci/type-conversion.h
index e69effe..3b96ab7 100644
--- a/include/soci/type-conversion.h
+++ b/include/soci/type-conversion.h
@@ -62,7 +62,7 @@ public:
 
 
 private:
-    void convert_from_base() SOCI_OVERRIDE
+    void convert_from_base() override
     {
         type_conversion<T>::from_base(
             base_value_holder<T>::val_, ind_, value_);
@@ -130,7 +130,7 @@ public:
         //convert_to_base();
     }
 
-    void convert_from_base() SOCI_OVERRIDE
+    void convert_from_base() override
     {
         // NOTE:
         // readOnly_ flag indicates that use_type object has been generated
@@ -145,7 +145,7 @@ public:
         }
     }
 
-    void convert_to_base() SOCI_OVERRIDE
+    void convert_to_base() override
     {
         if (ind_ == i_null)
         {
@@ -233,7 +233,7 @@ public:
         user_ranges_ = end != NULL;
     }
 
-    std::size_t size() const SOCI_OVERRIDE
+    std::size_t size() const override
     {
         // the user might have resized his vector in the meantime
         // -> synchronize the base-value mirror to have the same size
@@ -244,7 +244,7 @@ public:
         return into_type<base_type>::size();
     }
 
-    void resize(std::size_t sz) SOCI_OVERRIDE
+    void resize(std::size_t sz) override
     {
         into_type<base_type>::resize(sz);
 
@@ -254,7 +254,7 @@ public:
     }
 
 private:
-    void convert_from_base() SOCI_OVERRIDE
+    void convert_from_base() override
     {
         if (user_ranges_)
         {
@@ -365,7 +365,7 @@ public:
     }
 
 private:
-    void convert_to_base() SOCI_OVERRIDE
+    void convert_to_base() override
     {
         std::size_t const sz = value_.size();
         base_vector_holder<T>::vec_.resize(sz);
diff --git a/include/soci/type-holder.h b/include/soci/type-holder.h
index 61c9613..f103edb 100644
--- a/include/soci/type-holder.h
+++ b/include/soci/type-holder.h
@@ -10,6 +10,7 @@
 
 #include "soci/soci-platform.h"
 // std
+#include <cstring>
 #include <typeinfo>
 
 namespace soci
@@ -18,6 +19,31 @@ namespace soci
 namespace details
 {
 
+// Returns U* as T*, if the dynamic type of the pointer is really T.
+//
+// This should be used instead of dynamic_cast<> because using it doesn't work
+// when using libc++ and ELF visibility together. Luckily, when we don't need
+// the full power of the cast, but only need to check if the types are the
+// same, it can be done by comparing their type info objects.
+//
+// This function does _not_ replace dynamic_cast<> in all cases and notably
+// doesn't allow the input pointer to be null.
+template <typename T, typename U>
+T* checked_ptr_cast(U* ptr)
+{
+    // Check if they're identical first, as an optimization, and then compare
+    // their names to make it actually work with libc++.
+    std::type_info const& ti_ptr = typeid(*ptr);
+    std::type_info const& ti_ret = typeid(T);
+
+    if (&ti_ptr != &ti_ret && std::strcmp(ti_ptr.name(), ti_ret.name()) != 0)
+    {
+        return NULL;
+    }
+
+    return static_cast<T*>(ptr);
+}
+
 // Base class holder + derived class type_holder for storing type data
 // instances in a container of holder objects
 template <typename T>
@@ -32,7 +58,7 @@ public:
     template<typename T>
     T get()
     {
-        type_holder<T>* p = dynamic_cast<type_holder<T> *>(this);
+        type_holder<T>* p = checked_ptr_cast<type_holder<T> >(this);
         if (p)
         {
             return p->template value<T>();
@@ -54,7 +80,7 @@ class type_holder : public holder
 {
 public:
     type_holder(T * t) : t_(t) {}
-    ~type_holder() SOCI_OVERRIDE { delete t_; }
+    ~type_holder() override { delete t_; }
 
     template<typename TypeValue>
     TypeValue value() const { return *t_; }
diff --git a/include/soci/use-type.h b/include/soci/use-type.h
index bd0401d..6016335 100644
--- a/include/soci/use-type.h
+++ b/include/soci/use-type.h
@@ -73,10 +73,10 @@ public:
         //convert_to_base();
     }
 
-    ~standard_use_type() SOCI_OVERRIDE;
-    void bind(statement_impl & st, int & position) SOCI_OVERRIDE;
-    std::string get_name() const SOCI_OVERRIDE { return name_; }
-    void dump_value(std::ostream& os) const SOCI_OVERRIDE;
+    ~standard_use_type() override;
+    void bind(statement_impl & st, int & position) override;
+    std::string get_name() const override { return name_; }
+    void dump_value(std::ostream& os) const override;
     virtual void * get_data() { return data_; }
 
     // conversion hook (from arbitrary user type to base type)
@@ -84,13 +84,13 @@ public:
     virtual void convert_from_base() {}
 
 protected:
-    void pre_use() SOCI_OVERRIDE;
+    void pre_use() override;
 
 private:
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void post_use(bool gotData) SOCI_OVERRIDE;
-    void clean_up() SOCI_OVERRIDE;
-    std::size_t size() const SOCI_OVERRIDE { return 1; }
+    void pre_exec(int num) override;
+    void post_use(bool gotData) override;
+    void clean_up() override;
+    std::size_t size() const override { return 1; }
 
     void* data_;
     exchange_type type_;
@@ -152,17 +152,17 @@ public:
         , backEnd_(NULL)
     {}
 
-    ~vector_use_type() SOCI_OVERRIDE;
+    ~vector_use_type() override;
 
 private:
-    void bind(statement_impl& st, int & position) SOCI_OVERRIDE;
-    std::string get_name() const SOCI_OVERRIDE { return name_; }
-    void dump_value(std::ostream& os) const SOCI_OVERRIDE;
-    void pre_exec(int num) SOCI_OVERRIDE;
-    void pre_use() SOCI_OVERRIDE;
-    void post_use(bool) SOCI_OVERRIDE { /* nothing to do */ }
-    void clean_up() SOCI_OVERRIDE;
-    std::size_t size() const SOCI_OVERRIDE;
+    void bind(statement_impl& st, int & position) override;
+    std::string get_name() const override { return name_; }
+    void dump_value(std::ostream& os) const override;
+    void pre_exec(int num) override;
+    void pre_use() override;
+    void post_use(bool) override { /* nothing to do */ }
+    void clean_up() override;
+    std::size_t size() const override;
 
     void* data_;
     exchange_type type_;
diff --git a/include/soci/values-exchange.h b/include/soci/values-exchange.h
index d7caeb5..eae91e6 100644
--- a/include/soci/values-exchange.h
+++ b/include/soci/values-exchange.h
@@ -46,7 +46,7 @@ public:
         : v_(v)
     {}
 
-    void bind(details::statement_impl & st, int & /*position*/) SOCI_OVERRIDE
+    void bind(details::statement_impl & st, int & /*position*/) override
     {
         v_.uppercase_column_names(st.session_.get_uppercase_column_names());
 
@@ -54,7 +54,7 @@ public:
         st.bind(v_);
     }
 
-    std::string get_name() const SOCI_OVERRIDE
+    std::string get_name() const override
     {
         std::ostringstream oss;
 
@@ -74,23 +74,23 @@ public:
         return oss.str();
     }
 
-    void dump_value(std::ostream& os) const SOCI_OVERRIDE
+    void dump_value(std::ostream& os) const override
     {
         // TODO: Dump all columns.
         os << "<value>";
     }
 
-    void pre_exec(int /* num */) SOCI_OVERRIDE {}
+    void pre_exec(int /* num */) override {}
 
-    void post_use(bool /*gotData*/) SOCI_OVERRIDE
+    void post_use(bool /*gotData*/) override
     {
         v_.reset_get_counter();
         convert_from_base();
     }
 
-    void pre_use() SOCI_OVERRIDE {convert_to_base();}
-    void clean_up() SOCI_OVERRIDE {v_.clean_up();}
-    std::size_t size() const SOCI_OVERRIDE { return 1; }
+    void pre_use() override {convert_to_base();}
+    void clean_up() override {v_.clean_up();}
+    std::size_t size() const override { return 1; }
 
     // these are used only to re-dispatch to derived class
     // (the derived class might be generated automatically by
@@ -124,7 +124,7 @@ public:
         : into_type<row>(v.get_row(), ind), v_(v)
     {}
 
-    void clean_up() SOCI_OVERRIDE
+    void clean_up() override
     {
         v_.clean_up();
     }
diff --git a/include/soci/values.h b/include/soci/values.h
index 28b1004..5f9db2f 100644
--- a/include/soci/values.h
+++ b/include/soci/values.h
@@ -287,7 +287,7 @@ private:
 
         typedef typename type_conversion<T>::base_type base_type;
 
-        if (dynamic_cast<details::use_type<base_type> *>(u))
+        if (details::checked_ptr_cast<details::use_type<base_type> >(u))
         {
             base_type const & baseValue = *static_cast<base_type*>(u->get_data());
 
diff --git a/include/soci/version.h b/include/soci/version.h
index 1f56d11..b13caa3 100644
--- a/include/soci/version.h
+++ b/include/soci/version.h
@@ -22,13 +22,13 @@
 //  SOCI_VERSION / 100 % 1000 is the minor version
 //  SOCI_VERSION / 100000 is the major version
 
-#define SOCI_VERSION 400003
+#define SOCI_VERSION 400100
 
 //
 //  SOCI_LIB_VERSION must be defined to be the same as SOCI_VERSION
 //  but as a *string* in the form "x_y[_z]" where x is the major version
 //  number, y is the minor version number, and z is the patch level if not 0.
 
-#define SOCI_LIB_VERSION "4_0_3"
+#define SOCI_LIB_VERSION "4_1_0"
 
 #endif // SOCI_VERSION_HPP
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 0000000..1fda190
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,51 @@
+site_name: SOCI (master)
+site_description: SOCI - The C++ Database Access Library
+repo_url: https://github.com/SOCI/soci/
+copyright: Copyright &copy; 2017 <a href="https://github.com/msobczak">Maciej Sobczak</a> and <a href="http://soci.sourceforge.net/people.html">SOCI Team</a>.
+
+nav:
+  - Home: index.md
+  - Overview:
+    - Getting Started: quickstart.md
+    - Installation: installation.md
+    - Library Structure: structure.md
+    - License: license.md
+    - FAQ: faq.md
+  - User Guide:
+    - Connections: connections.md
+    - Queries: queries.md
+    - Data Binding: binding.md
+    - Data Indicators: indicators.md
+    - Data Types: types.md
+    - LOBs: lobs.md
+    - Statements: statements.md
+    - Transactions: transactions.md
+    - Procedures: procedures.md
+    - Errors: errors.md
+    - Logging: logging.md
+    - Interfaces: interfaces.md
+  - Backends:
+    - Features: backends/index.md
+    - DB2: backends/db2.md
+    - Firebird: backends/firebird.md
+    - MySQL: backends/mysql.md
+    - ODBC: backends/odbc.md
+    - Oracle: backends/oracle.md
+    - PostgreSQL: backends/postgresql.md
+    - SQLite3: backends/sqlite3.md
+  - Miscellaneous:
+    - Beyond SQL: beyond.md
+    - Multi-threading: multithreading.md
+    - Boost: boost.md
+    - Utilities: utilities.md
+    - Vagrant: vagrant.md
+  - API:
+    - Client API: api/client.md
+    - Backend API: api/backend.md
+    - Ada:
+        - languages/ada/index.md
+        - languages/ada/concepts.md
+        - languages/ada/idioms.md
+        - languages/ada/reference.md
+
+#theme: readthedocs
diff --git a/scripts/build.bat b/scripts/build.bat
new file mode 100644
index 0000000..e968a9d
--- /dev/null
+++ b/scripts/build.bat
@@ -0,0 +1,79 @@
+@echo off
+rem Runs CMake to configure SOCI for Visual Studio 2017.
+rem Runs MSBuild to build the generated solution.
+rem
+rem Usage:
+rem 1. Copy build.bat to build.local.bat (git ignored file)
+rem 2. Make your adjustments in the CONFIGURATION section below
+rem 3. Run build.local.bat 32|64
+rem 4. Optionally, run devenv.exe SOCI{32|64}.sln from command line
+
+rem ### CONFIGURATION #####################################
+rem ### Connection strings for tests (alternatively, use command line-c option)
+rem ### For example, SQL Server LocalDB instance, MySQL and PostgreSQL on the Vagrant VM.
+set TEST_CONNSTR_MSSQL=""
+set TEST_CONNSTR_MYSQL=""
+set TEST_CONNSTR_PGSQL=""
+setlocal
+set BOOST_ROOT=C:/local/boost_1_59_0
+rem #######################################################
+
+set U=""
+if /I "%2"=="U"  set U=U
+if [%1]==[32] goto :32
+if [%1]==[64] goto :64
+goto :Usage
+
+:32
+set P=32
+set MSBUILDP=Win32
+set GENERATOR="Visual Studio 15 2017"
+goto :Build
+
+:64
+set P=64
+set MSBUILDP=x64
+set GENERATOR="Visual Studio 15 2017 Win64"
+goto :Build
+
+:Build
+set BUILDDIR=_build%P%%U%
+mkdir %BUILDDIR%
+pushd %BUILDDIR%
+cmake.exe ^
+    -G %GENERATOR% ^
+    -DWITH_BOOST=ON ^
+    -DWITH_DB2=ON ^
+    -DWITH_FIREBIRD=ON ^
+    -DWITH_MYSQL=ON ^
+    -DWITH_ODBC=ON ^
+    -DWITH_ORACLE=ON ^
+    -DWITH_POSTGRESQL=ON ^
+    -DWITH_SQLITE3=ON ^
+    -DSOCI_EMPTY=ON ^
+    -DSOCI_EMPTY_TEST_CONNSTR="" ^
+    -DSOCI_DB2=ON ^
+    -DSOCI_DB2_TEST_CONNSTR="" ^
+    -DSOCI_FIREBIRD=ON ^
+    -DSOCI_FIREBIRD_TEST_CONNSTR="" ^
+    -DSOCI_MYSQL=ON ^
+    -DSOCI_MYSQL_TEST_CONNSTR="" ^
+    -DSOCI_ODBC=ON ^
+    -DSOCI_ODBC_TEST_MYSQL_CONNSTR="" ^
+    -DSOCI_ODBC_TEST_POSTGRESQL_CONNSTR="" ^
+    -DSOCI_ORACLE=ON ^
+    -DSOCI_ORACLE_TEST_CONNSTR="" ^
+    -DSOCI_POSTGRESQL=ON ^
+    -DSOCI_POSTGRESQL_TEST_CONNSTR="" ^
+    -DSOCI_SQLITE3=ON ^
+    -DSOCI_SQLITE3_TEST_CONNSTR="" ^
+    ..
+move SOCI.sln SOCI%P%%U%.sln
+rem msbuild.exe SOCI%P%%U%.sln /p:Configuration=Release /p:Platform=%MSBUILDP%
+popd
+goto :EOF
+
+:Usage
+@echo build.bat
+@echo Usage: build.bat [32 or 64]
+exit /B 1
diff --git a/scripts/ci/before_build.sh b/scripts/ci/before_build.sh
new file mode 100755
index 0000000..1f4489e
--- /dev/null
+++ b/scripts/ci/before_build.sh
@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Run before_script actions for SOCI build in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+before_script="${SOCI_SOURCE_DIR}/scripts/ci/before_build_${SOCI_CI_BACKEND}.sh"
+if [ -x ${before_script} ]; then
+    echo "Running ${before_script}"
+    ${before_script}
+fi
diff --git a/scripts/ci/before_build_db2.sh b/scripts/ci/before_build_db2.sh
new file mode 100755
index 0000000..035ac64
--- /dev/null
+++ b/scripts/ci/before_build_db2.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Sets up environment for SOCI backend DB2 in CI builds
+#
+# Copyright (c) 2013 Brian R. Toonen <toonen@alcf.anl.gov>
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+sudo -u db2inst1 -i db2 "CREATE DATABASE SOCITEST"
+sudo -u db2inst1 -i db2 "ACTIVATE DATABASE SOCITEST"
diff --git a/scripts/ci/before_build_firebird.sh b/scripts/ci/before_build_firebird.sh
new file mode 100755
index 0000000..2dcf41d
--- /dev/null
+++ b/scripts/ci/before_build_firebird.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Configure Firebird database for SOCI build in CI builds
+#
+# Mateusz Loskot <mateusz@loskot.net>, http://github.com/SOCI
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+isql-fb -z -q -i /dev/null # --version
+echo 'CREATE DATABASE "LOCALHOST:/tmp/soci_test.fdb" PAGE_SIZE = 16384;' > /tmp/create_soci_test.sql
+isql-fb -u SYSDBA -p masterkey -i /tmp/create_soci_test.sql -q
+cat /tmp/create_soci_test.sql
diff --git a/scripts/ci/before_build_mysql.sh b/scripts/ci/before_build_mysql.sh
new file mode 100755
index 0000000..a0bbd05
--- /dev/null
+++ b/scripts/ci/before_build_mysql.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# Sets up environment for SOCI backend MySQL in CI builds
+#
+# Mateusz Loskot <mateusz@loskot.net>, http://github.com/SOCI
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+SOCI_MYSQL_USER=$(id -un)
+
+if [ -n "${SOCI_MYSQL_ROOT_PASSWORD}" ]; then
+    sudo systemctl start mysql.service
+    SOCI_MYSQL_PASSWORD_OPT="-p${SOCI_MYSQL_ROOT_PASSWORD}"
+    mysql -u root ${SOCI_MYSQL_PASSWORD_OPT} -e "CREATE USER '${SOCI_MYSQL_USER}';"
+fi
+
+mysql --version
+mysql -u root ${SOCI_MYSQL_PASSWORD_OPT} -e "CREATE DATABASE soci_test;"
+mysql -u root ${SOCI_MYSQL_PASSWORD_OPT} -e "GRANT ALL PRIVILEGES ON soci_test.* TO '${SOCI_MYSQL_USER}'@'%';";
+
+# This is necessary for MySQL stored procedure unit test to work.
+mysql -u root ${SOCI_MYSQL_PASSWORD_OPT} -e "SET GLOBAL log_bin_trust_function_creators=1";
+
+echo 'Testing connection to the database:'
+echo 'SELECT USER();' | mysql --database=soci_test
diff --git a/scripts/ci/before_build_odbc.sh b/scripts/ci/before_build_odbc.sh
new file mode 100755
index 0000000..b999894
--- /dev/null
+++ b/scripts/ci/before_build_odbc.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Sets up environment for SOCI backend ODBC in CI builds
+#
+# Mateusz Loskot <mateusz@loskot.net>, http://github.com/SOCI
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# Create PostgreSQL database we use for ODBC tests too.
+${SOCI_SOURCE_DIR}/scripts/ci/before_build_postgresql.sh
+
+# Test connection to the database via ODBC.
+#
+# Note that using FILEDSN requires -k (Use SQLDriverConnect) and doesn't work
+# without it.
+echo 'select 2+2;' | isql -b -k -v "FILEDSN=${SOCI_SOURCE_DIR}/tests/odbc/test-postgresql.dsn"
diff --git a/scripts/ci/before_build_oracle.sh b/scripts/ci/before_build_oracle.sh
new file mode 100755
index 0000000..d1a08e9
--- /dev/null
+++ b/scripts/ci/before_build_oracle.sh
@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Configures Oracle database for SOCI Oracle backend CI builds.
+#
+# Copyright (c) 2013 Peter Butkovic <butkovic@gmail.com>
+#
+# Modified by Mateusz Loskot <mateusz@loskot.net>
+# Changes:
+# - Check connection as user for testing
+#
+# Copyright (c) 2021 Vadim Zeitlin <vz-soci@zeitlins.org>
+# - Rewrote to work with Docker Oracle container
+
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# create the user for the tests
+oracle_sqlplus sys/oracle AS SYSDBA <<SQL
+create user travis identified by travis;
+grant connect, resource to travis;
+grant execute on sys.dbms_lock to travis;
+grant create session, alter any procedure to travis;
+SQL
+
+# increase default=40 value of processes to prevent ORA-12520 failures while testing
+echo "alter system set processes=300 scope=spfile;" | \
+oracle_sqlplus sys/oracle AS SYSDBA
+
+# restart the database for the parameter change above to be taken into account
+echo "Restarting the database..."
+oracle_exec /etc/init.d/oracle-xe restart
+
+# confirm the parameter modification was taken into account
+echo "show parameter processes;" | \
+oracle_sqlplus sys/oracle AS SYSDBA
+
+# check connection as user for testing
+echo "Connecting using travis/travis@XE"
+echo "SELECT * FROM product_component_version;" | \
+oracle_sqlplus travis/travis@XE
diff --git a/scripts/ci/before_build_postgresql.sh b/scripts/ci/before_build_postgresql.sh
new file mode 100755
index 0000000..b588c24
--- /dev/null
+++ b/scripts/ci/before_build_postgresql.sh
@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# Sets up environment for SOCI backend PostgreSQL in CI builds
+#
+# Mateusz Loskot <mateusz@loskot.net>, http://github.com/SOCI
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+case "$(uname)" in
+    Linux)
+        sudo service postgresql start
+        pg_isready --timeout=60
+        sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'Password12!';"
+        ;;
+
+    Darwin)
+        pg_ctl init
+        pg_ctl start
+        pg_isready --timeout=60
+        createuser --superuser postgres
+        ;;
+
+    *)
+        echo 'Unknown OS, PostgreSQL not available'
+        exit 1
+esac
+
+psql --version
+psql -c 'create database soci_test;' -U postgres
+
+echo 'Testing connection to the database:'
+psql -c 'select user;' -U postgres -d soci_test
diff --git a/scripts/ci/before_build_valgrind.sh b/scripts/ci/before_build_valgrind.sh
new file mode 100755
index 0000000..c1465d9
--- /dev/null
+++ b/scripts/ci/before_build_valgrind.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Sets up environment for SOCI backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+# Copyright (c) 2015 Sergei Nikulov <sergey.nikulov@gmail.com>
+# Copyright (c) 2021 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+
+# We use both MySQL and PostgreSQL in this build.
+${SOCI_SOURCE_DIR}/scripts/ci/before_build_mysql.sh
+${SOCI_SOURCE_DIR}/scripts/ci/before_build_postgresql.sh
diff --git a/scripts/ci/build.sh b/scripts/ci/build.sh
new file mode 100755
index 0000000..47de9b2
--- /dev/null
+++ b/scripts/ci/build.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Build SOCI in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# prepare build directory
+mkdir -p ${builddir}
+cd ${builddir}
+
+# do build
+SCRIPT=${SOCI_SOURCE_DIR}/scripts/ci/build_${SOCI_CI_BACKEND}.sh
+echo "Running ${SCRIPT}"
+${SCRIPT}
diff --git a/scripts/ci/build_all.sh b/scripts/ci/build_all.sh
new file mode 100644
index 0000000..3d1d45e
--- /dev/null
+++ b/scripts/ci/build_all.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Builds SOCI with all backends.
+#
+# Copyright (c) 2021 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# We don't use the default options here, as we don't want to turn off all the
+# backends.
+cmake ${SOCI_COMMON_CMAKE_OPTIONS} \
+    ..
+
+run_make
diff --git a/scripts/ci/build_db2.sh b/scripts/ci/build_db2.sh
new file mode 100755
index 0000000..39c5552
--- /dev/null
+++ b/scripts/ci/build_db2.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Builds SOCI DB2 backend in CI builds
+#
+# Copyright (c) 2013 Brian R. Toonen <toonen@alcf.anl.gov>
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DSOCI_DB2=ON \
+    -DSOCI_DB2_TEST_CONNSTR:STRING="DSN=SOCITEST\;Uid=db2inst1\;Pwd=db2inst1" \
+    ..
+
+run_make
diff --git a/scripts/ci/build_empty.sh b/scripts/ci/build_empty.sh
new file mode 100755
index 0000000..b27a31e
--- /dev/null
+++ b/scripts/ci/build_empty.sh
@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# Builds SOCI "empty" backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+run_cmake_for_empty()
+{
+    cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+        -DCMAKE_CXX_STANDARD=${CMAKE_CXX_STANDARD:-11} \
+        -DSOCI_EMPTY=ON \
+        ..
+}
+
+run_cmake_for_example()
+{
+  cmake "../examples/$1"
+}
+
+if [[ "$BUILD_EXAMPLES" == "YES" ]]; then
+  run_cmake_for_example subdir-include
+  run_make
+else
+  run_cmake_for_empty
+  run_make
+fi
+
+# Test release branch packaging and building from the package
+if [[ "$TEST_RELEASE_PACKAGE" == "YES" ]] && [[ "$SOCI_CI_BRANCH" =~ ^release/[3-9]\.[0-9]$ ]]; then
+    ME=`basename "$0"`
+
+    run_apt update
+    run_apt install python3-venv
+
+    SOCI_VERSION=$(cat "$SOCI_SOURCE_DIR/include/soci/version.h" | grep -Po "(.*#define\s+SOCI_LIB_VERSION\s+.+)\K([3-9]_[0-9]_[0-9])" | sed "s/_/\./g")
+    if [[ ! "$SOCI_VERSION" =~ ^[4-9]\.[0-9]\.[0-9]$ ]]; then
+        echo "${ME} ERROR: Invalid format of SOCI version '$SOCI_VERSION'. Aborting."
+        exit 1
+    else
+        echo "${ME} INFO: Creating source package 'soci-${SOCI_VERSION}.tar.gz' from '$SOCI_CI_BRANCH' branch"
+    fi
+
+    cd $SOCI_SOURCE_DIR
+    $SOCI_SOURCE_DIR/scripts/release.sh --use-local-branch $SOCI_CI_BRANCH
+
+    if [[ ! -f "soci-${SOCI_VERSION}.tar.gz" ]]; then
+        echo "${ME} ERROR: Archive file 'soci-${SOCI_VERSION}.tar.gz' not found. Aborting."
+        exit 1
+    fi
+
+    echo "${ME} INFO: Unpacking source package 'soci-${SOCI_VERSION}.tar.gz'"
+    tar -xzf soci-${SOCI_VERSION}.tar.gz
+
+    echo "${ME} INFO: Building SOCI from source package 'soci-${SOCI_VERSION}.tar.gz'"
+    cd soci-${SOCI_VERSION}
+    mkdir _build
+    echo $PWD
+
+    run_cmake_for_empty
+    run_make
+    run_test
+fi
diff --git a/scripts/ci/build_firebird.sh b/scripts/ci/build_firebird.sh
new file mode 100755
index 0000000..9a96de3
--- /dev/null
+++ b/scripts/ci/build_firebird.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Builds SOCI Firebird backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DSOCI_FIREBIRD=ON \
+    -DSOCI_FIREBIRD_TEST_CONNSTR:STRING="service=LOCALHOST:/tmp/soci_test.fdb user=SYSDBA password=masterkey" \
+    ..
+
+run_make
diff --git a/scripts/ci/build_mysql.sh b/scripts/ci/build_mysql.sh
new file mode 100755
index 0000000..b420680
--- /dev/null
+++ b/scripts/ci/build_mysql.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Builds SOCI MySQL backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DSOCI_MYSQL=ON \
+    -DSOCI_MYSQL_TEST_CONNSTR:STRING="db=soci_test" \
+    ..
+
+run_make
diff --git a/scripts/ci/build_odbc.sh b/scripts/ci/build_odbc.sh
new file mode 100755
index 0000000..0d64965
--- /dev/null
+++ b/scripts/ci/build_odbc.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Builds SOCI ODBC backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+ODBC_TEST=${PWD}/../tests/odbc
+if test ! -d ${ODBC_TEST}; then
+    echo "ERROR: '${ODBC_TEST}' directory not found"
+    exit 1
+fi
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DSOCI_ODBC=ON \
+   ..
+
+run_make
diff --git a/scripts/ci/build_oracle.sh b/scripts/ci/build_oracle.sh
new file mode 100755
index 0000000..a5e235f
--- /dev/null
+++ b/scripts/ci/build_oracle.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Builds SOCI Oracle backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DWITH_BOOST=OFF \
+    -DSOCI_ORACLE=ON \
+    -DSOCI_ORACLE_TEST_CONNSTR:STRING="service=localhost/XE user=travis password=travis" \
+    ..
+
+run_make
diff --git a/scripts/ci/build_postgresql.sh b/scripts/ci/build_postgresql.sh
new file mode 100755
index 0000000..debbb6a
--- /dev/null
+++ b/scripts/ci/build_postgresql.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Builds SOCI PostgreSQL backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DSOCI_POSTGRESQL=ON \
+    -DSOCI_POSTGRESQL_TEST_CONNSTR:STRING="dbname=soci_test user=postgres" \
+    ..
+
+run_make
diff --git a/scripts/ci/build_sqlite3.sh b/scripts/ci/build_sqlite3.sh
new file mode 100755
index 0000000..7804033
--- /dev/null
+++ b/scripts/ci/build_sqlite3.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Builds SOCI SQLite3 backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+cmake ${SOCI_DEFAULT_CMAKE_OPTIONS} \
+    -DSOCI_SQLITE3=ON \
+    -DSOCI_SQLITE3_TEST_CONNSTR:STRING="soci_test.db" \
+    ..
+
+run_make
diff --git a/scripts/ci/build_valgrind.sh b/scripts/ci/build_valgrind.sh
new file mode 100755
index 0000000..37acad5
--- /dev/null
+++ b/scripts/ci/build_valgrind.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Builds SOCI for use with Valgrind in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+# Copyright (c) 2015 Sergei Nikulov <sergey.nikulov@gmail.com>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# Note that we don't use the default options here, as we don't want to turn
+# off all the backends (nor to enable ASAN which is incompatible with Valgrind).
+cmake ${SOCI_COMMON_CMAKE_OPTIONS} \
+    -DSOCI_ODBC=OFF \
+    ..
+
+run_make
diff --git a/scripts/ci/common.sh b/scripts/ci/common.sh
new file mode 100644
index 0000000..c1864ea
--- /dev/null
+++ b/scripts/ci/common.sh
@@ -0,0 +1,104 @@
+#!/bin/sh
+# Common definitions used by SOCI build scripts in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+# Note that this is a /bin/sh script because it is used from install.sh
+# which installs bash under FreeBSD and so we can't rely on bash being
+# available yet.
+
+# Stop on all errors.
+set -e
+
+if [ "$SOCI_CI" != "true" ] ; then
+	echo "Running this script is only useful in the CI builds"
+	exit 1
+fi
+
+backend_settings=${SOCI_SOURCE_DIR}/scripts/ci/${SOCI_CI_BACKEND}.sh
+if [ -f ${backend_settings} ]; then
+    . ${backend_settings}
+fi
+
+#
+# Environment
+#
+case `uname` in
+    Linux)
+        num_cpus=`nproc`
+        ;;
+
+    Darwin | FreeBSD)
+        num_cpus=`sysctl -n hw.ncpu`
+        ;;
+
+    *)
+        num_cpus=1
+esac
+
+# Directory where the build happens.
+#
+# Note that the existing commands suppose that the build directory is an
+# immediate subdirectory of the source one, so don't change this.
+builddir="${SOCI_SOURCE_DIR}/_build"
+
+# These options are used for all builds.
+SOCI_COMMON_CMAKE_OPTIONS='
+    -DCMAKE_BUILD_TYPE=Debug
+    -DCMAKE_VERBOSE_MAKEFILE=ON
+    -DSOCI_ENABLE_WERROR=ON
+    -DSOCI_STATIC=OFF
+    -DSOCI_TESTS=ON
+'
+
+if [ -n "${SOCI_CXXSTD}" ]; then
+    SOCI_COMMON_CMAKE_OPTIONS="$SOCI_COMMON_CMAKE_OPTIONS -DCMAKE_CXX_STANDARD=${SOCI_CXXSTD}"
+fi
+
+if [ -n "${WITH_BOOST}" ]; then
+    SOCI_COMMON_CMAKE_OPTIONS="$SOCI_COMMON_CMAKE_OPTIONS -DWITH_BOOST=${WITH_BOOST}"
+fi
+
+# These options are defaults and used by most builds, but not Valgrind one.
+SOCI_DEFAULT_CMAKE_OPTIONS="${SOCI_COMMON_CMAKE_OPTIONS}
+    -DSOCI_ASAN=ON
+    -DSOCI_DB2=OFF
+    -DSOCI_EMPTY=OFF
+    -DSOCI_FIREBIRD=OFF
+    -DSOCI_MYSQL=OFF
+    -DSOCI_ODBC=OFF
+    -DSOCI_ORACLE=OFF
+    -DSOCI_POSTGRESQL=OFF
+    -DSOCI_SQLITE3=OFF
+"
+
+#
+# Functions
+#
+tmstamp()
+{
+    echo -n "[$(date '+%H:%M:%S')]" ;
+}
+
+run_apt()
+{
+    # Disable some (but not all) output.
+    sudo apt-get -q -y -o=Dpkg::Use-Pty=0 "$@"
+}
+
+run_make()
+{
+    make -j $num_cpus
+}
+
+run_test()
+{
+    # The example project doesn't have any tests, but otherwise their absence
+    # is an error and means that something has gone wrong.
+    if [ "$BUILD_EXAMPLES" == "YES" ]; then
+        no_tests_action=ignore
+    else
+        no_tests_action=error
+    fi
+    ctest -V --output-on-failure --no-tests=${no_tests_action} "$@" .
+}
diff --git a/scripts/ci/install.sh b/scripts/ci/install.sh
new file mode 100755
index 0000000..47bb486
--- /dev/null
+++ b/scripts/ci/install.sh
@@ -0,0 +1,45 @@
+#!/bin/sh
+# Run install actions for SOCI build in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+# Note that this is a /bin/sh script because bash is not installed yet under
+# FreeBSD.
+. ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+case "$(uname)" in
+    Linux)
+        packages_to_install="cmake libc6-dbg"
+        if [ "${WITH_BOOST}" != OFF ]; then
+            packages_to_install="$packages_to_install  libboost-dev libboost-date-time-dev"
+        fi
+
+        # Get rid of the repositories that we don't need: not only this takes
+        # extra time to update, but it also often fails with "Mirror sync in
+        # progress" errors.
+        for apt_file in `grep -lr microsoft /etc/apt/sources.list.d/`; do sudo rm $apt_file; done
+
+        codename=$(lsb_release --codename --short)
+        # Enable the `-dbgsym` repositories.
+        echo "deb http://ddebs.ubuntu.com ${codename} main restricted universe multiverse
+        deb http://ddebs.ubuntu.com ${codename}-updates main restricted universe multiverse" | \
+        sudo tee --append /etc/apt/sources.list.d/ddebs.list >/dev/null
+
+        # Import the debug symbol archive signing key from the Ubuntu server.
+        # Note that this command works only on Ubuntu 18.04 LTS and newer.
+        run_apt install ubuntu-dbgsym-keyring
+
+        run_apt update
+        run_apt install ${packages_to_install}
+        ;;
+
+    FreeBSD)
+        pkg install -q -y bash cmake
+        ;;
+esac
+
+install_script="${SOCI_SOURCE_DIR}/scripts/ci/install_${SOCI_CI_BACKEND}.sh"
+if [ -x ${install_script} ]; then
+    echo "Running ${install_script}"
+    ${install_script}
+fi
diff --git a/scripts/ci/install_db2.sh b/scripts/ci/install_db2.sh
new file mode 100755
index 0000000..81385e1
--- /dev/null
+++ b/scripts/ci/install_db2.sh
@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Installs DB2 for SOCI build in CI builds
+#
+# Copyright (c) 2013 Brian R. Toonen <toonen@alcf.anl.gov>
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+set -e
+sudo bash -c 'echo "deb http://archive.canonical.com/ubuntu precise partner" >> /etc/apt/sources.list'
+run_apt update
+run_apt install db2exc
+
+echo "Running db2profile and db2rmln"
+sudo /bin/sh -c '. ~db2inst1/sqllib/db2profile ; $DB2DIR/cfg/db2rmln'
+
+echo "Setting up db2 users"
+echo -e "db2inst1\ndb2inst1" | sudo passwd db2inst1
+echo -e "db2fenc1\ndb2fenc1" | sudo passwd db2fenc1
+echo -e "dasusr1\ndasusr1" | sudo passwd dasusr1
+
+echo "Configuring DB2 ODBC driver"
+if test `getconf LONG_BIT` = "64" ; then
+    if test -f /home/db2inst1/sqllib/lib64/libdb2o.so ; then
+        DB2_ODBC_DRIVER=/home/db2inst1/sqllib/lib64/libdb2o.so
+    else
+        echo "ERROR: can't find the 64-bit DB2 ODBC library"
+        exit 1
+    fi
+else
+    if test -f /home/db2inst1/sqllib/lib32/libdb2.so ; then
+        DB2_ODBC_DRIVER=/home/db2inst1/sqllib/lib32/libdb2.so
+    elif test -f /home/db2inst1/sqllib/lib/libdb2.so ; then
+        DB2_ODBC_DRIVER=/home/db2inst1/sqllib/lib/libdb2.so
+    else
+        echo "ERROR: can't find the 32-bit DB2 ODBC library"
+        exit 1
+    fi
+fi
+echo "DB2 ODBC driver set to $DB2_ODBC_DRIVER"
diff --git a/scripts/ci/install_firebird.sh b/scripts/ci/install_firebird.sh
new file mode 100755
index 0000000..7cc3b2e
--- /dev/null
+++ b/scripts/ci/install_firebird.sh
@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Install Firebird server for SOCI in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+codename=$(lsb_release -sc)
+case "$codename" in
+    trusty | xenial)
+        firebird_version=2.5
+        firebird_server_package=firebird2.5-super
+        firebird_server_service=firebird2.5-super
+        firebird_expect_enable=$(cat <<EOF
+expect "Enable Firebird server?"
+send "yes\r"
+EOF
+)
+        ;;
+
+    jammy | focal | bionic)
+        firebird_version=3.0
+        firebird_server_package=firebird3.0-server
+        firebird_server_service=firebird3.0
+        ;;
+
+    *)
+        echo "*** Can't install Firebird: unknown Ubuntu version $codename! ***"
+        exit 1
+esac
+
+run_apt install expect ${firebird_server_package} firebird-dev
+
+# Default frontend is "noninteractive", which prevents dpkg-reconfigure from
+# asking anything at all, so change it. Notice that we must do it via
+# environment and not using -f option of dpkg-reconfigure because it is
+# overridden by the existing environment variable (which is predefined).
+#
+# OTOH we do need to set priority to low using -p option below as otherwise we
+# wouldn't be asked to change the password after the initial installation.
+export DEBIAN_FRONTEND=teletype
+
+num_tries=1
+wait_time=6 # seconds
+
+while true; do
+
+echo "Reconfiguring Firebird (attempt #$num_tries):"
+
+# Expect script feeding dpkg-reconfigure prompts
+sudo --preserve-env /usr/bin/expect - << ENDMARK
+spawn dpkg-reconfigure -plow $firebird_server_package
+$firebird_expect_enable
+
+expect "Password for SYSDBA:"
+send "masterkey\r"
+
+# done
+expect eof
+ENDMARK
+# End of Expect script
+
+# Check that we've actually updated the password file as we sometimes fail to
+# do it with "Unable to complete network request to host localhost." error.
+firebird_password_file="/etc/firebird/$firebird_version/SYSDBA.password"
+
+# We have to be careful with grep as the password may or not be quoted, even
+# with the same Firebird version (2.5) on the same system (Ubuntu Xenial),
+# depending on whether we're running on Travis or GitHub CI.
+if sudo cat "$firebird_password_file" | egrep -q 'ISC_PASSWORD="?masterkey'; then
+    echo "Successfully updated $firebird_password_file:"
+    sudo grep ISC_ $firebird_password_file
+    break
+fi
+
+if [[ $num_tries -gt 10 ]]; then
+    echo "Failed to update Firebird password file after $num_tries attempts."
+    exit 1
+fi
+
+echo "Failed to reconfigure Firebird, retrying in $wait_time seconds..."
+sleep $wait_time
+((num_tries++))
+
+done
+
+echo
+echo "Firebird: restarting"
+sudo service $firebird_server_service restart
+echo "Firebird: DONE"
diff --git a/scripts/ci/install_odbc.sh b/scripts/ci/install_odbc.sh
new file mode 100755
index 0000000..f8d6962
--- /dev/null
+++ b/scripts/ci/install_odbc.sh
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Install ODBC libraries for SOCI in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+run_apt install \
+    tar bzip2 \
+    unixodbc unixodbc-dev \
+    odbc-postgresql odbc-postgresql-dbgsym
+
+# Use full path to the driver library to avoid errors like
+# [01000][unixODBC][Driver Manager]Can't open lib 'psqlodbca.so' : file not found
+psqlodbca_lib=$(dpkg -L odbc-postgresql | grep -F 'psqlodbca.so')
+sudo sed -i'' -e "s@^Driver=psqlodbca\.so@Driver=$psqlodbca_lib@" /etc/odbcinst.ini
+
+echo Contents of /etc/odbcinst.ini
+echo '---------------------------------- >8 --------------------------------------'
+cat /etc/odbcinst.ini
+echo '---------------------------------- >8 --------------------------------------'
diff --git a/scripts/ci/install_oracle.sh b/scripts/ci/install_oracle.sh
new file mode 100755
index 0000000..1ae4da1
--- /dev/null
+++ b/scripts/ci/install_oracle.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Sets up Oracle database for SOCI Oracle backend CI builds.
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+docker run --name ${ORACLE_CONTAINER} --detach --publish 1521:1521 -e ORACLE_ALLOW_REMOTE=true wnameless/oracle-xe-11g-r2
+
+echo 'Waiting for Oracle startup...'
+num_tries=1
+wait_time=6 # seconds
+while true; do
+    if oracle_exec /etc/init.d/oracle-xe status | grep -q 'Instance "XE", status READY'; then
+        if echo "SELECT STATUS, DATABASE_STATUS FROM V\$INSTANCE WHERE INSTANCE_NAME='XE';" | \
+            oracle_sqlplus sys/oracle AS SYSDBA | grep -q 'OPEN'; then
+            echo 'Oracle database is available now'
+            break
+        fi
+    fi
+
+    if [[ $num_tries -gt 50 ]]; then
+        echo 'Timed out waiting for Oracle startup'
+        break
+    fi
+
+    echo "Waiting $wait_time more seconds (attempt #$num_tries)"
+    sleep $wait_time
+    ((num_tries++))
+done
+
+echo 'Oracle log:'
+docker logs --timestamps ${ORACLE_CONTAINER}
+echo 'Oracle global status:'
+oracle_exec /etc/init.d/oracle-xe status
+echo 'Oracle instance status:'
+echo 'SELECT INSTANCE_NAME, STATUS, DATABASE_STATUS FROM V$INSTANCE;' | \
+oracle_sqlplus sys/oracle AS SYSDBA
+
+# Copy Oracle directory, notably containing the headers and the libraries
+# needed for the compilation, from the container.
+sudo mkdir -p ${ORACLE_HOME}
+sudo docker cp ${ORACLE_CONTAINER}:${ORACLE_HOME} ${ORACLE_HOME}/..
diff --git a/scripts/ci/install_valgrind.sh b/scripts/ci/install_valgrind.sh
new file mode 100755
index 0000000..2a1ea9f
--- /dev/null
+++ b/scripts/ci/install_valgrind.sh
@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Install Valgrind for SOCI in CI builds
+#
+# Copyright (c) 2020 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+run_apt install valgrind
diff --git a/scripts/ci/oracle.sh b/scripts/ci/oracle.sh
new file mode 100644
index 0000000..4afba9e
--- /dev/null
+++ b/scripts/ci/oracle.sh
@@ -0,0 +1,30 @@
+# Definitions used by SOCI when building Oracle backend in CI builds
+#
+# Copyright (c) 2015 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+# Notice that this file is not executable, it is supposed to be sourced from
+# the other files.
+
+# This is arbitrary.
+export ORACLE_CONTAINER=oracle-11g
+
+# We use the same name for the path inside and outside the container.
+export ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe
+export ORACLE_SID=XE
+
+# Add path to Oracle libraries.
+export LD_LIBRARY_PATH=$ORACLE_HOME/lib
+
+# Execute any command in the Oracle container: pass the command with its
+# arguments directly to the function.
+oracle_exec()
+{
+    docker exec ${ORACLE_CONTAINER} "$@"
+}
+
+# Execute SQLPlus in the Oracle container: pass the extra arguments to the
+# command to this function and its input on stdin.
+oracle_sqlplus()
+{
+    docker exec --interactive --env ORACLE_HOME=${ORACLE_HOME} --env ORACLE_SID=${ORACLE_SID} ${ORACLE_CONTAINER} "$ORACLE_HOME/bin/sqlplus" -S -L "$@"
+}
diff --git a/scripts/ci/test.sh b/scripts/ci/test.sh
new file mode 100755
index 0000000..847dc91
--- /dev/null
+++ b/scripts/ci/test.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# Run SOCI tests in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# run tests from the build directory
+cd ${builddir}
+
+# run the tests
+SCRIPT=${SOCI_SOURCE_DIR}/scripts/ci/test_${SOCI_CI_BACKEND}.sh
+if [ -x ${SCRIPT} ]; then
+  # use the custom script for this backend
+  echo "Running ${SCRIPT}"
+  ${SCRIPT}
+else
+  run_test
+fi
diff --git a/scripts/ci/test_db2.sh b/scripts/ci/test_db2.sh
new file mode 100755
index 0000000..8a6932e
--- /dev/null
+++ b/scripts/ci/test_db2.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Tests SOCI DB2 backend in CI builds
+#
+# Copyright (c) 2013 Brian R. Toonen <toonen@alcf.anl.gov>
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+# Copyright (c) 2021 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+LSAN_OPTIONS=suppressions=${SOCI_SOURCE_DIR}/scripts/suppress_db2.txt run_test
diff --git a/scripts/ci/test_firebird.sh b/scripts/ci/test_firebird.sh
new file mode 100755
index 0000000..a99c00b
--- /dev/null
+++ b/scripts/ci/test_firebird.sh
@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Tests SOCI FB backend in CI builds
+#
+# Copyright (c) 2021 Ilya Sinitsyn <isinitsyn@tt-solutions.com>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+LSAN_OPTIONS=suppressions=${SOCI_SOURCE_DIR}/scripts/suppress_firebird.txt run_test
diff --git a/scripts/ci/test_odbc.sh b/scripts/ci/test_odbc.sh
new file mode 100755
index 0000000..42af00a
--- /dev/null
+++ b/scripts/ci/test_odbc.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Tests SOCI ODBC backend in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+# Copyright (c) 2021 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+# Exclude the tests which can't be run due to the absence of ODBC drivers (MS
+# SQL and MySQL).
+run_test -E 'soci_odbc_test_m.sql'
diff --git a/scripts/ci/test_valgrind.sh b/scripts/ci/test_valgrind.sh
new file mode 100755
index 0000000..b9aa816
--- /dev/null
+++ b/scripts/ci/test_valgrind.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Builds SOCI for use with Valgrind in CI builds
+#
+# Copyright (c) 2013 Mateusz Loskot <mateusz@loskot.net>
+# Copyright (c) 2015 Sergei Nikulov <sergey.nikulov@gmail.com>
+# Copyright (c) 2021 Vadim Zeitlin <vz-soci@zeitlins.org>
+#
+source ${SOCI_SOURCE_DIR}/scripts/ci/common.sh
+
+valgrind --leak-check=full --suppressions=${SOCI_SOURCE_DIR}/valgrind.suppress --error-exitcode=1 --trace-children=yes ctest -V --output-on-failure "$@" .
diff --git a/scripts/release.sh b/scripts/release.sh
new file mode 100755
index 0000000..34e4bb5
--- /dev/null
+++ b/scripts/release.sh
@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+# This script is part of the release procedure of the SOCI library based
+# on current state of given release branch or master (see RELEASING.md).
+#
+# Copyright (c) 2019 Mateusz Loskot <mateusz@loskot.net>
+#
+# This script performs the following steps:
+# 1. If given release/X.Y exists
+#    - on remote as origin/release/X.Y, check it out;
+#    - locally, then pass option --use-local-branch to check it out;
+#    and use it as ready for packaging.
+# 3. Determine the full release version number from `SOCI_LIB_VERSION` value in include/soci/version.h.
+# 4. Build HTML documentation
+# 4.1. Create Python virtual environment
+# 4.2. Install MkDocs
+# 4.3. Build documentation
+# 5. Filter unwanted content
+#    - Website files
+#    - Markdown documentation and configuration files
+#    - CI configuration files
+#    - Development auxiliary files
+#    - Git auxiliary files
+# 6. Create archives (.zip, .tar.gz)
+#
+usage()
+{
+    echo "Usage: `realpath $0` [OPTIONS] <release/X.Y branch>"
+    echo "  --rc <N>            N is number of release candidate (e.g. from 1 to 9)"
+    echo "  --use-local-branch  Use existing local release/X.Y branch instead of checking out origin/release/X.Y"
+    echo "  --help, -h          Displays this message"
+    exit 1
+}
+ME=`basename "$0"`
+MSG_TAG="| $ME"
+
+UNAME_S="$(uname -s)"
+case "${UNAME_S}" in
+    Linux*)     THIS_SYS=Linux;;
+    Darwin*)    THIS_SYS=Mac;;
+    CYGWIN*)    THIS_SYS=Cygwin;;
+    MINGW*)     THIS_SYS=MinGW;;
+    *)          THIS_SYS="UNKNOWN:${UNAME_S}"
+esac
+if [[ "$THIS_SYS" != "Linux" ]]; then
+    echo "${MSG_TAG} ERROR: This script requires Linux. Yours is '$THIS_SYS'. Aborting."
+    exit 1
+fi
+if [[ ! -d "$PWD/.git" ]] || [[ ! -r "$PWD/include/soci/version.h" ]]; then
+    echo "${MSG_TAG} ERROR: Directory '$PWD' is not Git repository. Aborting."
+    exit 1
+fi
+
+OPT_USE_LOCAL_RELEASE_BRANCH=0
+OPT_GIT_RELEASE_BRANCH=""
+OPT_RC_NUMBER=""
+while [[ $# -gt 0 ]];
+do
+    case $1 in
+        --rc) test ! -z $2 && OPT_RC_NUMBER=$2; shift; echo "${MSG_TAG} INFO: Setting --rc=$OPT_RC_NUMBER, building release candidate archive";;
+        --use-local-branch) OPT_USE_LOCAL_RELEASE_BRANCH=1; echo "${MSG_TAG} INFO: Setting --use-local-branch on, using existing local release/X.Y branch";;
+        -h|--help) usage;;
+        *) OPT_GIT_RELEASE_BRANCH=$1;;
+    esac;
+    shift
+done
+
+if [[ -n "$OPT_RC_NUMBER" ]] && [[ ! "$OPT_RC_NUMBER" =~ ^[1-9]+$ ]]; then
+    echo "${MSG_TAG} ERROR: Release candidate must be single digit integer from 1 to 9, not '$OPT_RC_NUMBER'. Aborting."
+    exit 1
+fi
+
+GIT_RELEASE_BRANCH=$OPT_GIT_RELEASE_BRANCH
+if [[ -z "$GIT_RELEASE_BRANCH" ]] || [[ ! "$GIT_RELEASE_BRANCH" =~ ^release/[3-9]\.[0-9]$ ]]; then
+    echo "${MSG_TAG} ERROR: Missing valid 'release/X.Y' branch name i.e. release/3.0 or later"
+    usage
+    exit 1
+fi
+
+GIT_CURRENT_BRANCH=$(git branch | grep \* | cut -d ' ' -f2)
+echo "${MSG_TAG} INFO: Current branch is $GIT_CURRENT_BRANCH"
+echo "${MSG_TAG} INFO: Releasing branch $GIT_RELEASE_BRANCH"
+
+echo "${MSG_TAG} INFO: Fetching branches from origin"
+git fetch origin
+
+# Checkout branch release/X.Y
+GIT_LOCAL_RELEASE_BRANCH=$(git branch -a | grep -Po "(\*?\s+)\K$GIT_RELEASE_BRANCH")
+if [[ $OPT_USE_LOCAL_RELEASE_BRANCH -eq 1 ]]; then
+    if [[ -n "$GIT_LOCAL_RELEASE_BRANCH" ]]; then
+        echo "${MSG_TAG} INFO: Checking out branch '$GIT_RELEASE_BRANCH'"
+        git checkout $GIT_RELEASE_BRANCH || exit 1
+        echo "${MSG_TAG} INFO: Updating branch '$GIT_RELEASE_BRANCH' from origin"
+        git pull --ff-only origin $GIT_RELEASE_BRANCH || exit 1
+    else
+        echo "${MSG_TAG} ERROR: Local release branch '$GIT_LOCAL_RELEASE_BRANCH' does not exists. Aborting."
+        exit 1
+    fi
+else
+    if [[ -n "$GIT_LOCAL_RELEASE_BRANCH" ]]; then
+        echo "${MSG_TAG} ERROR: Local release branch '$GIT_LOCAL_RELEASE_BRANCH' already exists. Aborting."
+        echo "${MSG_TAG} INFO: Delete the local branch and run again to checkout 'origin/$GIT_RELEASE_BRANCH'."
+        exit 1
+    fi
+fi
+
+# Checkout branch origin/release/X.Y as release/X.Y
+if [[ $OPT_USE_LOCAL_RELEASE_BRANCH -eq 0 ]]; then
+    GIT_REMOTE_RELEASE_BRANCH=$(git branch -a | grep -Po "(\*?\s+)\Kremotes/origin/$GIT_RELEASE_BRANCH")
+    if [[ -n "$GIT_REMOTE_RELEASE_BRANCH" ]]; then
+        echo "${MSG_TAG} INFO: Release branch 'origin/$GIT_RELEASE_BRANCH' does exist. Checking it out."
+        git checkout -b $GIT_RELEASE_BRANCH --no-track origin/$GIT_RELEASE_BRANCH || exit 1
+        git pull --ff-only origin $GIT_RELEASE_BRANCH || exit 1
+    else
+        echo "${MSG_TAG} ERROR: Release branch 'origin/$GIT_RELEASE_BRANCH' does not exist. Aborting"
+        echo "${MSG_TAG} INFO: Create release branch 'origin/$GIT_RELEASE_BRANCH' and run again."
+        exit 1
+    fi
+fi
+
+GIT_CURRENT_RELEASE_BRANCH=$(git branch -a | grep -Po "(\*\s+)\K$GIT_RELEASE_BRANCH")
+if [[ "$GIT_CURRENT_RELEASE_BRANCH" != "$GIT_RELEASE_BRANCH" ]]; then
+    echo "${MSG_TAG} ERROR: Current branch is not '$GIT_RELEASE_BRANCH' but '$GIT_CURRENT_RELEASE_BRANCH'. Aborting."
+    exit 1
+fi
+
+SOCI_VERSION=$(cat "$PWD/include/soci/version.h" | grep -Po "(.*#define\s+SOCI_LIB_VERSION\s+.+)\K([3-9]_[0-9]_[0-9])" | sed "s/_/\./g")
+if [[ ! "$SOCI_VERSION" =~ ^[4-9]\.[0-9]\.[0-9]$ ]]; then
+    echo "${MSG_TAG} ERROR: Invalid format of SOCI version '$SOCI_VERSION'. Aborting."
+    exit 1
+else
+    echo "${MSG_TAG} INFO: Releasing version $SOCI_VERSION"
+fi
+
+SOCI_FULL_VERSION=$SOCI_VERSION
+if [[ -n $OPT_RC_NUMBER ]];then
+    SOCI_FULL_VERSION=$SOCI_VERSION-rc$OPT_RC_NUMBER
+fi
+SOCI_ARCHIVE=soci-$SOCI_FULL_VERSION
+
+if [[ -d "$SOCI_ARCHIVE" ]]; then
+    echo "${MSG_TAG} ERROR: Directory '$SOCI_ARCHIVE' already exists. Aborting."
+    echo "${MSG_TAG} INFO: Delete it and run again."
+    exit 1
+fi
+if [[ -f "${SOCI_ARCHIVE}.zip" ]]; then
+    echo "${MSG_TAG} ERROR: Archive '${SOCI_ARCHIVE}.zip' already exists. Aborting."
+    echo "${MSG_TAG} INFO: Delete it and run again."
+    exit 1
+fi
+if [[ -f "${SOCI_ARCHIVE}.tar.gz" ]]; then
+    echo "${MSG_TAG} ERROR: Archive '${SOCI_ARCHIVE}.tar.gz' already exists. Aborting."
+    echo "${MSG_TAG} INFO: Delete it and run again."
+    exit 1
+fi
+
+if [[ -d $PWD/.venv ]] && [[ ! -f $PWD/.venv/bin/activate ]]; then
+    echo "${MSG_TAG} ERROR: Directory '$PWD/.venv' already exists. Can not create Python environment. Aborting."
+    exit 1
+fi
+
+if [[ ! -f $PWD/.venv/bin/activate ]]; then
+    MASTER_PY=""
+    if command -v python3 &>/dev/null; then
+        MASTER_PY=$(which python3)
+    fi
+    if [[ -z "$MASTER_PY" ]] && command -v python &>/dev/null; then
+        MASTER_PY=$(which python)
+    fi
+    if [[ -z "$MASTER_PY" ]] || [[ ! $($MASTER_PY --version) =~ ^Python.+3 ]]; then
+        echo "${MSG_TAG} ERROR: Python 3 not found. Aborting."
+        exit 1
+    else
+        echo "${MSG_TAG} INFO: Creating Python virtual environment using $MASTER_PY (`$MASTER_PY --version`)"
+    fi
+    $MASTER_PY -m venv $PWD/.venv || exit 1
+fi
+
+if [[ ! -f $PWD/.venv/bin/activate ]]; then
+    echo "${MSG_TAG} ERROR: Python virtual environment script '$PWD/.venv/bin/activate' not found. Aborting."
+    exit 1
+fi
+source $PWD/.venv/bin/activate
+echo "${MSG_TAG} INFO: Using Python from `which python` (`python --version`)"
+python -m pip --quiet install --upgrade pip
+python -m pip --quiet install --upgrade mkdocs
+
+echo "${MSG_TAG} INFO: Building documentation with `mkdocs --version`"
+mkdocs build --clean
+
+echo "${MSG_TAG} INFO: Exiting Python virtual environment"
+deactivate
+
+echo "${MSG_TAG} INFO: Preparing release archive in '$SOCI_ARCHIVE'"
+mkdir $SOCI_ARCHIVE
+cp -a cmake $SOCI_ARCHIVE
+cp -a include $SOCI_ARCHIVE
+cp -a languages $SOCI_ARCHIVE
+cp -a src $SOCI_ARCHIVE
+cp -a tests $SOCI_ARCHIVE
+cp -a AUTHORS CMakeLists.txt LICENSE_1_0.txt README.md Vagrantfile $SOCI_ARCHIVE/
+mv site $SOCI_ARCHIVE/docs
+
+# Add git SHA-1 to version in CHANGES file
+RELEASE_BRANCH_SHA1=$(git show-ref --hash=8 origin/$GIT_RELEASE_BRANCH)
+echo "${MSG_TAG} INFO: Appending '$RELEASE_BRANCH_SHA1' hash to version in '$SOCI_ARCHIVE/CHANGES'"
+cat CHANGES | sed "s/Version $SOCI_VERSION.*differs/Version $SOCI_FULL_VERSION ($RELEASE_BRANCH_SHA1) differs/" > $SOCI_ARCHIVE/CHANGES
+
+echo "${MSG_TAG} INFO: Building release archive '$SOCI_ARCHIVE.zip'"
+zip -q -r $SOCI_ARCHIVE.zip $SOCI_ARCHIVE
+if [[ $? -ne 0 ]]; then
+    echo "${MSG_TAG} ERROR: zip failed. Aborting."
+    exit 1
+fi
+
+echo "${MSG_TAG} INFO: Building release archive '$SOCI_ARCHIVE.tar.gz'"
+tar -czf $SOCI_ARCHIVE.tar.gz $SOCI_ARCHIVE
+if [[ $? -ne 0 ]]; then
+    echo "${MSG_TAG} ERROR: tar failed. Aborting."
+    exit 1
+fi
+
+echo "${MSG_TAG} INFO: Cleaning up"
+rm -rf "${SOCI_ARCHIVE}"
+git checkout $GIT_CURRENT_BRANCH
+
+if [[ $OPT_USE_LOCAL_RELEASE_BRANCH -eq 0 ]]; then
+    echo "${MSG_TAG} INFO: Deleting '$GIT_RELEASE_BRANCH' checked out from 'origin/$GIT_RELEASE_BRANCH'."
+    git branch -D $GIT_RELEASE_BRANCH
+fi
+
+echo "${MSG_TAG} INFO: Done"
diff --git a/scripts/suppress_db2.txt b/scripts/suppress_db2.txt
new file mode 100644
index 0000000..5421ec0
--- /dev/null
+++ b/scripts/suppress_db2.txt
@@ -0,0 +1,11 @@
+# This is a suppression file for LeakSanitizer when running DB2 tests.
+
+# This DB2 function leaks memory during initialization.
+leak:LicInitializeNetls
+
+# There is also some other unidentifiable leak from libdb2.so.
+leak:libdb2.so
+
+# And unfortunately there are some other unidentifiable leaks that we also need
+# to disable, even if this means that we'll probably miss any new leaks too.
+leak:libasan.so
diff --git a/scripts/suppress_firebird.txt b/scripts/suppress_firebird.txt
new file mode 100644
index 0000000..1095e3f
--- /dev/null
+++ b/scripts/suppress_firebird.txt
@@ -0,0 +1,4 @@
+# This is a suppression file for LeakSanitizer when running FB tests.
+
+# This FB function leaks memory during initialization.
+leak:isc_attach_database
diff --git a/scripts/vagrant/bootstrap.sh b/scripts/vagrant/bootstrap.sh
new file mode 100755
index 0000000..61e03c0
--- /dev/null
+++ b/scripts/vagrant/bootstrap.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Pre-installation
+echo "Bootstrap: setting common environment in /etc/profile.d/vagrant-soci.sh"
+sudo sh -c "cat /vagrant/scripts/vagrant/common.env > /etc/profile.d/vagrant-soci.sh"
+export DEBIAN_FRONTEND="noninteractive"
+# Installation
+# TODO: Switch to apt-fast when it is avaiable for Trusty
+sudo apt-get update -y -q
+sudo apt-get -o Dpkg::Options::='--force-confnew' -y -q install \
+  build-essential \
+  avahi-daemon \
+  zip
+# Post-installation
+## Configure Avahi to enable .local hostnames used to connect between VMs.
+echo "Bootstrap: updating /etc/nsswitch.conf to configure Avahi/MDNS for .local lookup"
+sudo sed -i 's/hosts:.*/hosts:          files mdns4_minimal [NOTFOUND=return] dns myhostname/g' /etc/nsswitch.conf
diff --git a/scripts/vagrant/build.sh b/scripts/vagrant/build.sh
new file mode 100755
index 0000000..e302d6b
--- /dev/null
+++ b/scripts/vagrant/build.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Builds and tests SOCI from git master branch
+source /vagrant/scripts/vagrant/common.env
+
+# Build SOCI in /home/vagrant on Linux filesystem,
+# outside /vagrant which is VM shared directory.
+# Otherwise, CMake will fail:
+# CMake Error: cmake_symlink_library: System Error: Protocol error
+# Explanation from https://github.com/mitchellh/vagrant/issues/713
+# The VirtualBox shared folder filesystem doesn't allow symlinks, unfortunately.
+# Your only option is to deploy outside of the shared folders.
+if [[ ! -d "${SOCI_BUILD}" ]] ; then
+  mkdir -p ${SOCI_BUILD}
+fi
+
+echo "Build: building SOCI from sources in ${SOCI_HOME} to build in ${SOCI_BUILD}"
+cd ${SOCI_BUILD} && \
+cmake \
+    -DSOCI_TESTS=ON \
+    -DSOCI_STATIC=OFF \
+    -DSOCI_DB2=ON \
+    -DSOCI_ODBC=OFF \
+    -DSOCI_ORACLE=OFF \
+    -DSOCI_EMPTY=ON \
+    -DSOCI_FIREBIRD=ON \
+    -DSOCI_MYSQL=ON \
+    -DSOCI_POSTGRESQL=ON \
+    -DSOCI_SQLITE3=ON \
+    -DSOCI_DB2_TEST_CONNSTR:STRING="DATABASE=${SOCI_USER}\\;hostname=${SOCI_DB2_HOST}\\;UID=${SOCI_DB2_USER}\\;PWD=${SOCI_DB2_PASS}\\;ServiceName=50000\\;Protocol=TCPIP\\;" \
+    -DSOCI_FIREBIRD_TEST_CONNSTR:STRING="service=LOCALHOST:/tmp/soci.fdb user=${SOCI_USER} password=${SOCI_PASS}" \
+    -DSOCI_MYSQL_TEST_CONNSTR:STRING="host=localhost db=${SOCI_USER} user=${SOCI_USER} password=${SOCI_PASS}" \
+    -DSOCI_POSTGRESQL_TEST_CONNSTR:STRING="host=localhost port=5432 dbname=${SOCI_USER} user=${SOCI_USER} password=${SOCI_PASS}" \
+    ${SOCI_HOME} && \
+make
+echo "Build: building DONE"
+
+# Do not run tests during provisioning, thay may fail terribly, so just build
+# and let to run them manually after developer vagrant ssh'ed to the VM.
+echo "Build: ready to test SOCI by running: cd ${SOCI_BUILD}; ctest -V --output-on-failure ."
diff --git a/scripts/vagrant/common.env b/scripts/vagrant/common.env
new file mode 100644
index 0000000..7f97405
--- /dev/null
+++ b/scripts/vagrant/common.env
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+export SOCI_HOME=/vagrant
+export SOCI_BUILD=/home/vagrant/soci-build
+export SOCI_HOST=vmsoci.local
+# SOCI_USER has two purposes: database user name, database name
+export SOCI_USER=soci
+export SOCI_PASS=soci
+export SOCI_DB2_HOST=vmdb2.local
+export SOCI_DB2_USER=db2inst1
+export SOCI_DB2_PASS=db2inst1
diff --git a/scripts/vagrant/db2.sh b/scripts/vagrant/db2.sh
new file mode 100755
index 0000000..36a87f7
--- /dev/null
+++ b/scripts/vagrant/db2.sh
@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Installs DB2 Express-C 9.7
+# Pre-installation
+source /vagrant/scripts/vagrant/common.env
+export DEBIAN_FRONTEND="noninteractive"
+# Installation
+/vagrant/scripts/ci/install_db2.sh
+# Post-installation
+## Let's be gentle to DB2 and try to not to recreate existing databases
+echo "db2: checking if ${SOCI_USER} database exists"
+# First time guest machine is created, there is no database, hence test for:
+# SQL1031N  The database directory cannot be found on the indicated file system.
+sudo -u db2inst1 -i db2 "LIST DATABASE DIRECTORY" | grep SQL1031N
+NODB=$?
+sudo -u db2inst1 -i db2 "LIST DATABASE DIRECTORY" | grep -i ${SOCI_USER}
+HASSOCI=$?
+if [[ $NODB -eq 0 || $HASSOCI -ne 0 ]]; then
+  echo "db2: creating database ${SOCI_USER}"
+  sudo -u db2inst1 -i db2 "CREATE DATABASE ${SOCI_USER}"
+  sudo -u db2inst1 -i db2 "ACTIVATE DATABASE ${SOCI_USER}"
+else
+  echo "db2: database ${SOCI_USER} (may) exists, skipping"
+fi
diff --git a/scripts/vagrant/db2cli.sh b/scripts/vagrant/db2cli.sh
new file mode 100755
index 0000000..99102cf
--- /dev/null
+++ b/scripts/vagrant/db2cli.sh
@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Installs DB2 CLI Driver 10.5 (64-bit and 32-bit) from
+# IBM Data Server Driver Package (DS Driver)
+
+# Prerequisities (manual download if wget fails):
+# 1. Go to http://www-01.ibm.com/support/docview.wss?uid=swg21385217
+# 2. Go to "IBM Data Server Driver Package (DS Driver)"
+# 3. Download "IBM Data Server Driver Package (Linux AMD64 and Intel EM64T)"
+# 4. Copy the package to '{SOCI SOURCE TREE ROOT}/tmp' directory.
+DSPKG="ibm_data_server_driver_package_linuxx64_v10.5.tar.gz"
+DSPREFIX=/opt/ibm
+DSDRIVER=${DSPREFIX}/dsdriver
+SOCITMP=/vagrant/tmp
+
+# Try to download from known location
+echo "DB2CLI: downloading ${DSPKG} from github.com/rorymckinley/gold_importer"
+wget -q https://raw.githubusercontent.com/rorymckinley/gold_importer/master/3rdparty/ibm_data_server_driver_package_linuxx64_v10.5.tar.gz
+
+# Check if driver package is available
+if [[ ! -f ${DSPKG} && ! -f ${SOCITMP}/${DSPKG} ]]; then
+  echo "DB2CLI: missing ${SOCITMP}/${DSPKG}"
+  echo "DB2CLI: try manual download, then provision VM to install"
+  echo "DB2CLI: meanwhile, skipping driver installation"
+  exit 0
+fi
+
+if [ -f ${SOCITMP}/${DSPKG} ]; then
+    DSPKG=${SOCITMP}/${DSPKG}
+fi
+
+# If the drivers is already installed, skip re-installation
+# because installDSDriver script does not support it
+if [[ -d "${DSDRIVER}" && -f ${DSDRIVER}/db2profile ]]; then
+  echo "DB2CLI: ${DSDRIVER} already installed, skipping"
+  echo "DB2CLI: if necessary, upgrade manually running: ${DSDRIVER}/installDSDriver -upgrade ${DSDRIVER}"
+  exit 0
+fi
+
+# Korn shell required by installDSDriver script
+sudo apt-get -o Dpkg::Options::='--force-confnew' -y -q install \
+  ksh
+
+echo "DB2CLI: unpacking ${DSPKG} to ${DSPREFIX}"
+sudo mkdir -p ${DSPREFIX}
+sudo tar -zxf ${DSPKG} -C ${DSPREFIX}
+echo "DB2CLI: running ${DSDRIVER}/installDSDriver script"
+sudo ${DSDRIVER}/installDSDriver
+echo "DB2CLI: cat ${DSDRIVER}/installDSDriver.log"
+cat ${DSDRIVER}/installDSDriver.log
+echo
+echo "DB2CLI: installing ${DSDRIVER}/db2profile in /etc/profile.d/db2profile.sh for 64-bit env"
+sudo cp ${DSDRIVER}/db2profile /etc/profile.d/db2profile.sh
+echo "DB2CLI: For 32-bit, manually source ${DSDRIVER}/db2profile32 to overwrite 64-bit env"
diff --git a/scripts/vagrant/devel.sh b/scripts/vagrant/devel.sh
new file mode 100755
index 0000000..67ce137
--- /dev/null
+++ b/scripts/vagrant/devel.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Installs essentials and core dependencies
+# Pre-installation
+source /vagrant/scripts/vagrant/common.env
+export DEBIAN_FRONTEND="noninteractive"
+# Trusty has CMake 2.8, we need CMake 3
+sudo apt-get install software-properties-common
+sudo add-apt-repository ppa:george-edison55/cmake-3.x
+sudo apt-get update -y -q
+# Installation
+sudo apt-get -o Dpkg::Options::='--force-confnew' -y -q install \
+  build-essential \
+  cmake \
+  firebird2.5-dev \
+  git \
+  libboost-dev \
+  libboost-date-time-dev \
+  libmyodbc \
+  libmysqlclient-dev \
+  libpq-dev \
+  libsqlite3-dev \
+  odbc-postgresql \
+  unixodbc-dev \
+  valgrind
+# Post-installation
diff --git a/scripts/vagrant/firebird.sh b/scripts/vagrant/firebird.sh
new file mode 100755
index 0000000..e7e7858
--- /dev/null
+++ b/scripts/vagrant/firebird.sh
@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Installs PostgreSQL with 'soci' user and database
+# Pre-installation
+source /vagrant/scripts/vagrant/common.env
+export DEBIAN_FRONTEND="noninteractive"
+# FIXME: these debconf lines should automate the Firebird config but do/may not :(
+# However, keep them enabled to allow smooth(er) apt-get/dpkg operations.
+# Othwerise, installation of firebird packages may fail, randomly.
+# We work around this bug with Expect script below used to update SYSDBA password.
+sudo debconf-set-selections <<< "firebird2.5-super shared/firebird/enabled boolean true"
+sudo debconf-set-selections <<< "firebird2.5-super shared/firebird/sysdba_password/first_install password masterkey"
+# Installation
+sudo apt-get -o Dpkg::Options::='--force-confnew' -y -q install \
+  expect \
+  firebird2.5-super
+# Post-installation
+FB_ORIGINAL_PASS=`sudo cat /etc/firebird/2.5/SYSDBA.password \
+  | grep ISC_PASSWORD | sed -e 's/ISC_PASSWORD="\([^"]*\)".*/\1/'`
+echo "Firebird: dpkg-reconfigure resetting sysdba password from ${FB_ORIGINAL_PASS} to ${SOCI_PASS}"
+export DEBIAN_FRONTEND="readline"
+# Expect script feeding dpkg-reconfigure prompts
+sudo /usr/bin/expect - << ENDMARK > /dev/null
+spawn dpkg-reconfigure firebird2.5-super -freadline
+expect "Enable Firebird server?"
+send "Y\r"
+
+expect "Password for SYSDBA:"
+send "${SOCI_PASS}\r"
+
+# done
+expect eof
+ENDMARK
+# End of Expect script
+export DEBIAN_FRONTEND="noninteractive"
+echo "Firebird: cat /etc/firebird/2.5/SYSDBA.password"
+sudo cat /etc/firebird/2.5/SYSDBA.password | grep ISC_
+echo
+echo "Firebird: creating user ${SOCI_USER}"
+sudo gsec -user sysdba -pass ${SOCI_PASS} -delete ${SOCI_USER}
+sudo gsec -user sysdba -pass ${SOCI_PASS} -add ${SOCI_USER} -pw ${SOCI_PASS} -admin yes
+echo "Firebird: creating database /tmp/${SOCI_USER}.fdb"
+sudo rm -f /tmp/${SOCI_USER}.fdb
+echo "CREATE DATABASE \"LOCALHOST:/tmp/${SOCI_USER}.fdb\";" \
+  | isql-fb -q -u ${SOCI_USER} -p ${SOCI_PASS}
+echo "Firebird: restarting"
+sudo service firebird2.5-super restart
+echo "Firebird: DONE"
diff --git a/scripts/vagrant/mysql.sh b/scripts/vagrant/mysql.sh
new file mode 100755
index 0000000..89eb3bf
--- /dev/null
+++ b/scripts/vagrant/mysql.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Installs MySQL with 'soci' user and database
+# Pre-installation
+source /vagrant/scripts/vagrant/common.env
+export DEBIAN_FRONTEND="noninteractive"
+sudo debconf-set-selections <<< "mysql-server mysql-server/root_password password ${SOCI_PASS}"
+sudo debconf-set-selections <<< "mysql-server mysql-server/root_password_again password ${SOCI_PASS}"
+# Installation
+sudo apt-get -o Dpkg::Options::='--force-confnew' -y -q install \
+  mysql-server
+# Post-installation
+echo "MySQL: updating /etc/mysql/my.cnf"
+sudo sed -i "s/bind-address.*/bind-address = 0.0.0.0/" /etc/mysql/my.cnf
+echo "MySQL: setting root password to ${SOCI_PASS}"
+mysql -uroot -p${SOCI_PASS} -e \
+  "GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '${SOCI_PASS}' WITH GRANT OPTION; FLUSH PRIVILEGES;"
+echo "MySQL: creating user ${SOCI_USER}"
+mysql -uroot -p${SOCI_PASS} -e \
+  "GRANT ALL PRIVILEGES ON ${SOCI_USER}.* TO '${SOCI_USER}'@'%' IDENTIFIED BY '${SOCI_PASS}' WITH GRANT OPTION"
+mysql -uroot -p${SOCI_PASS} -e "DROP DATABASE IF EXISTS ${SOCI_USER}"
+echo "MySQL: creating database ${SOCI_USER}"
+mysql -uroot -p${SOCI_PASS} -e "CREATE DATABASE ${SOCI_USER}"
+echo "MySQL: restarting"
+sudo service mysql restart
+echo "MySQL: DONE"
diff --git a/scripts/vagrant/postgresql.sh b/scripts/vagrant/postgresql.sh
new file mode 100755
index 0000000..21f0d13
--- /dev/null
+++ b/scripts/vagrant/postgresql.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Part of Vagrant virtual development environments for SOCI
+
+# Installs PostgreSQL with 'soci' user and database
+# Pre-installation
+source /vagrant/scripts/vagrant/common.env
+export DEBIAN_FRONTEND="noninteractive"
+# Installation
+sudo apt-get -o Dpkg::Options::='--force-confnew' -y -q install \
+  postgresql \
+  postgresql-contrib
+# Post-installation
+echo "PostgreSQL: updating /etc/postgresql/9.3/main/postgresql.conf"
+sudo sed -i "s/#listen_address.*/listen_addresses '*'/" /etc/postgresql/9.3/main/postgresql.conf
+echo "PostgreSQL: updating /etc/postgresql/9.3/main/pg_hba.conf"
+sudo cat >> /etc/postgresql/9.3/main/pg_hba.conf <<EOF
+# Accept all IPv4 connections - DEVELOPMENT ONLY
+host    all         all         0.0.0.0/0             md5
+EOF
+echo "PostgreSQL: creating user ${SOCI_USER}"
+sudo -u postgres psql -c "CREATE ROLE ${SOCI_USER} WITH LOGIN SUPERUSER CREATEDB ENCRYPTED PASSWORD '${SOCI_PASS}'"
+echo "PostgreSQL: creating database ${SOCI_USER}"
+sudo -u postgres dropdb --if-exists ${SOCI_USER}
+sudo -u postgres createdb ${SOCI_USER} --owner=${SOCI_USER}
+echo "PostgreSQL: restarting"
+sudo service postgresql restart
+echo "PostgreSQL: DONE"
diff --git a/scripts/vm/debian-oracle10g-install.sh b/scripts/vm/debian-oracle10g-install.sh
new file mode 100755
index 0000000..a96b983
--- /dev/null
+++ b/scripts/vm/debian-oracle10g-install.sh
@@ -0,0 +1,89 @@
+#/bin/sh
+# Script performs non-interactive instllation of Oracle XE 10g on Debian
+#
+# Based on oracle10g-update.sh from HTSQL project:
+# https://bitbucket.org/prometheus/htsql
+#
+# Modified by Mateusz Loskot <mateusz@loskot.net>
+# Changes:
+# - Add fake swap support (backup /usr/bin/free manually anyway!)
+#
+set -ex
+
+#
+# Utilities
+#
+function free_backup()
+{
+    # Multiple copies to be on safe side
+    cp /usr/bin/free /root
+    mv /usr/bin/free /usr/bin/free.original
+}
+
+function free_restore()
+{
+    cp /usr/bin/free.original /usr/bin/free
+}
+
+# Install fake free
+# http://www.axelog.de/2010/02/7-oracle-ee-refused-to-install-into-openvz/
+free_backup
+cat <<EOF >> /usr/bin/free
+#!/bin/sh
+cat <<__eof
+             total       used       free     shared    buffers     cached
+Mem:       1048576     327264     721312          0          0          0
+-/+ buffers/cache:     327264     721312
+Swap:      2000000          0    2000000
+__eof
+exit
+EOF
+chmod 755 /usr/bin/free
+
+# Enable HTTPS for APT repositories.
+apt-get -q update
+apt-get -qy install apt-transport-https
+
+# Register the Oracle repository.
+echo "deb https://oss.oracle.com/debian/ unstable main non-free" >/etc/apt/sources.list.d/oracle.list
+wget -q https://oss.oracle.com/el4/RPM-GPG-KEY-oracle -O- | apt-key add -
+apt-get -q update
+
+# Install the Oracle 10g Express Edition.
+apt-get -qy install oracle-xe
+
+# Clean APT cache.
+apt-get clean
+
+# Fix the problem when the configuration script eats the last
+# character of the password if it is 'n': replace IFS="\n" with IFS=$'\n'.
+sed -i -e s/IFS=\"\\\\n\"/IFS=\$\'\\\\n\'/ /etc/init.d/oracle-xe
+
+# Configure the server; provide the answers for the following questions:
+# The HTTP port for Oracle Application Express: 8080
+# A port for the database listener: 1521
+# The password for the SYS and SYSTEM database accounts: admin
+# Start the server on boot: yes
+/etc/init.d/oracle-xe configure <<END
+8080
+1521
+admin
+admin
+y
+END
+
+# Load Oracle environment variables so that we could run `sqlplus`.
+. /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
+
+# Increase the number of connections.
+echo "ALTER SYSTEM SET PROCESSES=40 SCOPE=SPFILE;" | \
+sqlplus -S -L sys/admin AS SYSDBA
+
+# Set Oracle environment variables on login.
+cat <<END >>/root/.bashrc
+
+. /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
+END
+
+free_restore
+
diff --git a/scripts/windows/Get-ODBCList.ps1 b/scripts/windows/Get-ODBCList.ps1
new file mode 100644
index 0000000..4ede88d
--- /dev/null
+++ b/scripts/windows/Get-ODBCList.ps1
@@ -0,0 +1,105 @@
+Function Get-ODBCList
+{
+    <#
+	.SYNOPSIS
+	    Get ODBC list.
+
+	.DESCRIPTION
+	    The Get-ODBCList cmdlet to Get ODBC connectors list on specific machine.
+		
+	.PARAMETER ComputerName
+	    Specifies a computer name.
+		
+	.EXAMPLE
+		PS C:\> Get-ODBCList -ComputerName "g1","g2","g3"
+
+		ODBC                                                        ComputerName
+		----                                                        ------------
+		SQL Server                                                  g1
+		Microsoft Access Driver (*.mdb, *.accdb)                    g1
+		Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)      g1
+		Microsoft Access dBASE Driver (*.dbf, *.ndx, *.mdx)         g1
+		Microsoft Access Text Driver (*.txt, *.csv)                 g1
+		SQL Server Native Client 10.0                               g1
+		SQL Native Client                                           g1
+		SQL Server                                                  g2
+		SQL Server                                                  g3
+		
+	.NOTES
+		Author: Michal Gajda
+		Blog  : http://commandlinegeeks.com/
+	#>
+	[CmdletBinding(
+		SupportsShouldProcess=$True,
+		ConfirmImpact="Low"
+	)]
+	Param
+	(
+		[parameter(ValueFromPipeline=$true,
+			ValueFromPipelineByPropertyName=$true)]		
+		[String[]]$ComputerName = $env:COMPUTERNAME
+	)
+
+	Begin
+	{
+		$Key = "SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers"
+		$KeyWow64 = "SOFTWARE\Wow6432Node\ODBC\ODBCINST.INI\ODBC Drivers"
+		$Type = [Microsoft.Win32.RegistryHive]::LocalMachine
+	} #End Begin
+	
+	Process
+	{
+		Foreach($Computer in $ComputerName)
+		{
+			If(Test-Connection $Computer -Quiet)
+			{
+				Try
+				{
+					$regKey = [Microsoft.Win32.RegistryKey]::OpenRemoteBaseKey($Type, $Computer)
+					$regSubKey = $regKey.OpenSubKey($Key)
+					$regSubKeyWow64 = $regKey.OpenSubKey($KeyWow64)
+				}
+				Catch
+				{
+					Write-Error $_.Exception.Message -ErrorAction Stop
+				}
+				
+				if($regSubKey -and $regSubKeyWow64)
+				{
+					$Bits = 64
+				} #End if $regSubKey -and $regSubKeyWow64
+				else
+				{
+					$Bits = 32
+				} #End Else $regSubKey -and $regSubKeyWow64
+				
+				Foreach($val in $regSubKey.GetValueNames())
+				{
+					$log = New-Object PSObject -Property @{
+						ComputerName = $Computer
+						ODBC = $val
+						Bits = $Bits
+					} #End New-Object PSObject
+					
+					$log
+				} #End ForEach $val in $regSubKey.GetValueNames()
+				
+				if($Bits -eq 64)
+				{
+					Foreach($val in $regSubKeyWow64.GetValueNames())
+					{
+						$log = New-Object PSObject -Property @{
+							ComputerName = $Computer
+							ODBC = $val	
+							Bits = 32
+						} #End New-Object PSObject
+						
+						$log
+					} #End ForEach $val in $regSubKeyWow64.GetValueNames()
+				} #End If $Bits -eq 64
+			} #End If Test-Connection $Computer -Quiet
+		} #End Foreach $Computer in $ComputerName
+	} #End Process
+	
+	End{}
+} #In The End :)
\ No newline at end of file
diff --git a/scripts/windows/mssql_db_create.sql b/scripts/windows/mssql_db_create.sql
new file mode 100644
index 0000000..c5a0b67
--- /dev/null
+++ b/scripts/windows/mssql_db_create.sql
@@ -0,0 +1 @@
+IF db_id('soci_test') IS NULL BEGIN CREATE DATABASE [soci_test] END;
diff --git a/src/backends/db2/blob.cpp b/src/backends/db2/blob.cpp
index 6c3fcb0..2631d98 100644
--- a/src/backends/db2/blob.cpp
+++ b/src/backends/db2/blob.cpp
@@ -10,7 +10,7 @@
 #include "soci/db2/soci-db2.h"
 
 #ifdef _MSC_VER
-#pragma warning(disable:4355)
+# pragma warning(disable:4355 4702)
 #endif
 
 using namespace soci;
@@ -20,43 +20,39 @@ using namespace soci::details;
 db2_blob_backend::db2_blob_backend(db2_session_backend &session)
     : session_(session)
 {
-    // ...
+    throw soci_error("BLOBs are not supported.");
 }
 
 db2_blob_backend::~db2_blob_backend()
 {
-    // ...
 }
 
 std::size_t db2_blob_backend::get_len()
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t db2_blob_backend::read(
-    std::size_t /* offset */, char * /* buf */, std::size_t /* toRead */)
+std::size_t db2_blob_backend::read_from_start(char * /* buf */, std::size_t /* toRead */, std::size_t /* offset */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t db2_blob_backend::write(
-    std::size_t /* offset */, char const * /* buf */,
-    std::size_t /* toWrite */)
+std::size_t db2_blob_backend::write_from_start(char const * /* buf */, std::size_t /* toWrite */, std::size_t /* offset */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
 std::size_t db2_blob_backend::append(
     char const * /* buf */, std::size_t /* toWrite */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
 void db2_blob_backend::trim(std::size_t /* newLen */)
 {
-    // ...
+    throw soci_error("BLOBs are not supported.");
 }
+
+#ifdef _MSC_VER
+# pragma warning(pop)
+#endif
diff --git a/src/backends/empty/blob.cpp b/src/backends/empty/blob.cpp
index 0663995..a09e92d 100644
--- a/src/backends/empty/blob.cpp
+++ b/src/backends/empty/blob.cpp
@@ -9,7 +9,8 @@
 #include "soci/empty/soci-empty.h"
 
 #ifdef _MSC_VER
-#pragma warning(disable:4355)
+# pragma warning(push)
+# pragma warning(disable:4355 4702)
 #endif
 
 using namespace soci;
@@ -19,43 +20,39 @@ using namespace soci::details;
 empty_blob_backend::empty_blob_backend(empty_session_backend &session)
     : session_(session)
 {
-    // ...
+    throw soci_error("BLOBs are not supported.");
 }
 
 empty_blob_backend::~empty_blob_backend()
 {
-    // ...
 }
 
 std::size_t empty_blob_backend::get_len()
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t empty_blob_backend::read(
-    std::size_t /* offset */, char * /* buf */, std::size_t /* toRead */)
+std::size_t empty_blob_backend::read_from_start(char * /* buf */, std::size_t /* toRead */, std::size_t /* offset */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t empty_blob_backend::write(
-    std::size_t /* offset */, char const * /* buf */,
-    std::size_t /* toWrite */)
+std::size_t empty_blob_backend::write_from_start(char const * /* buf */, std::size_t /* toWrite */, std::size_t /* offset */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
 std::size_t empty_blob_backend::append(
     char const * /* buf */, std::size_t /* toWrite */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
 void empty_blob_backend::trim(std::size_t /* newLen */)
 {
-    // ...
+    throw soci_error("BLOBs are not supported.");
 }
+
+#ifdef _MSC_VER
+# pragma warning(pop)
+#endif
diff --git a/src/backends/firebird/blob.cpp b/src/backends/firebird/blob.cpp
index d289e84..5c3bb80 100644
--- a/src/backends/firebird/blob.cpp
+++ b/src/backends/firebird/blob.cpp
@@ -32,8 +32,7 @@ std::size_t firebird_blob_backend::get_len()
     return data_.size();
 }
 
-std::size_t firebird_blob_backend::read(
-    std::size_t offset, char * buf, std::size_t toRead)
+std::size_t firebird_blob_backend::read_from_start(char * buf, std::size_t toRead, std::size_t offset)
 {
     if (from_db_ && (loaded_ == false))
     {
@@ -62,8 +61,7 @@ std::size_t firebird_blob_backend::read(
     return limit;
 }
 
-std::size_t firebird_blob_backend::write(std::size_t offset, char const * buf,
-                                       std::size_t toWrite)
+std::size_t firebird_blob_backend::write_from_start(char const * buf, std::size_t toWrite, std::size_t offset)
 {
     if (from_db_ && (loaded_ == false))
     {
diff --git a/src/backends/firebird/common.cpp b/src/backends/firebird/common.cpp
index 724d2ad..3e8580e 100644
--- a/src/backends/firebird/common.cpp
+++ b/src/backends/firebird/common.cpp
@@ -190,11 +190,11 @@ std::string getTextParam(XSQLVAR const *var)
 
     if ((var->sqltype & ~1) == SQL_VARYING)
     {
-        GCC_WARNING_SUPPRESS(cast-align)
+        SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
         size = *reinterpret_cast<short*>(var->sqldata);
 
-        GCC_WARNING_RESTORE(cast-align)
+        SOCI_GCC_WARNING_RESTORE(cast-align)
 
         offset = sizeof(short);
     }
@@ -224,16 +224,16 @@ void copy_from_blob(firebird_statement_backend &st, char *buf, std::string &out)
 {
     firebird_blob_backend blob(st.session_);
 
-    GCC_WARNING_SUPPRESS(cast-align)
+    SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
     blob.assign(*reinterpret_cast<ISC_QUAD*>(buf));
 
-    GCC_WARNING_RESTORE(cast-align)
+    SOCI_GCC_WARNING_RESTORE(cast-align)
 
     std::size_t const len_total = blob.get_len();
     out.resize(len_total);
 
-    std::size_t const len_read = blob.read(0, &out[0], len_total);
+    std::size_t const len_read = blob.read_from_start(&out[0], len_total);
     if (len_read != len_total)
     {
         std::ostringstream os;
diff --git a/src/backends/firebird/standard-into-type.cpp b/src/backends/firebird/standard-into-type.cpp
index 59b3c9f..278b23f 100644
--- a/src/backends/firebird/standard-into-type.cpp
+++ b/src/backends/firebird/standard-into-type.cpp
@@ -123,11 +123,11 @@ void firebird_standard_into_type_backend::exchangeData()
                     throw soci_error("Can't get Firebid BLOB BackEnd");
                 }
 
-                GCC_WARNING_SUPPRESS(cast-align)
+                SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
                 blob->assign(*reinterpret_cast<ISC_QUAD*>(buf_));
 
-                GCC_WARNING_RESTORE(cast-align)
+                SOCI_GCC_WARNING_RESTORE(cast-align)
             }
             break;
 
diff --git a/src/backends/mysql/.session.cpp.swp b/src/backends/mysql/.session.cpp.swp
deleted file mode 100644
index 7114148..0000000
Binary files a/src/backends/mysql/.session.cpp.swp and /dev/null differ
diff --git a/src/backends/mysql/blob.cpp b/src/backends/mysql/blob.cpp
index 127e78a..93d4408 100644
--- a/src/backends/mysql/blob.cpp
+++ b/src/backends/mysql/blob.cpp
@@ -33,15 +33,12 @@ std::size_t mysql_blob_backend::get_len()
     throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t mysql_blob_backend::read(
-    std::size_t /* offset */, char * /* buf */, std::size_t /* toRead */)
+std::size_t mysql_blob_backend::read_from_start(char * /* buf */, std::size_t /* toRead */, std::size_t /* offset */)
 {
     throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t mysql_blob_backend::write(
-    std::size_t /* offset */, char const * /* buf */,
-    std::size_t /* toWrite */)
+std::size_t mysql_blob_backend::write_from_start(char const * /* buf */, std::size_t /* toWrite */, std::size_t /* offset */)
 {
     throw soci_error("BLOBs are not supported.");
 }
diff --git a/src/backends/mysql/common.cpp b/src/backends/mysql/common.cpp
index 7a06e00..32f354a 100644
--- a/src/backends/mysql/common.cpp
+++ b/src/backends/mysql/common.cpp
@@ -5,6 +5,7 @@
 // http://www.boost.org/LICENSE_1_0.txt)
 //
 
+#define SOCI_MYSQL_SOURCE
 #include "common.h"
 #include <ciso646>
 #include <cstdlib>
diff --git a/src/backends/mysql/common.h b/src/backends/mysql/common.h
index 0d822c4..708818f 100644
--- a/src/backends/mysql/common.h
+++ b/src/backends/mysql/common.h
@@ -41,11 +41,11 @@ bool is_infinity_or_nan(T x)
     T y = x - x;
 
     // We really need exact floating point comparison here.
-    GCC_WARNING_SUPPRESS(float-equal)
+    SOCI_GCC_WARNING_SUPPRESS(float-equal)
 
     return (y != y);
 
-    GCC_WARNING_RESTORE(float-equal)
+    SOCI_GCC_WARNING_RESTORE(float-equal)
 }
 
 template <typename T>
diff --git a/src/backends/mysql/statement.cpp b/src/backends/mysql/statement.cpp
index cc70e15..cfa91a1 100644
--- a/src/backends/mysql/statement.cpp
+++ b/src/backends/mysql/statement.cpp
@@ -440,6 +440,7 @@ void mysql_statement_backend::describe_column(int colNum,
         type = dt_date;
         break;
 //  case MYSQL_TYPE_VARCHAR:
+    case 245:                   //MYSQL_TYPE_JSON:
     case FIELD_TYPE_VAR_STRING: //MYSQL_TYPE_VAR_STRING:
     case FIELD_TYPE_STRING:     //MYSQL_TYPE_STRING:
     case FIELD_TYPE_BLOB:       // TEXT OR BLOB
diff --git a/src/backends/odbc/blob.cpp b/src/backends/odbc/blob.cpp
index 851c250..434e95a 100644
--- a/src/backends/odbc/blob.cpp
+++ b/src/backends/odbc/blob.cpp
@@ -8,6 +8,11 @@
 #define SOCI_ODBC_SOURCE
 #include "soci/odbc/soci-odbc.h"
 
+#ifdef _MSC_VER
+# pragma warning(push)
+# pragma warning(disable:4702)
+#endif
+
 using namespace soci;
 using namespace soci::details;
 
@@ -15,43 +20,39 @@ using namespace soci::details;
 odbc_blob_backend::odbc_blob_backend(odbc_session_backend &session)
     : session_(session)
 {
-    // ...
+    throw soci_error("BLOBs are not supported.");
 }
 
 odbc_blob_backend::~odbc_blob_backend()
 {
-    // ...
 }
 
 std::size_t odbc_blob_backend::get_len()
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t odbc_blob_backend::read(
-    std::size_t /* offset */, char * /* buf */, std::size_t /* toRead */)
+std::size_t odbc_blob_backend::read_from_start(char * /* buf */, std::size_t /* toRead */, std::size_t /* offset */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
-std::size_t odbc_blob_backend::write(
-    std::size_t /* offset */, char const * /* buf */,
-    std::size_t /* toWrite */)
+std::size_t odbc_blob_backend::write_from_start(char const * /* buf */, std::size_t /* toWrite */, std::size_t /* offset */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
 std::size_t odbc_blob_backend::append(
     char const * /* buf */, std::size_t /* toWrite */)
 {
-    // ...
-    return 0;
+    throw soci_error("BLOBs are not supported.");
 }
 
 void odbc_blob_backend::trim(std::size_t /* newLen */)
 {
-    // ...
+    throw soci_error("BLOBs are not supported.");
 }
+
+#ifdef _MSC_VER
+# pragma warning(pop)
+#endif
diff --git a/src/backends/odbc/standard-into-type.cpp b/src/backends/odbc/standard-into-type.cpp
index f31e4cd..26a4b41 100644
--- a/src/backends/odbc/standard-into-type.cpp
+++ b/src/backends/odbc/standard-into-type.cpp
@@ -181,11 +181,11 @@ void odbc_standard_into_type_backend::post_fetch(
             // Our pointer should, in fact, be sufficiently aligned, as we
             // allocate it on the heap, but gcc on ARMv7hl warns about this not
             // being the case, so just suppress this warning explicitly here.
-            GCC_WARNING_SUPPRESS(cast-align)
+            SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
             TIMESTAMP_STRUCT * ts = reinterpret_cast<TIMESTAMP_STRUCT*>(buf_);
 
-            GCC_WARNING_RESTORE(cast-align)
+            SOCI_GCC_WARNING_RESTORE(cast-align)
 
             details::mktime_from_ymdhms(t,
                                         ts->year, ts->month, ts->day,
diff --git a/src/backends/odbc/standard-use-type.cpp b/src/backends/odbc/standard-use-type.cpp
index b6898a9..60ec149 100644
--- a/src/backends/odbc/standard-use-type.cpp
+++ b/src/backends/odbc/standard-use-type.cpp
@@ -103,11 +103,11 @@ void* odbc_standard_use_type_backend::prepare_for_bind(
                    // yyyy-mm-dd hh:mm:ss
 
         // See comment for the use of this macro in standard-into-type.cpp.
-        GCC_WARNING_SUPPRESS(cast-align)
+        SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
         TIMESTAMP_STRUCT * ts = reinterpret_cast<TIMESTAMP_STRUCT*>(buf_);
 
-        GCC_WARNING_RESTORE(cast-align)
+        SOCI_GCC_WARNING_RESTORE(cast-align)
 
         ts->year = static_cast<SQLSMALLINT>(t.tm_year + 1900);
         ts->month = static_cast<SQLUSMALLINT>(t.tm_mon + 1);
diff --git a/src/backends/odbc/vector-into-type.cpp b/src/backends/odbc/vector-into-type.cpp
index 6781598..8486354 100644
--- a/src/backends/odbc/vector-into-type.cpp
+++ b/src/backends/odbc/vector-into-type.cpp
@@ -12,7 +12,6 @@
 #include "soci-compiler.h"
 #include "soci-cstrtoi.h"
 #include "soci-mktime.h"
-#include "soci-static-assert.h"
 #include "soci-vector-helpers.h"
 #include <algorithm>
 #include <cctype>
@@ -49,7 +48,7 @@ void odbc_vector_into_type_backend::define_by_pos(
         break;
     case x_integer:
         odbcType_ = SQL_C_SLONG;
-        SOCI_STATIC_ASSERT(sizeof(SQLINTEGER) == sizeof(int));
+        static_assert(sizeof(SQLINTEGER) == sizeof(int), "unsupported SQLINTEGER size");
         break;
     case x_long_long:
         if (use_string_for_bigint())
@@ -269,11 +268,11 @@ void odbc_vector_into_type_backend::do_post_fetch_rows(
         for (std::size_t i = beginRow; i != endRow; ++i)
         {
             // See comment for the use of this macro in standard-into-type.cpp.
-            GCC_WARNING_SUPPRESS(cast-align)
+            SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
             TIMESTAMP_STRUCT * ts = reinterpret_cast<TIMESTAMP_STRUCT*>(pos);
 
-            GCC_WARNING_RESTORE(cast-align)
+            SOCI_GCC_WARNING_RESTORE(cast-align)
 
             details::mktime_from_ymdhms(v[i],
                                         ts->year, ts->month, ts->day,
diff --git a/src/backends/odbc/vector-use-type.cpp b/src/backends/odbc/vector-use-type.cpp
index 4774f72..90ab74e 100644
--- a/src/backends/odbc/vector-use-type.cpp
+++ b/src/backends/odbc/vector-use-type.cpp
@@ -9,7 +9,6 @@
 #include "soci/soci-platform.h"
 #include "soci/odbc/soci-odbc.h"
 #include "soci-compiler.h"
-#include "soci-static-assert.h"
 #include "soci-vector-helpers.h"
 #include <cctype>
 #include <cstdio>
@@ -59,7 +58,7 @@ void* odbc_vector_use_type_backend::prepare_for_bind(SQLUINTEGER &size,
             sqlType = SQL_INTEGER;
             cType = SQL_C_SLONG;
             size = sizeof(SQLINTEGER);
-            SOCI_STATIC_ASSERT(sizeof(SQLINTEGER) == sizeof(int));
+            static_assert(sizeof(SQLINTEGER) == sizeof(int), "unsupported SQLINTEGER size");
             std::vector<int> *vp = static_cast<std::vector<int> *>(data_);
             std::vector<int> &v(*vp);
             prepare_indicators(v.size());
@@ -310,11 +309,11 @@ void odbc_vector_use_type_backend::pre_use(indicator const *ind)
                     std::tm t = v[i];
 
                     // See comment for the use of this macro in standard-into-type.cpp.
-                    GCC_WARNING_SUPPRESS(cast-align)
+                    SOCI_GCC_WARNING_SUPPRESS(cast-align)
 
                     TIMESTAMP_STRUCT * ts = reinterpret_cast<TIMESTAMP_STRUCT*>(pos);
 
-                    GCC_WARNING_RESTORE(cast-align)
+                    SOCI_GCC_WARNING_RESTORE(cast-align)
 
                     ts->year = static_cast<SQLSMALLINT>(t.tm_year + 1900);
                     ts->month = static_cast<SQLUSMALLINT>(t.tm_mon + 1);
diff --git a/src/backends/oracle/blob.cpp b/src/backends/oracle/blob.cpp
index d9c90fd..ee68972 100644
--- a/src/backends/oracle/blob.cpp
+++ b/src/backends/oracle/blob.cpp
@@ -53,13 +53,12 @@ std::size_t oracle_blob_backend::get_len()
     return static_cast<std::size_t>(len);
 }
 
-std::size_t oracle_blob_backend::read(
-    std::size_t offset, char *buf, std::size_t toRead)
+std::size_t oracle_blob_backend::read_from_start(char *buf, std::size_t toRead, std::size_t offset)
 {
     ub4 amt = static_cast<ub4>(toRead);
 
     sword res = OCILobRead(session_.svchp_, session_.errhp_, lobp_, &amt,
-        static_cast<ub4>(offset), reinterpret_cast<dvoid*>(buf),
+        static_cast<ub4>(offset + 1), reinterpret_cast<dvoid*>(buf),
         amt, 0, 0, 0, 0);
     if (res != OCI_SUCCESS)
     {
@@ -69,13 +68,12 @@ std::size_t oracle_blob_backend::read(
     return static_cast<std::size_t>(amt);
 }
 
-std::size_t oracle_blob_backend::write(
-    std::size_t offset, char const *buf, std::size_t toWrite)
+std::size_t oracle_blob_backend::write_from_start(char const *buf, std::size_t toWrite, std::size_t offset)
 {
     ub4 amt = static_cast<ub4>(toWrite);
 
     sword res = OCILobWrite(session_.svchp_, session_.errhp_, lobp_, &amt,
-        static_cast<ub4>(offset),
+        static_cast<ub4>(offset + 1),
         reinterpret_cast<dvoid*>(const_cast<char*>(buf)),
         amt, OCI_ONE_PIECE, 0, 0, 0, 0);
     if (res != OCI_SUCCESS)
diff --git a/src/backends/oracle/standard-use-type.cpp b/src/backends/oracle/standard-use-type.cpp
index acdf64d..b25d653 100644
--- a/src/backends/oracle/standard-use-type.cpp
+++ b/src/backends/oracle/standard-use-type.cpp
@@ -498,14 +498,14 @@ void oracle_standard_use_type_backend::post_use(bool gotData, indicator *ind)
 
                 // Exact comparison is fine here, they are really supposed to
                 // be exactly the same.
-                GCC_WARNING_SUPPRESS(float-equal)
+                SOCI_GCC_WARNING_SUPPRESS(float-equal)
 
                 if (original != bound)
                 {
                     throw soci_error("Attempted modification of const use element");
                 }
 
-                GCC_WARNING_RESTORE(float-equal)
+                SOCI_GCC_WARNING_RESTORE(float-equal)
             }
             break;
         case x_stdstring:
diff --git a/src/backends/postgresql/blob.cpp b/src/backends/postgresql/blob.cpp
index f3d32d2..0e46e32 100644
--- a/src/backends/postgresql/blob.cpp
+++ b/src/backends/postgresql/blob.cpp
@@ -49,8 +49,7 @@ std::size_t postgresql_blob_backend::get_len()
     return static_cast<std::size_t>(pos);
 }
 
-std::size_t postgresql_blob_backend::read(
-    std::size_t offset, char * buf, std::size_t toRead)
+std::size_t postgresql_blob_backend::read_from_start(char * buf, std::size_t toRead, std::size_t offset)
 {
     int const pos = lo_lseek(session_.conn_, fd_,
         static_cast<int>(offset), SEEK_SET);
@@ -68,8 +67,7 @@ std::size_t postgresql_blob_backend::read(
     return static_cast<std::size_t>(readn);
 }
 
-std::size_t postgresql_blob_backend::write(
-    std::size_t offset, char const * buf, std::size_t toWrite)
+std::size_t postgresql_blob_backend::write_from_start(char const * buf, std::size_t toWrite, std::size_t offset)
 {
     int const pos = lo_lseek(session_.conn_, fd_,
         static_cast<int>(offset), SEEK_SET);
diff --git a/src/backends/sqlite3/blob.cpp b/src/backends/sqlite3/blob.cpp
index 0d9ca60..15dcd37 100644
--- a/src/backends/sqlite3/blob.cpp
+++ b/src/backends/sqlite3/blob.cpp
@@ -33,8 +33,7 @@ std::size_t sqlite3_blob_backend::get_len()
     return len_;
 }
 
-std::size_t sqlite3_blob_backend::read(
-    std::size_t offset, char * buf, std::size_t toRead)
+std::size_t sqlite3_blob_backend::read_from_start(char * buf, std::size_t toRead, std::size_t offset)
 {
     size_t r = toRead;
 
@@ -51,9 +50,7 @@ std::size_t sqlite3_blob_backend::read(
 }
 
 
-std::size_t sqlite3_blob_backend::write(
-    std::size_t offset, char const * buf,
-    std::size_t toWrite)
+std::size_t sqlite3_blob_backend::write_from_start(char const * buf, std::size_t toWrite, std::size_t offset)
 {
     const char* oldBuf = buf_;
     std::size_t oldLen = len_;
@@ -114,5 +111,5 @@ std::size_t sqlite3_blob_backend::set_data(char const *buf, std::size_t toWrite)
         buf_ = 0;
         len_ = 0;
     }
-    return write(0, buf, toWrite);
+    return write_from_start(buf, toWrite);
 }
diff --git a/src/backends/sqlite3/session.cpp b/src/backends/sqlite3/session.cpp
index 69a8948..a25c1b3 100644
--- a/src/backends/sqlite3/session.cpp
+++ b/src/backends/sqlite3/session.cpp
@@ -10,6 +10,9 @@
 
 #include "soci/connection-parameters.h"
 
+#include "soci-cstrtoi.h"
+
+#include <functional>
 #include <sstream>
 #include <string>
 
@@ -24,42 +27,93 @@ using namespace sqlite_api;
 namespace // anonymous
 {
 
-// helper function for hardcoded queries
-void execude_hardcoded(sqlite_api::sqlite3* conn, char const* const query, char const* const errMsg)
+// Callback function use to construct the error message in the provided stream.
+//
+// SQLite3 own error message will be appended to it.
+using error_callback = std::function<void (std::ostream& ostr)>;
+
+// helper function for hardcoded queries: this is a simple wrapper for
+// sqlite3_exec() which throws an exception on error.
+void execude_hardcoded(sqlite_api::sqlite3* conn, char const* const query,
+                       error_callback const& errCallback,
+                       int (*callback)(void*, int, char**, char**) = NULL,
+                       void* callback_arg = NULL)
 {
     char *zErrMsg = 0;
-    int const res = sqlite3_exec(conn, query, 0, 0, &zErrMsg);
+    int const res = sqlite3_exec(conn, query, callback, callback_arg, &zErrMsg);
     if (res != SQLITE_OK)
     {
         std::ostringstream ss;
-        ss << errMsg << " " << zErrMsg;
+        errCallback(ss);
+        ss << ": " << zErrMsg;
         sqlite3_free(zErrMsg);
         throw sqlite3_soci_error(ss.str(), res);
     }
 }
 
-void check_sqlite_err(sqlite_api::sqlite3* conn, int res, char const* const errMsg)
+// Simpler to use overload which uses a hard coded error message.
+void execude_hardcoded(sqlite_api::sqlite3* conn, char const* const query, char const* const errMsg,
+                       int (*callback)(void*, int, char**, char**) = NULL,
+                       void* callback_arg = NULL)
+{
+    return execude_hardcoded(conn, query,
+        [errMsg](std::ostream& ostr) { ostr << errMsg; },
+        callback, callback_arg
+    );
+}
+
+void check_sqlite_err(sqlite_api::sqlite3* conn, int res,
+                      error_callback const& errCallback)
 {
     if (SQLITE_OK != res)
     {
         const char *zErrMsg = sqlite3_errmsg(conn);
         std::ostringstream ss;
-        ss << errMsg << zErrMsg;
+        errCallback(ss);
+        ss << ": " << zErrMsg;
         sqlite3_close(conn); // connection must be closed here
         throw sqlite3_soci_error(ss.str(), res);
     }
 }
 
+void check_sqlite_err(sqlite_api::sqlite3* conn, int res, char const* const errMsg)
+{
+    return check_sqlite_err(conn, res, [errMsg](std::ostream& ostr) { ostr << errMsg; });
+}
+
 } // namespace anonymous
 
+static int sequence_table_exists_callback(void* ctxt, int result_columns, char**, char**)
+{
+    bool* const flag = static_cast<bool*>(ctxt);
+    *flag = result_columns > 0;
+    return 0;
+}
+
+static bool check_if_sequence_table_exists(sqlite_api::sqlite3* conn)
+{
+    bool sequence_table_exists = false;
+    execude_hardcoded
+    (
+      conn,
+      "select name from sqlite_master where type='table' and name='sqlite_sequence'",
+      "Failed checking if the sqlite_sequence table exists",
+      &sequence_table_exists_callback,
+      &sequence_table_exists
+    );
+
+    return sequence_table_exists;
+}
 
 sqlite3_session_backend::sqlite3_session_backend(
     connection_parameters const & parameters)
+    : sequence_table_exists_(false)
 {
     int timeout = 0;
     int connection_flags = SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE;
     std::string vfs;
     std::string synchronous;
+    std::string foreignKeys;
     std::string const & connectString = parameters.get_connect_string();
     std::string dbname(connectString);
     std::stringstream ssconn(connectString);
@@ -105,6 +159,10 @@ sqlite3_session_backend::sqlite3_session_backend(
         {
             connection_flags = (connection_flags | SQLITE_OPEN_READONLY) & ~(SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE);
         }
+        else if ("nocreate" == key)
+        {
+            connection_flags &= ~SQLITE_OPEN_CREATE;
+        }
         else if ("shared_cache" == key && "true" == val)
         {
             connection_flags |= SQLITE_OPEN_SHAREDCACHE;
@@ -113,22 +171,44 @@ sqlite3_session_backend::sqlite3_session_backend(
         {
             vfs = val;
         }
-
+        else if ("foreign_keys" == key)
+        {
+            foreignKeys = val;
+        }
     }
 
     int res = sqlite3_open_v2(dbname.c_str(), &conn_, connection_flags, (vfs.empty()?NULL:vfs.c_str()));
-    check_sqlite_err(conn_, res, "Cannot establish connection to the database. ");
+    check_sqlite_err(conn_, res,
+        [&dbname](std::ostream& ostr)
+        {
+            ostr << "Cannot establish connection to \"" << dbname << "\"";
+        }
+    );
 
     if (!synchronous.empty())
     {
         std::string const query("pragma synchronous=" + synchronous);
-        std::string const errMsg("Query failed: " + query);
-        execude_hardcoded(conn_, query.c_str(), errMsg.c_str());
+        execude_hardcoded(conn_, query.c_str(),
+            [&synchronous](std::ostream& ostr)
+            {
+                ostr << "Setting synchronous pragma to \"" << synchronous << "\" failed";
+            }
+        );
+    }
+
+    if (!foreignKeys.empty())
+    {
+        std::string const query("pragma foreign_keys=" + foreignKeys);
+        execude_hardcoded(conn_, query.c_str(),
+            [&foreignKeys](std::ostream& ostr)
+            {
+                ostr << "Setting foreign_keys pragma to \"" << foreignKeys << "\" failed";
+            }
+        );
     }
 
     res = sqlite3_busy_timeout(conn_, timeout * 1000);
     check_sqlite_err(conn_, res, "Failed to set busy timeout for connection. ");
-
 }
 
 sqlite3_session_backend::~sqlite3_session_backend()
@@ -151,10 +231,80 @@ void sqlite3_session_backend::rollback()
     execude_hardcoded(conn_, "ROLLBACK", "Cannot rollback transaction.");
 }
 
+// Argument passed to store_single_value_callback(), which is used to retrieve
+// a single numeric value from a hardcoded query.
+struct single_value_callback_ctx
+{
+    single_value_callback_ctx() : valid_(false) {}
+
+    long long value_;
+    bool valid_;
+};
+
+static int store_single_value_callback(void* ctx, int result_columns, char** values, char**)
+{
+    single_value_callback_ctx* arg = static_cast<single_value_callback_ctx*>(ctx);
+
+    if (result_columns == 1 && values[0])
+    {
+        if (cstring_to_integer(arg->value_, values[0]))
+            arg->valid_ = true;
+    }
+
+    return 0;
+}
+
+static std::string sanitize_table_name(std::string const& table)
+{
+    std::string ret;
+    ret.reserve(table.length());
+    for (std::string::size_type pos = 0; pos < table.size(); ++pos)
+    {
+        if (isspace(table[pos]))
+            throw sqlite3_soci_error("Table name must not contain whitespace", 0);
+        const char c = table[pos];
+        ret += c;
+        if (c == '\'')
+            ret += '\'';
+        else if (c == '\"')
+            ret += '\"';
+    }
+    return ret;
+}
+
 bool sqlite3_session_backend::get_last_insert_id(
-    session & /* s */, std::string const & /* table */, long long & value)
+    session &, std::string const & table, long long & value)
 {
-    value = static_cast<long long>(sqlite3_last_insert_rowid(conn_));
+    single_value_callback_ctx ctx;
+    if (sequence_table_exists_ || check_if_sequence_table_exists(conn_))
+    {
+        // Once the sqlite_sequence table is created (because of a column marked AUTOINCREMENT)
+        // it can never be dropped, so don't search for it again.
+        sequence_table_exists_ = true;
+
+        std::string const query =
+            "select seq from sqlite_sequence where name ='" + sanitize_table_name(table) + "'";
+        execude_hardcoded(conn_, query.c_str(),  "Unable to get value in sqlite_sequence",
+                          &store_single_value_callback, &ctx);
+
+        // The value will not be filled if the callback was never called.
+        // It may mean either that nothing was inserted yet into the table
+        // that has an AUTOINCREMENT column, or that the table does not have an AUTOINCREMENT
+        // column.
+        if (ctx.valid_)
+        {
+            value = ctx.value_;
+            return true;
+        }
+    }
+
+    // Fall-back just get the maximum rowid of what was already inserted in the
+    // table. This has the disadvantage that if rows were deleted, then ids may be re-used.
+    // But, if one cares about that, AUTOINCREMENT should be used anyway.
+    std::string const max_rowid_query = "select max(rowid) from \"" + sanitize_table_name(table) + "\"";
+    execude_hardcoded(conn_, max_rowid_query.c_str(),  "Unable to get max rowid",
+                      &store_single_value_callback, &ctx);
+    value = ctx.valid_ ? ctx.value_ : 0;
 
     return true;
 }
diff --git a/src/backends/sqlite3/standard-into-type.cpp b/src/backends/sqlite3/standard-into-type.cpp
index eb7bf5c..7d22d9b 100644
--- a/src/backends/sqlite3/standard-into-type.cpp
+++ b/src/backends/sqlite3/standard-into-type.cpp
@@ -165,6 +165,18 @@ void sqlite3_standard_into_type_backend::post_fetch(bool gotData,
                 break;
             }
 
+            case x_xmltype:
+            {
+                const char *buf = reinterpret_cast<const char*>(
+                    sqlite3_column_text(statement_.stmt_, pos)
+                );
+                const int bytes = sqlite3_column_bytes(statement_.stmt_, pos);
+                exchange_type_traits<x_xmltype>::value_type &out
+                    = exchange_type_cast<x_xmltype>(data_);
+                out.value.assign(buf, bytes);
+                break;
+            }
+
             default:
                 throw soci_error("Into element used with non-supported type.");
         }
diff --git a/src/backends/sqlite3/standard-use-type.cpp b/src/backends/sqlite3/standard-use-type.cpp
index 013a31a..adbb058 100644
--- a/src/backends/sqlite3/standard-use-type.cpp
+++ b/src/backends/sqlite3/standard-use-type.cpp
@@ -175,6 +175,15 @@ void sqlite3_standard_use_type_backend::pre_use(indicator const * ind)
             break;
         }
 
+        case x_xmltype:
+        {
+            const soci::xml_type &xml = exchange_type_cast<x_xmltype>(data_);
+            col.type_ = dt_string;
+            col.buffer_.constData_ = xml.value.c_str();
+            col.buffer_.size_ = xml.value.size();
+            break;
+        }
+
         default:
             throw soci_error("Use element used with non-supported type.");
     }
diff --git a/src/backends/sqlite3/statement.cpp b/src/backends/sqlite3/statement.cpp
index ffe870c..ed648c4 100644
--- a/src/backends/sqlite3/statement.cpp
+++ b/src/backends/sqlite3/statement.cpp
@@ -497,15 +497,9 @@ void sqlite3_statement_backend::describe_column(int colNum, data_type & type,
     std::string dt = declType;
 
     // remove extra characters for example "(20)" in "varchar(20)" and all spaces
-#if defined(SOCI_HAVE_CXX11) || (defined(_MSC_VER) && _MSC_VER >= 1800)
     dt.erase(std::remove_if(dt.begin(), dt.end(), [](char const c) { return std::isspace(c); }), dt.end());
 
     std::string::iterator siter = std::find_if(dt.begin(), dt.end(), [](char const c) { return !std::isalnum(c); });
-#else
-    dt.erase(std::remove_if(dt.begin(), dt.end(), std::ptr_fun(isspace)), dt.end());
-
-    std::string::iterator siter = std::find_if(dt.begin(), dt.end(), std::not1(std::ptr_fun(isalnum)));
-#endif
     if (siter != dt.end())
         dt.resize(siter - dt.begin());
 
diff --git a/src/backends/sqlite3/vector-into-type.cpp b/src/backends/sqlite3/vector-into-type.cpp
index e5dc44e..8feb99d 100644
--- a/src/backends/sqlite3/vector-into-type.cpp
+++ b/src/backends/sqlite3/vector-into-type.cpp
@@ -222,11 +222,35 @@ void sqlite3_vector_into_type_backend::post_fetch(bool gotData, indicator * ind)
                     }
 
                     case dt_xml:
-                        throw soci_error("XML data type is not supported");
+                    {
+                        soci::xml_type xml;
+                        xml.value = std::string(col.buffer_.constData_, col.buffer_.size_);
+                        set_in_vector(data_, i, xml);
+                        break;
+                    }
                 };
                 break;
             } // x_stdstring
 
+            case x_xmltype:
+            {
+                switch (col.type_)
+                {
+                    case dt_string:
+                    case dt_blob:
+                    case dt_xml:
+                    {
+                        soci::xml_type xml;
+                        xml.value = std::string(col.buffer_.constData_, col.buffer_.size_);
+                        set_in_vector(data_, i, xml);
+                        break;
+                    }
+                    default:
+                        throw soci_error("DB type does not have a valid conversion to expected XML type");
+                };
+                break;
+            } // x_xmltype
+
             case x_short:
                 set_number_in_vector<exchange_type_traits<x_short>::value_type>(data_, i, col);
                 break;
@@ -333,6 +357,9 @@ void sqlite3_vector_into_type_backend::resize(std::size_t sz)
     case x_stdtm:
         resize_vector<std::tm>(data_, sz);
         break;
+    case x_xmltype:
+        resize_vector<soci::xml_type>(data_, sz);
+        break;
     default:
         throw soci_error("Into vector element used with non-supported type.");
     }
@@ -371,6 +398,9 @@ std::size_t sqlite3_vector_into_type_backend::size()
     case x_stdtm:
         sz = get_vector_size<std::tm>(data_);
         break;
+    case x_xmltype:
+        sz = get_vector_size<soci::xml_type>(data_);
+        break;
     default:
         throw soci_error("Into vector element used with non-supported type.");
     }
diff --git a/src/backends/sqlite3/vector-use-type.cpp b/src/backends/sqlite3/vector-use-type.cpp
index f12a5c0..c98a3ab 100644
--- a/src/backends/sqlite3/vector-use-type.cpp
+++ b/src/backends/sqlite3/vector-use-type.cpp
@@ -151,6 +151,15 @@ void sqlite3_vector_use_type_backend::pre_use(indicator const * ind)
                 break;
             }
 
+            case x_xmltype:
+            {
+                soci::xml_type &xml = (*static_cast<std::vector<exchange_type_traits<x_xmltype>::value_type> *>(data_))[i];
+                col.type_ = dt_string;
+                col.buffer_.constData_ = xml.value.c_str();
+                col.buffer_.size_ = xml.value.size();
+                break;
+            }
+
             default:
                 throw soci_error(
                     "Use vector element used with non-supported type.");
@@ -188,6 +197,9 @@ std::size_t sqlite3_vector_use_type_backend::size()
     case x_stdtm:
         sz = get_vector_size<std::tm>(data_);
         break;
+    case x_xmltype:
+        sz = get_vector_size<soci::xml_type>(data_);
+        break;
     default:
         throw soci_error("Use vector element used with non-supported type.");
     }
diff --git a/src/core/CMakeLists.txt b/src/core/CMakeLists.txt
index 3e7deea..0158da2 100644
--- a/src/core/CMakeLists.txt
+++ b/src/core/CMakeLists.txt
@@ -44,6 +44,7 @@ soci_target_output_name(${SOCI_CORE_TARGET} SOCI_CORE_TARGET_OUTPUT_NAME)
 #
 if (SOCI_SHARED)
   add_library(${SOCI_CORE_TARGET} SHARED ${SOCI_CORE_HEADERS} ${SOCI_CORE_SOURCES})
+  add_library(Soci::core ALIAS ${SOCI_CORE_TARGET})
 
   target_link_libraries(${SOCI_CORE_TARGET} ${SOCI_CORE_DEPS_LIBS})
 
@@ -66,6 +67,7 @@ if (SOCI_SHARED)
   target_include_directories(${SOCI_CORE_TARGET}
       PUBLIC
       $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/../../include>
+      $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/../../include>
       $<INSTALL_INTERFACE:include>
   )
 
@@ -84,6 +86,7 @@ if (SOCI_STATIC)
 
   add_library(${SOCI_CORE_TARGET_STATIC} STATIC
     ${SOCI_CORE_HEADERS} ${SOCI_CORE_SOURCES})
+  add_library(Soci::core_static ALIAS ${SOCI_CORE_TARGET_STATIC})
 
   # we still need to link against dl if we have it
   target_link_libraries (${SOCI_CORE_TARGET_STATIC}
@@ -99,6 +102,7 @@ if (SOCI_STATIC)
   target_include_directories(${SOCI_CORE_TARGET_STATIC}
       PUBLIC
       $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/../../include>
+      $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/../../include>
       $<INSTALL_INTERFACE:include>
   )
 
diff --git a/src/core/blob.cpp b/src/core/blob.cpp
index bcb66f7..f42930e 100644
--- a/src/core/blob.cpp
+++ b/src/core/blob.cpp
@@ -8,20 +8,18 @@
 #define SOCI_SOURCE
 #include "soci/blob.h"
 #include "soci/session.h"
+#include "soci/soci-platform.h"
 
 #include <cstddef>
 
 using namespace soci;
 
 blob::blob(session & s)
+	: backEnd_{s.make_blob_backend()}
 {
-    backEnd_ = s.make_blob_backend();
 }
 
-blob::~blob()
-{
-    delete backEnd_;
-}
+blob::~blob() = default;
 
 std::size_t blob::get_len()
 {
@@ -30,7 +28,9 @@ std::size_t blob::get_len()
 
 std::size_t blob::read(std::size_t offset, char *buf, std::size_t toRead)
 {
+    SOCI_ALLOW_DEPRECATED_BEGIN
     return backEnd_->read(offset, buf, toRead);
+    SOCI_ALLOW_DEPRECATED_END
 }
 
 std::size_t blob::read_from_start(char * buf, std::size_t toRead,
@@ -42,7 +42,9 @@ std::size_t blob::read_from_start(char * buf, std::size_t toRead,
 std::size_t blob::write(
     std::size_t offset, char const * buf, std::size_t toWrite)
 {
+    SOCI_ALLOW_DEPRECATED_BEGIN
     return backEnd_->write(offset, buf, toWrite);
+    SOCI_ALLOW_DEPRECATED_END
 }
 
 std::size_t blob::write_from_start(const char * buf, std::size_t toWrite,
diff --git a/src/core/error.cpp b/src/core/error.cpp
index 2048196..27e50b5 100644
--- a/src/core/error.cpp
+++ b/src/core/error.cpp
@@ -118,7 +118,7 @@ soci_error& soci_error::operator=(soci_error const& e)
     return *this;
 }
 
-soci_error::~soci_error() SOCI_NOEXCEPT
+soci_error::~soci_error() noexcept
 {
     delete info_;
 }
@@ -128,7 +128,7 @@ std::string soci_error::get_error_message() const
     return std::runtime_error::what();
 }
 
-char const* soci_error::what() const SOCI_NOEXCEPT
+char const* soci_error::what() const noexcept
 {
     if (info_)
         return info_->get_full_message(get_error_message());
diff --git a/src/core/once-temp-type.cpp b/src/core/once-temp-type.cpp
index f870aed..6fd189f 100644
--- a/src/core/once-temp-type.cpp
+++ b/src/core/once-temp-type.cpp
@@ -35,7 +35,7 @@ once_temp_type & once_temp_type::operator=(once_temp_type const & o)
     return *this;
 }
 
-once_temp_type::~once_temp_type() SOCI_NOEXCEPT_FALSE
+once_temp_type::~once_temp_type() noexcept(false)
 {
     rcst_->dec_ref();
 }
@@ -75,7 +75,7 @@ ddl_type & ddl_type::operator=(const ddl_type & d)
     return *this;
 }
 
-ddl_type::~ddl_type() SOCI_NOEXCEPT_FALSE
+ddl_type::~ddl_type() noexcept(false)
 {
     rcst_->dec_ref();
 }
diff --git a/src/core/session.cpp b/src/core/session.cpp
index 9303a09..fc4550e 100644
--- a/src/core/session.cpp
+++ b/src/core/session.cpp
@@ -73,7 +73,7 @@ private:
 } // namespace anonymous
 
 session::session()
-    : once(this), prepare(this), query_transformation_(NULL),
+    : once(this), prepare(this),
       logger_(new standard_logger_impl),
       uppercaseColumnNames_(false), backEnd_(NULL),
       isFromPool_(false), pool_(NULL)
@@ -81,7 +81,7 @@ session::session()
 }
 
 session::session(connection_parameters const & parameters)
-    : once(this), prepare(this), query_transformation_(NULL),
+    : once(this), prepare(this),
       logger_(new standard_logger_impl),
       lastConnectParameters_(parameters),
       uppercaseColumnNames_(false), backEnd_(NULL),
@@ -92,7 +92,7 @@ session::session(connection_parameters const & parameters)
 
 session::session(backend_factory const & factory,
     std::string const & connectString)
-    : once(this), prepare(this), query_transformation_(NULL),
+    : once(this), prepare(this),
     logger_(new standard_logger_impl),
       lastConnectParameters_(factory, connectString),
       uppercaseColumnNames_(false), backEnd_(NULL),
@@ -103,7 +103,7 @@ session::session(backend_factory const & factory,
 
 session::session(std::string const & backendName,
     std::string const & connectString)
-    : once(this), prepare(this), query_transformation_(NULL),
+    : once(this), prepare(this),
       logger_(new standard_logger_impl),
       lastConnectParameters_(backendName, connectString),
       uppercaseColumnNames_(false), backEnd_(NULL),
@@ -113,7 +113,7 @@ session::session(std::string const & backendName,
 }
 
 session::session(std::string const & connectString)
-    : once(this), prepare(this), query_transformation_(NULL),
+    : once(this), prepare(this),
       logger_(new standard_logger_impl),
       lastConnectParameters_(connectString),
       uppercaseColumnNames_(false), backEnd_(NULL),
@@ -123,8 +123,7 @@ session::session(std::string const & connectString)
 }
 
 session::session(connection_pool & pool)
-    : query_transformation_(NULL),
-      logger_(new standard_logger_impl),
+    : logger_(new standard_logger_impl),
       isFromPool_(true), pool_(&pool)
 {
     poolPosition_ = pool.lease();
@@ -143,7 +142,6 @@ session::~session()
     }
     else
     {
-        delete query_transformation_;
         delete backEnd_;
     }
 }
@@ -237,7 +235,7 @@ void session::reconnect()
     }
 }
 
-bool session::is_connected() const SOCI_NOEXCEPT
+bool session::is_connected() const noexcept
 {
     try
     {
@@ -306,16 +304,15 @@ std::string session::get_query() const
 }
 
 
-void session::set_query_transformation_(cxx_details::auto_ptr<details::query_transformation_function>& qtf)
+void session::set_query_transformation_(std::unique_ptr<details::query_transformation_function>&& qtf)
 {
     if (isFromPool_)
     {
-        pool_->at(poolPosition_).set_query_transformation_(qtf);
+        pool_->at(poolPosition_).set_query_transformation_(std::move(qtf));
     }
     else
     {
-        delete query_transformation_;
-        query_transformation_= qtf.release();
+        query_transformation_= std::move(qtf);
     }
 }
 
diff --git a/src/core/soci-simple.cpp b/src/core/soci-simple.cpp
index c5f1c7f..80b6d57 100644
--- a/src/core/soci-simple.cpp
+++ b/src/core/soci-simple.cpp
@@ -192,7 +192,30 @@ SOCI_DECL int soci_blob_read(blob_handle b, int offset, char *buf, int toRead)
     blob_wrapper *blob = static_cast<blob_wrapper *>(b);
     try
     {
+        SOCI_ALLOW_DEPRECATED_BEGIN
         return static_cast<int>(blob->blob_.read(offset, buf, toRead));
+        SOCI_ALLOW_DEPRECATED_END
+    }
+    catch (std::exception &e)
+    {
+        blob->is_ok = false;
+        blob->error_message = e.what();
+        return -1;
+    }
+    catch (...)
+    {
+        blob->is_ok = false;
+        blob->error_message = "unknown exception";
+        return -1;
+    }
+}
+
+SOCI_DECL int soci_blob_read_from_start(blob_handle b, char *buf, int toRead, int offset)
+{
+    blob_wrapper *blob = static_cast<blob_wrapper *>(b);
+    try
+    {
+        return static_cast<int>(blob->blob_.read_from_start(buf, toRead, offset));
     }
     catch (std::exception &e)
     {
@@ -213,7 +236,30 @@ SOCI_DECL int soci_blob_write(blob_handle b, int offset, char const *buf, int to
     blob_wrapper *blob = static_cast<blob_wrapper *>(b);
     try
     {
+        SOCI_ALLOW_DEPRECATED_BEGIN
         return static_cast<int>(blob->blob_.write(offset, buf, toWrite));
+        SOCI_ALLOW_DEPRECATED_END
+    }
+    catch (std::exception &e)
+    {
+        blob->is_ok = false;
+        blob->error_message = e.what();
+        return -1;
+    }
+    catch (...)
+    {
+        blob->is_ok = false;
+        blob->error_message = "unknown exception";
+        return -1;
+    }
+}
+
+SOCI_DECL int soci_blob_write_from_start(blob_handle b, char const *buf, int toWrite, int offset)
+{
+    blob_wrapper *blob = static_cast<blob_wrapper *>(b);
+    try
+    {
+        return static_cast<int>(blob->blob_.write_from_start(buf, toWrite, offset));
     }
     catch (std::exception &e)
     {
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index 9dc2215..7e65d2c 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -11,10 +11,8 @@
 
 colormsg(_HIBLUE_ "Configuring SOCI tests:")
 
-# Request CATCH to disable all the C++11 features
-if (NOT SOCI_CXX11)
-  add_definitions(-DCATCH_CONFIG_NO_CPP11)
-endif()
+# This works around a problem when building in C++11 mode with clang (see #984).
+add_definitions(-DCATCH_CONFIG_CPP11_NO_SHUFFLE)
 
 include_directories(
   ${SOCI_SOURCE_DIR}/include/private
diff --git a/tests/common-tests.h b/tests/common-tests.h
index f4e3c31..9d287d8 100644
--- a/tests/common-tests.h
+++ b/tests/common-tests.h
@@ -20,6 +20,9 @@
 #include "soci/boost-fusion.h"
 #endif // BOOST_VERSION
 #endif // SOCI_HAVE_BOOST
+#ifdef SOCI_HAVE_CXX17
+#include "soci/std-optional.h"
+#endif
 
 #include "soci-compiler.h"
 
@@ -535,11 +538,11 @@ inline bool
 are_doubles_exactly_equal(double a, double b)
 {
     // Avoid g++ warnings: we do really want the exact equality here.
-    GCC_WARNING_SUPPRESS(float-equal)
+    SOCI_GCC_WARNING_SUPPRESS(float-equal)
 
     return a == b;
 
-    GCC_WARNING_RESTORE(float-equal)
+    SOCI_GCC_WARNING_RESTORE(float-equal)
 }
 
 #define ASSERT_EQUAL_EXACT(a, b) \
@@ -600,7 +603,7 @@ protected:
     SOCI_NOT_COPYABLE(common_tests)
 };
 
-typedef cxx_details::auto_ptr<table_creator_base> auto_table_creator;
+using auto_table_creator = std::unique_ptr<table_creator_base>;
 
 // Define the test cases in their own namespace to avoid clashes with the test
 // cases defined in individual backend tests: as only line number is used for
@@ -2469,6 +2472,16 @@ TEST_CASE_METHOD(common_tests, "Dynamic row binding", "[core][dynamic]")
 
         CHECK(r.get_properties(0).get_data_type() == dt_string);
         CHECK(r.get_properties(1).get_data_type() == dt_integer);
+
+        // Check if row object is movable
+        row moved = std::move(r);
+
+        CHECK(moved.size() == 2);
+        // We expect the moved-from row to become empty after the move operation
+        CHECK(r.size() == 0);
+
+        CHECK(moved.get_properties(0).get_data_type() == dt_string);
+        CHECK(moved.get_properties(1).get_data_type() == dt_integer);
     }
 }
 
@@ -3250,7 +3263,7 @@ TEST_CASE_METHOD(common_tests, "NULL with optional", "[core][boost][null]")
     soci::session sql(backEndFactory_, connectString_);
 
     // create and populate the test table
-    auto_table_creator tableCreator(tc_.table_creator_1(sql));
+    auto_table_creator tableCreator0(tc_.table_creator_1(sql));
     {
         sql << "insert into soci_test(val) values(7)";
 
@@ -3713,6 +3726,478 @@ TEST_CASE_METHOD(common_tests, "NULL with optional", "[core][boost][null]")
 
 #endif // SOCI_HAVE_BOOST
 
+#ifdef SOCI_HAVE_CXX17
+
+// test for handling NULL values with std::optional
+// (both into and use)
+TEST_CASE_METHOD(common_tests, "NULL with std optional", "[core][null]")
+{
+
+    soci::session sql(backEndFactory_, connectString_);
+
+    // create and populate the test table
+    auto_table_creator tableCreator0(tc_.table_creator_1(sql));
+    {
+        sql << "insert into soci_test(val) values(7)";
+
+        {
+            // verify non-null value is fetched correctly
+            std::optional<int> opt;
+            sql << "select val from soci_test", into(opt);
+            CHECK(opt.has_value());
+            CHECK(opt.value() == 7);
+
+            // indicators can be used with optional
+            // (although that's just a consequence of implementation,
+            // not an intended feature - but let's test it anyway)
+            indicator ind;
+            opt.reset();
+            sql << "select val from soci_test", into(opt, ind);
+            CHECK(opt.has_value());
+            CHECK(opt.value() == 7);
+            CHECK(ind == i_ok);
+
+            // verify null value is fetched correctly
+            sql << "select i1 from soci_test", into(opt);
+            CHECK(opt.has_value() == false);
+
+            // and with indicator
+            opt = 5;
+            sql << "select i1 from soci_test", into(opt, ind);
+            CHECK(opt.has_value() == false);
+            CHECK(ind == i_null);
+
+            // verify non-null is inserted correctly
+            opt = 3;
+            sql << "update soci_test set val = :v", use(opt);
+            int j = 0;
+            sql << "select val from soci_test", into(j);
+            CHECK(j == 3);
+
+            // verify null is inserted correctly
+            opt.reset();
+            sql << "update soci_test set val = :v", use(opt);
+            ind = i_ok;
+            sql << "select val from soci_test", into(j, ind);
+            CHECK(ind == i_null);
+        }
+
+        // vector tests (select)
+
+        {
+            sql << "delete from soci_test";
+
+            // simple readout of non-null data
+
+            sql << "insert into soci_test(id, val, str) values(1, 5, \'abc\')";
+            sql << "insert into soci_test(id, val, str) values(2, 6, \'def\')";
+            sql << "insert into soci_test(id, val, str) values(3, 7, \'ghi\')";
+            sql << "insert into soci_test(id, val, str) values(4, 8, null)";
+            sql << "insert into soci_test(id, val, str) values(5, 9, \'mno\')";
+
+            std::vector<std::optional<int> > v(10);
+            sql << "select val from soci_test order by val", into(v);
+
+            CHECK(v.size() == 5);
+            CHECK(v[0].has_value());
+            CHECK(v[0].value() == 5);
+            CHECK(v[1].has_value());
+            CHECK(v[1].value() == 6);
+            CHECK(v[2].has_value());
+            CHECK(v[2].value() == 7);
+            CHECK(v[3].has_value());
+            CHECK(v[3].value() == 8);
+            CHECK(v[4].has_value());
+            CHECK(v[4].value() == 9);
+
+            // readout of nulls
+
+            sql << "update soci_test set val = null where id = 2 or id = 4";
+
+            std::vector<int> ids(5);
+            sql << "select id, val from soci_test order by id", into(ids), into(v);
+
+            CHECK(v.size() == 5);
+            CHECK(ids.size() == 5);
+            CHECK(v[0].has_value());
+            CHECK(v[0].value() == 5);
+            CHECK(v[1].has_value() == false);
+            CHECK(v[2].has_value());
+            CHECK(v[2].value() == 7);
+            CHECK(v[3].has_value() == false);
+            CHECK(v[4].has_value());
+            CHECK(v[4].value() == 9);
+
+            // readout with statement preparation
+
+            int id = 1;
+
+            ids.resize(3);
+            v.resize(3);
+            statement st = (sql.prepare <<
+                "select id, val from soci_test order by id", into(ids), into(v));
+            st.execute();
+            while (st.fetch())
+            {
+                for (std::size_t i = 0; i != v.size(); ++i)
+                {
+                    CHECK(id == ids[i]);
+
+                    if (id == 2 || id == 4)
+                    {
+                        CHECK(v[i].has_value() == false);
+                    }
+                    else
+                    {
+                        CHECK(v[i].has_value());
+                        CHECK(v[i].value() == id + 4);
+                    }
+
+                    ++id;
+                }
+
+                ids.resize(3);
+                v.resize(3);
+            }
+            CHECK(id == 6);
+        }
+
+        // and why not stress iterators and the dynamic binding, too!
+
+        {
+            rowset<row> rs = (sql.prepare << "select id, val, str from soci_test order by id");
+
+            rowset<row>::const_iterator it = rs.begin();
+            CHECK(it != rs.end());
+
+            row const& r1 = (*it);
+
+            CHECK(r1.size() == 3);
+
+            // Note: for the reason of differences between number(x,y) type and
+            // binary representation of integers, the following commented assertions
+            // do not work for Oracle.
+            // The problem is that for this single table the data type used in Oracle
+            // table creator for the id column is number(10,0),
+            // which allows to insert all int values.
+            // On the other hand, the column description scheme used in the Oracle
+            // backend figures out that the natural type for such a column
+            // is eUnsignedInt - this makes the following assertions fail.
+            // Other database backends (like PostgreSQL) use other types like int
+            // and this not only allows to insert all int values (obviously),
+            // but is also recognized as int (obviously).
+            // There is a similar problem with stream-like extraction,
+            // where internally get<T> is called and the type mismatch is detected
+            // for the id column - that's why the code below skips this column
+            // and tests the remaining column only.
+
+            //CHECK(r1.get_properties(0).get_data_type() == dt_integer);
+            CHECK(r1.get_properties(1).get_data_type() == dt_integer);
+            CHECK(r1.get_properties(2).get_data_type() == dt_string);
+            //CHECK(r1.get<int>(0) == 1);
+            CHECK(r1.get<int>(1) == 5);
+            CHECK(r1.get<std::string>(2) == "abc");
+            CHECK(r1.get<std::optional<int> >(1).has_value());
+            CHECK(r1.get<std::optional<int> >(1).value() == 5);
+            CHECK(r1.get<std::optional<std::string> >(2).has_value());
+            CHECK(r1.get<std::optional<std::string> >(2).value() == "abc");
+
+            ++it;
+
+            row const& r2 = (*it);
+
+            CHECK(r2.size() == 3);
+
+            // CHECK(r2.get_properties(0).get_data_type() == dt_integer);
+            CHECK(r2.get_properties(1).get_data_type() == dt_integer);
+            CHECK(r2.get_properties(2).get_data_type() == dt_string);
+            //CHECK(r2.get<int>(0) == 2);
+            try
+            {
+                // expect exception here, this is NULL value
+                (void)r1.get<int>(1);
+                FAIL("expected exception not thrown");
+            }
+            catch (soci_error const &) {}
+
+            // but we can read it as optional
+            CHECK(r2.get<std::optional<int> >(1).has_value() == false);
+
+            // stream-like data extraction
+
+            ++it;
+            row const &r3 = (*it);
+
+            std::optional<int> io;
+            std::optional<std::string> so;
+
+            r3.skip(); // move to val and str columns
+            r3 >> io >> so;
+
+            CHECK(io.has_value());
+            CHECK(io.value() == 7);
+            CHECK(so.has_value());
+            CHECK(so.value() == "ghi");
+
+            ++it;
+            row const &r4 = (*it);
+
+            r3.skip(); // move to val and str columns
+            r4 >> io >> so;
+
+            CHECK(io.has_value() == false);
+            CHECK(so.has_value() == false);
+        }
+
+        // inserts of non-null const data
+        {
+            sql << "delete from soci_test";
+
+            const int id = 10;
+            const std::optional<int> val = 11;
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(id, "id"),
+                use(val, "val");
+
+            int sum;
+            sql << "select sum(val) from soci_test", into(sum);
+            CHECK(sum == 11);
+        }
+
+        // bulk inserts of non-null data
+
+        {
+            sql << "delete from soci_test";
+
+            std::vector<int> ids;
+            std::vector<std::optional<int> > v;
+
+            ids.push_back(10); v.push_back(20);
+            ids.push_back(11); v.push_back(21);
+            ids.push_back(12); v.push_back(22);
+            ids.push_back(13); v.push_back(23);
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(ids, "id"), use(v, "val");
+
+            int sum;
+            sql << "select sum(val) from soci_test", into(sum);
+            CHECK(sum == 86);
+
+            // bulk inserts of some-null data
+
+            sql << "delete from soci_test";
+
+            v[2].reset();
+            v[3].reset();
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(ids, "id"), use(v, "val");
+
+            sql << "select sum(val) from soci_test", into(sum);
+            CHECK(sum == 41);
+        }
+
+
+        // bulk inserts of non-null data with const vector
+
+        {
+            sql << "delete from soci_test";
+
+            std::vector<int> ids;
+            std::vector<std::optional<int> > v;
+
+            ids.push_back(10); v.push_back(20);
+            ids.push_back(11); v.push_back(21);
+            ids.push_back(12); v.push_back(22);
+            ids.push_back(13); v.push_back(23);
+
+            const std::vector<int>& cref_ids = ids;
+            const std::vector<std::optional<int> >& cref_v = v;
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(cref_ids, "id"),
+                use(cref_v, "val");
+
+            int sum;
+            sql << "select sum(val) from soci_test", into(sum);
+            CHECK(sum == 86);
+
+            // bulk inserts of some-null data
+
+            sql << "delete from soci_test";
+
+            v[2].reset();
+            v[3].reset();
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(cref_ids, "id"),
+                use(cref_v, "val");
+
+            sql << "select sum(val) from soci_test", into(sum);
+            CHECK(sum == 41);
+        }
+
+        // composability with user conversions
+
+        {
+            sql << "delete from soci_test";
+
+            std::optional<MyInt> omi1;
+            std::optional<MyInt> omi2;
+
+            omi1 = MyInt(125);
+            omi2.reset();
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(omi1), use(omi2);
+
+            sql << "select id, val from soci_test", into(omi2), into(omi1);
+
+            CHECK(omi1.has_value() == false);
+            CHECK(omi2.has_value());
+            CHECK(omi2.value().get() == 125);
+        }
+
+        // use with const optional and user conversions
+
+        {
+            sql << "delete from soci_test";
+
+            std::optional<MyInt> omi1;
+            std::optional<MyInt> omi2;
+
+            omi1 = MyInt(125);
+            omi2.reset();
+
+            std::optional<MyInt> const & comi1 = omi1;
+            std::optional<MyInt> const & comi2 = omi2;
+
+            sql << "insert into soci_test(id, val) values(:id, :val)",
+                use(comi1), use(comi2);
+
+            sql << "select id, val from soci_test", into(omi2), into(omi1);
+
+            CHECK(omi1.has_value() == false);
+            CHECK(omi2.has_value());
+            CHECK(omi2.value().get() == 125);
+        }
+
+        // use with rowset and table containing null values
+
+        {
+            auto_table_creator tableCreator(tc_.table_creator_1(sql));
+
+            sql << "insert into soci_test(id, val) values(1, 10)";
+            sql << "insert into soci_test(id, val) values(2, 11)";
+            sql << "insert into soci_test(id, val) values(3, NULL)";
+            sql << "insert into soci_test(id, val) values(4, 13)";
+
+            rowset<std::optional<int> > rs = (sql.prepare <<
+                "select val from soci_test order by id asc");
+
+            // 1st row
+            rowset<std::optional<int> >::const_iterator pos = rs.begin();
+            CHECK((*pos).has_value());
+            CHECK(10 == (*pos).value());
+
+            // 2nd row
+            ++pos;
+            CHECK((*pos).has_value());
+            CHECK(11 == (*pos).value());
+
+            // 3rd row
+            ++pos;
+            CHECK((*pos).has_value() == false);
+
+            // 4th row
+            ++pos;
+            CHECK((*pos).has_value());
+            CHECK(13 == (*pos).value());
+        }
+
+        // inserting using an i_null indicator with a std::optional should
+        // insert null, even if the optional is valid, just as with standard
+        // types
+        {
+            auto_table_creator tableCreator(tc_.table_creator_1(sql));
+
+            {
+                indicator ind = i_null;
+                std::optional<int> v1(10);
+                sql << "insert into soci_test(id, val) values(1, :val)",
+                       use(v1, ind);
+            }
+
+            // verify the value is fetched correctly as null
+            {
+                indicator ind;
+                std::optional<int> opt;
+
+                ind = i_truncated;
+                opt = 0;
+                sql << "select val from soci_test where id = 1", into(opt, ind);
+                CHECK(ind == i_null);
+                CHECK(!opt.has_value());
+            }
+        }
+
+        // prepared statement inserting non-null and null values alternatively
+        // (without passing an explicit indicator)
+        {
+            auto_table_creator tableCreator(tc_.table_creator_1(sql));
+
+            {
+                int id;
+                std::optional<int> val;
+                statement st = (sql.prepare
+                    << "insert into soci_test(id, val) values (:id, :val)",
+                       use(id), use(val));
+
+                id = 1;
+                val = 10;
+                st.execute(true);
+
+                id = 2;
+                val = std::optional<int>();
+                st.execute(true);
+
+                id = 3;
+                val = 11;
+                st.execute(true);
+            }
+
+            // verify values are fetched correctly
+            {
+                indicator ind;
+                std::optional<int> opt;
+
+                ind = i_truncated;
+                opt = 0;
+                sql << "select val from soci_test where id = 1", into(opt, ind);
+                CHECK(ind == i_ok);
+                CHECK(opt.has_value());
+                CHECK(opt.value() == 10);
+
+                ind = i_truncated;
+                opt = 0;
+                sql << "select val from soci_test where id = 2", into(opt, ind);
+                CHECK(ind == i_null);
+                CHECK(!opt.has_value());
+
+                ind = i_truncated;
+                opt = 0;
+                sql << "select val from soci_test where id = 3", into(opt, ind);
+                CHECK(ind == i_ok);
+                REQUIRE(opt.has_value());
+                CHECK(opt.value() == 11);
+            }
+        }
+    }
+}
+#endif
+
 // connection and reconnection tests
 TEST_CASE_METHOD(common_tests, "Connection and reconnection", "[core][connect]")
 {
@@ -4654,12 +5139,14 @@ TEST_CASE_METHOD(common_tests, "Insert error", "[core][insert][exception]")
         try
         {
             int const *a = ages;
-            for (char const* const* n = names; n; ++n, ++a)
+            for (char const* const* n = names; *n; ++n, ++a)
             {
                 name = *n;
                 age = *a;
                 st.execute(true);
             }
+
+            FAIL("exception expected on unique constraint violation with prepared statement not thrown");
         }
         catch (soci_error const &e)
         {
@@ -5318,7 +5805,7 @@ TEST_CASE_METHOD(common_tests, "Failover", "[keep-alive][.]")
 
         bool did_reconnect() const { return reconnected_; }
 
-        void started() SOCI_OVERRIDE
+        void started() override
         {
             std::cout << "Please undo the previous action "
                          "(restart the server, plug the cable back, ...) "
@@ -5326,19 +5813,19 @@ TEST_CASE_METHOD(common_tests, "Failover", "[keep-alive][.]")
             std::cin.get();
         }
 
-        void failed(bool& retry, std::string&) SOCI_OVERRIDE
+        void failed(bool& retry, std::string&) override
         {
             // We only retry once.
             retry = !attempted_;
             attempted_ = true;
         }
 
-        void finished(soci::session&) SOCI_OVERRIDE
+        void finished(soci::session&) override
         {
             reconnected_ = true;
         }
 
-        void aborted() SOCI_OVERRIDE
+        void aborted() override
         {
             FAIL( "Failover aborted" );
         }
diff --git a/tests/db2/test-db2.cpp b/tests/db2/test-db2.cpp
index 082737f..fa84241 100644
--- a/tests/db2/test-db2.cpp
+++ b/tests/db2/test-db2.cpp
@@ -68,35 +68,35 @@ public:
     test_context(backend_factory const & pi_back_end, std::string const & pi_connect_string)
         : test_context_base(pi_back_end, pi_connect_string) {}
 
-    table_creator_base* table_creator_1(soci::session & pr_s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_1(soci::session & pr_s) const override
     {
         pr_s << "SET CURRENT SCHEMA = 'DB2INST1'";
         return new table_creator_one(pr_s);
     }
 
-    table_creator_base* table_creator_2(soci::session & pr_s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_2(soci::session & pr_s) const override
     {
         pr_s << "SET CURRENT SCHEMA = 'DB2INST1'";
         return new table_creator_two(pr_s);
     }
 
-    table_creator_base* table_creator_3(soci::session & pr_s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_3(soci::session & pr_s) const override
     {
         pr_s << "SET CURRENT SCHEMA = 'DB2INST1'";
         return new table_creator_three(pr_s);
     }
 
-    table_creator_base* table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_4(soci::session& s) const override
     {
         return new table_creator_for_get_affected_rows(s);
     }
 
-    std::string to_date_time(std::string const & pi_datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const & pi_datdt_string) const override
     {
         return "to_date('" + pi_datdt_string + "', 'YYYY-MM-DD HH24:MI:SS')";
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         return "length(" + s + ")";
     }
diff --git a/tests/firebird/test-firebird.cpp b/tests/firebird/test-firebird.cpp
index d4e1983..73d0c30 100644
--- a/tests/firebird/test-firebird.cpp
+++ b/tests/firebird/test-firebird.cpp
@@ -535,10 +535,10 @@ TEST_CASE("Firebird blobs", "[firebird][blob]")
         blob b(sql);
 
         char str1[] = "Hello";
-        b.write(0, str1, strlen(str1));
+        b.write_from_start(str1, strlen(str1));
 
         char str2[20];
-        std::size_t i = b.read(3, str2, 2);
+        std::size_t i = b.read_from_start(str2, 2, 3);
         str2[i] = '\0';
         CHECK(str2[0] == 'l');
         CHECK(str2[1] == 'o');
@@ -557,11 +557,11 @@ TEST_CASE("Firebird blobs", "[firebird][blob]")
         sql << "select img from test7 where id = 1", into(b);
 
         std::vector<char> text(b.get_len());
-        b.read(0, &text[0], b.get_len());
+        b.read_from_start(&text[0], b.get_len());
         CHECK(strncmp(&text[0], "Hello, Firebird!", b.get_len()) == 0);
 
         char str1[] = "FIREBIRD";
-        b.write(7, str1, strlen(str1));
+        b.write_from_start(str1, strlen(str1), 7);
 
         // after modification blob must be written to database
         sql << "update test7 set img=? where id=1", use(b);
@@ -574,12 +574,12 @@ TEST_CASE("Firebird blobs", "[firebird][blob]")
         sql << "select img from test7 where id = 1", into(b);
 
         std::vector<char> text(b.get_len());
-        b.read(0, &text[0], b.get_len());
+        b.read_from_start(&text[0], b.get_len());
 
         char str1[] = "HELLO";
-        b.write(0, str1, strlen(str1));
+        b.write_from_start(str1, strlen(str1));
 
-        b.read(0, &text[0], b.get_len());
+        b.read_from_start(&text[0], b.get_len());
         CHECK(strncmp(&text[0], "HELLO, FIREBIRD!", b.get_len()) == 0);
 
         b.trim(5);
@@ -594,12 +594,12 @@ TEST_CASE("Firebird blobs", "[firebird][blob]")
 
         st.fetch();
         std::vector<char> text(b.get_len());
-        b.read(0, &text[0], b.get_len());
+        b.read_from_start(&text[0], b.get_len());
         CHECK(strncmp(&text[0], "Hello, FIREBIRD!", b.get_len()) == 0);
 
         st.fetch();
         text.resize(b.get_len());
-        b.read(0, &text[0], b.get_len());
+        b.read_from_start(&text[0], b.get_len());
         CHECK(strncmp(&text[0], "HELLO", b.get_len()) == 0);
     }
 
@@ -621,7 +621,7 @@ TEST_CASE("Firebird blobs", "[firebird][blob]")
         const int blobSize = 65536; //max segment size is 65535(unsigned short)
         std::vector<char> data(blobSize);
         blob b(sql);
-        b.write(0, data.data(), blobSize);
+        b.write_from_start(data.data(), blobSize);
         sql << "insert into test7(id, img) values(3,?)", use(b);
 
         //now read blob back from database and make sure it has correct content and size
@@ -629,7 +629,7 @@ TEST_CASE("Firebird blobs", "[firebird][blob]")
         sql << "select img from test7 where id = 3", into(br);
         std::vector<char> data2(br.get_len());
         if(br.get_len()>0)
-            br.read(0, data2.data(), br.get_len());
+            br.read_from_start(data2.data(), br.get_len());
         CHECK(data == data2);
     }
 
@@ -1304,47 +1304,47 @@ class test_context : public tests::test_context_base
                 : test_context_base(backEnd, connectString)
         {}
 
-        tests::table_creator_base* table_creator_1(soci::session& s) const SOCI_OVERRIDE
+        tests::table_creator_base* table_creator_1(soci::session& s) const override
         {
             return new TableCreator1(s);
         }
 
-        tests::table_creator_base* table_creator_2(soci::session& s) const SOCI_OVERRIDE
+        tests::table_creator_base* table_creator_2(soci::session& s) const override
         {
             return new TableCreator2(s);
         }
 
-        tests::table_creator_base* table_creator_3(soci::session& s) const SOCI_OVERRIDE
+        tests::table_creator_base* table_creator_3(soci::session& s) const override
         {
             return new TableCreator3(s);
         }
 
-        tests::table_creator_base* table_creator_4(soci::session& s) const SOCI_OVERRIDE
+        tests::table_creator_base* table_creator_4(soci::session& s) const override
         {
             return new TableCreator4(s);
         }
 
-        tests::table_creator_base* table_creator_clob(soci::session& s) const SOCI_OVERRIDE
+        tests::table_creator_base* table_creator_clob(soci::session& s) const override
         {
             return new TableCreatorCLOB(s);
         }
 
-        tests::table_creator_base* table_creator_xml(soci::session& s) const SOCI_OVERRIDE
+        tests::table_creator_base* table_creator_xml(soci::session& s) const override
         {
             return new TableCreatorXML(s);
         }
 
-        std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+        std::string to_date_time(std::string const &datdt_string) const override
         {
             return "'" + datdt_string + "'";
         }
 
-        void on_after_ddl(soci::session& sql) const SOCI_OVERRIDE
+        void on_after_ddl(soci::session& sql) const override
         {
             sql.commit();
         }
 
-        std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+        std::string sql_length(std::string const& s) const override
         {
             return "char_length(" + s + ")";
         }
diff --git a/tests/mysql/test-mysql.cpp b/tests/mysql/test-mysql.cpp
index 230915f..32af3ad 100644
--- a/tests/mysql/test-mysql.cpp
+++ b/tests/mysql/test-mysql.cpp
@@ -7,6 +7,8 @@
 //
 
 #include "soci/soci.h"
+
+#include "soci-compiler.h"
 #include "soci/mysql/soci-mysql.h"
 #include "mysql/test-mysql.h"
 #include <string.h>
diff --git a/tests/mysql/test-mysql.h b/tests/mysql/test-mysql.h
index 6cca072..0fda454 100644
--- a/tests/mysql/test-mysql.h
+++ b/tests/mysql/test-mysql.h
@@ -60,39 +60,39 @@ public:
                 std::string const &connectString)
         : test_context_base(backEnd, connectString) {}
 
-    table_creator_base* table_creator_1(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_1(soci::session& s) const override
     {
         return new table_creator_one(s);
     }
 
-    table_creator_base* table_creator_2(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_2(soci::session& s) const override
     {
         return new table_creator_two(s);
     }
 
-    table_creator_base* table_creator_3(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_3(soci::session& s) const override
     {
         return new table_creator_three(s);
     }
 
-    table_creator_base* table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_4(soci::session& s) const override
     {
         return new table_creator_for_get_affected_rows(s);
     }
 
-    std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const &datdt_string) const override
     {
         return "\'" + datdt_string + "\'";
     }
 
-    bool has_fp_bug() const SOCI_OVERRIDE
+    bool has_fp_bug() const override
     {
         // MySQL fails in the common test3() with "1.8000000000000000 !=
         // 1.7999999999999998", so don't use exact doubles comparisons for it.
         return true;
     }
 
-    bool has_transactions_support(soci::session& sql) const SOCI_OVERRIDE
+    bool has_transactions_support(soci::session& sql) const override
     {
         sql << "drop table if exists soci_test";
         sql << "create table soci_test (id int) engine=InnoDB";
@@ -103,7 +103,7 @@ public:
         return retv;
     }
 
-    bool has_silent_truncate_bug(soci::session& sql) const SOCI_OVERRIDE
+    bool has_silent_truncate_bug(soci::session& sql) const override
     {
         std::string sql_mode;
         sql << "select @@session.sql_mode", into(sql_mode);
@@ -113,7 +113,7 @@ public:
         return sql_mode.find("STRICT_") == std::string::npos;
     }
 
-    bool enable_std_char_padding(soci::session& sql) const SOCI_OVERRIDE
+    bool enable_std_char_padding(soci::session& sql) const override
     {
         // turn on standard right padding on mysql. This options is supported as of version 5.1.20
         try
@@ -128,7 +128,7 @@ public:
         }
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         return "char_length(" + s + ")";
     }
diff --git a/tests/odbc/CMakeLists.txt b/tests/odbc/CMakeLists.txt
index a5c1c3b..c57db67 100644
--- a/tests/odbc/CMakeLists.txt
+++ b/tests/odbc/CMakeLists.txt
@@ -16,24 +16,31 @@ if (WIN32)
     BACKEND ODBC
     DEPENDS ODBC
     SOURCE test-odbc-access.cpp ${SOCI_TESTS_COMMON}
-    CONNSTR "test-access.dsn")
+    CONNSTR "FILEDSN=${CMAKE_CURRENT_SOURCE_DIR}/test-access.dsn")
 else()
     message(STATUS "MS Access test disabled on non-Windows platform")
 endif()
 
+set(MSSQL_VER $ENV{MSSQL_VER})
+if (NOT MSSQL_VER)
+    # Use the same value that was used before by default.
+    set(MSSQL_VER "2014")
+endif()
+configure_file("test-mssql.dsn.in" "test-mssql.dsn" @ONLY)
+
 soci_backend_test(
   NAME mssql
   BACKEND ODBC
   DEPENDS ODBC
   SOURCE test-odbc-mssql.cpp ${SOCI_TESTS_COMMON}
-  CONNSTR "test-mssql.dsn")
+  CONNSTR "FILEDSN=${CMAKE_CURRENT_BINARY_DIR}/test-mssql.dsn")
 
 soci_backend_test(
   NAME mysql
   BACKEND ODBC
   DEPENDS ODBC
   SOURCE test-odbc-mysql.cpp ${SOCI_TESTS_COMMON}
-  CONNSTR "test-mysql.dsn")
+  CONNSTR "FILEDSN=${CMAKE_CURRENT_SOURCE_DIR}/test-mysql.dsn")
 
 if(WIN32)
   set(TEST_PGSQL_DSN "test-postgresql-win64.dsn")
@@ -45,7 +52,7 @@ soci_backend_test(
   BACKEND ODBC
   DEPENDS ODBC
   SOURCE test-odbc-postgresql.cpp ${SOCI_TESTS_COMMON}
-  CONNSTR ${TEST_PGSQL_DSN})
+  CONNSTR "FILEDSN=${CMAKE_CURRENT_SOURCE_DIR}/${TEST_PGSQL_DSN}")
 
 # TODO: DB2 backend is tested by Travis CI on dedicated VM, separate from ODBC,
 # in order to test DB2 with ODBC, it would be best to install DB2 driver only.
@@ -56,7 +63,7 @@ if (WITH_ODBC_TEST_DB2)
     NAME db2
     BACKEND ODBC
     SOURCE test-odbc-db2.cpp
-    CONNSTR "test-db2.dsn")
+    CONNSTR "FILEDSN=${CMAKE_CURRENT_SOURCE_DIR}/test-db2.dsn")
 else()
   message(STATUS "ODBC DB2 test disabled.")
 endif()
diff --git a/tests/odbc/test-access.dsn b/tests/odbc/test-access.dsn
deleted file mode 100644
index 5565c4f..0000000
--- a/tests/odbc/test-access.dsn
+++ /dev/null
@@ -1,13 +0,0 @@
-[ODBC]
-DRIVER=Microsoft Access Driver (*.mdb, *.accdb)
-UID=admin
-UserCommitSync=Yes
-Threads=3
-SafeTransactions=0
-PageTimeout=5
-MaxScanRows=8
-MaxBufferSize=2048
-FIL=MS Access
-DriverId=25
-DefaultDir=/home/zeitlin/mirrors/soci\tests\odbc
-DBQ=/home/zeitlin/mirrors/soci\tests\odbc\soci_test.mdb
diff --git a/tests/odbc/test-mssql.dsn b/tests/odbc/test-mssql.dsn.in
similarity index 83%
rename from tests/odbc/test-mssql.dsn
rename to tests/odbc/test-mssql.dsn.in
index 5db0e2c..e178be6 100644
--- a/tests/odbc/test-mssql.dsn
+++ b/tests/odbc/test-mssql.dsn.in
@@ -4,7 +4,7 @@ UID=sa
 PWD=Password12!
 WSID=SOLARWIND
 APP=SOCI Test Application
-SERVER=(local)\SQL2014
+SERVER=(local)\SQL@MSSQL_VER@
 DATABASE=soci_test
 Description=SQL on AppVeyor
 
diff --git a/tests/odbc/test-mysql.dsn b/tests/odbc/test-mysql.dsn
deleted file mode 100644
index 59dff62..0000000
--- a/tests/odbc/test-mysql.dsn
+++ /dev/null
@@ -1,4 +0,0 @@
-[ODBC]
-DRIVER=MySQL
-DATABASE=soci_test
-OPTION=0
diff --git a/tests/odbc/test-odbc-mssql.cpp b/tests/odbc/test-odbc-mssql.cpp
index a42393f..d2b68dd 100644
--- a/tests/odbc/test-odbc-mssql.cpp
+++ b/tests/odbc/test-odbc-mssql.cpp
@@ -156,52 +156,52 @@ public:
                 std::string const &connstr)
         : test_context_base(backend, connstr) {}
 
-    table_creator_base* table_creator_1(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_1(soci::session& s) const override
     {
         return new table_creator_one(s);
     }
 
-    table_creator_base* table_creator_2(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_2(soci::session& s) const override
     {
         return new table_creator_two(s);
     }
 
-    table_creator_base* table_creator_3(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_3(soci::session& s) const override
     {
         return new table_creator_three(s);
     }
 
-    table_creator_base * table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base * table_creator_4(soci::session& s) const override
     {
         return new table_creator_for_get_affected_rows(s);
     }
 
-    tests::table_creator_base* table_creator_clob(soci::session& s) const SOCI_OVERRIDE
+    tests::table_creator_base* table_creator_clob(soci::session& s) const override
     {
         return new table_creator_for_clob(s);
     }
 
-    tests::table_creator_base* table_creator_xml(soci::session& s) const SOCI_OVERRIDE
+    tests::table_creator_base* table_creator_xml(soci::session& s) const override
     {
         return new table_creator_for_xml(s);
     }
 
-    tests::table_creator_base* table_creator_get_last_insert_id(soci::session& s) const SOCI_OVERRIDE
+    tests::table_creator_base* table_creator_get_last_insert_id(soci::session& s) const override
     {
         return new table_creator_for_get_last_insert_id(s);
     }
 
-    bool has_real_xml_support() const SOCI_OVERRIDE
+    bool has_real_xml_support() const override
     {
         return true;
     }
 
-    std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const &datdt_string) const override
     {
         return "convert(datetime, \'" + datdt_string + "\', 120)";
     }
 
-    bool has_multiple_select_bug() const SOCI_OVERRIDE
+    bool has_multiple_select_bug() const override
     {
         // MS SQL does support MARS (multiple active result sets) since 2005
         // version, but this support needs to be explicitly enabled and is not
@@ -210,7 +210,7 @@ public:
         return true;
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         return "len(" + s + ")";
     }
diff --git a/tests/odbc/test-odbc-postgresql.cpp b/tests/odbc/test-odbc-postgresql.cpp
index 1886167..64da868 100644
--- a/tests/odbc/test-odbc-postgresql.cpp
+++ b/tests/odbc/test-odbc-postgresql.cpp
@@ -161,47 +161,47 @@ public:
         std::cout << "Using ODBC driver version " << m_verDriver << "\n";
     }
 
-    table_creator_base * table_creator_1(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base * table_creator_1(soci::session& s) const override
     {
         return new table_creator_one(s);
     }
 
-    table_creator_base * table_creator_2(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base * table_creator_2(soci::session& s) const override
     {
         return new table_creator_two(s);
     }
 
-    table_creator_base * table_creator_3(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base * table_creator_3(soci::session& s) const override
     {
         return new table_creator_three(s);
     }
 
-    table_creator_base * table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base * table_creator_4(soci::session& s) const override
     {
         return new table_creator_for_get_affected_rows(s);
     }
 
-    table_creator_base* table_creator_xml(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_xml(soci::session& s) const override
     {
         return new table_creator_for_xml(s);
     }
 
-    table_creator_base* table_creator_clob(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_clob(soci::session& s) const override
     {
         return new table_creator_for_clob(s);
     }
 
-    bool has_real_xml_support() const SOCI_OVERRIDE
+    bool has_real_xml_support() const override
     {
         return true;
     }
 
-    std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const &datdt_string) const override
     {
         return "timestamptz(\'" + datdt_string + "\')";
     }
 
-    bool has_fp_bug() const SOCI_OVERRIDE
+    bool has_fp_bug() const override
     {
         // The bug with using insufficiently many digits for double values was
         // only fixed in 9.03.0400 version of the ODBC driver (see commit
@@ -212,7 +212,7 @@ public:
         return !m_verDriver.is_initialized() || m_verDriver < odbc_version(9, 3, 400);
     }
 
-    std::string fix_crlf_if_necessary(std::string const& s) const SOCI_OVERRIDE
+    std::string fix_crlf_if_necessary(std::string const& s) const override
     {
         // Version 9.03.0300 (ancient, but still used on AppVeyor CI) is known
         // to have a bug which replaces new lines, i.e. LF characters, with CR
@@ -233,7 +233,7 @@ public:
         return s2;
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         return "char_length(" + s + ")";
     }
diff --git a/tests/oracle/test-oracle.cpp b/tests/oracle/test-oracle.cpp
index b33f90a..6905c4e 100644
--- a/tests/oracle/test-oracle.cpp
+++ b/tests/oracle/test-oracle.cpp
@@ -119,97 +119,47 @@ struct blob_table_creator : public table_creator_base
 
 TEST_CASE("Oracle blob", "[oracle][blob]")
 {
-    {
-        soci::session sql(backEnd, connectString);
+    soci::session sql(backEnd, connectString);
 
-        blob_table_creator tableCreator(sql);
+    blob_table_creator tableCreator(sql);
 
-        char buf[] = "abcdefghijklmnopqrstuvwxyz";
-        sql << "insert into soci_test (id, img) values (7, empty_blob())";
+    char buf[] = "abcdefghijklmnopqrstuvwxyz";
+    sql << "insert into soci_test (id, img) values (7, empty_blob())";
 
-        {
-            blob b(sql);
-
-            oracle_session_backend *sessionBackEnd
-                = static_cast<oracle_session_backend *>(sql.get_backend());
+    {
+        blob b(sql);
 
-            oracle_blob_backend *blobBackEnd
-                = static_cast<oracle_blob_backend *>(b.get_backend());
+        oracle_session_backend *sessionBackEnd
+            = static_cast<oracle_session_backend *>(sql.get_backend());
 
-            OCILobDisableBuffering(sessionBackEnd->svchp_,
-                sessionBackEnd->errhp_, blobBackEnd->lobp_);
+        oracle_blob_backend *blobBackEnd
+            = static_cast<oracle_blob_backend *>(b.get_backend());
 
-            sql << "select img from soci_test where id = 7", into(b);
-            CHECK(b.get_len() == 0);
+        OCILobDisableBuffering(sessionBackEnd->svchp_,
+            sessionBackEnd->errhp_, blobBackEnd->lobp_);
 
-            // note: blob offsets start from 1
-            b.write(1, buf, sizeof(buf));
-            CHECK(b.get_len() == sizeof(buf));
-            b.trim(10);
-            CHECK(b.get_len() == 10);
+        sql << "select img from soci_test where id = 7", into(b);
+        CHECK(b.get_len() == 0);
 
-            // append does not work (Oracle bug #886191 ?)
-            //b.append(buf, sizeof(buf));
-            //assert(b.get_len() == sizeof(buf) + 10);
-            sql.commit();
-        }
+        b.write_from_start(buf, sizeof(buf));
+        CHECK(b.get_len() == sizeof(buf));
+        b.trim(10);
+        CHECK(b.get_len() == 10);
 
-        {
-            blob b(sql);
-            sql << "select img from soci_test where id = 7", into(b);
-            //assert(b.get_len() == sizeof(buf) + 10);
-            CHECK(b.get_len() == 10);
-            char buf2[100];
-            b.read(1, buf2, 10);
-            CHECK(strncmp(buf2, "abcdefghij", 10) == 0);
-        }
+        // append does not work (Oracle bug #886191 ?)
+        //b.append(buf, sizeof(buf));
+        //assert(b.get_len() == sizeof(buf) + 10);
+        sql.commit();
     }
 
-    // additional sibling test for read_from_start and write_from_start
     {
-        soci::session sql(backEnd, connectString);
-
-        blob_table_creator tableCreator(sql);
-
-        char buf[] = "abcdefghijklmnopqrstuvwxyz";
-        sql << "insert into soci_test (id, img) values (7, empty_blob())";
-
-        {
-            blob b(sql);
-
-            oracle_session_backend *sessionBackEnd
-                = static_cast<oracle_session_backend *>(sql.get_backend());
-
-            oracle_blob_backend *blobBackEnd
-                = static_cast<oracle_blob_backend *>(b.get_backend());
-
-            OCILobDisableBuffering(sessionBackEnd->svchp_,
-                sessionBackEnd->errhp_, blobBackEnd->lobp_);
-
-            sql << "select img from soci_test where id = 7", into(b);
-            CHECK(b.get_len() == 0);
-
-            // note: blob offsets start from 1
-            b.write_from_start(buf, sizeof(buf));
-            CHECK(b.get_len() == sizeof(buf));
-            b.trim(10);
-            CHECK(b.get_len() == 10);
-
-            // append does not work (Oracle bug #886191 ?)
-            //b.append(buf, sizeof(buf));
-            //assert(b.get_len() == sizeof(buf) + 10);
-            sql.commit();
-        }
-
-        {
-            blob b(sql);
-            sql << "select img from soci_test where id = 7", into(b);
-            //assert(b.get_len() == sizeof(buf) + 10);
-            CHECK(b.get_len() == 10);
-            char buf2[100];
-            b.read_from_start(buf2, 10);
-            CHECK(strncmp(buf2, "abcdefghij", 10) == 0);
-        }
+        blob b(sql);
+        sql << "select img from soci_test where id = 7", into(b);
+        //assert(b.get_len() == sizeof(buf) + 10);
+        CHECK(b.get_len() == 10);
+        char buf2[100];
+        b.read_from_start(buf2, 10);
+        CHECK(strncmp(buf2, "abcdefghij", 10) == 0);
     }
 }
 
@@ -1508,64 +1458,64 @@ public:
                 std::string const &connectString)
         : test_context_base(backEnd, connectString) {}
 
-    table_creator_base* table_creator_1(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_1(soci::session& s) const override
     {
         return new table_creator_one(s);
     }
 
-    table_creator_base* table_creator_2(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_2(soci::session& s) const override
     {
         return new table_creator_two(s);
     }
 
-    table_creator_base* table_creator_3(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_3(soci::session& s) const override
     {
         return new table_creator_three(s);
     }
 
-    table_creator_base* table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_4(soci::session& s) const override
     {
         return new table_creator_four(s);
     }
 
-    table_creator_base* table_creator_clob(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_clob(soci::session& s) const override
     {
         return new table_creator_for_clob(s);
     }
 
-    table_creator_base* table_creator_xml(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_xml(soci::session& s) const override
     {
         return new table_creator_for_xml(s);
     }
 
-    std::string to_xml(std::string const& x) const SOCI_OVERRIDE
+    std::string to_xml(std::string const& x) const override
     {
         return "xmltype(" + x + ")";
     }
 
-    std::string from_xml(std::string const& x) const SOCI_OVERRIDE
+    std::string from_xml(std::string const& x) const override
     {
         // Notice that using just x.getCLOBVal() doesn't work, only
         // table.x.getCLOBVal() or (x).getCLOBVal(), as used here, does.
         return "(" + x + ").getCLOBVal()";
     }
 
-    bool has_real_xml_support() const SOCI_OVERRIDE
+    bool has_real_xml_support() const override
     {
         return true;
     }
 
-    bool treats_empty_strings_as_null() const SOCI_OVERRIDE
+    bool treats_empty_strings_as_null() const override
     {
         return true;
     }
 
-    std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const &datdt_string) const override
     {
         return "to_date('" + datdt_string + "', 'YYYY-MM-DD HH24:MI:SS')";
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         // Oracle treats empty strings as NULLs, but we want to return the
         // length of 0 for them for consistency with the other backends, so use
diff --git a/tests/postgresql/test-postgresql.cpp b/tests/postgresql/test-postgresql.cpp
index 525f872..2f80530 100644
--- a/tests/postgresql/test-postgresql.cpp
+++ b/tests/postgresql/test-postgresql.cpp
@@ -153,82 +153,41 @@ struct blob_table_creator : public table_creator_base
 
 TEST_CASE("PostgreSQL blob", "[postgresql][blob]")
 {
-    {
-        soci::session sql(backEnd, connectString);
+    soci::session sql(backEnd, connectString);
 
-        blob_table_creator tableCreator(sql);
+    blob_table_creator tableCreator(sql);
 
-        char buf[] = "abcdefghijklmnopqrstuvwxyz";
+    char buf[] = "abcdefghijklmnopqrstuvwxyz";
 
-        sql << "insert into soci_test(id, img) values(7, lo_creat(-1))";
+    sql << "insert into soci_test(id, img) values(7, lo_creat(-1))";
 
-        // in PostgreSQL, BLOB operations must be within transaction block
-        transaction tr(sql);
+    // in PostgreSQL, BLOB operations must be within transaction block
+    transaction tr(sql);
 
-        {
-            blob b(sql);
+    {
+        blob b(sql);
 
-            sql << "select img from soci_test where id = 7", into(b);
-            CHECK(b.get_len() == 0);
+        sql << "select img from soci_test where id = 7", into(b);
+        CHECK(b.get_len() == 0);
 
-            b.write(0, buf, sizeof(buf));
-            CHECK(b.get_len() == sizeof(buf));
+        b.write_from_start(buf, sizeof(buf));
+        CHECK(b.get_len() == sizeof(buf));
 
-            b.append(buf, sizeof(buf));
-            CHECK(b.get_len() == 2 * sizeof(buf));
-        }
-        {
-            blob b(sql);
-            sql << "select img from soci_test where id = 7", into(b);
-            CHECK(b.get_len() == 2 * sizeof(buf));
-            char buf2[100];
-            b.read(0, buf2, 10);
-            CHECK(std::strncmp(buf2, "abcdefghij", 10) == 0);
-        }
-
-        unsigned long oid;
-        sql << "select img from soci_test where id = 7", into(oid);
-        sql << "select lo_unlink(" << oid << ")";
+        b.append(buf, sizeof(buf));
+        CHECK(b.get_len() == 2 * sizeof(buf));
     }
-
-    // additional sibling test for read_from_start and write_from_start
     {
-        soci::session sql(backEnd, connectString);
-
-        blob_table_creator tableCreator(sql);
-
-        char buf[] = "abcdefghijklmnopqrstuvwxyz";
-
-        sql << "insert into soci_test(id, img) values(7, lo_creat(-1))";
-
-        // in PostgreSQL, BLOB operations must be within transaction block
-        transaction tr(sql);
-
-        {
-            blob b(sql);
-
-            sql << "select img from soci_test where id = 7", into(b);
-            CHECK(b.get_len() == 0);
-
-            b.write_from_start(buf, sizeof(buf));
-            CHECK(b.get_len() == sizeof(buf));
-
-            b.append(buf, sizeof(buf));
-            CHECK(b.get_len() == 2 * sizeof(buf));
-        }
-        {
-            blob b(sql);
-            sql << "select img from soci_test where id = 7", into(b);
-            CHECK(b.get_len() == 2 * sizeof(buf));
-            char buf2[100];
-            b.read_from_start(buf2, 10);
-            CHECK(std::strncmp(buf2, "abcdefghij", 10) == 0);
-        }
-
-        unsigned long oid;
-        sql << "select img from soci_test where id = 7", into(oid);
-        sql << "select lo_unlink(" << oid << ")";
+        blob b(sql);
+        sql << "select img from soci_test where id = 7", into(b);
+        CHECK(b.get_len() == 2 * sizeof(buf));
+        char buf2[100];
+        b.read_from_start(buf2, 10);
+        CHECK(std::strncmp(buf2, "abcdefghij", 10) == 0);
     }
+
+    unsigned long oid;
+    sql << "select img from soci_test where id = 7", into(oid);
+    sql << "select lo_unlink(" << oid << ")";
 }
 
 struct longlong_table_creator : table_creator_base
@@ -1160,52 +1119,52 @@ public:
         : test_context_base(backend, connstr)
     {}
 
-    table_creator_base* table_creator_1(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_1(soci::session& s) const override
     {
         return new table_creator_one(s);
     }
 
-    table_creator_base* table_creator_2(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_2(soci::session& s) const override
     {
         return new table_creator_two(s);
     }
 
-    table_creator_base* table_creator_3(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_3(soci::session& s) const override
     {
         return new table_creator_three(s);
     }
 
-    table_creator_base* table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_4(soci::session& s) const override
     {
         return new table_creator_for_get_affected_rows(s);
     }
 
-    table_creator_base* table_creator_xml(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_xml(soci::session& s) const override
     {
         return new table_creator_for_xml(s);
     }
 
-    table_creator_base* table_creator_clob(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_clob(soci::session& s) const override
     {
         return new table_creator_for_clob(s);
     }
 
-    bool has_real_xml_support() const SOCI_OVERRIDE
+    bool has_real_xml_support() const override
     {
         return true;
     }
 
-    std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const &datdt_string) const override
     {
         return "timestamptz(\'" + datdt_string + "\')";
     }
 
-    bool has_fp_bug() const SOCI_OVERRIDE
+    bool has_fp_bug() const override
     {
         return false;
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         return "char_length(" + s + ")";
     }
diff --git a/tests/sqlite3/test-sqlite3.cpp b/tests/sqlite3/test-sqlite3.cpp
index 8431f7c..dcd34dc 100644
--- a/tests/sqlite3/test-sqlite3.cpp
+++ b/tests/sqlite3/test-sqlite3.cpp
@@ -53,6 +53,208 @@ TEST_CASE("SQLite rowid", "[sqlite][rowid][oid]")
     sql << "drop table test1";
 }
 
+class SetupForeignKeys
+{
+public:
+    SetupForeignKeys(soci::session& sql)
+        : m_sql(sql)
+    {
+        m_sql <<
+        "create table parent ("
+        "    id integer primary key"
+        ")";
+
+        m_sql <<
+        "create table child ("
+        "    id integer primary key,"
+        "    parent integer,"
+        "    foreign key(parent) references parent(id)"
+        ")";
+
+        m_sql << "insert into parent(id) values(1)";
+        m_sql << "insert into child(id, parent) values(100, 1)";
+    }
+
+    ~SetupForeignKeys()
+    {
+        m_sql << "drop table child";
+        m_sql << "drop table parent";
+    }
+
+private:
+    SetupForeignKeys(const SetupForeignKeys&);
+    SetupForeignKeys& operator=(const SetupForeignKeys&);
+
+    soci::session& m_sql;
+};
+
+TEST_CASE("SQLite foreign keys are disabled by default", "[sqlite][foreignkeys]")
+{
+    soci::session sql(backEnd, connectString);
+
+    SetupForeignKeys setupForeignKeys(sql);
+
+    sql << "delete from parent where id = 1";
+
+    int parent = 0;
+    sql << "select parent from child where id = 100 ", into(parent);
+
+    CHECK(parent == 1);
+}
+
+TEST_CASE("SQLite foreign keys are enabled by foreign_keys option", "[sqlite][foreignkeys]")
+{
+    soci::session sql(backEnd, "dbname=:memory: foreign_keys=on");
+
+    SetupForeignKeys setupForeignKeys(sql);
+
+    CHECK_THROWS_WITH(sql << "delete from parent where id = 1",
+                      "sqlite3_statement_backend::loadOne: FOREIGN KEY "
+                      "constraint failed while executing "
+                      "\"delete from parent where id = 1\".");
+}
+
+class SetupAutoIncrementTable
+{
+public:
+    SetupAutoIncrementTable(soci::session& sql)
+        : m_sql(sql)
+    {
+        m_sql <<
+        "create table t("
+        "    id integer primary key autoincrement,"
+        "    name text"
+        ")";
+    }
+
+    ~SetupAutoIncrementTable()
+    {
+        m_sql << "drop table t";
+    }
+
+private:
+    SetupAutoIncrementTable(const SetupAutoIncrementTable&);
+    SetupAutoIncrementTable& operator=(const SetupAutoIncrementTable&);
+
+    soci::session& m_sql;
+};
+
+TEST_CASE("SQLite get_last_insert_id works with AUTOINCREMENT",
+          "[sqlite][rowid]")
+{
+    soci::session sql(backEnd, connectString);
+    SetupAutoIncrementTable createTable(sql);
+
+    sql << "insert into t(name) values('x')";
+    sql << "insert into t(name) values('y')";
+
+    long long val;
+    sql.get_last_insert_id("t", val);
+    CHECK(val == 2);
+}
+
+TEST_CASE("SQLite get_last_insert_id with AUTOINCREMENT does not reuse IDs when rows deleted",
+          "[sqlite][rowid]")
+{
+    soci::session sql(backEnd, connectString);
+    SetupAutoIncrementTable createTable(sql);
+
+    sql << "insert into t(name) values('x')";
+    sql << "insert into t(name) values('y')";
+
+    sql << "delete from t where id = 2";
+
+    long long val;
+    sql.get_last_insert_id("t", val);
+    CHECK(val == 2);
+}
+
+class SetupNoAutoIncrementTable
+{
+public:
+    SetupNoAutoIncrementTable(soci::session& sql)
+        : m_sql(sql)
+    {
+        m_sql <<
+        "create table t("
+        "    id integer primary key,"
+        "    name text"
+        ")";
+    }
+
+    ~SetupNoAutoIncrementTable()
+    {
+        m_sql << "drop table t";
+    }
+
+private:
+    SetupNoAutoIncrementTable(const SetupNoAutoIncrementTable&);
+    SetupNoAutoIncrementTable& operator=(const SetupNoAutoIncrementTable&);
+
+    soci::session& m_sql;
+};
+
+TEST_CASE("SQLite get_last_insert_id without AUTOINCREMENT reuses IDs when rows deleted",
+          "[sqlite][rowid]")
+{
+    soci::session sql(backEnd, connectString);
+    SetupNoAutoIncrementTable createTable(sql);
+
+    sql << "insert into t(name) values('x')";
+    sql << "insert into t(name) values('y')";
+
+    sql << "delete from t where id = 2";
+
+    long long val;
+    sql.get_last_insert_id("t", val);
+    CHECK(val == 1);
+}
+
+TEST_CASE("SQLite get_last_insert_id throws if table not found",
+          "[sqlite][rowid]")
+{
+    soci::session sql(backEnd, connectString);
+
+    long long val;
+    CHECK_THROWS(sql.get_last_insert_id("notexisting", val));
+}
+
+class SetupTableWithDoubleQuoteInName
+{
+public:
+    SetupTableWithDoubleQuoteInName(soci::session& sql)
+        : m_sql(sql)
+    {
+        m_sql <<
+        "create table \"t\"\"fff\"("
+        "    id integer primary key,"
+        "    name text"
+        ")";
+    }
+
+    ~SetupTableWithDoubleQuoteInName()
+    {
+        m_sql << "drop table \"t\"\"fff\"";
+    }
+
+private:
+    SetupTableWithDoubleQuoteInName(const SetupTableWithDoubleQuoteInName&);
+    SetupTableWithDoubleQuoteInName& operator=(const SetupTableWithDoubleQuoteInName&);
+
+    soci::session& m_sql;
+};
+
+TEST_CASE("SQLite get_last_insert_id escapes table name",
+          "[sqlite][rowid]")
+{
+    soci::session sql(backEnd, connectString);
+    SetupTableWithDoubleQuoteInName table(sql);
+
+    long long val;
+    sql.get_last_insert_id("t\"fff", val);
+    CHECK(val == 0);
+}
+
 // BLOB test
 struct blob_table_creator : public table_creator_base
 {
@@ -83,7 +285,7 @@ TEST_CASE("SQLite blob", "[sqlite][blob]")
         sql << "select img from soci_test where id = 7", into(b);
         CHECK(b.get_len() == 0);
 
-        b.write(0, buf, sizeof(buf));
+        b.write_from_start(buf, sizeof(buf));
         CHECK(b.get_len() == sizeof(buf));
         sql << "update soci_test set img=? where id = 7", use(b);
 
@@ -96,7 +298,7 @@ TEST_CASE("SQLite blob", "[sqlite][blob]")
         sql << "select img from soci_test where id = 8", into(b);
         CHECK(b.get_len() == 2 * sizeof(buf));
         char buf2[100];
-        b.read(0, buf2, 10);
+        b.read_from_start(buf2, 10);
         CHECK(std::strncmp(buf2, "abcdefghij", 10) == 0);
 
         sql << "select img from soci_test where id = 7", into(b);
@@ -391,6 +593,15 @@ struct table_creator_for_get_affected_rows : table_creator_base
 // Support for SOCI Common Tests
 //
 
+struct table_creator_from_str : table_creator_base
+{
+    table_creator_from_str(soci::session & sql, std::string const& sqlStr)
+        : table_creator_base(sql)
+    {
+        sql << sqlStr;
+    }
+};
+
 class test_context : public test_context_base
 {
 public:
@@ -398,46 +609,44 @@ public:
                 std::string const &connstr)
         : test_context_base(backend, connstr) {}
 
-    table_creator_base* table_creator_1(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_1(soci::session& s) const override
     {
         return new table_creator_one(s);
     }
 
-    table_creator_base* table_creator_2(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_2(soci::session& s) const override
     {
         return new table_creator_two(s);
     }
 
-    table_creator_base* table_creator_3(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_3(soci::session& s) const override
     {
         return new table_creator_three(s);
     }
 
-    table_creator_base* table_creator_4(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_4(soci::session& s) const override
     {
         return new table_creator_for_get_affected_rows(s);
     }
 
-    table_creator_base* table_creator_get_last_insert_id(soci::session& s) const SOCI_OVERRIDE
+    table_creator_base* table_creator_get_last_insert_id(soci::session& s) const override
     {
-        struct table_creator_for_get_last_insert_id : table_creator_base
-        {
-            table_creator_for_get_last_insert_id(soci::session & sql)
-                : table_creator_base(sql)
-            {
-                sql << "create table soci_test (id integer primary key, val integer)";
-            }
-        };
+        return new table_creator_from_str(s,
+            "create table soci_test (id integer primary key, val integer)");
+    }
 
-        return new table_creator_for_get_last_insert_id(s);
+    table_creator_base* table_creator_xml(soci::session& s) const override
+    {
+        return new table_creator_from_str(s,
+            "create table soci_test (id integer, x text)");
     }
 
-    std::string to_date_time(std::string const &datdt_string) const SOCI_OVERRIDE
+    std::string to_date_time(std::string const &datdt_string) const override
     {
         return "datetime(\'" + datdt_string + "\')";
     }
 
-    bool has_fp_bug() const SOCI_OVERRIDE
+    bool has_fp_bug() const override
     {
         /*
             SQLite seems to be buggy when using text conversion, e.g.:
@@ -455,13 +664,13 @@ public:
         return true;
     }
 
-    bool enable_std_char_padding(soci::session&) const SOCI_OVERRIDE
+    bool enable_std_char_padding(soci::session&) const override
     {
         // SQLite does not support right padded char type.
         return false;
     }
 
-    std::string sql_length(std::string const& s) const SOCI_OVERRIDE
+    std::string sql_length(std::string const& s) const override
     {
         return "length(" + s + ")";
     }
diff --git a/valgrind.suppress b/valgrind.suppress
new file mode 100644
index 0000000..30c6b1c
--- /dev/null
+++ b/valgrind.suppress
@@ -0,0 +1,8 @@
+# Reported as a leak in Travis CI Ubuntu 12.04.5 LTS builds.
+{
+   ignored libc NSS leak
+   Memcheck:Leak
+   fun:malloc
+   fun:nss_parse_service_list
+   fun:__nss_database_lookup
+}
diff --git a/www/articles.html b/www/articles.html
new file mode 100644
index 0000000..87b6d3f
--- /dev/null
+++ b/www/articles.html
@@ -0,0 +1,47 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+    <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type" />
+    <link rel="stylesheet" type="text/css" href="style.css" />
+    <title>SOCI - articles</title>
+</head>
+<body>
+<table class="banner" cellpadding="0" cellspacing="0">
+      <tr>
+        <td class="banner_left">
+          SOCI - The C++ Database Access Library
+        </td>
+      </tr>
+</table>
+
+<table class="main">
+      <tr>
+        <td class="main_navigator">
+          <p><a href="index.html">Home</a><br />
+          <a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">Download</a><br />
+          <a href="doc/index.html">Documentation</a><br />
+          Articles<br />
+          <a href="people.html">People</a><br />
+          <a href="events.html">Events</a><br />
+          <a href="links.html">Links</a><br />
+          </p>
+          <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=121480&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
+        </td>
+        <td class="main_text">
+<p>The following articles were published about SOCI:</p>
+<ul>
+<li><a href="http://ddj.com/dept/cpp/188700800" target="_blank">Supporting Custom C++ Types</a> by Stephen Hutton, in Dr. Dobb's Journal (June 2006).</li>
+<li><a href="http://www.ddj.com/184405930" target="_blank">A Simple Oracle Call Interface</a> by Maciej Sobczak, in Dr. Dobb's Journal (October 2004).</li>
+</ul>
+
+<p>as well as presentations:</p>
+<ul>
+    <li><a href="http://slid.es/mloskot/soci" target="_blank">Introduction To A Simple C++ Database Access Library</a> by Mateusz Loskot at London C++ Meeting (May 2013).</li>
+</ul>
+      </td>
+    </tr>
+</table>
+
+<a href="http://github.com/SOCI"><img style="position: absolute; top: 0; right: 0; border: 0;" src="forkus_github.png" alt="Fork us on GitHub"></a>
+</body>
+</html>
diff --git a/www/doc.html b/www/doc.html
new file mode 100644
index 0000000..84344d2
--- /dev/null
+++ b/www/doc.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<html>
+<head>
+   <meta http-equiv="refresh" content="0; url=http://soci.sourceforge.net/doc/index.html">
+</head>
+<body>
+   <p>The SOCI documentation front page has moved to <a href="http://soci.sourceforge.net/doc/index.html">this page</a></p>
+</body>
+</html>
diff --git a/www/doc/README.md b/www/doc/README.md
new file mode 100644
index 0000000..cfc098e
--- /dev/null
+++ b/www/doc/README.md
@@ -0,0 +1,12 @@
+SOCI Documentation
+==================
+
+The `/www/doc` directory is a placeholder for documentation published
+online, with subdirectories of versioned documentation, one per each
+branch (`master`, `release/3.2`, etc.), that is:
+
+* doc/master
+* doc/release/3.2
+* doc/release/3.1
+
+Documentation pages are copied from /doc directory of each release.
diff --git a/www/doc/index.html b/www/doc/index.html
new file mode 100644
index 0000000..cf3404b
--- /dev/null
+++ b/www/doc/index.html
@@ -0,0 +1,47 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <meta content="text/html; charset=utf-8" http-equiv="content-type" />
+  <link rel="stylesheet" type="text/css" href="/style.css" />
+  <title>SOCI - documentation</title>
+</head>
+<body>
+  <table class="banner" cellpadding="0" cellspacing="0">
+    <tr>
+      <td class="banner_left">SOCI - The C++ Database Access Library
+      </td>
+    </tr>
+  </table>
+
+  <table class="main">
+    <tr>
+      <td class="main_navigator">
+        <p>
+          <a href="/index.html">Home</a><br />
+          <a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">Download</a><br />
+          Documentation<br />
+          <a href="/articles.html">Articles</a><br />
+          <a href="/people.html">People</a><br />
+          <a href="/events.html">Events</a><br />
+          <a href="/links.html">Links</a><br />
+        </p>
+        <a href="http://sourceforge.net">
+          <img src="http://sflogo.sourceforge.net/sflogo.php?group_id=121480&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
+      </td>
+      <td class="main_text">
+        <p>SOCI documentation:</p>
+        <ul>
+          <li><a href="master/" target="_blank">master</a> (development)</li>
+          <li><a href="release/4.0/" target="_blank">4.0</a> (stable release)</li>
+          <li><a href="release/3.2/" target="_blank">3.2</a></li>
+          <li><a href="release/3.1/" target="_blank">3.1</a></li>
+        </ul>
+      </td>
+    </tr>
+  </table>
+
+  <a href="http://github.com/SOCI">
+    <img style="position: absolute; top: 0; right: 0; border: 0;" src="/forkus_github.png" alt="Fork us on GitHub" />
+  </a>
+</body>
+</html>
diff --git a/www/events.html b/www/events.html
new file mode 100644
index 0000000..416a7cd
--- /dev/null
+++ b/www/events.html
@@ -0,0 +1,117 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+    <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type" />
+    <link rel="stylesheet" type="text/css" href="style.css" />
+    <title>SOCI - events</title>
+</head>
+<body>
+<table class="banner" cellpadding="0" cellspacing="0">
+    <tr>
+    <td class="banner_left">
+        SOCI - The C++ Database Access Library
+    </td>
+    </tr>
+</table>
+
+<table class="main">
+    <tr>
+    <td class="main_navigator">
+        <p><a href="index.html">Home</a><br />
+        <a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">Download</a><br />
+        <a href="doc/index.html">Documentation</a><br />
+        <a href="articles.html">Articles</a><br />
+        <a href="people.html">People</a><br />
+        Events<br />
+        <a href="links.html">Links</a><br />
+        </p>
+        <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=121480&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
+    </td>
+    <td class="main_text">
+<p><span class="bold">Events:</span></p>
+
+<span class="bold">2021-04-19:</span>
+<div class="indent">4.0.2 version is released.
+</div>
+
+<span class="bold">2020-10-19:</span>
+<div class="indent">4.0.1 version is released.
+</div>
+
+<span class="bold">2019-11-09:</span>
+<div class="indent">4.0.0 version is released.
+</div>
+
+<span class="bold">2019-09-27:</span>
+<div class="indent"><a href="https://sourceforge.net/p/soci/mailman/message/36773320/">Created branch release/4.0</a> for maintenance of the upcoming SOCI 4.0.0 release.
+</div>
+
+<span class="bold">2015-04-09:</span>
+<div class="indent">3.2.3 version is released.
+</div>
+
+<span class="bold">2013-09-11:</span>
+<div class="indent">3.2.2 version is released.
+</div>
+<span class="bold">2013-04-13:</span>
+<div class="indent">3.2.1 version is released.
+</div>
+<br />
+<span class="bold">2013-03-25:</span>
+<div class="indent">3.2.0 version is released.
+</div>
+<br />
+<span class="bold">2012-11-12:</span>
+<div class="indent">SOCI development (Git repository and bug tracker) moved to <a href="https://github.com/SOCI">github.com/SOCI</a>.
+</div>
+<br />
+<span class="bold">2011-10-11:</span>
+<div class="indent">3.1.0 version is released.
+</div>
+<br />
+<span class="bold">2008-07-10:</span>
+<div class="indent">3.0.0 version is released.
+</div>
+<br />
+<span class="bold">2006-12-04:</span>
+<div class="indent">2.2.0 version is released.
+</div>
+<br />
+<span class="bold">2006-05-15:</span>
+<div class="indent">2.1.0 version is released.
+</div>
+<br />
+<span class="bold">2006-01-16:</span>
+<div class="indent">2.0.0 version is released.
+</div>
+<br />
+<span class="bold">2005-10-14:</span>
+<div class="indent">1.2.1 version is released.
+</div>
+<br />
+<span class="bold">2005-10-02:</span>
+<div class="indent">1.2.0 version is released.
+</div>
+<br />
+<span class="bold">2005-03-06:</span>
+<div class="indent">1.1.0 version is released.
+</div>
+<br />
+<span class="bold">2004-10-16:</span>
+<div class="indent">1.0.1 version is released.
+</div>
+<br />
+<span class="bold">2004-10-12:</span>
+<div class="indent">SOCI project is registered at SourceForge.
+</div>
+<br />
+<span class="bold">2004-09-29:</span>
+<div class="indent">First version of SOCI is announced on comp.lang.c++.moderated.
+</div>
+      </td>
+    </tr>
+</table>
+
+<a href="http://github.com/SOCI"><img style="position: absolute; top: 0; right: 0; border: 0;" src="forkus_github.png" alt="Fork us on GitHub"></a>
+</body>
+</html>
diff --git a/www/forkus_github.png b/www/forkus_github.png
new file mode 100644
index 0000000..e782f36
Binary files /dev/null and b/www/forkus_github.png differ
diff --git a/www/index.html b/www/index.html
new file mode 100644
index 0000000..1d069f3
--- /dev/null
+++ b/www/index.html
@@ -0,0 +1,134 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns='http://www.w3.org/1999/xhtml' xml:lang='en'>
+<head>
+    <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type" />
+    <link rel="stylesheet" type="text/css" href="style.css" />
+    <title>SOCI</title>
+</head>
+<body>
+<table class="banner" cellpadding="0" cellspacing="0">
+    <tr>
+    <td class="banner_left">
+        SOCI - The C++ Database Access Library
+    </td>
+    </tr>
+</table>
+
+<table class="main">
+    <tr>
+    <td class="main_navigator">
+        <p>Home<br />
+        <a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">Download</a><br />
+        <a href="doc/index.html">Documentation</a><br />
+        <a href="articles.html">Articles</a><br />
+        <a href="people.html">People</a><br />
+        <a href="events.html">Events</a><br />
+        <a href="links.html">Links</a><br />
+        </p>
+        <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=121480&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
+    </td>
+    <td class="main_text">
+<p>SOCI is a database access library
+for C++ that makes the illusion of <i>embedding</i>
+SQL queries in the regular
+C++ code, staying entirely within the Standard C++.</p>
+
+<p>The idea is to provide C++ programmers a way to access SQL
+databases in the most natural and intuitive way. If you find existing
+libraries too difficult for your needs or just distracting, SOCI can be
+a good alternative.</p>
+
+<p>The simplest motivating code example for the SQL query that is supposed
+to retrieve a single row is:</p>
+<pre>
+int id = ...;
+string name;
+int salary;
+
+<span class="bold">sql &lt;&lt; "</span><span class="literal">select name, salary from persons where id = </span><span class="bold">" &lt;&lt; id,
+       into(name), into(salary);</span>
+</pre>
+
+<p>and the following benefits from extensive support for object-relational
+mapping:</p>
+<pre>
+int id = ...;
+Person p;
+
+<span class="bold">sql &lt;&lt; "</span><span class="literal">select first_name, last_name, date_of_birth "
+       "from persons where id = </span><span class="bold">" &lt;&lt; id,
+       into(p);</span>
+</pre>
+
+<p>Integration with STL is also supported:</p>
+
+<pre>
+<span class="bold">Rowset&lt;string&gt; rs = (sql.prepare &lt;&lt; "</span><span class="literal">select name from persons</span><span class="bold">");
+copy(rs.begin(), rs.end(), ostream_iterator&lt;string&gt;(cout, "\n"));</span>
+</pre>
+
+<p>SOCI offers also extensive integration with Boost datatypes (optional, tuple and fusion) and flexible support
+for user-defined datatypes.</p>
+
+<p>Even though SOCI is mainly a C++ library, it also allows to use it from other programming languages. Currently the package contains the Ada binding, with more bindings likely to come in the future.</p>
+
+<p>Starting from its 2.0.0 release, SOCI uses the plug-in architecture for
+backends - this allows to target various database servers.
+Currently (4.0.2), the following database systems are supported:</p>
+<ul>
+    <li>DB2</li>
+    <li>Firebird</li>
+    <li>MySQL</li>
+    <li>ODBC (generic backend)</li>
+    <li>Oracle</li>
+    <li>PostgreSQL</li>
+    <li>SQLite3</li>
+</ul>
+
+<p>The intent of the library is to cover as many database technologies as
+possible. For this, the project has to rely on volunteer contributions
+from other programmers, who have expertise with the existing database
+interfaces and would like to help writing dedicated backends.<br />
+If you are interested in participating, please contact the <a
+ href="people.html">project admin</a>.</p>
+
+<p>The SOCI library is distributed under the terms of the <a
+ target="_blank" href="http://www.boost.org/LICENSE_1_0.txt">Boost
+Software License</a>.</p>
+
+<p>All SOCI downloads are hosted on SourceForge.net servers. The current
+stable release (4.0.2) can be downloaded <a href="https://sourceforge.net/p/soci/" target="_blank">here</a>,
+and all previous releases are available
+<a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">here</a>.</p>
+
+<p>The development of SOCI happens on GitHub. All repositories live
+under the <a target="_blank" href="http://github.com/organizations/SOCI">SOCI</a>
+organization where all Git repositories are available.</p>
+
+<p>The main Git repository with SOCI source code can be cloned with:</p>
+<pre>
+$ git clone git://github.com/SOCI/soci.git
+</pre>
+
+<p>The <a href="https://github.com/SOCI/soci/issues">Issues</a> tracker is open
+for bug reports and patches submission.</p>
+
+<p>The best way to contribute to SOCI is to follow the typical GitHub workflow:
+fork SOCI, apply your edits and submit <a href="https://github.com/SOCI/soci/pulls">Pull Request</a>.
+<br /> Feel free to join SOCI development!</p>
+
+<p>To meet other users, please consider subscribing to the
+<a target="_blank" href="https://lists.sourceforge.net/lists/listinfo/soci-users">SOCI-users mailing list</a>.
+There is also <a target="_blank" href="https://lists.sourceforge.net/lists/listinfo/soci-devel">SOCI-devel mailing list</a>
+available dedicated to development discussions only.</p>
+
+<p>There is also community-driven <a target="_blank" href="https://github.com/SOCI/soci/wiki/">Wiki</a>
+and <a target="_blank" href="https://github.com/SOCI/soci/wiki/FAQ">FAQ</a> hosted at GitHub, where everybody
+is welcome to contribute.</p>
+      </td>
+    </tr>
+</table>
+
+<a href="http://github.com/SOCI"><img style="position: absolute; top: 0; right: 0; border: 0;" src="forkus_github.png" alt="Fork us on GitHub"></a>
+</body>
+</html>
diff --git a/www/links.html b/www/links.html
new file mode 100644
index 0000000..5bcc514
--- /dev/null
+++ b/www/links.html
@@ -0,0 +1,78 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+    <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type" />
+    <link rel="stylesheet" type="text/css" href="style.css" />
+    <title>SOCI - links</title>
+</head>
+<body>
+<table class="banner" cellpadding="0" cellspacing="0">
+      <tr>
+        <td class="banner_left">
+          SOCI - The C++ Database Access Library
+        </td>
+      </tr>
+</table>
+
+<table class="main">
+      <tr>
+        <td class="main_navigator">
+          <p><a href="index.html">Home</a><br />
+          <a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">Download</a><br />
+          <a href="doc/index.html">Documentation</a><br />
+          <a href="articles.html">Articles</a><br />
+          <a href="people.html">People</a><br />
+          <a href="events.html">Events</a><br />
+          Links<br />
+          </p>
+          <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=121480&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
+        </td>
+        <td class="main_text">
+<p><span class="bold">Some links you may find useful:</span></p>
+
+ORAPP - Oracle OCI C++ Interface Library
+<div class="indent"><a href="http://orapp.sourceforge.net/" target="_blank">http://orapp.sourceforge.net/</a>
+</div>
+<br />
+
+OCI C++ Library
+<div class="indent"><a href="http://ocicpplib.sourceforge.net/" target="_blank">http://ocicpplib.sourceforge.net/</a>
+</div>
+<br />
+
+Oracle, ODBC and DB2-CLI Template Library
+<div class="indent"><a href="http://otl.sourceforge.net/" target="_blank">http://otl.sourceforge.net/</a>
+</div>
+<br />
+
+Oracle C++ Call Interface
+<div class="indent"><a href="http://otn.oracle.com/tech/oci/occi/index.html" target="_blank">http://otn.oracle.com/tech/oci/occi/index.html</a>
+</div>
+<br />
+
+Oracle Open Source Projects
+<div class="indent"><a href="http://www.oracle.com/technology/tech/opensource/projects.html"
+ target="_blank">http://www.oracle.com/technology/tech/opensource/projects.html</a>
+</div>
+<br />
+
+Database Template Library
+<div class="indent"><a href="http://dtemplatelib.sourceforge.net/index.htm">http://dtemplatelib.sourceforge.net/index.htm</a>
+</div>
+<br />
+
+MyMySQL - A lightweight C++ wrapper around MySQL client API
+<div class="indent"><a href="http://www.redi.uklinux.net/mymysql/" target="_blank">http://www.redi.uklinux.net/mymysql/</a>
+</div>
+<br />
+
+CMake Cross Platform make
+<div class="indent"><a href="http://cmake.org/" target="_blank">http://cmake.org/</a>
+</div>
+      </td>
+    </tr>
+</table>
+
+<a href="http://github.com/SOCI"><img style="position: absolute; top: 0; right: 0; border: 0;" src="forkus_github.png" alt="Fork us on GitHub"></a>
+</body>
+</html>
diff --git a/www/people.html b/www/people.html
new file mode 100644
index 0000000..30eb663
--- /dev/null
+++ b/www/people.html
@@ -0,0 +1,122 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta name="generator" content="HTML Tidy for HTML5 (experimental) for Windows https://github.com/w3c/tidy-html5/tree/c63cc39" />
+    <meta content="text/html; charset=utf-8" http-equiv="content-type" />
+    <link rel="stylesheet" type="text/css" href="style.css" />
+    <title>
+      SOCI - people
+    </title>
+  </head>
+  <body>
+    <table class="banner" cellpadding="0" cellspacing="0">
+      <tr>
+        <td class="banner_left">
+          SOCI - The C++ Database Access Library
+        </td>
+      </tr>
+    </table>
+    <table class="main">
+      <tr>
+        <td class="main_navigator">
+          <p>
+            <a href="index.html">Home</a><br />
+            <a href="http://sourceforge.net/project/showfiles.php?group_id=121480" target="_blank">Download</a><br />
+            <a href="doc/index.html">Documentation</a><br />
+            <a href="articles.html">Articles</a><br />
+            People<br />
+            <a href="events.html">Events</a><br />
+            <a href="links.html">Links</a><br />
+          </p><a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=121480&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
+        </td>
+        <td class="main_text">
+          <p><span class="bold">SOCI People:</span></p>
+          <p>Core team developers and contributors, current and previous, all people actively involved
+          <div class="column-left">
+            <span class="bold">Maciej Sobczak</span> (see <a target="_blank" href="http://www.msobczak.com/">homepage</a>)
+            <div class="indent">
+              Project admin<br />
+              Core development<br />
+              Initial Oracle Call Interface support (author)<br />
+              Plug-in backend architecture (author)<br />
+              PostgreSQL backend (author)<br />
+              Documentation
+            </div><br />
+            <span class="bold">Mateusz Łoskot</span> (see <a target="_blank" href="http://mateusz.loskot.net">homepage</a>)
+            <div class="indent">
+              Project admin<br />
+              Core development<br />
+              Iterator support<br />
+              Oracle backend (maintainer)<br />
+              PostgreSQL backend (maintainer)<br />
+              Build, test and release troublemaker<br />
+              Documentation
+            </div><br />
+            <span class="bold">Paweł Aleksander Fedoryński</span> (see <a target="_blank" href="http://www.jfedor.org/pfedor/">homepage</a>)
+            <div class="indent">
+              MySQL backend (author, maintainer)<br />
+              Documentation
+            </div><br />
+            <span class="bold">Steve Hutton</span> (see <a target="_blank" href="http://featurecomplete.com">homepage</a>)
+            <div class="indent">
+              Core development<br />
+              Bulk (vector) operations<br />
+              Dynamic result binding<br />
+              Object-Relational mapping facilities<br />
+              Common tests framework<br />
+              Documentation
+            </div><br />
+            <span class="bold">David Courtney</span> (see <a target="_blank" href="http://www.davidcourtney.com">homepage</a>)
+            <div class="indent">
+              SQLite backend (author)<br />
+              MS SQL Server (via ODBC) backend (author)
+            </div><br />
+            <span class="bold">Rafał Bobrowski</span>
+            <div class="indent">
+              Firebird backend (author)
+            </div><br />
+          </div>
+          <div class="column-right">
+            <span class="bold">Vadim Zeitlin</span> (see <a target="_blank" href="https://github.com/vadz">GitHub</a>)
+            <div class="indent">
+              ODBC backend (maintainer)<br />
+              Core development<br />
+            </div><br />
+            <span class="bold">Viacheslav Naydenov</span> (see <a target="_blank" href="https://github.com/vnaydionov">GitHub</a>)
+            <div class="indent">
+              Firebird backend (maintainer)<br />
+              Core development<br />
+            </div><br />
+            <span class="bold">Alex Ott</span> (see <a target="_blank" href="http://alexott.net/">homepage</a>)
+            <div class="indent">
+              Plug-in backend architecture<br />
+              Core development<br />
+            </div><br />
+            <span class="bold">Denis Chapligin</span> (see <a target="_blank" href="https://github.com/akashihi">GitHub</a>)
+            <div class="indent">
+              IBM DB2 backend (author)
+            </div><br />
+            <span class="bold">Denis Arnaud</span> (see <a target="_blank" href="https://github.com/denisarnaud">GitHub</a>)
+            <div class="indent">
+              Fedora and Debian packaging<br />
+              Contributor<br />
+              Troubleshooter<br />
+            </div><br />
+            <span class="bold">Julian Taylor</span> (see <a target="_blank" href="https://github.com/juliantaylor">GitHub</a>)
+            <div class="indent">
+              Debian packaging<br />
+              Contributor<br />
+              Troubleshooter<br />
+            </div><br />
+            <span class="bold">Sergei Nikulov</span> (see <a target="_blank" href="https://github.com/snikulov">GitHub</a>)
+            <div class="indent">
+              SQLite3 contributor<br />
+              Troubleshooter
+            </div><br />
+          </div>
+        </td>
+      </tr>
+    </table><a href="http://github.com/SOCI"><img style="position: absolute; top: 0; right: 0; border: 0;" src="forkus_github.png" alt="Fork us on GitHub" /></a>
+  </body>
+</html>
diff --git a/www/style.css b/www/style.css
new file mode 100644
index 0000000..8836c3b
--- /dev/null
+++ b/www/style.css
@@ -0,0 +1,87 @@
+body
+{
+  background-color: white;
+  color: black;
+  margin-left: 100px;
+  margin-right: 100px;
+/*   font-family: arial, sans-serif; */
+}
+
+table.banner
+{
+  width: 100%;
+  border-bottom-color: black;
+  border-bottom-style: solid;
+  border-bottom-width: 1px;
+  padding-top: 16px;
+  padding-right: 16px;
+  padding-bottom: 5px;
+}
+
+td.banner_left
+{
+  font-size: x-large;
+  font-weight: bold;
+  font-stretch: expanded;
+}
+
+td.banner_right
+{
+  text-align: right;
+}
+
+table.footer
+{
+  width: 100%;
+  border-top-color: black;
+  border-top-style: solid;
+  border-top-width: 1px;
+  padding-bottom: 16px;
+  padding-top: 5px;
+}
+
+table.main
+{
+  width: 60%;
+  padding-top: 25px;
+}
+
+td.main_navigator
+{
+  vertical-align: top;
+}
+
+td.main_text
+{
+  vertical-align: top;
+  padding-left: 20px;
+}
+
+span.bold
+{
+  font-weight: bold;
+}
+
+span.literal
+{
+  font-weight: bold;
+  background-color: white;
+  color: #8B0000;
+}
+
+div.indent
+{
+  margin-left: 40px;
+}
+
+div.column-left
+{
+  width: 50%;
+  float: left;
+}
+
+div.column-right
+{
+  width: 50%;
+  float: right;
+}

Debdiff

[The following lists of changes regard files as different if they have different names, permissions or owners.]

Files in second set of .debs but not in first

-rw-r--r--  root/root   /usr/include/soci/std-optional.h
-rw-r--r--  root/root   /usr/lib/debug/.build-id/41/98ad1b37647e88135d2c082c0093fb6470fa4c.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/41/bdf7bc06c1f162b0391979bbb350035a9508ed.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/54/8d0a156b31c758c4754464107f621b213897c5.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/ca/500859e9b0f2d488d8f90743f76d16c9cf1f52.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/ce/ebca43b3d1be671055f23cc31bbb846912c1d4.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/ef/04d0f05e30b104efb78308a6d9e9518557da5e.debug
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_core.so.4.1.0
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_firebird.so.4.1.0
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_mysql.so.4.1.0
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_odbc.so.4.1.0
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_postgresql.so.4.1.0
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_sqlite3.so.4.1.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_core.so -> libsoci_core.so.4.1
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_core.so.4.1 -> libsoci_core.so.4.1.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_firebird.so -> libsoci_firebird.so.4.1
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_firebird.so.4.1 -> libsoci_firebird.so.4.1.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_mysql.so -> libsoci_mysql.so.4.1
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_mysql.so.4.1 -> libsoci_mysql.so.4.1.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_odbc.so -> libsoci_odbc.so.4.1
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_odbc.so.4.1 -> libsoci_odbc.so.4.1.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_postgresql.so -> libsoci_postgresql.so.4.1
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_postgresql.so.4.1 -> libsoci_postgresql.so.4.1.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_sqlite3.so -> libsoci_sqlite3.so.4.1
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_sqlite3.so.4.1 -> libsoci_sqlite3.so.4.1.0

Files in first set of .debs but not in second

-rw-r--r--  root/root   /usr/lib/debug/.build-id/07/65fed9a0e84d16e07b79e6f1f6b41101e2f467.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/4c/28c50771483054347edcbe01be1fb718f4a745.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/9b/1c1ea6e37d07f67a6211b212748c017619ef7a.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/b7/1567f69f7e7fe2ea0fba79170ea788ebb2463e.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/ea/6100d0ab1e05a8a88e8d6d002a7d8fac45756b.debug
-rw-r--r--  root/root   /usr/lib/debug/.build-id/fb/a95fb72c078a48989dae42a65b8c692ea428c5.debug
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_core.so.4.0.3
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_firebird.so.4.0.3
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_mysql.so.4.0.3
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_odbc.so.4.0.3
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_postgresql.so.4.0.3
-rw-r--r--  root/root   /usr/lib/x86_64-linux-gnu/libsoci_sqlite3.so.4.0.3
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_core.so -> libsoci_core.so.4.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_core.so.4.0 -> libsoci_core.so.4.0.3
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_firebird.so -> libsoci_firebird.so.4.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_firebird.so.4.0 -> libsoci_firebird.so.4.0.3
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_mysql.so -> libsoci_mysql.so.4.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_mysql.so.4.0 -> libsoci_mysql.so.4.0.3
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_odbc.so -> libsoci_odbc.so.4.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_odbc.so.4.0 -> libsoci_odbc.so.4.0.3
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_postgresql.so -> libsoci_postgresql.so.4.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_postgresql.so.4.0 -> libsoci_postgresql.so.4.0.3
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_sqlite3.so -> libsoci_sqlite3.so.4.0
lrwxrwxrwx  root/root   /usr/lib/x86_64-linux-gnu/libsoci_sqlite3.so.4.0 -> libsoci_sqlite3.so.4.0.3

No differences were encountered between the control files of package libsoci-core4.0

Control files of package libsoci-core4.0-dbgsym: lines which differ (wdiff format)

  • Build-Ids: 9b1c1ea6e37d07f67a6211b212748c017619ef7a 548d0a156b31c758c4754464107f621b213897c5

No differences were encountered between the control files of package libsoci-dev

Control files of package libsoci-firebird4.0: lines which differ (wdiff format)

  • Depends: libc6 (>= 2.14), libfbclient2 (>= 2.5.0.25784~ReleaseCandidate1.ds2), libgcc-s1 (>= 3.0), libsoci-core4.0 (>= 4.0.3), 4.0.3+git20221201.0.80d4122), libstdc++6 (>= 9)

Control files of package libsoci-firebird4.0-dbgsym: lines which differ (wdiff format)

  • Build-Ids: 0765fed9a0e84d16e07b79e6f1f6b41101e2f467 41bdf7bc06c1f162b0391979bbb350035a9508ed

Control files of package libsoci-mysql4.0: lines which differ (wdiff format)

  • Depends: libc6 (>= 2.14), libgcc-s1 (>= 3.0), libmariadb3 (>= 3.0.0), libsoci-core4.0 (>= 4.0.3), 4.0.3+git20221201.0.80d4122), libstdc++6 (>= 5.2)

Control files of package libsoci-mysql4.0-dbgsym: lines which differ (wdiff format)

  • Build-Ids: ea6100d0ab1e05a8a88e8d6d002a7d8fac45756b ca500859e9b0f2d488d8f90743f76d16c9cf1f52

Control files of package libsoci-odbc4.0: lines which differ (wdiff format)

  • Depends: libc6 (>= 2.14), libgcc-s1 (>= 3.0), libodbc2 (>= 2.3.1), libsoci-core4.0 (>= 4.0.3), 4.0.3+git20221201.0.80d4122), libstdc++6 (>= 5.2)

Control files of package libsoci-odbc4.0-dbgsym: lines which differ (wdiff format)

  • Build-Ids: b71567f69f7e7fe2ea0fba79170ea788ebb2463e ceebca43b3d1be671055f23cc31bbb846912c1d4

Control files of package libsoci-postgresql4.0: lines which differ (wdiff format)

  • Depends: libc6 (>= 2.14), libgcc-s1 (>= 3.0), libpq5 (>= 9.2~beta3), libsoci-core4.0 (>= 4.0.3), 4.0.3+git20221201.0.80d4122), libstdc++6 (>= 5.2)

Control files of package libsoci-postgresql4.0-dbgsym: lines which differ (wdiff format)

  • Build-Ids: 4c28c50771483054347edcbe01be1fb718f4a745 4198ad1b37647e88135d2c082c0093fb6470fa4c

Control files of package libsoci-sqlite3-4.0: lines which differ (wdiff format)

  • Depends: libc6 (>= 2.14), libgcc-s1 (>= 3.0), libsoci-core4.0 (>= 4.0.3), 4.0.3+git20221201.0.80d4122), libsqlite3-0 (>= 3.5.9), libstdc++6 (>= 5.2)

Control files of package libsoci-sqlite3-4.0-dbgsym: lines which differ (wdiff format)

  • Build-Ids: fba95fb72c078a48989dae42a65b8c692ea428c5 ef04d0f05e30b104efb78308a6d9e9518557da5e

More details

Full run details

© 2018-2023 Jelmer Vernooij. File a bug. Source code. Published under the GNU GPLv2 or later.