README updates

4 files changed, 76 insertions, 72 deletions

diff --git a/utils/README.md b/utils/README.md
index c69617e..7dcf890 100644
--- a/utils/README.md
+++ b/utils/README.md
@@ -1,24 +1,30 @@
-# Service management utilities
+# Driver utilities
 
-Utilities used to manage (load, start, stop and unload) and communicate with
-drivers via virtual devices.
-Usage examples of some of the drivers in this repository are also included.
+A few usage examples are provided along with the drivers.
+Those include:
 
-* [libservice](libservice) — a simple service management library.
-  Also includes means of communicating with a driver via virtual devices.
-* [libnt_path_converter](libnt_path_converter) —
-  [nt_path_converter](../src/nt_path_converter) usage examples.
-* [libtest](libtest) — [test](../src/test) usage examples.
+* [libservice]: utilities to easily install/start/stop/uninstall drivers
+  (using Windows services),
+* [libtest]: [test] driver usage examples,
+* [libnt_path_converter]: [nt_path_converter] usage examples.
 
 ## Building
 
-I've used the compiler shipped with Visual Studio Express 2013 with Update 4
-for Windows Desktop.
+To build the utilities:
 
-You can generate the solution windows7_drivers_utils.sln using CMake and build
-it using Visual Studio.
+1. generate the solution windows7_drivers_utils.sln using CMake,
+2. build the solution using Visual Studio.
 
-## Licensing
+## License
 
 This project is licensed under the terms of the MIT License.
-See [Licensing](../README.md#licensing) for details.
+See [License] for details.
+
+
+
+[license]: ../README.md#license
+[libservice]: libservice/README.md
+[libtest]: libtest/README.md
+[test]: ../src/test
+[libnt_path_converter]: libnt_path_converter/README.md
+[nt_path_converter]: ../src/nt_path_converter
diff --git a/utils/libnt_path_converter/README.md b/utils/libnt_path_converter/README.md
index e401aaa..43375e0 100644
--- a/utils/libnt_path_converter/README.md
+++ b/utils/libnt_path_converter/README.md
@@ -1,33 +1,36 @@
-# libnt_path_converter
+# nt_path_converter driver utilities
 
-[nt_path_converter](../../src/nt_path_converter) usage examples.
+[nt_path_converter] driver usage examples.
 
-## Usage
+## Library
 
-### libnt_path_converter.lib
+[nt_path_converter] driver's virtual device is wrapped into a separate library
+`libnt_path_converter` using [libservice].
+`#include <libnt_path_converter/all.hpp>` and link with
+`libnt_path_converter.lib` to use the library.
 
-Wraps `nt_path_converter`'s virtual device interface using
-[libservice](../libservice).
-Include the headers by `#include`ing `libnt_path_converter/all.hpp`, which
-includes all the other header files.
+## Utilities
 
 ### convert_nt_path.exe
 
     Usage: convert_nt_path.exe [NT_PATH...]
 
 Converts a NT-style path to a DOS-style path.
-The NT namespace can be explored using the
-[WinObj](https://technet.microsoft.com/en-us/library/bb896657.aspx) utility.
-Usage example (assuming `nt_path_converter` is already loaded):
+The NT namespace can be explored using the [WinObj] utility.
+For example:
 
     > convert_nt_path.exe \Device\HarddiskVolume2\Windows
     C:\Windows
 
-## Building
+## See also
 
-See [Building](../README.md#building).
+* [Building]
+* [License]
 
-## Licensing
 
-This project is licensed under the terms of the MIT License.
-See [Licensing](../../README.md#licensing) for details.
+
+[building]: ../README.md#building
+[license]: ../../README.md#license
+[nt_path_converter]: ../../src/nt_path_converter
+[libservice]: ../libservice/README.md
+[WinObj]: https://technet.microsoft.com/en-us/library/bb896657.aspx
diff --git a/utils/libservice/README.md b/utils/libservice/README.md
index 8e25c2e..22c9388 100644
--- a/utils/libservice/README.md
+++ b/utils/libservice/README.md
@@ -1,39 +1,32 @@
-# libservice
+# Service management utilities
 
-Simple service management library and utilities.
+Utilities to easily install/start/stop/uninstall drivers using Windows
+services.
 
-## Usage
+## Library
 
-### libservice.lib
+`#include <libservice/all.hpp>` and link with `libservice.lib` to use the
+library.
 
-Include the headers by `#include`ing `libservice/all.hpp`, which includes all
-the other header files.
-
-For service management usage examples, see the utilities descriptions below.
-
-For virtual device usage examples, refer e.g. to
-[libnt_path_converter](../libnt_path_converter).
+## Utilities
 
 ### install_service.exe
 
     Usage: install_service.exe NAME SYS_PATH
 
 Installs a driver as a service.
-The service is started manually.
 The same as
 
-    sc create NAME type= kernel binPath= SYS_PATH
+    > sc create NAME type= kernel binPath= SYS_PATH
 
 ### start_service.exe
 
     Usage: start_service.exe NAME
 
-Starts a service (loading the corresponding driver).
+Starts the service `NAME` (loading the corresponding driver).
 The same as
 
-    net start NAME
-
-except that `start_service.exe` waits until the service is actually loaded.
+    > net start NAME
 
 ### stop_service.exe
 
@@ -42,9 +35,7 @@ except that `start_service.exe` waits until the service is actually loaded.
 Stops the service `NAME` (unloading the corresponding driver).
 The same as
 
-    net stop NAME
-
-except that `stop_service.exe` waits until the service is actually stopped.
+    > net stop NAME
 
 ### uninstall_service.exe
 
@@ -54,13 +45,14 @@ Uninstalls the service `NAME`, wiping the corresponding record from the
 registry.
 The same as
 
-    sc delete NAME
+    > sc delete NAME
+
+## See also
 
-## Building
+* [Building]
+* [License]
 
-See [Building](../README.md#building).
 
-## Licensing
 
-This project is licensed under the terms of the MIT License.
-See [Licensing](../../README.md#licensing) for details.
+[building]: ../README.md#building
+[license]: ../../README.md#license
diff --git a/utils/libtest/README.md b/utils/libtest/README.md
index dae0cfe..4992849 100644
--- a/utils/libtest/README.md
+++ b/utils/libtest/README.md
@@ -1,22 +1,22 @@
-# libtest
+# test driver utilities
 
-[test](../../src/test) usage examples.
+[test] driver usage examples.
 
-## Usage
+## Library
 
-### libtest.lib
+[test] driver's virtual device is wrapped into a separate library `libtest`
+using [libservice].
+`#include <libtest/all.hpp>` and link with `libtest.lib` to use the library.
 
-Wraps `test`'s virtual device interface using [libservice](../libservice).
-Include the headers by `#include`ing `libtest/all.hpp`, which includes all the
-other header files.
+## Utilities
 
 ### exchange_ints.exe
 
     Usage: exchange_ints.exe N
 
-Parses a given `unsigned int` and exchanges it with the value stored in
-driver's memory.
-Usage example (assuming `test` is already loaded):
+Parses its argument as an `unsigned int` and exchanges it with the one stored
+in [test] driver's memory.
+For example:
 
     > exchange_ints.exe 1
     42
@@ -27,11 +27,14 @@ Usage example (assuming `test` is already loaded):
     > exchange_ints.exe 100500
     32
 
-## Building
+## See also
 
-See [Building](../README.md#building).
+* [Building]
+* [License]
 
-## Licensing
 
-This project is licensed under the terms of the MIT License.
-See [Licensing](../../README.md#licensing) for details.
+
+[building]: ../README.md#building
+[license]: ../../README.md#license
+[test]: ../../src/test
+[libservice]: ../libservice/README.md