| 1 | .\" $XTermId: koi8rxterm.man,v 1.3 2007/12/30 15:46:00 tom Exp $ |
|---|
| 2 | .\" |
|---|
| 3 | .\" Copyright 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 koi8rxterm 1 "2004-12-19" "Debian Project" |
|---|
| 23 | .SH NAME |
|---|
| 24 | koi8rxterm \- X terminal emulator for KOI8-R environments |
|---|
| 25 | .SH SYNOPSIS |
|---|
| 26 | .B koi8rxterm |
|---|
| 27 | [ |
|---|
| 28 | .I xterm-options |
|---|
| 29 | ] |
|---|
| 30 | .SH DESCRIPTION |
|---|
| 31 | .B koi8rxterm |
|---|
| 32 | is a wrapper around the |
|---|
| 33 | .BR xterm(1) |
|---|
| 34 | program that invokes the latter program with the \(oqKOI8RXTerm\(cq X |
|---|
| 35 | resource class set. |
|---|
| 36 | All arguments to |
|---|
| 37 | .B koi8rxterm |
|---|
| 38 | are passed to |
|---|
| 39 | .B xterm |
|---|
| 40 | without processing; the |
|---|
| 41 | .B \-class |
|---|
| 42 | and |
|---|
| 43 | .B \-k8 |
|---|
| 44 | options should not be specified because they are used by the wrapper. |
|---|
| 45 | See the |
|---|
| 46 | .BR 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 \(oqru_RU.KOI8-R\(cq |
|---|
| 53 | (the Russian language as used in the territory of Russia, with the KOI8-R |
|---|
| 54 | character set) is assumed. |
|---|
| 55 | The |
|---|
| 56 | .BR locale(1) |
|---|
| 57 | utility is used to determine whether the system supports the selected |
|---|
| 58 | locale. |
|---|
| 59 | If it does not, |
|---|
| 60 | .B koi8rxterm |
|---|
| 61 | will exit with an error and report the output of |
|---|
| 62 | .BR locale . |
|---|
| 63 | .PP |
|---|
| 64 | .B Note: koi8rxterm |
|---|
| 65 | may produce unexpected results if the current locale is set to one in which |
|---|
| 66 | the KOI8-R character encoding is not supported, or if fonts using that |
|---|
| 67 | encoding are not available. |
|---|
| 68 | In the Debian system, the \(oqxfonts\-cyrillic\(cq package provides the |
|---|
| 69 | fonts that |
|---|
| 70 | .B koi8rxterm |
|---|
| 71 | uses by default. |
|---|
| 72 | To change the fonts |
|---|
| 73 | .B koi8rxterm |
|---|
| 74 | uses, edit the |
|---|
| 75 | .I __apploaddir__/KOI8RXTerm |
|---|
| 76 | file. |
|---|
| 77 | .PP |
|---|
| 78 | A similar wrapper, |
|---|
| 79 | .BR uxterm(1), |
|---|
| 80 | is available for Unicode UTF-8 environments. |
|---|
| 81 | .SH ENVIRONMENT |
|---|
| 82 | .TP |
|---|
| 83 | .B LC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG |
|---|
| 84 | The values of these variables are checked, in order, to determine the |
|---|
| 85 | character set used by the current locale. |
|---|
| 86 | .SH AUTHOR |
|---|
| 87 | .B koi8rxterm |
|---|
| 88 | was written by Branden Robinson and is very heavily based on |
|---|
| 89 | .BR uxterm , |
|---|
| 90 | by Thomas Dickey. |
|---|
| 91 | The assistance of Jurij Smakov was invaluable in sanity-checking its |
|---|
| 92 | operation. |
|---|
| 93 | .SH "SEE ALSO" |
|---|
| 94 | .BR locale(1), |
|---|
| 95 | .BR locale(7), |
|---|
| 96 | .BR uxterm(1), |
|---|
| 97 | .BR xterm(1) |
|---|
