МИ
ну эт понятно:)
"это надо код глазами парсить, где там функция, где описание"
точно тут есть проблема? мне кажется что все очень наглядно:
https://github.com/bessarabov/Moment/blob/bbfe6142230a45e91ecb9f97fa2b2d620450788c/lib/Moment.pm#L898-L903
Size: a a a
2021 October 07
МИ
Попробовал упоминавшийся выше Pod::Simple::HTMLBatch
Обходит рекурсивно без дополнительных телодвижений, но результат — не связанные файлы. Каждый файл сам по себе.
Обходит рекурсивно без дополнительных телодвижений, но результат — не связанные файлы. Каждый файл сам по себе.
МИ
ну не, сравните — https://metacpan.org/pod/Pod::Simple::HTMLBatch
МИ
нужна не мешанина с кодом, а только дока, в концентрированном, так сказать, виде
IB
А все-таки, кто потрбитель этого вида? Кому нужно читать POD к функцим не не видеть самих функций? (видимо, не программисты — им-то все-таки код тоже нужен)
МИ
И читать её, кстати, могут не только программеры.
Может читать, условно, менеджер, который знает, что есть некие "действия" (мы внутри знаем, что это функции). Читать и говорить: "Сидоров, а вот действие Х отправляет письмо, давай-ка в это письмо добавим скрытую копию мне".
Может читать, условно, менеджер, который знает, что есть некие "действия" (мы внутри знаем, что это функции). Читать и говорить: "Сидоров, а вот действие Х отправляет письмо, давай-ка в это письмо добавим скрытую копию мне".
IB
Очень сомневаюсь что так будет работать =)
МИ
Да и программистам код не обязательно видеть. Достаточно знать, что функция Х принимает емейл и шлёт письмо. Код не важен для использования.
МИ
Нормально работает, только сейчас мне приходится вручную каждый модуль экспортировать.
IB
Дока на публичное API и POD — это разные вещи
МИ
Что вы называете публичным API? мне именно POD нужно экспортнуть
IB
Раз работает — отлично, тогда не слушай меня =)
МИ
ну метаспан изобразить как бы
IB
Можно на "ты", пожалуйста?
МИ
без нахлобучек, конечно:) только документацию показывать.
IB
Тот POD который я обычно вижу — это штука написанная программистами для программистов (часто написанная плохо, часто не написанная, а часто устаревшая).
Давать это не программистом мне кажется странной идеей, но раз вы говорите что это работает — тогда ок =)
Давать это не программистом мне кажется странной идеей, но раз вы говорите что это работает — тогда ок =)
МИ
Я серьёзно отношусь к документации и, в том числе, к понятному литературному изложению
МИ
Cтараюсь, по крайней мере:)
МИ
Люди меняются, и если что-то не записано — привет реверс-инжиниринг.