nsf / library / lib

doc-tools.tcl

Clone Tools

Stats

Commits this week: 0
Total Committers: 3
Last Commit: 05 Mar
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 9 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
Monday 05 Sep 2011
11:25 pm

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

- apps/utils/nxdoc: Created a first version of a command-line script around the nxdoc machinery, for Makefile integration. - Makefile.in: Added two experimental nxdoc make-targets: [make yuidoc] and [make xowiki]. In addition, provided for a doc-specific cleanup target: [make cleandoc]. Also changed the way TCLLIBPATH is initialised for makefile runs, to preserve the surrounding environment settings. - tests/doc.test: Deactivated obsolete sections; actual cleanup is pending. - Refactored nxdoc code fragments into sub-packages, namely the html and xowiki rendering components; renamed some file and directory. - Some necessary adjustments to make nxdoc work with the new property/variable nomenclature; spotted some misbehaviour of [namespace import] when running under 8.6b2 (to be investigated; see XOTcl-lanfRef.xotcl)

Options
    • -4445
    • +0
    ./doc-tools.tcl
  2. … 82 more files in changeset.
Thursday 01 Sep 2011
6:17 pm

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

- renamed "nsf::method::dispatch" to "nsf::directdispatch" - renamed "nsf::object::dispatch" to "nsf::dispatch"

Options
    • -23
    • +23
    ./doc-tools.tcl
  2. … 16 more files in changeset.
Monday 15 Aug 2011
12:03 pm

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

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:

library/lib/doc-tools.tcl

Options
    • -33
    • +50
    ./doc-tools.tcl
  2. … 2 more files in changeset.
11:35 am

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

- nx.tcl * renamed "info parameter name" to "info parameter names" (since it returns a list of names) * renamed "info parameter name" to "info parameter names" (since it returns a list of names) * renamed "info slots" to "info slot objects" * additional method "info slot definition" * additional method "info slot name" * additional method "info properties" (alias to "info slot definition") * removed "info parameter slot" * use term "noaccessor" and "noconfig" to deactivate accessors or object-parameters in property definitions * don't show slots with noconfig in "info parameter names" * don't show slots with noconfig in "info parameter definition" * renamed slot property "configparam" to "config" * renamed "::nsf::methods::class::info::slots" to "::nsf::methods::class::info::slotobjects" * additional public method ObjectParameterSlot.getPropertyDefinition * updated and extended regression test

Options
    • -1
    • +1
    ./doc-tools.tcl
  2. … 14 more files in changeset.
Friday 12 Aug 2011
2:01 pm

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

- nx.tcl * renamed "attribute" to "property" * renamed "defaultAttributeCallProtection" to "defaultPropertyCallProtection" * renamed "nx::Attribute" to ""nx::VariableSlot" * renamed "BootStrapAttributeSlot" to "BootStrapVariableSlot" * renamed "createBootstrapAttributeSlots" to "createBootstrapVariableSlots" * removed method attributes * implemented old attributes definition in xotcl2 as method "parameter"

Options
    • -107
    • +108
    ./doc-tools.tcl
  2. … 32 more files in changeset.
12:41 am

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

- library/lib/doc-tools.tcl: Ported over the nxdoc core to reflect recent changes (i.e., modified attribute() signature and honouring that ::nsf::method::setter|forward are expected to return the method handle)

Options
    • -31
    • +33
    ./doc-tools.tcl
Thursday 14 Jul 2011
9:18 am

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

- regularized more nsf::* names: renamed "nsf::createobjectsystem" => "nsf::objectsystem::create" renamed "nsf::unknown" => "nsf::object::unknown" renamed "nsf::dispatch" => "nsf::object::dispatch"

Options
    • -28
    • +28
    ./doc-tools.tcl
  2. … 17 more files in changeset.
Tuesday 17 May 2011
11:49 am

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

- Allow for defining type specifications for @param entities as an @spec part. - Corrected some inconsistencies in the doc templates for attribute methods - Added object parametersyntax in @class templates (though they appear quite lengthy, keep them at the end of the day?) - Distinguish between the "cls" and "obj" as affices

Options
    • -13
    • +60
    ./doc-tools.tcl
  2. … 10 more files in changeset.
Friday 06 May 2011
4:19 am

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

- Adjusted nxdoc for the latest changes in the nsf/nx core: - library/lib/doc-tools.tcl: Reflected the renaming of class-object to final; substituted the new positioning declaration for the old-style objectparameter shadowing on Entity (for @doc); some minor cleanup - tests/doc.test: A number of tests did not survive the continued renaming from object -> class-object -> class; fixed them.

Options
    • -17
    • +26
    ./doc-tools.tcl
  2. … 1 more file in changeset.
Tuesday 19 Apr 2011
1:09 pm

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

- nsf: renamed nsf::isobject to nsf::object::exists - nsf: renamed nsf::qualify to nsf::object::qualify

Options
    • -19
    • +18
    ./doc-tools.tcl
  2. … 17 more files in changeset.
Friday 18 Mar 2011
12:31 pm

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

* Hopefully the last big naming change: Instead of writing "C class-object method foo {} {...}" one can write now "C class method foo {} {...}" to define a class method named "foo" for class "C". This naming change became possible by defining XOTcl's "class" (and "superclass") as object parameter only. To change a class of an object o, one has to use "o configure -class NEWCLASS". The term "object-class" looks alien to language beginners, the term "class" is much more straightforward. Changing classes or superclasses is seldomly used by typicall application programs.

For already existing nx scripts, changing "object-class" into

class should be straightforward.

* various documentation updates (migration guide, nx tutorial)

Options
    • -22
    • +22
    ./doc-tools.tcl
  2. … 22 more files in changeset.
Thursday 10 Mar 2011
12:45 pm

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

- Provided proper template for hook methods; started partial support for validating Tcl packages (remains to be completeted, i.e., missing and mismatch support) - Fixed rendering for glossary back-references in the light of nested render() calls. - Refactored the rendering of overview lists/status into proper template; show per-project stats - Made @stashed filtering working; some fixes

Options
    • -51
    • +109
    ./doc-tools.tcl
  2. … 9 more files in changeset.
Wednesday 02 Mar 2011
12:27 pm

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

- changed names of var handling commands in nsf: ::nsf::existsvar => ::nsf::var::exists ::nsf::importvar => ::nsf::var::import ::nsf::setvar => ::nsf::var::set

Options
    • -5
    • +5
    ./doc-tools.tcl
  2. … 12 more files in changeset.
1:39 am

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

- @project.html.yuidoc: reflect changes in asset names - body-chunked.html.yuidoc: Added this template, used to generate the chunked, yuidoc-based xowiki output - leftbar.html.yuidoc: Use link template - Renamed ac-js + api-js to ac.js + api.js - Added Monika's api-next.css - library/lib/doc-tools.tcl: for the xowiki renderer, I completed the asset export (requiring a tcllib installation!), some refactoring to allow for rendering xowiki-style links etc. - Revised TODO

Options
    • -8
    • +61
    ./doc-tools.tcl
  2. … 9 more files in changeset.
Tuesday 01 Mar 2011
10:20 am

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

- changed named of method handling commands in nsf: ::nsf::methodproperty => ::nsf::method::property ::nsf::method => ::nsf::method::create ::nsf::methoddelete => ::nsf::method::delete ::nsf::alias => ::nsf::method::alias ::nsf::forward => ::nsf::method::forward ::nsf::setter => ::nsf::method::setter (updated regression test, docs, ...)

Options
    • -14
    • +14
    ./doc-tools.tcl
  2. … 24 more files in changeset.
Monday 07 Feb 2011
11:41 am

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

- Added a first version of an xowiki renderer - Reworked the renderer infrastructure to allow for refining templates between renderers (e.g., xowiki-like links in the yuidoc theme etc.) introduces - Templates can now also be defined, stored, and maintained through Tcl scripts (rather than separate template files only). - Clarified the concepts of theme/layout/renderer etc. Major cleanup. - yuidoc: Fixed an issue with setting filter css classes while no filter checkboxes are available.

Options
    • -214
    • +213
    ./doc-tools.tcl
  2. … 12 more files in changeset.
Friday 04 Feb 2011
11:57 am

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

- Reactivated and extended the filtering support around the yuidoc theme. One can now filter according to various entity states (deprecated, missing, mismatch, protected, ...) - filter.html.yuidoc: Refactored the checkbox battery into a proper template. - Fixed some typos in templates - library/lib/doc-assets/yuidoc/ac-js: Refined the checkbox/visibility mechanism to honour defaultChecked states of checkboxes. - library/lib/doc-assets/yuidoc/api.css: checkbox/visibility selectors are now based on composite class selectors. - Removed @modifier and related selection statements throughout the code. Background: The call-protection state is inferred during verification, so there is no need to actually declare a method protected. Also, filtering in the templates breaks orthogonality when it comes to rendering doc entities at various spots (leftbar, ...). Method filtering can be applied during the initial processing step or visually in the final output. - Added print names for per-object methods

Options
    • -14
    • +20
    ./doc-tools.tcl
  2. … 12 more files in changeset.
Thursday 03 Feb 2011
4:10 pm

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

- @class.html.yuidoc: Printing class-scope validation messages. - @object.html.yuidoc: Printing object-scope validation messages. - @method.html.yuidoc: Flattening list structure of validation messages when printed. - Revised and fixed status propagation - Fixed an issue when verifying forwarders/aliases which do not carry any verifiable parameter specifications. Also, I had forgotten to collect paramtersyntax docstrings for forwarders. Addresses an issue reported by Gustaf Neumann trying to make appear the proper paramsyntax of the Object->class() forwarder. - statusmark resolution is now aware of @use chains

Options
    • -27
    • +47
    ./doc-tools.tcl
  2. … 4 more files in changeset.
12:21 pm

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

- Simplified the render()/include() mechanism: I provide for some context-aware auto-completion of template specifics (name, format, theme). This avoids declaring template specifics redundantly. - For this purpose, renamed some of the templates to reflect their doc entity names: @object -> @object.html.asciidoc|yuidoc. - Theme-specific assets are now stored in a subdir of doc-assets/, named after the theme: doc-assets/yuidoc, doc-assets/asciidoc. - Adding the asciidoc assets subdir, including the asciidoc css - Renamed the theme "tmpl" to "yuidoc": This required to change the corresponding template extensions (*.tmpl -> *.yuidoc) and the include()/render() statements throughout the templates. - Removed the unneeded source.html.tmpl

Options
    • -18
    • +56
    ./doc-tools.tcl
  2. … 52 more files in changeset.
Saturday 22 Jan 2011
5:10 pm

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

- nsf.c: changed handling of cmdPtrs in callstack content. * we use now explicit reference counting using NsfCommandPreserve/NsfCommandRelease * as a consequence, we do not need the following functions Nsf_DeleteCommandFromToken() and CallStackClearCmdReferences() any more. * the flag NSF_CSC_OBJECT_ACTIVATED is not needed anymore and was removed

- removed a small memory leak when a destroy method of an object o

deletes its grandparents namespace, containing also this class of o

(and its methods). Significantly eased by the change above.

Options
    • -2
    • +1
    ./doc-tools.tcl
  2. … 4 more files in changeset.
Tuesday 11 Jan 2011
12:41 am

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

- "asciidoc" theme: Completed a first template suite which renders an nxdoc project in terms of the html4/xhtml11 asciidoc backend. Added new templates: singlefile.html.asciidoc, class.html.asciidoc, attributemethod.html.asciidoc, command.html.asciidoc, link.html.asciidoc, listing.html.asciidoc, method.html.asciidoc, object.html.asciidoc, package.html.asciidoc, submethod.html.asciidoc. - nxdoc now distinguishes between rendering format, layout (multifile, singlefile, chunked) and refactored. All layout/format/theme handling, for now, is provided by ::nx::doc::Renderer. - First step towards refactoring/automating template resolution; see the TemplateData class. In a further step, this will permit us to remove redundant declarations of template details in render() and include() statements. - List and link generation are now adaptable based on dedicated templates per theme, e.g., link.html.tmpl|asciidoc. Note that these file-based templates might be replaced by scripted ones at a later point. - Fixed pretty naming of @package - Various refactorings, e.g. renderer mixin layers are now objects, rather than classes.

Options
    • -90
    • +172
    ./doc-tools.tcl
  2. … 17 more files in changeset.
Monday 10 Jan 2011
12:14 pm

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

- doc-tools.tcl: make -name parameter of method new always required and "any" - doc-tools.tcl: make object parameter of Entity of type "any"

Options
    • -9
    • +8
    ./doc-tools.tcl
Sunday 09 Jan 2011
11:51 am

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

- adding obvously missing argument

Options
    • -1
    • +1
    ./doc-tools.tcl
Tuesday 04 Jan 2011
2:37 pm

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

- adjust doc-tools (removed obsolete -public flag)

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

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

- library/lib/doc-tools.tcl: Some fixes, including adjusting @class.inherited() to return only doc entities of classes which are part of the same project as the inheritee. - library/lib/doc-tools.tcl: Integrated an xodoc-compat infrastructure and provided for processing xodoc packages (see processor.process=@package()). - tests/doc.test: Now also serves a nxdoc port of the XOTcl-langref package - library/xotcl/doc/langRef.xotcl: equipped with an empty namespace declaration (to please pkg_mkIndex.tcl) and import ::xotcl::@ by default (for convenience).

Options
    • -16
    • +249
    ./doc-tools.tcl
  2. … 2 more files in changeset.
12:20 am

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

- doc-tools: added "-where" to !get - doc-tools: title to internal links, provided css class, added nicer label - updated reference doc

Options
    • -16
    • +31
    ./doc-tools.tcl
  2. … 6 more files in changeset.
Sunday 02 Jan 2011
6:12 pm

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

listing(): Trim result string of pretty printer for trailing newlines to avoid their transformation to multiple line breaks.

Options
    • -2
    • +3
    ./doc-tools.tcl
  2. … 1 more file in changeset.
3:14 am

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

- library/lib/doc-tools.tcl: Added a link renderer for Tcl commands, pointing to the tcl.tk online reference; usage: <<tclcmd /cmd/>>. - library/nx/nx.nxd: Fixed glossary references pointing to mixin classes. - glossary.html.tmpl: Made the tmpl more robust against the non-existence of glossary entries. - method.html.tmpl: Made Type and Protection fully conditional - doc-tools.tcl: added a @project.is_validated attribute to reflect the validation status of a given project. this should later turn into a derived property. - langRef.xotcl: added a missing </tt> closing tag, to avoid tt pollution of the remaining document space.

Options
    • -25
    • +58
    ./doc-tools.tcl
  2. … 5 more files in changeset.
Saturday 01 Jan 2011
8:36 pm

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

- documentation work

Options
    • -1
    • +1
    ./doc-tools.tcl
  2. … 6 more files in changeset.
Friday 31 Dec 2010
6:09 pm

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

- update of the migration guide

Options
    • -1
    • +1
    ./doc-tools.tcl
  2. … 4 more files in changeset.