View Issue Details

IDProjectCategoryView StatusLast Update
0003771WishesMacropublic2020-02-04 08:41
ReporterJohnDoe Assigned To 
PrioritynormalSeverityminorReproducibilityN/A
Status newResolutionopen 
Platformx86OSWindowsOS VersionXP SP3
Product Version3.0 
Summary0003771: Функции BM.* не полностью адаптированы при переходе на Lua
DescriptionПричина: исходная информация из Энциклопедии изначально не полна.

1. Возвращаемое значение описано только для Stat и Get, однако остальные 9 функций также возвращают значения: 0/1, означающие успех или неудачу (*которые тоже нуждаются в документировании).
Для Lua было бы логично использовать true/false
Исключение: BM.Get при вызове с несуществующим индексом возвращает -1 (для Lua логично было бы false)

2. Значения возвращаемые BM.Get сейчас переводятся в Lua с базой 1.
Однако BM.Get(idx,3) на самом деле возвращает не номер строки (как ошибочно указано в Энциклопедии), а смещение, а значит в этом случае значение должно остаться с базой 0.
Альтернативно, можно исправить саму функцию (чтобы действие соответствовало задокументированному).
http://bugs.farmanager.com/view.php?id=2745
Additional Informationhttps://api.farmanager.com/ru/macro/macrocmd/prop_func/editor.html#bm.push
Tagsbookmarks
Build

Relationships

related to 0002745 new Encyclopedia EditorBookmarks: неточность в описании ScreenLine 

Activities

shmuel

2020-02-03 13:14

developer   bugnote:0016730

Last edited: 2020-02-03 13:15

Все BM-функции относятся к макро-API. Когда они создавались, макросы не имели доступа к API плагинов. Сейчас ситуация другая - можно пользоваться функциями editor.AddSessionBookmark, editor.ClearSessionBookmark и т.д.

Мне возиться с библиотекой BM не слишком интересно, не уверен, что займусь.
Вот если бы вы поисследовали соответствующие функции из LuaFAR, для меня было бы более актуально.

JohnDoe

2020-02-04 07:57

updater   bugnote:0016731

Last edited: 2020-02-04 08:41

Мне возиться с библиотекой BM не слишком интересно, не уверен, что займусь.

shmuel
Сам я раньше вообще избегал этого апи по причине слишком большого количества "особенностей".
В любом случае, небесполезно иметь описание этих особенностей на мантисе, хотя бы для того чтобы знать, как их обойти.

Вот если бы вы поисследовали соответствующие функции из LuaFAR, для меня было бы более актуально.

shmuel
Это уже сделано, но результат неутешительный: LuaFAR-апи сейчас годится только для простейшего сценария: запомнить позицию, что-то сделать, и восстановить позицию.
Плюс, баг упомянутый в описании, касается и LuaFAR апи: https://bugs.farmanager.com/view.php?id=2745

P.S.
Все тикеты я объединил общим тагом https://bugs.farmanager.com/search.php?tag_string=bookmarks

shmuel

2020-02-04 08:13

developer   bugnote:0016732

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

Issue History

Date Modified Username Field Change
2020-01-30 15:51 JohnDoe New Issue
2020-01-30 15:51 JohnDoe Tag Attached: bookmarks
2020-01-30 15:51 JohnDoe Relationship added related to 0002745
2020-02-03 13:14 shmuel Note Added: 0016730
2020-02-03 13:15 shmuel Note Edited: 0016730
2020-02-04 07:57 JohnDoe Note Added: 0016731
2020-02-04 08:03 JohnDoe Note Edited: 0016731
2020-02-04 08:13 shmuel Note Added: 0016732
2020-02-04 08:41 JohnDoe Note Edited: 0016731