This file is a list of frequently reported problems with ncurses which are
considered bugs elsewhere or configuration problems.  If you're going to
report a bug in ncurses, you should probably look over this list first.

********

If you use escape codes to configure a terminal, ncurses applications will
just overwrite your settings when they exit.

The proper way to do this is to also provide a custom terminfo type which
sets the terminal correctly.  For instance, for controlling the cursor
shape/color/etc., change the 'cnorm' capability.

********

If you hit the "Print Screen" key while in a Linux console, your current
application will likely dump core.

The kernel maps that key to ^\, which generates a SIGQUIT by default. 
There's no bug here (although why that key was chosen is unclear).

********

Home/End keys don't work in some non-full-screen applications.

The situation with this is somewhat complicated.  For a background summary,
see:
	http://dickey.his.com/xterm/xterm.faq.html#xterm_pc_style
	http://dickey.his.com/xterm/xterm.faq.html#xterm_arrows

Essentially, the key sequences in terminfo entries (particularly khome and
kend) are for full-screen applications only.  This means that they
are only valid after an 'smkx' sequence, to put the terminal into
application mode.  If you want to use these sequences in non-application
mode, you need to recognize similar sequences - the versions which start
with CSI (\E [) rather than SS3 (\E O).  One example of how is in /etc/zshrc
in recent Debian ZSH packages.

********

The Debian terminfo entry for xterm doesn't work with some other xterms

There's no way to win this.  For a while, Debian made its xterm default to
a terminal type of 'xterm-debian', which seemed to fix the problem.  In
that case, however, connecting to remote non-Debian machines requires you
to change your terminal type (since there will be no entry for xterm-debian
there).  Having changed back to a default terminal type of 'xterm', when you
sit at a non-Debian system using some other version of xterm, applications
on the Debian system may use features not available in your current xterm.

The only workaround for this problem is to set your terminal type from xterm
to one of the feature-limited versions when you log in to a Debian system
remotely.  "xterm-r6" and the associated terminal types are appropriate for
this.
