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

* How to compile and install this beast ?

  $ ./0 
  $ make
  $ su -c 'make install'

  In this example, the 0 script is executed without any parameters, so pawm
  gets installed in the default directory (i.e. /usr/local), but you can
  tell to 0 your favourite installation directories, in an syntax very 
  similar to 'configure'. For example, to change the prefix installation
  directory and the data directory, run 0 with the command './0 --prefix=/usr'
  For all the installation options run './0 --help' and for detailed
  instructions about the 0 scripts, see the 0.README file.


* Compile-time features

  You can enable and disable features at compile time with the --enable-FEATURE
  and --disable-FEATURE parameters to the 0 script. The features avaliable are:

  xft: support for the Xft library, the new X font system    [default:enabled]
  debug: support for verbose operation, useful for debugging [default:disabled]


* 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: window_shadow is for enabling and disabling shadow for
    decorated windows, and 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.

  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 !



