Если у тебя на сране планируется только документация с указанной страницы, то это уг. Ты хоть что-то в ридми напиши. А вообще рекомендую pod2markdown, тогда документацию придется писать только в одном месте (коде).
Из ридми на пару предложений вообще не понятно, что за модуль и как он может кому-то пригодиться в жизни.

Не понятно, что такое _dop когда читаешь сверху вниз. Добавь хотя бы однострочный коммент чтобы было понятно.
В стр.54 для старых перлов нужно добавить явное определение sub _dop;
Ещё может сразу уйти от dclone?
В чём смысл: unless ( $cb_chainer ) {
 unshift @_, $promise; ? Что если то, что попало в $promise не умеет в then?
Типа async as {bless [13], "main"};

> unless ( $cb_chainer ) {
нужен для  того, что бы можно было не только промисы запихивать. Когда чейнишь промисы в then можно возвращать как thenable, так и простые значения. Этот случай как раз распространяет синтаксис на простые значения. Там в пределе вообще ни одного промиса может и не быть, при этом в качестве результата вернётся простое значение. Это довольно удобно при отладке (заменить шаг с созданием промиса на хардкодное значение).

Затем что перл добавляет определение функции только когда доходит до конца выражения. А у тебя _dop используется из неё же. Поскольку перл ещё не дошел до }, он не будет знать, что такое _dop

Затем что перл добавляет определение функции только когда доходит до конца выражения. А у тебя _dop используется из неё же. Поскольку перл ещё не дошел до }, он не будет знать, что такое _dop

Можешь показать пример. Что-то я не понимаю как вопрозвести проблему. Пытался так — работает https://perlbanjo.com/90aa6ad9dd

Не, даже в 5.005 перл сначала компилирует весь исходник. Не нужно, что бы процедура объявлялась выше места её использования.

Этого и не увидишь в современных версиях :)

Так а что вернет это?
async as {bless [13], "main"};

Но это же неправильно, карл!

оно сразу ругнётся, что надо хотя бы один await {} аргумент.

Не вижу, где это?

я пробовал на 5.8 — тоже не получислось поймать ошибку

в sub async { ... }

я пробовал на 5.8 — тоже не получислось поймать ошибку

в sub async { ... }

Единственный side-effect сейчас, думаю, это вот такой способ вызова: https://perlbanjo.com/38be7adf25
Попробуй закомменить forward declaration

Ку-ку :)
Так а что вернет это?
async as {bless [13], "main"};