Short:    v1.2. GNU getopt() <-> WBench interface
Author:   <jensthi@ifi.uio.no> (Jens T. Berger Thielemann)
Uploader: <jensthi@ifi.uio.no> (Jens T. Berger Thielemann)
Version:  1.2
Type:     dev/c,dev/cross
Replaces: WB2Argv.lha
Requires: Amiga, C compiler, C= includes, OS 2.04+

                             Introduction
                             ~~~~~~~~~~~~
    As  C/C++  is  currently  the only compilable languages worth doing
cross-development  in, I decided to push portability a bit further.  As
many  other  platforms haven't noticed, the computer has a mouse, which
can be utilized for passing options to programs, amongs others.

    Still,  as the Workbench is very OS specific; the GNU getopt_long()
routines  are still the programmer's choice if he wishes to easily port
his program.

    WB2Argv  is  a  set  of  routines  which  solve this problem.  They
convert  the  tooltypes  and  shift-clicked  icons into an argv similar
array,  which  can be passed directly onto getopt_long().  The getopt()
and  getopt_long() routines are included in the archive.  A minor quirk
is  that  they  require that the Amiga has OS 2.04 or higher.  This may
change if there is enough interest for these routines.

    New  for  v1.2  is  that  the routine now uses approx.  1/10 of the
memory  needed  previously.   Cost:  Uses some more stack, but this can
usually be ignored.


                                Example
                                ~~~~~~~
    An  example:   Suppose your program is called "dh1:Tools/Foo".  The
user  shift-clicks  the files "dh1:Data" and "dh1:Neural", and puts the
following arguments as tooltypes:

SPEED=FAST
IQ=HIGH
  UNIVERSE=UTOPIA
(FOO=BAR)

    The  routine  WB2Argv()  will take the WBenchMsg which is passed to
you,  and  convert  it  to  the following array (line shifts indicating
separate array elements):

dh1:Tools/Foo
--speed=FAST
--iq=HIGH
--universe=UTOPIA
--
dh1:Data
dh1:Neural

    This  is  fully compliant to the getopt_long() format.  The folding
of  options case can be specified via flags (it stops at the `=' sign).
As  you  see,  the  routine  ignores  options enclosed with parenthesis
around, and skips leading blanks in tooltypes.


                                   Usage
                                   ~~~~~
    Very  simple.   Put  the  following  chunk  at  the  top of your main()
procedure:

--- Cut here ---

#include "WB2Argv.h"

int main(int argc, char **argv)
{
    int c;

#ifdef AMIGA
    if(_WBenchMsg)
    {
        if(argv = WB2Argv(_WBenchMsg, W2A_LOWER))
            argc = CountArgv(argv);
        else
            exit(20);
    }
#endif

    /* Your own code */
}

--- Cut here ---

    As  with  WB2Argv,  the  routines  will only be used and defined if you
define AMIGA somewher.

    As  getopt_long(), this is distributed under the GNU General Public
License,  with  the  following  addition:   You  must mention that your
program uses my routine in your document.

    Copyright © 1996 Jens T.  Berger Thielemann.

    To contact the author for suggestions or whatever, write to:
        Jens Berger
        Spektrumvn. 4
        N-0666 Oslo
        Norway

        Email: <jensthi@ifi.uio.no>

Note: These routines were written for one of my other projects, ChkTeX,
      which  may  be  useful  if you're doing serious typesetting using
      LaTeX.  Available on AmiNet as text/tex/chktex.lha.