The KDE team strives to provide documentation for the KDE programming interfaces and libraries that is always up-to-date and correct. Taking ideas from literate programming and Java, we decided from day one to keep the documentation as close to the source as possible.
All the KDE API documentation is contained within the library source itself. Documentation is written using specially-marked comments. This ensures that the latest library is always shipped with the latest documentation, and makes it easy for programmers to update and write documentation as the interface grows and changes.
We have developed KDOC, a tool to generate easily readable and heavily cross-referenced documentation in a variety of hypertext and printable formats. For an example of it's output, browse the KDE 2.2 API Reference.
We also recommend that application developers use KDOC while developing their applications, since it acts as a good reference for the developers themselves, or for anyone who wishes to modify or extend the application. Any non-trivial application benefits from an easily browseable and comprehensive API reference.
For detailed information on how to use KDOC, see the KDOC home page.
Sirtaj Singh Kang [email protected]