From afa467e975617c9c343b2a993b794c5c47ff98d9 Mon Sep 17 00:00:00 2001
From: Jan-Piet Mens <jpmens@gmail.com>
Date: Wed, 24 Oct 2012 19:42:52 +0200
Subject: [PATCH] DOCUMENTATION: LaTeX template is back    ongoing work for the
 Booklet

---
 hacking/module_formatter.py |  4 +-
 hacking/templates/latex.j2  | 76 +++++++++++++++++++++++++++++++++++++
 2 files changed, 78 insertions(+), 2 deletions(-)
 create mode 100644 hacking/templates/latex.j2

diff --git a/hacking/module_formatter.py b/hacking/module_formatter.py
index 8653d994a88..7e8894830c3 100755
--- a/hacking/module_formatter.py
+++ b/hacking/module_formatter.py
@@ -259,8 +259,8 @@ def main():
         env.filters['jpfunc'] = latex_ify
         template = env.get_template('latex.j2')
         outputname = "%s.tex"
-        includecmt = "% generated code\n"
-        includefmt = "\\input %s\n"
+        includecmt = ""
+        includefmt = "%s\n"
     if options.type == 'html':
         env.filters['jpfunc'] = html_ify
         template = env.get_template('html.j2')
diff --git a/hacking/templates/latex.j2 b/hacking/templates/latex.j2
new file mode 100644
index 00000000000..d02ffa8677f
--- /dev/null
+++ b/hacking/templates/latex.j2
@@ -0,0 +1,76 @@
+{# -------------------------------------------------------------------
+   template for module_formatter.py for LaTeX output (Ansible Booklet)
+   by Jan-Piet Mens.
+   Note: nodes & code examples are omitted on purpose.
+ -------------------------------------------------------------------- #}
+%--- @{ module | upper }@  ----  from @{ filename }@ ---
+
+%: -- module header
+\mods{@{module}@}{@{docuri}@}{
+		{% for desc in description -%}
+		@{ desc | jpfunc }@
+		{% endfor -%}
+		{% if version_added is defined -%}
+		(\I{* new in version @{ version_added }@})
+		{% endif -%}
+		}
+
+%: -- module options
+
+
+
+{% if options %}
+\begin{xlist}{abcdefghijklmno}
+  {% for (opt,v) in options.iteritems()  %}
+  	{% if v['required'] %}
+		\item[\man\,\C{@{ opt }@}]
+	{% else %}
+		\item[\opt\,\C{@{ opt }@}]
+	{% endif %}
+
+		{# -------- option description ----------#}
+		{% for desc in v.description %}
+		@{ desc | jpfunc }@
+		{% endfor %}
+		{% if v['choices'] %}
+		    \B{Choices}:\,
+		    {% for choice in v['choices'] %}\C{@{ choice }@}{% if not loop.last %},{% else %}.{% endif %}
+		    {% endfor %}
+		{% endif %}
+		{% if v['default'] %}
+		(default \C{@{ v['default'] }@})
+		{% endif %}
+		{% if v['version_added'] is defined %}
+		(\I{* version @{ v['version_added'] }@})
+		{% endif %}
+  {% endfor %}
+\end{xlist}
+{% endif %}
+
+{# ---------------------------------------
+{% if notes %}
+
+		{% for note in notes %}
+		\I{@{ note | jpfunc }@}
+		{% endfor %}
+{% endif %}
+ ----------------------------- #}
+
+{#-------------------------------------------
+
+{% if examples is defined -%}
+  {% for e in examples %}
+  	\begin{extymeta}
+@{ e['code'] }@
+  	\end{extymeta}
+  {% endfor %}
+{% endif %}
+----------------------------------- #}
+
+{% if extradata is defined %}
+%--- BEGIN-EXTRADATA
+\begin{extymeta}
+@{ extradata }@
+\end{extymeta}
+%----- END-EXTRADATA
+{% endif %}