>Пометь sxed_aatree_init_ex как служебную функцию
почему служебную? она не служебная. добавил туда камент, спасибо.

>Вот эту конструкцию я не пони:
это пояснение ко всей секции. "when complete" — это "when the walking is complete". спасибо, докинул каментов.

>// remove given range from the tree
>What's range?
ahem…
`sxed_aatree_delete (sxed_aatree *tree, uint32_t index, uint32_t size)`
там вот `size` не на что не намекает разве? ;-)

>Copypaste is baaaaad
ага. она вдобавок ещё и не используется нигде. надо бы удалить нахрен потом.

>Then I would be good to add _line_ as a separate noun in function name to clearly
>distinguish LI-tree API and other functions
неудобно печатать. и так имена неебической длины. но в принципе ты прав, конечно. ;-)

>Copypaste is baaaaad
ага, спасибо, убрал к хуям тоже. ;-)

(Reply to this) (Parent) (Thread)

>`sxed_aatree_delete (sxed_aatree *tree, uint32_t index, uint32_t size)`
>там вот `size` не на что не намекает разве? ;-)

Не-а, не намекает. Ну размер это чего-то. Тем более, судя по комментарию (// for non-pt tree types, `size` doesn't matter), этот размер относится к внутренностям ноды, а не к дереву.

(Reply to this) (Parent) (Thread)

и что он может значить кроме длины спана? я честно не в состоянии представить ни одного логического выверта, который позволит при виде слова «range» и аргументов «позиция, длина» — проинтерпретировать это как-то иначе, нежели «начало и длина оного range». а если кто-то таки да — то ему лучше никогда не пытаться использовать libsxed, там дальше всё ещё хуже. ;-)

(Reply to this) (Parent) (Thread)

Так я же тебе и продемострировал этот выверт: из коммента делается вывод, что к range относится только индекс, а size это только для специфичных внутренних данных. Вот и остаётся из аргументов только "позиция".

(Reply to this) (Parent) (Thread)

ну, вот в этом случае я не согласен, что это нормальный вывод. есть граница между «понятно» и «для не умеющих думать идиотов».

а вот про «size doesn't matter» — это баг документации. про который я уже протупил. убрал, спасибо. он везде матерс.

(Reply to this) (Parent)