[Asterisk-code-review] manager: Add <see-also> tags to relate interrelated events/a... (asterisk[13])
Matt Jordan
asteriskteam at digium.com
Sat Aug 13 22:05:45 CDT 2016
Matt Jordan has uploaded a new change for review.
https://gerrit.asterisk.org/3533
Change subject: manager: Add <see-also> tags to relate interrelated events/actions together
......................................................................
manager: Add <see-also> tags to relate interrelated events/actions together
Change-Id: Idbac539205aa732bf786c4f765577d8e9ff28ba4
---
M main/manager.c
M main/stasis_bridges.c
2 files changed, 89 insertions(+), 0 deletions(-)
git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/33/3533/1
diff --git a/main/manager.c b/main/manager.c
index cdbf5fb..0ca84b2 100644
--- a/main/manager.c
+++ b/main/manager.c
@@ -149,6 +149,9 @@
<description>
<para>Logoff the current manager session.</para>
</description>
+ <see-also>
+ <ref type="manager">Login</ref>
+ </see-also>
</manager>
<manager name="Login" language="en_US">
<synopsis>
@@ -168,6 +171,9 @@
<description>
<para>Login Manager.</para>
</description>
+ <see-also>
+ <ref type="manager">Logoff</ref>
+ </see-also>
</manager>
<manager name="Challenge" language="en_US">
<synopsis>
@@ -321,6 +327,9 @@
<para>If a channel name is not provided then the variable is considered global.</para>
</note>
</description>
+ <see-also>
+ <ref type="manager">Getvar</ref>
+ </see-also>
</manager>
<manager name="Getvar" language="en_US">
<synopsis>
@@ -341,6 +350,9 @@
<para>If a channel name is not provided then the variable is considered global.</para>
</note>
</description>
+ <see-also>
+ <ref type="manager">Setvar</ref>
+ </see-also>
</manager>
<manager name="GetConfig" language="en_US">
<synopsis>
@@ -373,6 +385,12 @@
In the case where a category name is non-unique, a filter may be specified
to match only categories with matching variable values.</para>
</description>
+ <see-also>
+ <ref type="manager">GetConfigJSON</ref>
+ <ref type="manager">UpdateConfig</ref>
+ <ref type="manager">CreateConfig</ref>
+ <ref type="manager">ListCategories</ref>
+ </see-also>
</manager>
<manager name="GetConfigJSON" language="en_US">
<synopsis>
@@ -397,6 +415,12 @@
In the case where a category name is non-unique, a filter may be specified
to match only categories with matching variable values.</para>
</description>
+ <see-also>
+ <ref type="manager">GetConfig</ref>
+ <ref type="manager">UpdateConfig</ref>
+ <ref type="manager">CreateConfig</ref>
+ <ref type="manager">ListCategories</ref>
+ </see-also>
</manager>
<manager name="UpdateConfig" language="en_US">
<synopsis>
@@ -488,6 +512,12 @@
<para>This action will modify, create, or delete configuration elements
in Asterisk configuration files.</para>
</description>
+ <see-also>
+ <ref type="manager">GetConfig</ref>
+ <ref type="manager">GetConfigJSON</ref>
+ <ref type="manager">CreateConfig</ref>
+ <ref type="manager">ListCategories</ref>
+ </see-also>
</manager>
<manager name="CreateConfig" language="en_US">
<synopsis>
@@ -504,6 +534,12 @@
directory. This action is intended to be used before an UpdateConfig
action.</para>
</description>
+ <see-also>
+ <ref type="manager">GetConfig</ref>
+ <ref type="manager">GetConfigJSON</ref>
+ <ref type="manager">UpdateConfig</ref>
+ <ref type="manager">ListCategories</ref>
+ </see-also>
</manager>
<manager name="ListCategories" language="en_US">
<synopsis>
@@ -518,6 +554,12 @@
<description>
<para>This action will dump the categories in a given file.</para>
</description>
+ <see-also>
+ <ref type="manager">GetConfig</ref>
+ <ref type="manager">GetConfigJSON</ref>
+ <ref type="manager">UpdateConfig</ref>
+ <ref type="manager">CreateConfig</ref>
+ </see-also>
</manager>
<manager name="Redirect" language="en_US">
<synopsis>
@@ -553,6 +595,9 @@
<description>
<para>Redirect (transfer) a call.</para>
</description>
+ <see-also>
+ <ref type="manager">BlindTransfer</ref>
+ </see-also>
</manager>
<manager name="Atxfer" language="en_US">
<synopsis>
@@ -573,6 +618,9 @@
<description>
<para>Attended transfer.</para>
</description>
+ <see-also>
+ <ref type="managerEvent">AttendedTransfer</ref>
+ </see-also>
</manager>
<manager name="Originate" language="en_US">
<synopsis>
@@ -697,6 +745,9 @@
<para>Will return an <literal>Extension Status</literal> message. The response will include
the hint for the extension and the status.</para>
</description>
+ <see-also>
+ <ref type="managerEvent">ExtensionStatus</ref>
+ </see-also>
</manager>
<manager name="PresenceState" language="en_US">
<synopsis>
@@ -713,6 +764,9 @@
<para>Will return a <literal>Presence State</literal> message. The response will include the
presence state and, if set, a presence subtype and custom message.</para>
</description>
+ <see-also>
+ <ref type="managerEvent">PresenceStatus</ref>
+ </see-also>
</manager>
<manager name="AbsoluteTimeout" language="en_US">
<synopsis>
@@ -750,6 +804,9 @@
<para>Waiting: <literal>0</literal> if messages waiting, <literal>1</literal>
if no messages waiting.</para>
</description>
+ <see-also>
+ <ref type="manager">MailboxCount</ref>
+ </see-also>
</manager>
<manager name="MailboxCount" language="en_US">
<synopsis>
@@ -770,6 +827,9 @@
<para>NewMessages: <replaceable>count</replaceable></para>
<para>OldMessages: <replaceable>count</replaceable></para>
</description>
+ <see-also>
+ <ref type="manager">MailboxStatus</ref>
+ </see-also>
</manager>
<manager name="ListCommands" language="en_US">
<synopsis>
@@ -875,6 +935,9 @@
<description>
<para>Send a reload event.</para>
</description>
+ <see-also>
+ <ref type="manager">ModuleLoad</ref>
+ </see-also>
</manager>
<managerEvent language="en_US" name="CoreShowChannel">
<managerEventInstance class="EVENT_FLAG_CALL">
@@ -987,6 +1050,10 @@
<description>
<para>Loads, unloads or reloads an Asterisk module in a running system.</para>
</description>
+ <see-also>
+ <ref type="manager">Reload</ref>
+ <ref type="manager">ModuleCheck</ref>
+ </see-also>
</manager>
<manager name="ModuleCheck" language="en_US">
<synopsis>
@@ -1002,6 +1069,9 @@
<para>Checks if Asterisk module is loaded. Will return Success/Failure.
For success returns, the module revision number is included.</para>
</description>
+ <see-also>
+ <ref type="manager">ModuleLoad</ref>
+ </see-also>
</manager>
<manager name="AOCMessage" language="en_US">
<synopsis>
@@ -1171,6 +1241,9 @@
this command can be used to create filters that may bypass
filters defined in manager.conf</para>
</description>
+ <see-also>
+ <ref type="manager">FilterList</ref>
+ </see-also>
</manager>
<manager name="FilterList" language="en_US">
<synopsis>
@@ -1180,6 +1253,9 @@
<para>The filters displayed are for the current session. Only those filters defined in
manager.conf will be present upon starting a new session.</para>
</description>
+ <see-also>
+ <ref type="manager">Filter</ref>
+ </see-also>
</manager>
<manager name="BlindTransfer" language="en_US">
<synopsis>
@@ -1198,6 +1274,7 @@
</description>
<see-also>
<ref type="manager">Redirect</ref>
+ <ref type="managerEvent">BlindTransfer</ref>
</see-also>
</manager>
<managerEvent name="ExtensionStatus" language="en_US">
@@ -1275,6 +1352,9 @@
</enumlist>
</parameter>
</syntax>
+ <see-also>
+ <ref type="manager">ExtensionState</ref>
+ </see-also>
</managerEventInstance>
</managerEvent>
<managerEvent name="PresenceStatus" language="en_US">
@@ -1288,6 +1368,9 @@
<parameter name="Subtype" />
<parameter name="Message" />
</syntax>
+ <see-also>
+ <ref type="manager">PresenceState</ref>
+ </see-also>
</managerEventInstance>
</managerEvent>
***/
diff --git a/main/stasis_bridges.c b/main/stasis_bridges.c
index 1838557..3688a46 100644
--- a/main/stasis_bridges.c
+++ b/main/stasis_bridges.c
@@ -79,6 +79,9 @@
<para>Destination extension for the blind transfer.</para>
</parameter>
</syntax>
+ <see-also>
+ <ref type="manager">BlindTransfer</ref>
+ </see-also>
</managerEventInstance>
</managerEvent>
<managerEvent language="en_US" name="AttendedTransfer">
@@ -131,6 +134,9 @@
<para> <replaceable>SecondTransfererChannel</replaceable>: Alice's channel in the bridge with Bob.</para>
<para> <replaceable>SecondBridgeUniqueid</replaceable>: The bridge between Alice and Bob.</para>
</description>
+ <see-also>
+ <ref type="manager">AtxFer</ref>
+ </see-also>
</managerEventInstance>
</managerEvent>
***/
--
To view, visit https://gerrit.asterisk.org/3533
To unsubscribe, visit https://gerrit.asterisk.org/settings
Gerrit-MessageType: newchange
Gerrit-Change-Id: Idbac539205aa732bf786c4f765577d8e9ff28ba4
Gerrit-PatchSet: 1
Gerrit-Project: asterisk
Gerrit-Branch: 13
Gerrit-Owner: Matt Jordan <mjordan at digium.com>
More information about the asterisk-code-review
mailing list