You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
62 lines
2.1 KiB
Markdown
62 lines
2.1 KiB
Markdown
PDCursesMod for X11 (new, experimental)
|
|
========================================
|
|
|
|
This port of PDCursesMod for X11 has been written from scratch, with
|
|
(thus far) only the key remapping array taken from pdckbd.c of the
|
|
"original" X11 port. It is, as yet, unclear if this will be a
|
|
replacement for the original port. As noted in the 'to do' section,
|
|
it's early days for this port (no known bugs, but many unimplemented
|
|
and unfinished bits of functionality).
|
|
|
|
Building
|
|
--------
|
|
|
|
- Run `make`. Add `UTF8=Y` to force the wide-character version. Add
|
|
`DEBUG=Y` for the debug version. Add `NO_LEAKS=Y` to avoid Xlib's tendency
|
|
to leak lots of memory (this does limit you to a US keyboard; see
|
|
`pdckbd.c`.) Add the target `demos` to build the sample programs,
|
|
and/or `tests` for the test programs.
|
|
|
|
- Currently, there is no `make install`.
|
|
|
|
Usage
|
|
-----
|
|
|
|
When compiling your application, you need to include the `\<curses.h\>`
|
|
that comes with PDCursesMod. You also need to link your code with
|
|
libXCurses. You will need to link with the following libraries:
|
|
|
|
`-lX11 -lpthread`
|
|
|
|
To do
|
|
-----
|
|
|
|
- Combining and fullwidth characters
|
|
- How to do SMB (Unicode > 0xffff)?
|
|
- Bold & italic text
|
|
- Respond to Ctrl-plus and Ctrl-minus with font size changes?
|
|
- Add `make install`.
|
|
|
|
Most of these shouldn't be all that tough to do.
|
|
|
|
Interaction with stdio
|
|
----------------------
|
|
|
|
Be aware that curses programs that expect to have a normal tty
|
|
underneath them will be very disappointed! Output directed to stdout
|
|
will go to the xterm that invoked the PDCursesMod application, or to the
|
|
console if not invoked directly from an xterm. Similarly, stdin will
|
|
expect its input from the same place as stdout.
|
|
|
|
Note that this isn't entirely a bad thing. You can use `printf()`s for
|
|
debugging, secure in the knowledge that they'll go to the terminal
|
|
and won't mess up the Curses screen. You can do this for the X11
|
|
ports and GL, SDL1/2, WinGUI, and the OS/2 GUI ports. You can't
|
|
with the other ports (they all do have terminals under them) or when
|
|
building with `ncurses`.
|
|
|
|
Distribution Status
|
|
-------------------
|
|
|
|
The files in this directory are released to the public domain.
|