libtool: Wrapper executables

1 
1 3.3.1 Wrapper executables for uninstalled programs
1 --------------------------------------------------
1 
1 Some platforms, notably those hosted on Windows such as Cygwin and
1 MinGW, use a wrapper executable rather than a wrapper script to ensure
1 proper operation of uninstalled programs linked by libtool against
1 uninstalled shared libraries.  The wrapper executable thus performs the
1 same function as the wrapper script used on other platforms, but allows
1 to satisfy the 'make' rules for the program, whose name ends in
1 '$(EXEEXT)'.  The actual program executable is created below .libs, and
1 its name will end in '$(EXEEXT)' and may or may not contain an 'lt-'
1 prefix.  This wrapper executable sets various environment values so that
1 the program executable may locate its (uninstalled) shared libraries,
1 and then launches the program executable.
1 
1    The wrapper executable provides a debug mode, enabled by passing the
1 command-line option '--lt-debug' (see below).  When executing in debug
1 mode, diagnostic information will be printed to 'stderr' before the
1 program executable is launched.
1 
1    Finally, the wrapper executable supports a number of command line
1 options that may be useful when debugging the operation of the wrapper
1 system.  All of these options begin with '--lt-', and if present they
1 and their arguments will be removed from the argument list passed on to
1 the program executable.  Therefore, the program executable may not
1 employ command line options that begin with '--lt-'.  (In fact, the
1 wrapper executable will detect any command line options that begin with
1 '--lt-' and abort with an error message if the option is not
1 recognized).  If this presents a problem, please contact the Libtool
1 team at the Libtool bug reporting address <bug-libtool@gnu.org>.
1 
1    These command line options include:
1 
1 '--lt-dump-script'
1      Causes the wrapper to print a copy of the wrapper _script_ to
1      'stdout', and exit.
1 
1 '--lt-debug'
1      Causes the wrapper to print diagnostic information to 'stdout',
1      before launching the program executable.
1 
1    For consistency, both the wrapper _script_ and the wrapper
1 _executable_ support these options.
1