X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=README.md;h=dc976599bf6cffeb4d37a2d48a3d0bc0932d5d77;hb=3f499f9f180683b0ecf098684412d99662a523c7;hp=ff50ca75cb53c315fd3d727e4b24b02e2d855759;hpb=fe0770f988e64fc0ccafd3d3b086b4a0eb559d3b;p=nikiroo-utils.git diff --git a/README.md b/README.md index ff50ca7..dc97659 100644 --- a/README.md +++ b/README.md @@ -73,8 +73,9 @@ class MyApplication extends TApplication { addFileMenu(); addWindowMenu(); - // Add a custom window, see below for its code. - addWindow(new MyWindow(this)); + // Add a custom window, see below for its code. The TWindow + // constructor will add it to this application. + new MyWindow(this); } public static void main(String [] args) { @@ -196,6 +197,14 @@ The following properties control features of Jexer: be faster on slower systems but also more likely to have screen tearing. Default: true. + jexer.TTerminal.ptypipe + ----------------------- + + Used by jexer.TTerminalWindow. If true, spawn shell using the + 'ptypipe' utility rather than 'script'. This permits terminals to + resize with the window. ptypipe is a separate C language utility, + available at https://github.com/klamonte/ptypipe. Default: false. + Known Issues / Arbitrary Decisions @@ -205,11 +214,6 @@ Some arbitrary design decisions had to be made when either the obviously expected behavior did not happen or when a specification was ambiguous. This section describes such issues. - - The JVM needs some warmup time to exhibit the true performance - behavior. Drag a window around for a bit to see this: the initial - performance is slow, then the JIT compiler kicks in and Jexer can - be visually competitive with C/C++ curses applications. - - See jexer.tterminal.ECMA48 for more specifics of terminal emulation limitations. @@ -218,19 +222,19 @@ ambiguous. This section describes such issues. input (see the ENABLE_LINE_INPUT flag for GetConsoleMode() and SetConsoleMode()). - - TTerminalWindow launches 'script -fqe /dev/null' or 'script -q -F - /dev/null' on non-Windows platforms. This is a workaround for the - C library behavior of checking for a tty: script launches $SHELL - in a pseudo-tty. This works on Linux and Mac but might not on - other Posix-y platforms. + - TTerminalWindow by default launches 'script -fqe /dev/null' or + 'script -q -F /dev/null' on non-Windows platforms. This is a + workaround for the C library behavior of checking for a tty: + script launches $SHELL in a pseudo-tty. This works on Linux and + Mac but might not on other Posix-y platforms. - Closing a TTerminalWindow without exiting the process inside it may result in a zombie 'script' process. - - TTerminalWindow cannot notify the child process of changes in - window size, due to Java's lack of support for forkpty() and - similar. Solving this requires C, and will be pursued only if - sufficient user requests come in. + - TTerminalWindow can only notify the child process of changes in + window size if using the 'ptypipe' utility, due to Java's lack of + support for forkpty() and similar. ptypipe is available at + https://github.com/klamonte/ptypipe. - Java's InputStreamReader as used by the ECMA48 backend requires a valid UTF-8 stream. The default X10 encoding for mouse