On Sun, 23 Apr 2006, Russell Bryant wrote:

Peter Beckman wrote:
 The fact that flags to voicemail (though you point
 out that his is changing - sweet!) are part of the mailbox# string is
 confusing when the Dial flags are a comma delimited part of the
 parameters.

Actually, the options string to Voicemail was moved to the end even before
Asterisk 1.2 was released five months ago.  In fact, this change was made on
April 13th, 2005 - revision 5461 (we're currently on revision 22230).  That was
over one year ago!

So, perhaps before you make posts to the development list pointing out problems,
you should check to see that your statements are still accurate, and not more
than a year out of date.

 I normally would!  Where's that documentation?

 I found this: http://www.asterisk.org/doxygen/app__voicemail_8c.html

 But I can't really find the options for Voicemail in that 1MB file.  By
 doing a "show application voicemail" and searching for "This application
 allows" I did find it in line 338 of app_voicemail.c.

 And I agree, it clearly points out what the options string to Voicemail
 is.

 I believe most people who do not develop Asterisk and who don't know about
 the "show application xxx" command (and while they should, they don't) go
 to voip-info.org wiki, which tends to be wildly inaccurate.  Clearly my
 source, voip-info.org, for the flags in Voicemail is incorrectly
 documented.

 All I want to do is take this documentation:


    -= Info about application 'VoiceMail' =-

    [Synopsis]
    Leave a Voicemail message

    [Description]
    VoiceMail([EMAIL PROTECTED]&[EMAIL PROTECTED]|options]): This
    application allows the calling party to leave a message for the specified
    list of mailboxes. When multiple mailboxes are specified, the greeting will
    be taken from the first mailbox specified. Dialplan execution will stop if 
the
    specified mailbox does not exist.
    The Voicemail application will exit if any of the following DTMF digits are
    received:
        0 - Jump to the 'o' extension in the current dialplan context.
        * - Jump to the 'a' extension in the current dialplan context.
    This application will set the following channel variable upon completion:
        VMSTATUS - This indicates the status of the execution of the VoiceMail
                application. The possible values are:
                SUCCESS | USEREXIT | FAILED

    Options:
        b    - Play the 'busy' greeting to the calling party.
        g(#) - Use the specified amount of gain when recording the voicemail
            message. The units are whole-number decibels (dB).
        s    - Skip the playback of instructions for leaving a message to the
            calling party.
        u    - Play the 'unavailable greeting.
        j    - Jump to priority n+101 if the mailbox is not found or some other
            error occurs.

 And turn it into this:

    http://mph.gotdns.com:82/manual/en/function.voicemail.php

 There are some examples, a bit more enumeration about the function, notes
 about the mutual-exclusivity of the b and u flags, the (potentially
 inaccurate) note about the arrival of the j and g flags, the change in
 version about the flags, and once I get it working, an asterisk code-based
 version information about when that application showed up in Asterisk.

 Can you see my vision?  What's there is good, but I think it can be
 better.

Beckman
---------------------------------------------------------------------------
Peter Beckman                                                  Internet Guy
[EMAIL PROTECTED]                             http://www.purplecow.com/
---------------------------------------------------------------------------
_______________________________________________
--Bandwidth and Colocation provided by Easynews.com --

asterisk-dev mailing list
To UNSUBSCRIBE or update options visit:
  http://lists.digium.com/mailman/listinfo/asterisk-dev

Reply via email to