diff --git a/res/res_agi.c b/res/res_agi.c
index 557f349715..0bf6290048 100644
--- a/res/res_agi.c
+++ b/res/res_agi.c
@@ -449,13 +449,34 @@
Records to a given file.
-
-
-
-
-
-
-
+
+ The destination filename of the recorded audio.
+
+
+ The audio format in which to save the resulting file.
+
+
+ The DTMF digits that will terminate the recording process.
+
+
+ The maximum recording time in milliseconds. Set to -1 for no
+ limit.
+
+
+ Causes the recording to first seek to the specified offset before
+ recording begins.
+
+
+ Causes Asterisk to play a beep as recording begins. This argument
+ can take any value.
+
+
+ The number of seconds of silence that are permitted before the
+ recording is terminated, regardless of the
+ escape_digits or timeout
+ arguments. If specified, this parameter must be preceded by
+ s=.
+
Record to a file until a given dtmf digit in the sequence is received.
@@ -463,7 +484,9 @@
will be recorded. The timeout is the maximum record time in
milliseconds, or -1 for no timeout.
offset samples is optional, and, if provided, will seek
- to the offset without exceeding the end of the file. silence is
+ to the offset without exceeding the end of the
+ file. beep can take any value, and causes Asterisk
+ to play a beep to the channel that is about to be recorded. silence is
the number of seconds of silence allowed before the function returns despite the
lack of dtmf digits or reaching timeout. silence
value must be preceded by s= and is also optional.