From acb7d5599a6e1774633aa0c063915ba220bcd95e Mon Sep 17 00:00:00 2001
From: Patrick McDermott <patrick.mcdermott@libiquity.com>
Date: Sat, 29 Dec 2018 01:00:51 -0500
Subject: ob_substvars(): Document

---
diff --git a/lib/control.sh b/lib/control.sh
index 53a3ea8..8f9fc26 100644
--- a/lib/control.sh
+++ b/lib/control.sh
@@ -242,6 +242,15 @@ ob_set_substvar()
 	return 0
 }
 
+## @brief Substitute variables in text
+## @details \fBob_substvars\fP substitutes variables previously set with
+##          \fBob_set_substvar\fP(3) in a string.  The format for variable
+##          substitutions is \fI${var}\fP, and substitutions can be nested.
+## @operand string req The string in which to substitute variables.
+## @return Returns 0 on success, 1 on possible recursion, or 125 if called with
+##         an incorrect number of arguments.
+## @stderr Prints a warning on possible recursion.
+## @pure yes This function has no side effects.
 ob_substvars()
 {
 	local string=
--
cgit v0.9.1