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-release-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.