Энциклопедия: улучшение раздела о макросах

Здесь обсуждается всё, что касается макросов.
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Latest post of the previous page:

Skirda wrote:2. свой писать - а надо ли?
Свой писать не надо. По крайней мере то о чём писал я предполагает поиск только по существующему индексу.
Skirda wrote:3. можно в принципе разделить апи и макросы, но я изначально хотел, чтобы Писание рассматривалось не просто как Help по апи... а нечто большее.
Ну совсем разделять не надо. Только лишь добавить отдельную ссылку для быстрого попадания в раздел макросов.
Skirda wrote:4. автоматический индекс - ХЗ, можно сделать.
Он как бы почти есть, строится для chm.
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

Предлагается изменение для раздела Переменные. Сейчас:
Из этой области FAR считывает глобальные переменные при старте.
На самом деле:
Из этой области FAR считывает глобальные переменные при старте либо при вызове плагина "Просмотр макрокоманд".
Я так вижу, кстати, что мои наработки для этого раздела, описанные и обоснованные, в основном пропали втуне... :(
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:На самом деле:...
Не надо путать причину со следствием.
Raistlin wrote:Я так вижу, кстати, что мои наработки для этого раздела, описанные и обоснованные, в основном пропали втуне... :(
О чём вы?
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

John Doe wrote:Не надо путать причину со следствием.
Уф... Вы не согласны с тем, что для считывания занесенных вручную в реестр глобальных переменных нет необходимости перезапускать Far? Чего к словам-то цепляться, не пойму никак...
John Doe wrote:О чём вы?
О том, что даже "10-ричная константа" на месте. Не говоря уже о прочем.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:Чего к словам-то цепляться, не пойму никак...
К словам нужно цепляться, в противном случае смысл меняется на обратный.
Да, замечание ваше дельное, но формулировка негодная.
Raistlin wrote:О том, что даже "10-ричная константа" на месте. Не говоря уже о прочем.
А куда торопиться? У нас тут довольно длительный цикл разработки. Посмотрите на дату первого сообщения темы. А те изменения вошли в svn только на днях.

А вот если вы решите типографику править, то тут другое дело, думаю Валентин сразу внесёт.
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

John Doe wrote:К словам нужно цепляться, в противном случае смысл меняется на обратный.
Да, замечание ваше дельное, но формулировка негодная.
Такая уж негодная? Плагин в стандартной поставке. Нам шашечки или ехать?
Пока я не наткнулся случайно на указанный факт, перезапускал-таки Far для перечитывания глобальных переменных. Я один такой :dyatel: ?
Raistlin wrote:А куда торопиться? У нас тут довольно длительный цикл разработки. Посмотрите на дату первого сообщения темы. А те изменения вошли в svn только на днях.
Н-да... Я тут как раз про svn читаю. Он вроде как раз и предназначен для коллективного труда над материалами - не стоит ли либерализовать процесс внесения изменений, ведь откатить назад всегда можно?
Я не за то, чтобы "разрушить и новый мир построить", но вот наглядная ситуация. Если делать, как было посоветовано, diff'ом, что править - то, что уже отредактировано, или то, что лежит на svn?
Raistlin wrote:А вот если вы решите типографику править, то тут другое дело, думаю Валентин сразу внесёт.
Решить-то я решил, но на всё сразу времени не хватает. И опять-таки - на странице "Переменные" типографику мне, выходит, опять править надо будет.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:Такая уж негодная?
Абсолютно.
Raistlin wrote:Пока я не наткнулся случайно на указанный факт, перезапускал-таки Far для перечитывания глобальных переменных. Я один такой :dyatel: ?
Я где-то в одном месте уже вставлял замечание насчёт macro:load. Видимо надо упомянуть и MCMD_LOADALL. Но тут я сам не берусь сформулировать: однако, програмист нужен.
Raistlin wrote:Н-да... Я тут как раз про svn читаю. Он вроде как раз и предназначен для коллективного труда над материалами - не стоит ли либерализовать процесс внесения изменений, ведь откатить назад всегда можно?
Доступ к свн только у нескольких провереных товарищей. У меня кстати нет, но я не считаю это препятствием.
Raistlin wrote:Если делать, как было посоветовано, diff'ом, что править - то, что уже отредактировано, или то, что лежит на svn?
Типографику? То что на свн.
А когда закончите, то надо будет проверить какие страницы за это время поменялись, и при необходимости переделать их.
И только после этого svn diff.
Raistlin wrote:Решить-то я решил, но на всё сразу времени не хватает. И опять-таки - на странице "Переменные" типографику мне, выходит, опять править надо будет.
А что на странице Переменные?
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

John Doe wrote:Абсолютно.
Значит, все же шашечки.
John Doe wrote:Я в одном месте уже вставил замечание насчёт macro:load.
Я не знаю, в каком месте ты это вставил, - факт тот, что там, где речь о глобальных переменных, нет никаких замечаний - ни твоих, ни негодных.
John Doe wrote:Доступ к свн только у нескольких провереных товарищей.
Я это и предполагал. Только вот оправдано ли это, в частности, для Энциклопедии? Вандалов тут вроде нет, все люди взрослые.
John Doe wrote:
Raistlin wrote:Если делать, как было посоветовано, diff'ом, что править - то, что уже отредактировано, или то, что лежит на svn?
Типографику? То что на свн.
Я не про типографику, а про значимые изменения. Допустим, кто-то решил внести вклад и дополнить статью о переменных. Дополнил, используя svn как основу. Что после этого сделать с моими наработками, опубликованными выше? Правильно, подтереться ими.
John Doe wrote:А когда закончите, то надо будет проверить какие страницы за это время поменялись, и при необходимости переделать их.
Авторы идеи CVS аплодируют.
John Doe wrote:А что на странице Переменные?
А на странице Переменные я уже однажды типографику правил. Да, вместе с другими правками, не по правилам, выходит, но их (другие правки) вроде никто не оспорил. Хотя, конечно, никто и не обязан их читать вообще - они ведь даже не на svn, где по ним можно пробежаться глазами "по пути", а где-то здесь, в дебрях темы. У кого тут лишнее время есть в чужих наработках копаться? Замкнутый круг.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:Я не знаю, в каком месте ты это вставил, - факт тот, что там, где речь о глобальных переменных, нет никаких замечаний - ни твоих, ни негодных.
Естественно. Надо добавить, в виде примечания.
Raistlin wrote:Только вот оправдано ли это, в частности, для Энциклопедии?
Даже если раздавать права на запись Энциклопедии, то явно не всем.
Raistlin wrote:Что после этого сделать с моими наработками, опубликованными выше?
Вы переоцениваете свой пока ещё не внесённый вклад.
Пока правил я, несколько страниц тоже обновились, но мне почему-то не составило труда интегрировать изменения.
Raistlin wrote:У кого тут лишнее время есть в чужих наработках копаться?
Судя по всему у меня.

P.S.
И переменные я тоже поправлю, пользуясь вашими предложениями (вероятно не всеми).
Патч мне для этого не понадобится, не надо переживать.
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

John Doe wrote:Даже если раздавать права на запись Энциклопедии, то явно не всем.
Все их и не захотят иметь. Это не виши и не баги - прямой пользы от правок Энциклопедии тому, кто правит, нет.
John Doe wrote:
Raistlin wrote:Что после этого сделать с моими наработками, опубликованными выше?
Вы переоцениваете свой пока ещё не внесённый вклад.
Не нужно читать у меня между строк то, чего там нет. Свои наработки я привел только в качестве примера.
John Doe wrote:Пока правил я, несколько страниц тоже обновились, но мне почему-то не составило труда интегрировать изменения.
Из этого не следует, что такой подход - правильный. Уверен ли ты, что авторы изменений полностью удовлетворены тем, как ты их интегрировал?
John Doe wrote:
Raistlin wrote:У кого тут лишнее время есть в чужих наработках копаться?
Судя по всему у меня.
Вот и выходит, что, несмотря на отсутствие доступа на запись на svn, ты вершишь судьбу Энциклопедии.
Я не спорю, курирование необходимо, однако право отозвать изменения, если они негативны, - это одно, а полномочия решать, что из предложенного использовать, а что - нет, - это другое. Впрочем, не знаю, может, народу нравится именно второй подход.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

John Doe wrote:Из этого не следует, что такой подход - правильный. Уверен ли ты, что авторы изменений полностью удовлетворены тем, как ты их интегрировал?
Уверен на 100%, а если бы сомневался, то не постеснялся бы спросить.
Если есть более правильный подход - сам с удовольствием возьму на вооружение.
John Doe wrote:Вот и выходит, что, несмотря на отсутствие доступа на запись на svn, ты вершишь судьбу Энциклопедии.
Так вперёд, присоединяйся, и тоже начинай вершить её судьбу, вакансий ещё достаточно.

В общем, я опытом поделился сполна, принимать его на вооружение или нет - навязывать не могу.
Maximus5
Posts: 3295
Joined: Sun 11 Nov, 2007 02:03
Been thanked: 10 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by Maximus5 »

Хорошо, конечно, что теперь указано
Для строковых функций: нумерация символов в строке начинается с 0 (см. index(), rindex(), substr()).
но все-таки в самом низу страницы этому примечению не место.
Может это замечание передвинуть сразу после заголовка Строковые функции?
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

Maximus5 wrote:Хорошо, конечно, что теперь указано
Для строковых функций: нумерация символов в строке начинается с 0 (см. index(), rindex(), substr()).
но все-таки в самом низу страницы этому примечению не место.
Может это замечание передвинуть сразу после заголовка Строковые функции?
На мой взгляд, ему место в описании каждой функции. И там, где нумерация начинается с 1, тоже нужно так и написать.
Про других не знаю, а я, открыв страницу с функциями, ищу нужную мне и читаю именно ее описание. Не найдя полной информации, я скорее начну экспериментировать "на кошках", чем метаться по странице в поисках дополнительных замечаний.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:На мой взгляд, ему место в описании каждой функции.
Я против, т.к. это не даёт общей картины, и создаёт впечатление будто в разных функциях элементы могут нумероваться по-разному.
Raistlin wrote:И там, где нумерация начинается с 1, тоже нужно так и написать.
Все элементы в макроязыке, вообще все, за исключением строк, нумеруются с единицы.
Стоки являются единственным исключением, это на мой взгляд ничем не оправданно, и лишь способствует путанице.
Maximus5 wrote:Может это замечание передвинуть сразу после заголовка Строковые функции?
Но тогда логично и в прочих разделах подвинуть аналогичные замечания. Возможно.
Maximus5
Posts: 3295
Joined: Sun 11 Nov, 2007 02:03
Been thanked: 10 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by Maximus5 »

В области "Свойства и функции для работы с диалогами" отсутсвует "Dlg.Info.Id"
User avatar
John Doe
Бюрократ
Posts: 13851
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Также отсутствуют callplugin(), mmode(2,), window.scroll().
Не описана работа с "точными строками" (verbatim strings).
Post Reply

Return to “Обсуждение макросов”