nsf

Clone Tools
  • last updated 9 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
- minor cleanup

- make sure to load the local version of the old XOTcl documentation toolkit

    • -2
    • +2
    /library/xotcl/library/lib/makeDoc.xotcl
    • -1
    • +1
    /library/xotcl/library/lib/xodoc.xotcl
- added strnstr emulation for installations without having it

- new printf-style error message generator: NsfPrintError() - simplified error handling: removed NsfVarErrMsg() and NsfErrMsg() and replaced it by NsfPrintError()

- fixed bug with required last object parameter without provided value - extended regression test

    • -1
    • +14
    /library/xotcl/tests/slottest.xotcl
- apply allowempty only on list, and not to elements

- fix a few typos in TODO

- introduced a few forms of multiplicty * 0..1 allow empty value * 0..* list, can be empty (equivalent to 0..n) * 1..* list, cannot be empty (equivalent to 1..n) - deprecate multivalued in parameter specs in favor of multiplicty - deprecate allowempty in parameter specs in favor of multiplicty - adjust regression test

- make "... info children ?pattern?" compliant with XOTcl 1; if pattern contains no wildcard and is no absolute path, nsf completes it. (eg. Object create o; Object create o:x; o info children x" will return ::o::x) - extended regression test

- quote name of referenced parameter in error message to ease reading - new parameter checker "parameter", performing an approximate checking for valid parameter specs - set NSF_ARG_CHECK_NONPOS only when there are multiple arguments - remove space checking for NSF_ARG_CHECK_NONPOS in favor of parameter checker

- minor cleanup

- provide a generic logging interface * predefined for plain Tcl and aolserver/naviserver * C-level: NsfLog() * Tcl-level: ::nsf::log

- Fixed some naming confusion around @class-object-method - Completed statusmark support down to the @param level - method parameter definitions are now pre-processed during tracing; see ::nx::doc::paraminfo - Continued the pinfo/pdata-based refactoring

    • -21
    • +26
    /library/lib/doc-assets/method.html.tmpl
- xotcl2.tcl: fix the default init handler - nsf.c: provide warnings when unchecked parameter values might conflict with nonpos args

- nsf.c: aquire parameter structure for returns more lazyly (otherwise, a serializer handling returns would aquire the structure for every argument) - extend regression test

Merge branch '2.0.0-develop' of ssh://alice.wu-wien.ac.at/usr/local/src/git-repo/xotcl into 2.0.0-develop

- xotcl2.tcl: cleanup of forward implementation - xotcl2.tcl: provide debug version of default init method

- nx.tcl: cleanup of forward implementation

- Fixed an issue when accessing partly initialised NsfParamDefs (created e.g. by [::nsf::methodproperty ... returns]) from [info method] subcommands, previously leading to invalid memory accesses. Added a test to tests/returns.test. - Minor correction: xotcl2's method_handle_to_xotcl was not aware of the change to "class-object" as scope modifier.

- NSDeleteChildren: delete objects before classes - NSDeleteChildren: delete here aliases as well - fix potential crash when "next" is called from a non-proc frame.

- fixed bug in xotcl 2.0 "info forward" - extended regression test

Accomplishments: - Completed a first version of the sandboxed (partial) evaluation of Tcl source artifacts (packages, script files, C extensions) based on a dedicated child/slave interp environment: see ::nx::doc::Sandbox; the test suite and the test documentation builts run on it. - Based on this infrastructure, we can now generate a snapshot of a program's structure to be documented (and contrast it to the explicitly documented structure). - Added simplistic css sprites for visualising the doc entity status (extra, missing, mismatch, complete); see also library/lib/doc-assets/status.svg and library/lib/doc-assets/status.png - The entity status is printed optionally along with the print name of an entity - Added switch-like parts to represent properties of doc entities: @deprecated, @stashed, @c-implemented, @syshook. The implementation and use of ::nx::doc::SwitchAttribute should be reviewed after having figured out how to proceed using "switching" objparams. - I provide a multi-property dispatcher as doc-syntactic sugar and for mere convenience: @property

Various:

- Corrected some div-boxing mess in the templates

- Added a filtered helper to process entity collections

- Made the mixin layer infrastructure more symmetric (a revoke operation).

- Added tracers for ::nsf::method and ::nsf::alias (remains to be completed)

- Renamed ::nx::doc to ::nx::processor and turned it into another

mixin layer to trace the doc entity creation in e.g. readin()

- Companion (*.nxd) files: Revised the handling of companion

files. Temporarily moved generic/nsf.nxd in the top-level

directory. We need to find a permanent place as its location is

currently derived from the location of the shared extension. A

candidate is doc/ but this is not linked to the shared extension

location at all.

- processor.readin() now returns a collection of entities created

during its execution.

- Improved robustedness and orthogonality: destroy hooks; the

tag-dispatcher can now handle empty comment lines; when placing NSF

object tracer, we now use the freshly added introspection of an

object system's method aliases.

    • -7
    • +5
    /library/lib/doc-assets/class.html.tmpl
    • -1
    • +1
    /library/lib/doc-assets/entity.html.tmpl
    • -3
    • +4
    /library/lib/doc-assets/method.html.tmpl
    • -3
    • +5
    /library/lib/doc-assets/package.html.tmpl
    • binary
    /library/lib/doc-assets/status.png
    • -0
    • +405
    /library/lib/doc-assets/status.svg
    • -331
    • +1007
    /library/lib/doc-tools.tcl
- Converted migration guide to asciidoc - Overhaul of serveral sections in asciidoc - Developed styles for nx for migration guide (.css and source-highlight)

    • -1484
    • +3695
    /doc/next-migration.html
    • binary
    /doc/next-migration.txt
- Don't allow to call objects as methods (for the time being) via absolute names

- fix typo

- follow Tcl nameing convention (uppercase functions)

- make handling of redefinitions in system methods more robust

- improve robustness of varresolver for unconfigured objects

Merge branch '2.0.0-develop' of ssh://alice.wu-wien.ac.at/usr/local/src/git-repo/xotcl into 2.0.0-develop

Conflicts:

TODO

- Fixed switching between INACTIVE_MIXIN frames to ACTIVE_MIXIN frames - Extended regression test