[Checkins] SVN: zc.async/trunk/src/zc/async/ address XXX items in TODO

[Gary Poster]

Log message for revision 91293:
  address XXX items in TODO

Changed:
  U   zc.async/trunk/src/zc/async/CHANGES.txt
  U   zc.async/trunk/src/zc/async/TODO.txt

-=-
Modified: zc.async/trunk/src/zc/async/CHANGES.txt
===================================================================
--- zc.async/trunk/src/zc/async/CHANGES.txt	2008-09-20 23:03:02 UTC (rev 91292)
+++ zc.async/trunk/src/zc/async/CHANGES.txt	2008-09-21 00:26:00 UTC (rev 91293)
@@ -66,11 +66,24 @@
 - zc.async events inherit from 'zc.component.interfaces.IObjectEvent' instead
   of a zc.async specific IObjectEvent (thanks to Satchit Haridas).
 
-- Added new monitoring and introspection tools XXX
+- Added new monitoring and introspection tools: the ``asyncdb`` zc.monitor
+  command (and, for Python, the code in monitordb.py).  This code provides
+  easy spellings to examine the database's view of what is happening in
+  zc.async.  Because it is the database, it also has a much longer historical
+  view than the ``async`` tools.  The best way to learn about these tools is
+  to read the extensive documentation provided within zc.monitor by
+  using ``asyncdb help`` and ``asyncdb help <TOOL NAME>``.
 
-- Added new preferred way of filtering agent choices: ``filter`` attribute XXX
+- Added new preferred way of filtering agent choices: the new ``filter``
+  attribute.  Using filters, rather than "choosers," allows several ``asyncdb``
+  tools to filter pending jobs based on what an agent is willing to do.  It
+  also is a smaller contract, and so a filter requires less code than a chooser
+  in the common case.  On the other hand, using a filter alone doesn't allow
+  the agent to try to *prefer* certain tasks.
 
-- deprecated agent.chooseFirst XXX
+- Deprecated agent.chooseFirst.  It is no longer necesary, since an agent
+  without a chooser and with a filter of None has the same behavior.  It is
+  retained for legacy databases.
 
 - Moved deprecated legacy code to new ``legacy`` module.
 

Modified: zc.async/trunk/src/zc/async/TODO.txt
===================================================================
--- zc.async/trunk/src/zc/async/TODO.txt	2008-09-20 23:03:02 UTC (rev 91292)
+++ zc.async/trunk/src/zc/async/TODO.txt	2008-09-21 00:26:00 UTC (rev 91293)
@@ -1,12 +1,9 @@
-- need to show in monitordb test that completed, in-agent, and pending jobs
-  do a merge sort (esp. completed, because this is important to the semantics
-  of lastcompleted.
-- fill out XXXs in CHANGES
-
+- verify that main docs now show that zc.monitor has much fewer dependencies,
+  so can be introduced without Zope 3.
 - fix up tips so that it looks better
 - write a zc.buildout/grok quickstart
+- would love a module-based API review of docs.
 
-
 Improvements
 
 - queues should be pluggable like agent with filter