-.TH wx\-config 1 "15 Feb 2000" "Debian GNU/Linux" "wxWidgets"
+.TH wx\-config 1 "29 Sep 2004" "Debian GNU/Linux" "wxWidgets"
+
.SH NAME
-wx-config \- generate compile time requirements for wxWidgets applications
+wx-config \- wxWidgets configuration search and query tool
+
.SH SYNOPSIS
.nh
-.B wxbase\-config
-.br
-.B wxgtk\-config
.HP
-.B wx\-config
-[\-\-version] [\-\-libs\fI[=LIBS]\fP] [\-\-cflags] [\-\-cc] [\-\-cxx] [\-\-ld]
-[\-\-prefix\fI[=DIR]\fP] [\-\-exec\-prefix\fI[=DIR]\fP] [\-\-release] [\-\-basename]
+.B wx\-config [ OPTIONS ... ] [ LIB ... ]
+
.SH DESCRIPTION
-\fIwx\-config\fP is a tool to determine the compiler and linker
-flags required for applications using the \fIwxWidgets\fP toolkit(s).
+.I 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.
.PP
-\fIwx\-config\fP is normally a symlink to one of the port\-specific
-versions like \fIwxbase\-config\fP or \fIwxgtk\-config\fP which
-designates the default port to compile applications with.
-You can override this default either by using one of the specific
-versions directly, or by changing which version the symlink points to.
-On Debian systems this can be done using the
-.BR update\-alternatives (8)
-mechanism.
+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
+.I wx\-config \-\-list
+and select from them by using the feature options described below.
+.PP
+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
+.B std
+may be used to import all libraries that would be used by default if none
+were specified explicitly.
+.br
+eg.
+.I wx-config --libs std,gizmos
.hy
+
.SH OPTIONS
.l
-\fIwx\-config\fP accepts the following options:
+\fIwx\-config\fP accepts the following options with no restrictions on
+their order as was required in previous releases:
+
+.SS Installed root
+These options change or query the filesystem root for the operations
+listed below.
+
+.TP 15
+.B \-\-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.
+.TP 15
+.B \-\-exec\-prefix[=EXEC-PREFIX]
+Similar to \-\-prefix, but acts on the exec-prefix. If not specified
+will default to the value of prefix.
+
+.SS Query options
+These options return information about the wxWidgets default version
+and and installed alternatives.
+.TP 15
+.B \-\-list
+List all configs in prefix and show those that match any additional
+feature options given.
+.TP 15
+.B \-\-release
+Output the wxWidgets release number.
+.TP 15
+.B \-\-version\-full
+Output the wxWidgets version number in all its glory.
+.TP 15
+.B \-\-basename
+Output the base name of the wxWidgets libraries.
+.TP 15
+.B \-\-selected-config
+Output the signature of the selected wxWidgets library.
+This is a string of the form "port-unicode-release-version".
+
+
+.SS Feature options
+These options select features which determine which wxWidgets
+configuration to use.
+
+.TP 15
+.B \-\-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.
+.TP 15
+.B \-\-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.
.TP 15
-.B \-\-version
-What to
-.B ALWAYS
-include in a bug report.
+.B \-\-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.
.TP 15
-.B \-\-libs[=LIBS]
-Generate linker flags for a \fIwxWidgets\fP program.
-The optional argument is a comma separated list of the wxWidgets libraries
-to link with. You may include contrib libs here too. If no argument is
-given it will assume you wish to link all 'core' libraries.
+.B \-\-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.
+.TP 15
+.B \-\-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 common failure idioms. You are encouraged to use
+them during active development of applications. They are not binary
+compatible with the release libraries.
+.TP 15
+.B \-\-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 supplied
+in the wxGTK packages any more.
+
+.SS Compiler options
+These options generate output required to build an application using
+a particular wxWidgets configuration.
+
+.TP 15
+.B \-\-libs
+Output link flags required for a \fIwxWidgets\fP application.
+.TP 15
+.B \-\-cppflags
+Output parameters required by the C preprocessor.
.TP 15
.B \-\-cflags
-Generate compiler flags for the same.
+Output parameters required by the C compiler.
+.TP 15
+.B \-\-cxxflags
+Output parameters required by the C++ compiler.
.TP 15
.B \-\-cc
Output the name of the C compiler \fB$(CC)\fP.
Output the name of the C++ compiler \fB$(CXX)\fP.
.TP 15
.B \-\-ld
-Output the Linker command \fB$(LD)\fP.
-.TP 15
-.B \-\-prefix=PREFIX
-If specified, use PREFIX instead of the installation prefix that \fIwxWidgets\fP
-was built with when computing the output for the \-\-cflags and
-\-\-libs options. This option is also used for the exec prefix
-if \-\-exec\-prefix was not specified. This option must be specified
-before any \-\-libs or \-\-cflags options.
-.br
-.nh
-.HP
-(Translation: this is the root path to the \fIwxWidgets\fP headers \-\- [Ron])
-.hy
-.TP 15
-.B \-\-exec\-prefix=PREFIX
-If specified, use PREFIX instead of the installation exec prefix that
-\fIwxWidgets\fP was built with when computing the output for the \-\-cflags
-and \-\-libs options. This option must be specified before any
-\-\-libs or \-\-cflags options.
-.br
-.nh
-.HP
-(Translation: this is the root path to the \fIwxWidgets\fP library \-\- [Ron])
-.hy
-.TP 15
-.B \-\-release
-Output the wxWidgets release number.
-.TP 15
-.B \-\-basename
-Output the base name of the wxWidgets libraries.
-.SH SEE ALSO
-.BR gtk\-config (1),
-.BR update\-alternatives (8)
-.SH COPYRIGHT
-This manpage was copied whole\-heartedly from the \fBgtk\-config\fP(1) manpage
-by Brian Bassett <brianb@debian.org> for the Debian GNU/Linux distribution of
-wxGTK. It was subsequently updated to include new options and otherwise
-bastardised generally by Ron Lee <ron@debian.org>
-
-The original gtk\-config manpage copyright:
+Output the linker command.
-Copyright \(co 1995 Spencer Kimball and Peter Mattis
+.SH COPYRIGHT
+This manpage was written by Ron Lee <ron@debian.org> for the Debian GNU/Linux
+distribution of wxWindows. It may be freely distributed by anyone who finds
+it useful.
-Permission to use, copy, modify, and distribute this software and its
-documentation for any purpose and without fee is hereby granted,
-provided that the above copyright notice appear in all copies and that
-both that copyright notice and this permission notice appear in
-supporting documentation.
projects / wxWidgets.git / blobdiff