wx-config - wxWidgets configuration search and query tool
wx-config [ OPTIONS ... ] [ LIB ... ]
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
wx-config accepts the following options with no
restrictions on their order as was required in previous releases:
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.
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".
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.
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.
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.