#summary How to use

= Introduction =

= Prerequisites =

• The ant-growllistener jar
• Growl (http://growl.info) or Growl for Linux (https://github.com/mattn/growl-for-linux)
• growlnotify or gntp

= Details =

== Installation ==

• Put ant-growllistener.jar into Ant's lib directory or $HOME/.ant/lib

= Supported environment variables =

• ANT_GROWL_TARGET_FILTER - will allow to filter by targets, won't show growl message for the specified targets. Regexp are available.

  • export ANT_GROWL_TARGET_FILTER=init;compile;^-.*$ # Ignore init, compile, and minus-started targets (e.g. -pre-init)

• ANT_GROWL_SUCC_FAIL_ONLY - will only show success and or failure growl messages.

  • export ANT_GROWL_SUCC_FAIL_ONLY=true

• ANT_GROWL_IGNORE_SUB_BUILDS - will ignore growl messages from all sub builds.

  • export ANT_GROWL_IGNORE_SUB_BUILDS=true

• ANT_GROWL_DISABLE_STICK_ON_FAILURE - will disable sticky message on failed build.

  • export ANT_GROWL_DISABLE_STICK_ON_FAILURE=true

== Using the Ant Growl Notifier ==

• To make ant use the new listener, invoke ant like this:
  • ant -listener com.google.code.ant.growlnotify.GrowlListener
• You could also add "-listener com.google.code.ant.growlnotify.GrowlListener" to your ANT_ARGS environment variable.
  • export ANT_ARGS="-listener com.google.code.ant.growlnotify.GrowlListener"