nsf / library

lib

Clone Tools

Stats

Commits this week: 0
Total Committers: 6
Last Commit: 14 Oct
Commits this week: 0

Lines of code count not available

Commit Activity

Commits By Day In Week
52 week commits volume
Commits By Day In Week
Commits by day
Commits By Day In Week
Commits by hour
Commits By Hour In Day
Commit calendar
 

Most active committers (90 days)

loading
loading
  • last updated 4 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
Friday 10 Sep 2010
11:11 am

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- changed "info available" into "info lookup" (and accordingly c definitions, migration guide)

Options
    • -5
    • +5
    ./doc-tools.tcl
  2. … 14 more files in changeset.
Wednesday 08 Sep 2010
5:14 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Added support for companion documentation files (based on the file extension *.nxd) - Moved the nsf and nx documentation blocks in generic/predefined.nxd and library/nx/nx.nxd, respectively - Un-exported @param, provide two aliases @attribute and @parameter (in the respective contexts). - Changed the test suite and the two documentations to reflect the naming changes.

Options
    • -7
    • +7
    ./doc-assets/class.html.tmpl
    • -2
    • +2
    ./doc-assets/method.html.tmpl
    • -2
    • +2
    ./doc-assets/submethod.html.tmpl
    • -20
    • +43
    ./doc-tools.tcl
  5. … 5 more files in changeset.
12:36 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Added two new templates: method.html.tmpl and submethod.html.tmpl - Generalised the support for sub-commands and sub-methods, including a shortcut notation for tag lines. - Adding the special handling of initcmd blocks of attribute slots: They are processed as @param specifications of their owning (class) object. In a next step, I will limit this special handling to the first comment block only, while subsequent ones are evaluated in the context of the slot object itself. - Fixed an issue with cleaning up the processing-related mixin classes in the CommentBlockParser: As the nested notation of doc entities can conflict with relation slot forwarders (*::info::mixin vs. *::info mixin <add|delete>), I revert to using ::nsf::relation directly. - Fixed the default namespace resolution (still needs some review, once all use cases are figured out!) Changed nx and nsf documentation accordingly. - Add first doc text for Object->info() and its sub-methods (for testing purposes, merely) - Added an initial implementation for parsing level support. By introducing skipping axes into the tag notation (e.g., @..param), we can now differentiate between different scopes of applications for tags. This has a number of advantages: a) processing becomes more efficient (skip-level annotated tags can be identified early), b) we do not have maintain different tag labels for different parsing levels (e.g., @child-object vs. @object), ... - Parsing levels have to be maintained within the documentation processor and provided to the comment block parsers at work. This still has to be accomplished. - Adapted the naming scheme for qualifier tags (for now). Instead of "child" scopes, we coerce the entity names using namespace delimiters (this fits nested objects nicely) - Changed the resolution behaviour for dotted tag labels: Intermediate nodes (i.e., entities) are not allocated anymore, on the fly. Rather, it is a pure id resolution, except from the leaf element which is effectively initialised as a documentation entity. This has major implications: It requires partof entities to exist prior to any part entity. However, the id resolution work can later be reused when introducing the new tag notations into the link block markers in the templating engine (avoiding zombie and widely undescribed doc entities). - Started shifting id generation into part attributes (for the time being). Probably I will do so permanently to avoid the complexity in the various new() factories for doc entity types. - Adjusted the tests accordings and added many more on the navigatable tag notation. - Renamed EntityClass and PartClass into Tag and PartTag. The meta-class names so better reflect their purpose as entity factory classes, based on the tag notation scheme. Added a QualifierTag meta-class which marks tags (@class, @object, @command) which impose extra requirements when not being part of another entity (in particular, default namespace resolution). If not part of another entity, they represent *qualifying* language constructs, i.e. language constructs which help identify other elements (command -> subcommand, object -> nested object or method). - Started harmonising the entity class hierarchy (not ready cooked yet): Entity < StructuredEntity < ContainerEntity < @project < @method < @package < PartEntity < @object (@param) < @class < @command The most important change is that all entities (entity instances) can become parts, however, only a single entity class (@param) is critical about it.

Options
    • -67
    • +1
    ./doc-assets/class.html.tmpl
    • -3
    • +3
    ./doc-assets/command.html.tmpl
    • -0
    • +71
    ./doc-assets/method.html.tmpl
    • -0
    • +37
    ./doc-assets/submethod.html.tmpl
    • -173
    • +419
    ./doc-tools.tcl
  6. … 3 more files in changeset.
Saturday 04 Sep 2010
9:06 am

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- new flag for configure: "nx::configure checkarguments on|off" - turn off argument-checking for non-converters, when checking is off (per default, it is on) - extended regression test for optional argument checking

Options
    • -3
    • +3
    ./test.tcl
  2. … 8 more files in changeset.
Wednesday 01 Sep 2010
7:44 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- minor cleanup

Options
    • -1
    • +0
    ./doc-tools.tcl
  2. … 5 more files in changeset.
1:34 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- changed argument order on nsf::is to make it conformant with Tcl conventions - removed objectproperty, replaced it by ::nsf::is - move functionalizy of objectproperty to make "obj info is ..." more efficient

Options
    • -8
    • +8
    ./doc-tools.tcl
  2. … 13 more files in changeset.
11:18 am

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- fix editing

Options
    • -2
    • +2
    ./doc-tools.tcl
11:10 am

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- replaced argument order on objectproperty to make it conformant with Tcl conventions - updated migration guide

Options
    • -3
    • +3
    ./doc-tools.tcl
  2. … 11 more files in changeset.
1:00 am

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Replaced the former "exception" handling mechanism by a simplified one. This speeds up e.g. the generation of the current nx.tcl documentation by 15-20%. - Adjusted the tests for the modified CommentBlockParser interface. - Implemented a first version of the revised tagline notation. Changed the documentation in nx.tcl and predefined.tcl accordingly. - Discriminate between parsing simple and complex part entities. In the simple case, multi-line part sections are not allowed anymore. - Adopted the recent changes in the object introspection interfaces

Options
    • -10
    • +10
    ./doc-assets/entity.html.tmpl
    • -161
    • +164
    ./doc-tools.tcl
  3. … 3 more files in changeset.
Tuesday 31 Aug 2010
9:56 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- introduced ::nsf::isobject - replaced in all scripts "::nsf::objectproperty ... object" by isobject

Options
    • -6
    • +6
    ./doc-tools.tcl
    • -1
    • +1
    ./test.tcl
  3. … 13 more files in changeset.
Monday 30 Aug 2010
2:34 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Refactoring templating code: Separated generic and backend-specific templating behaviour into distinct classes: BaseTemplateData and NxDocTemplateData. Rewrote the getter logic for the @doc strings to retrieve different representations (as_text() and as_list()). - Multi-line block markers: To achieve this, I moved the handling of block markers into the template data classes. - Adjusted the tests for the changes ...

Options
    • -9
    • +9
    ./doc-assets/class.html.tmpl
    • -6
    • +6
    ./doc-assets/command.html.tmpl
    • -1
    • +1
    ./doc-assets/package.html.tmpl
    • -161
    • +182
    ./doc-tools.tcl
  5. … 2 more files in changeset.
11:29 am

Gustaf Neumann <neumann@wu-wien.ac.at>

- removed some deubug output

Options
    • -1
    • +1
    ./test.tcl
10:55 am

ssoberni <stefan.sobernig@wu-wien.ac.at>

Temporarily fixed an issue with cleaning up comment section states set on an entity object. This needs to be improved and to be made more robust!

Options
    • -4
    • +24
    ./doc-tools.tcl
  2. … 1 more file in changeset.
Thursday 26 Aug 2010
5:10 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Added an experimental gathering facility for part objects, relative to a given entity object. It returns a [dict] which allows to reuse the parts gathered throughout the templates rendering process. - Moved the process=@* methods to the doc object (this increases the cohesion). - Adjusted the current documentation artifacts for the changes (@object -> @class where applicable).

Options
    • -14
    • +55
    ./doc-assets/class.html.tmpl
    • -15
    • +12
    ./doc-assets/entity.html.tmpl
    • -8
    • +25
    ./doc-assets/package.html.tmpl
    • -104
    • +146
    ./doc-tools.tcl
  5. … 2 more files in changeset.
5:10 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Renamed the existing object.html.tmpl to class.html.tmpl and fix it to reflect class features. Providing an object-only template remains to be done. - Added an experimental gathering facility for part objects, relative to a given entity object. It returns a [dict] which allows to reuse the parts gathered throughout the templates rendering process. - Moved the process=@* methods to the doc object (this increases the cohesion). - Adjusted the current documentation artifacts for the changes (@object -> @class where applicable).

Options
    • -0
    • +264
    ./doc-assets/class.html.tmpl
    • -264
    • +0
    ./doc-assets/object.html.tmpl
Wednesday 25 Aug 2010
10:41 am

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Started separating the documentation into four documentation projects, each with its own documentation artifact: nsf (predefined.tcl), nsl/nx (nx.tcl), xotcl (xotcl2.tcl), libraries (several?). - Removed documentation blocks from gentclAPI.decls - Added default namespace resolution for documentation entities. @project and @package can now specify a default namespace which is applied to all relative (not fully qualified) entity names. This avoids the redundant writing of longish qualified entity names. As a @project may contain several @packages, multiple default namespaces can be specified. - Added a distinct @class entity family. - @project and @package can now trace the creation of specified part entities (@class, @object, @command) to be structurally linked to them. - Fixed search box support for @command views - Excluded template files from output directories

Options
    • -0
    • +3
    ./doc-assets/api.css
    • -1
    • +17
    ./doc-assets/command.html.tmpl
    • -4
    • +4
    ./doc-assets/entity.html.tmpl
    • -91
    • +213
    ./doc-tools.tcl
  5. … 5 more files in changeset.
Tuesday 24 Aug 2010
12:43 am

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- changed requireNamespace to "require namespace" in lib/make.tcl

Options
    • -1
    • +1
    ./make.tcl
Monday 23 Aug 2010
2:54 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- implemented experimental delegating version of "object as method" that keeps the original self.

Options
    • -3
    • +4
    ./test.tcl
  2. … 8 more files in changeset.
Friday 20 Aug 2010
5:24 pm

Gustaf Neumann <neumann@wu-wien.ac.at>

- changed __invalidateobjectparameter from a method of class to framework primitiv ::nsf::invalidateobjectparameter

Options
    • -1
    • +1
    ./test.tcl
  2. … 5 more files in changeset.
5:11 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

Fixed some more [info callable] occurrences

Options
    • -2
    • +2
    ./doc-tools.tcl
2:05 pm

ssoberni <stefan.sobernig@wu-wien.ac.at>

- Accomplished major rewrite and cleanup of the comment block parser. The revised design allows us to express parsing states (context, description, part) as well as their substates reflecting the comment line processed (tag, text, space) directly. The design follows a METHODS-FOR-STATES strategy. Also, the parsing logic is now self-contained and is not interwoven with the class hierarchy documentation entities anymore (i.e., the former process() method of Entity and its subclasses). - The modal/reactive design of the comment block parser has been streamlined: There is a CommentBlockParser class which acts as the event source. The actual parsing is achieved by the mixin-refined entity objects by reacting upon the parsing events (process, parse, next). - Adjusted the tests in doc.tcl accordingly. - Changed occurrences of [info callable] to reflect the latest changes.

Options
    • -449
    • +360
    ./doc-tools.tcl
  2. … 1 more file in changeset.
Thursday 19 Aug 2010
2:19 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- renamed "info method name ..." into "info method handle ...", since it returned already the handle - renamed ListMethodName() to ListMethodHandle() - changed output of "info callable -which ..." from definition to method handle - renamed "info callable -which ..." into "info callable method ..." - updated regression test to reflect the changes

Options
    • -2
    • +2
    ./doc-tools.tcl
  2. … 13 more files in changeset.
Friday 13 Aug 2010
2:50 pm

Gustaf Neumann <neumann@wu-wien.ac.at>

- use testfile name as additional prefix in test reports

Options
    • -3
    • +4
    ./test.tcl
Thursday 12 Aug 2010
7:44 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- made the "next scripting laguage" a own, loadable tcl package (currently named nx, name is subject of change) - predefined.tcl is now pretty minimal.

Options
    • -1
    • +1
    ./doc-assets/object.html.tmpl
    • -26
    • +26
    ./doc-tools.tcl
    • -1
    • +1
    ./make.tcl
    • -1
    • +1
    ./test.tcl
  5. … 29 more files in changeset.
Wednesday 11 Aug 2010
1:01 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- changed more self/current

Options
    • -5
    • +5
    ./make.tcl
  2. … 1 more file in changeset.
12:57 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- added interp alias "nx::self" to "nx::core::current method" - changed "current proc" into "current method" in scripts and tests

Options
    • -2
    • +2
    ./doc-tools.tcl
  2. … 10 more files in changeset.
Tuesday 10 Aug 2010
7:59 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- xotcl.c: * new function GetObjectFromNsName() to obtail object or class from a fully qualified namespace name used in method handles (such as e.g. ::nx::core::classes::X) * new function MethodHandleObj() to return a tcl_obj containing the methodhandle * removed obsolete method getFullProcQualifier() * info methods obtain now object and/or class from fully qualified method names (method handles) if possible * return message handles in "current next", "current filterreg" and "... info filter ... -order", which can be used in "info method .... " for obtaining more details. * change all occurrances of "self" in next regression tests to current. - xotcl2.tcl * implemented "self" as a proc to provide extensibility and full backward compatibilty; this opens opportunity to replace now e.g. "self proc" by "current method", etc. * provide full compatibility for "self next", "self filterreg" and "... info filter ... -order", returning old-style multiword method handles (such as e.g. "::C instproc foo") - changed "next" to current in documentation framework and templates

Options
    • -3
    • +3
    ./doc-assets/entity.html.tmpl
    • -22
    • +22
    ./doc-tools.tcl
    • -4
    • +4
    ./test.tcl
  4. … 17 more files in changeset.
Sunday 08 Aug 2010
7:03 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- created own directory structure xotcl under library containing doc, tests, apps, lib etc. and moved obvious content here. - adjusted regression test and old documentation system to work with new structure

Options
    • -40
    • +0
    ./Script.xotcl
    • -677
    • +0
    ./htmllib.xotcl
    • -109
    • +0
    ./makeDoc.xotcl
    • -505
    • +0
    ./metadataAnalyzer.xotcl
    • -98
    • +0
    ./mixinStrategy.xotcl
    • -150
    • +0
    ./package.xotcl
    • -1
    • +0
    ./pkgIndex-package.add
    • -12
    • +0
    ./pkgIndex.tcl
    • -82
    • +0
    ./staticMetadata.xotcl
    • -289
    • +0
    ./trace.xotcl
    • -52
    • +0
    ./upvarcompat.xotcl
    • -51
    • +0
    ./wafecompat.tcl
    • -410
    • +0
    ./xodoc.xotcl
    • -812
    • +0
    ./xotcl2.tcl
  15. … 391 more files in changeset.
12:44 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- added redefine-protected to the object template - added methodtype to object template - some documentation updates - some indentation/spacing improvements on xotcl.c - let ".... info method .... METHOD" return values, when METHOD contains namespace prefix. This can be used to obtain the parmeter definitions from nx::core - get forward definition from the original command

Options
    • -5
    • +12
    ./doc-assets/object.html.tmpl
    • -13
    • +40
    ./doc-tools.tcl
  3. … 4 more files in changeset.
Saturday 07 Aug 2010
1:32 pm

Gustaf A. Neumann <neumann@Gustaf-A-Neumanns-iMac.local>

- added @properties and has_property to the documentation classes. Current primary purpose: define, which methods are internally-called - added interanlly-called to the method object template

Options
    • -0
    • +4
    ./doc-assets/object.html.tmpl
    • -5
    • +12
    ./doc-tools.tcl
  3. … 3 more files in changeset.