X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=README.md;h=058eb6f2d02667698054915c8ab61f1b53ed7369;hb=bb35d91958450cc7152d2063f1d6cd34c15e2a3d;hp=bbe38d640af88567e030fe45f93132870b34ad8c;hpb=128e5be1ffb65d047d8461ea1cfb65c22686ec91;p=fanfix.git

diff --git a/README.md b/README.md
index bbe38d6..058eb6f 100644
--- a/README.md
+++ b/README.md
@@ -1,29 +1,55 @@
 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.
+WARNING: THIS IS ALPHA CODE!
+
+This library 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.
+
+Two backends are available:
+
+* System.in/out to a command-line ECMA-48 / ANSI X3.64 type terminal
+  (tested on Linux + xterm).  I/O is handled through terminal escape
+  sequences generated by the library itself: ncurses is not required
+  or linked to.  xterm mouse tracking using UTF8 coordinates is
+  supported.  This is the default backend on non-Windows platforms.
+
+* 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.
+
+A demo application showing the existing UI controls is available via
+'java -jar jexer.jar' or 'java -Djexer.AWT=true -jar jexer.jar' .
+
 
 
 License
 -------
 
-This library is licensed LGPL ("GNU Lesser General Public License")
+This project 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.
 
 
+
+Acknowledgements
+----------------
+
+Jexer makes use of the Terminus TrueType font [made available
+here](http://files.ax86.net/terminus-ttf/) .
+
+
+
 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:
+Usage patterns are still being worked on, but in general the goal will
+be to build applications somewhat as follows:
 
 ```Java
 import jexer.*;
@@ -33,11 +59,6 @@ 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();
@@ -50,54 +71,67 @@ public class MyApplication extends TApplication {
 }
 ```
 
+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.
+
 
 Roadmap
 -------
 
 Many tasks remain before calling this version 1.0:
 
-0.0.1:
-
-- TDirectoryList
-- TMessageBox
-- THScroller / TVScroller
-- TText
-- TTreeView
-
 0.0.2:
 
-- TEditor
+- AWT:
+  - Blinking cursor
+- ECMA48Backend running on socket
+- TTreeView
+- TDirectoryList
 - TFileOpen
-- TTerminal
+- Decide on naming convention: getText, getValue, getLabel: one or all
+  of them?
 
 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
+  - TSubMenu keyboard mnemonic not working
+  - 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
 
+0.1.0:
+
+- TWindow
+  - "Smart placement" for new windows
+- ECMATerminal
+  - Mouse 1006 mode parsing
+
 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
@@ -111,4 +145,10 @@ Wishlist features (2.0):
   - TText
   - TTerminal
   - TComboBox
-- AWTBackend
+
+
+Screenshots
+-----------
+
+![Several Windows Open Including A Terminal](/screenshots/screenshot1.png?raw=true "Several Windows Open Including A Terminal")
+