parses the line following the comment to automatically prefill some documentation for you. eg: fills in the @param and @return tags, with tab to jump between sections for quick editing. Makes intelligent guesses about return types of functions, and uses type-hinting and default values (in PHP) to determine parameter data tyeps.

Double slash comments (// like this) are extended when enter is pressed.

v1.3.0, 5 November 2011Improvements to handling of single-line commentsFunctions beginning with is or has are assumed to return BooleansConsolidated settings files into Base File.sublime-settings. If you had configured your settings in jsdocs.sublime-settings, please move them to the Base File settings.Setting jsdocs_extend_double_slashes controls whether single-line comments are extended.Pressing tab in a docblock will tab to match the description block of the previous tag. Use jsdocs_deep_indent to toggle this behaviour.

Don't mean to be spamming, but I've released version 2.0.0 of JSDocs which now officially supports PHP. I've edited the post at the start of this thread, but the readme on the github repo has the most info.

I've just released an update, now at version 2.1.0. From the changelog:

- Added a command to join lines inside a docblock which is smart to leading asterisks Press Ctrl+J to join lines - Variable types are guessed from their name. `is` and `has` are assumed to be Booleans, and `callback`, `cb`, `done`, `fn` and `next` are assumed to be Functions. - You can now define your own patterns for mapping a variable name to a type. See the README for documentation about the format - Autocomplete works better now. `@` will also insert the "@" character, allowing you to add any tag you like, even if it isn't in the autocomplete list. - Added the full set of PHPDoc tags.