pacman/scripts/library
Dave Reisner 00ab01e634 scripts/library: remove parse_options
This is retired, as the two consumers of this function are now using the
new parseopts instead.

Signed-off-by: Dave Reisner <dreisner@archlinux.org>
2012-04-24 08:38:36 -05:00
..
README scripts/library: remove parse_options 2012-04-24 08:38:36 -05:00
output_format.sh scripts: refactor output formatting functions 2011-06-15 09:18:05 -05:00
parseopts.sh scripts/library: introduce parseopts 2012-04-24 08:38:36 -05:00

README

This folder contains code snippets that can be reused by multiple
scripts.  A brief description of each file follows.

output_format.sh:
Provides basic output formatting functions with levels 'msg', 'msg2',
'warning' and 'error'.  The 'msg' amd 'msg2' functions print to stdout
and can be silenced by defining 'QUIET'.  The 'warning' and 'error'
functions print to stderr with the appropriate prefix added to the
message.

parseopts.sh:
A getopt_long-like parser which portably supports longopts and shortopts
with some GNU extensions. It does not allow for options with optional
arguments. For both short and long opts, options requiring an argument
should be suffixed with a colon. After the first argument containing
the short opts, any number of valid long opts may be be passed. The end
of the options delimiter must then be added, followed by the user arguments
to the calling program.

Reccommended Usage:
  OPT_SHORT='fb:z'
  OPT_LONG=('foo' 'bar:' 'baz')
  if ! parseopts "$OPT_SHORT" "${OPT_LONG[@]}" -- "$@"; then
    exit 1
  fi
  set -- "${OPTRET[@]}"
Returns:
  0: parse success
  1: parse failure (error message supplied)