Update documentation, added wirnings for oldated functions

git-svn-id: svn://kolibrios.org@9995 a494cfbc-eb01-0410-851d-a64ba20cac60

kernel/trunk/docs/sysfuncr.txt

@@ -882,6 +882,9 @@ picture     rb  Xsize*Ysize*4  ; 32 бита
 ====================== Функция 18, подфункция 11 =====================
 ============= Получить информацию о дисковой подсистеме. =============
 ======================================================================
+
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
+
 Параметры:
   * eax = 18 - номер функции
   * ebx = 11 - номер подфункции
@@ -1255,8 +1258,8 @@ dd 1675
 Параметры:
   * eax = 18 - номер функции
   * ebx = 25 - номер подфункции
-  * ecx = 1 - номер подподфункции
+  * ecx = 1  - номер подподфункции
-  * edx = -1(для текущего окна) или PID приложения
+  * edx = -1 (для текущего окна) или PID приложения
 Возвращаемое значение:
   * eax = одна из констант положения окна
 
@@ -1264,8 +1267,8 @@ dd 1675
 Параметры:
   * eax = 18 - номер функции
   * ebx = 25 - номер подфункции
-  * ecx = 2 - номер подподфункции
+  * ecx = 2  - номер подподфункции
-  * edx = -1(для текущего окна) или PID приложения
+  * edx = -1 (для текущего окна) или PID приложения
   * esi = новое положение окна (одна из констант ниже)
 Возвращаемое значение:
   * eax = 0 - неудача
@@ -1285,15 +1288,17 @@ dd 1675
 ==================== Функция 20 - интерфейс MIDI. ====================
 ======================================================================
 
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
+
 ------------------------ Подфункция 1 - сброс ------------------------
 Параметры:
   * eax = 20 - номер функции
-  * ebx = 1 - номер подфункции
+  * ebx = 1  - номер подфункции
 
 -------------------- Подфункция 2 - вывести байт ---------------------
 Параметры:
   * eax = 20 - номер функции
-  * ebx = 2 - номер подфункции
+  * ebx = 2  - номер подфункции
   * cl = байт для вывода
 Возвращаемое значение (одинаково для обеих подфункций):
   * eax = 0 - успешно
@@ -1308,6 +1313,9 @@ dd 1675
 ======================================================================
 ==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
 ======================================================================
+
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
+
 Параметры:
   * eax = 21 - номер функции
   * ebx = 1 - номер подфункции
@@ -1486,6 +1494,9 @@ dd 1675
 ======================================================================
 ======= Функция 24, подфункция 4 - извлечь лоток привода диска. ======
 ======================================================================
+
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
+
 Параметры:
   * eax = 24 - номер функции
   * ebx = 4 - номер подфункции
@@ -1509,6 +1520,9 @@ dd 1675
 ======================================================================
 ====== Функция 24, подфункция 5 - загрузить лоток привода диска. =====
 ======================================================================
+
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
+
 Параметры:
   * eax = 24 - номер функции
   * ebx = 5 - номер подфункции
@@ -1550,6 +1564,9 @@ dd 1675
 ======================================================================
 ===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
 ======================================================================
+
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!! 
+
 Параметры:
   * eax = 26 - номер функции
   * ebx = 1 - номер подфункции
@@ -2091,42 +2108,10 @@ path    db  'HD0/1',0
 ---------------------- Константы для регистров: ----------------------
   eax - SF_SET_EVENTS_MASK (40)
 ======================================================================
-=================== Функция 43 - ввод/вывод в порт. ==================
-======================================================================
-
------------------------- Вывод данных в порт -------------------------
-Параметры:
-  * eax = 43 - номер функции
-  * bl = байт для вывода
-  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
-Возвращаемое значение:
-  * eax = 0 - успешно
-  * eax = 1 - поток не зарезервировал указанный порт
-
------------------------- Ввод данных из порта ------------------------
-Параметры:
-  * eax = 43 - номер функции
-  * ebx игнорируется
-  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
-Возвращаемое значение:
-  * eax = 0 - успешно, при этом ebx = введённый байт
-  * eax = 1 - поток не зарезервировал данный порт
-Замечания:
-  * Предварительно поток должен зарезервировать за собой
-    указанный порт функцией 46.
-  * Для зарезервированных портов вместо вызова этих функций
-    лучше использовать команды процессора in/out - это значительно
-    быстрее и несколько короче и проще. Из незарезервированных
-    портов читать всё равно нельзя.
-
----------------------- Константы для регистров: ----------------------
-  eax - SF_PORT_IN_OUT (43)
-======================================================================
 = Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
 ======================================================================
 К зарезервированным портам можно обращаться напрямую из приложения
-командами in/out (рекомендуемый способ) и вызовом функции 43
+командами in/out .
-(нерекомендуемый способ).
 Параметры:
   * eax = 46 - номер функции
   * ebx = 0 - зарезервировать, 1 - освободить
@@ -3017,6 +3002,9 @@ IPC применяется для посылок сообщений от одн
 ======================================================================
 ========== Функция 64 - перераспределить память приложения. ==========
 ======================================================================
+
+ !!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
+
 Параметры:
   * eax = 64 - номер функции
   * ebx = 1 - единственная подфункция

kernel/trunk/docs/sysfuncs.txt

@@ -872,6 +872,9 @@ Remarks:
 ======================================================================
  Function 18, subfunction 11 - get information on the disk subsystem.
 ======================================================================
+
+!!! WARNING. This interface is outdated and should not be used !!!
+
 Parameters:
   * eax = 18 - function number
   * ebx = 11 - subfunction number
@@ -1277,6 +1280,8 @@ Constant position of the window relative to other windows:
 ==================== Function 20 - MIDI interface. ===================
 ======================================================================
 
+!!! WARNING. This interface is outdated and should not be used !!!
+
 ----------------------- Subfunction 1 - reset ------------------------
 Parameters:
   * eax = 20 - function number
@@ -1300,6 +1305,9 @@ Remarks:
 ======================================================================
 ======== Function 21, subfunction 1 - set MPU MIDI base port. ========
 ======================================================================
+
+!!! WARNING. This interface is outdated and should not be used !!!
+
 Parameters:
   * eax = 21 - function number
   * ebx = 1 - subfunction number
@@ -1475,6 +1483,9 @@ Remarks:
 ======================================================================
 ======= Function 24, subfunction 4 - eject tray of disk drive. =======
 ======================================================================
+
+!!! WARNING. This interface is outdated and should not be used !!!
+
 Parameters:
   * eax = 24 - function number
   * ebx = 4 - subfunction number
@@ -1498,6 +1509,9 @@ Remarks:
 ======================================================================
 ======== Function 24, subfunction 5 - load tray of disk drive. =======
 ======================================================================
+
+!!! WARNING. This interface is outdated and should not be used !!!
+
 Parameters:
   * eax = 24 - function number
   * ebx = 5 - subfunction number
@@ -1539,6 +1553,9 @@ Remarks:
 ======================================================================
 ======== Function 26, subfunction 1 - get MPU MIDI base port. ========
 ======================================================================
+
+!!! WARNING. This interface is outdated and should not be used !!!
+
 Parameters:
   * eax = 26 - function number
   * ebx = 1 - subfunction number
@@ -2075,41 +2092,10 @@ Remarks:
 ---------------------- Constants for registers: ----------------------
   eax - SF_SET_EVENTS_MASK (40)
 ======================================================================
-================ Function 43 - input/output to a port. ===============
-======================================================================
-
------------------------- Output data to port -------------------------
-Parameters:
-  * eax = 43 - function number
-  * bl = byte for output
-  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
-Returned value:
-  * eax = 0 - success
-  * eax = 1 - the thread has not reserved the selected port
-
------------------------- Input data from port ------------------------
-Parameters:
-  * eax = 43 - function number
-  * ebx is ignored
-  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
-Returned value:
-  * eax = 0 - success, thus ebx = entered byte
-  * eax = 1 - the thread has not reserved the selected port
-Remarks:
-  * Previously the thread must reserve the selected port
-    for itself by function 46.
-  * Instead of call to this function it is better to use
-    processor instructions in/out - this is much
-    faster and a bit shorter and easier.
-
----------------------- Constants for registers: ----------------------
-  eax - SF_PORT_IN_OUT (43)
-======================================================================
 ====== Function 46 - reserve/free a group of input/output ports. =====
 ======================================================================
 To work with reserved ports an application can access directly by
-commands in/out (recommended way) and can use function 43
+commands in/out .
-(not recommended way).
 Parameters:
   * eax = 46 - function number
   * ebx = 0 - reserve, 1 - free
@@ -2987,6 +2973,9 @@ Returned value:
 ======================================================================
 ============== Function 64 - resize application memory. ==============
 ======================================================================
+
+!!! WARNING. This interface is outdated and should not be used !!!
+
 Parameters:
   * eax = 64 - function number
   * ebx = 1 - unique subfunction