doc

Clone Tools
  • last updated 17 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
- update documentation

- improve wording in rosetta example

    • -2
    • +3
    ./example-scripts/rosetta-unknown-method.tcl
- improve wording in rosetta example

    • -2
    • +8
    ./example-scripts/rosetta-abstract-type.tcl
Property Reform Part 2: better handling of per-object properties nsf.c: - changed "/class/ __objectconfigure" to "/obj/ __objectconfigure" to be able to handle per-object properties on classes properly. - renamed "info method parametersyntax" -> "info method syntax" - renamed "/obj|cls/ info method parametersyntax" into "/obj|cls/ info method syntax" - replaced "::nsf::methods::class::info::objectparameter" by "::nsf::methods::object::info::objectparameter" - new command "::nsf::parameter::specs ?-configure? ?-noposargs? slotobjs": convert provided slotobjs into a list of parameter specs - new command "::nsf::parameter::get list|name|syntax parameterspec": convert parameter spec into syntax form, or retrieve pieces of information from it (can be extended in the future) - added more or less generic list handling functions TclObjListFreeList(), TclObjListNewElement() and TclObjListAdd() used by "::nsf::parameter::specs" - replaced "::nsf::method::property /obj/ -per-object /name/ slotcontainer ?value?" by "::nsf::object::property /obj/ slotcontainer ?value?" - added "::nsf::object::property /obj/ hasperobjectslots ?value?"

nx.tcl:

- new info methods

* "/obj/ info lookup parameter definitions"

* "/obj/ info lookup parameter names"

* "/obj/ info lookup parameter list"

* "/obj/ info lookup parameter syntax"

- changed "/cls/ info parameter definition ?name?"

into "/cls/ info parameter definitions ?name?"

since ir returns a list. Still, "list" or "syntax" won't

be plural

  1. … 18 more files in changeset.
Property reform part 1:

- disallow protection modifiers for "properties" and

add new flag "-accessor" to "property" and "variable"

This changes definitions like

Class create C {

:property {a a1}

:public property {b b1}

:protected property {c c1}

:private property {d d1}

}

to

Class create C {

:property {a a1}

:property -accessor public {b b1}

:property -accessor protected {c c1}

:property -accessor private {d d1}

}

since "properties" are always public accessible

over the "configure" and "cget" interface, but the

accessors methods might not be public. The value of

the accessor might be also "none" (specifying explicitely

that no accessor is wanted) or "", which means: use the default.

Same holds for "variable"

- disallow parameter option "incremental" and change it to a flag

of the property or variable. The motivation for this is due to

the fact, that "incremental" is a property of the accessor, and

not of the value.

old:

Class create C {

:property foo:int,incremental

:variable bar:int,incremental

}

new:

Class create C {

:property -incremental foo:int

:variable -incremental bar:int

}

- disallow "public class property" and friends since these are not needed

- removed parameter property "noaccessor"

- removed "nx::configure defaultPropertyCallProtection" and

method hook "__default_property_call_protection"

- introduced "nx::configure defaultAccessor" and

method hook "__default_accessor"

- for the time being, "defaultAccessor" is "public" for NX and XOTcl,

will be changed to "none" in NX

- extended regression test (new file properties.test)

    • -1
    • +1
    ./example-scripts/rosetta-constraint-genericity.tcl
  1. … 15 more files in changeset.
- use explicit return in tutorial example scripts

- improve documentation

    • -17
    • +24
    ./example-scripts/ruby-mixins.html
    • -15
    • +23
    ./example-scripts/ruby-mixins.tcl
- minor documentation updates

    • -53
    • +47
    ./example-scripts/ruby-mixins.html
Don't recommend to use "configure" method for chaning class/superclass

First examples, supporting text, and Makefile integration

    • -0
    • +276
    ./example-scripts/linearisation.tcl
  1. … 1 more file in changeset.
cosmetical documentation changes

- document private properties in tutorial and migration guide - improve wording in documenting - extend regression test

    • -51
    • +128
    ./next-tutorial/next-tutorial.html
  1. … 2 more files in changeset.
- added documentation for "/obj/ info name" to migration guide and .nxd file - adding more comments to examples in migration guide

  1. … 2 more files in changeset.
- added design study ruby-mixins.tcl to example-docs and regression test

    • -0
    • +1133
    ./example-scripts/ruby-mixins.html
    • -0
    • +214
    ./example-scripts/ruby-mixins.tcl
  1. … 2 more files in changeset.
- change "#!/bin/env" into "#!/usr/bin/env"

  1. … 6 more files in changeset.
- don't allow method to overwrite child object - extended regression test - documented new feature as incompatibility with XOTcl 1

  1. … 3 more files in changeset.
- mv next-tutorial (source, images) into own subdirectory doc/next-tutorial/

    • binary
    ./next-tutorial/languages.png
    • -0
    • +4001
    ./next-tutorial/next-tutorial.html
    • -0
    • +2309
    ./next-tutorial/next-tutorial.txt
    • -0
    • +638
    ./next-tutorial/object-class-appclass.graffle
    • binary
    ./next-tutorial/object-class-appclass.png
    • -0
    • +2498
    ./next-tutorial/object-parameter.graffle
    • binary
    ./next-tutorial/object-parameter.png
    • -0
    • +420
    ./next-tutorial/object-stack.graffle
    • binary
    ./next-tutorial/object-stack.png
    • -0
    • +719
    ./next-tutorial/per-class-mixin.graffle
    • binary
    ./next-tutorial/per-class-mixin.png
    • -0
    • +722
    ./next-tutorial/per-object-mixin.graffle
  1. … 27 more files in changeset.
improve wording

Added README.release Added Annoice 2.0b3

  1. … 1 more file in changeset.
add missing question mark

fix typo

doc: fixed line-number handling locally

  1. … 1 more file in changeset.
- removed documentation about incompatibility to XOTcl1 in respect of the method interface for object invocations

  1. … 1 more file in changeset.
- updates for the tutorial (mustly typos and stilistic changes)

- doc fixes in tutorial: fix typos and improve some wordings

- generic/nsfInt.h: Provided the DECR_REF_COUNT2 #define macro for __WIN32__ builds (e.g., MinGW). Thanks to Stephan Adelsberger for pointing to the issue. - Made temp file handling in a rosetta example OS-independent; thanks to Stephan Adelsberger for the initial patch

    • -2
    • +3
    ./example-scripts/rosetta-serialization.tcl
  1. … 2 more files in changeset.
- close parens in Annouce file

- adding anouncement for the release of 1.6.7

- fixed documentation bug in migration guide, since arguments in "info slot ..." were deleted in the code, but not in the guide

- updated indentation