# c3270 Additional Build and Install Instructions

This file describes build and install information specific to c3270. For general build information, look here.

## Wide Curses Requirement

c3270 needs the 'wide' version of the curses or ncurses library (one that supports multi-byte character encodings). Without wide curses or ncurses, c3270 will be restricted to using the 7-bit basic ASCII character set.

On some platforms, the standard curses or ncurses library is the wide version and no extra packages need be installed. On others, a special wide ncurses package is needed. On still others (such as on Solaris, documented below) the wide curses library is installed in a special location and `configure` must be told where to locate it using CPPFLAGS and LDFLAGS.

## Notes for Ubuntu

Additonal packages needed to compile c3270 are:

- libncursesw5-dev

## Notes for Cygwin

Additional Cygwin packages are needed to compile c3270:

- The libncurses-devel package from the Devel group
- For command-line editing and history, the readline package from the Devel group

## Notes for Solaris

c3270 prefers wide curses, which on Solaris is in the `/usr/xpg4` directory. To use this version of curses, set CPPFLAGS and LDFLAGS when running `configure`:

       ./configure CPPFLAGS=-I/usr/xpg4/include LDFLAGS=-L/usr/xpg4/lib

## c3270-Specific `configure` Options

The c3270 `configure` script accepts the following c3270-specific option:

`--without-readline` | Don't use the readline command-line editing library, even if it is found on the system.