1 files changed, 31 insertions, 0 deletions

diff --git a/doc/asciidoc/README.txt b/doc/asciidoc/README.txt
new file mode 100644
index 0000000..a09eef6
--- /dev/null
+++ b/doc/asciidoc/README.txt
@@ -0,0 +1,31 @@
+whats this? this is the attempt to write the documentation for 
+fluxbox in ascii-doc format. how does it work?
+
+well, we just edit fluxbox.txt from this directory. save it.
+then we can produce pretty much any format we like:
+
+man:
+
+  $> asciidoc -b docbook -d manpage fluxbox.txt
+  $> xmlto man fluxbox.xml
+
+pdf:
+
+  $> asciidoc -b docbook -d manpage fluxbox.txt
+  $> docbook2pdf fluxbox.xml
+
+docbook:
+
+  $> asciidoc -b docbook-sgml -d manpage fluxbox.txt
+
+html:
+
+  $> asciidoc -b xhtml -d manpage fluxbox.txt
+
+and many many more ways to do it.
+what do we need? well, at least:
+
+  http://www.methods.co.nz/asciidoc/
+  http://cyberelk.net/tim/xmlto/
+
+and the rest of the docbook-family + maybe pdftex.