kasecato / vscode-docomment

Generate XML documentation comments for Visual Studio Code
https://marketplace.visualstudio.com/items?itemName=k--kato.docomment
MIT License
49 stars 15 forks source link

Incorrect comments generation for variables and method calls #70

Open SteamUpdate opened 6 years ago

SteamUpdate commented 6 years ago

Hello! It's can be fixed?

vscode wrong comments

For this case must be

using System;

namespace EleWise.ELMA.Core.Model
{
    public class TestClass
    {
        public void Main()
        {
            ///
            var prop = "";
            ///
            Console.WriteLine(prop);
        }
    }
}
SteamUpdate commented 6 years ago

I know how to fix second case (Console.WriteLine). Just delete this line of code

kasecato commented 6 years ago

Thanks @SteamUpdate ,

This is a deep problem, I can not fix it with the current architecture. We need to add AST, which makes the extension very heavy. This is an important issue, please do not close it. 🙇‍♂️

gruberr commented 5 years ago

I might not be up to date with a certain feature here, but does C# even care about documentation comments within a method body? I don't think these will get picked up anywhere to begin with. Still an annoying issue, but IMHO not vital.