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

Здесь обсуждается всё, что касается макросов.
Post Reply
User avatar
John Doe
Бюрократ
Posts: 13855
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:

В энциклопедии таких таблиц со значениями индексов десятки/сотни, неужели вы предлагаете каждый раз всё ломать?
Ради чего?
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

В энциклопедии, которая, по идее, предполагает самодостаточность, многие вещи пояснены недостаточно подробно. Сейчас приходится при освоении языка постоянно экспериментировать. Например, для APanel.ItemCount не указано, считается ли ".." за item. Интуитивно вроде догадываешься, что да, но для верности всё равно пробуешь. Это неправильно.
Выше была дискуссия по поводу выделения буленовых свойств в отдельную таблицу. Аргументов в пользу такого подхода, кроме того, что у них "несколько другой способ использования", не было. Развивая эту мысль, можно разделить на отдельные таблицы также string- и number-свойства... В общем, считаю, что в одной таблице было бы лучше.
Не лишним было бы раъяснение понятий "boolean", "number" и "string" (на отдельной странице хелпа) и ликбез на тему "как комбинировать значения типа number".
Мыслей на тему "как лучше" появляется много, есть смысл кидать их сюда? Если да, то в каком виде?
Magically yours
Raistlin
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

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

Post by Skirda »

Raistlin wrote:В энциклопедии, которая, по идее, предполагает самодостаточность, многие вещи пояснены недостаточно подробно.
Не вижу проблем :)
Видишь неточность - можешь исправить/дополнить - Wелкам!
We are the Borg. You will be assimilated.
So Say We All!
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Потому и спросил, в каком виде кидать идеи. Так:

Code: Select all

Раздел: Макроязык | Свойства и функции: по областям | Для панелей
Сейчас: содержит количество файловых объектов на панели
Предлагаю: содержит количество файловых объектов на панели (включая "..")
или сначала diff изучить?..
Magically yours
Raistlin
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Раздел: Макроязык | Свойства и функции: по областям | Для панелей
Замечание "Префикс APanel. относится к активной панели, PPanel. к пассивной" лучше указать однажды вверху страницы, а не повторять после каждой таблицы. И лучше написать:

Code: Select all

Префикс APanel. относится к активной панели, PPanel. — к пассивной
Magically yours
Raistlin
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

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

Post by Skirda »

Raistlin wrote:Потому и спросил, в каком виде кидать идеи.
Это где?
Лучше указывай к чему это замечание относится, а еще лучше дифом к текущей ревизии (если не к текущей, то укажи ключи -c -p для diff, что бы было понятно)
We are the Borg. You will be assimilated.
So Say We All!
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Skirda wrote: Это где?
Здесь:
Raistlin wrote:Мыслей на тему "как лучше" появляется много, есть смысл кидать их сюда? Если да, то в каком виде?
Skirda wrote: Лучше указывай к чему это замечание относится, а еще лучше дифом к текущей ревизии (если не к текущей, то укажи ключи -c -p для diff, что бы было понятно)
Эх, где бы время еще и на освоение diff выкроить...
Magically yours
Raistlin
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

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

Post by Skirda »

начни с простого :-)

Code: Select all

diff.exe -c -p old new > result.diff
We are the Borg. You will be assimilated.
So Say We All!
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Skirda wrote:еще лучше дифом к текущей ревизии (если не к текущей, то укажи ключи -c -p для diff, что бы было понятно)
Текущая - это та, что в посте John Doe, или та, что идет с ночной сборкой?
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13855
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

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

Post by John Doe »

Текущая эта та что на svn, она же идёт с ночной сборкой.
Моя версия пока не вошла в svn, хотя пора бы ;-)

Только что подготовил RC6
  • Внесены последние изменения из svn
  • Улучшено описание panel.item
  • "Каталоги" и "директории" заменены на "папки" (как принято в хелпе фара)
  • Всё валидизировано, найденые опечатки исправлены
User avatar
John Doe
Бюрократ
Posts: 13855
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

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

Post by John Doe »

Raistlin wrote:Потому и спросил, в каком виде кидать идеи. Так:

Code: Select all

Раздел: Макроязык | Свойства и функции: по областям | Для панелей
Сейчас: содержит количество файловых объектов на панели
Предлагаю: содержит количество файловых объектов на панели (включая "..")
или сначала diff изучить?..
Идеи можно в любом понятном виде. Выше - не очень понятно, т.к. вы не указали что за функция/свойство, и в каком файле.
В идеале давать прямую ссылку, это будет возможно после того как мои правки водут в svn.

Теперь по сути: вы предлагаете изменить описание только лишь свойства APanel.ItemCount, тогда как на самом деле это уточнение касается и ряда других свойств/функций.
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

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

Post by Skirda »

RC6 - можно заливать?
We are the Borg. You will be assimilated.
So Say We All!
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:Выше - не очень понятно, т.к. вы не указали что за функция/свойство, и в каком файле.
Теперь по сути: вы предлагаете изменить описание только лишь свойства APanel.ItemCount, тогда как на самом деле это уточнение касается и ряда других свойств/функций.
По названию раздела там очевидно, что имелся в виду именно RC, ну, а в разделе поиск дает только одно вхождение. А APanel.ItemCount просто с ходу под горячую руку попался :) .
P. S. Меня можно на "ты", надеюсь, это взаимно :wink: .
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13855
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

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

Post by John Doe »

Skirda wrote:RC6 - можно заливать?
Да.
Raistlin wrote:По названию раздела там очевидно [...]
Есть разница между "очевидно" и "можно разобраться немного поковырявшись".
А горячиться не надо, лучше выдавать уже как следует обдуманные предложения. Мы ж никуда не торопимся ;-)
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

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

Post by Skirda »

RC6 в svn`е
We are the Borg. You will be assimilated.
So Say We All!
Max Rusov
Posts: 3651
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Has thanked: 2 times
Been thanked: 19 times

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

Post by Max Rusov »

Э, что-то раздел о макросах на сайте совсем нечитаемый стал :( Что-то не срослось, однако.
Post Reply

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