вторник, 27 ноября 2007 г.

Так что там с нашим хэлпом?

Заметка была написана давно, да как-то не было времени выложить сюда. Актуальность её несколько утрачена, но, тем не менее, опубликую - не пропадать же добру =)

До третьего Update хелпом от 2007 – ой Delphi пользоваться было очень тяжело. Сейчас в нем многое поправили, но все – равно, нет-нет, да и наткнешься на липовую ссылку или отсутствие раздела. Хотя больше всего претензий вызывает скорость работы. Понятно, конечно - в деле используется более прогрессивная оболочка от Майкрософт с возможностью онлайн поиска, настраиваемым дизайном и интеграцией в инфраструктуру MSDN. Однако и ресурсов лопает этот Document Explorer от души. Вот специально запускаю его, потыкал пару кнопок, поискал пару топиков – почти 60 метров ОЗУ (Рам + виртуалка) и 25 потоков. «Наше прогрессивное средство не для слабаков!», - решил Майкрософт. «Ага!» – согласился CodeGear. – «И устанавливаться этот хелп должен также прогрессивно долго!». Действительно, пожалуй, самой длительной операцией при инсталляции Delphi теперь является установка, регистрация и настройка хелпа. Так долго, что можно поседеть и состарится. Зачем явился миру новый формат справки для Delphi - понятно. Не один десяток компаний пошел ко дну, отказавшись смотреть в рот Майкрософт. Но слепое следование мэйнстриму всегда имеет две стороны – либо мегамонстр все равно пропихнет свое детище, как было с IE, или комьюнити проигнорирует неудобные ему инновации, как произошло, например, с RAMBUS. Эх, знать бы прикуп…

Идем дальше. Замечательная фенечка «Фильтр». Казалось бы, выбираем нужный раздел, например, Language Delphi и получаем справку по Delphi… и С++. Тоже самое – если выбрать фильтр с С++. Ясно, конечно, откуда ноги растут. Справку от седьмой версии никто не переписывал – просто преобразовали в новый формат, как смогли и прикрутили к новому интерфейсу. Со времен семерки утекло много воды, кое-что изменилось, кое-какие классы и разделы добавились, но там вообще полный мрак: многие ссылки не работают, описание скудно или просто отсутствует, некоторые топики присутствуют в хелпе декларативно, для галочки. Технический писатель к ним даже не подступался. Только пронесся тупой генератор, подгоняемый переменной цикла, и создал несколько дежурных разделов и замечательное по своей информативности примечание: «Это класс TSuperpuperClass». Как будто я и сам этого не вижу =).

К чести CodeGear, по другим топикам фильтр наконец-то заработал нормально. Но так как файлы справки огромны – переключение между режимами первое время происходит раздражающе долго. Контекстный поиск по этой причине также предательски задумчив. Так что если вы запаслись быстрым винтом и двумя гигами памяти, то проблем быть не должно. Остальным следует тренировать свое терпение. Слава богу, что Delphi – система с открытым исходным кодом, пожалуй, одна из самых древних и живучих на платформе Win, поэтому многие вопросы можно решить, просто посмотрев исходные тексты модуля.

Из положительного следует отметить то, что было устранено ошибочное открытие нескольких файлов справки, когда они скушивали всю оставшуюся не тронутой BDS (ну, вы понимаете) физическую память, и работать было просто невыносимо. Также, судя по логам, пофикшено много других ошибок в документации. Но, как любит поговаривать Билл Гейтс – «Нам ещё есть над чем работать».

Есть в планах у CodeGear и желание русифицировать хелп, как это сделано для немецкого, французского и японского. Может быть это и нужно, но для начала хотелось бы привести хелп в разряд «достаточно хорошего», если не выходит сделать просто хороший.

Внимательный читатель спросит: «так в чем же соль этого затянувшегося эссе?» Мораль проста: опять приходится шаманить. Кто-то, использует сразу два хелпа. Старый – от семерки, если хочет найти что-то быстро. Новый, если старый не помог. Кто-то молчаливо терпит или юзает что-нибудь экзотическое типа PDF или HTML - хелп. Ну и самый правильный способ втихаря предлагает сам CodeGear для тех, кто не согласен с мейнстримом и ведет себя вызывающе. Это стандартный chm файл для Delphi 2007. Дешево и сердито. И как вы сами можете посмотреть – первое место в рейтинге по скачиванию (не считая интерактивного туториала пятилетней давности). Ну и стоило ли городить огород?

P.S. С момента написания заметки произошли изменения - появилось обновление хелпа, которое можно скачать тут

1 комментарий:

Анонимный комментирует...

Здравствуйте! Спасибо вам за ваш блог. Очень нужный!