/* -*-c-*-
*
- * $Id: conf.h,v 1.3 1999/07/27 18:30:14 mdw Exp $
+ * $Id: conf.h,v 1.9 2004/04/08 01:36:25 mdw Exp $
*
* Configuration parsing
*
* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
-/*----- Revision history --------------------------------------------------*
- *
- * $Log: conf.h,v $
- * Revision 1.3 1999/07/27 18:30:14 mdw
- * Improve documentation and layout for @CONF_BEGIN@ and friends. Remove
- * irritating warning about unused label by introducing a spurious `goto'.
- *
- * Revision 1.2 1999/07/26 23:28:39 mdw
- * Major reconstruction work for new design.
- *
- * Revision 1.1.1.1 1999/07/01 08:56:23 mdw
- * Initial revision.
- *
- */
-
#ifndef CONF_H
#define CONF_H
/*----- Functions provided ------------------------------------------------*/
+/* --- @conf_undelim@ --- *
+ *
+ * Arguments: @scanner *sc@ = pointer to scanner definition
+ * @const char *d, *dd@ = pointer to characters to escape
+ *
+ * Returns: ---
+ *
+ * Use: Modifies the tokenizer. Characters in the first list will
+ * always be considered to begin a word. Characters in the
+ * second list will always be allowed to continue a word.
+ */
+
+extern void conf_undelim(scanner */*sc*/,
+ const char */*d*/, const char */*dd*/);
+
/* --- @token@ --- *
*
* Arguments: @scanner *sc@ = pointer to scanner definition
extern void error(scanner */*sc*/, const char */*msg*/, ...);
+/* --- @pushback@ --- *
+ *
+ * Arguments: @scanner *sc@ = pointer to scanner definition
+ *
+ * Returns: ---
+ *
+ * Use: Pushes the current token back. This is normally a precursor
+ * to pushing a new scanner source.
+ */
+
+extern void pushback(scanner */*sc*/);
+
/* --- @conf_enum@ --- *
*
* Arguments: @scanner *sc@ = pointer to a scanner object
* 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
* because the option wasn't accepted. \
*/ \
\
- goto _conf_reject; \
+ goto _conf_reject; \
_conf_reject: \
if (_conf_state == CS_PLAIN) \
_conf_state = CS_UNKNOWN; \
extern void conf_name(scanner */*sc*/, char /*delim*/, dstr */*d*/);
-/* --- @conf_parse@ --- *
- *
- * Arguments: @scanner *sc@ = pointer to a scanner structure
- *
- * Returns: ---
- *
- * Use: Parses a configuration file fragment from the scanner
- */
-
-extern void conf_parse(scanner *sc);
-
/*----- That's all, folks -------------------------------------------------*/
#ifdef __cplusplus