/** \file HowToDocument.dox * \brief How to document KDevelop parts */ /** \page howToDocument How to document KDevelop parts You should add a README and a README.dox file to your part (KDevPlugin). On the README file put this text: \verbatim Please read the on-line, automaticaly updated KDevelop API documentation at: http://www.kdevelop.org or read the README.dox file. \endverbatim On the README.dox file put the mandatory information: \verbatim /** \class yourPartClassName Put a brief description here, the brief description ends at the first dot. Put a more detailed description of your part in these lines. It can span over several lines. You can even use some html commands in these lines like: This is code, html links link text, and images. ... /* \endverbatim IMPORTANT: You should replace yourPartClassName with the name of the class that implements your part. On the area marked with ... you can add optional informations. Here is an example of that: \verbinclude languages/cpp/app_templates/kdevpart/README.dox All these infos are optional and you should only add the link to the bugzilla database if YOUR_COMPONENT_NAME has been defined in that database. */