summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChristoph Schlosser <christoph@linux.com>2018-09-29 19:16:05 +0200
committerChristoph Schlosser <christophschlosser@users.noreply.github.com>2018-09-29 19:25:19 +0200
commit5d2f5cfaff8bd69aa779c957794cda11814d2830 (patch)
tree0ebad892662495475c59c4d4f8d62305fc1674a3
parent2e260f80ba6aa4c8a9d05f7f5455e445a06464e0 (diff)
downloaddoxdocgen-5d2f5cfaff8bd69aa779c957794cda11814d2830.tar.gz
Update Readme with new settings0.4.0
-rw-r--r--README.md139
1 files changed, 80 insertions, 59 deletions
diff --git a/README.md b/README.md
index b3884cb..d1f1f16 100644
--- a/README.md
+++ b/README.md
@@ -99,88 +99,109 @@ Each of them can be configured with its own custom text and you can decide if th
```json
// The prefix that is used for each comment line except for first and last.
-"doxdocgen.c.commentPrefix": " * ",
+ "doxdocgen.c.commentPrefix": " * ",
-// Smart text snippet for factory methods/functions.
-"doxdocgen.c.factoryMethodText": "Create a {name} object",
+ // Smart text snippet for factory methods/functions.
+ "doxdocgen.c.factoryMethodText": "Create a {name} object",
-// The first line of the comment that gets generated. If empty it won't get generated at all.
-"doxdocgen.c.firstLine": "/**",
+ // The first line of the comment that gets generated. If empty it won't get generated at all.
+ "doxdocgen.c.firstLine": "/**",
-// Smart text snippet for getters.
-"doxdocgen.c.getterText": "Get the {name} object",
+ // Smart text snippet for getters.
+ "doxdocgen.c.getterText": "Get the {name} object",
-// The last line of the comment that gets generated. If empty it won't get generated at all.
-"doxdocgen.c.lastLine": " */",
+ // The last line of the comment that gets generated. If empty it won't get generated at all.
+ "doxdocgen.c.lastLine": " */",
-// Smart text snippet for setters.
-"doxdocgen.c.setterText": "Set the {name} object",
+ // Smart text snippet for setters.
+ "doxdocgen.c.setterText": "Set the {name} object",
-// Doxygen comment trigger. This character sequence triggers generation of Doxygen comments.
-"doxdocgen.c.triggerSequence": "/**",
+ // Doxygen comment trigger. This character sequence triggers generation of Doxygen comments.
+ "doxdocgen.c.triggerSequence": "/**",
-// Smart text snippet for constructors.
-"doxdocgen.cpp.ctorText": "Construct a new {name} object",
+ // Smart text snippet for constructors.
+ "doxdocgen.cpp.ctorText": "Construct a new {name} object",
-// Smart text snippet for destructors.
-"doxdocgen.cpp.dtorText": "Destroy the {name} object",
+ // Smart text snippet for destructors.
+ "doxdocgen.cpp.dtorText": "Destroy the {name} object",
-// The template of the template parameter Doxygen line(s) that are generated. If empty it won't get generated at all.
-"doxdocgen.cpp.tparamTemplate": "@tparam {param} ",
+ // The template of the template parameter Doxygen line(s) that are generated. If empty it won't get generated at all.
+ "doxdocgen.cpp.tparamTemplate": "@tparam {param} ",
-// The order to use for the file comment. Values can be used multiple times. Valid values are shown in default setting.
-"doxdocgen.file.fileOrder": [
- "brief",
- "empty",
- "file",
- "author",
- "date"
-],
+ // File copyright documentation tag. Array of strings will be converted to one line per element. Can template {year}.
+ "doxdocgen.file.copyrightTag": [
+ "@copyright Copyright (c) {year}"
+ ],
-// The template for the file parameter in Doxygen.
-"doxdocgen.file.fileTemplate": "@file {name}",
+ // Additional file documentation. Array of strings will be converted to one line per element. Can template {year}, {date}, {author}, and {email}.
+ "doxdocgen.file.customTag": [],
-// Set the style of the author tag and your name.
-"doxdocgen.generic.authorTag": "@author your name",
+ // The order to use for the file comment. Values can be used multiple times. Valid values are shown in default setting.
+ "doxdocgen.file.fileOrder": [
+ "file",
+ "author",
+ "brief",
+ "version",
+ "date",
+ "empty",
+ "copyright",
+ "empty",
+ "custom"
+ ],
-// If this is enabled a bool return value will be split into true and false return param.
-"doxdocgen.generic.boolReturnsTrueFalse": true,
+ // The template for the file parameter in Doxygen.
+ "doxdocgen.file.fileTemplate": "@file {name}",
-// The template of the brief Doxygen line that is generated. If empty it won't get generated at all.
-"doxdocgen.generic.briefTemplate": "@brief {text}",
+ // Version number for the file.
+ "doxdocgen.file.versionTag": "@version 0.1",
-// The format to use for the date.
-"doxdocgen.generic.dateFormat": "YYYY-MM-DD",
+ // Set the e-mail address of the author. Replaces {email}.
+ "doxdocgen.generic.authorEmail": "you@domain.com",
-// The template for the date parameter in Doxygen.
-"doxdocgen.generic.dateTemplate": "@date {date}",
+ // Set the name of the author. Replaces {author}.
+ "doxdocgen.generic.authorName": "your name",
-// Decide if you want to get smart text for certain commands.
-"doxdocgen.generic.generateSmartText": true,
+ // Set the style of the author tag and your name. Can template {author} and {email}.
+ "doxdocgen.generic.authorTag": "@author {author} ({email})",
-// Whether include type information at return.
-"doxdocgen.generic.includeTypeAtReturn": true,
+ // If this is enabled a bool return value will be split into true and false return param.
+ "doxdocgen.generic.boolReturnsTrueFalse": true,
-// How many lines the plugin should look for to find the end of the declaration. Please be aware that setting this value too low could improve the speed of comment generation by a very slim margin but the plugin also may not correctly detect all declarations or definitions anymore.
-"doxdocgen.generic.linesToGet": 20,
+ // The template of the brief Doxygen line that is generated. If empty it won't get generated at all.
+ "doxdocgen.generic.briefTemplate": "@brief {text}",
-// The order to use for the comment generation. Values can be used multiple times. Valid values are shown in default setting.
-"doxdocgen.generic.order": [
- "brief",
- "empty",
- "tparam",
- "param",
- "return"
-],
+ // The format to use for the date.
+ "doxdocgen.generic.dateFormat": "YYYY-MM-DD",
-// The template of the param Doxygen line(s) that are generated. If empty it won't get generated at all.
-"doxdocgen.generic.paramTemplate": "@param {param} ",
+ // The template for the date parameter in Doxygen.
+ "doxdocgen.generic.dateTemplate": "@date {date}",
-// The template of the return Doxygen line that is generated. If empty it won't get generated at all.
-"doxdocgen.generic.returnTemplate": "@return {type} ",
+ // Decide if you want to get smart text for certain commands.
+ "doxdocgen.generic.generateSmartText": true,
-// Decide if the values put into {name} should be split according to their casing.
-"doxdocgen.generic.splitCasingSmartText": true
+ // Whether include type information at return.
+ "doxdocgen.generic.includeTypeAtReturn": true,
+
+ // How many lines the plugin should look for to find the end of the declaration. Please be aware that setting this value too low could improve the speed of comment generation by a very slim margin but the plugin also may not correctly detect all declarations or definitions anymore.
+ "doxdocgen.generic.linesToGet": 20,
+
+ // The order to use for the comment generation. Values can be used multiple times. Valid values are shown in default setting.
+ "doxdocgen.generic.order": [
+ "brief",
+ "empty",
+ "tparam",
+ "param",
+ "return"
+ ],
+
+ // The template of the param Doxygen line(s) that are generated. If empty it won't get generated at all.
+ "doxdocgen.generic.paramTemplate": "@param {param} ",
+
+ // The template of the return Doxygen line that is generated. If empty it won't get generated at all.
+ "doxdocgen.generic.returnTemplate": "@return {type} ",
+
+ // Decide if the values put into {name} should be split according to their casing.
+ "doxdocgen.generic.splitCasingSmartText": true
```
## Contributors