wx-config(1) wxWidgets wx-config(1)
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 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
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 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 the look and feel
of the compiled application. eg. gtk, gtk2, motif, msw.
If unspecified the default is to prefer the system de-
fault toolkit, but to match any toolkit in the absence
of a stricter specification.
--version[=VERSION]
Without the optional argument, return the wxWidgets ver-
sion. If the argument is supplied it specifies a (POSIX
extended) regex of the versions to match. If unspeci-
fied the default is to prefer the system default ver-
sion, 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 com-
mon ways of misusing the wxWidgets API, and you are en-
couraged to use them during active development of appli-
cations. 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 wxWid-
gets libraries into your application. If unspecified,
the system default (dynamic) will be preferred, but any
type may match in the absence of a stricter specifica-
tion. Static linking is mainly useful still for cross
ports not natively supported by Debian, and can be haz-
ardous 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.
Debian GNU/Linux 29 Sep 2004 wx-config(1)
Generated by dwww version 1.15 on Sat Jun 29 02:07:09 CEST 2024.