Update documentation and version to 0.74

Signed-off-by: Steve Bennett <steveb@workware.net.au>

4 files changed, 92 insertions, 68 deletions

diff --git a/Makefile.in b/Makefile.in
index b95b581..5d5a3f3 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -8,7 +8,7 @@ STRIP = @STRIP@
 # Configuration
 
 SH_CFLAGS ?= @SH_CFLAGS@
-SH_LDFLAGS ?= @SH_LDFLAGS@ @SH_SOPREFIX@libjim.@LIBSOEXT@.0.73
+SH_LDFLAGS ?= @SH_LDFLAGS@ @SH_SOPREFIX@libjim.@LIBSOEXT@.0.74
 SHOBJ_CFLAGS ?= @SHOBJ_CFLAGS@
 @if JIM_STATICLIB
 SHOBJ_LDFLAGS ?= @SHOBJ_LDFLAGS@
diff --git a/Tcl_shipped.html b/Tcl_shipped.html
index a687f09..fddfea8 100644
--- a/Tcl_shipped.html
+++ b/Tcl_shipped.html
@@ -883,6 +883,26 @@ Support for UDP, IPv6, Unix-Domain sockets in addition to TCP sockets
 Numbers with leading zeros are treated as decimal, not octal

 </p>

 </li>

+<li>

+<p>

+Add <a href="#_aio"><strong><code>aio</code></strong></a> <code>isatty</code>

+</p>

+</li>

+<li>

+<p>

+Add LFS (64 bit) support for <a href="#_aio"><strong><code>aio</code></strong></a> <code>seek</code>, <a href="#_aio"><strong><code>aio</code></strong></a> <code>tell</code>, <a href="#_aio"><strong><code>aio</code></strong></a> <code>copyto</code>, <a href="#_file"><strong><code>file</code></strong></a> <code>copy</code>

+</p>

+</li>

+<li>

+<p>

+<a href="#_string"><strong><code>string</code></strong></a> <code>compare</code> and <a href="#_string"><strong><code>string</code></strong></a> <code>equal</code> now support <em>-length</em>

+</p>

+</li>

+<li>

+<p>

+<a href="#_glob"><strong><code>glob</code></strong></a> now supports <em>-directory</em>

+</p>

+</li>

 </ol></div>

 </div>

 <div class="sect2">

@@ -4331,13 +4351,17 @@ for reading.</p></div>
 </div>

 <div class="sect2">

 <h3 id="_glob">glob</h3>

-<div class="paragraph"><p><code><strong>glob</strong> ?<strong>-nocomplain</strong>? <em>pattern ?pattern ...?</em></code></p></div>

+<div class="paragraph"><p><code><strong>glob</strong> ?<strong>-nocomplain</strong>? ?<strong>-directory</strong> <em>dir</em>? ?<strong>--</strong>? <em>pattern ?pattern ...?</em></code></p></div>

 <div class="paragraph"><p>This command performs filename globbing, using csh rules.  The returned

 value from <a href="#_glob"><strong><code>glob</code></strong></a> is the list of expanded filenames.</p></div>

 <div class="paragraph"><p>If <code>-nocomplain</code> is specified as the first argument then an empty

 list may be returned;  otherwise an error is returned if the expanded

 list is empty.  The <code>-nocomplain</code> argument must be provided

 exactly: an abbreviation will not be accepted.</p></div>

+<div class="paragraph"><p>If <code>-directory</code> is given, the <code><em>dir</em></code> is understood to contain a

+directory name to search in. This allows globbing inside directories

+whose names may contain glob-sensitive characters. The returned names

+are specified relative to this directory.</p></div>

 </div>

 <div class="sect2">

 <h3 id="_global">global</h3>

@@ -6726,27 +6750,27 @@ uid 1000 euid 1000 gid 100 egid 100</code></pre>
 <h3 id="_aio">aio</h3>

 <div class="dlist"><dl>

 <dt class="hdlist1">

-<code>$handle <strong>read ?-nonewline?</strong> <em>?len?</em></code>

+<code>$handle <strong>accept</strong></code>

 </dt>

 <dd>

 <p>

-    Read and return bytes from the stream. To eof if no len.

+    Server socket only: Accept a connection and return stream

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>gets</strong> <em>?var?</em></code>

+<code>$handle <strong>buffering none|line|full</strong></code>

 </dt>

 <dd>

 <p>

-    Read one line and return it or store it in the var

+    Sets the buffering mode of the stream.

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>puts ?-nonewline?</strong> <em>str</em></code>

+<code>$handle <strong>close</strong></code>

 </dt>

 <dd>

 <p>

-    Write the string, with newline unless -nonewline

+    Closes the stream

 </p>

 </dd>

 <dt class="hdlist1">

@@ -6760,11 +6784,11 @@ uid 1000 euid 1000 gid 100 egid 100</code></pre>
 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>flush</strong></code>

+<code>$handle <strong>eof</strong></code>

 </dt>

 <dd>

 <p>

-    Flush the stream

+    Returns 1 if stream is at eof

 </p>

 </dd>

 <dt class="hdlist1">

@@ -6777,71 +6801,72 @@ uid 1000 euid 1000 gid 100 egid 100</code></pre>
 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>eof</strong></code>

+<code>$handle <strong>flush</strong></code>

 </dt>

 <dd>

 <p>

-    Returns 1 if stream is at eof

+    Flush the stream

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>close</strong></code>

+<code>$handle <strong>gets</strong> <em>?var?</em></code>

 </dt>

 <dd>

 <p>

-    Closes the stream

+    Read one line and return it or store it in the var

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>seek</strong> <em>offset</em> <strong>?start|current|end?</strong></code>

+<code>$handle <strong>isatty</strong></code>

 </dt>

 <dd>

 <p>

-    Seeks in the stream (default <em>current</em>)

+    Returns 1 if the stream is a tty device.

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>tell</strong></code>

+<code>$handle <strong>ndelay ?0|1?</strong></code>

 </dt>

 <dd>

 <p>

-    Returns the current seek position

+    Set O_NDELAY (if arg). Returns current/new setting.

+    Note that in general ANSI I/O interacts badly with non-blocking I/O.

+    Use with care.

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>filename</strong></code>

+<code>$handle <strong>puts ?-nonewline?</strong> <em>str</em></code>

 </dt>

 <dd>

 <p>

-    Returns the original filename used when opening the file.

-    If the handle was returned from <a href="#_socket"><strong><code>socket</code></strong></a>, the type of the

-    handle is returned instead.

+    Write the string, with newline unless -nonewline

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>ndelay ?0|1?</strong></code>

+<code>$handle <strong>read ?-nonewline?</strong> <em>?len?</em></code>

 </dt>

 <dd>

 <p>

-    Set O_NDELAY (if arg). Returns current/new setting.

-    Note that in general ANSI I/O interacts badly with non-blocking I/O.

-    Use with care.

+    Read and return bytes from the stream. To eof if no len.

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>buffering none|line|full</strong></code>

+<code>$handle <strong>recvfrom</strong> <em>maxlen ?addrvar?</em></code>

 </dt>

 <dd>

 <p>

-    Sets the buffering mode of the stream.

+    Receives a message from the handle via recvfrom(2) and returns it.

+    At most <code><em>maxlen</em></code> bytes are read.

+    If <code><em>addrvar</em></code> is specified, the sending address of the message is stored in

+    the named variable in the form <em>addr:port</em>. See <a href="#_socket"><strong><code>socket</code></strong></a> for details.

 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>accept</strong></code>

+<code>$handle <strong>seek</strong> <em>offset</em> <strong>?start|current|end?</strong></code>

 </dt>

 <dd>

 <p>

-    Server socket only: Accept a connection and return stream

+    Seeks in the stream (default <em>current</em>)

 </p>

 </dd>

 <dt class="hdlist1">

@@ -6856,14 +6881,11 @@ uid 1000 euid 1000 gid 100 egid 100</code></pre>
 </p>

 </dd>

 <dt class="hdlist1">

-<code>$handle <strong>recvfrom</strong> <em>maxlen ?addrvar?</em></code>

+<code>$handle <strong>tell</strong></code>

 </dt>

 <dd>

 <p>

-    Receives a message from the handle via recvfrom(2) and returns it.

-    At most <code><em>maxlen</em></code> bytes are read.

-    If <code><em>addrvar</em></code> is specified, the sending address of the message is stored in

-    the named variable in the form <em>addr:port</em>. See <a href="#_socket"><strong><code>socket</code></strong></a> for details.

+    Returns the current seek position

 </p>

 </dd>

 </dl></div>

@@ -8071,7 +8093,7 @@ official policies, either expressed or implied, of the Jim Tcl Project.</code></
 <div id="footnotes"><hr /></div>

 <div id="footer">

 <div id="footer-text">

-Last updated 2012-09-11 11:21:08 EST

+Last updated 2013-07-22 11:07:02 EST

 </div>

 </div>

 </body>

diff --git a/jim.h b/jim.h
index 49e1909..9445522 100644
--- a/jim.h
+++ b/jim.h
@@ -128,7 +128,7 @@ extern "C" {
 /* Jim version numbering: every version of jim is marked with a
  * successive integer number. This is version 0. The first
  * stable version will be 1, then 2, 3, and so on. */
-#define JIM_VERSION 73
+#define JIM_VERSION 74
 
 #define JIM_OK 0
 #define JIM_ERR 1
diff --git a/jim_tcl.txt b/jim_tcl.txt
index 16d7891..5d83fd1 100644
--- a/jim_tcl.txt
+++ b/jim_tcl.txt
@@ -55,6 +55,10 @@ RECENT CHANGES
 Changes between 0.73 and 0.74
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 1. Numbers with leading zeros are treated as decimal, not octal
+2. Add `aio isatty`
+3. Add LFS (64 bit) support for `aio seek`, `aio tell`, `aio copyto`, `file copy`
+4. `string compare` and `string equal` now support '-length'
+5. `glob` now supports '-directory'
 
 Changes between 0.72 and 0.73
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -4404,54 +4408,55 @@ See `open` and `socket` for commands which return an I/O handle.
 
 aio
 ~~~
-+$handle *read ?-nonewline?* '?len?'+::
-    Read and return bytes from the stream. To eof if no len.
++$handle *accept*+::
+    Server socket only: Accept a connection and return stream
 
-+$handle *gets* '?var?'+::
-    Read one line and return it or store it in the var
++$handle *buffering none|line|full*+::
+    Sets the buffering mode of the stream.
 
-+$handle *puts ?-nonewline?* 'str'+::
-    Write the string, with newline unless -nonewline
++$handle *close*+::
+    Closes the stream
 
 +$handle *copyto* 'tofd ?size?'+::
     Copy bytes to the file descriptor +'tofd'+. If +'size'+ is specified, at most
     that many bytes will be copied. Otherwise copying continues until the end
     of the input file. Returns the number of bytes actually copied.
 
-+$handle *flush*+::
-    Flush the stream
++$handle *eof*+::
+    Returns 1 if stream is at eof
 
 +$handle *filename*+::
     Returns the original filename associated with the handle.
     Handles returned by `socket` give the socket type instead of a filename.
 
-+$handle *eof*+::
-    Returns 1 if stream is at eof
-
-+$handle *close*+::
-    Closes the stream
-
-+$handle *seek* 'offset' *?start|current|end?*+::
-    Seeks in the stream (default 'current')
++$handle *flush*+::
+    Flush the stream
 
-+$handle *tell*+::
-    Returns the current seek position
++$handle *gets* '?var?'+::
+    Read one line and return it or store it in the var
 
-+$handle *filename*+::
-    Returns the original filename used when opening the file.
-    If the handle was returned from `socket`, the type of the
-    handle is returned instead.
++$handle *isatty*+::
+    Returns 1 if the stream is a tty device.
 
 +$handle *ndelay ?0|1?*+::
     Set O_NDELAY (if arg). Returns current/new setting.
     Note that in general ANSI I/O interacts badly with non-blocking I/O.
     Use with care.
 
-+$handle *buffering none|line|full*+::
-    Sets the buffering mode of the stream.
++$handle *puts ?-nonewline?* 'str'+::
+    Write the string, with newline unless -nonewline
 
-+$handle *accept*+::
-    Server socket only: Accept a connection and return stream
++$handle *read ?-nonewline?* '?len?'+::
+    Read and return bytes from the stream. To eof if no len.
+
++$handle *recvfrom* 'maxlen ?addrvar?'+::
+    Receives a message from the handle via recvfrom(2) and returns it.
+    At most +'maxlen'+ bytes are read.
+    If +'addrvar'+ is specified, the sending address of the message is stored in
+    the named variable in the form 'addr:port'. See `socket` for details.
+
++$handle *seek* 'offset' *?start|current|end?*+::
+    Seeks in the stream (default 'current')
 
 +$handle *sendto* 'str ?hostname:?port'+::
     Sends the string, +'str'+, to the given address via the socket using sendto(2).
@@ -4459,11 +4464,8 @@ aio
     ways for other handle types.
     Returns the number of bytes written.
 
-+$handle *recvfrom* 'maxlen ?addrvar?'+::
-    Receives a message from the handle via recvfrom(2) and returns it.
-    At most +'maxlen'+ bytes are read.
-    If +'addrvar'+ is specified, the sending address of the message is stored in
-    the named variable in the form 'addr:port'. See `socket` for details.
++$handle *tell*+::
+    Returns the current seek position
 
 fconfigure
 ~~~~~~~~~~