deprecate chan_modem and its subdrivers

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@6465 65c4cc65-6c06-0410-ace0-fbb531ad65f3

UPGRADE.txt

@@ -143,3 +143,10 @@ Music On Hold:
 * The preferred format for musiconhold.conf has changed; please see the
   sample configuration file for the new format. The existing format
   is still supported but will generate warnings when the module is loaded.
+
+chan_modem:
+
+* All the chan_modem channel drivers (aopen, bestdata and i4l) are deprecated
+  in this release, and will be removed in the next major Asterisk release.
+  Please migrate to chan_mISDN for ISDN interfaces; there is no upgrade
+  path for aopen and bestdata modem users.

channels/chan_modem.c

@@ -100,6 +100,8 @@ static pthread_t monitor_thread = AST_PTHREADT_NULL;
 
 static int restart_monitor(void);
 
+int dep_warning = 0;
+
 static struct ast_channel *modem_request(const char *type, int format, void *data, int *cause);
 static int modem_digit(struct ast_channel *ast, char digit);
 static int modem_call(struct ast_channel *ast, char *idest, int timeout);
@@ -816,6 +818,11 @@ static struct ast_channel *modem_request(const char *type, int format, void *dat
 	strsep(&stringp, ":");
 	oldformat = format;
 
+	if (!dep_warning) {
+		ast_log(LOG_WARNING, "This channel driver is deprecated.  Please see the UPGRADE.txt file.\n");
+		dep_warning = 1;
+	}
+
 	if (dev[0]=='g' && isdigit(dev[1])) {
 		/* Retrieve the group number */
 		if (sscanf(dev+1, "%u", &groupint) < 1) {