Merge pull request #69 from KAMiKAZOW/patch-4

Update and rename README to README.md

Author: dobey

README README.mdREADME renamed to README.md

@@ -1,47 +1,51 @@
 Maliit
+======
 
 Maliit provides a flexible and cross-platform input method framework. It has a
 plugin-based client-server architecture where applications act as clients and
 communicate with the Maliit server via input context plugins. The communication
-link currently uses D-Bus. Maliit is an open source framework (LGPL 2) with
-open source plugins (BSD).
-
-This is the Maliit framework. For a virtual keyboard, see
-https://github.com/maliit/keyboard .
-
+link currently uses D-Bus. Maliit is an open source framework (LGPL 2.1) with
+a production-quality [keyboard plugin](https://github.com/maliit/keyboard) (LGPL 3.0).
 
 Installing
+----------
 
-Qt5 must be installed to build the Maliit framework. At a terminal, run:
+Qt 5 must be installed to build the Maliit framework. At a terminal, run:
 
+```
 mkdir build
 cd build
 cmake -DCMAKE_INSTALL_PREFIX=/usr ..
 make
 make install
-
-Run qmake HELP=1 to get more information about build options.
-
+```
 
 Running
+-------
 
 Set Maliit as the Qt and GTK+ input context:
 
+```
 export QT_IM_MODULE=Maliit
 export GTK_IM_MODULE=Maliit
+```
 
 Start the server:
 
+```
 maliit-server
+```
 
 Note that a compositing window manager and a D-Bus session bus are required to
 use Maliit.
 
 Test with the provided example applications:
 
+```
 maliit-exampleapp-plainqt # for Qt
 maliit-exampleapp-gtk2 # for Gtk2
 maliit-exampleapp-gtk3 # for Gtk3
+```
 
 Double-tap on the input field, and an input method (usually a virtual keyboard)
 should be shown. Note that an input method plugin, such as the Maliit keyboard
@@ -52,17 +56,20 @@ to work.
 NETWORK TRANSPARENCY
 
 On one computer run:
+```
 maliit-server -allow-anonymous -override-address tcp:host=xxx.xxx.xxx.xxx,port=yyyyy
+```
 
 Any valid dbus address is supported. Using -allow-anonymous must only be done on
 a trusted network. If using a method with authentication, the -allow-anonymous flag
 may be dropped.
 
 On another computer:
+```
 MALIIT_SERVER_ADDRESS=tcp:host=xxx.xxx.xxx.xxx,port=yyyyy
 export MALIIT_SERVER_ADDRESS
 maliit-exampleapp-plainqt (or maliit-exampleapp-gtk{2,3})
+```
 
 Where xxx.xxx.xxx.xxx is IP address of computer where maliit-server is ran
 and yyyyy is port number < 65536.
-