← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/X11/XmbRIC.man

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/doc/man/X11/XmbRIC.man
 
1
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
 
2
.\" Copyright \(co 2000  The XFree86 Project, Inc.
 
3
.\"
 
4
.\" Permission is hereby granted, free of charge, to any person obtaining
 
5
.\" a copy of this software and associated documentation files (the
 
6
.\" "Software"), to deal in the Software without restriction, including
 
7
.\" without limitation the rights to use, copy, modify, merge, publish,
 
8
.\" distribute, sublicense, and/or sell copies of the Software, and to
 
9
.\" permit persons to whom the Software is furnished to do so, subject to
 
10
.\" the following conditions:
 
11
.\"
 
12
.\" The above copyright notice and this permission notice shall be included
 
13
.\" in all copies or substantial portions of the Software.
 
14
.\"
 
15
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 
16
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 
17
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
18
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
 
19
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 
20
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 
21
.\" OTHER DEALINGS IN THE SOFTWARE.
 
22
.\"
 
23
.\" Except as contained in this notice, the name of the X Consortium shall
 
24
.\" not be used in advertising or otherwise to promote the sale, use or
 
25
.\" other dealings in this Software without prior written authorization
 
26
.\" from the X Consortium.
 
27
.\"
 
28
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
 
29
.\" Digital Equipment Corporation
 
30
.\"
 
31
.\" Portions Copyright \(co 1990, 1991 by
 
32
.\" Tektronix, Inc.
 
33
.\"
 
34
.\" Permission to use, copy, modify and distribute this documentation for
 
35
.\" any purpose and without fee is hereby granted, provided that the above
 
36
.\" copyright notice appears in all copies and that both that copyright notice
 
37
.\" and this permission notice appear in all copies, and that the names of
 
38
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
 
39
.\" to this documentation without specific, written prior permission.
 
40
.\" Digital and Tektronix makes no representations about the suitability
 
41
.\" of this documentation for any purpose.
 
42
.\" It is provided ``as is'' without express or implied warranty.
 
43
.\"
 
44
.\" $XFree86: xc/doc/man/X11/XmbRIC.man,v 1.3 2001/01/27 18:20:08 dawes Exp $
 
45
.\" 
 
46
.ds xT X Toolkit Intrinsics \- C Language Interface
 
47
.ds xW Athena X Widgets \- C Language X Toolkit Interface
 
48
.ds xL Xlib \- C Language X Interface
 
49
.ds xC Inter-Client Communication Conventions Manual
 
50
.na
 
51
.de Ds
 
52
.nf
 
53
.\\$1D \\$2 \\$1
 
54
.ft 1
 
55
.\".ps \\n(PS
 
56
.\".if \\n(VS>=40 .vs \\n(VSu
 
57
.\".if \\n(VS<=39 .vs \\n(VSp
 
58
..
 
59
.de De
 
60
.ce 0
 
61
.if \\n(BD .DF
 
62
.nr BD 0
 
63
.in \\n(OIu
 
64
.if \\n(TM .ls 2
 
65
.sp \\n(DDu
 
66
.fi
 
67
..
 
68
.de FD
 
69
.LP
 
70
.KS
 
71
.TA .5i 3i
 
72
.ta .5i 3i
 
73
.nf
 
74
..
 
75
.de FN
 
76
.fi
 
77
.KE
 
78
.LP
 
79
..
 
80
.de IN          \" send an index entry to the stderr
 
81
..
 
82
.de C{
 
83
.KS
 
84
.nf
 
85
.D
 
86
.\"
 
87
.\"     choose appropriate monospace font
 
88
.\"     the imagen conditional, 480,
 
89
.\"     may be changed to L if LB is too
 
90
.\"     heavy for your eyes...
 
91
.\"
 
92
.ie "\\*(.T"480" .ft L
 
93
.el .ie "\\*(.T"300" .ft L
 
94
.el .ie "\\*(.T"202" .ft PO
 
95
.el .ie "\\*(.T"aps" .ft CW
 
96
.el .ft R
 
97
.ps \\n(PS
 
98
.ie \\n(VS>40 .vs \\n(VSu
 
99
.el .vs \\n(VSp
 
100
..
 
101
.de C}
 
102
.DE
 
103
.R
 
104
..
 
105
.de Pn
 
106
.ie t \\$1\fB\^\\$2\^\fR\\$3
 
107
.el \\$1\fI\^\\$2\^\fP\\$3
 
108
..
 
109
.de ZN
 
110
.ie t \fB\^\\$1\^\fR\\$2
 
111
.el \fI\^\\$1\^\fP\\$2
 
112
..
 
113
.de hN
 
114
.ie t <\fB\\$1\fR>\\$2
 
115
.el <\fI\\$1\fP>\\$2
 
116
..
 
117
.de NT
 
118
.ne 7
 
119
.ds NO Note
 
120
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
 
121
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
 
122
.ie n .sp
 
123
.el .sp 10p
 
124
.TB
 
125
.ce
 
126
\\*(NO
 
127
.ie n .sp
 
128
.el .sp 5p
 
129
.if '\\$1'C' .ce 99
 
130
.if '\\$2'C' .ce 99
 
131
.in +5n
 
132
.ll -5n
 
133
.R
 
134
..
 
135
.               \" Note End -- doug kraft 3/85
 
136
.de NE
 
137
.ce 0
 
138
.in -5n
 
139
.ll +5n
 
140
.ie n .sp
 
141
.el .sp 10p
 
142
..
 
143
.ny0
 
144
.TH XmbResetIC 3X11 __xorgversion__ "XLIB FUNCTIONS"
 
145
.SH NAME
 
146
XmbResetIC, XwcResetIC, Xutf8ResetIC \- reset the state of an input context
 
147
.SH SYNTAX
 
148
char * XmbResetIC\^(\^\fIic\fP\^)
 
149
.br
 
150
      XIC \fIic\fP\^;
 
151
.LP
 
152
wchar_t * XwcResetIC\^(\^\fIic\fP\^)
 
153
.br
 
154
      XIC \fIic\fP\^; 
 
155
.LP
 
156
char * Xutf8ResetIC\^(\^\fIic\fP\^)
 
157
.br
 
158
      XIC \fIic\fP\^;
 
159
.SH ARGUMENTS
 
160
.IP \fIic\fP 1i
 
161
Specifies the input context.
 
162
.SH DESCRIPTION
 
163
When
 
164
.ZN XNResetState
 
165
is set to
 
166
.ZN XIMInitialState ,
 
167
.ZN XmbResetIC ,
 
168
.ZN XwcResetIC
 
169
and
 
170
.ZN Xutf8ResetIC
 
171
reset an input context to its initial state;
 
172
when
 
173
.ZN XNResetState
 
174
is set to
 
175
.ZN XIMPreserveState ,
 
176
the current input context state is preserved.
 
177
In both cases, any input pending on that context is deleted.
 
178
The input method is required to clear the preedit area, if any,
 
179
and update the status accordingly.
 
180
Calling 
 
181
.ZN XmbResetIC ,
 
182
.ZN XwcResetIC
 
183
or
 
184
.ZN Xutf8ResetIC
 
185
does not change the focus.
 
186
.LP
 
187
The return value of
 
188
.ZN XmbResetIC
 
189
is its current preedit string as a multibyte string.
 
190
The return value of
 
191
.ZN XwcResetIC
 
192
is its current preedit string as a wide character string.
 
193
The return value of
 
194
.ZN Xutf8ResetIC
 
195
is its current preedit string as an UTF-8 string.
 
196
If there is any preedit text drawn or visible to the user,
 
197
then these procedures must return a non-NULL string.
 
198
If there is no visible preedit text, 
 
199
then it is input method implementation-dependent 
 
200
whether these procedures return a non-NULL string or NULL.
 
201
.LP
 
202
The client should free the returned string by calling
 
203
.ZN XFree .
 
204
.LP
 
205
The function
 
206
.ZN Xutf8ResetIC
 
207
is an XFree86 extension introduced in XFree86 4.0.2. Its presence is
 
208
indicated by the macro
 
209
.ZN X_HAVE_UTF8_STRING .
 
210
.SH "SEE ALSO"
 
211
XCreateIC(3X11),
 
212
XOpenIM(3X11),
 
213
XSetICFocus(3X11),
 
214
XSetICValues(3X11)
 
215
.br
 
216
\fI\*(xL\fP