Translate comments to English and convert to UTF-8

programs/develop/libraries/console_coff/console.asm

@@ -1,6 +1,7 @@
-; <EFBFBD>㭪樨 ࠡ<><E0A0A1><EFBFBD> <20> <20><><EFBFBD>᮫<EFBFBD><E1AEAB> <20><><EFBFBD> <20>ணࠬ<E0AEA3> <20><><EFBFBD><EFBFBD><EFBFBD>਎<EFBFBD>
+; SPDX-License-Identifier: GPL-2.0
+; Functions for interaction with the console for KolibriOS programs
 ; diamond, 2006-2008
-
+; Copyright (C) 2006-2025 KolibriOS team
 
 format MS COFF
 
@@ -56,7 +57,7 @@ START:
         or      eax, -1
         ret     4
 
-; <EFBFBD><EFBFBD><EFBFBD>樠<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>᮫<EFBFBD>
+; Console initialization
 ; void __stdcall con_init(dword wnd_width, dword wnd_height,
 ;       dword scr_width, dword scr_height, const char* title);
 
@@ -271,13 +272,13 @@ con_write_length:
         pop     esi ebx
         ret     8
 
-; <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> ᨬ<><E1A8AC><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD> <20><><EFBFBD><EFBFBD> <20><>
-con.printfc.normal = 0   ; <EFBFBD><EFBFBD>ଠ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> ᨬ<><E1A8AC><EFBFBD>
+; Each character is classified as one of the following
+con.printfc.normal = 0   ; normal character
 con.printfc.percent = 1  ; '%'
 con.printfc.dot = 2      ; '.'
 con.printfc.asterisk = 3 ; '*'
 con.printfc.zero = 4     ; '0'
-con.printfc.digit = 5    ; <EFBFBD><EFBFBD><EFBFBD>㫥<EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD>
+con.printfc.digit = 5    ; non-null digit
 con.printfc.plus = 6     ; '+'
 con.printfc.minus = 7    ; '-'
 con.printfc.sharp = 8    ; '#'
@@ -376,24 +377,24 @@ con_printf:
         jmp     .normal
   .spec_begin:
         xor     ebx, ebx
-; bl = ⨯ <20><><EFBFBD><EFBFBD>樨:
-; 0 = <EFBFBD><EFBFBD>砫<EFBFBD>
-; 1 = <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>⠭ <20><><EFBFBD><EFBFBD>騩 0 <20> ᯥ<><E1AFA5>䨪<EFBFBD>樨 <20><>ଠ<EFBFBD><E0ACA0>
-; 2 = <EFBFBD><EFBFBD>⠥<EFBFBD> <20><><EFBFBD><EFBFBD> <20><>ਭ<EFBFBD>
-; 3 = <EFBFBD><EFBFBD>⠥<EFBFBD> <20><><EFBFBD><EFBFBD> <20><>筮<EFBFBD><E7ADAE><EFBFBD>
-; 4 = <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>⠭<EFBFBD> <20><><EFBFBD><EFBFBD> ࠧ<><E0A0A7><EFBFBD><EFBFBD> <20><><EFBFBD>㬥<EFBFBD><E3ACA5><EFBFBD>
-; 5 = <EFBFBD><EFBFBD>⠥<EFBFBD> <20><><EFBFBD><EFBFBD> ⨯<>
-; bh = 䫠<EFBFBD><EFBFBD>:
-; 1 = 䫠<EFBFBD> '#', <EFBFBD>뢮<EFBFBD><EFBFBD><EFBFBD><EFBFBD> 0/0x/0X
-; 2 = 䫠<EFBFBD> '-', <EFBFBD><EFBFBD>ࠢ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD>
-; 4 = 䫠<EFBFBD> '0', <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>ﬨ
-; 8 = 䫠<EFBFBD> 'h', <EFBFBD><EFBFBD><EFBFBD><EFBFBD>⪨<EFBFBD> <20><><EFBFBD>㬥<EFBFBD><E3ACA5>
+; bl = position type:
+; 0 = start
+; 1 = read leading 0 in format specification
+; 2 = read width field
+; 3 = read precision field
+; 4 = read argument size field
+; 5 =  read type field
+; bh = flags:
+; 1 = flag '#', output 0/0x/0X
+; 2 = flag '-', align left
+; 4 = flag '0', zero padding
+; 8 = flag 'h', short argument
         push    -1
 ; dword [esp+8] = precision
         push    -1
 ; dword [esp+4] = width
         push    0
-; byte [esp] = 䫠<EFBFBD> 0/'+'/' '
+; byte [esp] = flag 0/'+'/' '
   .spec:
         xor     eax, eax
         lodsb
@@ -529,7 +530,7 @@ con_printf:
   @@:
         push    edx
         xor     edx, edx
-; <EFBFBD><EFBFBD>᫮ <20> eax, <20>᭮<EFBFBD><E1ADAE><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>⥬<EFBFBD> <20><><EFBFBD>᫥<EFBFBD><E1ABA5><EFBFBD> <20> ecx
+; number in eax, radix in ecx
   @@:
         cmp     dword [esp+16+8], 0
         jnz     .print_num
@@ -1777,10 +1778,10 @@ con.data2image:
         mov     al, [esi+1]
         push    eax
         and     al, 0xF
-        mov     ebx, eax                ; 梥<EFBFBD> ⥪<><E2A5AA><EFBFBD>
+        mov     ebx, eax                ; text color
         pop     eax
         shr     al, 4
-        mov     ebp, eax                ; 梥<EFBFBD> 䮭<>
+        mov     ebp, eax                ; background color
         sub     ebx, ebp
         lodsb
         inc     esi
@@ -2188,7 +2189,7 @@ con_gets2:
         sub     ebx, 1
         jle     .ret
         mov     byte [esi], 0
-        xor     ecx, ecx                ; <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 㦥 <20><><EFBFBD><EFBFBD>񭭮<EFBFBD> <20><>ப<EFBFBD>
+        xor     ecx, ecx                ; length of the already entered string
         call    con.get_data_ptr
 .loop:
         call    con_getch2
@@ -2596,15 +2597,15 @@ con.wake:
         popad
         ret
 
-; <EFBFBD><EFBFBD>⮪ <20><><EFBFBD><EFBFBD> <20><><EFBFBD>᮫<EFBFBD>. <20><>ࠡ<EFBFBD><E0A0A1>뢠<EFBFBD><EBA2A0> <20><><EFBFBD><EFBFBD> <20> <20>뢮<EFBFBD>.
+; Console window thread. Handles input and output.
 con.thread:
-; <EFBFBD><EFBFBD>⮪ ॠ<><E0A5A0><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><> IPC, <20><><EFBFBD><EFBFBD>஥ <20>ᯮ<EFBFBD><E1AFAE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> ⮫쪮 <20><><EFBFBD> ⮣<>, <20>⮡<EFBFBD> <20><><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD> <20>뫮 "ࠧ<>㤨<EFBFBD><E3A4A8>"
+; The thread responds to IPC, which is used only so that it can be "waken up"
         push    40
         pop     eax
         push    0x80000067 ;  program dont getting events mouse, when it dont active
         pop     ebx
         int     0x40
-        xor     ebx,ebx     ;clear ebx
+        xor     ebx,ebx    ; clear ebx
         mov     al, 60
         mov     bl, 1
         mov     ecx, con.ipc_buf
@@ -3212,7 +3213,7 @@ con.draw_image:
 @@:
         int     0x40
         push    edx
-; <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>塞 <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>㭪<EFBFBD>
+; Calculate the height of the slider
         mov     ax, dx
         sub     eax, con.vscroll_btn_height
         mov     ecx, eax
@@ -3222,7 +3223,7 @@ con.draw_image:
         jae     @f
         mov     al, 5
 @@:
-; eax = <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>㭪<EFBFBD>. <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>塞 <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>㭪<EFBFBD>
+; eax = slider height. Calculate the slider position
         mov     [con.vscrollbar_size], eax
         xchg    eax, ecx
         sub     eax, ecx
@@ -3232,7 +3233,7 @@ con.draw_image:
         div     ebx
         pop     edx
         push    edx
-; ecx = <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD>㭪<EFBFBD>, eax = <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
+; ecx = slider height, eax = position
         add     eax, con.vscroll_btn_height
         mov     [con.vscrollbar_pos], eax
         mov     ebx, con.vscroll_bgr2
@@ -3331,8 +3332,8 @@ con.extended_numlock:
 
 cursor_esc      dd 27 + ('[' shl 8)
 
-; <EFBFBD> ⥪<>饩 ॠ<><E0A5A0><EFBFBD><EFBFBD>樨 <20><><EFBFBD>祭<EFBFBD><E7A5AD> <20><> 㬮<>砭<EFBFBD><E7A0AD> ⠪<><E2A0AA><EFBFBD>.
-; <EFBFBD> <20><><EFBFBD><EFBFBD>饬 <20><><EFBFBD>, <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>, <20><><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD>뢠<EFBFBD><EBA2A0><EFBFBD><EFBFBD> <20><><EFBFBD> <20><>ࠬ<EFBFBD><E0A0AC><EFBFBD><EFBFBD> <20><> ini-䠩<><E4A0A9> console.ini.
+; In the current implementation, the default values ​​are:
+; In the future, they may be read as parameters from the console.ini ini file.
 con.def_wnd_width   dd    80
 con.def_wnd_height  dd    25
 con.def_scr_width   dd    80