/// commenting disabled? Generated from a template?

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?
 
P

Peter Macej

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.
 
P

Peter Duniho

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?

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
 
P

Peter Duniho

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

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

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

Pete
 
P

Peter Macej

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

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.
 
H

Hillbilly

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.
 
H

Hillbilly

Thanks for that reminder (which was enabled) but please see my comments
above.
 
J

Jeff Johnson

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

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

Ask a Question

Want to reply to this thread or ask your own question?

You'll need to choose a username for the site, which only take a couple of moments. After that, you can post your question and our members will help you out.

Ask a Question

Top