Add initial manapage

3 files changed, 133 insertions, 0 deletions

diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
new file mode 100644
index 0000000..e5aa8cc
--- /dev/null
+++ b/doc/CMakeLists.txt
@@ -0,0 +1,9 @@
+find_package(Sphinx REQUIRED)
+
+add_custom_target(man ALL
+	${SPHINX_EXECUTABLE}
+	-q -b man
+	"${CMAKE_CURRENT_SOURCE_DIR}"
+	"${CMAKE_CURRENT_SOURCE_DIR}"
+	COMMENT "Building man page with Sphinx"
+)
diff --git a/doc/conf.py b/doc/conf.py
new file mode 100644
index 0000000..9d2a16b
--- /dev/null
+++ b/doc/conf.py
@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+import sys
+import os
+
+project = 'yawa'
+master_doc = 'yawa'
+source_suffix = '.rst'
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    ('yawa', 'yawa', 'Yet Another Wallpaper Application',
+     ['Johannes Löthberg'], 1)
+]
diff --git a/doc/yawa.rst b/doc/yawa.rst
new file mode 100644
index 0000000..353d731
--- /dev/null
+++ b/doc/yawa.rst
@@ -0,0 +1,109 @@
+yawa
+====
+
+Synopsis
+--------
+
+**yawa** [*options*]
+
+Description
+-----------
+
+:program:`yawa` is Yet Another Wallpaper Application, and a cleaned up fork of hsetroot
+
+Options
+-------
+
+Gradients:
+~~~~~~~~~~
+
+-a COLOR, --add COLOR
+        Add the specified hex color to range
+
+-d DISTANCE, --distance DISTANCE
+        Distance to use for adding color to range (Specify multiple times for
+        successive distances). Defaults to 1 for each color.
+
+-c, --clear
+        Clear the color range
+
+-g ANGLE, --gradient ANGLE
+        Render gradient using the specified angle
+
+Solid:
+~~~~~~
+
+-s COLOR, --solid COLOR
+        Render a solid background using the specified color
+
+Image files:
+~~~~~~~~~~~~
+
+-C IMAGE, --center IMAGE
+        Render the specified image centered on the screen
+
+-f IMAGE, --full IMAGE
+        Render the specified image using the maximum aspect ratio
+
+-F IMAGE, --fill IMAGE
+        Render the specified image stretched out
+
+-t IMAGE, --tile IMAGE
+        Render the specified image tiled
+
+Manipulations:
+~~~~~~~~~~~~~~
+
+-b RADIUS, --blur RADIUS
+        Blur the current image using the specified radius
+
+-B AMOUNT, --brightness AMOUNT
+        Adjust the brightness of the current image with the specified amount of
+        brightness
+
+-G AMOUNT, --gamma AMOUNT
+        Adjust the gamma level of the current image with the specifed amount
+
+-o AMOUNT, --contrast AMOUNT
+        Adjust the constrast of the current image with the specified amount
+
+-S RADIUS, --sharpen RADIUS
+        Sharpen the current image
+
+-T COLOR, --tint COLOR
+        Tint the current image using the specified hex color
+
+--fliph
+        Flip the current image horizontally
+
+--flipv
+        Flip the current image vertically
+
+--flipd
+        Flip the current image diagonally
+
+Misc:
+~~~~~
+
+-A AMOUNT, --alpha AMOUNT
+        Adjust the alpha level for colors and images
+
+-w FILENAME, --write FILENAME
+        Write the current image to the specified file. The filename specifies
+        the out-format
+
+-h, --help
+        Show this help message and exit
+
+--usage
+        Print a short usage message
+
+-?, --version
+        Print program version
+
+Examples
+--------
+
+Set the background to a nice blue to yellow horizontal gradient
+
+        :program:`yawa --add "#ffb301" --add "#00ffff" --gradient 100`