Prepare debops__tpl_macros.j2 upstreaming

Author: ypid

templates/etc/apache2/sites-available/debops__tpl_macros.j2

@@ -1,10 +1,12 @@
 {# vim: foldmarker=[[[,]]]:foldmethod=marker
-# Copyright [[[
 # Commonly used set of macros in DebOps.
 # It can be included in repositories as needed.
-# Changes to this file should go upstream: FIXME
+# Changes to this file should go upstream: https://github.com/debops/debops-playbooks/blob/master/templates/debops__tpl_macros.j2
+#
+# Copyright [[[
+# =============
 #
-# Copyright (C) 2014-2016 Maciej Delmanowski <[email protected]>
+# Copyright (C) 2014-2017 Maciej Delmanowski <[email protected]>
 # Copyright (C) 2015-2017 Robin Schneider <[email protected]>
 # Copyright (C) 2014-2017 DebOps https://debops.org/
 #
@@ -21,6 +23,27 @@
 #
 # You should have received a copy of the GNU General Public License
 # along with DebOps. If not, see https://www.gnu.org/licenses/.
+#
+# ]]]
+#
+# Usage [[[
+# =========
+#
+# Copy the template file into your ./templates/ path of a role where it fits
+# best. You can/might need to use symlinks to make the macros available from
+# different paths in your ./templates/ hierarchy.
+#
+# Make sure to retain the filename of this file so that automatic updates of
+# this file can be implemented.
+#
+# To use the macros in your own template, this file needs to be included like so:
+#
+# {% import 'debops__tpl_macros.j2' as debops__tpl_macros with context %}
+#
+# Then you can start using the macros like this:
+#
+# {{ debops__tpl_macros.indent(some_content, 4) }}
+#
 # ]]] #}
 
 {% macro get_yaml_list_for_elem(list_or_elem) %}{# [[[ #}