docs: add licenses API

Gauvain Pocentek · Gauvain Pocentek · commit 4540614a3806 · 2016-08-06T22:12:18.000+02:00
diff --git a/docs/api-objects.rst b/docs/api-objects.rst
@@ -13,6 +13,7 @@ API objects manipulation
    gl_objects/groups
    gl_objects/issues
    gl_objects/labels
+   gl_objects/licenses
    gl_objects/namespaces
    gl_objects/projects
    gl_objects/runners
diff --git a/docs/gl_objects/licenses.py b/docs/gl_objects/licenses.py
@@ -0,0 +1,8 @@
+# list
+licenses = gl.licenses.list()
+# end list
+
+# get
+license = gl.licenses.get('apache-2.0', project='foobar', fullname='John Doe')
+print(license.content)
+# end get
diff --git a/docs/gl_objects/licenses.rst b/docs/gl_objects/licenses.rst
@@ -0,0 +1,21 @@
+########
+Licenses
+########
+
+Use :class:`~gitlab.objects.License` objects to manipulate licenses. The
+:attr:`gitlab.Gitlab.licenses` manager object provides helper functions.
+
+Examples
+--------
+
+List known licenses:
+
+.. literalinclude:: licenses.py
+   :start-after: # list
+   :end-before: # end list
+
+Generate a license content for a project:
+
+.. literalinclude:: licenses.py
+   :start-after: # get
+   :end-before: # end get
