Rephrased documentation for better readability

[fifth.git] / doc / index.org

diff --git a/doc/index.org b/doc/index.org
index 4d9c4a0..c370a29 100644 (file)
--- a/doc/index.org
+++ b/doc/index.org
@@ -34,8 +34,9 @@ Fifth is a combination of:
 - [[id:da7fff9b-0b67-4843-828a-52a404d7f401][Programming language]] (inspired by Forth).
 - Operating system.
 - [[id:9b251eb9-aff6-4025-94bf-25e89e26d54a][Virtual machine]] with custom instruction set.
-- [[file:5TH_ET.txt][Example Fifth source file - text editor]]
-** screenshots
+
+** Screenshots
+
 [[file:screenshots/start.png]]
 
 Startup screen diplaying Fifth logo and full file list.
@@ -43,8 +44,8 @@ Startup screen diplaying Fifth logo and full file list.
 [[file:screenshots/dictionary.png]]
 
 Sample words defined. Most of the words are commands that can be
-executed interactively from command line or from file. When executed
-they can be selectively compiled or interpreted.
+executed interactively from the command line or from a file. When
+executed, they can be selectively compiled or interpreted.
 
 
 [[file:screenshots/text editor.png]]
@@ -53,11 +54,16 @@ Built in text editor.
 
 * Installation
 Just unpack all files, witout altering original directory structure,
-somewhere in your hard disk. For example: C:\MISC\FIFTH\....  To run
-fifth you need minimally just 2 files.  emulator itself ( EMULATOR.EXE
-or EMULATOR.COM ), and virtual disk file ( DISK.RAW ).
+somewhere in your hard disk. For example:
+
+: C:\MISC\FIFTH\
 
-Read more about [[id:0759f3e0-28bb-4901-9e4f-09ef41732173][Fifth distribution directory tree description]].
+To run fifth you need minimally just 2 files:
+- EMULATOR.COM :: Virtual CPU emulator
+- DISK.RAW :: Virtual disk file
+
+For more information, please refer to [[id:0759f3e0-28bb-4901-9e4f-09ef41732173][Fifth distribution directory
+tree description]].
 
 * Fifth distribution directory tree description
 :PROPERTIES:
@@ -84,20 +90,19 @@ tree similar to this:
 
 * Requirements
 ** Software
-- MS-DOS 6.22, with HIMEM.SYS loaded.
-- Mouse driver if you have a mouse.
-- Does work only when CPU is in real mode.
-- To recompile ASM sources I used FASM (Flat Assembler).
-- I ran QBasic utilities on QB 4.5 .
-- VESA support by BIOS, or external driver (UNIVBE).
+- MS-DOS 6.22 with HIMEM.SYS loaded.
+- Mouse driver (optional, if you have a mouse).
+- CPU is initialized into [[https://en.wikipedia.org/wiki/Unreal_mode][Unreal Mode]] during operation.
+- To recompile ASM sources, you can use FASM (Flat Assembler).
+- To run Quick Basic utilities, use Microsoft Quick Basic 4.5.
+- VESA support through BIOS or external driver (UNIVBE).
+
 ** Hardware
-- Minimum CPU 386.
-- 64 KB free RAM below 640KB,
-- 2 MB of free XMS.
-- VESA compatible video card.
-** Human
-- Beginner level Forth knowledge is recommended.
-- Lots of enthusiasm.
+- A minimum of a i386 CPU.
+- 64 KB of free RAM below 640KB.
+- 2 MB of free [[https://en.wikipedia.org/wiki/Extended_memory][extended memory]].
+- A VESA-compatible video card.
+
 * Numbers representation within Fifth
 
 Because we are in full experimentation mode here (no regard for