Ответ
silverbeam28 04.03.2008 17:59
Все-таки отвечу на 2-4 абзацы Вашего высказывания.
1) Если документации читать по принципу учебника ("сверху-вниз", из начала в конец), то всю жизнь можно провести за их чтением.
Почему именно хеш? Потому что здесь используется не обычная форма записи переменной в виде $variable, а вариант создания хеша
прямо в вызове метода. Этот случай, конечно, описан в соответствующем разделе, но при этом слабо представляется практическое применение такой конструкции.
2) То, что Вы считаете "примером плохого подхода в программировании", имеет практическое применение и, наоборот, упрощает создане кода, а также его понимание в определенных случаях (возможно, я скоро расскажу в каких, если к тому времени сам не разочаруюсь в такой конструкции).
3) Конечно, здесь вы абсолютно правы. Но в современной документации по парсеру перекрестных ссылок явно не достает. А скорее, проблема скрыта даже не в этом, а в недостатках логической структуры документации. Так, например, отсутствует полноценный раздел по работе с БД. Информацию приходится собирать по частям: из уроков, из разных классов, из приложений и даже из примеров, не входящих в документацию.