[BRLTTY] [Aurelien Jarno] Bug#479754: libbrlapi-dev: /usr/share/man/man3/error.3.gz conflicts with manpages-dev

[Dave Mielke]

[quoted lines by Mario Lang on 2008/05/07 at 16:15 +0200]

>Something is broken with these documentation installation rules.

That may just be a matter of opinion. :-)

>1. Note that vtsp and xbrlapi were installed, but their respective
>   manpages were not.

Because they haven't been written yet.

>2. The man3 directory is completely empty, why?  Should I have
>   run make in the Documents directory manually?  If so, why?  

Yes, because not all users have doxygen, sgmltools, etc. This was a conscious 
decision. Perhaps it's no longer a valid reason, but, at one time, we certainly 
believed it to be valid.

>If doxygen is available, why not build and install the documentation?

We could. No one has asked for that bit of autoconfing before, and we, or at 
least I myself, don't think of everything. The script that makes the tar file 
has just always done that extra step.

>3. Note the "share" toplevel directory, which should have been placed
>   under usr/.  This might be something related to the way how I
>   use INSTALL_ROOT, but it should still work somehow...

Yes, it does work correctly if you specify the paths via configure.

-- 
Dave Mielke           | 2213 Fox Crescent | I believe that the Bible is the
Phone: 1-613-726-0014 | Ottawa, Ontario   | Word of God. Please contact me
EMail: dave at mielke.cc | Canada  K2A 1H7   | if you're concerned about Hell.
http://FamilyRadio.com/                   | http://Mielke.cc/bible/