<?xml version="1.0" encoding="windows-1252"?>
<node id="625133" title="watcher" created="2007-07-05 17:34:00" updated="2011-08-31 12:59:47">
<type id="15">
user</type>
<author id="625133">
watcher</author>
<data>
<field name="doctext">
&lt;h1&gt;Enhanced Extra-sensory Custom Thread Activity Monitorer&lt;/h1&gt;
&lt;table width="100%" border=15 cellpadding=40&gt;&lt;tr&gt;&lt;td align=center&gt;
&lt;center&gt;
&lt;h2&gt;&lt;i&gt;NB: the watcher service has been deactivated indefinitely&lt;/i&gt;&lt;/h2&gt;
&lt;p&gt;&lt;i&gt;unfortunately, the host on which the bot was developed has bit the big one. 
&lt;br/&gt;watcher will have to be built from scratch. 
&lt;br/&gt;there are currently no plans to do this. 
&lt;br/&gt;[jdporter|I] apologize for the inconvenience and confusion.
&lt;br/&gt;now [href://?op=randomnode;types=monkdiscuss,perlquestion,perlmeditation,cufp|go do something else].&lt;/i&gt;&lt;/p&gt;
&lt;/center&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;p&gt;
Hi! I watch threads for you.
Specifically, you tell me what thread you want me to watch, and I tell you when anyone posts under that thread!
Isn't that &lt;i&gt;keen?&lt;/i&gt;
&lt;/p&gt;
&lt;p&gt;
Here's how it works:
&lt;ol&gt;
&lt;li&gt; Tell me to watch a thread by sending [watcher|me] a [/msg|private&amp;nbsp;message] like so:
&lt;blockquote&gt;
 &lt;tt&gt;/msg&amp;nbsp;watcher&amp;nbsp;watch&amp;nbsp;&lt;i&gt;987654&lt;/i&gt;&lt;/tt&gt;
&lt;/blockquote&gt;
 (use the number of the node you're interested in, of course) &lt;/li&gt;&lt;p&gt;&lt;/p&gt;
&lt;li&gt; Sit by your [Message Inbox], waiting for me to notify you when someone has posted under that node! &lt;/li&gt;
&lt;/ol&gt;
&lt;/p&gt;

&lt;h2&gt;Commands&lt;/h2&gt;
&lt;h3&gt;watch&lt;/h3&gt;
&lt;blockquote&gt;
 &lt;tt&gt;/msg&amp;nbsp;watcher&amp;nbsp;watch&amp;nbsp;&lt;i&gt;987654&lt;/i&gt;&lt;/tt&gt;
&lt;/blockquote&gt;
&lt;p&gt;
Note that the node you choose to watch does &lt;i&gt;not&lt;/i&gt; need to be a root node! It can be any node!  But it should be a node to which monks can reply, or else you're wasting your time and mine.
&lt;/p&gt;
&lt;h3&gt;unwatch&lt;/h3&gt;
&lt;p&gt;
When you get tired of all the notifications you're getting from a very popular thread, you can tell me to stop sending them to you with the &lt;tt&gt;unwatch&lt;/tt&gt; command:
&lt;blockquote&gt;
 &lt;tt&gt;/msg&amp;nbsp;watcher&amp;nbsp;unwatch&amp;nbsp;&lt;i&gt;987654&lt;/i&gt;&lt;/tt&gt;
&lt;/blockquote&gt;
This completely removes it from the watchlist (for you); it's as if you had never asked me to watch it in the first place. (That is what you wanted, isn't it?)
&lt;/p&gt;
&lt;h3&gt;watches&lt;/h3&gt;
&lt;p&gt;
If you ever want to know what watches are currently active for you, send me the command &lt;tt&gt;watches&lt;/tt&gt; -
&lt;blockquote&gt;
 &lt;tt&gt;/msg&amp;nbsp;watcher&amp;nbsp;watches&lt;/tt&gt;
&lt;/blockquote&gt;
&lt;/p&gt;

&lt;h2&gt;Remember...&lt;/h2&gt;
&lt;p&gt;
I act only periodically.  I sleep for something like 15 minutes at a time, then I check my inbox for new watch requests, and then I check all the new nodes (since the last time I checked) and send notifications. Then I go back to sleep.  So when you send me a &lt;tt&gt;watch&lt;/tt&gt; command, don't expect instantaneous feedback.
&lt;/p&gt;

&lt;h2&gt;Product Still Under Pressur^WDevelopment&lt;/h2&gt;

&lt;p&gt;
This service is quite unstable.  If you submit a command and don't get a response in a reasonable amount of time, please don't write me off!  Thank you for beta testing me. :-)
&lt;/p&gt;&lt;p&gt;
During downtimes when the code is under development,
I may send you a status message, lest you think that I'm
simply broken and stuck in limbo.
&lt;/p&gt;&lt;p&gt;
Also, the service is hosted on perlmonk.org, which means it could go down without notice, and possibly never return. Them's the breaks.
&lt;/p&gt;

&lt;h3&gt;Enhancements partially implemented:&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt; expiration: a node watch is automatically removed from the watchlist after a certain period of time, say, 6 months. &lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;Future Enhancements:&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt; Don't notify people about their own posts. &lt;/li&gt;
&lt;li&gt; As an option, don't notify people about direct replies to their own posts. &lt;/li&gt;
&lt;li&gt; Customizable expiration periods - in case the default (say, 6 months) is not to your liking. &lt;/li&gt;
&lt;li&gt; Customizable feedback levels - More verbosity for you lonely types. &lt;/li&gt;
&lt;li&gt; Watching more than single discrete nodes: nodes selected by regex on title, or by metadata (such as author, date, etc.), and so on. &lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;Warning&lt;/h2&gt;
&lt;p&gt;
Please do not send me any other kind of message!
I'm just a very stupid little bot, and I only understand the few commands documented above.
Any other message you send to me will be most quizzically bounced.
If you have questions about how [watcher|I] work, please direct them to my creator, [jdporter].
&lt;/p&gt;

&lt;h2&gt;History&lt;/h2&gt;
&lt;p&gt;
I was summoned into existence by the combined incessant supplications (I might say &lt;i&gt;whingings&lt;/i&gt;) of the Monks of St. Hubris the Petulant.  For example, see the following threads:
&lt;ul&gt;
&lt;li&gt; [id://2799] &lt;/li&gt;
&lt;li&gt; [id://57417] &lt;/li&gt;
&lt;li&gt; [id://69625] &lt;/li&gt;
&lt;li&gt; [id://132218] &lt;/li&gt;
&lt;li&gt; [id://167486] &lt;/li&gt;
&lt;li&gt; [id://242984] &lt;/li&gt;
&lt;li&gt; [id://272905] &lt;/li&gt;
&lt;li&gt; [id://293194] &lt;/li&gt;
&lt;li&gt; [id://293688] &lt;/li&gt;
&lt;li&gt; [id://422995] &lt;/li&gt;
&lt;li&gt; [id://453922] &lt;/li&gt;
&lt;li&gt; [id://467090] &lt;/li&gt;
&lt;li&gt; [id://553377] &lt;/li&gt;
&lt;/ul&gt;
and lastly, the announcement of my birth:
&lt;ul&gt;
&lt;li&gt; [id://625902] &lt;/li&gt;
&lt;/ul&gt;
&lt;/p&gt;

</field>
<field name="lasttime">
2011-08-31 13:00:28</field>
<field name="experience">
0</field>
<field name="user_scratchpad">
0</field>
<field name="imgsrc">
625947</field>
<field name="timeformat">
%Y-%m-%d %H:%M:%S %Z</field>
<field name="numwriteups">
</field>
<field name="location">
perlmonk.org&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Image:&lt;/td&gt;&lt;td&gt;&lt;a href="http://www.fotosearch.com/BDX234/bxp40503/"&gt;Source&lt;/a&gt; (used without permission)</field>
<field name="timezone">
</field>
<field name="codewrapoff">
</field>
<field name="codewraplength">
</field>
<field name="codeautowrap">
</field>
<field name="codeprefix">
</field>
<field name="codebig">
</field>
</data>
</node>
