From eb7b2475c8c79eabe4ad9f84a7fc6a31de34839e Mon Sep 17 00:00:00 2001
From: "Evgeny Grechnikov (Diamond)" <diamondz@land.ru>
Date: Fri, 19 Oct 2007 11:18:55 +0000
Subject: [PATCH] updated loader_doc.txt

git-svn-id: svn://kolibrios.org@657 a494cfbc-eb01-0410-851d-a64ba20cac60
---
 kernel/trunk/docs/loader_doc.txt | 52 ++++++++++++++++++++++++--------
 1 file changed, 39 insertions(+), 13 deletions(-)

diff --git a/kernel/trunk/docs/loader_doc.txt b/kernel/trunk/docs/loader_doc.txt
index bdd55c40ab..d1e57e4a19 100644
--- a/kernel/trunk/docs/loader_doc.txt
+++ b/kernel/trunk/docs/loader_doc.txt
@@ -1,7 +1,23 @@
+; (english text below)
+
+;------------------------------------------
+; Интерфейс сохранения параметров
+;------------------------------------------
+Если при передаче управления ядру загрузчик устанавливает AX='KL',
+то в DS:SI ядро ожидает дальнего указателя на следующую структуру:
+        db      версия структуры, должна быть 1
+        dw      флаги:
+                бит 0 установлен = присутствует образ рамдиска в памяти
+        dd      дальний указатель на процедуру сохранения параметров
+                может быть 0, если загрузчик не поддерживает
+Процедура сохранения параметров должна записать первый сектор ядра
+kernel.mnt назад на то место, откуда она его считала; возврат из
+процедуры осуществляется по retf.
+
 ;------------------------------------------
 ; Указание загрузчиком системного каталога
 ;------------------------------------------
-Перед передачей управления ядру могут быть установленны следующие регистры:
+Перед передачей управления ядру могут быть установлены следующие регистры:
 CX='HA'
 DX='RD'
 Это указывает на то, что регистр BX указывает на системный раздел. Каталог /kolibri/ на
@@ -16,7 +32,7 @@ DX='RD'
 'm' - Приводы CD-ROM
 
 Возможные значения регистра BH (указывает на раздел):
-для BL='a','b','c','d','r' - указывает на наздел, где расположен системный каталог
+для BL='a','b','c','d','r' - указывает на раздел, где расположен системный каталог
 для BL='m',указывает на номер физического устройства, с которого надо начинать поиск системного каталога.
 
 примеры значений регистра BX:
@@ -28,18 +44,30 @@ DX='RD'
 'r1' - /rd/1/
 
 
+;------------------------------------------
+; Interface for saving boot-screen settings
+;------------------------------------------
+If a loader sets AX='KL' when transferring control to the kernel,
+the kernel expects in DS:SI far pointer to the following structure:
+        db      structure version, must be 1
+        dw      flags
+                bit 0 set = ramdisk image in memory is present
+        dd      far pointer to save settings procedure
+                may be 0 if such procedure is not supported by loader
+Procedure for saving settings must write the first sector of the kernel
+kernel.mnt back to the place, from where it has been read; return from
+this procedure must be with retf.
 
-	
 ;------------------------------------------ 
-; Note boot system directory
+; System directory information from loader
 ;------------------------------------------ 
-The transfer of the kernel can be installed following registers:
+Before transfer of control to the kernel following registers can be set:
 CX = 'HA'
 DX = 'RD'
-This indicates that the register BX points to a system partition. Catalog /kolibri/ in
-this section is system, it is treated as a /sys/
+This indicates that the register BX identifies system partition. The folder /kolibri/ in
+this partition is system folder, it can be referenced as /sys/
 
-Possible values register BL (indicates the device):
+Possible values for register BL (indicates the device):
 'a' - Primary Master
 'b' - Primary Slave
 'c' - Secondary Master
@@ -47,8 +75,8 @@ Possible values register BL (indicates the device):
 'r' - RAM disc
 'm' - ROM drives
 
-Possible values register BH (indicating section):
-for BL = 'a', 'b', 'c', 'd', 'r' to denote nazdel where the system folder
+Possible values for register BH (indicates section):
+for BL = 'a', 'b', 'c', 'd', 'r' to denote partition where the system folder
 for BL = 'm', indicates the number of physical devices, which must begin a systematic search directory.
 
 Examples of register BX:
@@ -56,7 +84,5 @@ Examples of register BX:
 'a2' - /hd0/2/
 'b1' - /hd1/1/
 'd4' - /hd3/4/
-'m0' - search directory sidyukam kolibri
+'m0' - search directory 'kolibri' by all CD-ROMs
 'r1' - /rd/1/
-
-Переведено Google
\ No newline at end of file