OMK is an advanced make system written entirely in GNU make. Compiling
software using OMK requires only GNU make binary and standard UNIX
-utilities installed. OMK aims to be developer friendly; to use OMK,
-you do not need to understand (sometiles) cryptic syntax of makefile
-commands.
+utilities (@command{sh}, @command{sed} and
+@command{tr}@footnote{@command{tr} is needed only for OMK to be
+compatible with MinGW.}) installed. OMK aims to be developer friendly; to
+use OMK, you do not need to understand (sometimes) cryptic syntax of
+makefile commands.
+
+OMK handles properly dependencies of source files and libraries, so it
+is not necessary to recompile the whole project if only some files are
+changed. Also OMK greatly simplifies compilation of projects, where
+source files are spread between multiple directories. It is also very
+useful in combining components (libraries) from different projects to a
+single project.
+
+You can use OMK on all platforms where you can run GNU Make including
+Cygwin and MinGW. MS DOS was not tested.
+
+@c @section Features
+
+@c @itemize
+@c @item
+@c Easy to use for beginners.
+@c @item
+@c Automatic handling of dependencies.
+@c @item
+@c Supported host platforms: all Un*x operating system including Linux,
+@c Cygwin, MS DOS and maybe others.
+@c @end itemize
@section Quick Start
+If you get some sources, which are distributed with OMK, usually the
+following commands are sufficient to compile the whole project.
+
+@example
+@verbatim
+make default-config
+make
+@end verbatim
+@end example
+
+To use OMK in your own project, follow these steps:
+
+@enumerate
+@item
+ Take appropriate @file{Makefile.rules}, put it together with leaf
+ @file{Makefile} to the root directory of your project.
+@item
+ Create @file{Makefile.omk} files in all directories you want to
+ compile something. Please refer to chapter ... to learn what to write
+ in @file{Makefile.omk} files.
+@item
+ Run @command{make omkize} in the root directory.
+@end enumerate
+
+Your project is now ready to compile.
+
+
@node History
@section History
project. Several individual developers (mostly from Czech Technical
University) liked it and started to use it.
-As number of users grew it was necessary to modularize the make system
-to support more ``targets''. Michal Sojka took care about the process
-of modularization.
+As a number of projects using OMK grew it was necessary to modularize
+the make system to support more ``targets''. Michal Sojka took care
+about the process of modularization.
@chapter Original README
file should be used for building of own @file{config.omk} file, or as
list for all options if Kconfig is used.
-@chapter OMK User Manual
+@chapter OMK User's Manual
@section Basic Concepts
@section Configuration and Conditional Compilation
+@section Running OMK under Windows OS
+
@chapter OMK Reference
@chapter OMK Development