Re: [PATCH] Mention install-doc in INSTALL

[Petr Baudis <pasky@suse.cz>]

Dear diary, on Sun, Jan 22, 2006 at 12:54:12AM CET, I got a letter
where "J. Bruce Fields" <bfields@fieldses.org> said that...
> I think most people will want to install the man pages as well.
> 
> (I'm less sure about the case of the home directory, as I assume there's
> unlikely to be a reasonable place to install man pages to in that case.)
> 
> Signed-off-by: J. Bruce Fields <bfields@citi.umich.edu>

But you really do not want to build the documentation as root.
Cogito's "solution" is:

diff --git a/INSTALL b/INSTALL
index 916ddd4..464bfbb 100644
--- a/INSTALL
+++ b/INSTALL
@@ -90,3 +90,10 @@ Issues of note:
    You can place local settings in config.mak and the Makefile
    will include them.  Note that config.mak is not distributed;
    the name is reserved for local settings.
+
+ - By default, separate documentation (manpages, text, HTML) is not built
+   since it requires asciidoc and xmlto, and those tools are not so common.
+   You can build it by "make doc" and install it later by "make install-doc"
+   in the project root, or you can build directly in the "Documentation/"
+   subdirectory, where you can also choose to build only documentation in
+   particular format. See Documentation/Makefile for further details.

-- 
				Petr "Pasky" Baudis
Stuff: http://pasky.or.cz/
Of the 3 great composers Mozart tells us what it's like to be human,
Beethoven tells us what it's like to be Beethoven and Bach tells us
what it's like to be the universe.  -- Douglas Adams