3 # This is the main Natural Docs topics file. If you change anything here, it
\r
4 # will apply to EVERY PROJECT you use Natural Docs on. If you'd like to
\r
5 # change something for just one project, edit the Topics.txt in its project
\r
9 #-------------------------------------------------------------------------------
\r
12 # Topic Type: [name]
\r
13 # Creates a new topic type. Each type gets its own index and behavior
\r
14 # settings. Its name can have letters, numbers, spaces, and these
\r
15 # charaters: - / . '
\r
17 # The Enumeration type is special. It's indexed with Types but its members
\r
18 # are indexed with Constants according to the rules in Languages.txt.
\r
21 # Sets the plural name of the topic type, if different.
\r
25 # [keyword], [plural keyword]
\r
27 # Defines a list of keywords for the topic type. They may only contain
\r
28 # letters, numbers, and spaces and are not case sensitive. Plural keywords
\r
29 # are used for list topics.
\r
32 # Whether the topics get their own index. Defaults to yes. Everything is
\r
33 # included in the general index regardless of this setting.
\r
35 # Scope: [normal|start|end|always global]
\r
36 # How the topics affects scope. Defaults to normal.
\r
37 # normal - Topics stay within the current scope.
\r
38 # start - Topics start a new scope for all the topics beneath it,
\r
39 # like class topics.
\r
40 # end - Topics reset the scope back to global for all the topics
\r
42 # always global - Topics are defined as global, but do not change the scope
\r
43 # for any other topics.
\r
45 # Class Hierarchy: [yes|no]
\r
46 # Whether the topics are part of the class hierarchy. Defaults to no.
\r
48 # Page Title If First: [yes|no]
\r
49 # Whether the topic's title becomes the page title if it's the first one in
\r
50 # a file. Defaults to no.
\r
52 # Break Lists: [yes|no]
\r
53 # Whether list topics should be broken into individual topics in the output.
\r
56 # Can Group With: [type], [type], ...
\r
57 # Defines a list of topic types that this one can possibly be grouped with.
\r
59 #-------------------------------------------------------------------------------
\r
61 # The following topics MUST be defined in this file:
\r
63 # Generic, Class, Interface, Section, File, Group, Function, Variable,
\r
64 # Property, Type, Constant, Enumeration, Event, Delegate
\r
66 # If you add something that you think would be useful to other developers
\r
67 # and should be included in Natural Docs by default, please e-mail it to
\r
68 # topics [at] naturaldocs [dot] org.
\r
83 Class Hierarchy: Yes
\r
84 Page Title If First: Yes
\r
85 Can Group With: Interfaces
\r
89 structure, structures
\r
92 namespace, namespaces
\r
95 Topic Type: Interface
\r
99 Class Hierarchy: Yes
\r
100 Page Title If First: Yes
\r
101 Can Group With: Classes
\r
104 interface, interfaces
\r
107 Topic Type: Section
\r
112 Page Title If First: Yes
\r
122 Scope: Always global
\r
123 Page Title If First: Yes
\r
129 document, documents
\r
143 Topic Type: Function
\r
147 Can Group With: Properties
\r
150 function, functions
\r
152 procedure, procedures
\r
155 subroutine, subroutines
\r
158 callback, callbacks
\r
159 constructor, constructors
\r
160 destructor, destructors
\r
161 operator, operators
\r
164 Topic Type: Variable
\r
167 Can Group With: Types, Constants, Macros, Enumerations
\r
170 variable, variables
\r
188 arrayref, arrayrefs
\r
195 bitfield, bitfields
\r
199 reference, references
\r
203 character, characters
\r
204 wcharacter, wcharacters
\r
214 Topic Type: Property
\r
217 Can Group With: Functions
\r
220 property, properties
\r
227 Can Group With: Variables, Constants, Macros, Enumerations
\r
234 Topic Type: Constant
\r
237 Can Group With: Variables, Types, Macros, Enumerations
\r
240 constant, constants
\r
244 Topic Type: Enumeration
\r
246 Plural: Enumerations
\r
248 Can Group With: Variables, Types, Macros, Constants
\r
252 enumeration, enumerations
\r
262 Topic Type: Delegate
\r
266 delegate, delegates
\r
272 Can Group With: Variables, Types, Constants
\r
280 Topic Type: Database
\r
283 Page Title If First: Yes
\r
286 database, databases
\r
290 Topic Type: Database Table
\r
292 Plural: Database Tables
\r
294 Page Title If First: Yes
\r
298 database table, database tables
\r
299 databasetable, databasetables
\r
300 db table, db tables
\r
304 Topic Type: Database View
\r
306 Plural: Database Views
\r
308 Page Title If First: Yes
\r
312 database view, database views
\r
313 databaseview, databaseviews
\r
318 Topic Type: Database Index
\r
320 Plural: Database Indexes
\r
324 database index, database indexes
\r
325 database index, database indices
\r
326 databaseindex, databaseindexes
\r
327 databaseindex, databaseindices
\r
328 db index, db indexes
\r
329 db index, db indices
\r
333 database key, database keys
\r
334 databasekey, databasekeys
\r
337 primary key, primary keys
\r
338 primarykey, primarykeys
\r
339 database primary key, database primary keys
\r
340 databaseprimarykey, databaseprimarykeys
\r
341 db primary key, db primary keys
\r
342 dbprimarykey, dbprimarykeys
\r
345 Topic Type: Database Cursor
\r
347 Plural: Database Cursors
\r
350 database cursor, database cursors
\r
351 databasecursor, databasecursors
\r
352 db cursor, db cursors
\r
353 dbcursor, dbcursors
\r
356 Topic Type: Database Trigger
\r
358 Plural: Database Triggers
\r
361 database trigger, database triggers
\r
362 databasetrigger, databasetriggers
\r
363 db trigger, db triggers
\r
364 dbtrigger, dbtriggers
\r
370 Scope: Always global
\r
376 Topic Type: Build Target
\r
378 Plural: Build Targets
\r
381 build target, build targets
\r
382 buildtarget, buildtargets
\r