FuncDocr
A brackets extension to generate JS/PHPDocs for your functions.
Important change!
I would like to use parser to offer better support! At the moment ES6 isn't supported in a good way and everything else are just regular expressions. Sorry I'm still learning :D Unfortunately I didn't find a parser to support PHP yet :/ There are two options now: Just waiting until I find a parser for PHP or use regexes for PHP and a parser for JS. I've several extensions and a lot of other projects and that upgrade will take a lot of time. Therefore it would be great if you can check out the next section ;)
You're rich?
You don't need a second yacht and have some coins to spend? Here I am :)
Current amount: 1.04β¬
How to Use
- Open a JS or PHP file
- set your cursor on a function declaration
function cool(stuff)
- Use the ShortCut
Ctrl-Alt-D
(Win) orCtrl-Shift-D
(Mac) to start the documentation or/**
+ Enter
The extension will provide a function documentation:
Natural way: /**
+ Enter
With shortcut:
[[Description]]
will be selected so you can start to type. To jump to the next [[tag]]
you can use Tab
or jump to the last with Shift-Tab
. The indenting updates on a tab jump (live indenting).
You will get hints for the [[Type]]
tag.
Have fun and stay tuned!
v0.8.4
- It's possible to disable the autoindent functionality in the settings menu.
@callback
links will be visible as[[Type]]
hints.
v0.8.0
You can use several JSDoc options to describe your function
and you can dblclick on [[...]]
to edit the tags.
v0.7.0
Document your react functions!
v0.6.0
@link tags
Easy way to add @link tags to your docs!
v0.5.3
Default values!
v0.5.0
- It's possible to generate the doc block with
/**
+ Enter. You only need to type/**
in the line above the function declaration and use enter to start the documentation.
v0.4.0
- The padding for correct indentation updates on a tab jump
v0.3.0
- It's possible to update a doc block if you add a parameter or delete one (you need to use the shortcut again)
v0.2.0
- You get the tag
@returns
if the function returns a value - The
[[Type]]
is recognized if possible.