fset: add filters "h=xxx" and "he=xxx" to filter options by description (translated or in English)

1 files changed, 121 insertions, 119 deletions

diff --git a/doc/pl/autogen/user/fset_commands.adoc b/doc/pl/autogen/user/fset_commands.adoc
index ed4078797..5eefcf786 100644
--- a/doc/pl/autogen/user/fset_commands.adoc
+++ b/doc/pl/autogen/user/fset_commands.adoc
@@ -23,136 +23,138 @@
        -export [-help|-nohelp] <nazwa pliku>
        <filtr>
 
-       -bar: dodaj pomoc dla paska
-   -refresh: odświerza litę opcji, następnie cały ekran (komenda: /window refresh)
-        -up: przesuwa linie do góry o podaną "ilość" linii
-      -down: przesuwa linie w dół o podaną "ilość" linii
-      -left: przewija bufor o "procent" szerokości w lewo
-     -right: przewija bufor o "procent" szerokości w prawo
-        -go: wybierz numer linii, pierwsza linia ma numer 0 ("end" wyiera ostatnią linię)
-    -toggle: zmienia wartość opcji boolowskiej
-       -add: dodaje "wartość" (może być ujemna) do liczb i kolorów, ustawia/dodaje do wartości innych typów (ustawia, jeśli wartość jest ujemna, dodaje jeśli wartość jest pozytywna)
-     -reset: resetuje wartość opcji
-     -unset: kasuje wartość opcji
-       -set: dodaje komendę /set do linii poleceń w celu edycji wartości dla opcji (ustawia kursor na początku wartości)
-    -setnew: dodaje komendę /set do linii poleceń w celu ustawienia wartości dla opcji
-    -append: dodaje komendę /set do linii poleceń w celu dodania wartości do opcji (ustawia kursor na końcu wartości)
-      -mark: przełącza zaznaczenie
-    -format: przełącza na następny dostępny format
-    -export: eksportuje opcje i wartości wyświetlane w pliku (każda linia ma format: "/set nazwa wartość" lub "/unset nazwa")
-      -help: wymusza zapisanie pomocy dla opcji w wyeksportowanym pliku (zobacz /help fset.look.export_help_default)
-    -nohelp: nie zapisuj pomocy dla opcji w wyeksportowanym pliku (zobacz /help fset.look.export_help_default)
-     filtr: ustawia nowy filtr żeby pokazać konkretne opcje (filtr ten może być użyty jako dane wejściowe w buforze fset); dozwolone formaty:
-               *       pokazuje wszystkie opcje (brak filtra)
-               xxx     pokazuje tylko opcje z "xxx" w nazwie
-               f:xxx   pokazuje tylko opcje dla pliku konfiguracyjnego "xxx"
-               t:xxx   pokazuje tylko opcje typu "xxx" (bool/int/str/col)
-               d       pokazuje tylko zmienione opcje
-               d:xxx   pokazuje tylko zmienione opcje z "xxx" w nazwie
-               d=xxx   pokazuje tylko zmienione opcje z wartością zawierającą "xxx"
-               d==xxx  pokazuje tylko zmienione opcje z wartością równą "xxx"
-               =xxx    pokazuje tylko opcje z wartością zawierającą "xxx"
-               ==xxx   pokazuje tylko opcje z wartością równą "xxx"
-               c:xxx   pokazuje tylko opcje pasujące do przretworzonego warunku "xxx", używając najstępujących zmiennych: file, section, option, name, parent_name, type, type_en, type_short (bool/int/str/col), type_tiny (b/i/s/c), default_value, default_value_undef, value, quoted_value, value_undef, value_changed, parent_value, min, max, description, description2, description_en, description_en2, string_values
+       -bar: add the help bar
+   -refresh: refresh list of options, then whole screen (command: /window refresh)
+        -up: move the selected line up by "number" lines
+      -down: move the selected line down by "number" lines
+      -left: scroll the fset buffer by "percent" of width on the left
+     -right: scroll the fset buffer by "percent" of width on the right
+        -go: select a line by number, first line number is 0 ("end" to select the last line)
+    -toggle: toggle the boolean value
+       -add: add "value" (which can be a negative number) for integers and colors, set/append to value for other types (set for a negative value, append for a positive value)
+     -reset: reset the value of option
+     -unset: unset the option
+       -set: add the /set command in input to edit the value of option (move the cursor at the beginning of value)
+    -setnew: add the /set command in input to edit a new value for the option
+    -append: add the /set command to append something in the value of option (move the cursor at the end of value)
+      -mark: toggle mark
+    -format: switch to the next available format
+    -export: export the options and values displayed in a file (each line has format: "/set name value" or "/unset name")
+      -help: force writing of help on options in exported file (see /help fset.look.export_help_default)
+    -nohelp: do not write help on options in exported file (see /help fset.look.export_help_default)
+     filter: set a new filter to see only matching options (this filter can be used as input in fset buffer as well); allowed formats are:
+               *       show all options (no filter)
+               xxx     show only options with "xxx" in name
+               f:xxx   show only configuration file "xxx"
+               t:xxx   show only type "xxx" (bool/int/str/col)
+               d       show only changed options
+               d:xxx   show only changed options with "xxx" in name
+               d=xxx   show only changed options with "xxx" in value
+               d==xxx  show only changed options with exact value "xxx"
+               h=xxx   show only options with "xxx" in description (translated)
+               he=xxx  show only options with "xxx" in description (in English)
+               =xxx    show only options with "xxx" in value
+               ==xxx   show only options with exact value "xxx"
+               c:xxx   show only options matching the evaluated condition "xxx", using following variables: file, section, option, name, parent_name, type, type_en, type_short (bool/int/str/col), type_tiny (b/i/s/c), default_value, default_value_undef, value, quoted_value, value_undef, value_changed, parent_value, min, max, description, description2, description_en, description_en2, string_values
 
-Linie z opcjami są wyświetlane z użyciem przetworzonych ciągów (zobacz /help eval aby poznać format), z tymi opcjami:
-  - fset.format.option1: pierwszy format dla opcji
-  - fset.format.option2: drugi format dla opcji
+The lines with options are displayed using string evaluation (see /help eval for the format), with these options:
+  - fset.format.option1: first format for an option
+  - fset.format.option2: second format for an option
 
-Następujące zmienne mogą zostać użyte w tych opcjach:
-  - dane opcji z kolorem i wyrównane spacjami do prawej:
-    - ${file}: plik konfiguracyjny (na przykład "weechat" lub "irc")
-    - ${section}: sekcja
-    - ${option}: nazwa opcji
-    - ${name}: pełna nazwa opcji (plik.sekcja.opcja)
-    - ${parent_name}: nazwa nadrzędnej opcji
-    - ${type}: typ opcji (przetłumaczony)
-    - ${type_en}: typ opcji (po angielsku)
-    - ${type_short}: skrócony typ (bool/int/str/col)
-    - ${type_tiny}: krótki typ (b/i/s/c)
-    - ${default_value}: domyślna wartość opcji
-    - ${default_value_undef}: "1" jeśli domyślna wartość jest pusta, inaczej "0"
-    - ${value}: wartość opcji
-    - ${value_undef}: "1" jeśli wartość jest pusta, inaczej "0"
-    - ${value_changed}: "1" jeśli wartość różni się od domyślnej, inaczej "0"
-    - ${value2}: wartość opcji, z odziedziczoną wartościa jeśli pusta
-    - ${parent_value}: wartość nadrzędnej opcji
-    - ${min}: minimalna wartość
-    - ${max}: maksymalna wartość
-    - ${description}: opis opcji (przetłumaczony)
-    - ${description2}: opis opcji (przetłumaczony), "(brak opisu)" (przetłumaczony) jeśli nie ma opisu
-    - ${description_en}: opis opcji (po angielsku)
-    - ${description_en2}: opis opcji (po angielsku), "(brak opisu)" jeśli nie ma opisu
-    - ${string_values}: dozwolone wartości ciągu dla liczbowych wartości opcji
-    - ${marked}: "1" jeśli opcja jest zaznaczona, inaczej "0"
-    - ${index}: numer opcji na liście
-  - dane opcji, z kolorami ale bez spacji:
-    - te same nazwy poprzedzone podkreśleniem, na przykład: ${_name}, ${_type}, ...
-  - dane opcji, nieprzetworzony format (bez kolorów/spacji):
-    - te same nazwy poprzedzone dwoma podkreśleniami, na przykład: ${__name}, ${__type}, ...
-  - dane opcji, tylko spacje:
-    - te same nazwy poprzedzone "empty_", na przykład: ${empty_name}, ${empty_type}
-  - inne dane:
-    - ${selected_line}: "1" jeśli linia jest zaznaczona, inaczej "0"
-    - ${newline}: dodaje znak nowej linii, dzięki czemu opcja wyświetlana jestw kilku liniach
+The following variables can be used in these options:
+  - option data, with color and padded by spaces on the right:
+    - ${file}: configuration file (for example "weechat" or "irc")
+    - ${section}: section
+    - ${option}: option name
+    - ${name}: full option name (file.section.option)
+    - ${parent_name}: parent option name
+    - ${type}: option type (translated)
+    - ${type_en}: option type (in English)
+    - ${type_short}: short option type (bool/int/str/col)
+    - ${type_tiny}: tiny option type (b/i/s/c)
+    - ${default_value}: option default value
+    - ${default_value_undef}: "1" if default value is null, otherwise "0"
+    - ${value}: option value
+    - ${value_undef}: "1" if value is null, otherwise "0"
+    - ${value_changed}: "1" if value is different from default value, otherwise "0"
+    - ${value2}: option value, with inherited value if null
+    - ${parent_value}: parent option value
+    - ${min}: min value
+    - ${max}: max value
+    - ${description}: option description (translated)
+    - ${description2}: option description (translated), "(no description)" (translated) if there's no description
+    - ${description_en}: option description (in English)
+    - ${description_en2}: option description (in English), "(no description)" if there's no description
+    - ${string_values}: string values allowed for set of an integer option using strings
+    - ${marked}: "1" if option is marked, otherwise "0"
+    - ${index}: index of option in list
+  - option data, with color but no spaces:
+    - same names prefixed by underscore, for example: ${_name}, ${_type}, ...
+  - option data, raw format (no colors/spaces):
+    - same names prefixed by two underscores, for example: ${__name}, ${__type}, ...
+  - option data, only spaces:
+    - same names prefixed with "empty_", for example: ${empty_name}, ${empty_type}
+  - other data:
+    - ${selected_line}: "1" if the line is selected, otherwise "0"
+    - ${newline}: insert a new line at point, so the option is displayed on multiple lines
 
-Klawisze i polecenia do poruszania się w buforze fset:
-  up                        przesuwa linię do góry
-  down                      przesuwa linie w dół
-  pgup                      przesówa stronę do góry
-  pgdn                      przesówa stronę w dół
-  alt-home          <<      przenosi do pierwszej linii
-  alt-end           >>      przenosi do ostatniej linii
-  F11               <       przewija w lewo
-  F12               >       przewija w prawo
+Keys and input to move in on fset buffer:
+  up                        move one line up
+  down                      move one line down
+  pgup                      move one page up
+  pgdn                      move one page down
+  alt-home          <<      move to first line
+  alt-end           >>      move to last line
+  F11               <       scroll horizontally on the left
+  F12               >       scroll horizontally on the right
 
-Klawisze i polecenia do ustawiania opcji w buforze fset:
-  alt+space         t       zmiana wartości boolowskiej
-  alt+'-'           -       odejmuje 1 od wartości liczbowej/koloru, ustawia wartości innych typów
-  alt+'+'           +       dodaje 1 od wartości liczbowej/koloru, dodaje do wartości innych typów
-  alt+f, alt+r      r       resetuje wartość
-  alt+f, alt+u      u       kasuje wartość
-  alt+enter         s       ustawia wartość
-  alt+f, alt+n      n       ustawia nową wartość
-  alt+f, alt+a      a       dodaje do wartości
-  alt+','           ,       zazcnacza/odznacza opcję
-  shift+up                  przesuwa jedną linię w górę oraz zaznacza/odznacza opcję
-  shift+down                zaznacza/odznacza opcję i przesuwa jedną linię w dół
-                    m:xxx   zaznacza wyświetlane opcje pasujące do filtru "xxx" (dowolny filtr dla opcji lub wartoci, zobacz wyżej jak definiować filtry)
-                    u:xxx   odznacza wyświetlane opcje pasujące do filtru "xxx" (dowolny filtr dla opcji lub wartoci, zobacz wyżej jak definiować filtry)
+Keys and input to set options on fset buffer:
+  alt+space         t       toggle boolean value
+  alt+'-'           -       subtract 1 from value for integer/color, set value for other types
+  alt+'+'           +       add 1 to value for integer/color, append to value for other types
+  alt+f, alt+r      r       reset value
+  alt+f, alt+u      u       unset value
+  alt+enter         s       set value
+  alt+f, alt+n      n       set new value
+  alt+f, alt+a      a       append to value
+  alt+','           ,       mark/unmark option
+  shift+up                  move one line up and mark/unmark option
+  shift+down                mark/unmark option and move one line down
+                    m:xxx   mark options displayed that are matching filter "xxx" (any filter on option or value is allowed, see filters above)
+                    u:xxx   unmark options displayed that are matching filter "xxx" (any filter on option or value is allowed, see filters above)
 
-Pozostałe skróty klawiszowe i polecenia w buforze fset:
-  ctrl+L                    odświerza opcje i cały ekran (komenda: /fset -refresh)
-                    $       odświerza opcje (pozotawia zaznaczenia)
-                    $$      odświerza opcje (kasuje zaznaczenia)
-  alt+p             p       przełącza opcje opisu wtyczki (plugins.desc.*)
-  alt+v             v       przełącza pasek pomocy
-                    s:x,y   sortuje opcje po wartościach x,y (zobacz /help fset.look.sort)
-                    s:      resetuje sortowanie do domyślnych wartości (zobacz /help fset.look.sort)
-                    w:xxx   eksportuje opcje do pliku "xxx"
-                    w-:xxx  eskportuje opcje do pliku "xxx" bez pomocy
-                    w+:xxx  eskportuje opcje do pliku "xxx" z pomocą
-  ctrl+X            x       przełącza format uzywany do wyświetlenia opcji
-                    q       zamyka bufor fset
+Other keys and input on fset buffer:
+  ctrl+L                    refresh options and whole screen (command: /fset -refresh)
+                    $       refresh options (keep marked options)
+                    $$      refresh options (unmark all options)
+  alt+p             p       toggle plugin description options (plugins.desc.*)
+  alt+v             v       toggle help bar
+                    s:x,y   sort options by fields x,y (see /help fset.look.sort)
+                    s:      reset sort to its default value (see /help fset.look.sort)
+                    w:xxx   export options in file "xxx"
+                    w-:xxx  export options in file "xxx" without help
+                    w+:xxx  export options in file "xxx" with help
+  ctrl+X            x       switch the format used to display options
+                    q       close fset buffer
 
-Akcje myszy w buforze fset:
-  rolka up/down                                  przesuwa linie w gorę/dół
-  lewy przyciks                                  przesuwa linię w wybrane miejsce
-  prawy przycisk                                 przełącza wartość boolowską (on/off) lub edytuje wartość pola
-  prawy przycisk + przeciągnięcie w lewo/prawo   zwiększa/zmniejsza wartość liczby/koloru, ustawia/dodaje wartości innych typów
-  prawy przycisk + przeciągnięcie w górę/dół     zaznacza/odznacza wiele opcji
+Mouse actions on fset buffer:
+  wheel up/down                   move line up/down
+  left button                     move line here
+  right button                    toggle boolean (on/off) or edit the option value
+  right button + drag left/right  increase/decrease value for integer/color, set/append to value for other types
+  right button + drag up/down     mark/unmark multiple options
 
-Uwaga: jeśli wejście posiada na początku kilka spacji jest traktowane jako filtr bez spacji. Na przykład " q" pokazuje wszystkie opcje z "q" w nazwie "q" zamyka bufor.
+Note: if input has one or more leading spaces, the following text is interpreted as a filter, without the spaces. For example " q" searches all options with "q" inside name while "q" closes the fset buffer.
 
-Przykłady:
-  pokazuje zmienione opcje IRC:
+Examples:
+  show IRC options changed:
     /fset d:irc.*
-  pokazuje wszystkie opcje zawierające w nazwie "nicklist":
+  show all options with "nicklist" in name:
     /fset nicklist
-  pokazuje wszystkie wartości zawierające "red":
+  show all values which contain "red":
     /fset =red
-  pokazuje wszystkie wartości równe "red":
+  show all values which are exactly "red":
     /fset ==red
-  pokazuje wszystkie liczbowe wartości wtyczki irc:
+  show all integer options in irc plugin:
     /fset c:${file} == irc && ${type_en} == integer
 ----