Topics.txt 3.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. Format: 1.35
  2. # This is the Natural Docs topics file for this project. If you change anything
  3. # here, it will apply to THIS PROJECT ONLY. If you'd like to change something
  4. # for all your projects, edit the Topics.txt in Natural Docs' Config directory
  5. # instead.
  6. # If you'd like to prevent keywords from being recognized by Natural Docs, you
  7. # can do it like this:
  8. # Ignore Keywords: [keyword], [keyword], ...
  9. #
  10. # Or you can use the list syntax like how they are defined:
  11. # Ignore Keywords:
  12. # [keyword]
  13. # [keyword], [plural keyword]
  14. # ...
  15. #-------------------------------------------------------------------------------
  16. # SYNTAX:
  17. #
  18. # Topic Type: [name]
  19. # Alter Topic Type: [name]
  20. # Creates a new topic type or alters one from the main file. Each type gets
  21. # its own index and behavior settings. Its name can have letters, numbers,
  22. # spaces, and these charaters: - / . '
  23. #
  24. # Plural: [name]
  25. # Sets the plural name of the topic type, if different.
  26. #
  27. # Keywords:
  28. # [keyword]
  29. # [keyword], [plural keyword]
  30. # ...
  31. # Defines or adds to the list of keywords for the topic type. They may only
  32. # contain letters, numbers, and spaces and are not case sensitive. Plural
  33. # keywords are used for list topics. You can redefine keywords found in the
  34. # main topics file.
  35. #
  36. # Index: [yes|no]
  37. # Whether the topics get their own index. Defaults to yes. Everything is
  38. # included in the general index regardless of this setting.
  39. #
  40. # Scope: [normal|start|end|always global]
  41. # How the topics affects scope. Defaults to normal.
  42. # normal - Topics stay within the current scope.
  43. # start - Topics start a new scope for all the topics beneath it,
  44. # like class topics.
  45. # end - Topics reset the scope back to global for all the topics
  46. # beneath it.
  47. # always global - Topics are defined as global, but do not change the scope
  48. # for any other topics.
  49. #
  50. # Class Hierarchy: [yes|no]
  51. # Whether the topics are part of the class hierarchy. Defaults to no.
  52. #
  53. # Variable Type: [yes|no]
  54. # Whether the topics can be a variable type. Defaults to no.
  55. #
  56. # Page Title If First: [yes|no]
  57. # Whether the topic's title becomes the page title if it's the first one in
  58. # a file. Defaults to no.
  59. #
  60. # Break Lists: [yes|no]
  61. # Whether list topics should be broken into individual topics in the output.
  62. # Defaults to no.
  63. #
  64. # Can Group With: [type], [type], ...
  65. # Defines a list of topic types that this one can possibly be grouped with.
  66. # Defaults to none.
  67. #-------------------------------------------------------------------------------
  68. # The following topics are defined in the main file, if you'd like to alter
  69. # their behavior or add keywords:
  70. #
  71. # Generic, Class, Interface, Section, File, Group, Function, Variable,
  72. # Property, Type, Constant, Enumeration, Event, Delegate, Macro,
  73. # Database, Database Table, Database View, Database Index, Database
  74. # Cursor, Database Trigger, Cookie, Build Target
  75. # If you add something that you think would be useful to other developers
  76. # and should be included in Natural Docs by default, please e-mail it to
  77. # topics [at] naturaldocs [dot] org.