X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=README.md;h=570a0170c095aaf55cc2f6d15ef4ad13839f633f;hb=bd8d51fa0a33d6d27dba088c57791e1650512fc0;hp=f5effd47f3aabdd19e10263a872f548dc3d29eb0;hpb=30bd4abd2a85c162bdf0a1cc687b366345182bc1;p=nikiroo-utils.git diff --git a/README.md b/README.md index f5effd4..570a017 100644 --- a/README.md +++ b/README.md @@ -20,8 +20,9 @@ Two backends are available: * Java AWT UI. This backend can be selected by setting jexer.AWT=true. This is the default backend on Windows platforms. - AWT is VERY experimental, please consider filing bugs when you - encounter them. + AWT is experimental, please consider filing bugs when you encounter + them. The default window size for AWT is 132x40, which is set in + jexer.session.AWTSession. A demo application showing the existing UI controls is available via 'java -jar jexer.jar' or 'java -Djexer.AWT=true -jar jexer.jar' . @@ -71,10 +72,29 @@ public class MyApplication extends TApplication { } ``` -See the file demos/Demo1.java for example usage. +See the file demos/Demo1.java for detailed examples. +Known Issues / Arbitrary Decisions +---------------------------------- + +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. + + TTerminalWindow + --------------- + + - TTerminalWindow will hang on input from the remote if the + TApplication is exited before closing the TTerminalWindow. This + is due to a Java limitation/interaction between blocking reads + (necessary to get UTF8 translation correct) and file streams. + + - See jexer.tterminal.ECMA48 for more specifics of terminal + emulation limitations. + + Roadmap ------- @@ -84,29 +104,23 @@ Many tasks remain before calling this version 1.0: - AWT: - Blinking cursor - - More optimal refresh - - Jittery refresh with mouse movement -- Clean up TWidget constuctors (everyone is doing setX() / setY() / set...) + - Handle kbTab (disable focus traversal BS) - ECMA48Backend running on socket - TTreeView - TDirectoryList - TFileOpen - Decide on naming convention: getText, getValue, getLabel: one or all of them? -- TPasswordField (displays stars when not active) 0.0.3: - TEditor -- TTerminal 0.0.4: - Bugs - - Bare ESC isn't being returned immediately - - TTimer is jittery with I/O - TSubMenu keyboard mnemonic not working - - kbDel and use by TMenu (MID_CLEAR) + - Making TMenu keyboard accelerators active/inactive - TDirectoryList cannot be navigated only with keyboard - TTreeView cannot be navigated only with keyboard - RangeViolation after dragging scrollbar up/down @@ -136,3 +150,10 @@ Wishlist features (2.0): - TText - TTerminal - TComboBox + + +Screenshots +----------- + +![Several Windows Open Including A Terminal](/screenshots/screenshot1.png?raw=true "Several Windows Open Including A Terminal") +