]> git.saurik.com Git - wxWidgets.git/blobdiff - debian/wx-config.1
Generate the interface file for STC from gen_iface too.
[wxWidgets.git] / debian / wx-config.1
index 72aeac5390f796a7edb42ee568e95ceff70ea0c2..b14e941f06fedebc8a4463504a522a21a4b73d39 100644 (file)
-.TH wx-config 1 "15 Feb 2000" "Debian GNU/Linux" "wxWindows 2.2"
+.TH wx\-config 1 "29 Sep 2004" "Debian GNU/Linux" "wxWidgets"
+
 .SH NAME
 .SH NAME
-wx-config - generate compile time info for wxWindows
+wx-config \- wxWidgets configuration search and query tool
+
 .SH SYNOPSIS
 .nh
 .SH SYNOPSIS
 .nh
-.B wxbase-config
-.br
-.B wxgtk-config
 .HP
 .HP
-.B wx-config
-[\-\-version] [\-\-libs] [\-\-cflags] [\-\-cc] [\-\-cxx] [\-\-ld]
-[\-\-prefix\fI[=DIR]\fP] [\-\-exec\-prefix\fI[=DIR]\fP]
+.B wx\-config [ OPTIONS ... ] [ LIB ... ]
+
 .SH DESCRIPTION
 .SH DESCRIPTION
-\fIwx-config\fP is a tool to determine the compiler and linker
-flags required for applications using the \fIwxWindows\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
 .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
 .hy
+
 .SH OPTIONS
 .l
 .SH OPTIONS
 .l
-\fIwx-config\fP accepts the following options:
-.TP 8
-.B  \-\-version
-What to
-.B ALWAYS
-include in a bug report.
-.br
-( But of course you already knew that ... )
-.TP 8
+\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[=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  \-\-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
 .B  \-\-libs
-Generate linker flags for a \fIwxWindows\fP program.
-.TP 8
+Output link flags required for a \fIwxWidgets\fP application.
+.TP 15
+.B  \-\-cppflags
+Output parameters required by the C preprocessor.
+.TP 15
 .B  \-\-cflags
 .B  \-\-cflags
-Generate compiler flags for the same.
-.TP 8
+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.
 .B  \-\-cc
 Output the name of the C compiler \fB$(CC)\fP.
-.TP 8
+.TP 15
 .B  \-\-cxx
 Output the name of the C++ compiler \fB$(CXX)\fP.
 .B  \-\-cxx
 Output the name of the C++ compiler \fB$(CXX)\fP.
-.TP 8
+.TP 15
 .B  \-\-ld
 .B  \-\-ld
-Output the Linker command \fB$(LD)\fP.
-.TP 8
-.B  \-\-prefix=PREFIX
-If specified, use PREFIX instead of the installation prefix that \fIwxWindows\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 \fIwxWindows\fP headers -- [Ron])
-.hy
-.TP 8
-.B  \-\-exec\-prefix=PREFIX
-If specified, use PREFIX instead of the installation exec prefix that
-\fIwxWindows\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 \fIwxWindows\fP library -- [Ron])
-.hy
-.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 then 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.