From a82a880858457cf57b74b64255d72b16e694a620 Mon Sep 17 00:00:00 2001
From: Matthias Stecher <matthiasstecher@gmx.de>
Date: Sat, 31 Oct 2020 12:26:36 +0100
Subject: [PATCH] __nextcloud_user: finished manpage

---
 type/__nextcloud_user/gencode-remote |  4 ++
 type/__nextcloud_user/man.rst        | 59 +++++++++++++++++++++++++++-
 2 files changed, 61 insertions(+), 2 deletions(-)

diff --git a/type/__nextcloud_user/gencode-remote b/type/__nextcloud_user/gencode-remote
index bd986f5..c76f74e 100644
--- a/type/__nextcloud_user/gencode-remote
+++ b/type/__nextcloud_user/gencode-remote
@@ -242,4 +242,8 @@ SHELL
             done < "$__object/files/group.add"
         fi
     fi
+
+
+    # These parameters are only set if they exist
+    # ...
 fi
diff --git a/type/__nextcloud_user/man.rst b/type/__nextcloud_user/man.rst
index 43aefc8..39ff38a 100644
--- a/type/__nextcloud_user/man.rst
+++ b/type/__nextcloud_user/man.rst
@@ -66,6 +66,17 @@ password
 
 quota
     The quota the Nextcloud user have to store it data. Defaults to `default`.
+    Following values are accepted by Nextcloud:
+
+    default
+        Uses the quota set as default in Nextcloud.
+
+    none
+        No quota limit set; unlimited.
+
+    $size
+        The quota that should be used. Same values as set over the user
+        interface. First the number, then a space and then the unit like `GB`.
 
 group
     Multiple group names which the Nextcloud user belongs to. If not set, the
@@ -128,13 +139,57 @@ removed
 
 EXAMPLES
 --------
-TBA.
+
+.. code-block:: sh
+
+   # nextcloud base installation
+   __nextcloud cloud
+
+   # setups an user, but do not touch it after it was created
+   require="__nextcloud/cloud" __nextcloud_user foo \
+        --cloud /var/www/html/cloud/ \
+        --displayname "Big Fooo" \
+        --email "foo@bar.tld" \
+        --password "do-not-use-this-password" \
+        --group "team_a" --group "xxxx" \
+        --quota "2 GB"
+        --only-setup
+
+    # manages an admin user fully controlled by cdist
+    require="__nextcloud/cloud" __nextcloud_user bar \
+        --cloud /var/www/html/cloud/ \
+        --displayname "Bar" \
+        --email "bar@bar.tld" \
+        --password "nope_insecure" \
+        --group "admin"
+
+    # disables an user
+    require="__nextcloud/cloud" __nextcloud_user bb \
+        --state disabled \
+        --cloud /var/www/html/cloud/ \
+        --displayname "byebye" \
+        --password "do_not_copy" \
+        --keep-email --keep-password --keep-quota --keep-groups
+
+    # removes an user
+    require="__nextcloud/cloud" __nextcloud_user foobar \
+        --state absent \
+        --cloud /var/www/html/cloud/
+
+
+NOTES
+-----
+This type may be extended by more user settings. If you think some
+configuration is missing, you are welcome to contribute!
+
+Sometimes, this type uses custom php code to hack into Nextcloud to gather some
+information not possible to get via the `occ` command or even set a value.
 
 
 SEE ALSO
 --------
 :strong:`cdist-type__nextcloud`\ (7)
-:string:`cdist-type__nextcloud_app`\ (7)
+:strong:`cdist-type__nextcloud_app`\ (7)
 
 
 AUTHORS