From adcb761134c80285073a2c4728ab545dec101ff2 Mon Sep 17 00:00:00 2001 From: Steve Bennett Date: Mon, 18 May 2015 19:52:32 +1000 Subject: [PATCH] docs: minor typo with lassign Signed-off-by: Steve Bennett --- Tcl_shipped.html | 79 ++++++++++++++++++++++++++++++++++---------------------- jim_tcl.txt | 4 +-- 2 files changed, 50 insertions(+), 33 deletions(-) diff --git a/Tcl_shipped.html b/Tcl_shipped.html index 9bb32cd..ac4a57f 100644 --- a/Tcl_shipped.html +++ b/Tcl_shipped.html @@ -738,7 +738,7 @@ Jim Tcl(n) Manual Page

NAME

-

Jim Tcl v0.76 - +

Jim Tcl v0.76+ - reference manual for the Jim Tcl scripting language

@@ -878,6 +878,16 @@ Support for UDP, IPv6, Unix-Domain sockets in addition to TCP sockets

RECENT CHANGES

+

Changes between 0.76 and 0.77

+
    +
  1. +

    +Add support for aio sync +

    +
    2. +
+
+

Changes between 0.75 and 0.76

  1. @@ -2009,11 +2019,6 @@ of precedence:

  • -rand() takes the absolute value of the numeric argument. -

    -
    • -
  • -

    rand() returns a pseudo-random floating-point value in the range (0,1).

    • @@ -3811,16 +3816,19 @@ to be piped into standard input of the next command (or |& for both standard output and standard error).

    Under normal conditions the result of the exec command consists of the standard output produced by the last command -in the pipeline.

    -

    If any of the commands in the pipeline exit abnormally or -are killed or suspended, then exec will return an error -and the error message will include the pipeline’s output followed by -error messages describing the abnormal terminations.

    +in the pipeline followed by the standard error output.

    If any of the commands writes to its standard error file, -then exec will return an error, and the error message -will include the pipeline’s output, followed by messages -about abnormal terminations (if any), followed by the standard error -output.

    +then this will be included in the result after the standard output +of the last command.

    +

    Note that unlike Tcl, data written to standard error does not cause +exec to return an error.

    +

    If any of the commands in the pipeline exit abnormally or +are killed or suspended, then exec will return an error. +If no standard error output was produced, or is redirected, +the error message will include the normal result, as above, +followed by error messages describing the abnormal terminations.

    +

    If any standard error output was produced, these abnormal termination +messages are suppressed.

    If the last character of the result or error message is a newline then that character is deleted from the result or error message for consistency with normal @@ -4072,7 +4080,7 @@ abbreviation for option is acceptable. The valid options If it can’t be deleted, an error is generated. Non-empty directories will not be deleted unless the -force options is given. In this case no errors will be generated, even if the file/directory can’t be deleted. Use -- if there is any possibility of - the first name being -force. + the first name being -force.

    @@ -4148,8 +4156,8 @@ abbreviation for option is acceptable. The valid options

    Creates a hard link (default) or symbolic link from newname to target. - Note that the sense of this command is the opposite of file rename and file copy - and also of ln, but this is compatible with Tcl. + Note that the sense of this command is the opposite of file rename and file copy + and also of ln, but this is compatible with Tcl. An error is returned if target doesn’t exist or newname already exists.

    @@ -4237,8 +4245,8 @@ abbreviation for option is acceptable. The valid options

    Renames the file from the old name to the new name. - If newname already exists, an error is returned unless -force is - specified. + If newname already exists, an error is returned unless -force is + specified.

    @@ -4267,7 +4275,7 @@ abbreviation for option is acceptable. The valid options

    Invoke the stat kernel call on name, and return the result - as a dictionary with the following keys: atime, + as a dictionary with the following keys: atime, ctime, dev, gid, ino, mode, mtime, nlink, size, type, uid. Each element except type is a decimal string with the value of @@ -4275,8 +4283,8 @@ abbreviation for option is acceptable. The valid options manual entry for stat for details on the meanings of the values. The type element gives the type of the file in the same form returned by the command file type. - If varName is specified, it is taken to be the name of an array - variable and the values are also stored into the array. + If varName is specified, it is taken to be the name of an array + variable and the values are also stored into the array.

    @@ -4719,8 +4727,8 @@ The legal option's (which may be abbreviated) are: With a single argument, returns the original source location of the given script as a list of {filename linenumber}. If the source location can’t be determined, the list {{} 0} is returned. If filename and line are given, returns a copy - of script with the associate source information. This can be useful to produce - useful messages from eval, etc. if the original source information may be lost. + of script with the associate source information. This can be useful to produce + useful messages from eval, etc. if the original source information may be lost.

    @@ -4846,8 +4854,8 @@ For example,

    lassign list varName ?varName ...?

    This command treats the value list as a list and assigns successive elements from that list to the variables given by the varName arguments in order. If there are more variable names than -list elements, the remaining variables are set to the empty string. If there are more list ele- -ments than variables, a list of unassigned elements is returned.

    +list elements, the remaining variables are set to the empty string. If there are more list elements +than variables, a list of unassigned elements is returned.

    jim> lassign {1 2 3} a b; puts a=$a,b=$b
@@ -6888,7 +6896,7 @@ uid 1000 euid 1000 gid 100 egid 100

    Closes the stream. - The two-argument form is a "half-close" on a socket. See the shutdown(2) man page. + The two-argument form is a "half-close" on a socket. See the shutdown(2) man page.

    @@ -6999,6 +7007,15 @@ uid 1000 euid 1000 gid 100 egid 100

    +$handle sync +
    +
    +

    + Flush the stream, then fsync(2) to commit any changes to storage. + Only available on platforms that support fsync(2). +

    +
    +
    $handle tell
    @@ -7163,8 +7180,8 @@ to prevent infinite errors. (A time event handler is always removed after execut

    Called when an event handler script generates an error. Note that the normal command resolution - rules are used for bgerror. First the name is resolved in the current namespace, then in the - global scope. + rules are used for bgerror. First the name is resolved in the current namespace, then in the + global scope.

    @@ -8224,7 +8241,7 @@ official policies, either expressed or implied, of the Jim Tcl Project.
    diff --git a/jim_tcl.txt b/jim_tcl.txt index 6217678..fec2a4a 100644 --- a/jim_tcl.txt +++ b/jim_tcl.txt @@ -2848,8 +2848,8 @@ lassign This command treats the value +'list'+ as a list and assigns successive elements from that list to the variables given by the +'varName'+ arguments in order. If there are more variable names than -list elements, the remaining variables are set to the empty string. If there are more list ele- -ments than variables, a list of unassigned elements is returned. +list elements, the remaining variables are set to the empty string. If there are more list elements +than variables, a list of unassigned elements is returned. jim> lassign {1 2 3} a b; puts a=$a,b=$b 3 -- 2.11.4.GIT