core: add debug option "-d" in command /eval (issue #1434)

1 files changed, 61 insertions, 60 deletions

diff --git a/doc/pl/autogen/user/weechat_commands.adoc b/doc/pl/autogen/user/weechat_commands.adoc
index c6071c42a..ae2e8b6cf 100644
--- a/doc/pl/autogen/user/weechat_commands.adoc
+++ b/doc/pl/autogen/user/weechat_commands.adoc
@@ -263,71 +263,72 @@ infolists: wyświetla informacje o infolistach
 * `+eval+`: przetwórz wyrażenie
 
 ----
-/eval  [-n|-s] <wyrażenie>
-       [-n] -c <wyrażenie1> <operator> <wyrażenie2>
-
-        -n: wyświetla wynik bez wysyłania go do buforu (tryb debugowania)
-        -s: podziel wyrażenie przed przetworzeniem go (wiele komend może być oddzielonych średnikami)
-        -c: przetwarza jako warunek: użyj operatorów i nawiasów, zwraca wartość logiczną ("0" lub "1")
-wyrażenie: wyrażenie do przetworzenia, zmienne o formacie ${zmienna} są zastępowane (zobacz niżej); wiele komend można oddzielić średnikami
-  operator: operator logiczny lub porównania:
-            - operatory logiczne:
-                &&  logiczne "i"
-                ||  logiczne "lub"
-            - operatory porównania:
-                ==  równy
-                !=  różny
-                <=  mniejszy lub równy
-                <   mniejszy
-                >=  większy lub równy
-                >   większy
-                =~  pasuje do rozszerzonego wyrażenia regularnego POSIX
-                !~  NIE pasuje do rozszerzonego wyrażenia regularnego POSIX
-                =*  pasuje do maski (dzika karta "*" dozwolona)
-                !*  NIE pasuje do maski (dzika karta "*" dozwolona)
-
-Wyrażenie jest uznawane za „prawdziwe” jeśli nie jest NULL, nie jest puste, oraz różni się od "0".
-Porównania dokonuje się z użyciem liczb całkowitych jeśli oba wyrażenia są liczbami całkowitymi, w jednym z następujących formatów:
-  - liczby całkowite (przykłady: 5, -7)
-  - liczby zmiennoprzecinkowe (przykłady: 5.2, -7.5, 2.83e-2)
-  - liczby szesnastkowe (przykłady: 0xA3, -0xA3)
-W celu wymuszenia porównywania ciągów, należy umieścić każde wyrażenie w cudzysłowie, na przykład:
+/eval  [-n|-s] [-d] <expression>
+       [-n] [-d] -c <expression1> <operator> <expression2>
+
+        -n: display result without sending it to buffer (debug mode)
+        -s: split expression before evaluating it (many commands can be separated by semicolons)
+        -d: display debug output after evaluation
+        -c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
+expression: expression to evaluate, variables with format ${variable} are replaced (see below); many commands can be separated by semicolons
+  operator: a logical or comparison operator:
+            - logical operators:
+                &&  boolean "and"
+                ||  boolean "or"
+            - comparison operators:
+                ==  equal
+                !=  not equal
+                <=  less or equal
+                <   less
+                >=  greater or equal
+                >   greater
+                =~  is matching POSIX extended regex
+                !~  is NOT matching POSIX extended regex
+                =*  is matching mask (wildcard "*" is allowed)
+                !*  is NOT matching mask (wildcard "*" is allowed)
+
+An expression is considered as "true" if it is not NULL, not empty, and different from "0".
+The comparison is made using floating point numbers if the two expressions are valid numbers, with one of the following formats:
+  - integer (examples: 5, -7)
+  - floating point number (examples: 5.2, -7.5, 2.83e-2)
+  - hexadecimal number (examples: 0xA3, -0xA3)
+To force a string comparison, you can add double quotes around each expression, for example:
   50 > 100      ==> 0
   "50" > "100"  ==> 1
 
-Niektóre zmienne w wyrażeniach są zamieniane, poprzez zastosowanie formatu ${zmienna}, według priorytetu zmienną może być:
-  1. przetworzony ciąg (format: "eval:xxx")
-  2. ciąg z wyescapowanymi znakami (format: "esc:xxx" lub "\xxx")
-  3. ciąg ze znakami do ukrycia (format: "hide:char,string")
-  4. ciąg o maksymalnej długości (format: "cut:max,suffix,string" lub "cut:+max,suffix,string")
-     lub maksymalna ilość znaków wyświetlanych na ekranie (format: "cutscr:max,suffix,string" lub "cutscr:+max,suffix,string")
-  5. odwrócony ciąg (format: "rev:xxx")
-  6. powtórzony ciąg (format: "repeat:ilość,ciąg")
-  7. długość ciągu (format: "length:xxx" or "lengthscr:xxx")
-  8. kolor (format "color:xxx", zobacz „Opis API wtyczek”, funkcja "color")
-  9. modyfikator (format: "modifier:name,data,string")
-  10. informacja (format: "info:nazwa,argumenty", argumenty są opcjonalne)
-  11. obecna data/czas (format: "date" lub "date:format")
-  12. zmienna środowiskowa (format: "env:XXX")
-  13. wyrażenie warunkowe (format: "if:condition?value_if_true:value_if_false")
-  14. wynik wyrażenia z nawiasami i operatorami + - * / // % ** (format: "calc:xxx")
-  15. opcja (format: plik.sekcja.opcja)
-  16 zmienna lokalna w buforze
-  17. nazwa hdatay/zmiennej (wartość jest automatycznie konwertowana na ciąg znaków), domyślnie "window" i "buffer" wskazują na aktualne okno/bufor.
-Format dla hdata może być jednym z poniższych:
-  hdata.zmienna1.zmienna2...: inicjuje hdata (wskaźnik musi być znany), następnie wypytuje zmienne jedna po drugiej (inne hdata mogą być następne)
-  hdata[list].zmienna1.zmienna2...: inicjuje hdata z wykorzystaniem listy, na przykład:
-    ${buffer[gui_buffers].full_name}: pełna nazwa buforu w połączonej liście buforów
-    ${plugin[weechat_plugins].name}: nazwa pierwszej wtyczki w połączonej liście wtyczek
-  hdata[wskaźnik].zmienna1.zmienna2...: zacznij z hdata używając wskaźnika, na przykład:
-    ${buffer[0x1234abcd].full_name}: pełna nazwa buforu z tym wskaźnikiem (może zostać użyte w triggerach)
-Nazwy hdata i zmiennych, można znaleźć w  „Opisie API wtyczek”, funkcja "weechat_hdata_get".
-
-Przykłady (proste ciągi):
+Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
+  1. an evaluated sub-string (format: "eval:xxx")
+  2. a string with escaped chars (format: "esc:xxx" or "\xxx")
+  3. a string with chars to hide (format: "hide:char,string")
+  4. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
+     or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
+  5. a reversed string (format: "rev:xxx" or "revscr:xxx")
+  6. a repeated string (format: "repeat:count,string")
+  7. length of a string (format: "length:xxx" or "lengthscr:xxx")
+  8. a color (format: "color:xxx", see "Plugin API reference", function "color")
+  9. a modifier (format: "modifier:name,data,string")
+  10. an info (format: "info:name,arguments", arguments are optional)
+  11. current date/time (format: "date" or "date:format")
+  12. an environment variable (format: "env:XXX")
+  13. a ternary operator (format: "if:condition?value_if_true:value_if_false")
+  14. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
+  15. an option (format: "file.section.option")
+  16. a local variable in buffer
+  17. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
+Format for hdata can be one of following:
+  hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
+  hdata[list].var1.var2...: start with a hdata using a list, for example:
+    ${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
+    ${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
+  hdata[pointer].var1.var2...: start with a hdata using a pointer, for example:
+    ${buffer[0x1234abcd].full_name}: full name of the buffer with this pointer (can be used in triggers)
+For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
+
+Examples (simple strings):
   /eval -n ${info:version}                       ==> 0.4.3
   /eval -n ${env:HOME}                           ==> /home/user
   /eval -n ${weechat.look.scroll_amount}         ==> 3
-  /eval -n ${sec.data.freenode_password}        ==> secret
+  /eval -n ${sec.data.freenode_password}         ==> secret
   /eval -n ${window}                             ==> 0x2549aa0
   /eval -n ${window.buffer}                      ==> 0x2549320
   /eval -n ${window.buffer.full_name}            ==> core.weechat
@@ -343,7 +344,7 @@ Przykłady (proste ciągi):
   /eval -n ${length:test}                        ==> 4
   /eval -n ${calc:(5+2)*3}                       ==> 21
 
-Przykłady (warunki):
+Examples (conditions):
   /eval -n -c ${window.buffer.number} > 2 ==> 0
   /eval -n -c ${window.win_width} > 100   ==> 1
   /eval -n -c (8 > 12) || (5 > 2)         ==> 1