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

Здесь обсуждается всё, что касается макросов.
User avatar
Tim Sobolev
Posts: 714
Joined: Fri 01 Apr, 2005 14:46
Location: Украина
Has thanked: 1 time
Been thanked: 2 times

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

Post by Tim Sobolev »

Latest post of the previous page:

Вариант изменения русской версии раздела о макро-функциях редактора.
Обновлены текущие функции работы с закладками.
User avatar
Raistlin
Posts: 731
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

John Doe wrote:Большая загадка откуда взялись абсолютные ссылки.
Я сохранил в Firefox'е страницу с svn. Вот и все. Ссылки вообще не трогал.
John Doe wrote:Абсолютно ни к чему мимоходом переформатировать длинные строки: это затрудняет восприятие содержательных изменений.
Что конкретно ты имеешь в виду? Да, я объединил это:
Целочисленные константы: NNN - 10-ричная константа, 0NNN - 8-ричная константа, 0xNNN - 16-ричная константа.
Целочисленные константы 64-разрядные.
и это:
Глобальные переменные можно записывать в специальную область Vars.
Из этой области FAR считывает глобальные переменные при старте.
в единые абзацы, потому что речь идет в них об одном и том же: о целочисленных константах и глобальных переменных, соответственно.
John Doe wrote:Менять регистр там, где вы не понимаете зачем он такой, не надо. По всей энциклопедии ссылка на главную страницу с маленькой буквы, а одной статье значит будет с большой?
Тут более уместен другой вопрос: а почему везде она с маленькой? Ссылки рядом - с большой.
John Doe wrote:Кроме того, сопровождайте патч описанием и обоснованием предлагаемых правок, в противном случае никто ваши патчи расшифровывать не станет.
Что-то ты (или вы, я уж не знаю) слишком суров(ы). А Валентин говорил - "welcome!" Я, конечно, вовсе не против описывать и обосновывать правки, но уж какая-то слишком скептическая реакция на труды :( .
Итак, что было сделано:
  • Исправлен кое-где стиль изложения. Описывать это подробнее - значит работать человеческим аналогом diff'а, ну да ладно. В частности, выброшено слово "вам" из первого предложения, объединены строки про именование переменных (ибо фактически одно и то же, переписанное дважды), "двойной точности 64-разрядные" поменены местами (потому как "64-разрядные" - более общий признак).
  • Создан новый раздел про присвоение значений с собственным (IMHO полезным) замечанием по поводу начального значения.
  • Слова "десятиричный" в русском языке нет. "Восьмиричный" и "шестнадцатиричный" - есть, но "ричный" само по себе бессмысленно, поэтому писать цифрами "8" и "16", по меньшей мере, спорно, а уж рядом с "десятичный" (не "10-чный" же!) и вовсе некрасиво смотрится.
  • Косметика: дефисы поменял на тире, прямые кавычки - на "елочки". Но предложения с ними надо переписывать, потому что непонятно, о чем речь идет. Мне, по крайней мере, вам, программерам, и так ясно, не сомневаюсь.
Может, что и забыл... Но, в конце концов, есть diff или нет? Читаем исходник, применяем мою правку, читаем полученный результат. Есть возражения - пишем. Или так только юпитерам позволено править?.. Что-то я не видел такого подробного отчета для RC.
John Doe wrote:И лучше даже не патч приложить, а готовый vars.html
Во-первых, мне движок вообще ничего приложить не дал, вы внимательно читаете или как? Во-вторых, diff разве не позволяет получить мой же html?
Мне не жалко, расскажите, как, приложу html.
Last edited by Raistlin on Fri 14 Jan, 2011 21:51, edited 1 time in total.
Magically yours
Raistlin
User avatar
HaRT
Moderator
Posts: 9658
Joined: Tue 30 Aug, 2005 17:21
Location: Санкт-Петербург
Has thanked: 119 times
Been thanked: 245 times

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

Post by HaRT »

Raistlin wrote:Что-то ты (или вы, я уж не знаю), слишком суров(ы). А Валентин говорил - "welcome!" Я, конечно, вовсе не против описывать и обосновывать правки, но уж какая-то слишком скептическая реакция на труды :( .
Они не со зла. :-)
На самом деле спасибо Вам большое за Ваш труд по улучшению „Писания”!
Фар есть инструмент, а не нянька. © 2009 DrKnS
User avatar
Raistlin
Posts: 731
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Skirda wrote:ненужно заниматься переформатированием - пусть это будет привелегия одного-двух человек :-)
Видишь ли, переформатирование - это изменение ширины колонок и разработка стилей. Все остальное - это такие же важные правки, как исправление орфографических ошибок или добавление пояснений. Пример я дал выше - с объединением абзацев.
John Doe wrote:Самое страшное, что скорее всего это не было сознательным изменением...
Необходимо перепроверять собственные патчи.
У меня есть привычка, занимаясь чем-то, вылизывать результат до конца. Поэтому позволю себе утверждать, что "несознательных" изменений, видимых в html, в моем варианте нет. За все готов отвечать.

А все-таки, как присоединить файл к сообщению? Не иначе, быкам (носорогам :) ) не позволено...

HaRT, спасибо за поддержку! :beer:
Magically yours
Raistlin
User avatar
Raistlin
Posts: 731
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Skirda wrote:Конвертация...
1. В реестре у тебя была целочисленная переменная "a" типа REG_DWORD (4 байта)
2. Ты вызвал msave, что бы ее сохранить. В результате у тебя в реестре эта переменная стала типа REG_QDWORD (8 байт)
Гм... Хотел спросить: "А зачем?" - но оказалось, что сначала надо выяснить: "А как?" Ибо:

Code: Select all

macro:post %%b=1; msave("%%b");
создает в реестре параметр типа QWORD. То есть "законным" путем получить записанную в реестр глобальную переменную в виде DWORD нельзя, или я что-то не так делаю/понимаю? Это во-первых. Во-вторых, всё-таки - а зачем? Чтобы я народу объяснил :) .
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13003
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 40 times
Been thanked: 310 times

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

Post by John Doe »

Raistlin wrote:Что-то ты (или вы, я уж не знаю) слишком суров(ы).
Ты/вы не важно, мне удобней вы, тебе ты - пожалуйста.
Raistlin wrote:А Валентин говорил - "welcome!" Я, конечно, вовсе не против описывать и обосновывать правки, но уж какая-то слишком скептическая реакция на труды :( .
И я говорю welcome!
Никакой скептической реакции по поводу содержательную стороны правок и быть не могло, поскольку я её даже не касался.

Описание нужно, поскольку зачастую всё не так просо как кажется.
Raistlin wrote:Что-то я не видел такого подробного отчета для RC.
А вы перечитайте тему: RC6, соответственно есть 6 отчётов. Последний невелик, ибо изменения в нём минимальны (чего не скажешь о предыдущем).

Патчи прошу не делать, потому как у вас это получается не очень, и даже прямо указанных ошибок не видите. Но это не проблема, патч это всего лишь дело техники, а главное содержание.
Raistlin wrote:
John Doe wrote:И лучше даже не патч приложить, а готовый vars.html
Во-первых, мне движок вообще ничего приложить не дал, вы внимательно читаете или как?
Сарказм я оставлю без ответа, а по поводу аттачей всё просто: надо архивировать.
Raistlin wrote:Во-вторых, diff разве не позволяет получить мой же html?
В том-то и дело.
Но повторюсь, это не проблема, патч я и сам сделаю.
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 4 times

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

Post by Skirda »

Raistlin wrote:То есть "законным" путем получить записанную в реестр глобальную переменную в виде DWORD нельзя, или я что-то не так делаю/понимаю? Это во-первых. Во-вторых, всё-таки - а зачем?
внутренняя реализация (числа в макросах) - __int64. смысл их держать в двордах?
We are the Borg. You will be assimilated.
So Say We All!
User avatar
Raistlin
Posts: 731
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:А вы перечитайте тему: RC6, соответственно есть 6 отчётов. Последний невелик, ибо изменения в нём минимальны (чего не скажешь о предыдущем).
Это я все видел и масштабы твоей работы оценил - бесспорно, теперь пользоваться энциклопедией гораздо удобнее :good: .
John Doe wrote:Патчи прошу не делать, потому как у вас это получается не очень, и даже прямо указанных ошибок не видите.
Как Skirda сказал, так я и сделал... Не пойму только, это из-за моего неумения пользоваться diff'ом, или что-то принципиально не так сделал, когда добывал исходник? Если не затруднит, приведи, пожалуйста, алгоритм в двух словах.
John Doe wrote:по поводу аттачей всё просто: надо архивировать.
Пробовал 7z- и zip-форматы - безуспешно. Или после попытки "атаки" движок насторожился и решил пресекать все мои аттачи?

Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13003
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 40 times
Been thanked: 310 times

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

Post by John Doe »

Raistlin wrote:Это я все видел и масштабы твоей работы оценил
Я не о масштабах работы, а о наличии детального списка изменений.
Raistlin wrote:Не пойму только, это из-за моего неумения пользоваться diff'ом, или что-то принципиально не так сделал, когда добывал исходник?
С диффом всё в порядке, а вот с исходником да:

Насчёт переформатирования:

По поводу регистра:

P.S.
Да, под спойлером вполне можно поместить html, но желательно обрамить в <code>, иначе что-то может потеряться.
User avatar
Raistlin
Posts: 731
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Хорошо, тогда предлагаю:
  • Писать ссылку на главную страницу с большой буквы.
  • Использовать длинное тире (Alt-0151) и "елочки" (Alt-0171 / Alt-0187).
Теперь по существу. Из описания APanel.OPIFlags:
0x00000020 используется стандартная обработка файла FAR'ом, если запрошенная операция не поддерживается плагином; если этот флаг указан, элементы на панели плагина являются именами реальных файлов
Network Browser тоже выставляет этот флаг, хотя оперирует не файлами, а NetBIOS-именами и шарами. Вероятно, надо править описание, флаг, я так понимаю, выставляется верно.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13003
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 40 times
Been thanked: 310 times

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

Post by John Doe »

Raistlin wrote:Хорошо, тогда предлагаю:
  • Использовать длинное тире (Alt-0151) и "елочки" (Alt-0171 / Alt-0187).
Поддерживаю. Берётесь повсюду расставить тире, дефисы, ёлочки и лапки?
Raistlin wrote:Из описания APanel.OPIFlags:
Да, описание неплохо бы поправить, а то немного не по-русски.
Особенно "запрошенная операция не поддерживается плагином".
User avatar
Raistlin
Posts: 731
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Берусь. Исходники брать с svn или кинешь архивом сюда (памятуя про абсолютные ссылки)?

Верно ли я понимаю, что при выставленном флаге плагин самостоятельно операциями с объектами не занимается, а отдает их на откуп FAR'у?

О, вот еще суперпринципиальный вопрос. Far или FAR? В Энциклопедии - FAR, в заголовке самого Far'а - соответственно, Far.
Magically yours
Raistlin
User avatar
DrKnS
Posts: 5789
Joined: Thu 04 Aug, 2005 06:44
Location: Kyiv
Has thanked: 10 times
Been thanked: 333 times

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

Post by DrKnS »

Raistlin wrote:
0x00000020 используется стандартная обработка файла FAR'ом, если запрошенная операция не поддерживается плагином; если этот флаг указан, элементы на панели плагина являются именами реальных файлов
Network Browser тоже выставляет этот флаг, хотя оперирует не файлами, а NetBIOS-именами и шарами. Вероятно, надо править описание, флаг, я так понимаю, выставляется верно.
Править писание не надо. Network Browser ставит этот флаг, чтобы на шарах можно было делать AltF6.
User avatar
Raistlin
Posts: 731
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

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

Post by Raistlin »

Что значит - не надо? Я, следуя Писанию, создал макрос, который обрабатывает файлы SetACL'ом. Проверяю "файловость" значением флага. И получаю ерунду.

Не "именами реальных файлов", а "объектами файловой системы, NetBIOS-именами, именами разделяемых сетевых ресурсов". Да, тупо перечисление, если кто не придумает лучшего пояснения. Может, еще что забыл...
Last edited by Raistlin on Sat 15 Jan, 2011 12:46, edited 1 time in total.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13003
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 40 times
Been thanked: 310 times

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

Post by John Doe »

Raistlin wrote:Берусь. Исходники брать с svn или кинешь архивом сюда (памятуя про абсолютные ссылки)?
Брать с svn, с помощью svn-клиента. Любого, например SlikSVN, либо CollabNet Subversion Command-Line Client (для скачивания необходима зарегистрация. В инсталлятор пихают много лишнего).
Если хочется GUI, то TortoiseSVN.

Работы там , поэтому рекомендую править по частям (например разделами). Ведь одновременно кто-то другой может внести какие-то изменения.

Ничего другого попутно править не надо, лучше потом отдельным патчем.
Raistlin wrote:О, вот еще суперпринципиальный вопрос. Far или FAR? В Энциклопедии - FAR, в заголовке самого Far'а - соответственно, Far.
Ещё есть документация в дистрибутиве, и сам хелп фара.
Я бы не трогал.
Игорь Юдинцев
Posts: 725
Joined: Sun 03 Apr, 2005 22:00
Location: Казань
Been thanked: 2 times

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

Post by Игорь Юдинцев »

Raistlin wrote:О, вот еще суперпринципиальный вопрос. Far или FAR?
Наверное, FAR — аббревиатура всё-таки.
Post Reply

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