— В доке ошибки нет, она верно описывает API.
— Выбор названий методов в API очень спорный. Можно ожидать, что
open откроет на редактирование, а new сделает копию. Можно понять иначе: open только откроет картинку и не будет её редактировать.— Причина такого выбора может быть в том, что
new — это метод-конструктор. Он задаёт поведение по умолчанию.Чтобы не запутывать пользователя API, можно было бы дать методам имена, не связанные с их внутренней реализацией. Например,
copy и modify.Спасибо @dside_ru, что объяснил про конструктор.