Improve documentation (explain how changed-flag of capabilities is supposed to be used)