summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChristoph Schlosser <christoph@linux.com>2018-03-02 20:14:48 +0100
committerChristoph Schlosser <christophschlosser@users.noreply.github.com>2018-03-02 20:24:28 +0100
commit0734e59e6a300556bc1d7342eb762ebdf3bc1582 (patch)
tree4fce05033a37e328e84a8c408533c168905d6760
parentf44c42f1d322b8164b0c736c79eae0f22b5decbc (diff)
downloaddoxdocgen-0734e59e6a300556bc1d7342eb762ebdf3bc1582.tar.gz
Add smart text and config options to readme
-rw-r--r--CHANGELOG.md4
-rw-r--r--README.md106
-rw-r--r--images/smartTextCtor.gifbin0 -> 72694 bytes
-rw-r--r--images/smartTextCustom.gifbin0 -> 80323 bytes
-rw-r--r--images/smartTextGet.gifbin0 -> 52732 bytes
5 files changed, 109 insertions, 1 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3e7c6fe..70a96c7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
# Change Log
+## [0.2.1]
+
+- Hotfix. Include moment.js as runtime dependency
+
## [0.2.0]
- Fix #51
diff --git a/README.md b/README.md
index 65253d4..6cdee45 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,7 @@ This VS Code Extensions provides Doxygen Documentation generation on the fly by
* [Trailing](#trailing)
* [Smart text](#smart-text)
* [Templates](#templates)
+* [Config options](#config-options)
* [Contributors](#contributors)
* [Known Issues](#known-issues)
* [What's to come](#whats-to-come)
@@ -66,7 +67,23 @@ This VS Code Extensions provides Doxygen Documentation generation on the fly by
### Smart text
-todo
+![Smart text CTor](images/smartTextCtor.gif)
+![Smart text Custom](images/smartTextCustom.gif)
+![Smart text Getter](images/smartTextGet.gif)
+
+Supported smart text snippets:
+
+* Constructors
+
+* Destructors
+
+* Getters
+
+* Setters
+
+* Factory methods
+
+Each of them can be configured with its own custom text and you can decide if the addon should attempt to split the name of the method according to its case.
#### Trailing
@@ -77,6 +94,93 @@ todo
![Template method](images/template.gif)
![Template class](images/template-class.gif)
+## Config options
+
+```json
+// The prefix that is used for each comment line.
+ "doxdocgen.c.commentPrefix": " * ",
+
+ // 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": "/**",
+
+ // 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": " */",
+
+ // 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": "/**",
+
+ // 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",
+
+ // Whether to insert a newline after the template params.
+ "doxdocgen.cpp.newLineAfterTParams": false,
+
+ // 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 date. Valid values are shown in default setting.
+ "doxdocgen.file.fileOrder": [
+ "brief",
+ "file",
+ "author",
+ "date"
+ ],
+
+ // The template for the file parameter in DoxyGen.
+ "doxdocgen.file.fileTemplate": "@file {name}",
+
+ // Set the style of the author tag and your name.
+ "doxdocgen.generic.authorTag": "@author your name",
+
+ // If this is enabled a bool return value will be split into true and false return param.
+ "doxdocgen.generic.boolReturnsTrueFalse": true,
+
+ // The template of the brief DoxyGen line that is generated. If empty it won't get generated at all.
+ "doxdocgen.generic.briefTemplate": "@brief ",
+
+ // The format to use for the date.
+ "doxdocgen.generic.dateFormat": "YYYY-MM-DD",
+
+ // The template for the date parameter in DoxyGen.
+ "doxdocgen.generic.dateTemplate": "@date {date}",
+
+ // Decide if you want to get smart text for certain commands.
+ "doxdocgen.generic.generateSmartText": 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 may improve the speed of comment generation but the plugin also may not correctly detect all declarations or definitions anymore.
+ "doxdocgen.generic.linesToGet": 20,
+
+ // Whether to insert a newline after a brief.
+ "doxdocgen.generic.newLineAfterBrief": true,
+
+ // Whether to insert a newline after the params.
+ "doxdocgen.generic.newLineAfterParams": false,
+
+ // 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
[Christoph Schlosser](https://github.com/christophschlosser)
diff --git a/images/smartTextCtor.gif b/images/smartTextCtor.gif
new file mode 100644
index 0000000..bdb2d98
--- /dev/null
+++ b/images/smartTextCtor.gif
Binary files differ
diff --git a/images/smartTextCustom.gif b/images/smartTextCustom.gif
new file mode 100644
index 0000000..142c40c
--- /dev/null
+++ b/images/smartTextCustom.gif
Binary files differ
diff --git a/images/smartTextGet.gif b/images/smartTextGet.gif
new file mode 100644
index 0000000..9922ff0
--- /dev/null
+++ b/images/smartTextGet.gif
Binary files differ