# HG changeset patch
# Parent ae716670f1ff537fa8abe61d8bd82b6c5f91a5e2
doc: vastly improve the "First Steps" documentation to reflect all the recent improvements

diff --git a/doc/rathaxes/user/firststeps_en.tex b/doc/rathaxes/user/firststeps_en.tex
--- a/doc/rathaxes/user/firststeps_en.tex
+++ b/doc/rathaxes/user/firststeps_en.tex
@@ -31,6 +31,8 @@
 0.3 & 04/09/2011 & David Pineau & Quick fixes \\
 \hline
 0.4 & 07/19/2011 & Louis Opter & Add on overview of the generation of a driver \\
+\hline
+0.5 & 01/08/2012 & Louis Opter & Update to cover the latest improvements \\
 }
 
 \begin{document}
@@ -39,7 +41,7 @@
 
 \begin{abstract}
 \rtx\ is a Domain Specific Language to describes peripherals drivers. It
-compiles to kernel modules written in C for Linux, Windows and OpenBSD.
+compiles to kernel modules written in C for any defined Operating System.
 
 This document explains how to setup the \rtx\ compiler on Windows and Unix like
 platforms and generate your first peripheral driver.
@@ -59,9 +61,21 @@
 develop on \rtx\ itself from Windows you can also choose to install \rtx\ from
 the sources (i.e. without the installer).
 
-Although \rtx\ only generate drivers for Windows, Linux and OpenBSD it can be
-installed and used from others operating systems as well (including other BSDs
-and MacOS~X).
+\rtx\ doesn't need to be installed on the target operating system for driver
+generation. In other words, you can install \rtx\ on Windows and generate the
+sources of a Linux driver (from Windows).
+
+If you intend to write Windows drivers with \rtx\ you will also need to install
+the Microsoft Driver Development Kit.
+
+If you intend to build the driver source code generated by \rtx\ you will also
+need to install the required compiler tool-chain to build them. On Windows that
+would be the Microsoft Driver Development Kit; on Linux that would be the Linux
+sources and the GCC tool-chain.
+
+Finally, we made it very easy to build \rtx\ source files from a CMake
+``Makefile'', so you are highly encouraged to install \href{http://www.cmake.org/}{CMake}
+along with \rtx. CMake works on all the operating systems supported by \rtx.
 
 \subsection{Using the Windows installer}
 
@@ -71,9 +85,6 @@
 Download the \href{http://rathaxes.googlecode.com/files/rathaxes-latest.exe}{installer},
 then simply execute it and follow the instructions on your screen.
 
-To build and use the drivers generated by \rtx\ you will also need the
-Microsoft Driver Development Kit.
-
 \subsection{From the sources on Unix}
 
 If you are not on Windows you will have to install \rtx\ from a ``source