From: Richard Mudgett <rmudgett@digium.com>
Date: Thu, 28 Dec 2017 02:22:36 +0000 (-0600)
Subject: func_channel.c: Update MASTER_CHANNEL documentation
X-Git-Tag: 13.20.0-rc1~136^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=eead5d0c3021d3005868d63d0f18584bcbc3cef5;p=thirdparty%2Fasterisk.git

func_channel.c: Update MASTER_CHANNEL documentation

Be more explicit in what is meant by the master channel to eliminate
misunderstanding.

ASTERISK-23133

Change-Id: I453bcaf4b99404a5a3e345dbf093ac6c1afcfc72
---

diff --git a/funcs/func_channel.c b/funcs/func_channel.c
index 3005d31b12..793ea3f891 100644
--- a/funcs/func_channel.c
+++ b/funcs/func_channel.c
@@ -69,8 +69,11 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			Gets or sets variables on the master channel
 		</synopsis>
 		<description>
-			<para>Allows access to the channel which created the current channel, if any.  If the channel is already
-			a master channel, then accesses local channel variables.</para>
+			<para>Allows access to the oldest channel associated with the current
+			channel if it still exists.  If the channel is the master channel or
+			the master channel no longer exists then access local channel variables
+			instead.  In other words, the master channel is the channel identified by
+			the channel's linkedid.</para>
 		</description>
 	</function>
 	<function name="CHANNEL" language="en_US">