change form API to return error instead of warning user.

Update the form API so instead of directly warning the user it returns
an error code to the caller allowing the appropriate action to be
taken outside the core. Additionally clean up documentation of this
API.

1 files changed, 7 insertions, 1 deletions

diff --git a/render/form.h b/render/form.h
index 05898e3c5..eefa5ae37 100644
--- a/render/form.h
+++ b/render/form.h
@@ -126,6 +126,12 @@ struct form_control {
 };
 
 
-void form_select_process_selection(struct form_control *control, int item);
+/**
+ * Process a selection from a form select menu.
+ *
+ * \param  control  form control with menu
+ * \param  item	    index of item selected from the menu
+ */
+nserror form_select_process_selection(struct form_control *control, int item);
 
 #endif