added JavaDoc comments to some controller methods