• last updated 3 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
Made startup more robust

- handle not-yet-defined callback procs gracefully

fix bug, when Tcl's file command uses uplevel

This change fixes a bug whem "ad_file tmpfile filename ..." is used.

The output variable "filename" was created on the wrong calling level.

remove constant from deprecated message

Configure nsf to keep init commands much earlier, so that we don't lose doc for nsf classes defined before xotcl-core is loaded

  1. … 1 more file 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.
new proc "ad_log_deprecated": unified interface for logging deprecated usages

The existing code used a larger variety of different messages to

denote invocations of deprecated procs and other

artifacts. "ad_log_deprecated" provides a unified interface, and

provides a usage hint what to use instead based on the API-doc

definitions in the log-file.

  1. … 11 more files in changeset.
Add @see to deprecated procs

Deprecate ad_apply, made obsolete in modern Tcl by the expansion operator "{*}"

  1. … 4 more files in changeset.
Document behavior

Whitespace cleanup

passing "-debug" flag explicitly to nsf::proc

Added support for trailing non-positional arguments

The change makes the old hack with the own trailing-argument-parser

"ad_arg_parser" obsolete by using directly the c-level argument parser

which is anyhow capable of handling trailing arguments. A few changes

were necessary for api doc to handle there trailing arguments as well.

The proc "db_string" is already converted to use native arguments.

  1. … 7 more files in changeset.
added a comment about the usefulness of ad_arg_parser

reduce the size of the public interface

  1. … 2 more files in changeset.
include package key in proc info

mark functions called only internally as private

  1. … 15 more files in changeset.
just avoid tilde substitution, do not perform sanitizing

sanitizing can lead to file name clashes in case the names

without tilde exists, and they are OS specific. The intention

of "ad_file" is just to be a tilde-proof "file" replacement

  1. … 1 more file in changeset.
Sanitize all trailing tildes from the filename, mapping them to the current folder

Fixes acs-bootstrap-installer.ad_file automated test

improve spelling

  1. … 4 more files in changeset.
allow value checkers in ad_procs

Prefer 'namespace which' over 'info commands', as it is faster (on local tests, around 2x) and returns a single value. Many thanks to Nathan Coulter.

  1. … 58 more files in changeset.
Treat callback hooks and implementations as private api

Reduce acs-tcl.documentation__check_deprecated_see test warnings

  1. … 2 more files in changeset.
introduced "ad_file" as a means to avoid unexpected tilde substitution in file names

  1. … 50 more files in changeset.
deprecate unused function

Restrict switches to not negative Tcl numbers, and avoid non-printable characters as well

Fix typo

Remove private proc 'number_p', used only in 'ad_proc_valid_switch_p', and simplify logic of the latter

Fixed bug while populating the 'api_proc_doc_scripts' nsv on ad_proc, where some procs where not added due to a race condition between the 'acs-automated-testing' and the 'acs-bootstrap-installer' packages. See comments in commit for more details.

improve spelling

  1. … 3 more files in changeset.