fbpx
Welcome, Guest
Username: Password: Remember me
  • Page:
  • 1

TOPIC: XIDE and /doc

XIDE and /doc 1 year 7 months ago #3096

  Frank Maraite's Avatar Topic Author Frank Maraite Offline Posts: 172
Hi Chris,

since X# supports /doc it's crying for the code documentation comments (CDC) (XS1591). Of course I have many but now it's time to have support for them in XIDE too.

CDC's have to be just before the entity, for example:
/// <summary>
/// FMString does ...
/// </summary>
/// <example>
/// </example>
PARTIAL STATIC CLASS FMString

After collapsing the comments are still visible. Since these comments can be longer then the entity itself they should belong to the entity and then collapse with them.

Thanks in advance
Frank

Please Log in or Create an account to join the conversation.

XIDE and /doc 1 year 6 months ago #3171

  Chris's Avatar Chris Offline Posts: 1149
Hi Frank,

Sorry for my delay in answering this, wanted to look closely into it before getting back to you, but with all the testing etc for the new x# build, unfortunately I forgot.

Anyway, implementing this properly is difficult without slowing down the editor, but I think I have an idea on how to implement it relatively easily, by hardcoding the editor to always (at least when an option is set) treat comments starting with 3 slashes as doc comments, no matter where they are located. I assume you always use triple slashes for code doc comments, is that right? And you never use triple slashes (as comment markers) anywhere else in the code?

Chris
XSharp Development Team
chris(at)xsharp.eu

Please Log in or Create an account to join the conversation.

XIDE and /doc 1 year 6 months ago #3172

  Frank Maraite's Avatar Topic Author Frank Maraite Offline Posts: 172
Hi Chris,

do the important things first.

Yeah, I never understood why the comments are before the entity and not just the after the first line of them. This would be more consistent

method foo
/// <summary> foo is ... </summary>

or am I wrong?

OK, it is like it is. Of course three slashes are reserved for the CDC's. And if I used them accidently otherwise I have to correct that not you.

I'm on holiday the next two weeks. So you can take the time you need.

Thanks

Frank

Please Log in or Create an account to join the conversation.

  • Page:
  • 1