• last updated 1 hour ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
Improvded API browser documentation for NX methods

- Include NX content from acs* packages in online documentation

- determining source files where classes are defined

- extending type information for postional an non-positional arguments in API browser

  1. … 3 more files in changeset.
improved robustness (when fno flags for a parameter are present in the nsc)

provide more type information, factor out common code

    • -29
    • +44
    ./acs-api-documentation-procs.tcl
prettify rednderung for underspecified parameters

fixed broken HTML and make rendering more compact

ease future use of styling by introducing api-doc-parameter-list

    • -19
    • +25
    ./acs-api-documentation-procs.tcl
merge with missing files

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

    • -182
    • +303
    ./acs-api-documentation-procs.tcl
    • -1
    • +699
    ./test/acs-api-browser-procs.tcl
  1. … 8097 more files in changeset.
silence log entries during regression test

    • -15
    • +29
    ./test/acs-api-browser-procs.tcl
  1. … 1 more file in changeset.
improved variable naming

    • -12
    • +13
    ./test/acs-api-browser-procs.tcl
claim indirect proc coverage

Always use "--" in "dom parse" when document is interpolated

This is a safety measure to make sure that the document parsed is

never confused with an option, when the document starts with a "-". In

the best case, the error message provided by "dom parse" might be

misleading. This might be a problem for user contributed documents

(passed as variables, or return values from functions).

The double dash is supported in tdom since version 0.9.0.

  1. … 18 more files in changeset.
reduce verbosity

  1. … 1 more file in changeset.
improved Tcl9 compatibility

avoid redirect

whitespace changes

    • -14
    • +14
    ./acs-api-documentation-procs.tcl
Fixed potential infinie loop when source code looks like an regexp call

The api-code prettifier contains several heuristics for prettifying

source code without being a proper parser. It contains a

"Hack for nasty regexp stuff" which could run potentially into an infinite

parsing loop. This change fixes an acutal bug on openacs.org for file [1]

which is site-local.

[1] https://openacs.org/api-doc/procs-file-view?path=packages/xowf/tcl/openacs-procs.tcl&version_id=5526548&source_p=1

fixed typo

  1. … 4 more files in changeset.
do not abbreviate tcl command names (file root -> file rootname)

reduce verbosity

  1. … 4 more files in changeset.
Properly escape "<" and ">" in api-doc documentation.

Since all documentation is rendered via HTML, the characters

"<" and ">" have to be HTML-quoted, otherwise strange things

(omission, unintended renderings) might occur.

E.g. the sentence

Define an interface between a page and an

ADP <include> similar to the page_contract.

was rendered as

Define an interface between a page and an

ADP similar to the page_contract.

which is incorrect.

  1. … 13 more files in changeset.
improving rendering in api-doc

- fixed validity of HTML (missing <dd>)

- use

<dt>foo</dt><dd>...</dd>

instead of

<dt><b>foo></b><dd>...</dd>

and other variants. This improves stylability.

    • -29
    • +29
    ./acs-api-documentation-procs.tcl
Fixed calling info in call-graph, marked verbose test as "stress"

generalize collection of compiled template artefacts

Fix typo

Make xotcl-core optional in the api-browser

include DB interface classes in API-doc

Display the actual smell in the test

New test to detect smells of hacking in the code, raising a warning when certain smelly keywords are found

fix broken regression test

VS: ----------------------------------------------------------------------