summaryrefslogtreecommitdiffstats
path: root/doc/man/kcharselect/kcharselect.1
blob: cc54866fa9fd6eb235bf16e994ed71d3f35ad214 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
.lf 1 info/tdeutils.kcharselect.1
.TH KCHARSELECT 1 "May 2003" TDE "TDE Application"
.SH NAME
kcharselect \- TDE Character Selector
.SH SYNOPSIS
.B kcharselect
[\fIQt-options\fR] [\fITDE-options\fR]
.SH DESCRIPTION
This manual page documents briefly the
.B KCharSelect
TDE Application.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
.PP
Using
.B KCharSelect
one can view all the glyphs, organized by character table, available from any
installed font.  One can also assemble a string of characters by clicking on
characters in the table.  The string can be exported to the clipboard for
later use.
.PP
.B KCharSelect
is helpful for determining which characters in a font have glyphs as well as
for selecting characters that may be difficult to produce.
.P
This program is part of the official TDE utils module.
.SH OPTIONS
.SS "General Options"
.B \-\-help
Show help about options
.TP
.B \-\-help\-qt
Show Qt specific options
.TP
.B \-\-help\-tde
Show TDE specific options
.TP
.B \-\-help\-all
Show all options
.TP
.B \-\-author
Show author information
.TP
.B \-v\fR, \fB\-\-version
Show version information
.TP
.B \-\-license
Show license information
.TP
.B \-\-
End of options
.lf 1 info/kdeqtoptions
.SS "TDE options"
.TP 12
.BI \-\-caption \ caption
Use \fIcaption\fP as name in the titlebar.
.TP
.BI \-\-icon \ icon
Use \fIicon\fP as the application icon. \fIicon\fP is the name of the
icon, which can either be an absolute filename path, or otherwise the
icon is sought for in places according to the normal TDE rules.
.TP
.BI \-\-miniicon \ icon
Use \fIicon\fP as the icon in the titlebar. \fIicon\fP is the filename
of the icon, according to the same rules as for the \-\-icon parameter.
.TP
.BI \-\-config \ filename
Use an alternative configuration file, instead of the default, which
is normally located in
.I /usr/share/config
or in
.RB $ TDEHOME\fI/share/config
.TP
.BI \-\-dcopserver \ server
Set the address of the DCOP server to attach to.
.TP
.B \-\-nocrashhandler
Disable crash handler, to get core dumps. This option has the same
effect as definiting the environment variable TDE_DEBUG.
.TP
.B \-\-waitforwm
Waits for a WM_NET compatible windowmanager.
.TP
.BI \-\-style \ style
sets the application GUI style.
.TP
.BI \-\-geometry \ geometry
sets the client geometry of the main widget.
The geometry parameter follows the normal X convention for geometry,
which is on the form:
.RS
.IP
[\fIwidth\fBx\fIheight\fR][{\fB+-\fR}\fIxpos\fR{\fB+-\fR}\fIypos\fR]
.P
Where \fIwidth\fR and \fIheight\fR gives the desired minimum width and
height, of the main application window. Both in pixels. A value of 0
specifies the default size. The optional \fIxpos\fR and \fIypos\fR
specifies the x,y-position that which is desired for the application
window. Specifying negative values for x or y implies that the x or y
position is to be measured from the left or bottom screen edge,
instead of as in the normal case, with positive values, from the left
and top edges. 
.RE
.SS "Qt options"
.TP 12
.BI \-\-display \ displayname
Use the X-server display \fIdisplayname\fP.
.TP
.BI \-\-session \ sessionId
Restore the application for the given \fIsessionId\fP.
.TP
.B \-\-cmap
Causes the application to install a private color
map on an 8-bit display.
.TP
.BI \-\-ncols \ count
Limits the number of colors allocated in the color
cube on an 8-bit display, if the application is
using the QApplication::ManyColor color
specification.
.TP
.B \-\-nograb
Tells Qt to never grab the mouse or the keyboard.
.TP
.B \-\-dograb
Running under a debugger can cause an implicit
.B \-nograb, use \fB\-dograb\fR to override.
.TP
.B \-\-sync
switches to synchronous mode for debugging.
.TP
.BI "\-\-fn\fR, \fP\-\-font" \ fontname
Defines the default application font. The \fIfontname\fP should be in
the X logical font name description format XLFD. For a full description of
the format see
.I /usr/X11R6/lib/X11/doc/xlfd.TXT
Note that the application might override the font specified with
its own font.
.TP
.BI "-\-bg\fR, \fB\-\-background"  \ color
Sets the default background color and an
application palette (light and dark shades are
calculated).
.TP
.BI "\-\-fg\fR, \fB\-\-foreground"  \ color
Sets the default foreground color.
.TP
.BI \-\-btn\fR, \fB\-\-button \ color
Sets the default button color.
.TP
.BI \-\-name \ name
Sets the application name.
.TP
.BI \-\-title \ title
Sets the application title. This option might, or might not appear
in the title bar caption, depending on the application. To change the caption, use the 
.B \-\-caption
option instead. 
.TP
.B \-\-visual TrueColor
Forces the application to use a TrueColor visual on
an 8-bit display.
.TP
.BI \-\-inputstyle \ inputstyle
Sets XIM (X Input Method) input style. Possible
values are 
.BR onthespot ", " overthespot ", " offthespot and root .
.TP
.BI \-\-im " XIM-server"
Set XIM server.
.TP
.B \-\-noxim
Disable XIM.
.TP
.B \-\-reverse
Mirror reverses the whole layout of widgets. This means that menus
will go in the opposite direction, the scroll bar will be on the
opposite side, etc. For a normal western layout that means that menus
and tool bars will go from the right edge to the left, the vertical
scroll bar will be on the left side and so on.

.lf 48 info/tdeutils.kcharselect.1
.SH ENVIRONMENT
.lf 1 info/kdeenviron
.SS "standard TDE environment variables"
.IP TDE_LANG
Language locale setting to use. This option makes it possible to set
another language environment for a program than what is the default. The
correct language pack for this language has to be installed for this option
to work. The default language when there is none set is en_US. When
deciding upon a language, the following resources are looked up, in
order: TDE_LANG, configuration file, LC_CTYPE, LC_MESSAGES, LC_ALL,
LANG.
.IP TDE_UTF8_FILENAMES
Assume that all filenames are in UTF-8 format regardless of the
current language setting. Otherwise the filename format is defined by
the language.
.IP TDE_MULTIHEAD
If this variable has the value
.B true
multihead multiple display mode is enabled. The TDE display will be
shared over more than one screen.
.IP DISPLAY
Specifies the X display to run TDE on.
.IP TDESYCOCA
Specifies and alternative path for the 
.I tdesycoca
TDE system configuration cache file.
The default path is
/tmp/tde-$USER/tdesycoca
.IP DCOPSERVER
Specifies an alternative path for the DCOP server file. The default
file is
$HOME/.DCOPserver_\fIhostname\fP_\fIdisplayname\fP
.IP SESSION_MANAGER
The session manager to use. This option is set automatically by TDE
and is a network path to the session manager socket.
.IP HOME
Path to the home directory for the current user. 
.IP TDEHOME
The TDE per-user setting directory. Default if not specified is
.I $HOME/.trinity
.lf 50 info/tdeutils.kcharselect.1
.SH FILES
.TP
.I $HOME/.trinity/share/config/kcharselectrc
configuration file.
.SH AUTHOR
KCharSelect was written by
.nh
.ad l
Reginald Stadlbauer <reggie@kde.org>.
.hy
.br
Please use http://bugs.trinitydesktop.org to report bugs, do not mail the authors directly.
.br
This manual page was prepared by
.nh
.ad l
Karolina Lindqvist <pgd\-karolinali@algonet.se>
.hy
for the Debian GNU/Linux system (but may be used by others).
.SH "SEE ALSO"
The full documentation for
.B KCharSelect
is maintained as a docbook manual.  If the
.B khelpcenter
program is properly installed at your site, the command
.IP
.B khelpcenter help:/kcharselect
.PP
should give you access to the complete manual.
.P
Alternatively the manual can be browsed in
.B konqueror
giving it the URL help:/kcharselect