/* -*-c-*-
*
- * $Id: conf.h,v 1.4 1999/08/19 18:32:48 mdw Exp $
+ * $Id: conf.h,v 1.6 2002/01/13 14:48:16 mdw Exp $
*
* Configuration parsing
*
/*----- Revision history --------------------------------------------------*
*
* $Log: conf.h,v $
+ * Revision 1.6 2002/01/13 14:48:16 mdw
+ * Make delimiters be a property of a scanner. Change the delimiter-
+ * changing functions' names.
+ *
+ * Revision 1.5 1999/10/22 22:46:44 mdw
+ * Improve documentation for conf_enum.
+ *
* Revision 1.4 1999/08/19 18:32:48 mdw
* Improve lexical analysis. In particular, `chmod' patterns don't have to
* be quoted any more.
/*----- Functions provided ------------------------------------------------*/
-/* --- @undelim@ --- *
+/* --- @conf_undelim@ --- *
*
- * Arguments: @const char *d, dd@ = pointer to characters to escape
+ * Arguments: @scanner *sc@ = pointer to scanner definition
+ * @const char *d, *dd@ = pointer to characters to escape
*
* Returns: ---
*
* second list will always be allowed to continue a word.
*/
-extern void undelim(const char */*d*/, const char */*dd*/);
+extern void conf_undelim(scanner */*sc*/,
+ const char */*d*/, const char */*dd*/);
/* --- @token@ --- *
*
* Returns: Index into list, zero-based, or @-1@.
*
* Use: Checks whether the current token is a string which matches
- * one of the comma-separated items given. If not, an error is
- * reported; otherwise the index of the matched item is
- * returned.
+ * one of the comma-separated items given. The return value is
+ * the index (zero-based) of the matched string in the list.
+ *
+ * The flags control the behaviour if no exact match is found.
+ * If @ENUM_ABBREV@ is set, and the current token is a left
+ * substring of exactly one of the possibilities, then that one
+ * is chosen. If @ENUM_NONE@ is set, the value @-1@ is
+ * returned; otherwise an error is reported and the program is
+ * terminated.
*/
#define ENUM_ABBREV 1u