[asterisk-dev] Command Syntax -- weird?

[Peter Beckman]

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(mailbox[@context][&mailbox[@context]][...][|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
beckman at purplecow.com                             http://www.purplecow.com/
---------------------------------------------------------------------------