diff options
Diffstat (limited to 'libX11/man/Compose.man')
-rw-r--r-- | libX11/man/Compose.man | 316 |
1 files changed, 158 insertions, 158 deletions
diff --git a/libX11/man/Compose.man b/libX11/man/Compose.man index 22fe51e9c..13ba705ff 100644 --- a/libX11/man/Compose.man +++ b/libX11/man/Compose.man @@ -1,158 +1,158 @@ -.\" Copyright 2009 Oracle and/or its affiliates. All rights reserved.
-.\"
-.\" Permission is hereby granted, free of charge, to any person obtaining a
-.\" copy of this software and associated documentation files (the "Software"),
-.\" to deal in the Software without restriction, including without limitation
-.\" the rights to use, copy, modify, merge, publish, distribute, sublicense,
-.\" and/or sell copies of the Software, and to permit persons to whom the
-.\" Software is furnished to do so, subject to the following conditions:
-.\"
-.\" The above copyright notice and this permission notice (including the next
-.\" paragraph) shall be included in all copies or substantial portions of the
-.\" Software.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
-.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-.\" DEALINGS IN THE SOFTWARE.
-.\"
-.\" shorthand for double quote that works everywhere.
-.ds q \N'34'
-.ds xL Xlib \- C Language X Interface
-.TH Compose __filemansuffix__ __vendorversion__
-.SH NAME
-Compose \- X client mappings for multi-key input sequences
-.SH DESCRIPTION
-The X library, libX11, provides a simple input method for characters
-beyond those represented on typical keyboards using sequences of key
-strokes that are combined to enter a single character.
-.PP
-The compose file is searched for in the following order:
-.IP -
-If the environment variable
-.B $XCOMPOSEFILE
-is set, its value is used as the name of the Compose file.
-.IP -
-If the user's home directory has a file named
-.IR .XCompose ,
-it is used as the Compose file.
-.IP -
-The system provided compose file is used by mapping the locale to a compose
-file from the list in
-.IR __xlocaledir__/compose.dir .
-.PP
-Compose files can use an
-.RB \*q include \*q
-instruction. This allows local modifications to be made to existing compose
-files without including all of the content directly. For example, the
-system's iso8859-1 compose file can be included with a line like this:
-.RS 4
-.BI "include \*q" %S/iso8859-1/Compose \*q
-.RE
-.PP
-There are several substitutions that can be made in the file name of the
-include instruction:
-.TP 4
-.I %H
-expands to the user's home directory (the
-.B $HOME
-environment variable)
-.TP 4
-.I %L
-expands to the name of the locale specific Compose file (i.e.,
-.RI \*q __xlocaledir__/<localename>/Compose \*q)
-.TP 4
-.I %S
-expands to the name of the system directory for Compose files (i.e.,
-.RI \*q __xlocaledir__ \*q)
-.PP
-For example, you can include in your compose file the default Compose file
-by using:
-.RS
-.B "include \*q%L\*q"
-.RE
-and then rewrite only the few rules that you need to change. New
-compose rules can be added, and previous ones replaced.
-.SH FILE FORMAT
-.\" Based on grammar description in modules/im/ximcp/imLcPrs.c
-Compose files are plain text files, with a separate line for each compose
-sequence. Comments begin with \fB#\fP characters. Each compose sequence
-specifies one or more events and a resulting input sequence, with an optional
-comment at the end of the line:
-.RS
-\fIEVENT\fP [\fIEVENT\fP...] \fB:\fP \fIRESULT\fP [\fB#\fP \fICOMMENT\fP]
-.RE
-.PP
-Each event consists of a specified input keysym, and optional modifier states:
-.RS
-[\fIMODIFIER_LIST\fP] \fB<\fP\fIkeysym\fP\fB>\fP
-.RE
-.PP
-Each modifier consists of a specified modifier and a state:
-.RS
-(\fB!\fP \fIMODIFIER\fP ) | \fBNone\fP
-.RE
-Modifiers may be preceded by a
-.RB \*q "~" \*q
-character to indicate that the modifier must not be present.
-.PP
-The result specifies a string, keysym, or both, that the X client receives
-as input when the sequence of events is input:
-.RS
-\fB\*q\fP\fISTRING\fP\fB\*q\fP | \fIkeysym\fP | \fB\*q\fP\fISTRING\fP\fB\*q\fP \fIkeysym\fP
-.RE
-.PP
-Keysyms are specified without the \fBXK_\fP prefix.
-.PP
-Strings may be direct text encoded in the locale for which the compose file is
-to be used, or an escaped octal or hexadecimal character code. Octal codes
-are specified as \fB\*q\\123\*q\fP and hexadecimal codes as
-\fB\*q\\0x123a\*q\fP.
-It is not necessary to specify in the right part of a rule a locale encoded
-string in addition to the keysym name. If the string is omitted, Xlib
-figures it out from the keysym according to the current locale.
-I.e., if a rule looks like:
-.RS
-\fB<dead_grave> <A> : \*q\\300\*q Agrave\fP
-.RE
-the result of the composition is always the letter with the "\\300"
-code. But if the rule is:
-.RS
-\fB<dead_grave> <A> : Agrave\fP
-.RE
-the result depends on how Agrave is mapped in the current locale.
-.SH ENVIRONMENT
-.TP
-.B XCOMPOSEFILE
-File to use for compose sequences.
-.TP
-.B XCOMPOSECACHE
-Directory to use for caching compiled compose files.
-.SH FILES
-.TP
-.I $HOME/.XCompose
-User default compose file if XCOMPOSEFILE is not set.
-.TP
-.I __xlocaledir__/compose.dir
-File listing the compose file path to use for each locale.
-.TP
-.I __xlocaledir__/<localemapping>/Compose
-System default compose file for the locale, mapped via compose.dir.
-.TP
-.I /var/cache/libx11/compose/
-System-wide cache directory for compiled compose files.
-.TP
-.I $HOME/.compose-cache/
-Per-user cache directory for compiled compose files.
-.SH SEE ALSO
-.BR XLookupString (__libmansuffix__),
-.BR XmbLookupString (__libmansuffix__),
-.BR XwcLookupString (__libmansuffix__),
-.BR Xutf8LookupString (__libmansuffix__),
-.BR mkcomposecache (__appmansuffix__),
-.BR locale (__miscmansuffix__).
-.br
-\fI\*(xL\fP
+.\" Copyright 2009 Oracle and/or its affiliates. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.\" shorthand for double quote that works everywhere. +.ds q \N'34' +.ds xL Xlib \- C Language X Interface +.TH Compose __filemansuffix__ __vendorversion__ +.SH NAME +Compose \- X client mappings for multi-key input sequences +.SH DESCRIPTION +The X library, libX11, provides a simple input method for characters +beyond those represented on typical keyboards using sequences of key +strokes that are combined to enter a single character. +.PP +The compose file is searched for in the following order: +.IP - +If the environment variable +.B $XCOMPOSEFILE +is set, its value is used as the name of the Compose file. +.IP - +If the user's home directory has a file named +.IR .XCompose , +it is used as the Compose file. +.IP - +The system provided compose file is used by mapping the locale to a compose +file from the list in +.IR __xlocaledir__/compose.dir . +.PP +Compose files can use an +.RB \*q include \*q +instruction. This allows local modifications to be made to existing compose +files without including all of the content directly. For example, the +system's iso8859-1 compose file can be included with a line like this: +.RS 4 +.BI "include \*q" %S/iso8859-1/Compose \*q +.RE +.PP +There are several substitutions that can be made in the file name of the +include instruction: +.TP 4 +.I %H +expands to the user's home directory (the +.B $HOME +environment variable) +.TP 4 +.I %L +expands to the name of the locale specific Compose file (i.e., +.RI \*q __xlocaledir__/<localename>/Compose \*q) +.TP 4 +.I %S +expands to the name of the system directory for Compose files (i.e., +.RI \*q __xlocaledir__ \*q) +.PP +For example, you can include in your compose file the default Compose file +by using: +.RS +.B "include \*q%L\*q" +.RE +and then rewrite only the few rules that you need to change. New +compose rules can be added, and previous ones replaced. +.SH FILE FORMAT +.\" Based on grammar description in modules/im/ximcp/imLcPrs.c +Compose files are plain text files, with a separate line for each compose +sequence. Comments begin with \fB#\fP characters. Each compose sequence +specifies one or more events and a resulting input sequence, with an optional +comment at the end of the line: +.RS +\fIEVENT\fP [\fIEVENT\fP...] \fB:\fP \fIRESULT\fP [\fB#\fP \fICOMMENT\fP] +.RE +.PP +Each event consists of a specified input keysym, and optional modifier states: +.RS +[\fIMODIFIER_LIST\fP] \fB<\fP\fIkeysym\fP\fB>\fP +.RE +.PP +Each modifier consists of a specified modifier and a state: +.RS +(\fB!\fP \fIMODIFIER\fP ) | \fBNone\fP +.RE +Modifiers may be preceded by a +.RB \*q "~" \*q +character to indicate that the modifier must not be present. +.PP +The result specifies a string, keysym, or both, that the X client receives +as input when the sequence of events is input: +.RS +\fB\*q\fP\fISTRING\fP\fB\*q\fP | \fIkeysym\fP | \fB\*q\fP\fISTRING\fP\fB\*q\fP \fIkeysym\fP +.RE +.PP +Keysyms are specified without the \fBXK_\fP prefix. +.PP +Strings may be direct text encoded in the locale for which the compose file is +to be used, or an escaped octal or hexadecimal character code. Octal codes +are specified as \fB\*q\\123\*q\fP and hexadecimal codes as +\fB\*q\\0x123a\*q\fP. +It is not necessary to specify in the right part of a rule a locale encoded +string in addition to the keysym name. If the string is omitted, Xlib +figures it out from the keysym according to the current locale. +I.e., if a rule looks like: +.RS +\fB<dead_grave> <A> : \*q\\300\*q Agrave\fP +.RE +the result of the composition is always the letter with the "\\300" +code. But if the rule is: +.RS +\fB<dead_grave> <A> : Agrave\fP +.RE +the result depends on how Agrave is mapped in the current locale. +.SH ENVIRONMENT +.TP +.B XCOMPOSEFILE +File to use for compose sequences. +.TP +.B XCOMPOSECACHE +Directory to use for caching compiled compose files. +.SH FILES +.TP +.I $HOME/.XCompose +User default compose file if XCOMPOSEFILE is not set. +.TP +.I __xlocaledir__/compose.dir +File listing the compose file path to use for each locale. +.TP +.I __xlocaledir__/<localemapping>/Compose +System default compose file for the locale, mapped via compose.dir. +.TP +.I /var/cache/libx11/compose/ +System-wide cache directory for compiled compose files. +.TP +.I $HOME/.compose-cache/ +Per-user cache directory for compiled compose files. +.SH SEE ALSO +.BR XLookupString (__libmansuffix__), +.BR XmbLookupString (__libmansuffix__), +.BR XwcLookupString (__libmansuffix__), +.BR Xutf8LookupString (__libmansuffix__), +.BR mkcomposecache (__appmansuffix__), +.BR locale (__miscmansuffix__). +.br +\fI\*(xL\fP |