gengetopt -- History of visible changes.

Copyright (C) 1999-2011  Free Software Foundation

Please send gengetopt bug reports to bug-gengetopt at gnu.org

Version 2.23

   * Gengen and gengetopt are required when building from git. When building
     from tarball, everything works like it did before.
   * Drop IRIX compatibility
   * To mimic behaviour of coreutils, version string is no longer part of
     --help (bug #34400)
   * To mimic behaviour of coreutils, usage is printed before purpose in --help
     (bug #34402)
   * Use singular (`[OPTION]...`, `[FILE]...`) instead of plural
     (`[OPTIONS]...`, `[FILES]...`) (bug #34394)
   * Fix spelling of `--unnamed`. `--unamed` still provided for backwards
     compatibility. (bug #34392)

Version 2.22.6

   * Fixed a compilation problem in Mac OS X
   * Added versiontext directive
   * Added --strict-hidden command line option
   * Fixed many bugs

Version 2.22.5

   * correctly wraps and preprocess the specified usage string
   * handle escaped newline chars in the .ggo file correctly
   * initialize enum variables with a generated null value (makes
     the parser compilable in C++)
   * removed warnings in generated parser when only flags are used

Version 2.22.4

   * switched to git repository
   * removed other gcc compilation warnings on generated files

Version 2.22.3

   * enum option values can contain + and - (thanks to Papp Gyozo).
   * fixed compilation problems due to macro FIX_UNUSED which was not
   in the right place (thanks to Matthew Junker)
   * --header-output-dir and --src_output-dir to store cmdline.h 
   separately from cmdline.c (thanks to Yegor Yefremov)
   * #include <getopt.h> in the generated files, instead of "getopt.h"
   * generated functions use prototypes with char ** instead of
	char *const *

Version 2.22.2

   * removed further compilation warnings for generated files
   * fixed a compilation problems for files generated with --include-getopt
     with some versions of stdlib.h
   * removed dependency from flex library (that generated problems in
     compilation in open solaris)
   * uses PACKAGE_NAME, if defined, for printing help and version
   * uses --docdir if specified for installing documentation

Version 2.22.1

   * removed compilation warnings for generated files
   * fixed a bug with --long-help and enum options
   * output of --help and output of --show-help correspond
   * fixed a compilation problem in generated output with mode options

Version 2.22

   * avoid test suite if crosscompiling
   * generated code is averagely less verbose
   * generate a function to save the command line options into an open stream
     (thanks to Papp Gyozo).
   * given fields are unsigned also for non multiple options
   * removed compilation warnings for generated code when using
     -Wstrict-prototypes (thanks to Andre Noll)
   * added print_errors parameters to pass to generated parser function to
     suppress getopt_long message printing (thanks to J. David Bryan)
   * if h is specified as a short option, then --help is still automatically
     generated, the same holds for --version and v (thanks to J. David Bryan)
   * initializing of the structure for parser function parameters
     was changed in order to initialize the fields to their default values
     (instead of 0)
   * list of acceptable values for options can be have a type different from
     string and can have type enum (that will generate a C enum)
     (as suggested by Gyozo Papp)
   * usage string is printed only if not empty (as suggested by Gyozo Papp)
   * in case of hidden options, the generated help string array reuses the 
     strings of the full help array (as suggested by Gyozo Papp)
   * the _help field for options is correctly generated even in the presence
     of additional text before and after an option and also groups
   * for an option one can specify the "details" which will be printed in
     case --detailed-help is specified
   * mode options: if an option of a mode is given no option of another
     mode can be specified (mutually exclusive groups of options)
   * can use ? as short option
   * --no-help, --no-version: don't add --help and --version automatically
     (the user can specify those options manually)
   * fixed a bug in generation of multiple options of type longlong

Version 2.21

   * a structure for parser function parameters (that might be extended
     in future versions)
   * a parser parameter to check whether an option that is parsed is
     already present in the args_info struct (suggested by
     Yegor Yefremov)
   * the generated files contain doxygen documentation (suggested by
     Yegor Yefremov)
   * parallel make works
   * generated make files should not depend on GNU make
   * fixed a bug with multiple options with back slashes (thanks to
     Peter Kovacs)
   * updated to version 3 of GPL

Version 2.20

   * if --include-getopt is specified the generated parser is actually
     independent of getopt.h (bug fixed thanks to Tiago Menezes)
   * in help output do not generated a section if all its options are hidden
     (thanks to Edsko de Vries)
   * --default-optional permits specifying that all options are by default
     optional (unless explicitely specified)
   * fixed a bug when generating --full-help handling in case
     --no-handle-help is specified (thanks to Thomas Boehne)
   * fixed a bug in the included getopt code when --include-getopt is specified
   * fixed a bug when using args entry in the .ggo file
     (thanks to Christian Gagneraud)

Version 2.19.1

   * fixed compilation problem that can make 'make check' fail on some systems
     lacking getopt_long.
   * fixed a test problem when not using GNU sed
   * in strings # comments are not considered (thanks to Matthew K. Junker)

Version 2.19

   * strings can spawn more than one line and contain escaped "
   * usage string can be specified (instead of being generated automatically).
   * description string can be specified that will be printed after the
     usage string.
   * automatically created usage strings are wrapped.
   * with --long-help the optional options are correctly printed between []
   * --show-required, to explicitly print in the help output whether an
     option is mandatory
   * configuration files can include other configuration files
     (thanks to David Bird)
   * --no-handle-help handles also --full-help (thanks to Gyozo Papp)

Version 2.18

   * default values for enumerated options with optional arguments are
     correctly handled.
   * sections are printed in the help output before group specifications
   * can insert text in the output of --help
   * can specify gengetopt command line options in the input file itself
     with "args" specification
   * fixed bug in parsing of multiple option dimensions
   * fixed bug in generation of long help string

Version 2.17

   * fixed bug in generating parser where no multiple option is of
     type string (reported by Dave Swegen)
   * fixed bug: the passed header file extension is used when including the
     header file name in the generated C source
   * range of occurrences for multiple options
   * help and usage strings are generated and accessible (the same that are
     printed by --help)
   * reduced size for multiple option parsers
   * fixed a problem with the internal variable optind with non glibc
     version of getopt. (thanks to Gyozo Papp)
   * --output-dir command line option (suggested by Gyozo Papp)
   * --string-parser generate a parser that interprets a passed string
     as command line arguments (suggested by Andre Noll)

Version 2.16

   * a --full-help option is generated that shows also hidden options
     (in case there are some, as suggested by Paul Biggar)
   * multiple parsers can be linked into the same executable (even
     when using configuration files, thanks to Andre Noll)
   * when invoking getopt_long, discard any pointers to previously
     scanned command lines (thanks to Andre Noll)
   * fixed a bug in generation of help strings that might cause
     a seg fault (reported by Paul Biggar)

Version 2.15

   * option parts can be specified in any order
   * options can be hidden (not shown in the --help output)
   * an option can depend on another option
   * when converting a numeric string check for the result
   * when enumerated options are used, the value stored in the _arg field
     is an actual value specified in the list, and not the one specified
     at the command line (which can be abbreviated)

Version 2.14

   * required group options are not checked when the flag
     "check_required" is not specified.
   * generate a function to save the command line options into a file.
   * use dynamic memory for dealing with a configuration file.
   * -h,--help and -V,--version can be overridden
   * fixed another memory leak when invoking with --help and
     --version
   * fixed infinite loops with texts ending with newlines.
   * list of acceptable values variable have names that are
     prefixed with the parser name

Version 2.13

   * texinfo documentation
   * fixed some warnings (thanks to Gyozo Papp)
   * fixed other problems with option manipulation in config files
     (thanks to Gyozo Papp)
   * list of acceptable values for options
   * function to explicitly check whether a required option has
     been provided
   * group options can be multiple, and can have an
     optional argument
   * further memory leaks in the generated code have been removed
     (thanks to Michael Hagemann)
   * section definition can be multiline too
     (thanks to Gyozo Papp)

Version 2.12.2

   * removed segfaults in multiple option handling (thanks to Gyozo Papp)
   * sections can be associated a more detailed description that
     will be printed in the --help (suggested by Gyozo Papp)
   * options and arguments in config files can be separated by '='
     (with help from Gyozo Papp)
   * wrapping is applied to all description strings (with help from Gyozo Papp)
   * better check for "strings" well-formedness in configuration files
     (with help from Gyozo Papp)

Version 2.12.1

   * the generated source include config.h before any other header:
     otherwise some problems may come up in some circumstances
     (reported by Heinz Salzmann)
   * options can have optional arguments (as suggested by
     Guillaume Chazarain)
   * a _free function is generated for deallocating dynamic memory
     allocated for the option arguments by the parser
     and memory leaks in the generated files are removed
     (thanks to Michael Hagemann)
   * an _init function is generated that is called instead of clear_args
     and a initialize parameter has to be passed to the config file parser
     stating whether the args_info struct has to be initialized
     (Richard Zidlicky reported problems if the config file parser is
     called before the standard command line parser)
   * a second parser function is generated that allows to specify the
     override and initialize parameters that should be used together with
     the config file parser.  You can also specify whether the
     check for required option must be performed.
   * --arg-struct-name option for specifying the name of the generated
     struct for args info (suggested by Richard Zidlicky)
   * --unamed-opts can be given an optional argument
     describing the additional arguments without names, default is still
     FILES (as suggested by Simon Josefsson)
   * the config file parser generator was re-written in order to handle
     multiple options and other standard command line options
   * multiple options are allowed not to have arguments
     (suggested by Simon Josefsson)
   * multiple option arguments can be given separated by commas
     (thanks to Gyozo Papp)
   * default values can contain % without generating compiler errors
     in the generated code (thanks to Franck Lombardi)
   * Added --c-extension and --header-extension for specifying the
     extensions of generated files.

Version 2.11

   * fixed a small bug in the generated config file parser
     (reported by Karsten Reincke)
   * default values work for multiple options
     (reported by Christian Richter)
   * multiple options can be specified also without a short form
   * output of --help is wrapped (thanks to Michael Hagemann)
   * "typestr" allows to specify what a type of an option represents
     (e.g., FILENAME instead of STRING) (thanks to Michael Hagemann)
   * added sections for options

Version 2.10

   * correctly refer to the provided strdup if it is not in the
     standard library (thanks to Bert Deknuydt)
   * handle spaces in group names (reported by Matthew K. Junker)
   * package and version defined in a .ggo file have the precedence
     over PACKAGE and VERSION (reported by Kat Manton)
   * handle missing long long feature
   * correctly cast results of malloc in generated code
   * in the generated parser the generated version of strdup is
     always used (to improve portability)
   * generated conf file parser handles quoted strings
     (reported by Karsten Reincke)
   * fixed many compilation/portability problems in several
     architectures (thanks to Nelson H. F. Beebe)


-------------------------------------------------------
Copying information:

This file is licensed to you under the license specified in the included file
`LICENSE'. Look there for further details.

// vim: set ft= noet ts=8 sts=8 sw=8 tw=80 nojs spell :
