Skip to content
  • Michael Pyne's avatar
    api: Make some comments NaturalDocs-compatible. · 8c59d952
    Michael Pyne authored
    In the process of trying to plan out the best way to fix the issue where
    module names passed on the command line that are implicit subprojects of
    a kde-projects module go unrecognized, I decided that I needed a better
    way to navigate the API.
    
    There is a Doxygen::Filter::Perl available which seems decent as it
    allows one to use the nice and familiar Doxygen tool, but it seems a bit
    buggy still.
    
    NaturalDocs is a tool which seems better able to cope with kdesrc-build
    and its code, although it prefers comments to be formatted unlike the
    normal qdoc/JavaDoc syntax used by Doxygen. However it's not that much
    different and is easier to install and use otherwise. Maybe when I get
    some time I'll go ahead and properly convert everything.
    8c59d952