3

I'm referring to the snippet that's used when typing /// before a method.

I've found something for JavaScript (C:\Program Files (x86)\Microsoft Visual Studio 14.0\JavaScript\Snippets\1033\XML Comments) but changing it didn't affect the C# XML summary.

I'm aware of this question but the accepted answer doesn't really answer this question, and the second answer is outdated.

Community
  • 1
  • 1
ispiro
  • 26,556
  • 38
  • 136
  • 291
  • Good question but the fact that it's turned on/off in Tools,Options,C#,formatting suggests it isn't really a snippet. Also it adapts to your parameters and return type. – H H Jun 05 '16 at 13:29
  • Yes @HenkHolterman is right, that's not a snippet - it actually was more of a macro I think - this may be helpful, this is a [User Voice](https://visualstudio.uservoice.com/forums/121579-visual-studio-2015/suggestions/2709987-xml-comments-schema-customization-in-c) for this and still unresolved as it seems – NSGaga-mostly-inactive Jun 05 '16 at 13:34
  • @NSGaga Thanks. The `User Voice` is proof enough. From [a link there](https://blogs.msdn.microsoft.com/lisa/2010/05/24/how-to-customize-the-xml-comments-that-are-inserted-by-the-visual-basic-code-editor/) it seems it is, in a way, a snippet, but is only supported for VB, not C#. – ispiro Jun 05 '16 at 13:55
  • @NSGaga Also, feel free to write an answer. I wrote mine because your response was a comment. – ispiro Jun 05 '16 at 14:00

2 Answers2

1

As per a comment above - there's a User Voice request for it. And as per a comment on the User Voice - it can be done in VB but not C#.

ispiro
  • 26,556
  • 38
  • 136
  • 291
1

As requested by OP, not sure if it's an answer - but there doesn't seem to be a better one at the moment, unfortunately...

This may be helpful, this is a User Voice for this and still unresolved as it seems.

As per the @HenkHolterman's comment - that I agree with - I don't think that's a snippet. For the moment it seems to be built into VS (out of curiosity I searched through VS 15 - new version not the 2015, and nothing new in there either - I searched all files for anything resembling XML comments).

There's a VB solution that, as I could see, places a custom .XML file in the specific AppData location - which doesn't work for C#. They describe the process as...

Visual Studio has built-in defaults for the XML skeletons that get inserted, but when VBXMLDoc.xml is present upon startup, Visual Studio will use the XML definitions from that file instead

NSGaga-mostly-inactive
  • 14,052
  • 3
  • 41
  • 51