On 11.01.2011 07:27, Aron Xu writes:
Hi,
>>
>> Chinese at all. Also in my opinion the Abstract (`describes what fcitx
>> is and how it can be used.') and Section ('Help/Books') fields should be
>> also changed to something more appropriate.
>>
The above text meant to be a simple statement about the fact the
contents of doc-base file doesn't match to the contents of registered
documentation. I hope you didn't find it offensive or sth like this.
>
> 1. Users and developers who are interested in fcitx are required to
> have an X11 environment (fcitx is a X input toy). If so, I think
> nearly all of them will find the documentations themselves and open
> them with a browser (or text editor) to view them (see 2 for reason).
Oh, you can say exactly the same about any kind of documentation
provided in Debian :) In that case doc-base wouldn't be needed at all.
>
> 2. Registering to doc-base won't benefit users of Yelp or something in
> same category.
Yes, I was checking yesterday why doc-base docs are not visible in yelp,
but failed to find the reason. I found out that I had already reported
bug #546208 against rarian-compat about this issue.
>
> 3. Documentations about how to use doc-base is not so good, or we
> won't be dealing with this problem now.
I agree the doc-base documentation should be improved to make it obvious
how to correctly register documentation. I'll try to fix that, (maybe
adding some paragraph about common mistakes in doc-base files would do?)
but unfortunately I'm not good in writing docs.
>
> 4. The reason why I register them is to make lintian calm.
>
AFAIK lintian calms only about PDF or HTML documentation files not being
registered in doc-base. To find out why linitan would complain in your
case, I've just checked some previous versions of fcitx. It seems the
package used to contain some PDF documentation in Chinese. I don't speak
the language, but the document looks for me as some kind of user manual,
so the description contained in the Abstract field was perfectly valid
for that documentation. But since the PDF has gone, the doc-base file
should probably be gone as well.
Regards,
robert
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
