From da8757de2fd0e0d607a70e3d15b6ecd3fac0c74c Mon Sep 17 00:00:00 2001
From: Morris Jobke <hey@morrisjobke.de>
Date: Mon, 13 Oct 2014 10:54:51 +0200
Subject: [PATCH] template for config.sample.php documentation

---
 .../configuration_config_sample_php.rst       | 65 +++++++++++++++++++
 admin_manual/configuration/index.rst          |  1 +
 admin_manual/index.rst                        |  1 +
 3 files changed, 67 insertions(+)
 create mode 100644 admin_manual/configuration/configuration_config_sample_php.rst

diff --git a/admin_manual/configuration/configuration_config_sample_php.rst b/admin_manual/configuration/configuration_config_sample_php.rst
new file mode 100644
index 000000000..88f6a577c
--- /dev/null
+++ b/admin_manual/configuration/configuration_config_sample_php.rst
@@ -0,0 +1,65 @@
+Config.php Parameters
+=====================
+ownCloud uses the ``config/config.php`` file to control server operations.
+``config/config.sample.php`` lists all the configurable parameters within
+ownCloud. This document provides a more detailed reference. Many options are
+configurable on your Admin page, so it is usually not necessary to edit
+``config/config.php``.
+
+.. Generated content below. Don't change this.
+.. DEFAULT_SECTION_START
+
+.. DEFAULT_SECTION_END
+.. Generated content above. Don't change this.
+
+Default config.php Examples
+---------------------------
+When you use SQLite as your ownCloud database, your ``config.php`` looks like
+this after installation. The SQLite database is stored in your ownCloud
+``data/`` directory. SQLite is a simple, lightweight embedded database that
+is good for testing and for simple installations, but for production ownCloud
+systems you should use MySQL, MariaDB, or PosgreSQL.
+
+::
+
+  <?php
+  $CONFIG = array (
+    'instanceid' => 'occ6f7365735',
+    'passwordsalt' => '2c5778476346786306303',
+    'trusted_domains' =>
+    array (
+      0 => 'localhost',
+      1 => 'studio',
+    ),
+    'datadirectory' => '/var/www/owncloud/data',
+    'dbtype' => 'sqlite3',
+    'version' => '7.0.2.1',
+    'installed' => true,
+  );
+
+This example is from a new ownCloud installation using MariaDB::
+
+
+  <?php
+  $CONFIG = array (
+    'instanceid' => 'oc8c0fd71e03',
+    'passwordsalt' => '515a13302a6b3950a9d0fdb970191a',
+    'trusted_domains' =>
+    array (
+      0 => 'localhost',
+      1 => 'studio',
+      2 => '192.168.10.155'
+    ),
+    'datadirectory' => '/var/www/owncloud/data',
+    'dbtype' => 'mysql',
+     'version' => '7.0.2.1',
+    'dbname' => 'owncloud',
+    'dbhost' => 'localhost',
+    'dbtableprefix' => 'oc_',
+    'dbuser' => 'oc_carla',
+    'dbpassword' => '67336bcdf7630dd80b2b81a413d07',
+    'installed' => true,
+  );
+
+.. Generated content below. Don't change this.
+.. ALL_OTHER_SECTIONS_START
diff --git a/admin_manual/configuration/index.rst b/admin_manual/configuration/index.rst
index cf747b54f..1a5658585 100644
--- a/admin_manual/configuration/index.rst
+++ b/admin_manual/configuration/index.rst
@@ -31,3 +31,4 @@ Configuration
    custom_user_backend
    xsendfile
    configuring_search
+   configuration_config_sample_php
diff --git a/admin_manual/index.rst b/admin_manual/index.rst
index addec0a64..8efc72a85 100644
--- a/admin_manual/index.rst
+++ b/admin_manual/index.rst
@@ -76,6 +76,7 @@ contains the following topics:
 * :doc:`configuration/configuration-antivirus`
 * :doc:`configuration/configuration_preview`
 * :doc:`configuration/configuring_search`
+* :doc:`configuration/configuration_config_sample_php`
 
 Maintenance
 ===========