Как разделить robo-комментарии и #region от C#?
class TransparentJPanel extends JPanel
{
TransparentJPanel()
{
super() ;
this.setOpaque( false ) ; // this will make the JPanel transparent
// but not its components (JLabel, TextField etc.)
this.setLayout( null ) ;
}
}
4 ответа
Почему бы не использовать поиск и замену регулярных выражений в Visual Studio?
Для комментариев с тройной косой чертой:
///.*
Для тегов регионов:
[#]region.*
[#]endregion
Эти части, вероятно, были набраны вручную:
Реализация открытого метода foo bar, возвращающая void
и
строковый параметр с именем input
Если это находится в проекте библиотеки классов, я бы не стал избавляться от комментариев xml - именно они будут отображаться в подсказках intellisense для этих элементов. Их удаление может сильно разозлить на вас других разработчиков; несмотря на то, что весь текст здесь не очень хорош, подсказки по умолчанию загадочные и даже хуже.
Я бы сказал, что заменить их чем-то более разумным намного лучше, чем их убрать. Какими бы обыденными они ни были, отсутствие комментариев всегда хуже (если, конечно, комментарии неверны? Тогда отсутствие комментариев определенно лучше): -)
Тем не менее, я считаю , что это делает то, что вы ищете для .
Для тегов регионов вы можете попробовать адаптировать это приложение или использовать VS 'regex find / replace.
I vote that you go in and fix them as you come across them. I've had to do the same thing here... every time that I go into a class that has bad comments (in my case: none). I comment the methods/properties as I work with them. After 3 weeks, I've properly commented about 1/2 the codebase and have developed a stronger understanding of the entire project.