keyboard accelerators
[nikiroo-utils.git] / README.md
index c4c827a389daef6b66e0412bf2c3f0cf7f18d6c2..2e9ef73bec5b45ab70e55807bffb0b93f1b76933 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,119 @@
-# jexer
-Java Text User Interface
+Jexer - Java Text User Interface library
+========================================
+
+This library is currently in design, but when finished it is intended
+to implement a text-based windowing system loosely reminiscient of
+Borland's [Turbo Vision](http://en.wikipedia.org/wiki/Turbo_Vision)
+library.  For those wishing to use the actual C++ Turbo Vision
+library, see [Sergio Sigala's updated
+version](http://tvision.sourceforge.net/) that runs on many more
+platforms.
+
+
+License
+-------
+
+This library is licensed LGPL ("GNU Lesser General Public License")
+version 3 or greater.  See the file LICENSE for the full license text,
+which includes both the GPL v3 and the LGPL supplemental terms.
+
+
+Usage
+-----
+
+The library is currently under initial development, usage patterns are
+still being worked on.  Generally the goal will be to build
+applications somewhat as follows:
+
+```Java
+import jexer.*;
+
+public class MyApplication extends TApplication {
+
+    public MyApplication() {
+        super();
+
+        // Create an editor window that has support for
+        // copy/paste, search text, arrow keys, horizontal
+        // and vertical scrollbar, etc.
+        addEditor();
+
+        // Create standard menus for File and Window
+        addFileMenu();
+        addWindowMenu();
+    }
+
+    public static void main(String [] args) {
+        MyApplication app = new MyApplication();
+        app.run();
+    }
+}
+```
+
+
+Roadmap
+-------
+
+Many tasks remain before calling this version 1.0:
+
+0.0.1:
+
+- TCheckbox
+- TDirectoryList
+- TField
+- TMessageBox
+- TProgressBar
+- TTimer
+- TRadioGroup / TRadioButton
+- THScroller / TVScroller
+- TText
+- TTreeView
+
+0.0.2:
+
+- TEditor
+- TFileOpen
+- TTerminal
+
+0.0.3:
+
+- Bugs
+  - TSubMenu keyboard mnemonic not working
+  - kbDel assertion failure in TMenu (MID_CLEAR)
+- TEditor
+  - Word wrap
+  - Forward/backward word
+  - Search
+  - Replace
+  - Cut/Copy/Paste
+
+0.0.4:
+
+- ECMATerminal
+  - Mouse 1006 mode parsing
+- Bugs
+  - TDirectoryList cannot be navigated only with keyboard
+  - TTreeView cannot be navigated only with keyboard
+  - RangeViolation after dragging scrollbar up/down
+
+Wishlist features (2.0):
+
+- TTerminal
+  - Handle resize events (pass to child process)
+  - xterm mouse handling
+- TWindow
+  - "Smart placement" for new windows
+- Screen
+  - Allow complex characters in putCharXY() and detect them in putStrXY().
+- TComboBox
+- TListBox
+- TSpinner
+- TCalendar widget
+- TColorPicker widget
+- Drag and drop
+  - TEditor
+  - TField
+  - TText
+  - TTerminal
+  - TComboBox
+- AWTBackend