From eb220a99d8070dfe36b82319f9ef8415570a7fb0 Mon Sep 17 00:00:00 2001
From: Ondrej Vasik <ovasik@redhat.com>
Date: Jul 07 2011 12:58:35 +0000
Subject: Update README file


git-svn-id: https://svn.fedorahosted.org/svn/xmlto@59 eb1b79c1-ba03-4820-82f3-b60cf523859b

---

diff --git a/README b/README
index eac6fe0..1007292 100644
--- a/README
+++ b/README
@@ -1,3 +1,44 @@
-This is xmlto.
+=== xmlto ===
 
-See doc/xmlto.xml for more detail about what it is.
+Utility xmlto is a simple shell script for converting XML files to various
+formats. It serves as easy to use command line frontend to make fine output
+without remembering many long options and searching for the syntax of the
+backends.
+
+At the moment it supports conersion from docbook, xhtml1 and fo format to
+various output formats(awt, fo, htmlhelp, javahelp, mif, pdf, svg, xhtml,
+dvi, html, html-nochunks, man , pcl, ps, txt, xhtml-nochunks) 
+
+Some output formats may be unavailable if you use don't have all prerequisities
+installed, as xmlto uses backends (xsltproc, passivetex/fop/dblatex) 
+for processing.
+
+You could check the documentation online at 
+  https://fedorahosted.org/xmlto/wiki/xmlto
+
+(or generate the offline version with xmlto from doc/xmlto.xml sources).
+
+If you received xmlto as a part of distribution, you should already have
+xmlto(1) manpage on your machine.
+
+=== xmlif ===
+
+xmlif utility filters XML according to conditionalizing markup. This can be
+useful for formatting one of several versions of a XML document depending
+on conditions passed to the command.
+
+You could check the documentation online at 
+  https://fedorahosted.org/xmlto/wiki/xmlif
+
+(or generate the offline version with xmlto from doc/xmlif.xml sources ).
+
+If you received xmlif as a part of distribution, you should already have
+xmlif(1) manpage on your machine.
+
+=== How to contact authors ===
+
+Since xmlto 0.19, xmlto is maintained by Ondřej Vašík <ovasik@redhat.com>.
+
+You can contact me directly via email or leave a ticket on project's trac
+instance at https://fedorahosted.org/xmlto/newticket .
+Registered fedoraproject.org account is required for this.