nsf / library / lib

doc-assets

Clone Tools

Stats

Commits this week: 0
Total Committers: 2
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 10 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
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
    ./class.html.tmpl
    • -6
    • +6
    ./command.html.tmpl
    • -1
    • +1
    ./package.html.tmpl
  4. … 3 more files 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
    ./class.html.tmpl
    • -15
    • +12
    ./entity.html.tmpl
    • -8
    • +25
    ./package.html.tmpl
  4. … 3 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
    ./class.html.tmpl
    • -264
    • +0
    ./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
    ./api.css
    • -1
    • +17
    ./command.html.tmpl
    • -4
    • +4
    ./entity.html.tmpl
  4. … 6 more files in changeset.
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
    ./object.html.tmpl
  2. … 32 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
    ./entity.html.tmpl
  2. … 19 more files in changeset.
Sunday 08 Aug 2010
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
    ./object.html.tmpl
  2. … 5 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
    ./object.html.tmpl
  2. … 4 more files in changeset.
Friday 06 Aug 2010
8:40 pm

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

- renamed mk_predefined.xotcl -> mk_predefined.tcl - renamed predefined.xotcl -> predefined.tcl - additional subcommand "info method parametersyntax <methodname>" returns parameters in a syntax similar to the tcl man pages - added ability to pass syntax for forwarded methods via set ::nx::core::signature(::nx::Object-method-forward) (experimental) - fixed documentation system to work with actual version - added undocumented methods for quality control in documentation - added checks for documented, but unavailable methods in documentation - added comparison of documented parameters vs. actual parameters in documentation

Options
    • -5
    • +5
    ./command.html.tmpl
    • -16
    • +20
    ./object.html.tmpl
  3. … 16 more files in changeset.
Thursday 29 Jul 2010
2:18 pm

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

- I created a first draft of the nx language manual, based on the new next::doc facilities. It is still incomplete, but demonstrates the use of next::doc for authoring code documentation.

To re-create the language reference (which is not yet integrated into

the build environment), run:

./nextsh tests/doc.xotcl

You will then find an output directory "NextLanguageCore" in your

/tmp/ directory.

- The next::doc comments which are sourced for generating the manual

can be found in generic/gentclAPI.decls and

generic/predefined.xotcl. I tried to add most comments to the

former, as the complexity of the predefined script does not comfort

documentation comments (and vice versa).

- Applied many fixes to the templates (based on the needs of the

language reference)

Options
    • -1
    • +1
    ./ac-js
    • -7
    • +11
    ./command.html.tmpl
    • -3
    • +3
    ./object.html.tmpl
    • -1
    • +1
    ./package.html.tmpl
  5. … 6 more files in changeset.
Wednesday 28 Jul 2010
11:01 am

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

Adding the interim logo

Options
    • binary
    ./nx.png
10:59 am

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

- Added a placeholder logo image, to replace the YUI one for the time being - Provided for giving some version information at either the project or package level

Options
    • -1
    • +1
    ./api.css
    • -1
    • +7
    ./entity.html.tmpl
    • binary
    ./yui.png
  4. … 2 more files in changeset.
10:00 am

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

- Fixed search box and autocompletion support (for packages and objects) - I allow for selecting/deselecting structural features set "private" ("deprecated" remains to be done) - I added the generation of links between documentation entities based on {{...}} markers. Any marker (code as well as links) can now be used in both description and parts sections.

Options
    • -1
    • +1
    ./ac-js
    • -3
    • +3
    ./entity.html.tmpl
    • -3
    • +9
    ./object.html.tmpl
  4. … 1 more file in changeset.
Tuesday 27 Jul 2010
10:02 pm

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

- Adding basic support for subcommands (a @subcommand part type; formerly @variant) - Introducing comment reuse and cross-linkage along the class hierarchy upwards ("subclass of ...", showing inherited attributes and methods; using a @superclass attribute) - Amending the documentation of @param and @return with "type" information (checkoptions, constraints, defaults) - Showing both per-class and per-object methods - I now allow for inline- and out-of-line (block) code snippets in the description sections, based on wiki-like {{{...}}} marker annotation (same as in scaladoc2). - Adding support for newline representations in description sections (for a more convenient formatting). - Some bugfixes (e.g., @object-method did not work outside of an initcmd) - Started refactoring the entity tracing procedure (moving from [namespace import] resolution to mixin-based creation tracing)

Options
    • -4
    • +47
    ./command.html.tmpl
    • -8
    • +140
    ./object.html.tmpl
  3. … 2 more files in changeset.
10:02 pm

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

- Adding basic support for subcommands (a @subcommand part type; formerly @variant) - Introducing comment reuse and cross-linkage along the class hierarchy upwards ("subclass of ...", showing inherited attributes and methods; using a @superclass attribute) - Amending the documentation of @param and @return with "type" information (checkoptions, constraints, defaults) - Showing both per-class and per-object methods - I now allow for inline- and out-of-line (block) code snippets in the description sections, based on wiki-like {{{...}}} marker annotation (same as in scaladoc2). - Adding support for newline representations in description sections (for a more convenient formatting). - Some bugfixes (e.g., @object-method did not work outside of an initcmd) - Started refactoring the entity tracing procedure (moving from [namespace import] resolution to mixin-based creation tracing)

Options
    • -4
    • +47
    ./command.html.tmpl
    • -8
    • +140
    ./object.html.tmpl
  3. … 2 more files in changeset.
Friday 18 Jun 2010
12:13 pm

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

- Added a first set of documentation templates, based on the the TemplateData engine and the YUI doc styles available from http://yuilibrary.com/downloads/ (see library/lib/doc-assets/*.tmpl.html) - Added a @project entity class, which will become the root concept in a documentation hierarchy. For now, it only serves for some auxiliary purposes when processing the doc templates. - Continued documenting the next::doc package for testing purposes.

Options
    • -0
    • +162
    ./ac-js
    • -0
    • +42
    ./api-js
    • -0
    • +242
    ./api.css
    • binary
    ./bg_hd.gif
    • -0
    • +44
    ./command.html.tmpl
    • -0
    • +116
    ./entity.html.tmpl
    • -0
    • +111
    ./object.html.tmpl
    • -0
    • +56
    ./package.html.tmpl
    • -0
    • +7
    ./reset-fonts-grids-min.css
    • -0
    • +7
    ./source.html.tmpl
    • binary
    ./yui.png
  12. … 2 more files in changeset.