kdeaddons documentation

[Éric Bischoff]

On Saturday 20 April 2002 22:17, Charles Samuels wrote:
> In the kdeaddons module, the documentation is arranged like so:
>
> doc/kate-plugins/openheader.docbook
> doc/kate-plugins/projectmanager.docbook
> doc/kate-plugins/textfilter.docbook
> doc/kate-plugins/xmltools.docbook
>
> I propose that we change it to:
>
> doc/kate-plugins/openheader/index.docbook
> doc/kate-plugins/projectmanager/index.docbook
> doc/kate-plugins/textfilter/index.docbook
> doc/kate-plugins/xmltools/index.docbook
>
> First of all, it's consistent with every other module,

Uh ? Not really. Have a look for example in kdegames/ at
doc/ktuberling/technical-reference.docbook
(it's just an example. There are *many* other examples available)

> and secondly, and
> most importantly, it allows installing only one of the docbook files, the
> one that you actually want.

Well, the installation scripts currently install all the docs in a same 
module.

And thirdly, don't do such a thing without doing the same with every existing 
translation in kde-i18n/ module !