~ubuntu-branches/ubuntu/raring/wxwidgets2.8/raring

« back to all changes in this revision

Viewing changes to debian/manpages/wx-config.1

  • Committer: Bazaar Package Importer
  • Author(s): Devid Antonio Filoni
  • Date: 2010-07-20 01:55:41 UTC
  • Revision ID: james.westby@ubuntu.com-20100720015541-f4j0v8g28tdvp9xj
Tags: 2.8.11.0-0ubuntu2
* Merge *some* changes from Debian package (version 2.8.10.1-3). This should
  make merges easier. Also fixes LP: #559822. Also merged several patches.
* Remove debian/patches/editra_pixmaps.dpatch patch, we don't ship editra
  anymore.
* Remove files which broke update-alternatives (LP: #379573).
* Switch to format 3.0 (quilt).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH wx\-config 1 "29 Sep 2004" "Debian GNU/Linux" "wxWidgets"
2
 
 
3
 
.SH NAME
4
 
wx-config \- wxWidgets configuration search and query tool
5
 
 
6
 
.SH SYNOPSIS
7
 
.nh
8
 
.HP
9
 
.B wx\-config [ OPTIONS ... ] [ LIB ... ]
10
 
 
11
 
.SH DESCRIPTION
12
 
.I wx\-config
13
 
returns information about the wxWidgets libraries available on your system.
14
 
It may be used to retrieve the information you require to build applications
15
 
using these libraries.
16
 
.PP
17
 
Changing the library options you wish to use for an application previously
18
 
involved managing alternative configurations by a system dependent means.
19
 
It is now possible to select from any of the configurations installed
20
 
on your system via this single tool.  You can view all available
21
 
configurations installed in the system default prefix with the command
22
 
.I wx\-config \-\-list
23
 
and select from them by using the feature options described below.
24
 
.PP
25
 
Optional LIB arguments (comma or space separated) may be used to specify
26
 
individually the wxWidgets component libraries that you wish to use,
27
 
or to specify additional components not ususally included by default.
28
 
The magic token
29
 
.B std
30
 
may be used to import all libraries that would be used by default if none
31
 
were specified explicitly.
32
 
.br
33
 
eg.
34
 
.I wx-config --libs std,gizmos
35
 
.hy
36
 
 
37
 
.SH OPTIONS
38
 
\fIwx\-config\fP accepts the following options with no restrictions on
39
 
their order as was required in previous releases:
40
 
 
41
 
.SS Installed root
42
 
These options change or query the filesystem root for the operations
43
 
listed below.
44
 
 
45
 
.TP 15
46
 
.B  \-\-prefix[=PREFIX]
47
 
Without the optional argument, the current default prefix will be
48
 
output.  If the argument is supplied, PREFIX will be searched for
49
 
matching configs in place of the default.  You may use both forms
50
 
in the same command.
51
 
.TP 15
52
 
.B  \-\-exec\-prefix[=EXEC-PREFIX]
53
 
Similar to \-\-prefix, but acts on the exec-prefix.  If not specified
54
 
will default to the value of prefix.
55
 
 
56
 
.SS Query options
57
 
These options return information about the wxWidgets default version
58
 
and and installed alternatives.
59
 
.TP 15
60
 
.B  \-\-list
61
 
List all configs in prefix and show those that match any additional
62
 
feature options given.
63
 
.TP 15
64
 
.B  \-\-release
65
 
Output the wxWidgets release number.
66
 
.TP 15
67
 
.B  \-\-version\-full
68
 
Output the wxWidgets version number in all its glory.
69
 
.TP 15
70
 
.B  \-\-basename
71
 
Output the base name of the wxWidgets libraries.
72
 
.TP 15
73
 
.B  \-\-selected-config
74
 
Output the signature of the selected wxWidgets library.
75
 
This is a string of the form "port-unicode-release-version".
76
 
 
77
 
 
78
 
.SS Feature options
79
 
These options select features which determine which wxWidgets
80
 
configuration to use.
81
 
 
82
 
.TP 15
83
 
.B  \-\-host=HOST
84
 
Specify a (posix extended) regex of host aliases to match for cross
85
 
compiled configurations.  eg. \-\-host=i586-mingw32msvc, \-\-host=.*
86
 
If unspecified, the default is to match only configurations native to
87
 
the build machine.
88
 
.TP 15
89
 
.B  \-\-toolkit=TOOLKIT
90
 
Specify a (posix extended) regex of the toolkits to match.
91
 
The toolkit is responsible for look and feel of the compiled
92
 
application.  eg. gtk, gtk2, motif, msw.
93
 
If unspecified the default is to prefer the system default toolkit,
94
 
but to match any toolkit in the absence of a stricter specification.
95
 
.TP 15
96
 
.B  \-\-version[=VERSION]
97
 
Without the optional argument, return the wxWidgets version.  If the
98
 
argument is supplied it specifies a (posix extended) regex of the
99
 
versions to match.  If unspecified the default is to prefer the system
100
 
default version, but to match any version in the absence of a stricter
101
 
specification.
102
 
.TP 15
103
 
.B  \-\-unicode[=yes|no]]
104
 
Specify the default character type for the application.
105
 
If unspecified, the system default will be preferred, but any type may
106
 
match in the absence of a stricter specification.
107
 
.TP 15
108
 
.B  \-\-debug[=yes|no]]
109
 
Specify whether to create a debug or release build for the application.
110
 
If unspecified, the system default (release) will be preferred, but any
111
 
type may match in the absence of a stricter specification.
112
 
Debug builds should never be uploaded to Debian, but are very useful
113
 
for finding certain common failure idioms.  You are encouraged to use
114
 
them during active development of applications.  They are not binary
115
 
compatible with the release libraries.
116
 
.TP 15
117
 
.B  \-\-static[=yes|no]]
118
 
Specify whether to statically or dynamically link wxWidgets libraries
119
 
into your application.  If unspecified, the system default (dynamic)
120
 
will be preferred, but any type may match in the absence of a stricter
121
 
specification.  Static linking is mainly useful still for cross ports
122
 
not natively supported by Debian, and can be hazardous in conjunction
123
 
with the gtk toolkits.  Note that static libraries are no longer supplied
124
 
in the wxGTK packages any more.
125
 
 
126
 
.SS Compiler options
127
 
These options generate output required to build an application using
128
 
a particular wxWidgets configuration.
129
 
 
130
 
.TP 15
131
 
.B  \-\-libs
132
 
Output link flags required for a \fIwxWidgets\fP application.
133
 
.TP 15
134
 
.B  \-\-cppflags
135
 
Output parameters required by the C preprocessor.
136
 
.TP 15
137
 
.B  \-\-cflags
138
 
Output parameters required by the C compiler.
139
 
.TP 15
140
 
.B  \-\-cxxflags
141
 
Output parameters required by the C++ compiler.
142
 
.TP 15
143
 
.B  \-\-cc
144
 
Output the name of the C compiler \fB$(CC)\fP.
145
 
.TP 15
146
 
.B  \-\-cxx
147
 
Output the name of the C++ compiler \fB$(CXX)\fP.
148
 
.TP 15
149
 
.B  \-\-ld
150
 
Output the linker command.
151
 
 
152
 
.SH COPYRIGHT
153
 
This manpage was written by Ron Lee <ron@debian.org> for the Debian GNU/Linux
154
 
distribution of wxWindows.  It may be freely distributed by anyone who finds
155
 
it useful.
156