Short Note---------------------------------------------------------------------:
|This package contains the Bitstream Vera font. Its copyright is incorporated  |
|into the font, and can be found in the file Vera.txt.                         |
|The complete family can be downloaded from:                                   |
|      http://ftp.gnome.org/pub/GNOME/sources/ttf-bitstream-vera               |
:------------------------------------------------------------------------------:

And now: WMFORKPLOP ( http://hules.free.fr/wmforkplop )

  This is yet another dockapp, that you may found stupid, blinky, annoying, and
occasionaly useful. 

  It is a blend of wmhdplop (for the appearance and the code, see
http://hules.free.fr/wmhdplop) and wmtop ( a bonsaified version of "top", one
of the most useful dockapps in my opinion, http://wmtop.sourceforge.net/ ).

  Each time a new process is created, and each time another one dies, a spot
light appears on the applet and evolves. wmforkplop also display the top cpu
consuming processes, just like wmtop. It also has a (humble) process browser
(clic in the applet to bring it), which gives more informations about each
process, and hability to kill a specific process, or "killall" all process who
have the same name.


* How to enjoy wmforkplop:
  "./configure" scripts generate a lot of activity in wmforkplop. Compiling the
  kernel is also a great source of forks. 


* Requirements:
  - Imlib2 [ http://www.enlightenment.org/pages/imlib2.html ], for the blinks.
  - libgtop2 [ http://ftp.gnome.org/pub/GNOME/sources/libgtop ], for the stats.


* Portability:
  It should be portable on all Linux kernel flavours. Since one of libgtop2
  aims is portability, it should also run on any unix flavour, as long as the
  informations needed by wmforktop are available.


* Compilation/installation:
  ./configure && make 
  make install


* Informations of the "top" list
  For each process whose cpu consumption exceed 2%, wmforkplop displays

     - its name. Three colors are possible: white => one of your processes,
     violet => root process, green => process of another user.
     - its total amount of virtual memory (like the "VIRT" column of
     /usr/bin/top)
     - the total cpu time that this process consumed.
     - the current percentage of cpu time consumed by the process


* Informations of the "process browser"
  - on the first line is the name of the process, if you clic on it the
  "kill-mode" with be enabled.

  - on the second line is the PID, followed by the state of the process (Run,
  Sleep, Zombie etc.), and the number of children of this process.

  - on the third line is the username of the process

  - on the fourth line is the cpu time (user time + system time) consumed by
  the process

  - on the fifth line is the time elapsed since the process was started

  - on the sixth line is the resident size (non swapped physical memory) of the
  process, and the total amount of virtual memory used by the process.

  - on the last line is the page fault (major + minor) rate, followed by the
  maximum quantity of virtual memory used by the process.


* Usage of the "process browser"
  Use the wheel of your mouse to see the next/previous process. You can also
  clic with the left button and drag the mouse up/down. Clic on the process
  name to bring the "kill-mode" panel. This panel offers three choices: 
        - KILL GENTLY: send a SIGTERM to the process.
        - KILL -9    : send a SIGKILL to the process.
        - KILLALL    : kill a processes which have the same name.


* Command-line options
  Use wmforkplop --help to see the complete list. 

  With no options, wmforkplop create a dockapp window. This may not be adequate
  if your windowmanager does not handle windowmaker's dockapps. Note that KDE
  has a "dockbar extension" for this kind of dockapp.

  If your windowmanager expect small-size dockapps, such as 48x48 or 56x56,
  wmforkplop has suitable options for this ( "--32, --48, --56").
        
  If your windowmanager does not handle dockapps, the -g options will force
  wmforkplop to behave like a normal x11 application, with a resizable
  window. This window can be "swallowed" by the GNOME application called
  "gnome-swallow-applet" or (Swallower Meta-applet) 
        ( http://www-unix.oit.umass.edu/~tetron/technology/swallow/ ).
  


  If you think that wmhdplop is consuming too much CPU, or is refreshing its
  information too often, you can use the "--proc-update-delay n"
  option. Reading process statistics in /proc is unfortunately a quite
  kernel-expensive task, by default wmforkplop reads some information every
  150ms. Using a higher value will cause it to use less CPU.


* Bugs
  Tell-me about them ! hules(at)free.fr
