wmload/README

   1 >================================================<
   2 wmload - WindowMaker load gauge
   3 Updated, cleaned up and "fixed"
   4 ==================================================
   5 VERSION: 0.9.2
   6 RELEASE DATE: 17 July 1997
   7
   8         -Minor cosmetic changes.
   9          The graph zone is now perfectly square, 54x54.
  10          <I didn't like it's odd width! (;-)>
  11
  12         -All values dealing with pixmap size have been
  13          adjusted to accomodate the new `look'.
  14
  15 VERSION: 0.9.1
  16 RELEASE DATE: 8 July 1997
  17
  18         -Uses correct ordering of PROC data.
  19
  20         -Increases the differentiation between tones,
  21          just a smidgion.
  22
  23         -Catches a "Once In A Blue Moon" condition.
  24            Under various circumstances rounding error
  25            results in a pixel count of 55 or 53.
  26            To prevent the 55 count from writing one
  27            pixel into the edge of the frame, wmload
  28            now catches these occurrences and corrects
  29            for them.
  30
  31 VERSION: 0.9.0
  32 RELEASE DATE: 6 July 1997
  33
  34         -Fixed the grayscale problem that occurred
  35          whenever the "-shape" argument was used.
  36
  37         -Implemented the "-led" argument...
  38          ...the last release had the argument,
  39          however it wasn't implemented...
  40          ...ie: it did nothing.
  41          Called without the "-led" argument, wmload
  42          uses it's default color "LightSeaGreen"
  43          [which is the same as the asclock readout].
  44          Called with the argument, it uses the
  45          named color. If the default color is
  46          unavailable, or the named color is invalid,
  47          wmload simply uses the 3 green tones
  48          found in the "back.xpm" pixmap.
  49
  50         -Added a "-ver" argument...
  51          When used, it prints the current version
  52          on stdout. If it is called alone with no
  53          other arguments, wmload exits after
  54          printing its' version. Called with other
  55          arguments... wmload prints its' version
  56          and continues as normal.
  57
  58         -Trapped bad arguments that don't start
  59          with "-".
  60
  61         -Cleaned up the code a bit.
  62
  63         -Removed unnecessary files from the
  64          distribution. <kept README's though>
  65
  66 NOTE:
  67         This is a load monitor which is designed
  68         to work with the PROC filesystem. Generally
  69         all Linux systems come with the PROC fs.
  70         If you're using a different Unix and it
  71         doesn't have the PROC fs, first see if
  72         there is one available... otherwise this
  73         monitor won't work!
  74         Work is currently underway to produce a
  75         more `portable' wmload that Solaris/Sun/HP etc.
  76         users can also enjoy.
  77
  78 INSTALL:
  79         1. Check the Imakefile to see if all the
  80            LIBS are ok for your system.
  81            ALSO, check DESTDIR and BINDIR; as they
  82            are now, a `make install' will put the
  83            wmload binary in /usr/local/bin.
  84         2. `xmkmf'
  85         3. `make'
  86         4. `make install'
  87         5. Enjoy!!!! (;-)
  88
  89 SUGGESTED INVOCATION (for WindowMaker!):
  90         `wmload -shape -withdrawn &'
  91
  92         OR for a different graph color:
  93         `wmload -led ??? -shape -withdrawn &'
  94         ...replace "???" with a color name
  95         eg. green, red, orange, yellow, orchid, purple....
  96         any of your systems standard X color symbols.
  97
  98 SUGGESTED INVOCATION (for AfterStep):
  99         To load wmload in Wharf, add a line in .steprc:
 100 *Wharf wmload nil MaxSwallow "wmload" wmload -led green -shape &
 101         ...or to run it as a normal app: wmload -led "???" &
 102         NOTE: AfterStep doesn't require the "-withdrawn" option.
 103
 104 AVAILABILITY:
 105         The latest release should be available from:
 106                 ftp://afterstep.foo.net/pub/apps/wmload/
 107                 http://www.bc1.com/users/rland/
 108
 109 TODO LIST:
 110         -Implement alternative `load' algorithms?
 111
 112 LIABILITY & USABILITY:
 113         As usual, this software is bound by the
 114         GNU public license. You can use it however
 115         you see fit, as long as all the README's
 116         accompany any copy/version of it.
 117         THE KIND SOLES WHO HAVE WRITTEN/CONTRIBUTED
 118         TO THIS SOFTWARE, IN NO WAY ACCEPT LIABILITY
 119         OR ANY RESPONSIBILITY FOR THE USE OF, OR FOR
 120         ANY CONSEQUENCES RESULTING FROM THE USE OF
 121         THIS SOFTWARE.
 122         ...that having been said, I think you'll
 123         like this new version and shouldn't have
 124         problems with it. Happy load monitoring!
 125
 126 FEEDBACK etc:
 127         Maintainer of the current version...
 128         Ryan Land, rland@bc1.com
 129
 130
 131
 132                      ---<o>---
 133
 134
 135
 136 the contents of the initial WM patch and original
 137 asload README's now follow...
 138
 139 >================================================<
 140 wmload - WindowMaker performance monitor
 141 adapted from asload by Nic Bernstein
 142 ==================================================
 143         added withdrawn option, added WM hints.
 144         changed trace color
 145
 146
 147 original README contents follow...
 148
 149 >================================================<
 150 asload - afterstep performance monitor
 151 the best perfmonitor for the best X-windowmanager!
 152 ==================================================
 153
 154 RELEASE 1
 155       30th November 1996
 156       by Beat Christen, bchriste@iiic.ethz.ch
 157
 158
 159 VERSION 0.1
 160
 161
 162 AVAILABILITY
 163      the latest release should be available from
 164
 165      ftp://sunsite.unc.edu/pub/Linux/X11/xutils/asload.tgz
 166      http://rif3.ethz.ch:1313/spiff/asload/asload.tgz
 167
 168 INSTALL
 169      1. Check in the Imakefile if all LIBS are ok for your system.
 170      2. `make` (Send me the output if this fails)
 171
 172
 173 TODO
 174     write a todo list.
 175
 176 FEEDBACK
 177     I prefer uuencoded mail.
 178     You can register this software at
 179       http://rif3.ethz.ch:1313/spiff/asload/register.html
 180
 181 AUTHOR
 182     Beat Christen
 183
 184 CONTRIBUTORS
 185
 186 CHANGES
 187     28Nov96  First Version for Linux /proc
 188
 189 END OF FILE