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
|
