Re: [Bug-gnulib] html/doc target in coding standards

[Bruno Haible]

Karl Berry wrote:
> address@hidden htmldir
> address@hidden dvidir
> address@hidden pdfdir
> address@hidden psdir
> address@hidden xmldir
> +Directories for installing documentation files in the particular
> +format.

What does "documentation in XML format" mean? Do you mean a particular
instantiation of XML (such as DocBook)? What program do you assume people
use for "viewing" XML documentation?

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

What does this paragraph mean? As I understand, htmldir defaults to
$(docdir), and @docdir@ depends on @address@hidden So there is no "clutter"
problem in this case.

Bruno