Update readme

README.md

@@ -4,7 +4,7 @@ D library for working with *.desktop* files. Desktop entries in Freedesktop worl
 
 [![Build Status](https://travis-ci.org/MyLittleRobo/desktopfile.svg?branch=master)](https://travis-ci.org/MyLittleRobo/desktopfile) [![Coverage Status](https://coveralls.io/repos/MyLittleRobo/desktopfile/badge.svg?branch=master&service=github)](https://coveralls.io/github/MyLittleRobo/desktopfile?branch=master)
 
-The most of desktop environments on Linux and BSD flavors follows [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/latest/) today.
+The most of desktop environments on Linux and BSD flavors follow [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/latest/) today.
 The goal of **desktopfile** library is to provide implementation of this specification in D programming language.
 Please feel free to propose enchancements or report any related bugs to *Issues* page.
 
@@ -20,10 +20,10 @@ The library is crossplatform for the most part, though there's little sense to u
 **desktopfile** provides basic features like reading and executing desktop files, and more:
 
 * [Exec](http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s06.html) value unquoting and unescaping. Expanding field codes.
-* Can rewrite desktop files preserving all comments and the original order of groups.
+* Can rewrite desktop files preserving all comments and the original order of groups [as required by spec](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s02.html).
 * Retrieving [Desktop file ID](http://standards.freedesktop.org/desktop-entry-spec/latest/ape.html).
 * Support for [Additional application actions](http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s10.html).
-* Determining default terminal command to run applications with Terminal=true. Note that default terminal detector may not work properly on particular system since there's no standard way to find default terminal emulator that would work on every distribution and desktop environment.
+* Determining default terminal command to run applications with Terminal=true. Note that default terminal detector may not work properly on particular system (e.g. Fedora which does not have xterm installed by default) since there's no standard way to find default terminal emulator that would work on every distribution and desktop environment. If you strive for better terminal emulator detection you may look at [xdg-terminal.sh](https://src.chromium.org/svn/trunk/deps/third_party/xdg-utils/scripts/xdg-terminal).
 
 ### Missing features
 
@@ -32,7 +32,7 @@ Features that currently should be handled by user, but may be implemented in the
 * [D-Bus Activation](http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s07.html).
 * Startup Notification Protocol.
 * Copying files to local file system when %f field code is used.
-* Starting several instances of application if it supports only %f and not %F.
+* Starting several instances of application if it supports only %f or %u and not %F or %U.
 
 ## Generating documentation
 
@@ -119,7 +119,7 @@ catch (IniLikeException e) { //Parsing error - file is not desktop file or has e
 
 ## Examples
 
-### Desktop util
+### [Desktop util](examples/desktoputil/source/app.d)
 
 Utility that can parse, execute and rewrites .desktop files.
 
@@ -151,7 +151,7 @@ Read basic information about desktop file:
 
     dub run desktopfile:desktoputil -- read /usr/share/applications/kde4/kate.desktop
 
-### Desktop test
+### [Desktop test](examples/desktoptest/source/app.d)
 
 Parses all .desktop files in system's applications paths (usually /usr/local/share/applicatons and /usr/share/applications) and on the user's Desktop.
 Writes errors (if any) to stderr.
@@ -172,7 +172,7 @@ Example using cmd on Windows (KDE installed):
     set KDE_SHARE="%SYSTEMDRIVE%\ProgramData\KDE\share"
     dub run desktopfile:desktoptest -- %KDE_SHARE%\applications %KDE_SHARE%\templates %KDE_SHARE%\desktop-directories %KDE_SHARE%\autostart
 
-### Shoot desktop file
+### [Shoot desktop file](examples/shootdesktop/source/app.d)
 
 Uses the alternative way of starting desktop file. Instead of constructing DesktopFile object it just starts the application or opens link after read enough information from file.