[kde-doc-english]hitting the limits of kioslave documentation II

Leo Savernik l.savernik at aon.at
Fri Feb 14 20:34:01 CET 2003


Am Freitag, 14. Februar 2003 17:11 schrieb Frederik Fouvry:
[...]
> Book is too big for many documentation packages (many are just a
> few pages).  I wouldn't make too big an issue of this.  Just
> think that your documentation may grow, or that it may be merged
> with other documentation into a larger (real) book.  Then it's
> nice to have everything on the right level. :-)
>
> (In the beginning we discussed the book-article issue fairly
> extensive, one argument being that much documentation was
> (especially then) too small (iirc me being in favour of article).
> It's my impression that for some packages this changes quite
> drastically, and now I'm sure we're all glad to have the
> documentation with the same top level format.  It means we only
> have to worry about one style sheet etc., etc.)
>
> (The fact that you cannot have a bibliography in a reference page
> bothers me more in all this than the fact that "book" is too
> large a unit.)
[...]
>

I filed an rfe for docbook to allow bibliography under refentries:
https://sourceforge.net/tracker/index.php?func=detail&aid=686733&group_id=21935&atid=384107

Let's see what they'll say about the issue.




More information about the kde-doc-english mailing list