| 1 | .\" $XTermId: uxterm.man,v 1.3 2007/12/30 15:55:21 tom Exp $ |
|---|
| 2 | .\" |
|---|
| 3 | .\" Copyright 2001, 2004 Branden Robinson |
|---|
| 4 | .\" |
|---|
| 5 | .\" Permission is hereby granted, free of charge, to any person obtaining a |
|---|
| 6 | .\" copy of this software and associated documentation files (the "Software"), |
|---|
| 7 | .\" to deal in the Software without restriction, including without limitation |
|---|
| 8 | .\" the rights to use, copy, modify, merge, publish, distribute, sublicense, |
|---|
| 9 | .\" and/or sell copies of the Software, and to permit persons to whom the |
|---|
| 10 | .\" Software is furnished to do so, subject to the following conditions: |
|---|
| 11 | .\" |
|---|
| 12 | .\" The above copyright notice and this permission notice shall be included in |
|---|
| 13 | .\" all copies or substantial portions of the Software. |
|---|
| 14 | .\" |
|---|
| 15 | .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
|---|
| 16 | .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
|---|
| 17 | .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
|---|
| 18 | .\" SOFTWARE IN THE PUBLIC INTEREST, INC. 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 OTHER |
|---|
| 21 | .\" DEALINGS IN THE SOFTWARE. |
|---|
| 22 | .TH uxterm 1 "2004-12-19" "Debian Project" |
|---|
| 23 | .SH NAME |
|---|
| 24 | uxterm \- X terminal emulator for Unicode (UTF-8) environments |
|---|
| 25 | .SH SYNOPSIS |
|---|
| 26 | .B uxterm |
|---|
| 27 | [ |
|---|
| 28 | .I xterm-options |
|---|
| 29 | ] |
|---|
| 30 | .SH DESCRIPTION |
|---|
| 31 | .B uxterm |
|---|
| 32 | is a wrapper around the |
|---|
| 33 | .BR xterm(1) |
|---|
| 34 | program that invokes the latter program with the \(oqUXTerm\(cq X resource |
|---|
| 35 | class set. |
|---|
| 36 | All arguments to |
|---|
| 37 | .B uxterm |
|---|
| 38 | are passed to |
|---|
| 39 | .B xterm |
|---|
| 40 | without processing; the |
|---|
| 41 | .B \-class |
|---|
| 42 | and |
|---|
| 43 | .B \-u8 |
|---|
| 44 | options should not be specified because they are used by the wrapper. |
|---|
| 45 | See the |
|---|
| 46 | .B xterm |
|---|
| 47 | manual page for more information on |
|---|
| 48 | .IR xterm-options . |
|---|
| 49 | .PP |
|---|
| 50 | The environment's locale settings (see \(lqENVIRONMENT\(rq below) are |
|---|
| 51 | used to discern the locale's character set. |
|---|
| 52 | If no current locale can be determined, the locale \(oqen_US\(cq (the |
|---|
| 53 | English language as used in the territory of the United States) is assumed. |
|---|
| 54 | The |
|---|
| 55 | .BR locale(1) |
|---|
| 56 | utility is used to determine whether the system supports the selected |
|---|
| 57 | locale. |
|---|
| 58 | If it does not, |
|---|
| 59 | .B uxterm |
|---|
| 60 | will exit with an error and report the output of |
|---|
| 61 | .BR locale . |
|---|
| 62 | .PP |
|---|
| 63 | .B Note: uxterm |
|---|
| 64 | may produce unexpected results if the current locale is set to one in which |
|---|
| 65 | the UTF-8 character encoding is not supported, or if fonts using the ISO |
|---|
| 66 | 10646-1 character set are not available. |
|---|
| 67 | In the Debian system, the \(oqxfonts\-base\(cq package provides the fonts |
|---|
| 68 | that |
|---|
| 69 | .B uxterm |
|---|
| 70 | uses by default. |
|---|
| 71 | To change the fonts |
|---|
| 72 | .B uxterm |
|---|
| 73 | uses, edit the |
|---|
| 74 | .I __apploaddir__/UXTerm |
|---|
| 75 | file. |
|---|
| 76 | .PP |
|---|
| 77 | A similar wrapper, |
|---|
| 78 | .BR koi8rxterm(1), |
|---|
| 79 | is available for KOI8-R environments. |
|---|
| 80 | .SH ENVIRONMENT |
|---|
| 81 | .TP |
|---|
| 82 | .B LC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG |
|---|
| 83 | The values of these variables are checked, in order, to determine the |
|---|
| 84 | character set used by the current locale. |
|---|
| 85 | .SH AUTHOR |
|---|
| 86 | Thomas Dickey |
|---|
| 87 | .SH "SEE ALSO" |
|---|
| 88 | .BR locale(1), |
|---|
| 89 | .BR locale(7), |
|---|
| 90 | .BR koi8rxterm(1), |
|---|
| 91 | .BR xterm(1) |
|---|
