Installing pawm
===============

DISCLAIMER: pawm is unmaintained since 2.2.9 release September 2006. I'm doing
a new 2.3.0 release (May 2010) to update the build system and put some small
patches.  Although i don't spend more time in pawm, i'll accept new patches and
make releases if anyone sends them to me. Thank you, really ;), thank you, for
using and supporting pawm all this time :). It was fun to know all you :)

* How to compile and install this beast ?

  $ cmake -DCMAKE_INSTALL_PREFIX=/usr
  $ make
  $ su -c 'make install'

  pawm has been changed to use the CMake building system. Probably there are
  still some problems with this update because it has not been thoroughly
  tested. For example, previously configurable features (Xft, Startup) are now
  always included

* Running pawm

  After 'make install', proper directories are created and you are ready to 
  run pawm, just edit your .xinitrc and add the line 'exec pawm' at the end
  of the file, or launch X and run pawm from a console or from a x terminal.

  To finish pawm, use the 'power' button ;) in the bar at the bottom of the
  screen (pabar), or send a SIGTERM/SIGINT signal to the pawm process.

* Configuring pawm

  Configuration is stored in the pawm.conf (installed by default in /etc). So
  if you don't like the defaults, edit it and the configurations options. Pawm
  needs _all_ this variables, so don't delete them, just change their values.

  Some interesting options that you'll find in pawm.conf:

  - Colors options: You can configure all the colors used by pawn in frames,
    titlebars, fonts, windows, whatever you say. So you can personalize this
    way the look for pawm.
  - Fonts options: As you already guessed ;), you can change the fonts in
    pawm changing the ugly X font descriptors or using the simpler and nicer
    Xft font names.
  - Pixmaps for buttons: Put here differents pixmaps if you don't like the
    ones pawm includes by default. They must be 20x20 xpm files, and reside
    in the pawm icons directory.
  - Appearance: pabar_scroll enables auto-hiding in the pabar. And
    the pabar_autohide option makes the pabar fixed on the screen if disabled.
    All this options are "On" by default.
  - You can disable the pashut button. If you disable the pashut, the only way
    to kill pawm 'nicely' ;) is a SIGTERM.

* Launching X applications

  You have three options, launch them from your .xinitrc, from a console
  telling the applications which display to use (through the DISPLAY 
  enviroment variable or the -display parameter) or using the pawm application
  launcher. 

* Configuring the launcher:
   
  Fist create a .pawm directory in your $HOME. This is to allow every user
  to configure their own icons indepently of the rest of the users. Then put
  inside one file for each icon you want to create. The file name is important,
  it must begin with the string 'app'.

  There are some utilities in the pawm web page if don't like to use a text
  editor ;).  The format is pretty simple, just four lines, separeted by a
  newline character:

  First: Icon xpm filename (A 32x32 xpm)
  Second: Icon position in screen (x and y coordinates)
  Third line: Icon text (it can contain spaces)
  Four line: Application binary (absolute path or relative path)

  For example, create a file called appXterm in $(HOME)/.pawm, and add this:
  
  terminal.xpm
  100 10
  Xterm
  xterm

  This will load the icon at $(DATADIR)/icons/terminal.xpm, at position 100,10
  on the screen and with the text "Xterm". If you single-click on the icon,
  the xterm binary will be executed.

  An additional fifth (optional) line can be added to disable startup
  notification (in case it's enabled at compile time) because not every 
  application out there support this extension. To disable just add one
  line with the "false" string.

  You don't have to care much about the exact icon position in screen, just put
  whatever position you like, and when pawm is running by first time, move
  the icon around with the mouse and place it where you prefer. Pawm will
  gently remember the last icon position for you and will write it in the icon
  config file.

Building pawm packages
======================

* Fedora / Redhat:

  Use the spec file provided with pawm. Execute 'rpmbuild --bb pawm.spec' after
  copying the tar file to your rpm source directory. After that the binary rpm
  can be installed via executing as root with:
    'rpm -Uvh /pathToWhereTheRPM/isLocated/pawm-2.0.0-0.i386.rpm'


-----------------------

Enjoy the Puto Amo !



