Skip to content

jeremyvii/vs-docblockr

Repository files navigation

VS DocBlockr (Visual Studio Code)

Actions Status Coverage Status GitHub release Visual Studio Marketplace Installs

A Visual Studio Code port of the Atom package Docblockr.

Extension page

Currently three languages have been implemented:

  • C
  • Java
  • JavaScript
  • PHP
  • SCSS
  • TypeScript
  • Vue.js

More languages will be implemented in the future.

Usage

Type /** above the code you want to apply a docblock too, and press enter.

Demonstration of extension

The Render from selection command is also available in the command palette.

Demonstration of extension

This command can also be used to parse code that spans multiple lines. (Note: you autocomplete multiple lines with the /** keybinding)

Demonstration of extension

Settings

Currently the following configuration settings have been implemented:

Title Description
Align Tags Whether or not to automatically align the parameters, return, or variable tags.
Block Comment Style Which doc block comment style to use (default|drupal).
Column Spacing Minimum number of spaces between columns.
New Lines Between Tags Whether or not to add new lines between tags.
Default return tag Whether or not to display a return tag.
*SCSS Comment Close Type of block level comment closing to use.
*SCSS Comment Open Type of block level comment opening to use.
*SCSS Comment Separator Type of block level separator closing to use.

* Note: VS DocBlockr does not currently support autocompletion of SASS blocks with ///.