/// commenting disabled? Generated from a template?

  • Thread starter Thread starter Hillbilly
  • Start date Start date
H

Hillbilly

Not getting heard quick enough in newsgroup for visualstudio must be too
many VB weenies ;-) so since this is a C# issue...

When typing the three slashes I thought VS2008 would then generate a default
<summary> comment block but that is not happening (anymore).

I've tried devenv /installvstemplates and devenv /setup to reinstall
templates but this type of commenting is still apparently not functioning.
Anybody lose and then restore the XML commenting?
 
This is a per project setting. Go to project properties, on the Build
page, select XML documentation file. This will also enable comment
auto-insertion.
 
Hillbilly said:
Not getting heard quick enough in newsgroup for visualstudio must be too
many VB weenies ;-) so since this is a C# issue...

When typing the three slashes I thought VS2008 would then generate a
default <summary> comment block but that is not happening (anymore).

I've tried devenv /installvstemplates and devenv /setup to reinstall
templates but this type of commenting is still apparently not
functioning. Anybody lose and then restore the XML commenting?
Click to expand...

Did you check to make sure the feature didn't accidentally get turned off?

Tools/Options…/Text Editor/C#/Advanced/XML Documentation
Comments/Generate XML documentation comments for ///

If that's not it, you can try running the IDE with the /resetsettings
switch, in case somehow the settings storage got corrupted. Barring
that, I fear a clean uninstall/reinstall might be required. Normally
the XML commenting stuff works fine.

Pete
 
Peter said:
This is a per project setting. Go to project properties, on the Build
page, select XML documentation file.
Click to expand...

Having that setting disabled does not prevent the use of /// in the
editor to create XML comments.
This will also enable comment auto-insertion.
Click to expand...

On what version of VS? It does not do it in VS2008.

Pete
 
Having that setting disabled does not prevent the use of /// in the
editor to create XML comments.
Click to expand...

You are right. Sorry for misleading information. What I wrote is true
only for VB, not for C#. I work on VB and C# projects so sometimes it
gets mixed in my head.
 
VS2008 but I'm straightened out now. I didn't realize the cursor has to be
immediately before some statement known by Intellisense such as a method or
public property etc. and then upon the insertion of the third slash the
comment block is indeed generated.
 
Not getting heard quick enough in newsgroup for visualstudio must be too
many VB weenies ;-) so since this is a C# issue...
Click to expand...

If you mean microsoft.public.vsnet.ide, that group is as good as dead.
 
Back
Top