/*      $NetBSD: genshell.h,v 1.6 2024/08/18 20:47:24 christos Exp $    */

/*   -*- buffer-read-only: t -*- vi: set ro:
*
*  DO NOT EDIT THIS FILE   (genshell.h)
*
*  It has been AutoGen-ed
*  From the definitions    genshell.def
*  and the template file   options
*
* Generated from AutoOpts 42:1:17 templates.
*
*  AutoOpts is a copyrighted work.  This header file is not encumbered
*  by AutoOpts licensing, but is provided under the licensing terms chosen
*  by the genshellopt author or copyright holder.  AutoOpts is
*  licensed under the terms of the LGPL.  The redistributable library
*  (``libopts'') is licensed under the terms of either the LGPL or, at the
*  users discretion, the BSD license.  See the AutoOpts and/or libopts sources
*  for details.
*
* The genshellopt program is copyrighted and licensed
* under the following terms:
*
*  Copyright (C) 1999-2018 Bruce Korb, all rights reserved.
*  This is free software. It is licensed for use, modification and
*  redistribution under the terms of the GNU Lesser General Public License,
*  version 2 or later <http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html>
*
*  The genshellopt library is free software; you can redistribute it and/or
*  modify it under the terms of the GNU Library General Public License as
*  published by the Free Software Foundation; either version 2 of the
*  License, or (at your option) any later version.
*
*  This library is distributed in the hope that it will be useful, but
*  WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
*  Library General Public License for more details.
*
*  You should have received a copy of the GNU Library General Public
*  License along with this library; if not, see
*  <http://www.gnu.org/licenses/old-licenses/lgpl-2.0.html>
*/
/**
*  This file contains the programmatic interface to the Automated
*  Options generated for the genshellopt program.
*  These macros are documented in the AutoGen info file in the
*  "AutoOpts" chapter.  Please refer to that doc for usage help.
*/
#ifndef AUTOOPTS_GENSHELL_H_GUARD
#define AUTOOPTS_GENSHELL_H_GUARD 1
#include <autoopts/options.h>
#include <stdarg.h>
#include <stdnoreturn.h>

/**
*  Ensure that the library used for compiling this generated header is at
*  least as new as the version current when the header template was released
*  (not counting patch version increments).  Also ensure that the oldest
*  tolerable version is at least as old as what was current when the header
*  template was released.
*/
#define AO_TEMPLATE_VERSION 172033
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
 Choke Me.
#endif

#if GCC_VERSION > 40400
#define NOT_REACHED __builtin_unreachable();
#else
#define NOT_REACHED
#endif

/**
*  Enumeration of each option type for genshellopt
*/
typedef enum {
   INDEX_GENSHELL_OPT_SCRIPT      =  0,
   INDEX_GENSHELL_OPT_SHELL       =  1,
   INDEX_GENSHELL_OPT_VERSION     =  2,
   INDEX_GENSHELL_OPT_HELP        =  3,
   INDEX_GENSHELL_OPT_MORE_HELP   =  4
} teGenshell_OptIndex;
/** count of all options for genshellopt */
#define GENSHELL_OPTION_CT    5
/** genshellopt version */
#define GENSHELLOPT_VERSION       "1"
/** Full genshellopt version text */
#define GENSHELLOPT_FULL_VERSION  "genshellopt 1"

/**
*  Interface defines for all options.  Replace "n" with the UPPER_CASED
*  option name (as in the teGenshell_OptIndex enumeration above).
*  e.g. HAVE_GENSHELL_OPT(SCRIPT)
*/
#define GENSHELL_DESC(n) (genshelloptOptions.pOptDesc[INDEX_GENSHELL_OPT_## n])
/** 'true' if an option has been specified in any way */
#define     HAVE_GENSHELL_OPT(n) (! UNUSED_OPT(& GENSHELL_DESC(n)))
/** The string argument to an option. The argument type must be \"string\". */
#define      GENSHELL_OPT_ARG(n) (GENSHELL_DESC(n).optArg.argString)
/** Mask the option state revealing how an option was specified.
*  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
* \a OPTST_DEFINED, \a OPTST_RESET or zero.
*/
#define    STATE_GENSHELL_OPT(n) (GENSHELL_DESC(n).fOptState & OPTST_SET_MASK)
/** Count of option's occurrances *on the command line*. */
#define    COUNT_GENSHELL_OPT(n) (GENSHELL_DESC(n).optOccCt)
/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
#define    ISSEL_GENSHELL_OPT(n) (SELECTED_OPT(&GENSHELL_DESC(n)))
/** 'true' if \a HAVE_OPT would yield 'false'. */
#define ISUNUSED_GENSHELL_OPT(n) (UNUSED_OPT(& GENSHELL_DESC(n)))
/** 'true' if OPTST_DISABLED bit not set. */
#define  ENABLED_GENSHELL_OPT(n) (! DISABLED_OPT(& GENSHELL_DESC(n)))
/** number of stacked option arguments.
*  Valid only for stacked option arguments. */
#define  STACKCT_GENSHELL_OPT(n) (((tArgList*)(GENSHELL_DESC(n).optCookie))->useCt)
/** stacked argument vector.
*  Valid only for stacked option arguments. */
#define STACKLST_GENSHELL_OPT(n) (((tArgList*)(GENSHELL_DESC(n).optCookie))->apzArgs)
/** Reset an option. */
#define    CLEAR_GENSHELL_OPT(n) STMTS( \
               GENSHELL_DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
               if ((GENSHELL_DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                   GENSHELL_DESC(n).fOptState |= OPTST_DISABLED; \
               GENSHELL_DESC(n).optCookie = NULL )
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
*  Enumeration of genshellopt exit codes
*/
typedef enum {
   GENSHELLOPT_EXIT_SUCCESS         = 0,
   GENSHELLOPT_EXIT_FAILURE         = 1,
   GENSHELLOPT_EXIT_USAGE_ERROR     = 64,
   GENSHELLOPT_EXIT_LIBOPTS_FAILURE = 70
}   genshellopt_exit_code_t;
/**
*  Interface defines for specific options.
* @{
*/
#define VALUE_GENSHELL_OPT_SCRIPT 'o'
#define VALUE_GENSHELL_OPT_SHELL 's'
/** option flag (value) for help-value option */
#define VALUE_GENSHELL_OPT_HELP '?'
/** option flag (value) for more-help-value option */
#define VALUE_GENSHELL_OPT_MORE_HELP '!'
/** option flag (value) for version-value option */
#define VALUE_GENSHELL_OPT_VERSION 'v'
/*
*  Interface defines not associated with particular options
*/
#define ERRSKIP_GENSHELL_OPTERR  STMTS(genshelloptOptions.fOptSet &= ~OPTPROC_ERRSTOP)
#define ERRSTOP_GENSHELL_OPTERR  STMTS(genshelloptOptions.fOptSet |= OPTPROC_ERRSTOP)
#define RESTART_GENSHELL_OPT(n)  STMTS( \
               genshelloptOptions.curOptIdx = (n); \
               genshelloptOptions.pzCurOpt  = NULL )
#define START_GENSHELL_OPT       RESTART_GENSHELL_OPT(1)
#define GENSHELL_USAGE(c)        (*genshelloptOptions.pUsageProc)(&genshelloptOptions, c)

#ifdef  __cplusplus
extern "C" {
#endif
/*
*  global exported definitions
*/
#define ch_t  unsigned char
#define cc_t  const unsigned char
#define cch_t char const


/* * * * * *
*
*  Declare the genshellopt option descriptor.
*/
extern tOptions genshelloptOptions;

#if defined(ENABLE_NLS)
# ifndef _
#   include <stdio.h>
#   ifndef HAVE_GETTEXT
     extern char * gettext(char const *);
#   else
#     include <libintl.h>
#   endif

# ifndef ATTRIBUTE_FORMAT_ARG
#   define ATTRIBUTE_FORMAT_ARG(_a)
# endif

static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1);
static inline char* aoGetsText(char const* pz) {
   if (pz == NULL) return NULL;
   return (char*)gettext(pz);
}
#   define _(s)  aoGetsText(s)
# endif /* _() */

# define OPT_NO_XLAT_CFG_NAMES  STMTS(genshelloptOptions.fOptSet |= \
                                   OPTPROC_NXLAT_OPT_CFG;)
# define OPT_NO_XLAT_OPT_NAMES  STMTS(genshelloptOptions.fOptSet |= \
                                   OPTPROC_NXLAT_OPT|OPTPROC_NXLAT_OPT_CFG;)

# define OPT_XLAT_CFG_NAMES     STMTS(genshelloptOptions.fOptSet &= \
                                 ~(OPTPROC_NXLAT_OPT|OPTPROC_NXLAT_OPT_CFG);)
# define OPT_XLAT_OPT_NAMES     STMTS(genshelloptOptions.fOptSet &= \
                                 ~OPTPROC_NXLAT_OPT;)

#else   /* ENABLE_NLS */
# define OPT_NO_XLAT_CFG_NAMES
# define OPT_NO_XLAT_OPT_NAMES

# define OPT_XLAT_CFG_NAMES
# define OPT_XLAT_OPT_NAMES

# ifndef _
#   define _(_s)  _s
# endif
#endif  /* ENABLE_NLS */


#ifdef  __cplusplus
}
#endif
#endif /* AUTOOPTS_GENSHELL_H_GUARD */

/* genshell.h ends here */