1 files changed, 52 insertions, 0 deletions
diff --git a/manifests/init.pp b/manifests/init.pp
index 5856cf9..6599301 100644
--- a/manifests/init.pp
+++ b/manifests/init.pp
@@ -1,3 +1,55 @@
+# @summary Manages a cgit server
+#
+# Many of these options maps directly to cgit's options (replace
+# underscore with dash).
+#
+# Also see cgitrc(5).
+#
+# @param root_title
+#   Top title of webpage
+# @param root_desc
+#   Description under title on web page
+# @param scan_path
+#   Directory to scan for git repos
+# @param clone_url
+#   List of
+# @param root
+#   Webroot, media files and similar will be placed here
+# @param filterpath
+#   Where filter files shouldbe placed
+# @param root_readme_source
+#   Source attribute passed along to puppet's file for the global
+#   summary page. Mutually exclusive with root_readme_content.
+# @param root_readme_content
+#   Content attribute passed along to puppet's file for the global
+#   summary page. Mutually exclusive with root_readme_source.
+# @param root_readme_sha256
+#   SHA256 sum of root_readme_{source,content}
+# @param root_readme_extension
+#   Optional extension of file. Useful if ones "about" filter checks
+#   filename to determine rendering.
+# @param enable_http_clone
+#   Enable cgit's built in dump HTTP clone entdpoint.
+# @param public_repos
+#   A list of repos under scan_path which should be public. Used if
+#   manage_server is set to nginx, and is also dumped to the file
+#   /usr/local/var/public-repos, for use by custom filters.
+# @param users
+#   Used for basic auth by nginx, if manage_server is true.
+# @param manage_server
+#   Should a webserver be managed by us. Currently only nginx is
+#   supported.
+# @param server_name
+#   Passed to nginx::resource::server's server_name.
+# @param certname
+#   Target TLS certificate used by nginx.
+# @param htpasswd
+#   Path to htpasswd file used by nginx's basic auth.
+# @param cgitrc
+#   Path to system cgitrc file.
+# @param filters
+#   CGIT filters to be managed.
+#   @see cgit::filter
 class cgit (
     String $root_title,
     String $root_desc,