# Generate Doxygen Comments for VS Code

This VS Code Extensions provides Doxygen Documentation generation on the fly by starting a Doxygen comment block and pressing enter.

[![Build Status](https://travis-ci.org/christophschlosser/doxdocgen.svg?branch=master)](https://travis-ci.org/christophschlosser/doxdocgen)
[![Build status](https://ci.appveyor.com/api/projects/status/4h84071p9tv0y9r6?svg=true)](https://ci.appveyor.com/project/christophschlosser/doxdocgen)

## Features

Generate Doxygen Comments from method signatures.

From simple setter methods

![Simple Parameter](images/param_simple.gif)

over declarations

![Declaration](images/declaration.gif)

to bool return values.

![Bool return val](images/bool.gif)

And some special cases:

Like Constructors

![Constructor](images/ctor.gif)

Multi line definitions/declarations

![method](images/method.gif)

Strip reserved keywords

![keywords](images/keywords.gif)

Or even function pointers *as parameters* (see [Known Issues](#function-pointers))

![func_ptr](images/function_ptr.gif)

Featuring an extensive generation customization system

![options](images/options.gif)
![xml options](images/opts-xml.gif)


## Extension Settings

See [Below](#whats-to-come)

## Contributors

[Christoph Schlosser](https://github.com/christophschlosser)

[Rowan Goemans](https://github.com/rowanG077)

## Known Issues

### Function pointers

See [#18](https://github.com/christophschlosser/doxdocgen/issues/18)

Documentation for certain constructs (like the following) may not be generated correctly.

```C
int (*idputs(int (*puts)(const char *)))(const char *)
```

## What's to come

* Suggest smart text

* Configuration options
  * Support more configuration options

* Tests

* More languages
  * C++11 and newer

* Improve language support
  * Classes
  * Namespaces
  * Enums
