Check-in [52d37fea35]

Login
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to tclconference@googlegroups.com
or submit via the online form by Sep 9.

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Fix some spelling and awkward wording
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256:52d37fea350b97cf95a579e54315d955e61499264f7a7c5c42460eeae56c4eb4
User & Date: dkf 2018-06-10 20:49:14
Context
2018-06-13
20:50
examples and docu of tip 507 added check-in: 8331611a7f user: rene tags: trunk
2018-06-10
20:49
Fix some spelling and awkward wording check-in: 52d37fea35 user: dkf tags: trunk
20:44
Formatting tweaking check-in: 11ef41277a user: dkf tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to tip/508.md.

    15     15   for arrays, causing that value to be returned any time an attempt is made to
    16     16   access an element of the array that isn't present.
    17     17   
    18     18   # Rationale
    19     19   
    20     20   For its most basic usages, a Tcl array variable can be seen as a collection of
    21     21   scalar variables. However, an array also has its own existence as a variable and
    22         -provides specficic actions on itself and on its elements. For exampe, the
           22  +provides specific actions on itself and on its elements. For example, the
    23     23   regular way to check for a variable existence is to use the **info exists**
    24     24   command, and this is true for both arrays and scalars (including array
    25     25   elements); likewise, the **set** command is used to read and write the value of
    26     26   a scalar vars and array elements, however array variables have no value in
    27     27   themselves but provide a way to get and set several of its elements at once.
    28     28   
    29     29   For more advanced usages, one must get past the simple ‘collection of scalars’
................................................................................
    41     41   
    42     42   A new **array default** subcommand will be created with the following syntax:
    43     43   
    44     44   > **array default**  _option arrayName_ ?_arg_?
    45     45   
    46     46   The following _option_ values are supported:
    47     47   
    48         -* **array default get** _arrayName_: Get _arrayName_
    49         -  default value. Raise an error if _arrayName_ is not an array variable or if it
    50         -  has no default value.
    51         -* **array default set** _arrayName value_: Set the default value for
           48  +* **array default get** _arrayName_ — Get the default value for the array
           49  +  _arrayName_. Raise an error if _arrayName_ is not an array variable
           50  +  or if it has no default value.
           51  +* **array default set** _arrayName value_ — Set the default value for
    52     52     the array _arrayName_. If the variable _arrayName_ does not already exist,
    53     53     it is created with an empty array value. Raise an error if _arrayName_ is an
    54     54     existing scalar variable or an invalid array name.
    55         -* **array default exists** _arrayName_: Test whether array
           55  +* **array default exists** _arrayName_ — Tests whether the array
    56     56     _arrayName_ has a default value. Return false if _arrayName_ does not exist.
    57         -  Raise an error if _arrayName_ exists but is not an array variable.
    58         -* **array default unset** _arrayName_: Unsets _arrayName_'s default
           57  +  Raises an error if a variable _arrayName_ exists but is not an array variable.
           58  +* **array default unset** _arrayName_ — Unsets _arrayName_'s default
    59     59     value so that the array no longer has a default. Does nothing if
    60         -  _arrayName_ does not exist. Raise an error if
           60  +  _arrayName_ does not exist. Raises an error if
    61     61     _arrayName_ is not an array variable.
    62     62   
    63     63   The default value is only used as a last resort where an error would normally
    64     64   occur when accessing a non-existing array element. Read traces are processed
    65     65   _before_ that point and are free to set the element value or modify the default
    66     66   value.
    67     67