update usage; add comments where needed