GhostDoc «Документировать это» не работает для метода с атрибутом - PullRequest
0 голосов
/ 02 мая 2018

Я использую GhostDoc и Visual Studio 2017.

Теперь, если у меня есть такой метод

public string Foo() { ... }

Обычно я могу использовать GhostDocs «Документировать это», чтобы сгенерировать комментарий XML для соответствующего метода.

Однако, если к методу применены какие-либо атрибуты, например,

[NotNull]
public string Foo() { ... }

GhostDoc не может автоматически документировать метод. Это почему? Поскольку все мои методы аннотированы, невозможность использовать GhostDoc не очень удобна.

  • Есть ли способ, которым GhostDoc может документировать методы с атрибутами?

И, между прочим: я попытался добавить комментарии вручную, вставив /// между атрибутом и методом, который дает

Комментарий XML не помещен в допустимый элемент языка

ошибка.

enter image description here

однако, если я вставлю /// перед атрибутом, я не получу ошибку. Я чувствую, что даже при добавлении /// между методом и атрибутом комментарий применяется к методу и поэтому должен быть помещен в допустимый элемент языка, не так ли

1 Ответ

0 голосов
/ 07 мая 2018

Серж из SubMain здесь.

Мы попытались воспроизвести проблему, о которой вы сообщили, и GhostDoc сгенерировал документы в порядке.

Не могли бы вы прислать нам файлы журнала GhostDoc для устранения неполадок? Вы найдете файлы журнала в \ SubMain \ GhostDoc {Edition} для VSxxxx * .log

Пожалуйста, отправляйте журналы в службу поддержки на submain точка com.

Если вы включите рабочую версию и редакцию, это будет очень полезно.

Мы будем рады сотрудничать с вами для устранения проблемы, с которой вы столкнулись!

Спасибо!

...