Комментарии в многострочном стиле, вызывающие предупреждение XML-документации

У меня есть много многострочных комментариев в проекте C#, и когда параметр проекта настроен на вывод файла документации XML, все они вызывают предупреждение XML-комментарий не размещен на допустимом языковом элементе. Такое поведение наблюдается в Visual Studio 2010.

Если не считать изменения всех этих комментариев на комментарии в однострочном стиле, что я могу сделать, чтобы предотвратить срабатывание этих предупреждений?

Уменьшенный пример:

public class Foo
{
    /// <summary>
    /// Does something.
    /// </summary>
    public void DoSomething()
    {
        /**
         * Do something interest here.
         */
    }
}

person Altair    schedule 15.02.2013    source источник
comment
Что-то связанное с двойной звездой? Это похоже на комментарий к документу в Java... измените его на /* вместо /**   -  person jonnystoten    schedule 15.02.2013


Ответы (1)


Просто удалите второй * в первой строке комментария.

Комментарии XML-документа в стиле C открываются с помощью /**.

person SLaks    schedule 15.02.2013
comment
Я вижу, только /** вызывает предупреждение, любое другое количество * в первой строке не вызывает предупреждение. Спасибо @SLaks и @applechewer. - person Altair; 15.02.2013