lib

Clone Tools
  • last updated 3 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
- 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

    • -0
    • +106
    ./doc-assets/@class.html.asciidoc
    • -0
    • +236
    ./doc-assets/@class.html.yuidoc
    • -0
    • +62
    ./doc-assets/@command.html.asciidoc
    • -0
    • +117
    ./doc-assets/@command.html.yuidoc
    • -0
    • +30
    ./doc-assets/@method.html.asciidoc
    • -0
    • +83
    ./doc-assets/@method.html.yuidoc
    • -0
    • +20
    ./doc-assets/@object.html.asciidoc
    • -0
    • +101
    ./doc-assets/@object.html.yuidoc
    • -0
    • +45
    ./doc-assets/@package.html.asciidoc
    • -0
    • +75
    ./doc-assets/@package.html.yuidoc
    • -0
    • +388
    ./doc-assets/asciidoc/xhtml11.css
    • -117
    • +0
    ./doc-assets/attributemethod.html.tmpl
  1. … 38 more files in changeset.
- updated documentation

  1. … 5 more files in changeset.
- 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.

  1. … 4 more files in changeset.
- add "filter" to the list of highlited words

- "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.

    • -0
    • +51
    ./doc-assets/attributemethod.html.asciidoc
    • -0
    • +106
    ./doc-assets/class.html.asciidoc
    • -0
    • +62
    ./doc-assets/command.html.asciidoc
    • -0
    • +4
    ./doc-assets/link.html.asciidoc
    • -0
    • +4
    ./doc-assets/link.html.tmpl
    • -0
    • +3
    ./doc-assets/listing.html.asciidoc
    • -0
    • +1
    ./doc-assets/listing.html.tmpl
    • -0
    • +30
    ./doc-assets/method.html.asciidoc
    • -0
    • +77
    ./doc-assets/multifile.html.tmpl
    • -0
    • +20
    ./doc-assets/object.html.asciidoc
    • -0
    • +45
    ./doc-assets/package.html.asciidoc
    • -0
    • +102
    ./doc-assets/singlefile.html.asciidoc
    • -0
    • +25
    ./doc-assets/submethod.html.asciidoc
  1. … 3 more files in changeset.
- doc-tools.tcl: make -name parameter of method new always required and "any" - doc-tools.tcl: make object parameter of Entity of type "any"

- adding obvously missing argument

- nx::pp: added flag "-linenumbers on|off" to render method

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

- 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).

  1. … 2 more files in changeset.
- doc-tools: added "-where" to !get - doc-tools: title to internal links, provided css class, added nicer label - updated reference doc

  1. … 4 more files in changeset.
- remove unneeded newline

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

  1. … 1 more file in changeset.
- add type attribute to style tag

- 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.

  1. … 3 more files in changeset.
- documentation work

  1. … 5 more files in changeset.
- update of the migration guide

  1. … 3 more files in changeset.
- minor cleanup

- nx::pp: don't prepend newline after <pre>

- doc-tools.tcl: Integrated the nx pretty printer (nx::pp) to render freestanding code listings. - Minor cleanup

- generic/gentclAPI.decls: Set the ::nsf::setter parameter as required, otherwise ::nsf::setter crashes upon omitting the parameter/setter name. - library/lib/doc-tools.tcl: Reduced verbosity

  1. … 2 more files in changeset.
- nsf.nxd: Completed a first draft version of the NSF reference (needs to be revised and improved in further iterations) - doc-tools.tcl: Fixed an issue with closing comment blocks (the last comment line closes with an eof), previously dropped silently by the processor.

  1. … 3 more files in changeset.
- library/lib/doc-tools.tcl: added [pinfo append] to collect multiple validation reports per entity - library/lib/doc-tools.tcl / owned_parts(): skip entities which are not structured themselves (namely parameters); otherwise they show up in the lefthand navigation or the autosearch box. also: glossary entries now disappeared from these navigation items (do we need them there?). - library/lib/doc-assets/command.html.tmpl: validation reports need to be fused using [join] - library/lib/doc-assets/command.html.tmpl: fixed subcommand support; adjusted and refined the per-command template, as well as @command validation. - Provided for parameter validation for @command and the extraction of the parametersyntax for commands - nsf.nxd: Added to the NSF documentation, namely completed a first round commands ::nsf::alias throughout ::nsf::log. Also: Refactored some glossary entries to nsf.nxd. - glossary: glossary entries can now be shared between projects; this required to make the back references aware of their project context. - @project: added a depends attribute which can be used to express inter-project dependencies. - An empty @doc string is now reported during validation - processor->process(): Added include/exclude filtering based on namespace patterns

  1. … 3 more files in changeset.
- added -noCSSClasses to nx::pp render method

- better separation of state management and css concerns

- initial checkin of the nx pretty printer

- removed method "setter" from migration guide

  1. … 4 more files in changeset.
- nx::test: made differences in regression test easier to read

- doctools: changed "-slotclass" to "-class"

- Changed parametersyntax visualisation to show variable/replacable elements in italics. - Rewrote the method template for attribute accessors/mutators - Revised and refactored the resolution helper of member entities along an inheritance path to reflect member overloading - Reduced verbosity

    • -47
    • +86
    ./doc-assets/attributemethod.html.tmpl
  1. … 1 more file in changeset.