OSSP CVS Repository

ossp - Difference in ossp-pkg/var/var.pod versions 1.4 and 1.5
Not logged in
[Honeypot]  [Browse]  [Home]  [Login]  [Reports
[Search]  [Ticket]  [Timeline
  [History

ossp-pkg/var/var.pod 1.4 -> 1.5

--- var.pod      2001/11/19 15:38:47     1.4
+++ var.pod      2001/11/19 16:15:32     1.5
@@ -39,6 +39,8 @@
 
 var_rc_t var_expand(const char *input, size_t input_len, char **result, size_t *result_len, var_cb_t lookup, void *lookup_context, const var_config_t *config, int force_expand);
 
+const char *var_strerror(var_rc_t rc);
+
 =head1 DESCRIPTION
 
 The routines included in this library, var_unescape() and
@@ -244,6 +246,16 @@
 error codes described in section "CODES RETURNED BY THE LIBRARY" if
 the function call failed.
 
+=head1 THE VAR_STRERROR FUNCTION
+
+In order to make life for application developers easier, the helper
+function var_strerror() has been provided, which can be used to map
+any of the error codes returned by the OSSP var library into a
+clear-text message describing the reason for failure. Please note that
+errors coming from the callback, such as VAR_ERR_CALLBACK and those
+based on it, cannot be mapped and will yield the message "unknown
+error".
+
 =head1 COMBINING VAR_UNESCAPE AND VAR_EXPAND
 
 For maximum power and flexibility, you will want to use both routines

CVSTrac 2.0.1