couple of thoughts & ideas...
Posted April 14th, 2005 by situationist
firstly, just wanted to say, excellent work with the PHPdoc syntax and intellisense. it's really coming along, and it's so awesome to have a solid IDE for php that keeps gettin better every day.
admittedly, during the time you guys were workin on the phpdoc syntax, i switched over to zend for a while to see if it was any good (v4.0.2). i must say, next to vs.php, it's the only other app i'd use, but vs.php is already far surpassing it in my opinion.
a couple of ideas for vs.php (some inspired by zend):
- in phpdoc comments, make the @ descriptors bold, like @access, @param, @return, etc., for easier reading when editing.
- intellisense for @ descriptors: automatically display a list of available vars when the user types '@'
- can vs.php automatically remove whitespace as you edit? like when i use visual studio to write VB, it does that. this is great for when the caret is, say, 20 characters in, and the user hits 'enter' 3 times: auto-indent works great, but now there's 3 lines that each have 20 spaces. i can't stand that.
- maintain coloring when typing a variable name inside a string. example: "hello, $name" or "hello, {$name}" - in both cases, $name should be the proper color for a variable, but in the second case the brackets oughta be black to indicate that they're not part of the string.
- any way we could get intellisense for HTML tags, or at least attributes?
- i noticed intellisense works for constants, but only if you invoke intellisense with ctrl+space. obviously it might be kinda outta hand to have intellisense auto-list constants every time 1 letter is typed, but maybe you could set a 'number of characters' threshhold. in other words, if the word being typed is say, 3 or more characters in length thus far, then intellisense can list any matching constants automatically.
- i think someone mentioned this, but it'd be great to have some kinda shortcut or context menu to add phpdoc comment blocks with as much info filled in already as possible. like for example, if i'm editing 'function MyFunction($MyParam=0)', and i hit a shortcut or context menu item to insert a docblock, it should have a 'Enter description here...' and '@param int $MyParam' already included in the doc block.
- is there any way to integrate a phpdoc documentation generator/formatter, or maybe allow the user to specify a phpdoc generator as an 'external tool' or something? [by generator, i mean something that makes CHM or HTML help files from the docblock.] i'm actually pretty new to the whole phpdoc thing, so i really don't know what generators exist, or are any good, or this would even be easy to do with vs.php.
anyway, that's all i got for now. again, fantastic job with all the recent improvements. you guys are really doing a great job developing this thing, and it is now definitely my IDE of choice, bar none.
thanks,
-jake m


Re: couple of thoughts & ideas...
Very interesting and detailed post here, surely there is something to be done about what you mentionned, i'll be looking into it :)
Further on @-tags
Hi,
I'm currently working with VS.PHP version 2.3.
If you manually format your docblock as per the "standard" (i.e. with asterisks at the beginning of every line) the tags are made bold. That means this will look nice:
/**
* Description
*
* @see whatever you want
*/
The issue is that VS.PHP does not format the docblock like this automatically like other IDEs do. This would be a nice feature for future releases :)
In the meantime, you can do this manually, and it works fine.