[q-lang-cvs] q/doc qdoc.texi,1.146,1.147 version.texi,1.98,1.99

[Albert G. <ag...@us...>]

Update of /cvsroot/q-lang/q/doc
In directory sc8-pr-cvs16.sourceforge.net:/tmp/cvs-serv21765

Modified Files:
	qdoc.texi version.texi 
Log Message:
update documentation

Index: qdoc.texi
===================================================================
RCS file: /cvsroot/q-lang/q/doc/qdoc.texi,v
retrieving revision 1.146
retrieving revision 1.147
diff -C2 -d -r1.146 -r1.147
*** qdoc.texi	23 Jan 2008 07:09:07 -0000	1.146
--- qdoc.texi	22 Feb 2008 09:31:24 -0000	1.147
***************
*** 13546,13550 ****
  @code{lock} (wait for the mutex to be unlocked, then lock it and return
  @code{()}), @code{unlock} (unlock the mutex, return @code{()}) and
! @code{try} (lock the mutex if it is available, fail otherwise).
  
  @b{CAVEAT:} These operations are @emph{dangerous}, as you can easily
--- 13546,13555 ----
  @code{lock} (wait for the mutex to be unlocked, then lock it and return
  @code{()}), @code{unlock} (unlock the mutex, return @code{()}) and
! @code{try} (lock the mutex if it is available, fail otherwise). As of Q
! 7.11, on systems which support this functionality, the @code{try}
! operation can also be used with an argument of the form @code{(MUTEX,
! TIME)} to denote an absolute timeout value. This works analogously to
! the @code{await} operation on conditions, see @ref{Conditions}, for
! details.
  
  @b{CAVEAT:} These operations are @emph{dangerous}, as you can easily
***************
*** 13584,13588 ****
  public extern lock MUTEX;               // lock MUTEX
  public extern unlock MUTEX;             // unlock MUTEX
! public extern try MUTEX;                // try MUTEX
  @end smallexample
  
--- 13589,13593 ----
  public extern lock MUTEX;               // lock MUTEX
  public extern unlock MUTEX;             // unlock MUTEX
! public extern try MUTEX;                // try MUTEX, (MUTEX,TIME) for timeout
  @end smallexample
  
***************
*** 13639,13643 ****
  available), @code{get_size} or @code{#} which both return the current
  queue size, and @code{get_bound} which returns the queue size limit of a
! bounded semaphore (or zero if the semaphore is unbounded).
  
  Note that even with unbounded semaphores the maximum semaphore size is
--- 13644,13652 ----
  available), @code{get_size} or @code{#} which both return the current
  queue size, and @code{get_bound} which returns the queue size limit of a
! bounded semaphore (or zero if the semaphore is unbounded). As of Q 7.11,
! on systems which support this functionality, the @code{try} operation
! can also be used with an argument of the form @code{(SEM, TIME)} to
! denote an absolute timeout value. This works analogously to the
! @code{await} operation on conditions, see @ref{Conditions}, for details.
  
  Note that even with unbounded semaphores the maximum semaphore size is
***************
*** 13666,13670 ****
  public extern post SEM X;               // enqueue a value
  public extern get SEM;                  // dequeue a value
! public extern try SEM;                  // dequeue a value, fail if none
  
  public extern get_size SEM;             // get the current queue size
--- 13675,13679 ----
  public extern post SEM X;               // enqueue a value
  public extern get SEM;                  // dequeue a value
! public extern try SEM;                  // try SEM, (SEM,TIME) for timeout
  
  public extern get_size SEM;             // get the current queue size

Index: version.texi
===================================================================
RCS file: /cvsroot/q-lang/q/doc/version.texi,v
retrieving revision 1.98
retrieving revision 1.99
diff -C2 -d -r1.98 -r1.99
*** version.texi	23 Jan 2008 06:23:38 -0000	1.98
--- version.texi	22 Feb 2008 09:31:24 -0000	1.99
***************
*** 1,4 ****
! @set UPDATED 23 January 2008
! @set UPDATED-MONTH January 2008
  @set EDITION 7.11
  @set VERSION 7.11
--- 1,4 ----
! @set UPDATED 22 February 2008
! @set UPDATED-MONTH February 2008
  @set EDITION 7.11
  @set VERSION 7.11