Да, соглашусь, что это не самое удачное и полное описание. Можно было бы переписать аннотацию полностью, но это будет уже не совсем авторская версия.