*** empty log message ***

[software/libev.git] / ev.html
diff --git a/ev.html b/ev.html

index ec6eb1b1a758343a533224ea74614591d2d566f7..6c59bec08be24636d641d47ec68afa693bd834ce 100644 (file)
--- a/ev.html
+++ b/ev.html
@@ -6,7 +6,7 @@
         <meta name="description" content="Pod documentation for libev" />
         <meta name="inputfile" content="&lt;standard input&gt;" />
         <meta name="outputfile" content="&lt;standard output&gt;" />
         <meta name="description" content="Pod documentation for libev" />
         <meta name="inputfile" content="&lt;standard input&gt;" />
         <meta name="outputfile" content="&lt;standard output&gt;" />
-       <meta name="created" content="Wed Nov 28 12:27:27 2007" />
+       <meta name="created" content="Wed Nov 28 19:29:25 2007" />
         <meta name="generator" content="Pod::Xhtml 1.57" />
  <link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
  <body>
         <meta name="generator" content="Pod::Xhtml 1.57" />
  <link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
  <body>
@@ -135,12 +135,13 @@ watcher.</p>
  </div>
  <h1 id="FEATURES">FEATURES</h1>
  <div id="FEATURES_CONTENT">
  </div>
  <h1 id="FEATURES">FEATURES</h1>
  <div id="FEATURES_CONTENT">
-<p>Libev supports <code>select</code>, <code>poll</code>, the linux-specific <code>epoll</code>, the
-bsd-specific <code>kqueue</code> and the solaris-specific event port mechanisms
-for file descriptor events (<code>ev_io</code>), relative timers (<code>ev_timer</code>),
-absolute timers with customised rescheduling (<code>ev_periodic</code>), synchronous
-signals (<code>ev_signal</code>), process status change events (<code>ev_child</code>), and
-event watchers dealing with the event loop mechanism itself (<code>ev_idle</code>,
+<p>Libev supports <code>select</code>, <code>poll</code>, the Linux-specific <code>epoll</code>, the
+BSD-specific <code>kqueue</code> and the Solaris-specific event port mechanisms
+for file descriptor events (<code>ev_io</code>), the Linux <code>inotify</code> interface
+(for <code>ev_stat</code>), relative timers (<code>ev_timer</code>), absolute timers
+with customised rescheduling (<code>ev_periodic</code>), synchronous signals
+(<code>ev_signal</code>), process status change events (<code>ev_child</code>), and event
+watchers dealing with the event loop mechanism itself (<code>ev_idle</code>,
  <code>ev_embed</code>, <code>ev_prepare</code> and <code>ev_check</code> watchers) as well as
  file watchers (<code>ev_stat</code>) and even limited support for fork events
  (<code>ev_fork</code>).</p>
  <code>ev_embed</code>, <code>ev_prepare</code> and <code>ev_check</code> watchers) as well as
  file watchers (<code>ev_stat</code>) and even limited support for fork events
  (<code>ev_fork</code>).</p>
@@ -231,13 +232,14 @@ might be supported on the current system, you would need to look at
  recommended ones.</p>
                 <p>See the description of <code>ev_embed</code> watchers for more info.</p>
         </dd>
  recommended ones.</p>
                 <p>See the description of <code>ev_embed</code> watchers for more info.</p>
         </dd>
-       <dt>ev_set_allocator (void *(*cb)(void *ptr, size_t size))</dt>
+       <dt>ev_set_allocator (void *(*cb)(void *ptr, long size))</dt>
         <dd>
         <dd>
-               <p>Sets the allocation function to use (the prototype and semantics are
-identical to the realloc C function). It is used to allocate and free
-memory (no surprises here). If it returns zero when memory needs to be
-allocated, the library might abort or take some potentially destructive
-action. The default is your system realloc function.</p>
+               <p>Sets the allocation function to use (the prototype is similar - the
+semantics is identical - to the realloc C function). It is used to
+allocate and free memory (no surprises here). If it returns zero when
+memory needs to be allocated, the library might abort or take some
+potentially destructive action. The default is your system realloc
+function.</p>
                 <p>You could override this function in high-availability programs to, say,
  free some memory if it cannot allocate memory, to use a special allocator,
  or even to sleep a while and retry until some memory is available.</p>
                 <p>You could override this function in high-availability programs to, say,
  free some memory if it cannot allocate memory, to use a special allocator,
  or even to sleep a while and retry until some memory is available.</p>
@@ -1248,6 +1250,8 @@ not exist&quot; is a status change like any other. The condition &quot;path does
  not exist&quot; is signified by the <code>st_nlink</code> field being zero (which is
  otherwise always forced to be at least one) and all the other fields of
  the stat buffer having unspecified contents.</p>
  not exist&quot; is signified by the <code>st_nlink</code> field being zero (which is
  otherwise always forced to be at least one) and all the other fields of
  the stat buffer having unspecified contents.</p>
+<p>The path <i>should</i> be absolute and <i>must not</i> end in a slash. If it is
+relative and your working directory changes, the behaviour is undefined.</p>
  <p>Since there is no standard to do this, the portable implementation simply
  calls <code>stat (2)</code> regularly on the path to see if it changed somehow. You
  can specify a recommended polling interval for this case. If you specify
  <p>Since there is no standard to do this, the portable implementation simply
  calls <code>stat (2)</code> regularly on the path to see if it changed somehow. You
  can specify a recommended polling interval for this case. If you specify