Skip to content

Commit 58b5865

Browse files
committed
Add .naturaldocs
1 parent 5778bc7 commit 58b5865

24 files changed

+445
-37
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
/.naturaldocs/Working\ Data

.naturaldocs/Comments.txt

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
Format: 2.2
2+
3+
# This is the Natural Docs comments file for this project. If you change
4+
# anything here, it will apply to THIS PROJECT ONLY. You can edit the version
5+
# in Natural Docs' Config folder to make the changes apply to all projects,
6+
# but it's recommended that you edit this version instead.
7+
8+
9+
# Ignored Keywords
10+
# ------------------------------------------------------------------------
11+
12+
# If you'd like to prevent keywords from being recognized by Natural Docs,
13+
# you can do it like this:
14+
#
15+
# Ignore Keywords:
16+
# [keyword]
17+
# [keyword]
18+
# ...
19+
20+
21+
# Comment Types
22+
# ------------------------------------------------------------------------
23+
24+
# Each Natural Docs comment has a corresponding type which determine its
25+
# behavior. You can define your own here or override the settings of the
26+
# existing ones.
27+
#
28+
# Comment Type: [name]
29+
# Alter Comment Type: [name]
30+
# Creates a new comment type or changes an existing one.
31+
#
32+
# Display Name: [name]
33+
# Plural Display Name: [name]
34+
# The singular and plural name of the comment type as it should appear in
35+
# the output.
36+
#
37+
# Simple Identifier: [name]
38+
# The name of the comment type using only the letters A to Z. No spaces,
39+
# numbers, symbols, or Unicode allowed. Defaults to the comment type name
40+
# minus any unacceptable characters. This is used to generate things like
41+
# CSS class names.
42+
#
43+
# Scope: [normal|start|end|always global]
44+
# How the comment affects scope. Defaults to normal.
45+
# normal - The comment stays within the current scope.
46+
# start - The comment starts a new scope for all the comments
47+
# beneath it, like class comments.
48+
# end - The comment resets the scope back to global for all the
49+
# comments beneath it, like section comments.
50+
# always global - The comment is defined as a global symbol, but does not
51+
# change the scope for any other comments.
52+
#
53+
# Flags: [flag], [flag], ...
54+
# A combination of settings that apply to the comment type.
55+
# Code, File, or Documentation
56+
# Whether it's used to describe a code element, a file, or is a
57+
# standalone documentation comment. Defaults to Code.
58+
# Variable Type
59+
# Whether it describes a code element that can be used as a variable's
60+
# type.
61+
# Class Hierarchy or Database Hierarchy
62+
# Whether it describes a code element that should be included in the
63+
# class or database hierarchy. Requires Scope: Start.
64+
# Enum
65+
# Whether it describes an enum.
66+
#
67+
# Keywords:
68+
# [keyword]
69+
# [keyword], [plural keyword]
70+
# ...
71+
# A list of the comment type's keywords. Each line after the heading is
72+
# the keyword and optionally its plural form for list comments. You can
73+
# reuse existing keywords to change their definition. When using
74+
# "Alter Comment Type", these keywords are added to the existing ones
75+
# rather than replacing them.
76+
#
77+
# [Language] Keywords:
78+
# [keyword]
79+
# [keyword], [plural keyword]
80+
# ...
81+
# A list of keywords that only apply to the comment type when using a
82+
# specific programming language. Each line after the heading is the
83+
# keyword and optionally its plural form for list comments.

.naturaldocs/Languages.txt

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
Format: 2.2
2+
3+
# This is the Natural Docs languages file for this project. If you change
4+
# anything here, it will apply to THIS PROJECT ONLY. You can edit the version
5+
# in Natural Docs' Config folder to make the changes apply to all projects,
6+
# but it's recommended that you edit this version instead.
7+
8+
9+
# Ignored Extensions
10+
# ------------------------------------------------------------------------
11+
12+
# If you'd like to prevent certain file extensions from being scanned by
13+
# Natural Docs, you can do it like this:
14+
#
15+
# Ignore Extensions: [extension] [extension] ...
16+
17+
18+
# Languages
19+
# ------------------------------------------------------------------------
20+
# The syntax reference is after the definitions.
21+
22+
Language: ShellScript
23+
24+
Extension: sh
25+
Shebang String: sh
26+
27+
Line Comment: ##
28+
Block Comment: <<'__DOCMENTATION__' __DOCMENTATION__
29+
30+
31+
Language: Markdown
32+
33+
Extension: md
34+
35+
Block Comment: <!-- -->
36+
37+
38+
Language: XML
39+
40+
Extensions: xml xsl rng
41+
42+
Block Comment: <!-- -->
43+
44+
45+
# These settings define the languages Natural Docs knows how to parse. You
46+
# can define your own here or override the settings of the existing ones.
47+
# Note that all lists are space separated so that commas can be used as
48+
# values.
49+
#
50+
# Language: [name]
51+
# Alter Language: [name]
52+
# Defines a new language or alters an existing one. Its name can use any
53+
# characters. If any of the properties below have an add/replace form, you
54+
# must use that when using Alter Language.
55+
#
56+
# The language Shebang Script is special. It's entry is only used for
57+
# extensions, and files with those extensions have their shebang (#!) lines
58+
# read to determine the real language of the file. Extensionless files are
59+
# always treated this way.
60+
#
61+
# The language Text File is also special. It's treated as one big comment
62+
# so you can put Natural Docs content in them without special symbols.
63+
#
64+
# Extensions: [extension] [extension] ...
65+
# [Add/Replace] Extensions: [extension] [extension] ...
66+
# Defines the file extensions of the language's source files.
67+
#
68+
# Shebang Strings: [string] [string] ...
69+
# [Add/Replace] Shebang Strings: [string] [string] ...
70+
# Defines a list of strings that can appear in the shebang (#!) line to
71+
# designate that it's part of the language.
72+
#
73+
# Simple Identifier: [name]
74+
# The name of the language using only the letters A to Z. No spaces,
75+
# numbers, symbols, or Unicode allowed. Defaults to the language name
76+
# minus any unacceptable characters. This is used to generate things like
77+
# CSS class names.
78+
#
79+
# Aliases: [alias] [alias] ...
80+
# [Add/Replace] Aliases: [alias] [alias] ...
81+
# Defines alternative names for the language that can be used to start a
82+
# code block.
83+
#
84+
#
85+
# Properties for Basic Language Support Only
86+
# ------------------------------------------------------------------------
87+
# If you're adding your own language to Natural Docs you must define these.
88+
#
89+
# Line Comments: [symbol] [symbol] ...
90+
# Defines a space-separated list of symbols that are used for line comments,
91+
# if any.
92+
#
93+
# Block Comments: [opening sym] [closing sym] [opening sym] [closing sym] ...
94+
# Defines a space-separated list of symbol pairs that are used for block
95+
# comments, if any.
96+
#
97+
# Member Operator: [symbol]
98+
# Defines the default member operator symbol. The default is a dot.
99+
#
100+
# Line Extender: [symbol]
101+
# Defines the symbol that allows a prototype to span multiple lines if
102+
# normally a line break would end it.
103+
#
104+
# Enum Values: [global|under type|under parent]
105+
# Defines how enum values are referenced. The default is global.
106+
# global - Values are always global, referenced as 'value'.
107+
# under type - Values are under the enum type, referenced as
108+
# 'class.enum.value'.
109+
# under parent - Values are under the enum's parent, referenced as
110+
# 'class.value'.
111+
#
112+
# Case Sensitive: [yes|no]
113+
# Defines whether the language's identifiers are case sensitive. The
114+
# default is yes.
115+
#
116+
# [Comment Type] Prototype Enders: [symbol] [symbol] ...
117+
# When defined, Natural Docs will attempt to get a prototype from the code
118+
# immediately following the comment type. It stops when it reaches one of
119+
# these symbols. Use \n for line breaks.

0 commit comments

Comments
 (0)