[nautilus-actions/file-manager-actions] docs/README: add some comments

[Pierre Wieser <pwieser src gnome org>]

commit f2e4098d105ed2ae2d69350fdbc31b3dfe70f8ae
Author: Pierre Wieser <pwieser trychlos org>
Date:   Wed Sep 9 19:07:52 2015 +0200

    docs/README: add some comments

 docs/README |   18 ++++++++++++++----
 1 files changed, 14 insertions(+), 4 deletions(-)
---
diff --git a/docs/README b/docs/README
index c116d60..b6767b3 100644
--- a/docs/README
+++ b/docs/README
@@ -1,9 +1,19 @@
 docs
 ----
-As of Nautilus-Actions 3.0, the documentation is composed of two main
-parts:
+As of FileManager-Actions 3.4, the documentation is composed of two
+main parts:
 - the Reference Manual describes all features of the product, rather
   targeting developers and packagers;
-- the Nautilus-Actions Configuration Tool User's Manual.
+- the FileManager-Actions Configuration Tool User's Manual.
 
-P. Wieser, Dec. 2010
+All the documentation, whether it targets users or developers, is made
+of architecture-independent files. More it needs some rather special
+tools to be built (db2html, dblatex, Docbook stylesheets, and so on).
+So we want distribute it.
+
+There are so in the Makefiles some hacks so that:
+a) the built objects are distributed
+b) the distributed objects are installed without requiring to be
+   rebuilt.
+
+P. Wieser, last updated on sept. 2015