Shmuel wrote: ↑Sun 23 Jul, 2017 17:56Это как понимать?
Очень просто: нет кнопки "следующий (как в формате hlp, например). Нет возможности читать подряд (как в формате pdf).
Короче, мануал удобен в формате pdf. А формат chm больше именно помощь. Есть разница.
Shmuel wrote: ↑Sun 23 Jul, 2017 17:56Простой поиск regex в этом мануале немедленно выдаёт все вхождения.
Я ж не спорю. НО! Для этого надо было знать, что из трёх (!!!) chm=файлов надо было искать именно в luafar_manual.chm.
Снова. В этом каталоге три (!) файла chm с похожей информацией. Чтобы найти, в каком смотреть, я в ФАРе перехожу в этот каталог и жму AltF7 (поиск файла); в искомой строке пишу regex. Файла luafar_manual.chm среди результатов поиска нету. Откуда я должен был знать, что именно в нём описана эта библиотека? Тем более, что в оглавлении указано не regex, а LuaFAR Far libraries -> Regular expression functions. А внутри есть ещё подраздел regex.new, в котором почему-то повторно описаны те же самые функции. Видимо, для разработчиков слово new что-то означает. Для меня они - все new! А, как выяснилось, это - другая библиотека. А функции библиотеки string тоже работают с некими регулярными выражениями; просто не стандарта PERL, а другого (своего, Lua, наверно; не знаю). Поэтому оглавление Regular expression functions - это ни о чём. В оглавлении надо указывать именно имя таблицы.
Вообще сгруппированы топики в документации как-то совсем странно. Например, функции таблицы far раскиданы по нескольким группам (т.е., сгруппированы по функционалу), а аналогичные по функционалу функции таблиц Far, mf, Edit и т.д. - описаны вообще в другом документе! Простому человеку этого не понять.
Может, имеет смысл сгруппировать описания функций по таблицам? А при наличии похожих функций в других библиотеках делать ссылку "см.
также"? Пример - string.find, regex.find и mf.index . Понятно, что стандартную библиотеку string Вы описывать не будете никогда. Но ссыль-то можно дать - типо пусть юзер сам смотрит
Shmuel, мы углубились в обсуждение документации. Просто наболело, но меня уже предупредили за оффтопик. Не смертельно, но неприятно. Так что продолжение банкета - либо в форуме про документацию, либо в отдельной теме.
buniak_a_h wrote: ↑Sun 23 Jul, 2017 18:46Так что продолжение банкета - либо в форуме про документацию, либо в отдельной теме.
Продолжения банкета с моей стороны не будет. По моему пониманию, кто хочет учиться - учится, а кто не хочет - жалуется на несовершенство документации и прочую неидеальность нашего мира.
buniak_a_h wrote: ↑Sun 23 Jul, 2017 16:46И из чего тут видно, что окно, созданное функцией far.Message, закроется?
из того, что при отсутствии кнопок никакого окна не создаётся, а просто рисуется текст поверх всего, соответственно перерисовка всех окон, удаляет то, что просто нарисовано.
util: это префикс, принадлежащий скрипту Script utils, правильнее обсуждать там.
По сути вопроса: проблему не понял, и у меня не воспроизводится в актуальной версии фара.
(Если продолжать обсуждение, то в соответствующей теме)
Last edited by John Doe on Tue 17 Oct, 2017 14:13, edited 1 time in total.