Где найти толковый справочник по perl?

Question

[Андрей Кунцевич]

Подскажите хороший онлайн (или, что мало вероятно, оффлайн) справочник по perl.

В этом справочнике (в любом справочнике по языку программирования) должно быть:
Важное, полезное, лишнее.

1. Краткое описание
2. Полное описание
3. Развёрнутый синтаксис
4. Полное описание развёрнутого синтаксиса
5. Синоним/аналогичная запись
6. Примеры использования (код+результат)
7. Другие примеры использования (с другими условиями)
8. Ссылки на схожие/близкие по смыслу функции

Только не советуйте мне perldoc.perl.org!

Comments

[Андрей Кунцевич]

Почему perldoc.perl.org — плох:

функция push и док по ней для трёх языков программирования:
PHP на php.net

• Краткое описание
• Полное описание
• Развёрнутый синтаксис
• Полное описание развёрнутого синтаксиса
• Синоним/аналогичная запись
• Особенности использования (Notes)
• Примеры использования (код+результат)
• Комментарии пользователей с огромным количеством примеров использования в реальном коде и разбор их работы
• Ссылки на схожие/близкие по смыслу функции
• Версия ядра полностью поддерживающего данную конструкцию

JavaScript на w3schools.com

• Название и ссылка на описание объекта к которому относится данный метод (Array object)
• Краткое описание
• Пример использования (код+результат)
• Ссылка на лайв-демо
• Полное описание
• Особенности использования (Notes)
• Подсказки для особых случаев (Tips)
• Поддержка браузерами
• Синтаксис (более менее развёрнутый)
• Полное описание синтаксиса
• Другие примеры использования (с другими условиями) + ссылка на лайв-демо
• Версия ядра полностью поддерживающего данную конструкцию

perl на perldoc.perl.org

• Краткий синтаксис (одновременно с экспериментальным синтаксисом!)
• Описание синтаксиса
• Синоним/аналогичная запись
• Краткое описание нетривиального экспериментального синтаксиса
• Подсказка о формальном объявлении использования экспериментального функционала

Как видно, в справочнике perldoc.perl.org нету 3-х из 4-х критически важных элементов и 2-х из 3-х полезных. В придачу есть 2 лишних элемента, которые занимаю бОльшую часть справки. (по поводу того лишние они или нет можно много холиварить, пусть это будет имхо)
В итоге заходя на страницу perldoc.perl.org я сразу вижу портянку, которая по большей части относится к экспериментальному функционалу, ни одного примера использования и урезанный синтаксис. Более того — страница не разбита на смысловые блоки, по-этому приходится вчитываться в портянку просто ради того, что бы, к примеру, узнать тип возвращаемого значения!

Answer 1

[Александр Давыдов]

а кэмэл бук смотрели, не подходит?

Comments

[Андрей Кунцевич]

это книга а не справочник. я ищу именно справочник.

Answer 2

[vsespb]

Примеры использования (код+результат)

Примеры использования в push нет, потому что они не нужны. Он тривиален.
Здесь например, perldoc.perl.org/perlsub.html perldoc.perl.org/perlre.html есть примеры

Синоним/аналогичная запись

это были не синонимы, это спецификация. Именно по этому не нужны примеры.

Развёрнутый синтаксис

Полное описание развёрнутого синтаксиса

Если покажите мне развёрнутый синтаксис push, подскажу где найти (имею ввиду другие разделы perldoc).

Ссылки на схожие/близкие по смыслу функции

Он здесь perldoc.perl.org/index-functions-by-cat.html

на смысловые блоки, по-этому приходится вчитываться в портянку просто ради того,
что бы, к примеру, узнать тип возвращаемого значения!

Тип описан в первом же предложении.

Краткое описание нетривиального экспериментального синтаксиса

Я уверен что если бы статья была огромная, эсперементальный синтаксис отделили бы от основного.

Из других хороших ресурсов могу посоветовать www.perlmonks.org — задавайте вопрос — ответят. Или книгу Perl Best Practices. Есть ещё perldesignpatterns.com/ но это не по синтаксису.

Вообще если Вам нужно точно знать все ньюансы синтаксиса, лучше читать всё, а не куски на странице (относится к любому языку, но к Perl уж наверняка)

Answer 3

[BlackPie]

habrahabr.ru/post/25740/
Уверен это именно то что вам нужно

Comments

[Андрей Кунцевич]

К сожалению, Google Chrome не может найти страницу wdh.suncloud.ru

Да и если бы открыл… в посте коммент от 2008-го года «хороший справочник, жаль что давно не обновляется» боюсь что справочник который не обновляется более 5 лет не совсем то что мне нужно ):

Answer 4

[motl]

docstore.mik.ua/orelly/perl/cookbook/index.htm

Comments

[Андрей Кунцевич]

книгу с ламой я бы не пропустил. но это не справочник ):