x3270 4.0 General Release

x3270 is an IBM 3278/3279 terminal emulator for X11.

Documentation is in the html directory.  The files are:

Intro
     What x3270 is
Lineage
     Where x3270 came from (copyright stuff)
Build
     How to build and install x3270
FAQ
     Frequently Asked Questions (what to do when something goes wrong)
Attributes
     A translation table for 3270 field attributes
Resources
     Voluminous documentation of all the X resources used by x3270
Charset
     An explanation of x3270's use of fonts and character sets
Keymap
     How to create a custom x3270 keymap
Brackets
     How to get [ and ] to display correctly
New
     What's new in this release
Bugs
     What's broken in this release
Wishlist
     What isn't in this release

There is also a hypertext version of the x3270 man page, and of the man
pages for x3270if, x3270-script and ibm_hosts.

Please read Build before going ahead and building the program. Also, if you
have a problem, scan through FAQ; there are lots of interesting answers
there.

Updates to x3270, as well as the current status of development and bugs, are
available from the x3270 Web Page, http://x3270.sourceforge.net/.

Feel free to send comments, criticism, suggestions, complaints, etc., to
Paul Mattes, paul.mattes@case.edu. Requests will be addressed as time and
resources permit.

There is also an x3270 mailing list, which receives news about new releases.
You can subscribe to this list at
https://lists.sourceforge.net/lists/listinfo/x3270-announce.

How to Run x3270 in DBCS Mode
-----------------------------
DBCS is an attribute of your locale and the host character set you select.

Your locale is defined by the LC_CTYPE or LC_ALL environment variable, and
determines the character set and encoding for interactions with the Input
Method, as well as other workstation I/O (cut/paste, screen printing,
scripting).

The x3270 host character set may be selected from the command line, or from
the Options->Character set menu option.  For example, Simplified Chinese is
selected via the option '-charset simplified-chinese'.

In order to get multi-byte input, you must run an X Input Method (e.g., xcin,
kinput2).  The input method name can be automatically derived from
the locale, or can be specified by the XMODIFIERS environment variable or by
the '-im' command-line option.

The preedit type used by the input method can be specified by the '-pt' option,
which takes the values 'Root' or 'OverTheSpot'.  The vertical offset of the
preedit window for 'OverTheSpot' can be modified by adding a suffix to
'OverTheSpot', e.g., '-pt OverTheSpot+2' will cause the preedit window to
appear two lines below the cursor.  The default preedit type is
'OverTheSpot+1'.

Languages and Code Pages Supported
----------------------------------
 Charset Name       Code Pages               X11 Charsets
 ------------------ ------------------------ -------------------------
 simplified-chinese 836 (SBCS), 837 (DBCS)   gb2312.1980-0, iso10646-1
 japanese           1027 (SBCS), 300 (DBCS)  jisx201.1976-0+jisx0208.1983-0,
					     iso10646-1

Known Limitations
-----------------
- Flipped mode does not work, and is disabled.