- <sect2 id="category.general">
+ <sect2 id="extensions.category.general">
<title>General</title>
<para>
<parameter>static</parameter> yes | no -- If static is set to no, or
@@ -31,7 +31,7 @@
</para>
</sect2>
- <sect2 id="category.globals">
+ <sect2 id="extensions.category.globals">
<title>Globals</title>
<para>
<parameter>CONSOLE</parameter> Console/dsp; -- to be enumerated more
Added: en/config/voicemail.xml
URL: http://svncommunity.digium.com/view/asterisk-docs/en/config/voicemail.xml?rev=3&view=auto
==============================================================================
--- en/config/voicemail.xml (added)
+++ en/config/voicemail.xml Wed May 3 16:18:13 2006
@@ -1,0 +1,294 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.16 $ -->
+<!-- Purpose: basic.text -->
+<!-- Membership: bundled -->
+
+<chapter id="config.voicemail">
+ <title>voicemail.conf</title>
+ <titleabbrev>voicemail.conf</titleabbrev>
+
+ <sect1 id="voicemail.category">
+ &reftitle.intro;
+ <para>
+ The &link.voicemail.conf; controls Asterisk Voicemail operations.
+ </para>
+
+
+ <sect2 id="voicemail.category.general">
+ <title>General</title>
+ <para>
+ <parameter>format</parameter> g723sf | wav49 | wav | gsm -- The default
+ file format to store voicemails in. If
+ omitted, Asterisk defaults to wav.
+ </para>
+ <para>
+ <parameter>serveremail</parameter> &email.sample; -- The email address
+ email notifications should come from.
+ </para>
+ </sect2>
+
+ <sect2 id="voicemail.category.sample">
+ <title>Sample &voicemail.conf;</title>
+ <para>
+ <example>
+ <title>Sample &voicemail.conf;</title>
+ <programlisting role='astconf'>
+<![CDATA[
+;
+; Voicemail Configuration
+;
+
+;
+; NOTE: Asterisk has to edit this file to change a user's password. This does
+; note currently work with the "#include <file>" directive for Asterisk
+; configuration files. Do not use it with this configuration file.
+;
+
+[general]
+; Default formats for writing Voicemail
+;format=g723sf|wav49|wav
+format=wav49|gsm|wav
+;
+; WARNING:
+; If you change the list of formats that you record voicemail in
+; when you have mailboxes that contain messages, you _MUST_ absolutely
+; manually go through those mailboxes and convert/delete/add the
+; the message files so that they appear to have been stored using
+; your new format list. If you don't do this, very unpleasant
+; things may happen to your users while they are retrieving and
+; manipulating their voicemail.
+;
+; In other words: don't change the format list on a production system
+; unless you are _VERY_ sure that you know what you are doing and are
+; prepared for the consequences.
+;
+; Who the e-mail notification should appear to come from
+serveremail=asterisk
+;serveremail=asterisk@linux-support.net
+; Should the email contain the voicemail as an attachment
+attach=yes
+; Maximum number of messages per folder. If not specified, a default value
+; (100) is used. Maximum value for this option is 9999.
+;maxmsg=100
+; Maximum length of a voicemail message in seconds
+;maxmessage=180
+; Minimum length of a voicemail message in seconds for the message to be kept
+; The default is no minimum.
+;minmessage=3
+; Maximum length of greetings in seconds
+;maxgreet=60
+; How many miliseconds to skip forward/back when rew/ff in message playback
+skipms=3000
+; How many seconds of silence before we end the recording
+maxsilence=10
+; Silence threshold (what we consider silence, the lower, the more sensitive)
+silencethreshold=128
+; Max number of failed login attempts
+maxlogins=3
+
+; If you need to have an external program, i.e. /usr/bin/myapp
+; called when a voicemail is left, delivered, or your voicemailbox
+; is checked, uncomment this. It can also be set to 'smdi' to use
+; smdi for external notification. If it is 'smdi', smdiport should
+; be set to a valid port as specfied in smdi.conf.
+
+;externnotify=/usr/bin/myapp
+;smdiport=/dev/ttyS0
+
+; If you need to have an external program, i.e. /usr/bin/myapp
+; called when a voicemail password is changed, uncomment this:
+;externpass=/usr/bin/myapp
+; For the directory, you can override the intro file if you want
+;directoryintro=dir-intro
+; The character set for voicemail messages can be specified here
+;charset=ISO-8859-1
+; The ADSI feature descriptor number to download to
+;adsifdn=0000000F
+; The ADSI security lock code
+;adsisec=9BDBF7AC
+; The ADSI voicemail application version number.
+;adsiver=1
+; Skip the "[PBX]:" string from the message title
+;pbxskip=yes
+; Change the From: string
+;fromstring=The Asterisk PBX
+; Permit finding entries for forward/compose from the directory
+;usedirectory=yes
+;
+; Change the from, body and/or subject, variables:
+; VM_NAME, VM_DUR, VM_MSGNUM, VM_MAILBOX, VM_CALLERID, VM_CIDNUM,
+; VM_CIDNAME, VM_DATE
+;
+; Note: The emailbody config row can only be up to 512 characters due to a
+; limitation in the Asterisk configuration subsystem.
+;emailsubject=[PBX]: New message ${VM_MSGNUM} in mailbox ${VM_MAILBOX}
+; The following definition is very close to the default, but the default shows
+; just the CIDNAME, if it is not null, otherise just the CIDNUM, or "an unknown
+; caller", if they are both null.
+;emailbody=Dear ${VM_NAME}:\n\n\tjust wanted to let you know you were just left a ${VM_DUR} long message (number ${VM_MSGNUM})\nin mailbox ${VM_MAILBOX} from ${VM_CALLERID}, on ${VM_DATE}, so you might\nwant to check it when you get a chance. Thanks!\n\n\t\t\t\t--Asterisk\n
+;
+; You can also change the Pager From: string, the pager body and/or subject.
+; The above defined variables also can be used here
+;pagerfromstring=The Asterisk PBX
+;pagersubject=New VM
+;pagerbody=New ${VM_DUR} long msg in box ${VM_MAILBOX}\nfrom ${VM_CALLERID}, on ${VM_DATE}
+;
+; Set the date format on outgoing mails. Valid arguments can be found on the
+; strftime(3) man page
+;
+; Default
+emaildateformat=%A, %B %d, %Y at %r
+; 24h date format
+;emaildateformat=%A, %d %B %Y at %H:%M:%S
+;
+; You can override the default program to send e-mail if you wish, too
+;
+;mailcmd=/usr/sbin/sendmail -t
+;
+; Users may be located in different timezones, or may have different
+; message announcements for their introductory message when they enter
+; the voicemail system. Set the message and the timezone each user
+; hears here. Set the user into one of these zones with the tz= attribute
+; in the options field of the mailbox. Of course, language substitution
+; still applies here so you may have several directory trees that have
+; alternate language choices.
+;
+; Look in /usr/share/zoneinfo/ for names of timezones.
+; Look at the manual page for strftime for a quick tutorial on how the
+; variable substitution is done on the values below.
+;
+; Supported values:
+; 'filename' filename of a soundfile (single ticks around the filename
+; required)
+; ${VAR} variable substitution
+; A or a Day of week (Saturday, Sunday, ...)
+; B or b or h Month name (January, February, ...)
+; d or e numeric day of month (first, second, ..., thirty-first)
+; Y Year
+; I or l Hour, 12 hour clock
+; H Hour, 24 hour clock (single digit hours preceded by "oh")
+; k Hour, 24 hour clock (single digit hours NOT preceded by "oh")
+; M Minute, with 00 pronounced as "o'clock"
+; N Minute, with 00 pronounced as "hundred" (US military time)
+; P or p AM or PM
+; Q "today", "yesterday" or ABdY
+; (*note: not standard strftime value)
+; q "" (for today), "yesterday", weekday, or ABdY
+; (*note: not standard strftime value)
+; R 24 hour time, including minute
+;
+;
+[zonemessages]
+eastern=America/New_York|'vm-received' Q 'digits/at' IMp
+central=America/Chicago|'vm-received' Q 'digits/at' IMp
+central24=America/Chicago|'vm-received' q 'digits/at' H N 'hours'
+military=Zulu|'vm-received' q 'digits/at' H N 'hours' 'phonetic/z_p'
+european=Europe/Copenhagen|'vm-received' a d b 'digits/at' HM
+
+;
+; Each mailbox is listed in the form <mailbox>=<password>,<name>,<email>,<pager_email>,<options>
+; if the e-mail is specified, a message will be sent when a message is
+; received, to the given mailbox. If pager is specified, a message will be
+; sent there as well. If the password is prefixed by '-', then it is
+; considered to be unchangable.
+;
+; Advanced options example is extension 4069
+; NOTE: All options can be expressed globally in the general section, and
+; overriden in the per-mailbox settings, unless listed otherwise.
+;
+; tz=central ; Timezone from zonemessages above. Irrelevant if envelope=no.
+; attach=yes ; Attach the voicemail to the notification email *NOT* the pager email
+; attachfmt=wav49 ; Which format to attach to the email. Normally this is the
+ ; first format specified in the format parameter above, but this
+ ; option lets you customize the format sent to particular mailboxes.
+ ; Useful if Windows users want wav49, but Linux users want gsm.
+ ; [per-mailbox only]
+; saycid=yes ; Say the caller id information before the message. If not described,
+ ; or set to no, it will be in the envelope
+; cidinternalcontexts=intern ; Internal Context for Name Playback instead of
+ ; extension digits when saying caller id.
+; sayduration=no ; Turn on/off the duration information before the message. [ON by default]
+; saydurationm=2 ; Specify the minimum duration to say. Default is 2 minutes
+; dialout=fromvm ; Context to dial out from [option 4 from the advanced menu]
+ ; if not listed, dialing out will not be permitted
+sendvoicemail=yes ; Context to Send voicemail from [option 5 from the advanced menu]
+ ; if not listed, sending messages from inside voicemail will not be
+ ; permitted
+; searchcontexts=yes ; Current default behavior is to search only the default context
+ ; if one is not specified. The older behavior was to search all contexts.
+ ; This option restores the old behavior [DEFAULT=no]
+; callback=fromvm ; Context to call back from
+ ; if not listed, calling the sender back will not be permitted
+; review=yes ; Allow sender to review/rerecord their message before saving it [OFF by default
+; operator=yes ; Allow sender to hit 0 before/after/during leaving a voicemail to
+ ; reach an operator [OFF by default]
+; envelope=no ; Turn on/off envelope playback before message playback. [ON by default]
+ ; This does NOT affect option 3,3 from the advanced options menu
+; delete=yes ; After notification, the voicemail is deleted from the server. [per-mailbox only]
+ ; This is intended for use with users who wish to receive their
+ ; voicemail ONLY by email. Note: "deletevoicemail" is provided as an
+ ; equivalent option for Realtime configuration.
+; nextaftercmd=yes ; Skips to the next message after hitting 7 or 9 to delete/save current message.
+ ; [global option only at this time]
+; forcename=yes ; Forces a new user to record their name. A new user is
+ ; determined by the password being the same as
+ ; the mailbox number. The default is "no".
+; forcegreetings=no ; This is the same as forcename, except for recording
+ ; greetings. The default is "no".
+; hidefromdir=yes ; Hide this mailbox from the directory produced by app_directory
+ ; The default is "no".
+
+
+[default]
+; Define maximum number of messages per folder for partcular context.
+;maxmsg=50
+
+1234 => 4242,Example Mailbox,root@localhost
+;4200 => 9855,Mark Spencer,markster@linux-support.net,mypager@digium.com,attach=no|serveremail=myaddy@digium.com|tz=central|maxmsg=10
+;4300 => 3456,Ben Rigas,ben@american-computer.net
+;4310 => -5432,Sales,sales@marko.net
+;4069 => 6522,Matt Brooks,matt@marko.net,,|tz=central|attach=yes|saycid=yes|dialout=fromvm|callback=fromvm|review=yes|operator=yes|envelope=yes|sayduration=yes|saydurationm=1
+;4073 => 1099,Bianca Paige,bianca@biancapaige.com,,delete=1
+;4110 => 3443,Rob Flynn,rflynn@blueridge.net
+;4235 => 1234,Jim Holmes,jim@astricon.ips,,Tz=european
+
+
+;
+; Mailboxes may be organized into multiple contexts for
+; voicemail virtualhosting
+;
+
+[other]
+;The intro can be customized on a per-context basis
+;directoryintro=dir-company2
+1234 => 5678,Company2 User,root@localhost
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </sect2>
+ </sect1>
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
Added: en/reference/general/functions/senddtmf.xml
URL: http://svncommunity.digium.com/view/asterisk-docs/en/reference/general/functions/senddtmf.xml?rev=3&view=auto
==============================================================================
--- en/reference/general/functions/senddtmf.xml (added)
+++ en/reference/general/functions/senddtmf.xml Wed May 3 16:18:13 2006
@@ -1,0 +1,54 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+
+<refentry id="function.senddtmf">
+ <refnamediv>
+ <refname>SendDTMF</refname>
+ <refpurpose>
+ Sends arbitrary DTMF digits
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <methodname>SendDTMF</methodname>
+ <methodparam><type>string</type><parameter>digits</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>timeout_ms</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sends DTMF digits on a channel.
+ </para>
+
+ <para>
+ Accepted digits: 0-9, *#abcd, w (.5s pause)
+ </para>
+
+ <para>
+ The application will either pass the assigned digits or terminate if it
+ encounters an error.
+ </para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
Added: en/reference/general/functions/sendimage.xml
URL: http://svncommunity.digium.com/view/asterisk-docs/en/reference/general/functions/sendimage.xml?rev=3&view=auto
==============================================================================
--- en/reference/general/functions/sendimage.xml (added)
+++ en/reference/general/functions/sendimage.xml Wed May 3 16:18:13 2006
@@ -1,0 +1,77 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+
+<refentry id="function.sendimage">
+ <refnamediv>
+ <refname>SendImage</refname>
+ <refpurpose>
+ Send an image file
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <methodname>SendImage</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam>
+ </methodsynopsis>
+
+ <para>
+ Sends an image on a channel, if the channel supports it. If the channel
+ supports image transport but the image send fails, the channel will be hung
+ up. Otherwise, the dialplan continues execution.
+ </para>
+
+ <para>
+ <parameter>options</parameter> can be one or more of the following:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>j</literal> - jump to priority n+101 if the channel doesn't support image transport
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ SendImage sets the channel variable $SENDIMAGESTATUS to one of the
+ following:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>OK</literal> - The image was successfully sent to the channel.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>NOSUPPORT</literal> - The current channel does not support
+ sending of images.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
Added: en/reference/general/functions/sendtext.xml
URL: http://svncommunity.digium.com/view/asterisk-docs/en/reference/general/functions/sendtext.xml?rev=3&view=auto
==============================================================================
--- en/reference/general/functions/sendtext.xml (added)
+++ en/reference/general/functions/sendtext.xml Wed May 3 16:18:13 2006
@@ -1,0 +1,80 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+
+<refentry id="function.sendtext">
+ <refnamediv>
+ <refname>SendText</refname>
+ <refpurpose>
+ Send a Text Message
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <methodname>SendText</methodname>
+ <methodparam><type>string</type><parameter>text</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sends text to current channel (callee). Text must be 7 bit ASCII in most
+ channels. The dialplan will continue execution regardless of the return
+ status of SendText.
+ </para>
+
+ <para>
+ <parameter>options</parameter> can be one or more of the following:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>j</literal> - jump to n+101 priority if the channel doesn't support text transport
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ SendText sets the channel variable $SENDIMAGESTATUS to one of the
+ following upon completion:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>SUCCESS</literal> - The text was successfully sent to the channel.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>FAILURE</literal> - The text was not sent to the channel.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>UNSUPPORTED</literal> - The current channel does not support sending of text.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
Added: en/reference/voicemail/functions/vmauthenticate.xml
URL: http://svncommunity.digium.com/view/asterisk-docs/en/reference/voicemail/functions/vmauthenticate.xml?rev=3&view=auto
==============================================================================
--- en/reference/voicemail/functions/vmauthenticate.xml (added)
+++ en/reference/voicemail/functions/vmauthenticate.xml Wed May 3 16:18:13 2006
@@ -1,0 +1,64 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+
+<refentry id="function.vmauthenticate">
+<refnamediv>
+ <refname>VMAuthenticate</refname>
+ <refpurpose>
+ Authenticate with Voicemail passwords
+ </refpurpose>
+</refnamediv>
+
+<refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <methodname>VMAuthenticate</methodname>
+ <methodparam choice="opt"><type>string</type><parameter>boxnumber</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ This application behaves the same way as the
+ <function>Authenticate</function> application, but the passwords are taken
+ from &link.voicemail.conf;.
+ </para>
+
+ <para>
+ If the mailbox is specified, only that mailbox's password will be considered
+ valid. If the mailbox is not specified, the channel variable AUTH_MAILBOX
+ will be set with the authenticated mailbox.
+ </para>
+
+ <para>
+ <parameter>options</parameter> can be one or more of the following:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>s</literal> - Skip playing the initial prompts.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+</refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
Modified: entities/file-entities.ent
URL: http://svncommunity.digium.com/view/asterisk-docs/entities/file-entities.ent?rev=3&r1=2&r2=3&view=diff
==============================================================================
--- entities/file-entities.ent (original)
+++ entities/file-entities.ent Wed May 3 16:18:13 2006
@@ -25,6 +25,7 @@
<!ENTITY reference.voicemail.reference SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/voicemail/reference.xml'>
<!ENTITY reference.voicemail.functions SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/voicemail/functions.xml'>
<!ENTITY reference.voicemail.functions.voicemail SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/voicemail/functions/voicemail.xml'>
+<!ENTITY reference.voicemail.functions.vmauthenticate SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/voicemail/functions/vmauthenticate.xml'>
<!ENTITY reference.voicemail.functions SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/voicemail/functions.xml'>
<!ENTITY reference.flowcontrol.functions SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/flowcontrol/functions.xml'>
<!ENTITY reference.flowcontrol.functions.goto SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/flowcontrol/functions/goto.xml'>
@@ -39,9 +40,13 @@
<!ENTITY reference.general.reference SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/reference.xml'>
<!ENTITY reference.general.functions SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/functions.xml'>
<!ENTITY reference.general.functions.authenticate SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/functions/authenticate.xml'>
+<!ENTITY reference.general.functions.senddtmf SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/functions/senddtmf.xml'>
+<!ENTITY reference.general.functions.sendimage SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/functions/sendimage.xml'>
+<!ENTITY reference.general.functions.sendtext SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/functions/sendtext.xml'>
<!ENTITY reference.general.functions SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/reference/general/functions.xml'>
<!ENTITY config.intro SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/config/intro.xml'>
<!ENTITY config.extensions SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/config/extensions.xml'>
+<!ENTITY config.voicemail SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/config/voicemail.xml'>
<!ENTITY language.constants SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/language/constants.xml'>
<!ENTITY language.macros SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/language/macros.xml'>
<!ENTITY language.basic-syntax SYSTEM '/usr/local/www/vhosts/asterisk-docs/astdoc/en/language/basic-syntax.xml'>
As has been suggested multiple times already, you should *really* start
using the term "application" in this documentation before you get much
further. We have another entity in asterisk called dialplan functions
which are completely different from applications. Use of the term
"function" in this context is bound to cause mass confusion.
Russell
_______________________________________________
--Bandwidth and Colocation provided by Easynews.com --
As has been suggested multiple times already, you should *really* start
using the term "application" in this documentation before you get much
further. We have another entity in asterisk called dialplan functions
which are completely different from applications. Use of the term
"function" in this context is bound to cause mass confusion.
You did, and it was noted. Unfortunately there is a lot of code wrapped
up around the name function and I fear that trying to figure out how to
rename them will slow the implementation of documentation. Since
"function" only exists in the ID name and the URL name, I decided to fix
that later, since the change could be automated, and only exists within
the application documentation in a single place.
I'm hoping that someone will come forward to tinker with the internals of
how the documentation is auto-generated (function/application indexes are
automatically generated rather than manually, and I don't want to muck it
up at this point).
Beckman
---------------------------------------------------------------------------
Peter Beckman Internet Guy
beckman@purplecow.comhttp://www.purplecow.com/
---------------------------------------------------------------------------
_______________________________________________
--Bandwidth and Colocation provided by Easynews.com --
Posted: Thu May 04, 2006 2:50 pm Post subject: [asterisk-doc] r3 - // /en/config/ /en/reference/general/ /e
On Thu, 4 May 2006, Randy Resnick wrote:
Quote:
Russell Bryant wrote:
> commits@digium.com wrote:
>> +<refentry id="function.vmauthenticate">
>
> As has been suggested multiple times already, you should *really* start
> using the term "application" in this documentation before you get much
> further. We have another entity in asterisk called dialplan functions
> which are completely different from applications. Use of the term
> "function" in this context is bound to cause mass confusion.
I wish I had more time because not only is what Russel said very true
and important, the entire terminology needs to be scrutinized and I
think several areas need improvement. This is no one's fault, just the
organic growth of asterisk.
See my email from moments before this one (:-) ); the documentation itself
calls everything "Applications" except for that class ID.
Quote:
Someone should step in and identify the ambiguous and hard to search for
elements as well. For example, when talking about this:
${EXTEN:4}
What is that called? If I didn't know better, starting with asterisk, my
reasoning would be "there's gotta be a substring function" (heh, or is
that an application?) Once I coulnd't remember whether ${}:n was zero or
one indexed. I googles for asterisk substring, assuming I'd find
"substr() is deprecated, see fjhregf.
There is a "Language Reference" section that is pretty poor at the moment,
but I would assume it would be put there, under a "Variables" section that
would cover the concept of Global, Channel and other variables, as well as
modifiers such as :4, why the curly braces are there and when to use them,
etc.
I'll add the Variables Language Reference today; it should be viewable
here in the next hour or two:
Beckman
---------------------------------------------------------------------------
Peter Beckman Internet Guy
beckman@purplecow.comhttp://www.purplecow.com/
---------------------------------------------------------------------------
_______________________________________________
--Bandwidth and Colocation provided by Easynews.com --
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum