Пишу, скажем, миграцию на создание функции.
/* вот этот коммент съедается и не попадает в DDL */
-- и этот тоже
create or replace function ... language pgplsql as $$
declare
...
begin
/** вот этот-то комментарий вполне сохраняется и в базе, и в дампе, так что его можно использовать как docblock /*
end;
$$
Вопрос в том был, знает ли кто-то существующие инструменты, которые этот докблок выкусывают :) Регэкспы я и сам могу.