From e4ec545e5955be22cea78e55e10a59e624ba3e01 Mon Sep 17 00:00:00 2001
From: "Kevin P. Fleming" <kpfleming@digium.com>
Date: Thu, 27 Jan 2011 15:57:52 +0000
Subject: [PATCH] Rename the SendFAX/ReceiveFAX 'force audio' option.

The recently added option to disable usage of T.38 for a single
session should have been named 'F' for 'force audio', since that
is really what the user is asking to happen (and it's a positive
option instead of a negative option that way).



git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@304422 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 res/res_fax.c | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/res/res_fax.c b/res/res_fax.c
index c926d95dbb..604d139066 100644
--- a/res/res_fax.c
+++ b/res/res_fax.c
@@ -74,8 +74,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 					<option name="f">
 						<para>Allow audio fallback FAX transfer on T.38 capable channels.</para>
 					</option>
-					<option name="n">
-						<para>Disable usage of T.38 on otherwise T.38 capable channels.</para>
+					<option name="F">
+						<para>Force usage of audio mode on T.38 capable channels.</para>
 					</option>
 					<option name="s">
 						<para>Send progress Manager events (overrides statusevents setting in res_fax.conf).</para>
@@ -110,8 +110,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 					<option name="f">
 						<para>Allow audio fallback FAX transfer on T.38 capable channels.</para>
 					</option>
-					<option name="n">
-						<para>Disable usage of T.38 on otherwise T.38 capable channels.</para>
+					<option name="F">
+						<para>Force usage of audio mode on T.38 capable channels.</para>
 					</option>
 					<option name="s">
 						<para>Send progress Manager events (overrides statusevents setting in res_fax.conf).</para>
@@ -273,7 +273,7 @@ enum {
 	OPT_STATUS      = (1 << 3),
 	OPT_ALLOWAUDIO  = (1 << 5),
 	OPT_REQUEST_T38 = (1 << 6),
-	OPT_DISABLE_T38 = (1 << 7),
+	OPT_FORCE_AUDIO = (1 << 7),
 };
 
 AST_APP_OPTIONS(fax_exec_options, BEGIN_OPTIONS
@@ -281,7 +281,7 @@ AST_APP_OPTIONS(fax_exec_options, BEGIN_OPTIONS
 	AST_APP_OPTION('c', OPT_CALLERMODE),
 	AST_APP_OPTION('d', OPT_DEBUG),
 	AST_APP_OPTION('f', OPT_ALLOWAUDIO),
-	AST_APP_OPTION('n', OPT_DISABLE_T38),
+	AST_APP_OPTION('F', OPT_FORCE_AUDIO),
 	AST_APP_OPTION('s', OPT_STATUS),
 	AST_APP_OPTION('z', OPT_REQUEST_T38),
 END_OPTIONS);
@@ -1628,7 +1628,7 @@ static int receivefax_exec(struct ast_channel *chan, const char *data)
 
 	if ((ast_channel_get_t38_state(chan) == T38_STATE_UNAVAILABLE) ||
 	    ast_test_flag(&opts, OPT_ALLOWAUDIO) ||
-	    ast_test_flag(&opts, OPT_DISABLE_T38)) {
+	    ast_test_flag(&opts, OPT_FORCE_AUDIO)) {
 		details->option.allow_audio = AST_FAX_OPTFLAG_TRUE;
 	}
 
@@ -1653,7 +1653,7 @@ static int receivefax_exec(struct ast_channel *chan, const char *data)
 		}
 	}
 
-	if (!ast_test_flag(&opts, OPT_DISABLE_T38)) {
+	if (!ast_test_flag(&opts, OPT_FORCE_AUDIO)) {
 		if (set_fax_t38_caps(chan, details)) {
 			ast_string_field_set(details, error, "T38_NEG_ERROR");
 			ast_string_field_set(details, resultstr, "error negotiating T.38");
@@ -1665,7 +1665,7 @@ static int receivefax_exec(struct ast_channel *chan, const char *data)
 		}
 	}
 
-	if (!ast_test_flag(&opts, OPT_DISABLE_T38) && (details->caps & AST_FAX_TECH_T38)) {
+	if (!ast_test_flag(&opts, OPT_FORCE_AUDIO) && (details->caps & AST_FAX_TECH_T38)) {
 		if (receivefax_t38_init(chan, details)) {
 			ast_string_field_set(details, error, "T38_NEG_ERROR");
 			ast_string_field_set(details, resultstr, "error negotiating T.38");
@@ -2106,7 +2106,7 @@ static int sendfax_exec(struct ast_channel *chan, const char *data)
 
 	if ((ast_channel_get_t38_state(chan) == T38_STATE_UNAVAILABLE) ||
 	    ast_test_flag(&opts, OPT_ALLOWAUDIO) ||
-	    ast_test_flag(&opts, OPT_DISABLE_T38)) {
+	    ast_test_flag(&opts, OPT_FORCE_AUDIO)) {
 		details->option.allow_audio = AST_FAX_OPTFLAG_TRUE;
 	}
 
@@ -2135,7 +2135,7 @@ static int sendfax_exec(struct ast_channel *chan, const char *data)
 		}
 	}
 
-	if (!ast_test_flag(&opts, OPT_DISABLE_T38)) {
+	if (!ast_test_flag(&opts, OPT_FORCE_AUDIO)) {
 		if (set_fax_t38_caps(chan, details)) {
 			ast_string_field_set(details, error, "T38_NEG_ERROR");
 			ast_string_field_set(details, resultstr, "error negotiating T.38");
@@ -2147,7 +2147,7 @@ static int sendfax_exec(struct ast_channel *chan, const char *data)
 		}
 	}
 
-	if (!ast_test_flag(&opts, OPT_DISABLE_T38) && (details->caps & AST_FAX_TECH_T38)) {
+	if (!ast_test_flag(&opts, OPT_FORCE_AUDIO) && (details->caps & AST_FAX_TECH_T38)) {
 		if (sendfax_t38_init(chan, details)) {
 			ast_string_field_set(details, error, "T38_NEG_ERROR");
 			ast_string_field_set(details, resultstr, "error negotiating T.38");