--- parser3/operators.txt	2003/11/11 08:01:33	1.139
+++ parser3/operators.txt	2004/03/01 13:46:45	1.156
@@ -92,7 +92,11 @@ Xне сделано, видимо, не будет сделано
         default as-is
     !^taint[[lang]][код]
         default "just tainted, language unknown"
-    !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[во что переименовать @main]
+    !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[
+        $.main[во что переименовать @main]
+        $.file[имя файла из которого, якобы, данный текст]
+        $.lineno(номер строки в файле, откуда данный текст. можно отрицательный) 
+    ]
     !^process..[путь][во что переименовать @main]
       по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
@@ -119,6 +123,7 @@ Xне сделано, видимо, не будет сделано
             NLS_ISO_CURRENCY  ISO currency symbol
             NLS_SORT  sort sequence
             ORA_ENCRYPT_LOGIN=TRUE
+            ClientCharset=parser-charset << charset in which parser thinks client works
 
         !odbc://DSN=dsn^;UID=user^;PWD=password
 
@@ -151,10 +156,11 @@ odbc    c:\drives\y\parser3project\odbc\
         ставить такой префикс перед открывающим апострофом, впритык, везде без проблелов
         /**имя_поля**/'literal'
     !^rem{}
-    !^cache[файл](секунд){код}
+    !^cache[файл](секунд){код}[{catch код}]
         !относительное задание времени
         !скэшировать строку, которая получается при выполнении кода на 'секунд' секунд
         !если 0секунд, значит не кэшировать, а старый такой стереть
+        !в catch коде $exception.handled[cache]  ^rem{флаг, что exception обработан}
     !^cache[файл][expires date]{код}
         !абсолютное задание времени
     X^cache[файл] удалить файл [не ругает, если его нет] // такое было, больше не будет, делать ^cache(0)
@@ -299,6 +305,8 @@ odbc    c:\drives\y\parser3project\odbc\
     !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены
         полезно делать перед сложными match операциями, если вы знаете, что входная строка
         состоит из большого числа фрагментов
+    !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца
+        default 'chars' -- whitespace chars
 
 !table
     в выражении 
@@ -369,7 +377,7 @@ odbc    c:\drives\y\parser3project\odbc\
     !^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]]
         получается hash(ключи=значения первая колонка ответа)
         of hash(ключи=названия остальных колонкок ответа)
-    !^hash._keys[]+ таблица из одного столбца $key
+    !^hash._keys[[название колонки с ключами]]+ таблица из одного столбца $key или как передадут
     !^hash._count[]
     !^foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^delete[ключ]  удалить ключ
@@ -390,7 +398,7 @@ odbc    c:\drives\y\parser3project\odbc\
     !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
 
     пример:
-    $uids[^hashfile::assign[/db/uids]]
+    $uids[^hashfile::open[/db/uids]]
     
     $random[23847387taduigh345XGHWElxjgdjg]
     $uids.$random[$.value[$uid] $.expires(1)]
@@ -623,6 +631,8 @@ odbc    c:\drives\y\parser3project\odbc\
         определяющее прожорливость выделялки цветов из палитры [default=150]
             меньше - точнее приближает цвета, но они быстро кончаются
             больше - неточно приближает цвет, но бОльшей части хватит
+    !^картинка.pixel(x;y)[(color)]
+        узнать или задать цвет пиксела
 
 !file
     !$файл_из_post.name 
@@ -714,7 +724,7 @@ odbc    c:\drives\y\parser3project\odbc\
     !^date.sql-string[] %Y-%m-%d %H:%M:%S
         where published='$дата.sql-string[]'
     !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу 
-        столбцы: 0..6, week, weekyear
+        столбцы: 0..6, week, year
     !^date:calendar[rus|eng;год;месяц;день] выдаёт именнованную таблицу
         столбцы: year, month, day, weekday
     
@@ -777,10 +787,17 @@ xdoc(xnode)
         выдаёт media-type при подстановке $response:body[сюда]
 
 
+	!если на документ ссылаются так:
+	    parser://method/param/to/that/method
+	    то в качестве документа используется ^MAIN:method[/param/to/that/method]
+	    [примечание: в параметр всегда приходит лидирующая /, даже, если параметров вообще не было]
+
 !xnode
     DOM1 attributes:
     !$node.nodeName
     !$node.nodeValue
+    	!read
+    	!write
     !$node.nodeType = int
       ELEMENT_NODE                   = 1 
       ATTRIBUTE_NODE                 = 2 
@@ -919,11 +936,6 @@ xdoc(xnode)
             file    time
             file    time
             file    time
-    !$status:charset hash
-        !cache table
-            file
-            file
-            file
 
     !$status:rusage hash
         !utime user time used
@@ -950,6 +962,9 @@ xdoc(xnode)
             Return the total number of bytes [EVER(c)PAF] allocated in this process.		
             Never decreases.							
 
+    !$status:pid process id
+    !$status:tid thread id
+
 console
     $console:timeout
     !$console:line