documentation: Update Gosub, Goto, and add new documentationtype.

Gosub and Goto were not displaying their syntax correctly on the docs
site. This change adds a new way to specify an optional context, an
optional extension, and a required priority that the xml stylesheet can
parse without having to know which optional parameters come in which
order. In Asterisk, it looks like this:

  parameter name="context" documentationtype="dialplan_context"
  parameter name="extension" documentationtype="dialplan_extension"
  parameter name="priority" documentationtype="dialplan_priority" required="true"

The stylesheet will ignore the context and extension parameters, but for
priority, it will automatically inject the following:

  [[context,]extension,]priority

This is the correct oder for applications such as Gosub and Goto.
This commit is contained in:
Ben Ford
2025-03-14 17:05:30 -05:00
parent 92b005abf8
commit 11684bc0d3
3 changed files with 8 additions and 7 deletions

View File

@@ -227,9 +227,9 @@
Jump to a particular priority, extension, or context.
</synopsis>
<syntax>
<parameter name="context" />
<parameter name="extensions" />
<parameter name="priority" required="true" />
<parameter name="context" documentationtype="dialplan_context" />
<parameter name="extension" documentationtype="dialplan_extension" />
<parameter name="priority" documentationtype="dialplan_priority" required="true" />
</syntax>
<description>
<para>This application will set the current context, extension, and priority in the channel structure.