= Installing Pathalizer =

See the INSTALL file

= Running Pathalizer =

pathalizer works in a number of stages:
- 'apache2events': access.log  -> events-file
- 'events2dot':    events-file -> dot-file
- 'dot':           dot-file    -> ps-file
- 'ps2img':        ps-file     -> png-file

You can do all of this at once with the 'pathalizer' script:
arnouten@mintzer$ pathalizer access.log

This generates an access.log.events, access.log.dot, access.log.ps 
and access.log.png file in the current directory. 

If you want more control, for example edit or even generate the 
intermediate files by hand, look at the pathalizer bash-script.

= Configuring Pathlizer =

Configuration is read from 'pathalizer.conf' in the current directory.

The following statements are supported:

unify "HOME PAGE" : "^/$" "^/index.html" "^index.htm"
  Merges all nodes with names to the right of the colon into one node with the
  name to the left of the colon. Those are POSIX regular expressions, so you'll
  have to use [::] notation instead of '\d' and such.

ignore \.png
  This will tell the first stage of pathalizer (apache2events) to ignore
  any lines that match on the regexp /\.png/. POSIX regexps again.

min_edgewidth -1
  events2dot will filter out edges that are taken less than min_edgewidth
  times. '-1' is the default, and causes events2dot to establish 
  min_edgewidth automatically based on max_edgecount

max_edgecount 30
  if min_edgewidth is -1 (the default), events2dot will try to establish
  the highest min_edgewidth for which the total number of edges in the
  generated graph is under or equal to max_edgecount.

ignore_refresh 1
  When set to 1, ignores all edges that go from a node to the same node.
  Default is 0.

session_timeout -1
  Treat 2 hits from the same session as different sessions when their timeouts 
  differ more than session_timeout. -1 to disable.

= License =

Pathalizer is licensed under the GNU GPL
