git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Mention install-doc in INSTALL

From
Petr Baudis <pasky@suse.cz>
Date
Jan 22, 2006, 00:12 UTC
Message-ID
<20060122001255.GR28365@pasky.or.cz>
In-Reply-To
<E1F0SYe-0005ix-WB@puzzle.fieldses.org>

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...

Show 6 quoted lines
> 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
Previous: J. Bruce FieldsNext: Junio C Hamano
Message 2 of 4 in “Mention install-doc in INSTALL”
  1. Mention install-doc in INSTALLJ. Bruce Fields, Jan 21, 2006
  2. Petr BaudisJan 22, 2006
  3. Junio C HamanoJan 22, 2006
  4. J. Bruce FieldsJan 22, 2006

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.