# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1383495571 -3600
# Node ID 5dca9e4e91f1b2002afdfcd5ebc6d9b72b807431
# Parent  5e8fd72988c88f34946f9104063dc0d064c2e821
Added a reference to the existing RenderAsPDF action along with a description of
some differences between it and this action.
Added an improvements section.

diff -r 5e8fd72988c8 -r 5dca9e4e91f1 README.txt
--- a/README.txt	Sun Nov 03 14:40:04 2013 +0100
+++ b/README.txt	Sun Nov 03 17:19:31 2013 +0100
@@ -5,6 +5,13 @@
 documents using XSLT, DocBook and XSL-FO external tools, or using either of
 the htmldoc or wkhtmltopdf tools.
 
+The use of XSL-FO and DocBook was indicated as a viable route to PDF output by
+the existing RenderAsPDF action, but this action has been written
+independently and has slightly different design criteria. For example, there
+is no usage of JavaScript in the browser to indicate progress or to initiate
+different processing steps. Furthermore, this action avoids creating files
+explicitly and instead employs pipes where a multi-stage conversion occurs.
+
 Installation
 ------------
 
@@ -78,6 +85,14 @@
 
 In summary, the "docbook" mode is by far the recommended solution.
 
+Improvement Suggestions
+-----------------------
+
+Some improvements could be made to this action:
+
+  * Images need to be included in the output
+  * More control over output options would be useful
+
 Recommended Software
 --------------------