Re: [Bug 465460] anyone has take a look?

[Hans Breuer <hans breuer org>]

Am 01.06.2008 15:02, Thomas Harding schrieb:
> Hello,
> I updated Bug 465460 a few days ago, but as it is an old one, I don't
> know if new maintainers are mailed about.
I get mails about every dia bug change. But that does not mean I can make 
immediately sense of all of them ;) This particular bug report appeared to 
me as some improvement and some regression. But I don't really feel 
qualified to review it. So input from someone who understands more of 
DocBook than I do would really be appreciated.

> Last patch filled addresses several problems about documentation:
>   
>   * scrollkeeper really works, so xml docs are now accessibles directly
>     via yelp.
Could you comment on your replacements of <para/> to <simpara/>. Does it 
have to do with producing less pages only containing the headline and a link?

>   * hardcopies are done for all languages (there are still problems
>     with pl, at least on Debian, on ps and pdf outputs, as lll TeX
>     macro is defined twice somewhere in the tools used).
Is this a regression?

>   * All documentation processes are done automatically, hardcopies
>     are compiled while --with-hardbooks option is given to ./configure
will check if it work out of the box for me when I have access to my Linux 
box again.

> However, I detected a new problem:
>   
>   * when compiled without gnome support, Dia is not able to open
>     and list documentation directory. I filled a short strace 
>     output about that.
THe exact error message given would be interesting. Looking at the code it 
either includes the path or it dose not. The latter would be an issue with 
the content of the directory (i.e. missing index.html. The former should 
include more detailed information _why_ opening the directory failed.

BTW: it would be better to have this information in a different bug-report 
*if* the files are installed in the correct place.


> Again, I would emphasize that documentation is a matter of quality on
> programs.
Yeah, but what helps the best documentation if it does not get read ;)


Regards,
        Hans

-------- Hans "at" Breuer "dot" Org -----------
Tell me what you need, and I'll tell you how to
get along without it.                -- Dilbert