Short:        Simple task synchroniser
Author:       megacz@usa.com
Uploader:     megacz usa com
Type:         util/cli
Version:      0.3
Requires:     68000+/os2.04+
Architecture: m68k-amigaos

waitback-0.3
--------------

---

This is 'waitback' a much better sync. than system 'wait'.

---

NOTES:

Requires 68000+, OS 2.04+, 8192+ bytes of free memory

Returns 0 if task wasnt found and 5 upon successful operation.

Outputs text if it wasnt able to find requested task, so you may like
to >nil: it.

---

NEWS:
     [09-Mar-2009]  0.3  Cleaner, better, quicker
     [25-May-2008]  0.2  Last example didnt work, due to fact
                         that the value was 0(no checks...).
---

USAGE:

 *** template: waitback <task/a> [arg] [timeout/n] [ic/s]

         <task/a>  -  name of a task or process, you can specify exact 
                      "taskname" or exact "[procname]" or partial name 
                      together with [ic/s], or task address($XXXXXXXX,
                      0xX[XXXXXXX]) or CLI number.

      [timeout/n]  -  timeout, 10 seconds by default, one check per sec.

            [arg]  -  where to search for a <task/a>:

                      t  -  in tasks (default)
                      p  -  in ports
                      b  -  both

           [ic/s]  -  ignores case and does patternal search.

---                                                            

EXAMPLES:

   ; sync with exact name(CLI process)
   run >nil: c:task
   waitback [c:task]

   ; sync with exact name if task creates port = 'TASK'
   run >nil: task
   waitback TASK p

   ; sync Workbench program and give up after 5 seconds
   wbrun task
   waitback task 5

   ; try detect some task at all
   waitback >nil: task 1 ic
   if warn
     echo "found!"
   else
     echo "not found!"
   endif

---
megacz@usa.com