NAME

       wx-config - wxWidgets configuration search and query tool

SYNOPSIS

       wx-config [ OPTIONS ... ] [ LIB ... ]

DESCRIPTION

       wx-config  returns information about the wxWidgets libraries available on your system.  It
       may be used to retrieve the information you require  to  build  applications  using  these
       libraries.

       Changing  the  library  options  you  wish  to  use for an application previously involved
       managing alternative configurations by a system dependent means.  It is  now  possible  to
       select  from any of the configurations installed on your system via this single tool.  You
       can view all available configurations installed in the  system  default  prefix  with  the
       command  wx-config  --list  and  select  from  them by using the feature options described
       below.

       Optional LIB arguments (comma or space separated) may be used to specify individually  the
       wxWidgets  component  libraries  that you wish to use, or to specify additional components
       not usually included by default.  The magic token std may be used to import all  libraries
       that would be used by default if none were specified explicitly.
       eg.  wx-config --libs std,gizmos

OPTIONS

       wx-config  accepts  the  following  options  with  no  restrictions  on their order as was
       required in previous releases:

   Installed root
       These options change or query the filesystem root for the operations listed below.

       --prefix[=PREFIX]
                      Without the optional argument, the current default prefix will  be  output.
                      If  the  argument is supplied, PREFIX will be searched for matching configs
                      in place of the default.  You may use both forms in the same command.

       --exec-prefix[=EXEC-PREFIX]
                      Similar to --prefix, but acts on the exec-prefix.  If  not  specified  will
                      default to the value of prefix.

   Query options
       These  options  return  information  about  the  wxWidgets  default  version and installed
       alternatives.

       --list         List all configs in prefix and show those that match any additional feature
                      options given.

       --release      Output the wxWidgets release number.

       --version-full Output the wxWidgets version number in all its glory.

       --basename     Output the base name of the wxWidgets libraries.

       --selected-config
                      Output  the  signature of the selected wxWidgets library.  This is a string
                      of the form "port-unicode-version".

   Feature options
       These options select features which determine which wxWidgets configuration to use.

       --host=HOST    Specify a (POSIX extended)  regex  of  host  aliases  to  match  for  cross
                      compiled   configurations.    eg.  --host=i586-mingw32msvc,  --host=.*   If
                      unspecified, the default is to match  only  configurations  native  to  the
                      build machine.

       --toolkit=TOOLKIT
                      Specify  a (POSIX extended) regex of the toolkits to match.  The toolkit is
                      responsible for the look and feel of the compiled  application.   eg.  gtk,
                      gtk2,  motif,  msw.   If  unspecified  the  default is to prefer the system
                      default toolkit, but to match any toolkit in  the  absence  of  a  stricter
                      specification.

       --version[=VERSION]
                      Without  the  optional  argument,  return  the  wxWidgets  version.  If the
                      argument is supplied it specifies a (POSIX extended) regex of the  versions
                      to  match.   If  unspecified  the  default  is to prefer the system default
                      version,  but  to  match  any  version  in  the  absence  of   a   stricter
                      specification.

       --unicode[=yes|no]]
                      Specify  the  default  character type for the application.  If unspecified,
                      the system default will be preferred, but any type may match in the absence
                      of a stricter specification.

       --debug[=yes|no]]
                      Specify whether to create a debug or release build for the application.  If
                      unspecified, the system default (release) will be preferred, but  any  type
                      may match in the absence of a stricter specification.

                      Debug  versions are very useful for finding certain common ways of misusing
                      the wxWidgets API, and  you  are  encouraged  to  use  them  during  active
                      development  of  applications.  They are not binary compatible with release
                      versions, and packages built against wxWidgets debug builds should never be
                      uploaded to Debian.

       --static[=yes|no]]
                      Specify  whether to statically or dynamically link wxWidgets libraries into
                      your application.  If unspecified, the system  default  (dynamic)  will  be
                      preferred,   but   any  type  may  match  in  the  absence  of  a  stricter
                      specification.  Static linking is mainly useful still for cross  ports  not
                      natively  supported by Debian, and can be hazardous in conjunction with the
                      GTK toolkits.  Note that static libraries are no  longer  included  in  the
                      wxGTK packages.

   Compiler options
       These  options  generate  output  required  to  build  an  application  using a particular
       wxWidgets configuration.

       --libs         Output link flags required for a wxWidgets application.

       --cppflags     Output parameters required by the C preprocessor.

       --cflags       Output parameters required by the C compiler.

       --cxxflags     Output parameters required by the C++ compiler.

       --cc           Output the name of the C compiler $(CC).

       --cxx          Output the name of the C++ compiler $(CXX).

       --ld           Output the linker command.

COPYRIGHT

       This manpage was written by Ron Lee <ron@debian.org> for the Debian GNU/Linux distribution
       of wxWidgets.  It may be freely distributed by anyone who finds it useful.