  , , ,   ,   . 
,       ,   ,
   ,    .    -
      .

      ,   gcc 
     C++.       -
   (   , ).

/*

* get ship speed() -    

*  

*     .

*     ,

*     .

*/

    ,     -
   ,    ,   
.       "XXX: ",  
    "FIXME: ",    .

/*

* FIXME: ,  dog == cat.

*       

*/

      .  
 GNOME-doc,      Kernel-doc.  
   HTML    .

make htmldocs

     postscript    -
.

make psdocs

        -
.

/**

* find_treasure -  ,    

* @map -  

* @time -  ,    

*

*      pirate ship lock.

*/

void find treasure(int dog, int cat)

{

/*..*/                        .   ,
}

    .  Documentation/kernel-doc-nano-

HOWTO.txt.

,    409