• last updated 4 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
Consider documentation the presence of an author

fix comment of per_request_cache

  1. … 1 more file in changeset.
generalized handling of nx classes and objects not defined by OpenACS

  1. … 1 more file in changeset.
exclude more content provided from outside of OpenACS

exclude low-level slot classes

provide full link to entities with missing text documentation

remove objects and classes defined in NaviServer from the listing

reduced reported error cases by ~1500 by omitting slot objects

Rework array idioms

  1. … 1 more file in changeset.
merge from oacs-5-10

  1. … 8099 more files in changeset.
set error-level to warning for documentation__check_proc_testcase (similar to datamodel__named_constraints)

Add 'documentation__check_proc_testcase' test, for checking public procs without test cases. Many thanks to Monika Andergassen.

Allow square brackets in proc doc. In particular, this fixed a false positive with [doc_string] in 'ad_proc'

Improve 'args' check in 'documentation__check_parameters' test case by using the built-in 'varargs_p' variable.

Add 'args' parameter to the real parameter list of the 'documentation__check_parameters', as it is not included into 'switches' or 'positionals'.

Take care of '_p' boolean parameters when checking for discrepancies between real and documented proc parameters.

Overhaul of test cases:

- make tested API calls explict

- reduce dependency on twt

  1. … 18 more files in changeset.
Add new test case 'documentation__check_parameters', which checks if parameters defined in the proc doc (@param) are really proc parameters.

Sometimes proc parameter changes are not reflected in the proc doc, this should take care of some of these cases.

Remove apparent leftover + trailing whitespace

rework test case documentation__check_typos

- make test case more robust (don't abort tests when there is a proc_doc without a "main" section

- improve performance and sanity:

* move invariantes out of the loop

* use built-in hashes

* don't check the same term multiple times

... times went from >15 sec to <1sec

Add new test case 'files__trailing_whitespace', which looks for trailing whitespace (spaces or tabs at the end of lines).

Currently, only .tcl files are checked.

  1. … 1 more file in changeset.
Add more information about typos loaded and checks passed

Test refactoring

Improve test documentation.

Reduce test verbosity

Add new test case 'documentation__check_typos', which checks for spelling errors in the proc documentation.

The test uses a file containing common spelling errors (doc-check-procs-common-typos.txt), based in the one

provided by Debian's lintian, which can be found here: https://github.com/Debian/lintian/tree/master/data/spelling

The test can take some time, depending on the amount of packages and how powerful the machine is.

  1. … 1 more file in changeset.
improve testcases by removing useless expr commands

  1. … 5 more files in changeset.
merged changes from the oacs-5-9 branch and resolved conflicts

  1. … 7834 more files in changeset.
eliminating documentation__check_proc_interface_status, -public is not required

adds test for acs_object_type internal consistency, proc documentation, xql files, named constraints, acs_attributes internal consistency

    • -0
    • +78
    ./doc-check-procs.tcl
  1. … 3 more files in changeset.