LINUX.ORG.RU
Форум — Development  

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


0

2

Товаrищи, может знаете, есть ли где-нибудь такая тулза:

1) есть код
2) в этот код нельзя писать комментарии
3) но можно написать комментарии в отдельный файл
4) тулза будет отображать исходник, а на полях отмечать комметарии из файла
5) работает как патч - при изменении исходника пытается угадать, что куда сдвинулось и передвигает комментарии соответственно

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

нужно для комментариев, которые стыдно выложить в исходнике (длинные рассуждения на русском языке, вопли «смертельный быдлокод» и «адский мегакостыль» итп)

★★★★☆

Ответ на: комментарий от geekless

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

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

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

Bad_ptr ★★★★★
()
Ответ на: комментарий от Bad_ptr

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

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

geekless ★★
()

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

panter_dsd ★★★★
()

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

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

Kalashnikov ★★★
()
Ответ на: комментарий от geekless

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

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

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

stevejobs ★★★★☆
() автор топика
Ответ на: комментарий от stevejobs

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

strangeman ★★★★
()
Ответ на: комментарий от strangeman

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

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

stevejobs ★★★★☆
() автор топика

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

panter_dsd ★★★★
()

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

buddhist ★★★★★
()
Ответ на: комментарий от panter_dsd

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

Eddy_Em ☆☆☆☆☆
()

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

MKuznetsov ★★★★★
()

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

anonymous
()

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

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

anonymous
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.
Development