README for AGX Addons
=====================

This package contains additional modules for Asterisk which are, for one reason 
or another, not included in the normal base distribution.  Many of these
modules are experimental or have a GPL license without a disclaimer that allow
digium to insert them into the official distribution (double licensed).

This work/effort has been sponsored by http://www.mercuriuspbx.it/


MOTIVATIONS
===========

Digium does not accept "new features" addition to official releases, so you have
to keep them updated yourself if you want them working with 1.4; so this is my
goal.

Also you have to give copyright to Digium to all the changes/sources. This is not
possible when the original author does not want give them but, since the source
its GPL, it can still be used by others (like this project).


ASTERISK 1.6 ADDONS include app_fax.c. So i'm not going to port the Fax apps to 1.6.
Please *poke me* if somewhere in time 1.6 will be really ready for production use.



UPDATED SOURCE
==============

If you downloaded the tarball please delete it and try the svn version instead
since the tarball is almost always out-of-date.


INSTALLATION ARE PRE-REQUISITES
===============================

- Install "CMake" to compile the source
	A. On Fedora 6, thanks to Michael Gollihue, run:
		yum install CMake Glib2 Glib2-devel

- Install libSpanDSP version 0.0.4 pre 16	*Make sure its this EXACT version*
	- pre15 is OK
	- pre16 is OK and i've never got 1 single problem
	- pre18 is working but i've got some problem
	- >>pre18 introduce API changes and then is incompatible
	- there is a new directory for spandsp 0.0.5 pre 3
- Install libTiff >=3.8 and <4.0		*You really need that version range*
- Install Cmake					*Because CMake is faster and easy*
- Execute: ./build.sh				*Because i'm lazy*

FAQ: i use CMake because its really faster if compared to GNU configure stuffs.

FAQ: the fax addons are tested against:
	- asterisk 1.4.17 + spanDSP pre15
	- asterisk 1.4.17 + spanDSP pre16
	- asterisk 1.4.17 + spanDSP pre18

FAQ: Fax + chan_misdn are a very bad idea, if you use BRI you want to move to Hylafax
or use an external BRI gateway for that.
	MORE: chan_misdn + faxes seems very hard to make it work. If you have any
		suggestion of the reason please *poke me*.


EXPERIMENTAL
============

I've ported app_*fax.c to spandsp 0.0.5 pre3, you have to manually build the files yourself
or replace the files main files with that subversions.

I've got problems with 0.0.5 pre3 so i rolled back. Check the spandps-0.0.5 directory.



PROBLEMS
========

Please have a look at CHANGES file and BUGS_KNOW_PROBLEMS.

For some strange reason i don't get email notification when someone posts on sourceforge webpage.

I can fix some stuff but need you to compile with debug infoes enabled and to 
provide me at least a backtrace (with source lines) of what happened.



CONTACT
=======

Unluckly i cannot provide any form of free support for this software since i'm
very busy with my work, put please help me share your opinion so i can at least 
keep the docs updated.

Antonio Gallo
@mail: agx at linux dot it
@work: http://www.mercuriuspbx.it/
@home: http://www.badpenguin.org/
@IRC:  agx on channell #callweaver, #callweaver-dev, #asterisk-dev, #openser, #aastra
@jabber: agx at jabber.linux.it
@MSN:	antoniogallo73 at hotmail dot com
@Skype: antoniogallo73, just open a chat window



CREDITS: PATCHES CONTRIBUTORS
=============================

Archie Cobbs			- patches for CMakeList.txt, app_rxfax.c



CREDITS: ORIGINAL AUTHORS
=========================

app_confcall.c			- Anthony Minessale II, patched and ported by Kirk Wolff
					NOTE: its experimental its not compiling against asterisk 1.4.17
app_devstate.c			- Druid Software
app_nv_backgrounddetect.c	- Newman Telecom
app_nv_faxdetect.c		- Newman Telecom
app_pickup2.c			- Florian Overkamp
app_txfax.c			- Steve Underwood, patched by me
app_app_rxfax.c			- Steve Underwood, patched by me
app_valetparking.c		- Anthony Minessale II
func_devstate.c			- http://svncommunity.digium.com/svn/russell/asterisk-1.4/func_devstate-1.4/func_devstate.c

