Merged revisions 229966 via svnmerge from

https://origsvn.digium.com/svn/asterisk/trunk

................
  r229966 | file | 2009-11-13 11:20:26 -0600 (Fri, 13 Nov 2009) | 13 lines
  
  Merged revisions 229965 via svnmerge from 
  https://origsvn.digium.com/svn/asterisk/branches/1.4
  
  ........
    r229965 | file | 2009-11-13 11:19:59 -0600 (Fri, 13 Nov 2009) | 6 lines
    
    Document a limitation in the AVAILSTATUS variable from ChanIsAvail and provide
    a workaround for it that does not change existing behavior.
    
    (closes issue #14426)
    Reported by: macli
  ........
................


git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.6.0@229967 f38db490-d61c-443f-a65b-d21fe96a405b

1 files changed, 5 insertions, 0 deletions

diff --git a/apps/app_chanisavail.c b/apps/app_chanisavail.c
index 3425bc35a..8dc95cd9e 100644
--- a/apps/app_chanisavail.c
+++ b/apps/app_chanisavail.c
@@ -53,6 +53,11 @@ static char *descrip =
 "    s - Consider the channel unavailable if the channel is in use at all.\n"
 "    t - Simply checks if specified channels exist in the channel list\n"
 "        (implies option s).\n"
+"Note that the AVAILSTATUS variable is used for both device state\n"
+"and cause code. It is therefore possible for it to give a value that may\n"
+"indicate a device is available when it is not. It is suggested that the\n"
+"AVAILORIGCHAN variable is used instead to see whether a device is available\n"
+"or not.\n"
 "This application sets the following channel variable upon completion:\n"
 "  AVAILCHAN     - the name of the available channel, if one exists\n"
 "  AVAILORIGCHAN - the canonical channel name that was used to create the channel\n"