This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
Summary: | Comment Blocks | ||
---|---|---|---|
Product: | php | Reporter: | compucoder <compucoder> |
Component: | Editor | Assignee: | Ondrej Brejla <obrejla> |
Status: | RESOLVED WORKSFORME | ||
Severity: | blocker | CC: | jeremyclarke |
Priority: | P2 | ||
Version: | 6.x | ||
Hardware: | All | ||
OS: | All | ||
Issue Type: | ENHANCEMENT | Exception Reporter: |
Description
compucoder
2008-10-24 20:55:44 UTC
I think these are good suggestions. PHPDoc comments are easy to produce. Just go above the function or variable you want to document and type: /** then hit enter. That will produce a skeleton that is intelligent about the contents of the function etc. There's no keyboard shortcut but its easy to set up a macro for it that makes it easy. I set one up with the following contents: "/**" insert-break I mapped this to SHIFT+META+C (i'm on a mac, you could use CTRL instead of META) so I just hit those keys above a function and BAM, there's a mostly-done PHPdoc for my function :) Once you have PHPDoc comments they do indeed fold just like functions and will fold/unfold when you do the 'fold all' and 'unfold all' commands. That said its annoying because folded PHPDoc comments don't show any information, just [+] /** [...] I made an enhancement ticket about showing the first line of the comment in folded PHPDocs if you're interested in voting for it :) http://www.netbeans.org/issues/show_bug.cgi?id=169660 With regard to your request to change the keyboard shortcuts you should probably just change them yourself in the keymapping options. PHPDoc comments are easy to produce. Just go above the function or variable you want to document and type: /** then hit enter. That will produce a skeleton that is intelligent about the contents of the function etc. There's no keyboard shortcut but its easy to set up a macro for it that makes it easy. I set one up with the following contents: "/**" insert-break I mapped this to SHIFT+META+C (i'm on a mac, you could use CTRL instead of META) so I just hit those keys above a function and BAM, there's a mostly-done PHPdoc for my function :) Once you have PHPDoc comments they do indeed fold just like functions and will fold/unfold when you do the 'fold all' and 'unfold all' commands. That said its annoying because folded PHPDoc comments don't show any information, just [+] /** [...] I made an enhancement ticket about showing the first line of the comment in folded PHPDocs if you're interested in voting for it :) http://www.netbeans.org/issues/show_bug.cgi?id=169660 With regard to your request to change the keyboard shortcuts you should probably just change them yourself in the keymapping options. reassigning to default owner batch reassigning WFM |