Какие есть проекты по извлечению разметки из специальных комментариев?
Не разбираюсь совсем. Хочу разделять комментарии в исходном коде на 'служебные' и 'для людей'. Например, с одной стороны в комментарии можно класть doxygen/grapviz и прочее для документации 'на месте', ну или обозначения и группировки узлов графа вызовов/типов/данных для 'самого важного для понимания'. И есть обычные комментарии, которые, например, поясняют посреди алгоритма неочевидный/сомнительный шаг или обозначение. Проблема в том, что служебные и человекочитаемые комментарии сливаются, так ещё и служебные комментарии могут быть разнотипные.
Похоже на потребность в (1) формате служебных комментариев, который и визуально отделит его от человекочитаемых комментариев, и покажет, в каком формате служебный комментарий написан (нет, аннотация в стиле markdown вида ```doxygen неудобна, хочется отделять чем-то вроде префикса --- на каждой строчке спец.коммента) и (2) препроцессоре служебных комментариев, который выбросит всё кроме целевого формата, чтобы в одном файле форматы сосуществовали по принципу 'перемешать, но не смешивать'.
И вот что-то такое специфическое попытался загуглить, и не нашёл. Интересует, (1) есть ли проекты под эту задачу, (2) есть ли субъективно удобная практика решения проблем разнородных комментариев иначе. Ну и наверное (3) где ещё можно на этот счёт поинтересоваться
ты хочешь сложный язык в комментариях сотворить чтоль ??
самописный скрипт с регекспом для выдергивания и использования инклюдов в комментах.
+ настройки отображения в любимый DE чтобы высветить или наоброт приглушить отобюражения данных хитроумных коментов.
...
профит ??
самописный скрипт запускать перед препроцессором при компиляциях.
Алексей Уколов, у меня rust/c/c++, но кажется история не зависит от языка. Скажем, то, что в rustdoc можно примеры кода делать частью юнит-тестов - точно встречалось где-то ещё, просто не помню где. Это не история про работу с AST. От ЯП как бы требуется только поддержка однострочных комментариев, а поддержка ЯП со стороны тулзы вроде doxygen - уже чуть другое.
pfg21, пока не сотворить, а взять готовую префикс-(или ещё какую 'визуально-отделимо-')ориентированную разметку и препроцессор. На первый взгляд, это вопрос договорённости и regex
