home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / x / volume10 / contool / part01 / README < prev    next >
Text File  |  1990-10-30  |  7KB  |  174 lines
  1. /************************************************************************/
  2. /*    Copyright 1988-1990 by Chuck Musciano and Harris Corporation    */
  3. /*                                    */
  4. /*    Permission to use, copy, modify, and distribute this software    */
  5. /*    and its documentation for any purpose and without fee is    */
  6. /*    hereby granted, provided that the above copyright notice    */
  7. /*    appear in all copies and that both that copyright notice and    */
  8. /*    this permission notice appear in supporting documentation, and    */
  9. /*    that the name of Chuck Musciano and Harris Corporation not be    */
  10. /*    used in advertising or publicity pertaining to distribution    */
  11. /*    of the software without specific, written prior permission.    */
  12. /*    Chuck Musciano and Harris Corporation make no representations    */
  13. /*    about the suitability of this software for any purpose.  It is    */
  14. /*    provided "as is" without express or implied warranty.  This     */
  15. /*    software may not be sold without the prior explicit permission    */
  16. /*    of Harris Corporation.                        */
  17. /************************************************************************/
  18.  
  19.      Contool Version 3.0
  20.      
  21.      Contool will capture and display system console messages with timestamps.
  22. It is a replacement for the standard Sun console, which is created with 
  23. "cmdtool -C".  Contool will flash its icon and beep when messages are written
  24. to the icon, so you can keep it closed on your desktop until a message arrives.
  25. You can modify this beeping and flashing behavior; see the man page for more
  26. details.
  27.  
  28.      You can instruct contool to filter and ignore certain common console
  29. messages.  The man page explains how to create a file of filters in 
  30. ~/.contool; the included sample.filter is how my filters are set up.  You
  31. can modify this to suit yourself, and copy it to ~/.contool.
  32.  
  33.      This version of contool will only work with Open Windows 2.0, from Sun,
  34. or the XView 2.0 libraries available via anonymous FTP from expo.lcs.mit.edu.
  35. In either case, obviously, you'll need to be running some version of X Windows.
  36.  
  37.      There are no plans to produce a SunView version of contool 3.0.
  38.      
  39.      Before building contool, you need to check several site dependencies
  40. in the Makefile.  These dependencies are:
  41.  
  42.     In Makefile:
  43.         BIN        Where the executable will go, normally
  44.                 /usr/local/bin
  45.  
  46.         MANDIR        Where the man page will go, normally
  47.                 /usr/man/manl
  48.  
  49.         MANEXT        The man page extension, usually 'l',
  50.                 for local man pages.  You may want to
  51.                 make MANDIR /usr/man/man1, in which case
  52.                 MANEXT should be '1'.
  53.  
  54.         HELPDIR        Where the context-sensitive help file
  55.                 will be stored.
  56.  
  57.         ICON_PATH    Path to search (at runtime) for other
  58.                 icon files.  This path will only be used
  59.                 if the user does not have the ICON_PATH
  60.                 environment variable defined.  Should
  61.                 consist of a various directories
  62.                 separated by colons.
  63.  
  64.         OPENWINHOME    Where you installed Open Windows.
  65.                 Alternately, where you installed the
  66.                 XView toolkit shipped with X11R4.  Must
  67.                 be a directory with a child directory
  68.                 named "include" which contains X and
  69.                 XView include files.
  70.  
  71.         LDFLAGS        Where ld can find your XView libraries.
  72.                 If you compile with Open Windows, the
  73.                 default value should be correct.  If you
  74.                 are using the X11 XView libraries, you
  75.                 may need to modify this value.
  76.  
  77.         CPPFLAGS    Where cpp can find your XView include
  78.                 files.  If you compile with Open Windows,
  79.                 the default value should be correct.  If
  80.                 you are using the X11 XView toolkit, you
  81.                 may need to modify this value.
  82.  
  83. Once you have adjusted these values, just type "make contool" or "make
  84. install".  
  85.  
  86.      Contool honors window command line options, described in xview(1),
  87. so you can change the default window size, icon position, etc.  We like
  88. to bring contool up closed, using "-Wi".
  89.  
  90.      Comments, bugs, to me, please.  I would be very interested in your 
  91. impressions of contool and any suggestions you might have to make it better.
  92. By the way, there are a few convenient untility routines in misc.c you might
  93. find useful in other programs you are writing.
  94.  
  95. Chuck Musciano
  96. Advanced Technology Department
  97. Harris Corporation
  98. PO Box 37, MS 3A/1912
  99. Melbourne, FL 32902
  100. (407) 727-6131
  101. ARPA: chuck@trantor.harris-atd.com
  102.  
  103. ******************************** KNOWN XVIEW BUG ********************************
  104. *                                        *
  105. *      It is a known bug in XView that if you bring up a dialog box with the    *
  106. * pushpin out (the default) and display a menu without selecting an item from    *
  107. * the menu, the dialog box will be closed.  This can be demonstrated in contool    *
  108. * by bringing up the edit filters window, and displaying the "edit" menu     *
  109. * without selecting an action.                            *
  110. *                                        *
  111. *      This bug has been reported to Sun, but will not be fixed until version    *
  112. * 3.0 of XView.                                    *
  113. *                                        *
  114. *********************************************************************************
  115.  
  116. *********************************************************************************
  117. *                Change history                    *
  118. *********************************************************************************
  119.  
  120.          1.0    20 Jun 88    Original release
  121.          1.1    30 Jun 88    Added -p option to pop open when messages
  122.                         arrive.  Suggested by Doug Lind
  123.                         (lind@perron.ms.washington.edu).
  124.                      Added alternate icon sets for more attractive
  125.                         appearance when messages arrive.  Alternate
  126.                         set two is from David Eckelcamp 
  127.                         (eckelcamp@mcc.com).
  128.                      Cleaned up Makefile.  Again, courtesy of
  129.                         David Eckelcamp.
  130.     2.0    23 Aug 88    Added automatic reload of filters when
  131.                    filter file is modified.  Suggested by
  132.                    Craig Musicant (cmusican@stanford.prime.com).
  133.                 Filter strings are now regular expressions.
  134.                    Provided by jqj@hogg.cc.uoregon.edu.
  135.                 Reworked frame menu, based upon diffs posted
  136.                    to sun-source@titan.rice.edu.
  137.                 Added protection from overflowing the text edit
  138.                    window when too many messages arrive.
  139.                 Filters can now be read from any file, not
  140.                    just ~/.contool.
  141.     2.1    10 Feb 89    Added logging capability, courtesy of
  142.                    Gregory Bond (gnb@melba.bby.oz.au).
  143.     2.2    19 Sep 89    Added filter editing.
  144.                 Added icon pathname completion, courtesy of
  145.                    Mike Arms (sandia!marms@unmvax.cs.unm.edu).
  146.                 Added moving the blinking icon to the front,
  147.                    courtesy of Peter Lennevi
  148.                    (etxlevi@solsta.ericsson.se).
  149.                 Changed icon loading to use ICON_PATH, and
  150.                    supported ~ expansion, suggested by
  151.                    Larry Virden (osu-cis!chemabs!lwv27).
  152.                 Fixed multiple message alert handling,
  153.                    as suggested by Ellery Chan
  154.                    (ellery@trantor.harris-atd.com).
  155.     3.0     6 Jun 90    Ported to XView toolkit, running under
  156.                    Open Windows 2.0.
  157.                 Reworked interface to be OPEN LOOK
  158.                    compliant.
  159.                 Added saving of default actions to
  160.                    filter file.
  161.                 Removed large number of command line
  162.                    options in lieu of properties
  163.                    dialog box.
  164.                 Added ability to associate a command
  165.                    to be executed when a message arrives.
  166.                 Added explicit filter reset capability.
  167.                 Added the ability to print the contents
  168.                    of the console.  Suggested by 
  169.                    Danielle Heinzer
  170.                    (ESC1298%ESOC.BITNET@cunyvm.cuny.edu).
  171.                 Reworked console overflow handling,
  172.                    courtesy of Matt Cohen
  173.                    (sysnmc@magic706.chron.com).
  174.