X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=README.md;h=bbe38d640af88567e030fe45f93132870b34ad8c;hb=128e5be1ffb65d047d8461ea1cfb65c22686ec91;hp=c4c827a389daef6b66e0412bf2c3f0cf7f18d6c2;hpb=847c19a66b6e5c58ea11caa4a5654b0ed37180b3;p=fanfix.git diff --git a/README.md b/README.md index c4c827a..bbe38d6 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,114 @@ -# 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: + +- TDirectoryList +- TMessageBox +- 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