Problem with configure and installing documentation files

[Achim Bohnet]

On Tuesday 02 May 2006 17:34, Krzysztof Lichota wrote:
> I am compiling documentation for KDE from sources and ./configure is
> setting installation path for documentation to:
> /usr/share/doc/HTML/{LANG}
> while KDE documentation, which is used, is in:
> /usr/share/doc/kde/HTML/{LANG}
> 
> For me it looks like Kubuntu is using non-standard path for docs, but
> maybe it is ./configure fault? Why it was chosen to use such path and
> how to fix it, so that docs were installed properly?

From debian policy:

11.5. Web servers and applications 
----------------------------------

...
     2.   Access to HTML documents

          HTML documents for a package are stored in
          `/usr/share/doc/<package>' and can be referred to as
               http://localhost/doc/<package>/<filename>

          The web server should restrict access to the document tree so
          that only clients on the same host can read the documents.  If
          the web server does not support such access controls, then it
          should not provide access at all, or ask about providing access
          during installation.

...

Default configure path is different, so every 'proper' debian pkg supplies
configure with a different docdir setting.

AFAIR /usr/share/doc/HTML tree is 'reserved' by doc-base tools.

Achim
P.S.  e.g. sysconfdir is another place where configure's defaults are wrong
for debian.

> 
> Regards
> 
> 	Krzysztof Lichota
> 
> 
> 

-- 
  To me vi is Zen.  To use vi is to practice zen. Every command is
  a koan. Profound to the user, unintelligible to the uninitiated.
  You discover truth everytime you use it.
                                      -- reddy at lion.austin.ibm.com