kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-31 18:55:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

clean up some application descriptions to use more gooder English

Browse Source 
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@7047 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Russell Bryant
2005-11-10 20:56:45 +00:00
parent 9b037b4872
commit f3b4e0291c
7 changed files with 74 additions and 65 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@@ -1,3 +1,7 @@
2005-11-10 Russell Bryant <russell@digium.com>
* many files in apps/: Clean up some application descriptions. Make sure all descriptions in changed files are wrapped at 80 characters.
2005-11-09 Russell Bryant <russell@digium.com> 2005-11-09 Russell Bryant <russell@digium.com>
* pbx.c: Clean up descriptions of built-in dialplan applications. Changes include clearer wording and not referring to return values. * pbx.c: Clean up descriptions of built-in dialplan applications. Changes include clearer wording and not referring to return values.

6
apps/app_adsiprog.c
View File

@@ -55,10 +55,8 @@ static char *synopsis = "Load Asterisk ADSI Scripts into phone";
/* #define DUMP_MESSAGES */ /* #define DUMP_MESSAGES */
static char *descrip = static char *descrip =
" ADSIProg(script): Programs an ADSI Phone with the given script.\n" " ADSIProg(script): This application programs an ADSI Phone with the given\n"
"If none is specified, the default script is used. The reprogramming\n" "script. If nothing is specified, the default script (asterisk.adsi) is used.\n"
"will complete successfully, except in cases where the device is \n"
"disconnected or hungup.\n";
STANDARD_LOCAL_USER; STANDARD_LOCAL_USER;

16
apps/app_alarmreceiver.c
View File

@@ -73,13 +73,15 @@ static char *app = "AlarmReceiver";
static char *synopsis = "Provide support for receving alarm reports from a burglar or fire alarm panel"; static char *synopsis = "Provide support for receving alarm reports from a burglar or fire alarm panel";
static char *descrip = static char *descrip =
"Alarm receiver application for Asterisk. Only 1 signalling format is supported at this time:\n" " AlarmReceiver(): Only 1 signalling format is supported at this time: Ademco\n"
"Ademco Contact ID. This application should be called whenever there is an alarm panel calling in\n" "Contact ID. This application should be called whenever there is an alarm\n"
"to dump its events. The application will handshake with the alarm panel, and receive events,\n" "panel calling in to dump its events. The application will handshake with the\n"
"validate them, handshake them, and store them until the panel hangs up. Once the panel hangs up,\n" "alarm panel, and receive events, validate them, handshake them, and store them\n"
"the application will run the command line specified by the eventcmd setting in alarmreceiver.conf\n" "until the panel hangs up. Once the panel hangs up, the application will run the\n"
"and pipe the events to the standard input of the application. Alarmreceiver.conf also contains settings\n" "system command specified by the eventcmd setting in alarmreceiver.conf and pipe\n"
"for DTMF timing, and for the loudness of the acknowledgement tones.\n"; "the events to the standard input of the application. The configuration file also\n"
"contains settings for DTMF timing, and for the loudness of the acknowledgement\n"
"tones.\n";
/* Config Variables */ /* Config Variables */

38
apps/app_authenticate.c
View File

@@ -49,26 +49,24 @@ static char *app = "Authenticate";
static char *synopsis = "Authenticate a user"; static char *synopsis = "Authenticate a user";
static char *descrip = static char *descrip =
" Authenticate(password[|options]): Requires a user to enter a" " Authenticate(password[|options]): This application asks the caller to enter a\n"
"given password in order to continue execution. If the\n" "given password in order to continue dialplan execution. If the password begins\n"
"password begins with the '/' character, it is interpreted as\n" "with the '/' character, it is interpreted as a file which contains a list of\n"
"a file which contains a list of valid passwords (1 per line).\n" "valid passwords, listed 1 password per line in the file.\n"
"an optional set of opions may be provided by concatenating any\n" " When using a database key, the value associated with the key can be anything.\n"
"of the following letters:\n" "Users have three attempts to authenticate before the channel is hung up. If the\n"
" a - Set account code to the password that is entered\n" "passsword is invalid, the 'j' option is specified, and priority n+101 exists,\n"
" d - Interpret path as database key, not literal file\n" "dialplan execution will continnue at this location.\n"
" j - Support jumping to n+101\n" " Options:\n"
" m - Interpret path as a file which contains a list of\n" " a - Set the channels' account code to the password that is entered\n"
" account codes and password hashes delimited with ':'\n" " d - Interpret the given path as database key, not a literal file\n"
" one per line. When password matched, corresponding\n" " j - Support jumping to n+101 if authentication fails\n"
" account code will be set\n" " m - Interpret the given path as a file which contains a list of account\n"
" r - Remove database key upon successful entry (valid with 'd' only)\n" " codes and password hashes delimited with ':', listed one per line in\n"
"\n" " the file. When one of the passwords is matched, the channel will have\n"
"When using a database key, the value associated with the key can be\n" " its account code set to the corresponding account code in the file.\n"
"anything. Users have three attempts to authenticate before the line is \n" " r - Remove the database key upon successful entry (valid with 'd' only)\n"
"hungup. If the passsword is invalid, and the 'j' flag is specified, \n" ;
"and priority n+101 exists, the call would be sent to the n+101 priority \n"
"and executed \n";
STANDARD_LOCAL_USER; STANDARD_LOCAL_USER;

9
apps/app_cdr.c
View File

@@ -34,11 +34,14 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
#include "asterisk/pbx.h" #include "asterisk/pbx.h"
static char *tdesc = "Make sure asterisk doesn't save CDR for a certain call"; static char *tdesc = "Tell Asterisk to not maintain a CDR for the current call";
static char *nocdr_descrip =
" NoCDR(): This application will tell Asterisk not to maintain a CDR for the\n"
"current call.\n";
static char *nocdr_descrip = "NoCDR(): makes sure there won't be any CDR written for a certain call";
static char *nocdr_app = "NoCDR"; static char *nocdr_app = "NoCDR";
static char *nocdr_synopsis = "Make sure asterisk doesn't save CDR for a certain call"; static char *nocdr_synopsis = "Tell Asterisk to not maintain a CDR for the current call";
STANDARD_LOCAL_USER; STANDARD_LOCAL_USER;

26
apps/app_chanisavail.c
View File

@@ -44,26 +44,22 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
#include "asterisk/devicestate.h" #include "asterisk/devicestate.h"
#include "asterisk/options.h" #include "asterisk/options.h"
static char *tdesc = "Check if channel is available"; static char *tdesc = "Check channel availability";
static char *app = "ChanIsAvail"; static char *app = "ChanIsAvail";
static char *synopsis = "Check if channel is available"; static char *synopsis = "Check channel availability;
static char *descrip = static char *descrip =
" ChanIsAvail(Technology/resource[&Technology2/resource2...][|option]): \n" " ChanIsAvail(Technology/resource[&Technology2/resource2...][|options]): \n"
"Checks if any of the requested channels are available. \n" "This application will check to see if any of the specified channels are\n"
"If any of the requested channels are available, the dialplan will continue and:\n" "available. The following variables will be set by this application:\n"
" ${AVAILCHAN} will be set to the name of the available channel\n" " ${AVAILCHAN} - the name of the available channel, if one exists\n"
" ${AVAILORIGCHAN} is the canonical channel name that was used to create the channel\n" " ${AVAILORIGCHAN} - the canonical channel name that was used to create the channel\n"
" ${AVAILSTATUS} is the status code for the channel\n" " ${AVAILSTATUS} - the status code for the available channel\n"
"If the option 's' is specified (state), will consider channel unavailable\n" " Options:\n"
"when the channel is in use at all, even if it can take another call.\n" " s - Consider the channel unavailable if the channel is in use at all\n"
"If none of the requested channels are available, then:\n" " j - Support jumping to priority n+101 if no channel is available\n";
" if the option 'j' is specified (jump), the application will jump to n+101\n"
" if it exists, otherwise the call will terminate\n"
" if the option 'j' is not specified the dialplan will continue and\n"
" ${AVAILCHAN} will be empty\n";
STANDARD_LOCAL_USER; STANDARD_LOCAL_USER;

40
apps/app_chanspy.c
View File

@@ -51,23 +51,31 @@ AST_MUTEX_DEFINE_STATIC(modlock);
#define ALL_DONE(u, ret) LOCAL_USER_REMOVE(u); return ret; #define ALL_DONE(u, ret) LOCAL_USER_REMOVE(u); return ret;
#define get_volfactor(x) x ? ((x > 0) ? (1 << x) : ((1 << abs(x)) * -1)) : 0 #define get_volfactor(x) x ? ((x > 0) ? (1 << x) : ((1 << abs(x)) * -1)) : 0
static const char *synopsis = "Tap into any type of asterisk channel and listen to audio"; static const char *synopsis = "Listen to the audio of an active channel\n";
static const char *app = "ChanSpy"; static const char *app = "ChanSpy";
static const char *desc = " Chanspy([<scanspec>][|<options>])\n\n" static const char *desc =
"Valid Options:\n" " ChanSpy([chanprefix][|options]): This application is used to listen to the\n"
" - b: bridged, only spy on channels involved in a bridged call.\n" "audio from an active Asterisk channel. This includes the audio coming in and\n"
" - g(grp): enforce group. Match only calls where their ${SPYGROUP} is 'grp'.\n" "out of the channel being spied on. If the 'chanprefix' parameter is specified,\n"
" - q: quiet, don't announce channels beep, etc.\n" "only channels beginning with this string will be spied upon.\n"
" - r[(basename)]: Record session to monitor spool dir (with optional basename, default is 'chanspy')\n\n" " While Spying, the following actions may be performed:\n"
" - v([-4..4]): adjust the initial volume. (negative is quieter)\n" " - Dialing # cycles the volume level.\n"
"If <scanspec> is specified, only channel names *beginning* with that string will be scanned.\n" " - Dialing * will stop spying and look for another channel to spy on.\n"
"('all' or an empty string are also both valid <scanspec>)\n\n" " - Dialing a series of digits followed by # builds a channel name to append\n"
"While Spying:\n\n" " to 'chanprefix'. For example, executing ChanSpy(Agent) and then dialing\n"
"Dialing # cycles the volume level.\n" " the digits '1234#' while spying will begin spying on the channel,\n"
"Dialing * will stop spying and look for another channel to spy on.\n" " 'Agent/1234'.
"Dialing a series of digits followed by # builds a channel name to append to <scanspec>\n" " Options:\n"
"(e.g. run Chanspy(Agent) and dial 1234# while spying to jump to channel Agent/1234)\n\n" " b - Only spy on channels involved in a bridged call.\n"
""; " g(grp) - Match only channels where their ${SPYGROUP} variable is set to\n"
" 'grp'.\n"
" q - Don't play a beep when beginning to spy on a channel.\n"
" r[(basename)] - Record the session to the monitor spool directory. An\n"
" optional base for the filename may be specified. The\n"
" default is 'chanspy'.\n"
" v([value]) - Adjust the initial volume in the range from -4 to 4. A\n"
" negative value refers to a quieter setting.\n"
;
static const char *chanspy_spy_type = "ChanSpy"; static const char *chanspy_spy_type = "ChanSpy";