wx-config(1) User Commands wx-config(1)NAMEwx-config - wxWidgets configuration search and query tool
SYNOPSISwx-config [ options... ] [ lib... ]
DESCRIPTIONwx-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 ususally 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
OPTIONSwx-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 pre-fix 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 addi‐
tional 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.
Feature Options
These options select features which determine which wxWidgets configu‐
ration 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 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 pre‐
fer 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 builds should never be
uploaded to Debian, but are very useful for finding certain com‐
mon failure idioms. You are encouraged to use them during
active development of applications. They are not binary compat‐
ible with the release libraries.
--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 tool‐
kits. Note that static libraries are no longer supplied in
the wxGTK packages any more.
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.
SEE ALSOwxrc(1)SunOS 5.10 5 Aug 2008 wx-config(1)