[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Bug-gnulib] html/doc target in coding standards
From: |
Bruno Haible |
Subject: |
Re: [Bug-gnulib] html/doc target in coding standards |
Date: |
Tue, 12 Oct 2004 13:57:09 +0200 |
User-agent: |
KMail/1.5 |
Alexandre Duret-Lutz wrote:
> >> +If your package has multiple manuals, or you wish to install HTML
> >> +documentation with many files (such as the ``split'' mode output by
> >> address@hidden --html}, we recommend that you avoid collisions and
> >> +clutter by arranging for these targets to install in subdirectories of
> >> +the appropriate installation directory, such as @code{htmldir}.
>
> Bruno> What does this paragraph mean? As I understand, htmldir
> Bruno> defaults to $(docdir), and @docdir@ depends on
> Bruno> @address@hidden So there is no "clutter" problem in this
> Bruno> case.
>
> The paragraph is about packages with multiple manuals. For
> instance consider the mess it would be if emacs were to install
> split HTML for all its manuals in $(htmldir) directly, with all
> the nodes `emacs.texi', `elisp.texi', `gnus.texi', etc. mixed in
> the same directory. The point is just to state that creating
> subdirectories is OK.
Ah, I see. Thanks. Then the text should say
If your package has multiple manuals, _AND_ you wish to install HTML
documentation with many files ...
with "and", not "or", right? Because when the package has multiple manuals,
each being in a single file, there is no clutter. And when the package has
a single manual, and it is installed "split", there is no problem either.
Bruno