From 4dcdded687e3051d8cfb68d9eac72a06dfdd0fd2 Mon Sep 17 00:00:00 2001
From: George Joseph <gjoseph@sangoma.com>
Date: Mon, 1 Apr 2024 06:30:54 -0600
Subject: [PATCH] Fix incorrect application and function documentation
 references

There were a few references in the embedded documentation XML
where the case didn't match or where the referenced app or function
simply didn't exist any more.  These were causing 404 responses
in docs.asterisk.org.

(cherry picked from commit 0e0a56a0ca4ef8c54deb868ff64b8824878b782a)
---
 apps/app_mixmonitor.c |  1 -
 apps/app_stack.c      |  4 ++--
 channels/chan_iax2.c  |  3 ---
 main/pbx_builtins.c   | 10 +++++-----
 res/res_fax.c         | 10 +++++-----
 5 files changed, 12 insertions(+), 16 deletions(-)

diff --git a/apps/app_mixmonitor.c b/apps/app_mixmonitor.c
index 95ecd71a86..22aedcad0b 100644
--- a/apps/app_mixmonitor.c
+++ b/apps/app_mixmonitor.c
@@ -177,7 +177,6 @@
 			<ref type="application">StopMixMonitor</ref>
 			<ref type="application">PauseMonitor</ref>
 			<ref type="application">UnpauseMonitor</ref>
-			<ref type="function">AUDIOHOOK_INHERIT</ref>
 		</see-also>
 	</application>
 	<application name="StopMixMonitor" language="en_US">
diff --git a/apps/app_stack.c b/apps/app_stack.c
index 557c6f160f..a927cb574b 100644
--- a/apps/app_stack.c
+++ b/apps/app_stack.c
@@ -202,7 +202,7 @@
 			returning to the dialplan with execution of a Return().</para>
 		</description>
 		<see-also>
-			<ref type="application">GoSub</ref>
+			<ref type="application">Gosub</ref>
 		</see-also>
 	</agi>
 	<managerEvent language="en_US" name="VarSet">
@@ -220,7 +220,7 @@
 				</parameter>
 			</syntax>
 			<see-also>
-				<ref type="application">GoSub</ref>
+				<ref type="application">Gosub</ref>
 				<ref type="agi">gosub</ref>
 				<ref type="function">LOCAL</ref>
 				<ref type="function">LOCAL_PEEK</ref>
diff --git a/channels/chan_iax2.c b/channels/chan_iax2.c
index ecf5074d9c..5d92b4ad2f 100644
--- a/channels/chan_iax2.c
+++ b/channels/chan_iax2.c
@@ -192,9 +192,6 @@
 		<description>
 			<para>Gets information associated with the specified IAX2 peer.</para>
 		</description>
-		<see-also>
-			<ref type="function">SIPPEER</ref>
-		</see-also>
 	</function>
 	<function name="IAXVAR" language="en_US">
 		<synopsis>
diff --git a/main/pbx_builtins.c b/main/pbx_builtins.c
index 54fe4ff92a..afe9418ef7 100644
--- a/main/pbx_builtins.c
+++ b/main/pbx_builtins.c
@@ -131,7 +131,7 @@
 		<see-also>
 			<ref type="application">Congestion</ref>
 			<ref type="application">Progress</ref>
-			<ref type="application">Playtones</ref>
+			<ref type="application">PlayTones</ref>
 			<ref type="application">Hangup</ref>
 		</see-also>
 	</application>
@@ -151,7 +151,7 @@
 		<see-also>
 			<ref type="application">Busy</ref>
 			<ref type="application">Progress</ref>
-			<ref type="application">Playtones</ref>
+			<ref type="application">PlayTones</ref>
 			<ref type="application">Hangup</ref>
 		</see-also>
 	</application>
@@ -392,7 +392,7 @@
 			<ref type="application">Busy</ref>
 			<ref type="application">Congestion</ref>
 			<ref type="application">Ringing</ref>
-			<ref type="application">Playtones</ref>
+			<ref type="application">PlayTones</ref>
 		</see-also>
 	</application>
 	<application name="RaiseException" language="en_US">
@@ -407,7 +407,7 @@
 			dialplan function EXCEPTION(). If the <literal>e</literal> extension does not exist, the call will hangup.</para>
 		</description>
 		<see-also>
-			<ref type="function">Exception</ref>
+			<ref type="function">EXCEPTION</ref>
 		</see-also>
 	</application>
 	<application name="Ringing" language="en_US">
@@ -422,7 +422,7 @@
 			<ref type="application">Busy</ref>
 			<ref type="application">Congestion</ref>
 			<ref type="application">Progress</ref>
-			<ref type="application">Playtones</ref>
+			<ref type="application">PlayTones</ref>
 		</see-also>
 	</application>
 	<application name="SayAlpha" language="en_US">
diff --git a/res/res_fax.c b/res/res_fax.c
index be7f5092a5..8b26ff97eb 100644
--- a/res/res_fax.c
+++ b/res/res_fax.c
@@ -117,7 +117,7 @@
 		<description>
  			<para>This application is provided by res_fax, which is a FAX technology agnostic module
  			that utilizes FAX technology resource modules to complete a FAX transmission.</para>
- 			<para>Session arguments can be set by the FAXOPT function and to check results of the ReceiveFax() application.</para>
+ 			<para>Session arguments can be set by the FAXOPT function and to check results of the ReceiveFAX() application.</para>
 		</description>
 		<see-also>
 			<ref type="function">FAXOPT</ref>
@@ -156,7 +156,7 @@
 		<description>
  			<para>This application is provided by res_fax, which is a FAX technology agnostic module
  			that utilizes FAX technology resource modules to complete a FAX transmission.</para>
- 			<para>Session arguments can be set by the FAXOPT function and to check results of the SendFax() application.</para>
+ 			<para>Session arguments can be set by the FAXOPT function and to check results of the SendFAX() application.</para>
 		</description>
 		<see-also>
 			<ref type="function">FAXOPT</ref>
@@ -237,8 +237,8 @@
 		   	it can also be used to retrieve information about a FAX session that has finished eg. pages/status.</para>
 		</description>
 		<see-also>
-			<ref type="application">ReceiveFax</ref>
-			<ref type="application">SendFax</ref>
+			<ref type="application">ReceiveFAX</ref>
+			<ref type="application">SendFAX</ref>
 		</see-also>
 	</function>
 	<manager name="FAXSessions" language="en_US">
@@ -2273,7 +2273,7 @@ static int receivefax_exec(struct ast_channel *chan, const char *data)
 	}
 
 	if (report_receive_fax_status(chan, args.filename)) {
-		ast_log(AST_LOG_ERROR, "Error publishing ReceiveFax status message\n");
+		ast_log(AST_LOG_ERROR, "Error publishing ReceiveFAX status message\n");
 	}
 
 	/* If the channel hungup return -1; otherwise, return 0 to continue in the dialplan */