ApexDoc comment generation broken?
When I type /**
+ enter above a method, I used to get a nice stub with @param
s and the name, etc.
Now I get
Comments (7)
-
repo owner -
repo owner - changed status to resolved
I'm going to resolve this assuming that takes care of it for you, but if not please reopen and let me know what you're seeing.
-
Account Deactivated reporter First checkbox was not checked. Not sure how that got changed since it last worked, but it is resolved.
Thanks.
-
repo owner That option isn't enabled by default to ensure that folks don't reformat code and suddenly find HUGE sweeping changes across their code base. Ideally the second option would still work properly even if the first isn't checked, but I refactored the second option to use the first so I guess they're more tightly-coupled now. Sorry for the brief confusion...
-
Account Deactivated reporter A+ support either way. Thanks
-
The tight coupling of ‘Enable ApexDoc formatting’ and ‘Generate ApexDoc on /**’ is confusing. Understand why the first is unchecked by default but ever since I updated to 2.1.1.7 it has felt like ApexDoc was broken. Even though I did have Generate enabled ApexDoc never inserted parameters or @return options. I only ever got /** on one line, followed by * on the next and then */ on the last line. Because of the tight-coupling and the default off for formatting the update caused ApexDoc to become non-functional. I have now found and enabled formatting and I am back to normal. It was just confusing because it used to work and then it didn’t.
-
repo owner Greg, I agree that the tight coupling is confusing and it's something I plan to address so that
/**<enter
works whether the formatter is enabled or not. Hopefully I'll get that into one of the very near-term builds. - Log in to comment
Make sure that you have these options enabled in the formatter:
Take a look at the following for more information: