Update OtherTools page

Author: michaliskambi

src/OtherTools.asciidoc

@@ -1,48 +1,53 @@
 :doctitle: Other Tools Developed Here
+:sectnums:
+:toc: left
+:toclevels: 4
 
-Subdirectory source/tools/ inside link:index[PasDoc] sources
+## Introduction
+
+Subdirectory `source/tools/` inside link:index[PasDoc] sources
 contains some useful programs related to PasDoc. They are either small
 programs helpful for development of PasDoc, or tools that use PasDoc
 units to do other tasks.
 
 ## [[file_to_pascal_string]] file_to_pascal_string
 
-Converts any text file into a Pascal string, so that you can compile
-text files inside your program.
+Converts any text file into a Pascal string.
+This allows to embed contents of any text file into a compiled program.
 
 ## [[file_to_pascal_data]] file_to_pascal_data
 
-Converts any file into a Pascal array of bytes, so that you can compile
-binary files inside your program.
+Converts any file into a Pascal array of bytes.
+This allows to embed contents of any binary file into a compiled program.
 
 ## [[pascal_pre_proc]] pascal_pre_proc
 
-Pascal preprocessor. It reads the Pascal source file given on the
+Pascal preprocessor. Rreads the Pascal source file given on the
 command-line, and outputs it's processed version to the standard output.
 Features (all inherited from pasdoc tokenizer and scanner):
 
-* Handles $ifdef and related constructs
+* Handles `$ifdef` and related constructs, see link:ConditionalDefines[conditional expressions support].
 
 * Handles FPC macros (very useful if you want to use FPC source code using macros in Delphi)
-* Handles $include
+
+* Handles `$include`
+
 * Preserves whitespace
 
 The preprocessor behavior can be configured by a couple of command-line
 options, a subset of link:CommandLine[PasDoc command line options].
-Run pascal_pre_proc --help to get a list of supported options. Examples
+Run `pascal_pre_proc --help` to get a list of supported options. Examples
 of use:
 
 * Basic test of handling macros using ok_macros.pas file from pasdoc tests:
 +
 ----
 pascal_pre_proc pasdoc/tests/ok_macros.pas
 ----
-* Generate a single (without any $includes and $ifdefs) source code of the SysUtils unit for Linux/i386 target from FPC sources:
+* Generate a single (without any `$include`, `$ifdef` etc.) source code of the SysUtils unit for Linux/i386 target from FPC sources:
 +
 ----
 pascal_pre_proc unix/sysutils.pp \
  -I objpas/sysutils/ -I inc/ -I i386/ -I ./linux/ \
  -D UNIX -D cpui386 > linux_i386_sysutils.pas
 ----
-+
-Note that this is not perfect. because proper handling of $if and $elseif conditions is not implemented yet.

src/index.asciidoc

@@ -118,10 +118,10 @@ In short, just call
 ----
 git clone https://github.com/pasdoc/pasdoc.git
 ----
-* See link:CompilingPasDoc[CompilingPasDoc] for instructions how to compile PasDoc.
-* See link:ReleaseMaking[ReleaseMaking] to know how we test and package PasDoc for final releases.
+* See link:CompilingPasDoc[compiling PasDoc] for instructions how to compile PasDoc.
+* See link:ReleaseMaking[release making] to know how we test and package PasDoc for final releases.
 
-While developing PasDoc we also developed some link:OtherTools[OtherTools] that you may find useful.
+While developing PasDoc we also developed some link:OtherTools[other tools, like Pascal preprocessor] that you may find useful.
 
 About these web pages: