document new TOS/PP generation logic

1 files changed, 66 insertions, 0 deletions

diff --git a/manpages/taler-terms-generator.1.rst b/manpages/taler-terms-generator.1.rst
new file mode 100644
index 00000000..d15a2166
--- /dev/null
+++ b/manpages/taler-terms-generator.1.rst
@@ -0,0 +1,66 @@
+taler-terms-generator(1)
+########################
+
+
+.. only:: html
+
+   Name
+   ====
+
+   **taler-terms-generator** - generate legal terms for GNU Taler services
+
+
+Synopsis
+========
+
+**taler-terms-generator**
+[**-a** *AUTHOR*]
+[**-C** *COPYRIGHT*]
+[**-h**]
+[**-i** *INPUT*]
+[**-l** *LANGUAGE*]
+[**-o** *OUTPUT*]
+[**-p** *PAPER*]
+[**-t** *TITLE*]
+
+
+Description
+===========
+
+**taler-terms-generator** is a command-line tool to create terms of service
+ and privacy policy files in various file formats and languages from a
+ reStructuredText (".rst") input. It can be used to generate the responses
+ various GNU Taler services serve under the ``/terms`` and ``/pp`` endpoints.
+
+**-a** *AUTHOR*
+   set the author information to the given AUTHOR in the meta-data of various generated outputs.
+
+**-C** *COPYRIGHT*
+   set the copyright information to the given COPYRIGHT in the meta-data of various generated outputs.
+
+**-h** \| **--help**
+   Prints a compiled-in help text.
+
+**-l** *LANGUAGE*
+   Add the given *LANGUAGE* to the list of translations for the current *INPUT*. *LANGUAGE* must be a two-letter language code (like "de" or "it"). This will generate or update the respective ".po" files to translate the *INPUT* terms to this *LANGUAGE*.
+
+**-o** *OUTPUT*
+   Specifies where to write the output. This should be the directory where the service expects to find the generated resources.  Unless you changed the default configuration, you probably do not have to specify this value.
+
+**-p** *PAPER*
+   Specifies the paper format for generated PDF documents. Can be "a4" or "letter".
+
+**-t** *TITLE*
+   Overrides the document title. By default, the title will be set to the contents of the first line of the *INPUT* ".rst" file.
+
+
+See Also
+========
+
+taler-config(1), taler.conf(5)
+
+Bugs
+====
+
+Report bugs by using https://bugs.taler.net/ or by sending electronic
+mail to <taler@gnu.org>.