template.rst 1.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. Template API
  2. =============
  3. Overview
  4. --------
  5. INSTRUCTIONS: Provide overview where and how this API may be used. For large number of functions, break down description into groups.
  6. Use the folowing heading levels:
  7. * # with overline, for parts
  8. * \* with overline, for chapters
  9. * =, for sections
  10. * -, for subsections
  11. * ^, for subsubsections
  12. * ", for paragraphs
  13. Application Example
  14. -------------------
  15. INSTRUCTIONS: Provide one or more pratical examples to demonstrate functionality of this API.
  16. Reference
  17. ---------
  18. INSTRUCTIONS: Provide list of API memebers divided into sections. Use coresponding **.. doxygen** directices, so member documentation is auto updated.
  19. * Data Structures **.. doxygenstruct**
  20. * Macros **.. doxygendefine**
  21. * Type Definitions **.. doxygentypedef**
  22. * Enumerations **.. doxygenenum**
  23. * Functions **.. doxygenfunction**
  24. * Variables **.. doxygenvariable**
  25. Include code snippotes to ilustrate functionality of particular functions where applicable. Skip section hearder if empty.
  26. Data Structures
  27. ^^^^^^^^^^^^^^^
  28. .. Data Structures .. doxygenstruct
  29. Macros
  30. ^^^^^^
  31. .. Macros .. doxygendefine
  32. Type Definitions
  33. ^^^^^^^^^^^^^^^^
  34. .. Type Definitions .. doxygentypedef
  35. Enumerations
  36. ^^^^^^^^^^^^
  37. .. Enumerations .. doxygenenum
  38. Functions
  39. ^^^^^^^^^
  40. .. Functions .. doxygenfunction
  41. Variables
  42. ^^^^^^^^^
  43. .. Variables .. doxygenvariable