Add tables listing functions with user or internal progress

Issue #134 wontfix
Amir Kamil created an issue

In the 9/12/18 developer meeting, we resolved to add a table listing the calls that can make user-level progress. We may also want a table of the calls that can make internal-level progress.

Comments (4)

  1. Amir Kamil reporter

    PR #49 adds lists of functions with user and internal progress.

    However, I don’t think this change is worthwhile. It introduces a new point of maintenance without much benefit.

  2. Dan Bonachea

    I agree the proposed table/index doesn't seem worth the effort to maintain. We already very clearly annotate the progress level of each function, and it's easy enough to search for ": user" in the document to identify the user-level progress points. I also can't think of any reason why the presence or absence of internal-level progress should ever matter to a correctly written program - it's basically informational rather than semantically prescriptive.

    As agreed verbally, we are shelving this idea. The work-in-progress from pull request #49 is preserved in tag issue-134-tocloft-progress-list (1673612), in case we ever decide to pick it up again.

  3. Log in to comment