doc: update polish translations and docs, add polish scripting guide

doc/pl/CMakeLists.txt

@@ -17,6 +17,17 @@
 # along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
 #
 
+# scripting guide
+ADD_CUSTOM_COMMAND(
+  OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_scripting.pl.html
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_scripting.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_scripting.pl.txt
+  DEPENDS
+  ${CMAKE_CURRENT_SOURCE_DIR}/weechat_scripting.pl.txt
+  COMMENT "Building weechat_scripting.pl.html"
+)
+ADD_CUSTOM_TARGET(doc-scripting-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_scripting.pl.html)
+INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_scripting.pl.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
+
 # FAQ
 ADD_CUSTOM_COMMAND(
   OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html

doc/pl/Makefile.am

@@ -21,14 +21,20 @@
 docdir = $(datadir)/doc/$(PACKAGE)
 
 EXTRA_DIST = CMakeLists.txt \
+             weechat_scripting.pl.txt \
              weechat_faq.pl.txt \
              weechat_quickstart.pl.txt \
              weechat_tester.pl.txt
 
-all-local: weechat_faq.pl.html \
+all-local: weechat_scripting.pl.html \
+		weechat_faq.pl.html \
 		weechat_quickstart.pl.html \
 		weechat_tester.pl.html
 
+# scripting guide
+weechat_scripting.pl.html: weechat_scripting.pl.txt
+	$(ASCIIDOC) -a toc -a toclevels=3 -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -n -o weechat_scripting.pl.html $(abs_top_srcdir)/doc/pl/weechat_scripting.pl.txt
+
 # FAQ
 weechat_faq.pl.html: weechat_faq.pl.txt
 	$(ASCIIDOC) -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -f $(abs_top_srcdir)/doc/asciidoc.conf -n -o weechat_faq.pl.html $(abs_top_srcdir)/doc/pl/weechat_faq.pl.txt

doc/pl/weechat_quickstart.pl.txt

@@ -25,7 +25,7 @@ Do ustawiania opcji służy `/set config.sekcja.opcja wartość`
 (gdzie `config` jest nazwą konfiguracyjną (`weechat` dla rdzenia, lub nazwa
 wtyczki), `sekcja` sekcja pliku konfiguracyjnego, oraz `opcja` nazwa opcji).
 
-WeeChat natychmiast używa nowej wartości (*nigdy* nie musisz restartoweać WeeChat
+WeeChat natychmiast używa nowej wartości (*nigdy* nie musisz restartować WeeChat
 po zmianach w ustawieniach).
 
 Możesz użyć `/set` z częściową nazwą zmiennej oraz dziką kartą "*" na początku
@@ -59,7 +59,7 @@ Rdzeń vs wtyczki
 interakcji z użytkownikiem, oznacza to, że rdzeń weechat bez wtyczek jest
 bezużyteczny (wierni użytkownicy: IRC był częścią rdzenia dla wersji ≤ 0.2.6).
 
-Wszystkie protokoły sieciowe jak IRC są dostarczane w oddzielnych pluginach.
+Wszystkie protokoły sieciowe jak IRC są dostarczane w oddzielnych wtyczkach.
 
 Użyj komendy `/plugin` do wyświetlenia załadowanych wtyczek, powinieneś zobaczyć
 na liście "irc" oraz inne wtyczki.
@@ -184,7 +184,7 @@ oraz duże okno (2/3), użyj komendy:
 Skróty klawiszowe
 -----------------
 
-WeeChat używa domyślnie wiele klawiszy. Wszystie z nich są w dokumentacji,
+WeeChat używa domyślnie wiele klawiszy. Wszystkie z nich są w dokumentacji,
 ale powinieneś znać przynajmniej kilka najprzydatniejszych:
 
 - 'alt + strzałki lewo/prawo' (lub 'F5'/'F6'): przełącza na poprzedni/następny bufor
@@ -196,14 +196,14 @@ ale powinieneś znać przynajmniej kilka najprzydatniejszych:
 - 'alt + A': skocz do bufora z aktywnością (w hotliście)
 
 Zgodnie z Twoją klawiaturą i/lub potrzebami, możesz zmienić przypisanie
-dowolnego klawisza do komendy używajac komendy `/key`.
+dowolnego klawisza do komendy używając komendy `/key`.
 Przydatnym skrótem jest meta-k (alt-k) do odnajdywania kodów klawiszy.
 
 Na przykład, aby przypisać meta-y (alt-y) do komendy `/buffer close`:
 
   /key bind (wciśnij meta-k) (wciśnij meta-y) /buffer close
 
-Otrzymasz w lini poleceń:
+Otrzymasz w linii poleceń:
 
   /key bind meta-y /buffer close
 
@@ -219,17 +219,17 @@ Wtyczki/skrypty
 W niektórych dystrybucjach, jak np Debian, wtyczki są dostarczane jako oddzielne
 pakiety (jak weechat-plugins).
 Wtyczki są automatycznie ładowane, kiedy zostaną wykryte (proszę spojrzeć do
-dokumentacji WeeChat, aby się dowiedzieć jak ładowac/wyładowywać wtyczki lub
+dokumentacji WeeChat, aby się dowiedzieć jak ładować/wyładowywać wtyczki lub
 skrypty).
 
-Niektóre pluginy pozwalają na używanie skryptów w WeeChat (w wielu językach jak Perl,
-Python, Ruby, Lua oraz Tcl). Te wtyczki muszą być załadowane za pomoca komendy
+Niektóre wtyczki pozwalają na używanie skryptów w WeeChat (w wielu językach jak Perl,
+Python, Ruby, Lua oraz Tcl). Te wtyczki muszą być załadowane za pomocą komendy
 `/plugin`, dostarczają one komendy jak `/perl`, używane do ładowania skryptów.
 
 Wiele zewnętrznych wtyczek/skryptów (od społeczności) jest dostępnych dla
 WeeChat: http://www.weechat.org/scripts
 
-Najprostrzym sposobem na instalowanie skryptów jest użycie skryptu 'weeget.py':
+Najprostszym sposobem na instalowanie skryptów jest użycie skryptu 'weeget.py':
 
 . ściągnij i skopiuj 'weeget.py' do ~/.weechat/python/autoload/
 . załaduj skrypt: `/python autoload`

doc/pl/weechat_tester.pl.txt

@@ -12,17 +12,17 @@ Najłatwiejszym (a zarazem najtrudniejszym) sposobem jest testowanie!
 
 Testowanie jest bardzo ważną częścią rozwoju oprogramowania i nie powinno być
 niedoceniane. Kiedy nowe funkcje są implementowane, powinny zostać przetestowane,
-ale dla wielu z nich jest za dużo możliwości użycia lub nie są łątwe do
-zasymulowania dlatego programiści nie są wstanie sprawdzić ich wszystkich.
+ale dla wielu z nich jest za dużo możliwości użycia lub nie są łatwe do
+za symulowania dlatego programiści nie są wstanie sprawdzić ich wszystkich.
 
 Na przykład: Powszechnie znana wtyczka od kodowania została wprowadzona w
 WeeChat 0.2.2: żaden z nas (programistów, współpracowników, testerów) nie
 używał kanałów ze znakami narodowymi w nazwach, kiedy wersja 0.2.2 została
 wypuszczona zostaliśmy zalani użytkownikami z Rosji obwiniającymi nas.
-Gdy będziemy mieli więcej testrów taka sytuacja nie powinna się już zdarzyć
+Gdy będziemy mieli więcej testerów taka sytuacja nie powinna się już zdarzyć
 w przyszłości.
 
-Testowanie stabilenj wersji WeeChat jest bezcelowe, ponieważ programiści są
+Testowanie stabilnej wersji WeeChat jest bezcelowe, ponieważ programiści są
 zajęci cały czas implementowaniem nowych rzeczy (oraz poprawianiem błędów).
 
 
@@ -30,9 +30,9 @@ zajęci cały czas implementowaniem nowych rzeczy (oraz poprawianiem błędów).
 Przygotuj swój system
 ---------------------
 
-Bardzo nam pomoże, jeśli włączysz linuksowe pliki 'core': jeśli WeeChat zawiesi,
-się Linuks zapisze plik zwany 'core'. Plik ten zawiera uzyteczne informacje
-pozwalające dokładnie zlokalizować bład w WeeChat.
+Bardzo nam pomoże, jeśli włączysz linuksowe pliki 'core': jeśli WeeChat zawiesi
+się Linux zapisze plik zwany 'core'. Plik ten zawiera użyteczne informacje
+pozwalające dokładnie zlokalizować błąd w WeeChat.
 
 Jeśli korzystasz z powłoki 'bash', dodaj następującą linijkę do `~/.bashrc`:
 
@@ -43,11 +43,11 @@ Jeśli korzystasz z powłoki 'bash', dodaj następującą linijkę do `~/.bashrc
 Pobieranie wersji rozwojowej
 ----------------------------
 
-Świerzy kod (z najnowszymi błędami i funkcjami) przechowywany jest w repozytorium GIT.
+Świeży kod (z najnowszymi błędami i funkcjami) przechowywany jest w repozytorium GIT.
 
 Możesz się zdecydować na własnoręczne zbudowanie (zalecana metoda):
 
-* wersja z GIT może być zbudowana i zainstalowana równolegle z wersją stabulną,
+* wersja z GIT może być zbudowana i zainstalowana równolegle z wersją stabilną,
 * nie potrzebujesz uprawnień administratora, oraz nie musisz poświęcać stabilnej
   wersji WeeChat.
 
@@ -62,7 +62,7 @@ $ mkdir ~/weechat-git
 $ cd ~/weechat-git
 ---------------------
 
-Jeśli masz zainstalowanego gita, po prostu zklonuj repozytorium (zalecana
+Jeśli masz zainstalowanego gita, po prostu sklonuj repozytorium (zalecana
 metoda):
 
 --------------------------------------------
@@ -73,7 +73,7 @@ $ cd weechat
 UWAGA: Później możesz wykonać w tym katalogu "`git pull`", aby pobrać najnowsze
 poprawki.
 
-Oczywiście możesz pobrać paczke oznaczoną jako 'devel':
+Oczywiście możesz pobrać paczkę oznaczoną jako 'devel':
 
 -----------------------------------------------------------------
 $ wget http://www.weechat.org/files/src/weechat-devel.tar.bz2
@@ -116,7 +116,7 @@ W zależności od dystrybucji Linuksa:
 Uruchomienie WeeChat
 --------------------
 
-Zalca się uruchomianie WeeChat z innym katalogiem (różnym od wersji stabilnej),
+Zaleca się uruchomianie WeeChat z innym katalogiem (różnym od wersji stabilnej),
 za pomocą opcji `--dir`.
 
 Komenda to:
@@ -126,8 +126,8 @@ Komenda to:
 Jeśli nadal nie śpisz powinieneś ujrzeć znajomy interfejs i chwalić się
 z posiadania najnowszej możliwej wersji WeeChat. ;)
 
-Teraz jeśli zaobserwujesz dziwne zachowanie (może sprawiać problemy, ulec awari
-lub zagotować Twoje piwo) nie wachaj się wejść na kanał `#weechat` na serwerze
+Teraz jeśli zaobserwujesz dziwne zachowanie (może sprawiać problemy, ulec awarii
+lub zagotować Twoje piwo) nie wahaj się wejść na kanał `#weechat` na serwerze
 `irc.freenode.net` i nam o tym opowiedzieć.
 
 Jeśli wszystko będzie w porządku - też nam o tym powiedz, potrzebujemy Twojej opinii!