Метакомментарии

Чёрт, телепаты на ЛОРе. Как раз собирался запостить такой же вопрос.

телепаты на ЛОРе

и хотят себе либастрал

изменении исходника пытается угадать, что куда сдвинулось

Ну почему же, если поддержку фичи к редактору прикрутить: правишь файл, вместе с ним правятся и комментарии в отдельном файле.

Угадывать — это действительно как-то... странно.

Самого такая фича интересовала всегда.

Может проще помечать такие комментарии и вырезать скриптом перед релизом?

Или вообще не писать комментарии за которые стыдно.

Угадывать — это действительно как-то... странно.

патч/дифф же угадывает

говорю, для этого дела можно юзать патч/дифф. Например, хранить пропатченную комментариями версию исходника в отдельном бранче «comments», а потом рибэйзать коммент-бранч поверх мастера/апстрима. Но это не очень удобно.

Отделять комментарии специфическим знаком (например обычные //коммент, а неугодные //=коммент), и при отправке в апстрим просто пробегаться регуляркой?

Тогда они потеряются!

Юзкейз:
1) есть репозиторий на гитхабе, где лежит публичная версия, которую чекаутят/юзают/допиливают Нормальные Люди.
2) есть команда, которая в основном пилит этот софт. У них рабочая версия (кроме локальных бранчей) отличается еще наличием внутренних метакомментариев.
3) комментарии могут иногда противоречить друг другу (например, в апстриме: «эту сортировку мы выбрали, потому что она очень быстрая и крутая», в метакомментариях: «какой дибил написал это шляпу? Вася, ты должен мне 3 лишних глаза»).

Тут еще одна фишка, использование кириллицы в комментариях - очень плохой подход, но иногда таки хочется написать коммент на родном языке. Вот и хорошо бы такие комменты в отдельном файле хранить.

Вы какой-то web/noweb изобретаете.

Зафигачить читалку комментариев по типу gettext'а: в коде комментарии делать на английском, а в отдельных файликах хранить перевод.

Некая wiki команды разработчиков. Начальное наполнение скриптами по doxygen,tags. Далее ведётся самими разработчиками. За актуальность и соответствие коду отвечает ведущий (кто там у вас на проекте главный). По функционалу подходит ikiwiki как хранящая всё в простых файлах, на выбранной вами VCS и соотв. легко скриптуемая в любом направлении.

Заведи в git-е бранч, пиши туда свои матерные каменты, и не забывай регулярно merge-ить в него master.

стыдно выложить в исходнике

Итого, имеем рукожопых быдлокодеров, для которых бородатые дядьки должны были написать тулзу, чтобы те могли скрывать от других свой ФГМ.
не нужно!

Лечи проблему а не симптомы.