[asterisk-bugs] [JIRA] (ASTERISK-21717) Documentation for PASSTHRU function is unclear

[Rusty Newton (JIRA)]

    [ https://issues.asterisk.org/jira/browse/ASTERISK-21717?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=205949#comment-205949 ] 

Rusty Newton edited comment on ASTERISK-21717 at 4/30/13 6:17 PM:
------------------------------------------------------------------

Patch adds the following to core show function PASSTHRU
{noformat}
NOTE: The functions which take a variable name need to be passed var and
not ${var}.  Similarly, use PASSTHRU() and not ${PASSTHRU()}.
Example: ${CHANNEL} contains SIP/321-1
         ${CUT(PASSTHRU(${CUT(CHANNEL,-,1)}),/,2)}) will return 321
{noformat}
(I expected 321 not to be on a line by itself).
                
      was (Author: ulogic):
    Patch adds the following to core show function PASSTHRU

NOTE: The functions which take a variable name need to be passed var and
not ${var}.  Similarly, use PASSTHRU() and not ${PASSTHRU()}.
Example: ${CHANNEL} contains SIP/321-1
         ${CUT(PASSTHRU(${CUT(CHANNEL,-,1)}),/,2)}) will return
         321

(I expected 321 not to be on a line by itself).
                  
> Documentation for PASSTHRU function is unclear
> ----------------------------------------------
>
>                 Key: ASTERISK-21717
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-21717
>             Project: Asterisk
>          Issue Type: Improvement
>      Security Level: None
>          Components: Functions/func_strings
>    Affects Versions: 1.8.21.0, 10.12.2, 11.3.0
>            Reporter: Richard Miller
>            Severity: Trivial
>         Attachments: func_strings.diff
>
>
> It is not apparent to the average user that the PASSTHRU function should not be passed as ${PASSTHRU(string)} but just as PASSTHRU(string) to functions which take a variable name and not its contents.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.asterisk.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira