Added some things to README

TooTallNate · TooTallNate · commit 9e752c32b1df · 2010-01-29T15:39:43.000-08:00
diff --git a/README.markdown b/README.markdown
@@ -2,9 +2,9 @@ Java WebSockets
 ===============
 
 This repository contains a simple WebSocket server and client implementation
-in Java. The underlying classes use `ServerSocketChannel` and `SocketChannel`
-objects, to allow for a non-blocking event-driven model (similar to the
-WebSocket API for web browsers).
+in Java. The underlying classes use the Java classes `ServerSocketChannel` and
+`SocketChannel`, to allow for a non-blocking event-driven model (similar to the
+[WebSocket API](<http://dev.w3.org/html5/websockets/>) for web browsers).
 
 Running the Example
 -------------------
@@ -24,22 +24,23 @@ The chat client is a simple Swing GUI that allows you to send messages to
 all other connected clients, and recieve messages from others in a text box.
 
 There's also a simple HTML file chat client `chat.html`, which can be opened
-by any browser that supports the WebSocket API (currently Chrome 4, Safari
-nightlies, Firefox nightlies).
+by any browser. If the browser natively supports the WebSocket API, then it will
+be used, otherwise it will fall back to a
+[Flash-based WebSocket Implementation](<http://github.com/gimite/web-socket-js>).
 
 Writing your own WebSocket Server
 ---------------------------------
 
-A WebSocketServer by itself doesn't do anything except establish socket
+A WebSocket server by itself doesn't do anything except establish socket
 connections though HTTP. After that it's up to a subclass to add purpose.
-
+The `WebSocketServer` class implements the server-side of the
+[WebSocket Protocol](<http://tools.ietf.org/html/draft-hixie-thewebsocketprotocol>).
 
 Writing your own WebSocket Client
 ---------------------------------
 
-The WebSocketClient aims to simulate the WebSocket API
-(<http://dev.w3.org/html5/websockets/>) as closely as possible.
-The constructor expects a valid "ws://" URI to connect to. Important
+The `WebSocketClient` class can connect to valid WebSocket servers.
+The constructor expects a valid `ws://` URI to connect to. Important
 events `onOpen`, `onClose`, and `onMessage` get fired throughout the life
 of the WebSocketClient, and must be implemented in your subclass.
 
