Updated documentation

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

kernel/trunk/docs/sysfuncr.txt

@@ -502,7 +502,7 @@
 ‚®§Άΰ ι ¥¬®¥ §­ η¥­¨¥:
   * δγ­<CEB3>ζ¨ο ­¥ Ά®§Άΰ ι ¥β §­ η¥­¨ο
 ‡ ¬¥η ­¨ο:
-  * ‚맮¢ ä㭪樨 ®¡ï§ â¥«¥­ ¯¥à¥¤ ¢ë§®¢®¬ ä㭪権 15.2 ¨ 15.5
+  * ‚맮¢ ä㭪樨 ®¡ï§ â¥«¥­ ¯¥à¥¤ ¢ë§®¢®¬ ¯®¤ä㭪権 2 ¨ 5.
   * „«ο ®΅­®Ά«¥­¨ο ν<>ΰ ­  (―®α«¥ § Ά¥ΰθ¥­¨ο α¥ΰ¨¨ <20>®¬ ­¤, ΰ ΅®β ξι¨ε α
     δ®­®¬) Άλ§λΆ ©β¥ ―®¤δγ­<CEB3>ζ¨ξ 3 ―¥ΰ¥ΰ¨α®Ά<C2AE>¨ δ®­ .
   * …αβμ ― ΰ­ ο δγ­<CEB3>ζ¨ο ―®«γη¥­¨ο ΰ §¬¥ΰ®Ά δ®­®Ά®£® ¨§®΅ΰ ¦¥­¨ο -
@@ -521,8 +521,8 @@
 ‡ ¬¥η ­¨ο:
   * ‘¬¥ι¥­¨¥ ¤«ο β®η<C2AE>¨ α <20>®®ΰ¤¨­ β ¬¨ (x,y) Άλη¨α«ο¥βαο <20> <EFBFBD>
     (x+y*xsize)*3.
-  * …᫨ 㪠§ ­­®¥ ᬥ饭¨¥ ¯à¥¢ëè ¥â ãáâ ­®¢«¥­­ë© ä㭪樥© 15.1 à §¬¥à,
+  * …᫨ 㪠§ ­­®¥ ᬥ饭¨¥ ¯à¥¢ëè ¥â ãáâ ­®¢«¥­­ë© ¯®¤ä㭪樥© 1
-    ¢ë§®¢ ¨£­®à¨àã¥âáï.
+    à §¬¥à, ¢ë§®¢ ¨£­®à¨àã¥âáï.
   * „«ο ®΅­®Ά«¥­¨ο ν<>ΰ ­  (―®α«¥ § Ά¥ΰθ¥­¨ο α¥ΰ¨¨ <20>®¬ ­¤, ΰ ΅®β ξι¨ε α
     δ®­®¬) Άλ§λΆ ©β¥ ―®¤δγ­<CEB3>ζ¨ξ 3 ―¥ΰ¥ΰ¨α®Ά<C2AE>¨ δ®­ .
   * …αβμ ― ΰ­ ο δγ­<CEB3>ζ¨ο ―®«γη¥­¨ο β®η<C2AE>¨ α δ®­®Ά®£® ¨§®΅ΰ ¦¥­¨ο -
@@ -566,8 +566,7 @@
 ‚®§Άΰ ι ¥¬®¥ §­ η¥­¨¥:
   * δγ­<CEB3>ζ¨ο ­¥ Ά®§Άΰ ι ¥β §­ η¥­¨ο
 ‡ ¬¥η ­¨ο:
-  * …᫨ 㪠§ ­­®¥ ᬥ饭¨¥ ¯à¥¢ëè ¥â ãáâ ­®¢«¥­­ë© ä㭪樥© 15.1 à §¬¥à,
+  * <20>஢¥àª¨ ª®à४⭮á⨠ᬥ饭¨ï ¨ à §¬¥à  ­¥ ¯à®¨§¢®¤¨âáï.
-    ¢ë§®¢ ¨£­®à¨àã¥âáï.
   * –Ά¥β <20> ¦¤®£® ―¨<E28095>ᥫο εΰ ­¨βαο <20> <EFBFBD> 3-΅ ©β­ ο Ά¥«¨η¨­  BBGGRR.
   * <20>¨<EFBFBD>ᥫ¨ δ®­®Ά®£® ¨§®΅ΰ ¦¥­¨ο § ―¨αλΆ ξβαο ―®α«¥¤®Ά β¥«μ­®
     α«¥Ά  ­ ―ΰ Ά®, αΆ¥ΰεγ Ά­¨§.
@@ -1822,16 +1821,16 @@ db 'Kolibri',0
   * …᫨ γ¤ «ο¥βαο  <>β¨Ά­λ© (γαβ ­®Ά«¥­­λ© ―®¤δγ­<CEB3>樥© 5) <20>γΰα®ΰ, β®
     Ά®ααβ ­ Ά«¨Ά ¥βαο <20>γΰα®ΰ ―® 㬮«η ­¨ξ (αβ ­¤ ΰβ­ ο αβ५<C2A5> ).
 
-------------------- <20>®¤äã­ªæ¨ï 7 - ¤ ­­ë¥ ¯à®ªàã⪨ --------------------
+------------------ <20>®¤äã­ªæ¨ï 7 - ¤ ­­ë¥ ¯à®ªàã⪨ -------------------
 <EFBFBD> ΰ ¬¥βΰλ:
   * eax = 37 - ­®¬¥ΰ δγ­<CEB3>樨
-  * ebx = 7 - ­®¬¥à ¯®¤ä㭪樨
+  * ebx = 6 - ­®¬¥à ¯®¤ä㭪樨
 ‚®§Άΰ ι ¥¬®¥ §­ η¥­¨¥:
-  * eax = horizontal_offset*65536 + vertical_offset
+  * eax = [horizontal offset]*65536 + [vertical offset]
 ‡ ¬¥η ­¨ο:
-  * „ ­­ë¥ ¤®áâ㯭ë ⮫쪮  ªâ¨¢­®¬ã ®ª­ã
+  * „ ­­ë¥ ¤®áâ㯭ë ⮫쪮  ªâ¨¢­®¬ã ®ª­ã.
-  * <20>®á«¥ ¯à®ç⥭¨ï §­ ç¥­¨ï ®¡­ã«ïîâáï
+  * <20>®á«¥ ¯à®ç⥭¨ï §­ ç¥­¨ï ®¡­ã«ïîâáï.
-  * „ ­­ë¥ ᮤ¥à¦ â §­ ª®¢ë¥ §­ ç¥­¨ï
+  * „ ­­ë¥ ¨¬¥îâ §­ ª®¢ë¥ §­ ç¥­¨ï.
 
 ======================================================================
 ================== ”γ­<CEB3>ζ¨ο 38 - ­ ΰ¨α®Ά βμ ®β१®<C2A7>. ==================
@@ -2919,7 +2918,6 @@ dword-
   * '/hd0/1/menuet/pics/tanzania.bmp',0
 „®αβγ―­λ¥ ―®¤δγ­<CEB3>樨:
   * ―®¤δγ­<CEB3>ζ¨ο 0 - ηβ¥­¨¥ δ ©« /― ―<C2A0>¨
-  * ¯®¤äã­ªæ¨ï 1 - ¯¥à¥§ ¯¨áì ä ©« 
   * ―®¤δγ­<CEB3>ζ¨ο 8 - LBA-ηβ¥­¨¥ α γαβΰ®©αβΆ 
   * ―®¤δγ­<CEB3>ζ¨ο 15 - ―®«γη¥­¨¥ ¨­δ®ΰ¬ ζ¨¨ ® δ ©«®Ά®© α¨α⥬¥
 
@@ -2984,29 +2982,6 @@ dword-
     ¨α―®«μ§γ©β¥ ―®¤δγ­<CEB3>ζ¨ξ 11 δγ­<CEB3>樨 18 ¨«¨
     η¨β ©β¥ α®®βΆ¥βαβΆγξ騥 ― ―<C2A0>¨ ―®¤δγ­<CEB3>樥© 1 δγ­<CEB3>樨 70.
 
-======================================================================
-============ ”ã­ªæ¨ï 58, ¯®¤äã­ªæ¨ï 1 - ¯¥à¥§ ¯¨á âì ä ©«. ===========
-======================================================================
-…᫨ ä ©« ­¥ áãé¥áâ¢ã¥â, ®­ ᮧ¤ ñâáï.
-…᫨ ä ©« áãé¥áâ¢ã¥â, ®­ ¯¥à¥§ ¯¨á뢠¥âáï.
-<EFBFBD> à ¬¥âàë:
-  * eax = 58 - ­®¬¥à ä㭪樨
-  * ebx = 㪠§ â¥«ì ­  ¨­ä®à¬ æ¨®­­ãî áâàãªâãàã
-”®à¬ â ¨­ä®à¬ æ¨®­­®© áâàãªâãàë:
-  * +0: dword: 1 = ­®¬¥à ¯®¤ä㭪樨
-  * +4: dword: ¨£­®à¨àã¥âáï (ãáâ ­ ¢«¨¢ ©â¥ ¢ 0)
-  * +8: dword: ç¨á«® ¡ ©â ¤«ï § ¯¨á¨
-  * +12 = +0xC: dword: 㪠§ â¥«ì ­  ¤ ­­ë¥ ¤«ï § ¯¨á¨
-  * +16 = +0x10: dword: 㪠§ â¥«ì ­  ¡ãä¥à ¤«ï à ¡®âë á¨á⥬ë
-    (4096 ¡ ©â)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ­¨ï ¨¬ñ­ 㪠§ ­ë ¢
-    ®¡é¥¬ ®¯¨á ­¨¨
-‚®§¢à é ¥¬®¥ §­ ç¥­¨¥:
-  * eax = 0 - ãᯥ譮, ¨­ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨á⥬ë
-  * ebx à §àãè ¥âáï
-‡ ¬¥ç ­¨ï:
-  * <20>â  äã­ªæ¨ï ãáâ à¥« , ¨á¯®«ì§ã©â¥ ¯®¤äã­ªæ¨î 2 ä㭪樨 70.
-
 ======================================================================
 ========= ”γ­<CEB3>ζ¨ο 58, ―®¤δγ­<CEB3>ζ¨ο 8 - LBA-ηβ¥­¨¥ α γαβΰ®©αβΆ . ========
 ======================================================================
@@ -3604,7 +3579,7 @@ Architecture Software Developer's Manual, Volume 3, Appendix B);
   * edx =  ¤ΰ¥α MSR
   * esi:edi = αβ ΰ訩:¬« ¤θ¨© dword
 ‚®§Άΰ ι ¥¬®¥ §­ η¥­¨¥:
-  * ebx:eax = ª®¯¨ï esi:edi
+  * äã­ªæ¨ï ­¥ ¢®§¢à é ¥â §­ ç¥­¨ï
 ‡ ¬¥η ­¨ο:
   * “<> § ­¨¥ Ά ecx ­¥αγι¥αβΆγξι¥£® ¨«¨ ­¥ΰ¥ «¨§®Ά ­­®£® ¤«ο ¤ ­­®£®
     ―ΰ®ζ¥αα®ΰ  MSR ―®Ά«¥ηρβ ¨α<C2A8>«ξη¥­¨¥ Ά ο¤ΰ¥, <20>®β®ΰ®¥ ―ਡμρβ ―®β®<CEB2>.
@@ -3806,7 +3781,7 @@ Architecture Software Developer's Manual, Volume 3, Appendix B);
 ―®¤δγ­<EFBFBD>樥© 3.
 
 ‚α¥ ―®¤δγ­<CEB3>樨 ―ਬ¥­¨¬λ β®«μ<C2AB>® <20> ―ΰ®ζ¥αα ¬/―®β®<CEB2> ¬, § ―γι¥­­λ¬
-¨§ ⥪ã饣® ä㭪樥© 58 ¨«¨ 70 á ãáâ ­®¢«¥­­ë¬ ä« £®¬ ®â« ¤ª¨.
+¨§ ⥪ã饣® ä㭪樥© 70 á ãáâ ­®¢«¥­­ë¬ ä« £®¬ ®â« ¤ª¨.
 <EFBFBD>β« ¤<EFBFBD>  ¬­®£®―®β®η­λε ―ΰ®£ΰ ¬¬ ―®<E28095>  ­¥ ―®¤¤¥ΰ¦¨Ά ¥βαο.
 <EFBFBD>®«­λ© α―¨α®<CEB1> ―®¤δγ­<CEB3>権:
   * ―®¤δγ­<CEB3>ζ¨ο 0 - ®―।¥«¨βμ ®΅« αβμ ¤ ­­λε ¤«ο ®β« ¤®η­λε α®®΅ι¥­¨©

kernel/trunk/docs/sysfuncs.txt

@@ -493,7 +493,7 @@ Parameters:
 Returned value:
   * function does not return value
 Remarks:
-  * Before calling functions 15.2 and 15.5 you should call this function
+  * Before calling subfunctions 2 and 5 you should call this function
     to set image size!
   * For update of the screen (after completion of a series of commands
     working with a background) call subfunction 3.
@@ -513,7 +513,7 @@ Returned value:
 Remarks:
   * Offset for a pixel with coordinates (x,y) is calculated as
     (x+y*xsize)*3.
-  * If the given offset exceeds size sets by function 15.1,
+  * If the given offset exceeds size set by subfunction 1,
     the call is ignored.
   * For update of the screen (after completion of a series of commands
     working with a background) call subfunction 3.
@@ -559,8 +559,7 @@ Parameters:
 Returned value:
   * function does not return value
 Remarks:
-  * If the block gets out abroad size sets by function 15.1,
+  * Offset and size are not checked for correctness.
-    the call is ignored.
   * Color of each pixel is stored as 3-bytes value BBGGRR.
   * Pixels of the background image are written sequentially
     from left to right, from up to down.
@@ -674,7 +673,7 @@ Parameters:
 Returned value:
   * eax = 0 - success
   * else eax = error code of the file system
-³àìå÷àíèÿ:
+Remarks:
   * All folders in the given path must exist, otherwise function
     returns value 5, "file not found".
 
@@ -1414,7 +1413,7 @@ Parameters:
 Returned value:
   * eax = 0 - success
   * eax = 1 - CD base is not defined
-³àìå÷àíèÿ:
+Remarks:
   * Previously CD base port must be defined by call to 
     subfunction 3 of function 21.
 
@@ -1797,16 +1796,16 @@ Remarks:
   * If the active cursor (set by subfunction 5) is deleted,
     the system restores the default cursor (standard arrow).
 
-------------------- Subfunction 7 - get scroll data --------------------
+------------------ Subfunction 7 - get scroll data -------------------
 Parameters:
   * eax = 37 - function number
   * ebx = 7 - subfunction number
 Returned value:
-  * eax = horizontal_offset*65536 + vertical_offset
+  * eax = [horizontal offset]*65536 + [vertical offset]
 Remarks:
-  * Scroll data is available for active window only
+  * Scroll data is available for active window only.
-  * Values are zeroized after reading
+  * Values are zeroed after reading.
-  * Values ara signed    
+  * Values are signed.
 
 ======================================================================
 ====================== Function 38 - draw line. ======================
@@ -2042,8 +2041,8 @@ Parameters:
     * bh = 0 - display in decimal number system
     * bh = 1 - display in hexadecimal system
     * bh = 2 - display in binary system
-    * áèòv 16-21 = how many digits to display
+    * bits 16-21 = how many digits to display
-    * áèòv 22-31 reserved and must be set to 0
+    * bits 22-31 reserved and must be set to 0
   * ecx = number (if bl=0) or pointer (if bl=1)
   * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
   * esi = 0xX0RRGGBB:
@@ -2893,7 +2892,6 @@ Examples:
   * '/hd0/1/menuet/pics/tanzania.bmp',0
 Existing subfunctions:
   * subfunction 0 - read file/folder
-  * subfunction 1 - rewrite file
   * subfunction 8 - LBA-read from device
   * subfunction 15 - get file system information
 
@@ -2959,29 +2957,6 @@ Remarks:
     use subfunction 11 of function 18 or
     read corresponding folder with subfunction 1 of function 70.
 
-======================================================================
-============= Function 58, subfunction 1 - rewrite file. =============
-======================================================================
-If the file does not exist, it is created.
-If the file exists, it is rewritten.
-Parameters:
-  * eax = 58 - function number
-  * ebx = pointer to the information structure
-Format of the information structure:
-  * +0: dword: 1 = subfunction number
-  * +4: dword: ignored (set to 0)
-  * +8: dword: number of bytes to write
-  * +12 = +0xC: dword: pointer to data to write
-  * +16 = +0x10: dword: pointer to buffer for system operations
-    (4096 bytes)
-  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
-    given in the general description
-Returned value:
-  * eax = 0 - success, otherwise file system error code
-  * ebx destroyed
-Remarks:
-  * This function is obsolete, use subfunction 2 of function 70.
-
 ======================================================================
 ========= Function 58, subfunction 8 - LBA-read from device. =========
 ======================================================================
@@ -3297,7 +3272,7 @@ Remarks:
 ============== Function 63 - work with the debug board. ==============
 ======================================================================
 The debug board is the global system buffer (with the size
-4096 bytes), to which any program can write (generally speaking,
+1024 bytes), to which any program can write (generally speaking,
 arbitrary) data and from which other program can read these data.
 By the agreement written data are text strings interpreted as
 debug messages on a course of program execution. The kernel in
@@ -3573,8 +3548,8 @@ Parameters:
   * edx = MSR address
   * esi:edi = high:low dword
 Returned value:
-  * ebx:eax = copy of esi:edi
+  * function does not return value
-³àìå÷àíèÿ:
+Remarks:
   * If ecx contains nonexistent or not implemented for this processor
     MSR, processor will generate an exception in the kernel, which
     will kill the thread.
@@ -3773,7 +3748,7 @@ If debugger does not want this, it must previously detach by
 subfunction 3.
 
 All subfunctions are applicable only to processes/threads started
-from the current by function 58 or 70 with set debugging flag.
+from the current by function 70 with set debugging flag.
 Debugging of multithreaded programs is not supported yet.
 The full list of subfunctions:
   * subfunction 0 - define data area for debug messages