Beautify docbook files

6 files changed, 628 insertions, 3171 deletions

diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
index 96e89dc01b2..fe313be9352 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
@@ -1,127 +1,49 @@
 <!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
      Thanks a lot in advance.-->
 <chapter id="getting-started">
-<title
->Rozpoczęcie pracy</title>
-<para
->Gdy uruchomisz program &kturtle; zobaczysz następujące okno: <screenshot
-> <screeninfo
->Oto zrzut ekranu programu &kturtle;, gdy jest on uruchamiany po raz pierwszy</screeninfo
-> <mediaobject
-> <imageobject
-> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
-> <textobject
-> <phrase
->Główne okno &kturtle;</phrase
-> </textobject
-> </mediaobject
-> </screenshot
-> W tym podręczniku przyjmujemy, że językiem poleceń &logo; jest polski. Język możesz zmienić w menu <menuchoice
-><guimenu
->Ustawienia</guimenu
-><guimenuitem
->Konfiguracja &kturtle;...</guimenuitem
-></menuchoice
-> w dziale <guilabel
->Język</guilabel
->. Pamiętaj, że język, który ustawisz tutaj będzie musiał być wykorzystywany do wpisywania poleceń &logo;.</para>
+<title>Rozpoczęcie pracy</title>
+<para>Gdy uruchomisz program &kturtle; zobaczysz następujące okno: <screenshot> <screeninfo>Oto zrzut ekranu programu &kturtle;, gdy jest on uruchamiany po raz pierwszy</screeninfo> <mediaobject> <imageobject> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject> <textobject> <phrase>Główne okno &kturtle;</phrase> </textobject> </mediaobject> </screenshot> W tym podręczniku przyjmujemy, że językiem poleceń &logo; jest polski. Język możesz zmienić w menu <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja &kturtle;...</guimenuitem></menuchoice> w dziale <guilabel>Język</guilabel>. Pamiętaj, że język, który ustawisz tutaj będzie musiał być wykorzystywany do wpisywania poleceń &logo;.</para>
 
 <sect1 id="first-steps">
-<title
->Pierwsze kroki z &logo;: poznaj Żółwia!</title>
-<para
->Musiałeś już zauważyć żółwia w samym środku okna: dowiesz się teraz jak nim sterować za pomocą poleceń wpisywanych do edytora kodu.</para>
+<title>Pierwsze kroki z &logo;: poznaj Żółwia!</title>
+<para>Musiałeś już zauważyć żółwia w samym środku okna: dowiesz się teraz jak nim sterować za pomocą poleceń wpisywanych do edytora kodu.</para>
 
 <sect2 id="the-turtle-moves">
-<title
->Poruszanie żółwiem</title>
-<para
->Rozpocznijmy od wprawienia żółwia w ruch. Nasz żółw może się poruszać na trzy sposoby, (1) może się poruszać w przód i w tył, (2) możesz skręcać w lewo i w prawo oraz (3) może iść bezpośrednio do miejsca wskazanego na ekranie. Spróbuj na przykład:</para>
+<title>Poruszanie żółwiem</title>
+<para>Rozpocznijmy od wprawienia żółwia w ruch. Nasz żółw może się poruszać na trzy sposoby, (1) może się poruszać w przód i w tył, (2) możesz skręcać w lewo i w prawo oraz (3) może iść bezpośrednio do miejsca wskazanego na ekranie. Spróbuj na przykład:</para>
 <para>
-<screen
->naprzód 100
+<screen>naprzód 100
 obróć_w_lewo 90 
 </screen>
-Wpisz lub skopiuj i wklej kod do edytora kodów, a następnie go wykonaj (korzystając z menu <link linkend="file-execute"
-><menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Wykonaj rozkaz</guimenuitem
-></menuchoice
-></link
->), aby zobaczyć rezultat.</para>
+Wpisz lub skopiuj i wklej kod do edytora kodów, a następnie go wykonaj (korzystając z menu <link linkend="file-execute"><menuchoice><guimenu>Plik</guimenu><guimenuitem>Wykonaj rozkaz</guimenuitem></menuchoice></link>), aby zobaczyć rezultat.</para>
 
-<para
->Po wpisaniu i wykonaniu podanych wyżej poleceń mogłeś zaobserwować następujące zdarzenia:</para>
+<para>Po wpisaniu i wykonaniu podanych wyżej poleceń mogłeś zaobserwować następujące zdarzenia:</para>
 <orderedlist>
-<listitem
-><para
->Po wykonaniu polecenia, żółw przesuną się do góry, narysował linię, a następnie zrobił jedną czwartą obrotu w lewo. Stało się tak, ponieważ wprowadziłeś polecenia <link linkend="forward"
-><userinput
->naprzód</userinput
-></link
-> oraz <link linkend="turnleft"
-><userinput
->obróć_w_lewo</userinput
-></link
->.</para>
+<listitem><para>Po wykonaniu polecenia, żółw przesuną się do góry, narysował linię, a następnie zrobił jedną czwartą obrotu w lewo. Stało się tak, ponieważ wprowadziłeś polecenia <link linkend="forward"><userinput>naprzód</userinput></link> oraz <link linkend="turnleft"><userinput>obróć_w_lewo</userinput></link>.</para>
 </listitem>
 <listitem>
-<para
->Kolor kodu zmieniał się w miarę jak go pisałeś: opcja ta nazywana jest <emphasis
->intuicyjnym podświetlaniem</emphasis
-> &mdash; różne rodzaju poleceń są podświetlane w różny sposób. Ułatwia to czytanie dużych bloków tekstu.</para>
+<para>Kolor kodu zmieniał się w miarę jak go pisałeś: opcja ta nazywana jest <emphasis>intuicyjnym podświetlaniem</emphasis> &mdash; różne rodzaju poleceń są podświetlane w różny sposób. Ułatwia to czytanie dużych bloków tekstu.</para>
 </listitem>
 <listitem>
-<para
->Żółw narysował cienką czarną linię.</para>
+<para>Żółw narysował cienką czarną linię.</para>
 </listitem>
 <listitem>
-<para
->Być może pojawił się komunikat błędu. Może to zwyczajnie oznaczać dwie rzeczy: mogłeś popełnić błąd podczas kopiowania poleceń, albo napisałeś polecenia w innym języku niż ten, który został zdefiniowany dla poleceń &logo; (język możesz zmienić wybierając <menuchoice
-><guimenu
->Ustawienia</guimenu
-><guimenuitem
->Konfiguracja &kturtle;...</guimenuitem
-></menuchoice
->, a następnie dział <guilabel
->Język</guilabel
->).</para>
+<para>Być może pojawił się komunikat błędu. Może to zwyczajnie oznaczać dwie rzeczy: mogłeś popełnić błąd podczas kopiowania poleceń, albo napisałeś polecenia w innym języku niż ten, który został zdefiniowany dla poleceń &logo; (język możesz zmienić wybierając <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja &kturtle;...</guimenuitem></menuchoice>, a następnie dział <guilabel>Język</guilabel>).</para>
 </listitem>
 </orderedlist>
 
-<para
->Prawdopodobnie zauważyłeś, że polecenie <userinput
->naprzód 100</userinput
-> spowodowało przesunięcie żółwia do przodu i pozostawienie linii, a polecenie <userinput
->obróć_w_lewo 90</userinput
-> obrót o 90 <glossterm linkend="degrees"
->stopni</glossterm
-> w lewo.</para>
+<para>Prawdopodobnie zauważyłeś, że polecenie <userinput>naprzód 100</userinput> spowodowało przesunięcie żółwia do przodu i pozostawienie linii, a polecenie <userinput>obróć_w_lewo 90</userinput> obrót o 90 <glossterm linkend="degrees">stopni</glossterm> w lewo.</para>
 
-<para
->Sprawdź następujące odnośniki do podręcznika użytkownika, aby uzyskać informacje na temat nowych poleceń: <userinput
->naprzód</userinput
->, <userinput
->wstecz</userinput
->, <userinput
->obróć_w_lewo</userinput
->, oraz <userinput
->obróć_w_prawo</userinput
->.</para>
+<para>Sprawdź następujące odnośniki do podręcznika użytkownika, aby uzyskać informacje na temat nowych poleceń: <userinput>naprzód</userinput>, <userinput>wstecz</userinput>, <userinput>obróć_w_lewo</userinput>, oraz <userinput>obróć_w_prawo</userinput>.</para>
 </sect2>
 
 <sect2 id="more-examples">
-<title
->Dodatkowe przykłady</title>
-<para
->Pierwszy przykład był bardzo prosty, więc ruszajmy dalej!</para>
+<title>Dodatkowe przykłady</title>
+<para>Pierwszy przykład był bardzo prosty, więc ruszajmy dalej!</para>
 
 <para>
 <!--translators: if it's not already there, you can copy/paste the translated code below and save it in arrow.logo in your examples folder: tde-i18n/language-code/data/tdeedu/kturtle/ -->
-<screen
->przeskaluj_tło 200,200
+<screen>przeskaluj_tło 200,200
 kolor_tła 0,0,0
 kolor_pisaka 255,0,0
 ustaw_grubość_pisaka 5
@@ -141,115 +63,31 @@ obróć_w_lewo 45
 
 idź 40, 100
 </screen>
-Podobnie i tutaj możesz wpisać lub skopiować i wkleić kod do edytora kodów lub otworzyć plik <filename
->arrow.logo</filename
-> za pomocą menu <guimenu
->Otwórz przykłady</guimenu
->, a następnie go wykonać (korzystając z menu <link linkend="file-execute"
-><menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Wykonaj rozkaz</guimenuitem
-></menuchoice
-></link
->), aby zobaczyć rezultat. Po następnych przykładach będziesz już wiedział dokładnie o co chodzi.</para>
+Podobnie i tutaj możesz wpisać lub skopiować i wkleić kod do edytora kodów lub otworzyć plik <filename>arrow.logo</filename> za pomocą menu <guimenu>Otwórz przykłady</guimenu>, a następnie go wykonać (korzystając z menu <link linkend="file-execute"><menuchoice><guimenu>Plik</guimenu><guimenuitem>Wykonaj rozkaz</guimenuitem></menuchoice></link>), aby zobaczyć rezultat. Po następnych przykładach będziesz już wiedział dokładnie o co chodzi.</para>
 
-<para
->Jak widać, drugi przykład zawiera zdecydowanie więcej kodu. Zauważyłeś na pewno kilka nowych poleceń. Oto ich krótkie wyjaśnienie:</para>
+<para>Jak widać, drugi przykład zawiera zdecydowanie więcej kodu. Zauważyłeś na pewno kilka nowych poleceń. Oto ich krótkie wyjaśnienie:</para>
 
-<para
-><userinput
->przeskaluj_tło 200,200</userinput
-> ustawia wysokość i szerokość obszaru na 200 <glossterm linkend="pixels"
->pikseli</glossterm
->. Wysokość i szerokość są sobie równe, tak więc obszar będzie kwadratem.</para>
+<para><userinput>przeskaluj_tło 200,200</userinput> ustawia wysokość i szerokość obszaru na 200 <glossterm linkend="pixels">pikseli</glossterm>. Wysokość i szerokość są sobie równe, tak więc obszar będzie kwadratem.</para>
 
-<para
-><userinput
->kolor_tła 0,0,0</userinput
-> koloruje krawędzie na czarno. <userinput
->0,0,0</userinput
-> jest <glossterm linkend="rgb"
->kombinacją RGB</glossterm
->, w której wszystkie wartości są ustawione na <userinput
->0</userinput
->, co daje kolor czarny.</para>
+<para><userinput>kolor_tła 0,0,0</userinput> koloruje krawędzie na czarno. <userinput>0,0,0</userinput> jest <glossterm linkend="rgb">kombinacją RGB</glossterm>, w której wszystkie wartości są ustawione na <userinput>0</userinput>, co daje kolor czarny.</para>
 
-<para
-><userinput
->kolor_pisaka 255,0,0</userinput
-> ustawia kolor pióra na czerwony. <userinput
->255,0,0</userinput
-> jest <glossterm linkend="rgb"
->kombinacją RGB</glossterm
->, w której tylko wartość czerwona została ustawiona na <userinput
->255</userinput
-> (w pełni włączona) podczas gdy inne (zielona i niebieska) zostały ustawione na <userinput
->0</userinput
-> (w pełni wyłączone). Rezultatem jest ostry kolor czerwony.</para>
+<para><userinput>kolor_pisaka 255,0,0</userinput> ustawia kolor pióra na czerwony. <userinput>255,0,0</userinput> jest <glossterm linkend="rgb">kombinacją RGB</glossterm>, w której tylko wartość czerwona została ustawiona na <userinput>255</userinput> (w pełni włączona) podczas gdy inne (zielona i niebieska) zostały ustawione na <userinput>0</userinput> (w pełni wyłączone). Rezultatem jest ostry kolor czerwony.</para>
 
-<para
->Jeżeli nie rozumiesz wartości kolorów, to przeczytaj w słowniczku objaśnienie <glossterm linkend="rgb"
->kombinacji RGB</glossterm
-></para>
+<para>Jeżeli nie rozumiesz wartości kolorów, to przeczytaj w słowniczku objaśnienie <glossterm linkend="rgb">kombinacji RGB</glossterm></para>
 
-<para
-><userinput
->ustaw_grubość_pisaka 5</userinput
-> ustawia szerokość (rozmiar) pióra na <userinput
->5</userinput
-> <glossterm linkend="pixels"
->pikseli</glossterm
->. Od teraz, każda linia rysowana przez żółwia będzie miała szerokość <userinput
->5</userinput
->-ciu pikseli, aż do momentu zmiany wartości parametru <userinput
->ustaw_grubość_pisaka</userinput
-> na inną.</para>
+<para><userinput>ustaw_grubość_pisaka 5</userinput> ustawia szerokość (rozmiar) pióra na <userinput>5</userinput> <glossterm linkend="pixels">pikseli</glossterm>. Od teraz, każda linia rysowana przez żółwia będzie miała szerokość <userinput>5</userinput>-ciu pikseli, aż do momentu zmiany wartości parametru <userinput>ustaw_grubość_pisaka</userinput> na inną.</para>
 
-<para
-><userinput
->czyść</userinput
-> usuwa linie ograniczenia obszaru.</para>
+<para><userinput>czyść</userinput> usuwa linie ograniczenia obszaru.</para>
 
-<para
-><userinput
->idź 20,20</userinput
-> powoduje, że żółw przemieszcza się w określone miejsce obszaru. Pozycja jest obliczana od lewego górnego rogu, więc miejsce docelowe znajduje się 20 <glossterm linkend="pixels"
->pikseli</glossterm
-> na lewo i 20 <glossterm linkend="pixels"
->pikseli</glossterm
-> w dół. Pamiętaj, że po poleceniu <userinput
->go</userinput
-> żółw nie będzie rysował linii.</para>
+<para><userinput>idź 20,20</userinput> powoduje, że żółw przemieszcza się w określone miejsce obszaru. Pozycja jest obliczana od lewego górnego rogu, więc miejsce docelowe znajduje się 20 <glossterm linkend="pixels">pikseli</glossterm> na lewo i 20 <glossterm linkend="pixels">pikseli</glossterm> w dół. Pamiętaj, że po poleceniu <userinput>go</userinput> żółw nie będzie rysował linii.</para>
 
-<para
-><userinput
->kierunek 135</userinput
-> ustawia kierunek żółwia. Polecenia <userinput
->obróć_w_lewo</userinput
-> oraz <userinput
->obróć_w_prawo</userinput
-> zmieniają kąt położenia rozpoczynając od bieżącego kierunku. Polecenie <userinput
->kierunek</userinput
-> zmienia kąt żółwia z pozycji zero, czyli nie ma znaczenia w jakiej pozycji znajdował się żółw przed zmianą konta położenia.</para>
+<para><userinput>kierunek 135</userinput> ustawia kierunek żółwia. Polecenia <userinput>obróć_w_lewo</userinput> oraz <userinput>obróć_w_prawo</userinput> zmieniają kąt położenia rozpoczynając od bieżącego kierunku. Polecenie <userinput>kierunek</userinput> zmienia kąt żółwia z pozycji zero, czyli nie ma znaczenia w jakiej pozycji znajdował się żółw przed zmianą konta położenia.</para>
 
-<para
->Po poleceniu <userinput
->kierunek</userinput
-> następuje wiele poleceń <userinput
->naprzód</userinput
-> i <userinput
->obróć_w_lewo</userinput
->. Te polecenia powodują rysowanie.</para>
+<para>Po poleceniu <userinput>kierunek</userinput> następuje wiele poleceń <userinput>naprzód</userinput> i <userinput>obróć_w_lewo</userinput>. Te polecenia powodują rysowanie.</para>
 
-<para
->Wreszcie kolejne polecenie <userinput
->idź</userinput
-> powoduje przesunięcie żółwia na bok.</para>
+<para>Wreszcie kolejne polecenie <userinput>idź</userinput> powoduje przesunięcie żółwia na bok.</para>
 
-<para
->Pamiętaj, że odnośniki do poleceń kierują do wyjaśnień każdego z poleceń.</para>
+<para>Pamiętaj, że odnośniki do poleceń kierują do wyjaśnień każdego z poleceń.</para>
 
 
 </sect2>
@@ -260,36 +98,31 @@ Podobnie i tutaj możesz wpisać lub skopiować i wkleić kod do edytora kodów
 <!--        EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED"
 
 <sect1 id="calculations">
-<title
->Simple Calculations</title>
+<title>Simple Calculations</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="using_variables">
-<title
->Using Variables: creating 'number containers'</title>
+<title>Using Variables: creating 'number containers'</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="using_strings">
-<title
->Using strings: creating 'text containers'</title>
+<title>Using strings: creating 'text containers'</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="logic">
-<title
->Logic: asking the computer simple questions</title>
+<title>Logic: asking the computer simple questions</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="recursion">
-<title
->Recursion: the Turtle is using itself</title>
+<title>Recursion: the Turtle is using itself</title>
 <para>
 Draw a maze for example
 </para>
diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/glossary.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/glossary.docbook
index 6063f4c671b..e0f8dd1bd90 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/glossary.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/glossary.docbook
@@ -1,406 +1,149 @@
 <!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
      Thanks a lot in advance.-->
 <chapter id="Glossary">
-<title
->Słowniczek</title>
+<title>Słowniczek</title>
 
-<para
->W tym rozdziale znajdziesz objaśnienia większości <quote
->problematycznych</quote
-> słów, które są używane w niniejszym podręczniku.</para>
+<para>W tym rozdziale znajdziesz objaśnienia większości <quote>problematycznych</quote> słów, które są używane w niniejszym podręczniku.</para>
 
 <glosslist>
 <glossentry id="degrees">
-<glossterm
->stopnie</glossterm>
-<glossdef
-><para
->Stopnie są jednostką miary kątów lub obrotów. Pełny obrót, to 360 stopni, połowa obrotu, to 180 stopni, a ćwierć obrotu to 90 stopni. Polecenia <userinput
->obróć_w_lewo</userinput
->, <userinput
->obróć_w_prawo</userinput
-> oraz <userinput
->kierunek</userinput
-> wymagają podania wartości w stopniach.</para
-></glossdef>
+<glossterm>stopnie</glossterm>
+<glossdef><para>Stopnie są jednostką miary kątów lub obrotów. Pełny obrót, to 360 stopni, połowa obrotu, to 180 stopni, a ćwierć obrotu to 90 stopni. Polecenia <userinput>obróć_w_lewo</userinput>, <userinput>obróć_w_prawo</userinput> oraz <userinput>kierunek</userinput> wymagają podania wartości w stopniach.</para></glossdef>
 </glossentry>
 
 <glossentry id="input-output">
-<glossterm
->wejście i wyjście poleceń</glossterm>
-<glossdef
-><para
->Niektóre polecenie wymagają wejścia, a niektóre dają wyjście (wynik), niektóre polecenia wymagają zarówno wejścia <emphasis
->i</emphasis
-> dają wynik. Są także takie, które nie potrzebują ani wejścia, ani nie dają wyniku.</para>
-<para
->Oto przykłady poleceń, które potrzebują jedynie wejścia: <screen>
+<glossterm>wejście i wyjście poleceń</glossterm>
+<glossdef><para>Niektóre polecenie wymagają wejścia, a niektóre dają wyjście (wynik), niektóre polecenia wymagają zarówno wejścia <emphasis>i</emphasis> dają wynik. Są także takie, które nie potrzebują ani wejścia, ani nie dają wyniku.</para>
+<para>Oto przykłady poleceń, które potrzebują jedynie wejścia: <screen>
 naprzód 50
 kolor_pisaka 255,0,0
 pisz "Cześć!"
-</screen
-> Polecenie <userinput
->naprzód</userinput
-> uznaje <userinput
->50</userinput
-> jako wejście. <userinput
->naprzód</userinput
-> potrzebuje tego wpisu, aby wiedzieć ile <glossterm linkend="pixels"
->pikseli</glossterm
-> na przód ma się przesunąć żółw. <userinput
->kolor_pisaka</userinput
-> uznaje kolor jako wejście, a <userinput
->pisz</userinput
-> uznaje za wejście ciąg (kawałek tekstu). Pamiętaj, że wejście może być także pojemnika. Poniższy przykład jest tego ilustracją: <screen
->x = 50
+</screen> Polecenie <userinput>naprzód</userinput> uznaje <userinput>50</userinput> jako wejście. <userinput>naprzód</userinput> potrzebuje tego wpisu, aby wiedzieć ile <glossterm linkend="pixels">pikseli</glossterm> na przód ma się przesunąć żółw. <userinput>kolor_pisaka</userinput> uznaje kolor jako wejście, a <userinput>pisz</userinput> uznaje za wejście ciąg (kawałek tekstu). Pamiętaj, że wejście może być także pojemnika. Poniższy przykład jest tego ilustracją: <screen>x = 50
 pisz x
 str = "cześć!"
 pisz str
-</screen
-></para>
+</screen></para>
 
-<para
->Teraz kilka przykładów dających wynik: <screen>
+<para>Teraz kilka przykładów dających wynik: <screen>
 x = okno_wejścia "Wpisz coś i kliknij OK... dzięki!"
 r = losowo 1,100
-</screen
-> Polecenie <userinput
->okno_wejścia</userinput
-> potrzebuje ciągu jako wejścia, natomiast daje wynik w postaci liczbowej lub ciągu, który został wprowadzony. Jak widać, wynik polecenia <userinput
->okno_wejścia</userinput
-> jest przechowywany w kontenerze <userinput
->x</userinput
->. Polecenie <userinput
->losowo</userinput
-> także daje wynik. W tym przypadku wynikiem jest liczba pomiędzy 1, a 100. Wynik polecenia losowo jest również przechowywany w kontenerze, o nazwie <userinput
->r</userinput
->. Zwróć uwagę, że kontenery <userinput
->x</userinput
-> oraz <userinput
->r</userinput
-> nie są wykorzystywane w powyższym przykładzie kodu.</para>
+</screen> Polecenie <userinput>okno_wejścia</userinput> potrzebuje ciągu jako wejścia, natomiast daje wynik w postaci liczbowej lub ciągu, który został wprowadzony. Jak widać, wynik polecenia <userinput>okno_wejścia</userinput> jest przechowywany w kontenerze <userinput>x</userinput>. Polecenie <userinput>losowo</userinput> także daje wynik. W tym przypadku wynikiem jest liczba pomiędzy 1, a 100. Wynik polecenia losowo jest również przechowywany w kontenerze, o nazwie <userinput>r</userinput>. Zwróć uwagę, że kontenery <userinput>x</userinput> oraz <userinput>r</userinput> nie są wykorzystywane w powyższym przykładzie kodu.</para>
 
-<para
->Są także polecenia, które nie potrzebują wejścia i nie dają także wyniku. Oto kilka przykładów: <screen
->czyść
+<para>Są także polecenia, które nie potrzebują wejścia i nie dają także wyniku. Oto kilka przykładów: <screen>czyść
 podnieś
 zawijaj
 ukryj
 </screen>
-</para
-></glossdef>
+</para></glossdef>
 </glossentry>
 
 <glossentry id="intuitive-highlighting">
-<glossterm
->podświetlanie intuicyjne</glossterm>
-<glossdef
-><para
->Ta funkcja &kturtle; ułatwia pisanie, a przede wszystkim czytanie kodu. Dzięki intuicyjnemu podświetlaniu kod, który piszesz uzyskuje kolor oznaczający rodzaj wpisywanego kodu. Na poniższej liście znajdziesz różne rodzaje kodów i kolory, jakie one otrzymują w <link linkend="the-code-editor"
->edytorze kodów</link
->. <table>
-<title
->Różne rodzaje kodów i kolor ich wyświetlania</title>
+<glossterm>podświetlanie intuicyjne</glossterm>
+<glossdef><para>Ta funkcja &kturtle; ułatwia pisanie, a przede wszystkim czytanie kodu. Dzięki intuicyjnemu podświetlaniu kod, który piszesz uzyskuje kolor oznaczający rodzaj wpisywanego kodu. Na poniższej liście znajdziesz różne rodzaje kodów i kolory, jakie one otrzymują w <link linkend="the-code-editor">edytorze kodów</link>. <table>
+<title>Różne rodzaje kodów i kolor ich wyświetlania</title>
 <tgroup cols="3">
 <tbody>
 <row>
-<entry
->polecenia regularne</entry>
-<entry
->ciemno zielony</entry>
-<entry
->Polecenia regularne zostały opisane <link linkend="commands"
->tutaj</link
->.</entry>
+<entry>polecenia regularne</entry>
+<entry>ciemno zielony</entry>
+<entry>Polecenia regularne zostały opisane <link linkend="commands">tutaj</link>.</entry>
 </row>
 <row>
-<entry
->kontrolery rozkazów</entry>
-<entry
->czarny (pogrubiony)</entry>
-<entry
->Na temat kontroli wykonywania poleceń specjalnych możesz przeczytać <link linkend="controlling-execution"
->tutaj</link
->.</entry>
+<entry>kontrolery rozkazów</entry>
+<entry>czarny (pogrubiony)</entry>
+<entry>Na temat kontroli wykonywania poleceń specjalnych możesz przeczytać <link linkend="controlling-execution">tutaj</link>.</entry>
 </row>
 <row>
-<entry
->komentarze</entry>
-<entry
->ciemny żółty</entry>
-<entry
->Wiersze komentarza rozpoczynają się od znaku komentarza (#). Wiersze te są ignorowane, gdy kod jest wykonywany. Komentarze pozwalają programiście objaśniać swój kod, a także mogą być stosowane do tymczasowego wyłączania części kodu.</entry>
+<entry>komentarze</entry>
+<entry>ciemny żółty</entry>
+<entry>Wiersze komentarza rozpoczynają się od znaku komentarza (#). Wiersze te są ignorowane, gdy kod jest wykonywany. Komentarze pozwalają programiście objaśniać swój kod, a także mogą być stosowane do tymczasowego wyłączania części kodu.</entry>
 </row>
 <row>
-<entry
->nawiasy kwadratowe [, ]</entry>
-<entry
->jasno zielony (pogrubiony)</entry>
-<entry
->Nawiasy kwadratowe są wykorzystywane do grupowania partii kodu. Są one często stosowane z <link linkend="controlling-execution"
->kontrolerami rozkazów</link
->.</entry>
+<entry>nawiasy kwadratowe [, ]</entry>
+<entry>jasno zielony (pogrubiony)</entry>
+<entry>Nawiasy kwadratowe są wykorzystywane do grupowania partii kodu. Są one często stosowane z <link linkend="controlling-execution">kontrolerami rozkazów</link>.</entry>
 </row>
 <row>
-<entry
->polecenie <link linkend="learn"
->poznaj</link
-></entry>
-<entry
->jasno zielony (pogrubiony)</entry>
-<entry
->Polecenie <link linkend="learn"
->poznaj</link
-> jest wykorzystywane do tworzenia nowych poleceń.</entry>
+<entry>polecenie <link linkend="learn">poznaj</link></entry>
+<entry>jasno zielony (pogrubiony)</entry>
+<entry>Polecenie <link linkend="learn">poznaj</link> jest wykorzystywane do tworzenia nowych poleceń.</entry>
 </row>
 <row>
-<entry
->liczby</entry>
-<entry
->niebieski</entry>
-<entry
->Liczb chyba nie trzeba wyjaśniać.</entry>
+<entry>liczby</entry>
+<entry>niebieski</entry>
+<entry>Liczb chyba nie trzeba wyjaśniać.</entry>
 </row>
 <row>
-<entry
->ciągi</entry>
-<entry
->ciemno czerwony</entry>
-<entry
->Niewiele można powiedzieć na temat ciągów (tekstowych), poza tym, że zawsze zaczynają się one i kończą podwójnym cudzysłowem (").</entry>
+<entry>ciągi</entry>
+<entry>ciemno czerwony</entry>
+<entry>Niewiele można powiedzieć na temat ciągów (tekstowych), poza tym, że zawsze zaczynają się one i kończą podwójnym cudzysłowem (").</entry>
 </row>
 <row>
-<entry
->znaki matematyczne</entry>
-<entry
->szary</entry>
-<entry
->Oto znaki matematyczne: +, -, *, /. Dowiesz się więcej na ich temat czytając <link linkend="math"
->ten dział</link
->.</entry>
+<entry>znaki matematyczne</entry>
+<entry>szary</entry>
+<entry>Oto znaki matematyczne: +, -, *, /. Dowiesz się więcej na ich temat czytając <link linkend="math">ten dział</link>.</entry>
 </row>
 <row>
-<entry
->znaki zapytania</entry>
-<entry
->niebieski (pogrubiony)</entry>
-<entry
->Na temat pytań dowiesz się więcej <link linkend="questions"
->tutaj</link
->.</entry>
+<entry>znaki zapytania</entry>
+<entry>niebieski (pogrubiony)</entry>
+<entry>Na temat pytań dowiesz się więcej <link linkend="questions">tutaj</link>.</entry>
 </row>
 <row>
-<entry
->operatory logiczne</entry>
-<entry
->różowy</entry>
-<entry
->Na temat operatorów logicznych (i, lub, nie) możesz przeczytać <link linkend="question-glue"
->tutaj</link
->.</entry>
+<entry>operatory logiczne</entry>
+<entry>różowy</entry>
+<entry>Na temat operatorów logicznych (i, lub, nie) możesz przeczytać <link linkend="question-glue">tutaj</link>.</entry>
 </row>
 <row>
-<entry
->zwykły tekst</entry>
-<entry
->czarny</entry>
-<entry
-></entry>
+<entry>zwykły tekst</entry>
+<entry>czarny</entry>
+<entry></entry>
 </row>
 </tbody>
 </tgroup>
 </table>
-</para
-></glossdef>
+</para></glossdef>
 </glossentry>
 
 <glossentry id="pixels">
-<glossterm
->piksele</glossterm>
-<glossdef
-><para
->Piksel jest punktem na ekranie. Jeżeli dokładnie się przyjrzysz, to zobaczysz, że ekran Twojego monitora składa się z pikseli. Wszystkie obrazy na ekranie są zbudowane z takich pikseli. Piksel jest najmniejszą rzeczą, która może zostać narysowana na ekranie.</para>
-<para
->Wiele poleceń wymaga podania liczby pikseli jako wejścia. Polecenia te to: <userinput
->naprzód</userinput
->, <userinput
->wstecz</userinput
->, <userinput
->idź</userinput
->, <userinput
->idźx</userinput
->, <userinput
->idźy</userinput
->, <userinput
->przeskaluj_tło</userinput
-> oraz <userinput
->ustaw_grubość_pisaka</userinput
->.</para
-></glossdef>
+<glossterm>piksele</glossterm>
+<glossdef><para>Piksel jest punktem na ekranie. Jeżeli dokładnie się przyjrzysz, to zobaczysz, że ekran Twojego monitora składa się z pikseli. Wszystkie obrazy na ekranie są zbudowane z takich pikseli. Piksel jest najmniejszą rzeczą, która może zostać narysowana na ekranie.</para>
+<para>Wiele poleceń wymaga podania liczby pikseli jako wejścia. Polecenia te to: <userinput>naprzód</userinput>, <userinput>wstecz</userinput>, <userinput>idź</userinput>, <userinput>idźx</userinput>, <userinput>idźy</userinput>, <userinput>przeskaluj_tło</userinput> oraz <userinput>ustaw_grubość_pisaka</userinput>.</para></glossdef>
 </glossentry>
 
 <glossentry id="rgb">
-<glossterm
->Kombinacje RGB (kody kolorów)</glossterm>
-<glossdef
-><para
->Kombinacje RGB są wykorzystywane do opisywania kolorów. <quote
->R</quote
-> oznacza <quote
->czerwony</quote
->, <quote
->G</quote
-> oznacza <quote
->zielony</quote
->, a <quote
->B</quote
-> oznacza <quote
->niebieski</quote
->. Przykładem kombinacji RGB jest <userinput
->255,0,0</userinput
->: pierwsza wartość (<quote
->czerwony</quote
->) to 255, natomiast kolejnymi wartościami są 0, więc oznacza to jasny odcień czerwieni. Każda wartość kombinacji RGB musi znajdować się w zakresie od 0 do 255. Oto krótka lista niektórych, często stosowanych kolorów: <table frame="none">
-<title
->Często używane kombinacje RGB</title>
+<glossterm>Kombinacje RGB (kody kolorów)</glossterm>
+<glossdef><para>Kombinacje RGB są wykorzystywane do opisywania kolorów. <quote>R</quote> oznacza <quote>czerwony</quote>, <quote>G</quote> oznacza <quote>zielony</quote>, a <quote>B</quote> oznacza <quote>niebieski</quote>. Przykładem kombinacji RGB jest <userinput>255,0,0</userinput>: pierwsza wartość (<quote>czerwony</quote>) to 255, natomiast kolejnymi wartościami są 0, więc oznacza to jasny odcień czerwieni. Każda wartość kombinacji RGB musi znajdować się w zakresie od 0 do 255. Oto krótka lista niektórych, często stosowanych kolorów: <table frame="none">
+<title>Często używane kombinacje RGB</title>
 <tgroup cols="2" colsep="5" rowsep="1">
 <colspec colname="c1"/>
 <tbody>
-<row
-><entry
-><userinput
->0,0,0</userinput
-></entry
-><entry
->czarny</entry
-></row>
-<row
-><entry
-><userinput
->255,255,255</userinput
-></entry
-><entry
->biały</entry
-></row>
-<row
-><entry
-><userinput
->255,0,0</userinput
-></entry
-><entry
->czerwony</entry
-></row>
-<row
-><entry
-><userinput
->150,0,0</userinput
-></entry
-><entry
->ciemno czerwony</entry
-></row>
-<row
-><entry
-><userinput
->0,255,0</userinput
-></entry
-><entry
->zielony</entry
-></row>
-<row
-><entry
-><userinput
->0,0,255</userinput
-></entry
-><entry
->niebieski</entry
-></row>
-<row
-><entry
-><userinput
->0,255,255</userinput
-></entry
-><entry
->jasno niebieski</entry
-></row>
-<row
-><entry
-><userinput
->255,0,255</userinput
-></entry
-><entry
->różowy</entry
-></row>
-<row
-><entry
-><userinput
->255,255,0</userinput
-></entry
-><entry
->żółty</entry
-></row>
+<row><entry><userinput>0,0,0</userinput></entry><entry>czarny</entry></row>
+<row><entry><userinput>255,255,255</userinput></entry><entry>biały</entry></row>
+<row><entry><userinput>255,0,0</userinput></entry><entry>czerwony</entry></row>
+<row><entry><userinput>150,0,0</userinput></entry><entry>ciemno czerwony</entry></row>
+<row><entry><userinput>0,255,0</userinput></entry><entry>zielony</entry></row>
+<row><entry><userinput>0,0,255</userinput></entry><entry>niebieski</entry></row>
+<row><entry><userinput>0,255,255</userinput></entry><entry>jasno niebieski</entry></row>
+<row><entry><userinput>255,0,255</userinput></entry><entry>różowy</entry></row>
+<row><entry><userinput>255,255,0</userinput></entry><entry>żółty</entry></row>
 </tbody>
 </tgroup>
 </table>
 </para>
-<para
->Aby w łatwy sposób odnaleźć kombinację RGB koloru, powinieneś skorzystać z narzędzia wybierania koloru! Możesz je otworzyć wybierając z menu <link linkend="tools-color-picker"
-><menuchoice
-><guimenu
->Narzędzia</guimenu
-><guimenuitem
->Narzędzie wybierania koloru</guimenuitem
-></menuchoice
-></link
->.</para>
-<para
->Dwa polecenia wymagają kombinacji RGB jako wejścia: tymi poleceniami są <userinput
->kolor_tła</userinput
-> oraz <userinput
->kolor_pisaka</userinput
->.</para
-></glossdef>
+<para>Aby w łatwy sposób odnaleźć kombinację RGB koloru, powinieneś skorzystać z narzędzia wybierania koloru! Możesz je otworzyć wybierając z menu <link linkend="tools-color-picker"><menuchoice><guimenu>Narzędzia</guimenu><guimenuitem>Narzędzie wybierania koloru</guimenuitem></menuchoice></link>.</para>
+<para>Dwa polecenia wymagają kombinacji RGB jako wejścia: tymi poleceniami są <userinput>kolor_tła</userinput> oraz <userinput>kolor_pisaka</userinput>.</para></glossdef>
 </glossentry>
 
 <glossentry id="sprite">
-<glossterm
->sprajt</glossterm>
-<glossdef
-><para
->Sprajt, to niewielki obrazek, który może być przemieszczany po ekranie. Na przykład, nasz kochany żółwik jest sprajtem.</para>
-<para
->Pamiętaj: w tej wersji &kturtle;, sprajt nie może być zmieniony z żółwia na coś innego. Kolejne wersje &kturtle; będą miały taką możliwość.</para
-></glossdef>
+<glossterm>sprajt</glossterm>
+<glossdef><para>Sprajt, to niewielki obrazek, który może być przemieszczany po ekranie. Na przykład, nasz kochany żółwik jest sprajtem.</para>
+<para>Pamiętaj: w tej wersji &kturtle;, sprajt nie może być zmieniony z żółwia na coś innego. Kolejne wersje &kturtle; będą miały taką możliwość.</para></glossdef>
 </glossentry>
 
 <glossentry id="wrapping">
-<glossterm
->zawijanie</glossterm>
-<glossdef
-><para
->Zawijanie odbywa się, gdy żółw rysuje coś, co jest zbyt duże, aby zmieścić się w wyznaczonym obszarze, a zawijanie jest ustawione na <quote
->włączone</quote
->. <screenshot
-> <screeninfo
->Oto, co się dzieje, gdy zawijanie jest <quote
->włączone</quote
-></screeninfo
-> <mediaobject
-> <imageobject
-> <imagedata fileref="wrapping.png" format="PNG"/> </imageobject
-> <textobject
-> <phrase
->Przykład zawijania</phrase
-> </textobject
-> </mediaobject
-> </screenshot
-> Gdy żółw przemieszcza się poza granicę obszaru, zostaje on natychmiast przeniesiony na przeciwną stronę tak, że może on kontynuować swój ruch. W ten sposób, żółw pozostaje zawsze widoczny na ekranie podczas gdy się porusza. Tak się dzieje, gdy zawijanie jest włączone.</para>
-<para
->Zawijanie może być włączane i wyłączane za pomocą poleceń <userinput
->zawijaj</userinput
-> oraz <userinput
->nie_zawijaj</userinput
->. Gdy program &kturtle; zostaje uruchomiony, zawijanie jest włączane domyślnie.</para
-></glossdef>
+<glossterm>zawijanie</glossterm>
+<glossdef><para>Zawijanie odbywa się, gdy żółw rysuje coś, co jest zbyt duże, aby zmieścić się w wyznaczonym obszarze, a zawijanie jest ustawione na <quote>włączone</quote>. <screenshot> <screeninfo>Oto, co się dzieje, gdy zawijanie jest <quote>włączone</quote></screeninfo> <mediaobject> <imageobject> <imagedata fileref="wrapping.png" format="PNG"/> </imageobject> <textobject> <phrase>Przykład zawijania</phrase> </textobject> </mediaobject> </screenshot> Gdy żółw przemieszcza się poza granicę obszaru, zostaje on natychmiast przeniesiony na przeciwną stronę tak, że może on kontynuować swój ruch. W ten sposób, żółw pozostaje zawsze widoczny na ekranie podczas gdy się porusza. Tak się dzieje, gdy zawijanie jest włączone.</para>
+<para>Zawijanie może być włączane i wyłączane za pomocą poleceń <userinput>zawijaj</userinput> oraz <userinput>nie_zawijaj</userinput>. Gdy program &kturtle; zostaje uruchomiony, zawijanie jest włączane domyślnie.</para></glossdef>
 </glossentry>
 
 </glosslist>
diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/index.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/index.docbook
index f47777d18c8..ea2c17bcda7 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/index.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/index.docbook
@@ -5,8 +5,7 @@
   <!ENTITY package "tdeedu">
   <!ENTITY logo "Logo">
   <!ENTITY % addindex "IGNORE">
-  <!ENTITY % Polish "INCLUDE"
-><!-- change language only here -->
+  <!ENTITY % Polish "INCLUDE"><!-- change language only here -->
   <!ENTITY using-kturtle SYSTEM "using-kturtle.docbook">
   <!ENTITY getting-started SYSTEM "getting-started.docbook">
   <!ENTITY programming-reference SYSTEM "programming-reference.docbook">
@@ -17,202 +16,77 @@
 <book lang="&language;">
 
 <bookinfo>
-<title
->Podręcznik użytkownika &kturtle;</title>
+<title>Podręcznik użytkownika &kturtle;</title>
 
 <authorgroup>
-<author
-><firstname
->Cies</firstname
-> <surname
->Breijs</surname
-> <affiliation
-> <address
-><email
->cies MAŁPA kde KROPKA nl</email
-></address>
+<author><firstname>Cies</firstname> <surname>Breijs</surname> <affiliation> <address><email>cies MAŁPA kde KROPKA nl</email></address>
 </affiliation>
 </author>
-<author
-><firstname
->Anne-Marie</firstname
-> <surname
->Mahfouf</surname
-> <affiliation
-> <address
-><email
->annma MAŁPA kde KROPKA org</email
-></address>
+<author><firstname>Anne-Marie</firstname> <surname>Mahfouf</surname> <affiliation> <address><email>annma MAŁPA kde KROPKA org</email></address>
 </affiliation>
 </author>
-<othercredit role="translator"
-><firstname
-></firstname
-><surname
-></surname
-> <affiliation
-><address
-><email
->biuro@mandriva.pl</email
-></address
-></affiliation
-><contrib
-></contrib
-></othercredit
-> <othercredit role="translator"
-><firstname
->Krzysztof</firstname
-><surname
->Lichota</surname
-> <affiliation
-><address
-><email
->lichota@mimuw.edu.pl</email
-></address
-></affiliation
-><contrib
-></contrib
-></othercredit
-> 
+<othercredit role="translator"><firstname></firstname><surname></surname> <affiliation><address><email>biuro@mandriva.pl</email></address></affiliation><contrib></contrib></othercredit> <othercredit role="translator"><firstname>Krzysztof</firstname><surname>Lichota</surname> <affiliation><address><email>lichota@mimuw.edu.pl</email></address></affiliation><contrib></contrib></othercredit> 
 </authorgroup>
 
 
 <copyright>
-<year
->2004</year>
-<holder
->Cies Breijs</holder>
+<year>2004</year>
+<holder>Cies Breijs</holder>
 </copyright>
 
-<legalnotice
->&FDLNotice;</legalnotice>
+<legalnotice>&FDLNotice;</legalnotice>
 
-<date
->2005-12-10</date>
-<releaseinfo
->0.6</releaseinfo>
+<date>2005-12-10</date>
+<releaseinfo>0.6</releaseinfo>
 
 <abstract>
-<para
->&kturtle; to edukacyjne środowisko programistyczne wykorzystujące język programowania &logo;. Unikatową cechą LOGO jest to, że polecenia programowania są tłumaczone na język programisty, więc może on/ona programować we własnym języku. </para>
+<para>&kturtle; to edukacyjne środowisko programistyczne wykorzystujące język programowania &logo;. Unikatową cechą LOGO jest to, że polecenia programowania są tłumaczone na język programisty, więc może on/ona programować we własnym języku. </para>
 </abstract>
 
 <keywordset>
-<keyword
->KDE</keyword>
-<keyword
->tdeedu</keyword>
-<keyword
->KTurtle</keyword>
-<keyword
->adukacja</keyword>
-<keyword
->język</keyword>
-<keyword
->ojczysty</keyword>
-<keyword
->programowanie</keyword>
-<keyword
->kod</keyword>
-<keyword
->&logo;</keyword>
-<keyword
->instrukcje</keyword>
-<keyword
->żółw</keyword>
+<keyword>KDE</keyword>
+<keyword>tdeedu</keyword>
+<keyword>KTurtle</keyword>
+<keyword>adukacja</keyword>
+<keyword>język</keyword>
+<keyword>ojczysty</keyword>
+<keyword>programowanie</keyword>
+<keyword>kod</keyword>
+<keyword>&logo;</keyword>
+<keyword>instrukcje</keyword>
+<keyword>żółw</keyword>
 </keywordset>
 
 </bookinfo>
 
 <chapter id="introduction">
-<title
->Wprowadzenie</title>
+<title>Wprowadzenie</title>
 
-<para
->&kturtle; jest edukacyjnym środowiskiem programistycznym wykorzystującym język programowania <link linkend="what-is-logo"
->&logo;</link
->. Celem &kturtle; jest maksymalne ułatwienie programowania. Czyni to ten program odpowiednim do uczenia dzieci podstaw matematyki, geometrii i ... programowania. Wyjątkową cechą języka programowania &logo; jest to, że polecenia są tłumaczone na język, którym mówi programista.</para>
+<para>&kturtle; jest edukacyjnym środowiskiem programistycznym wykorzystującym język programowania <link linkend="what-is-logo">&logo;</link>. Celem &kturtle; jest maksymalne ułatwienie programowania. Czyni to ten program odpowiednim do uczenia dzieci podstaw matematyki, geometrii i ... programowania. Wyjątkową cechą języka programowania &logo; jest to, że polecenia są tłumaczone na język, którym mówi programista.</para>
 
-<para
->&kturtle; bierze swoją nazwę od <quote
->żółwia</quote
->, który odgrywa kluczową rolę w środowisku programistycznym. Użytkownik programuje żółwia korzystając z poleceń &logo;, aby ten rysował rysunek na <link linkend="the-canvas"
->płótnie</link
->.</para>
+<para>&kturtle; bierze swoją nazwę od <quote>żółwia</quote>, który odgrywa kluczową rolę w środowisku programistycznym. Użytkownik programuje żółwia korzystając z poleceń &logo;, aby ten rysował rysunek na <link linkend="the-canvas">płótnie</link>.</para>
 
 <sect1 id="what-is-logo">
-<title
->Czym jest &logo;?</title>
-<para
->Pierwsza wersja języka programowania &logo; została utworzona przez Seymour'a Papert'a z MIT Artificial Intelligence Laboratory w 1967 jako pochodna języka programowania LISP. Od tego czasu wydanych zostało wiele wersji &logo;. Do roku 1980, &logo; zyskiwał na sile, a jego wersje przeznaczone były na takie komputery jak MSX, Commodore, Atari, Apple II oraz IBM PC. Wersje te były przeznaczone głównie do celów edukacyjnych. LCSI wydało <application
->&Mac;&logo;</application
-> w 1985 roku jako narzędzie dla profesjonalnych programistów, które nigdy się nie przyjęło. MIT w dalszym ciągu utrzymuje stronę internetową &logo;, którą można odnaleźć pod adresem <ulink url="http://el.media.mit.edu/logo-foundation/"
->http://el.media.mit.edu/logo-foundation/</ulink
->.</para>
-
-<para
->Dziś istnieje kilka wersji &logo;, które można łatwo odnaleźć na <ulink url="http://el.media.mit.edu/logo-foundation/"
->stronie &logo;</ulink
-> utrzymywanej przez MIT oraz za pomocą zwykłego <ulink url="http://www.google.com/search?q=logo+programming+kids"
->wyszukiwania Google</ulink
->. Ta wersja &logo; (&kturtle;) skupia się tylko na wartościach edukacyjnych języka programowania i nie ma na celu spełnienia oczekiwań profesjonalnych programistów.</para>
+<title>Czym jest &logo;?</title>
+<para>Pierwsza wersja języka programowania &logo; została utworzona przez Seymour'a Papert'a z MIT Artificial Intelligence Laboratory w 1967 jako pochodna języka programowania LISP. Od tego czasu wydanych zostało wiele wersji &logo;. Do roku 1980, &logo; zyskiwał na sile, a jego wersje przeznaczone były na takie komputery jak MSX, Commodore, Atari, Apple II oraz IBM PC. Wersje te były przeznaczone głównie do celów edukacyjnych. LCSI wydało <application>&Mac;&logo;</application> w 1985 roku jako narzędzie dla profesjonalnych programistów, które nigdy się nie przyjęło. MIT w dalszym ciągu utrzymuje stronę internetową &logo;, którą można odnaleźć pod adresem <ulink url="http://el.media.mit.edu/logo-foundation/">http://el.media.mit.edu/logo-foundation/</ulink>.</para>
+
+<para>Dziś istnieje kilka wersji &logo;, które można łatwo odnaleźć na <ulink url="http://el.media.mit.edu/logo-foundation/">stronie &logo;</ulink> utrzymywanej przez MIT oraz za pomocą zwykłego <ulink url="http://www.google.com/search?q=logo+programming+kids">wyszukiwania Google</ulink>. Ta wersja &logo; (&kturtle;) skupia się tylko na wartościach edukacyjnych języka programowania i nie ma na celu spełnienia oczekiwań profesjonalnych programistów.</para>
 </sect1>
 
 <sect1 id="features-of-kturtle">
-<title
->Cechy &kturtle;</title>
-<para
->&kturtle; posiada kilka użytecznych cech, które czynią korzystanie z programu bardzo prostym. Oto kilka cech funkcji programu &kturtle;: <itemizedlist>
-<listitem
-><para
->Zintegrowany interpreter &logo; (bez dodatkowych zależności), który wykorzystuje pliki &XML; dla tłumaczenia poleceń, obsługuje funkcje zdefiniowane przez użytkownika oraz dynamiczne rzutowanie typów. </para
-></listitem>
-<listitem
-><para
->Wykonywanie polecenia może być zwolnione, wstrzymane lub zatrzymane w każdej chwili. </para
-></listitem>
-<listitem
-><para
->Funkcjonalny edytor poleceń &logo; z intuicyjnym kolorowaniem składni, numeracją wierszy, itp. </para
-></listitem>
-<listitem
-><para
-><link linkend="the-canvas"
->Płótna</link
-> mogą być zapisywane jako obraz lub drukowane. </para
-></listitem>
-<listitem
-><para
-><link linkend="the-canvas"
->Płótna</link
-> posiadają tryb zawijania (domyślnie włączony), więc żółw łatwo się nie zgubi. </para
-></listitem>
-<listitem
-><para
->Pomoc kontekstowa dla wszystkich poleceń &logo;: Wystarczy wcisnąć <keysym
->F2</keysym
->. </para
-></listitem>
-<listitem
-><para
->Polecenia &logo; są w pełni przetłumaczalne (w chwili obecnej obsługiwane są języki brazylijski portugalski, holenderski, francuski, niemiecki, włoski, słoweński, serbski (cyrylica i skrypt łaciński), hiszpański i szwedzki). </para
-></listitem>
-<listitem
-><para
->Okno błędów, które łączy komunikaty błędów z błędami w programie. </para
-></listitem>
-<listitem
-><para
->Uproszczona terminologia programowania. </para
-></listitem>
-<listitem
-><para
->Tryb pełnoekranowy. </para
-></listitem>
-<listitem
-><para
->Wiele zintegrowanych, umiędzynarodowionych przykładowych programów &logo; ułatwia rozpoczęcie z nim pracy. </para
-></listitem>
+<title>Cechy &kturtle;</title>
+<para>&kturtle; posiada kilka użytecznych cech, które czynią korzystanie z programu bardzo prostym. Oto kilka cech funkcji programu &kturtle;: <itemizedlist>
+<listitem><para>Zintegrowany interpreter &logo; (bez dodatkowych zależności), który wykorzystuje pliki &XML; dla tłumaczenia poleceń, obsługuje funkcje zdefiniowane przez użytkownika oraz dynamiczne rzutowanie typów. </para></listitem>
+<listitem><para>Wykonywanie polecenia może być zwolnione, wstrzymane lub zatrzymane w każdej chwili. </para></listitem>
+<listitem><para>Funkcjonalny edytor poleceń &logo; z intuicyjnym kolorowaniem składni, numeracją wierszy, itp. </para></listitem>
+<listitem><para><link linkend="the-canvas">Płótna</link> mogą być zapisywane jako obraz lub drukowane. </para></listitem>
+<listitem><para><link linkend="the-canvas">Płótna</link> posiadają tryb zawijania (domyślnie włączony), więc żółw łatwo się nie zgubi. </para></listitem>
+<listitem><para>Pomoc kontekstowa dla wszystkich poleceń &logo;: Wystarczy wcisnąć <keysym>F2</keysym>. </para></listitem>
+<listitem><para>Polecenia &logo; są w pełni przetłumaczalne (w chwili obecnej obsługiwane są języki brazylijski portugalski, holenderski, francuski, niemiecki, włoski, słoweński, serbski (cyrylica i skrypt łaciński), hiszpański i szwedzki). </para></listitem>
+<listitem><para>Okno błędów, które łączy komunikaty błędów z błędami w programie. </para></listitem>
+<listitem><para>Uproszczona terminologia programowania. </para></listitem>
+<listitem><para>Tryb pełnoekranowy. </para></listitem>
+<listitem><para>Wiele zintegrowanych, umiędzynarodowionych przykładowych programów &logo; ułatwia rozpoczęcie z nim pracy. </para></listitem>
 </itemizedlist>
 </para>
 </sect1>
@@ -230,148 +104,64 @@
 
 <chapter id="credits">
 
-<title
->Autorzy i licencje</title>
-
-<para
->&kturtle; </para>
-<para
->Prawa autorskie programu 2003-2005 Cies Breijs <email
->cies MAŁPA kde KROPKA nl</email
-></para>
-<para
->Współtwórcy: <itemizedlist>
-<listitem
-><para
->Pomoc dla kodowania, edytor: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</para>
+<title>Autorzy i licencje</title>
+
+<para>&kturtle; </para>
+<para>Prawa autorskie programu 2003-2005 Cies Breijs <email>cies MAŁPA kde KROPKA nl</email></para>
+<para>Współtwórcy: <itemizedlist>
+<listitem><para>Pomoc dla kodowania, edytor: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</para>
 </listitem>
-<listitem
-><para
->Autorka <application
->WSBASIC</application
-> (<ulink url="http://wsbasic.sourceforge.net"
->http://wsbasic.sourceforge.net</ulink
->) co jest podstawą interpretora &kturtle;: Walter Schreppers <email
->Walter KROPKA Schreppers MAŁPA ua KROPKA ac KROPKA be</email
-></para>
+<listitem><para>Autorka <application>WSBASIC</application> (<ulink url="http://wsbasic.sourceforge.net">http://wsbasic.sourceforge.net</ulink>) co jest podstawą interpretora &kturtle;: Walter Schreppers <email>Walter KROPKA Schreppers MAŁPA ua KROPKA ac KROPKA be</email></para>
 </listitem>
-<listitem
-><para
->Niemieckie pliki danych: Matthias Me&szlig;mer <email
->bmlmessmer MAŁPA web KROPKA de</email
-></para>
+<listitem><para>Niemieckie pliki danych: Matthias Me&szlig;mer <email>bmlmessmer MAŁPA web KROPKA de</email></para>
 </listitem>
-<listitem
-><para
->Niemieckie pliki danych: Burkhard L&uuml;ck <email
->lueck MAŁPA hube-lueck KROPKA de</email
-></para>
+<listitem><para>Niemieckie pliki danych: Burkhard L&uuml;ck <email>lueck MAŁPA hube-lueck KROPKA de</email></para>
 </listitem>
-<listitem
-><para
->Szwedzkie pliki danych: Stefan Asserh&#228;ll <email
->stefan KROPKA asserhal MAŁPA telia KROPKA com</email
-></para>
+<listitem><para>Szwedzkie pliki danych: Stefan Asserh&#228;ll <email>stefan KROPKA asserhal MAŁPA telia KROPKA com</email></para>
 </listitem>
-<listitem
-><para
->Słoweńskie pliki danych: Jure Repinc <email
->jlp@holodeck1.com</email
-></para>
+<listitem><para>Słoweńskie pliki danych: Jure Repinc <email>jlp@holodeck1.com</email></para>
 </listitem>
-<listitem
-><para
->Serbskie (Cyrylica Łacińska) pliki danych: Chusslove Illich <email
->caslav.ilic@gmx.net</email
-></para>
+<listitem><para>Serbskie (Cyrylica Łacińska) pliki danych: Chusslove Illich <email>caslav.ilic@gmx.net</email></para>
 </listitem>
-<listitem
-><para
->Włoskie pliki danych: Pino Toscano <email
->toscano.pino@tiscali.it</email
-></para>
+<listitem><para>Włoskie pliki danych: Pino Toscano <email>toscano.pino@tiscali.it</email></para>
 </listitem>
-<listitem
-><para
->Engielskie brytyjskie pliki danych: Andy Potter <email
->A.J.Potter@rhul.ac.uk</email
-></para>
+<listitem><para>Engielskie brytyjskie pliki danych: Andy Potter <email>A.J.Potter@rhul.ac.uk</email></para>
 </listitem>
-<listitem
-><para
->Hiszpańskie pliki danych: Rafael Beccar <email
->rafael.beccar@kdemail.net</email
-></para>
+<listitem><para>Hiszpańskie pliki danych: Rafael Beccar <email>rafael.beccar@kdemail.net</email></para>
 </listitem>
-<listitem
-><para
->Brazylijskie portugalskie pliki danych: Riverson Rios <email
->riverson@ccv.ufc.br</email
-></para>
+<listitem><para>Brazylijskie portugalskie pliki danych: Riverson Rios <email>riverson@ccv.ufc.br</email></para>
 </listitem>
-<listitem
-><para
->Norweskie Nynorsk i Bokmål pliki danych: Karl Ove Hufthammer <email
->karl@huftis.org</email
-></para>
+<listitem><para>Norweskie Nynorsk i Bokmål pliki danych: Karl Ove Hufthammer <email>karl@huftis.org</email></para>
 </listitem>
-<listitem
-><para
->Obsługa parsera cyrylicy: Albert Astals Cid <email
->astals11@terra.es</email
-></para>
+<listitem><para>Obsługa parsera cyrylicy: Albert Astals Cid <email>astals11@terra.es</email></para>
 </listitem>
 </itemizedlist>
 </para>
 
-<para
->Prawa autorskie dokumentacji 2004 <itemizedlist>
-<listitem
-><para
->Cies Breijs <email
->cies MAŁPA kde DOTKROPKA nl</email
-> </para
-></listitem>
-<listitem
-><para
->&Anne-Marie.Mahfouf; <email
->annma MAŁPA kde KROPKA org</email
-> </para
-></listitem>
-<listitem
-><para
->Korekta: &Philip.Rodrigues; &Philip.Rodrigues.mail;</para>
+<para>Prawa autorskie dokumentacji 2004 <itemizedlist>
+<listitem><para>Cies Breijs <email>cies MAŁPA kde DOTKROPKA nl</email> </para></listitem>
+<listitem><para>&Anne-Marie.Mahfouf; <email>annma MAŁPA kde KROPKA org</email> </para></listitem>
+<listitem><para>Korekta: &Philip.Rodrigues; &Philip.Rodrigues.mail;</para>
 </listitem>
-<listitem
-><para
->Zaktualizowane tłumaczenie how-to i zmiany korekcyjne: Andrew Coles <email
->andrew_coles MAŁPA yahoo KROPKA co KROPKA uk</email
-></para>
+<listitem><para>Zaktualizowane tłumaczenie how-to i zmiany korekcyjne: Andrew Coles <email>andrew_coles MAŁPA yahoo KROPKA co KROPKA uk</email></para>
 </listitem>
 
 </itemizedlist>
 </para>
-<para
->Mandriva Poland<email
->biuro@mandriva.pl</email
-></para
-> 
+<para>Mandriva Poland<email>biuro@mandriva.pl</email></para> 
 &underFDL; &underGPL; </chapter>
 
 
 
 <appendix id="installation">
-<title
->Instalacja</title>
+<title>Instalacja</title>
 
 <sect1 id="getting-kturtle">
-<title
->Skąd uzyskać &kturtle;</title>
+<title>Skąd uzyskać &kturtle;</title>
 &install.intro.documentation; </sect1>
 
 <sect1 id="compilation">
-<title
->Kompilacja i instalacja</title>
+<title>Kompilacja i instalacja</title>
 &install.compile.documentation; </sect1>
 
 </appendix>
diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/programming-reference.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/programming-reference.docbook
index d7120b30274..94893eda819 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/programming-reference.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/programming-reference.docbook
@@ -1,179 +1,58 @@
 <!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
      Thanks a lot in advance.-->
 <chapter id="reference">
-<title
->Dokumentacja programistyczna języka &logo; &kturtle;</title>
-<para
->Poniżej znajduje się dokumentacja języka &logo; używanego przez &kturtle;. W tym rozdziale najpierw zostaną krótko wymienione <link linkend="different-instructions"
->różne typy instrukcji</link
->. Następnie zostaną objaśnione <link linkend="commands"
->komendy</link
->. Po nich <link linkend="containers"
->kontenery</link
->, <link linkend="math"
->terminy matematyczne</link
->, <link linkend="questions"
->zapytania</link
-> oraz <link linkend="controlling-execution"
->kontrolery wykonawcze</link
->. Na końcu pokazane zostanie jak za pomocą <link linkend="learn"
->nauczyciela</link
-> tworzyć własne komendy.</para>
+<title>Dokumentacja programistyczna języka &logo; &kturtle;</title>
+<para>Poniżej znajduje się dokumentacja języka &logo; używanego przez &kturtle;. W tym rozdziale najpierw zostaną krótko wymienione <link linkend="different-instructions">różne typy instrukcji</link>. Następnie zostaną objaśnione <link linkend="commands">komendy</link>. Po nich <link linkend="containers">kontenery</link>, <link linkend="math">terminy matematyczne</link>, <link linkend="questions">zapytania</link> oraz <link linkend="controlling-execution">kontrolery wykonawcze</link>. Na końcu pokazane zostanie jak za pomocą <link linkend="learn">nauczyciela</link> tworzyć własne komendy.</para>
 
 <sect1 id="different-instructions">
-<title
->Różne typy instrukcji</title>
-<para
->Jak każdy inny język programowania ,LOGO posiada różne typy wyrazów i symboli. Oto różnice pomiędzy typami i krótkie wyjaśnienia.</para>
+<title>Różne typy instrukcji</title>
+<para>Jak każdy inny język programowania ,LOGO posiada różne typy wyrazów i symboli. Oto różnice pomiędzy typami i krótkie wyjaśnienia.</para>
 
 <sect2 id="command">
-<title
->Komendy</title>
-<para
->Przy użyciu komend wskazujemy &kturtle; czynności do wykonania. Niektóre z komend potrzebują argumentów wejściowych a inne wyjściowych. <screen
-># naprzód to komenda z argumentem wejściowym, tutaj jest to liczba 100:
+<title>Komendy</title>
+<para>Przy użyciu komend wskazujemy &kturtle; czynności do wykonania. Niektóre z komend potrzebują argumentów wejściowych a inne wyjściowych. <screen># naprzód to komenda z argumentem wejściowym, tutaj jest to liczba 100:
 naprzód 100
 </screen>
 </para>
-<para
->Szczegółowy opis wszystkich komend &kturtle; znajduje się <link linkend="commands"
->tutaj</link
->.</para>
+<para>Szczegółowy opis wszystkich komend &kturtle; znajduje się <link linkend="commands">tutaj</link>.</para>
 </sect2>
 
 <sect2 id="number">
-<title
->Liczby</title>
-<para
->Każdy użytkownik z pewnością wie trochę o liczbach. Sposób w jaki liczby używane są przez &kturtle; niezbyt różni się od języka mówionego czy matematyki. </para>
-<para
->Mamy liczby naturalne: <userinput
->0</userinput
->, <userinput
->1</userinput
->, <userinput
->2</userinput
->, <userinput
->3</userinput
->, <userinput
->4</userinput
->, <userinput
->5</userinput
->, itd. Liczby ujemne: <userinput
->-1</userinput
->, <userinput
->-2</userinput
->, <userinput
->-3</userinput
->, itd. Oraz liczby dziesiętne np: <userinput
->0.1</userinput
->, <userinput
->3.14</userinput
->, <userinput
->33.3333</userinput
->, <userinput
->-5.05</userinput
->, <userinput
->-1.0</userinput
->. </para>
-<para
->Liczby mogą być używane w <link linkend="math"
->obliczeniach matematycznych</link
-> oraz <link linkend="questions"
->zapytaniach</link
->. Mogą być również wkładane do <link linkend="containers"
->kontenerów</link
->.</para>
-<para
->W <link linkend="the-code-editor"
->edytorze kodów</link
-> liczby są <glossterm
->podświetlone</glossterm
-> na niebiesko.</para>
+<title>Liczby</title>
+<para>Każdy użytkownik z pewnością wie trochę o liczbach. Sposób w jaki liczby używane są przez &kturtle; niezbyt różni się od języka mówionego czy matematyki. </para>
+<para>Mamy liczby naturalne: <userinput>0</userinput>, <userinput>1</userinput>, <userinput>2</userinput>, <userinput>3</userinput>, <userinput>4</userinput>, <userinput>5</userinput>, itd. Liczby ujemne: <userinput>-1</userinput>, <userinput>-2</userinput>, <userinput>-3</userinput>, itd. Oraz liczby dziesiętne np: <userinput>0.1</userinput>, <userinput>3.14</userinput>, <userinput>33.3333</userinput>, <userinput>-5.05</userinput>, <userinput>-1.0</userinput>. </para>
+<para>Liczby mogą być używane w <link linkend="math">obliczeniach matematycznych</link> oraz <link linkend="questions">zapytaniach</link>. Mogą być również wkładane do <link linkend="containers">kontenerów</link>.</para>
+<para>W <link linkend="the-code-editor">edytorze kodów</link> liczby są <glossterm>podświetlone</glossterm> na niebiesko.</para>
 </sect2>
 
 <sect2 id="string">
-<title
->Łańcuchy znaków</title>
-<para
->Najpierw przykład: <screen>
+<title>Łańcuchy znaków</title>
+<para>Najpierw przykład: <screen>
 pisz "Cześć, Jestem łańcuchem znaków."
-</screen
-> W tym przykładzie <userinput
->pisz</userinput
-> jest komendą a <userinput
->"Cześć, Jestem łańcuchem znaków."</userinput
-> łańcuchem znaków. Łańcuch zaczyna i kończy się znakiem <userinput
->"</userinput
->, dzięki niemu &kturtle; rozpoznaje łańcuch znakowy.</para>
-<para
->Łańcuchy mogą być wkładane do <link linkend="containers"
->kontenerów</link
->. ale nie mogą być używane w <link linkend="math"
->obliczeniach matematycznych</link
-> i <link linkend="questions"
->zapytaniach</link
->.</para>
-<para
->W <link linkend="the-code-editor"
->edytorze kodów</link
-> liczby są <glossterm
->podświetlone</glossterm
-> na kolor ciemnoczerwony.</para>
+</screen> W tym przykładzie <userinput>pisz</userinput> jest komendą a <userinput>"Cześć, Jestem łańcuchem znaków."</userinput> łańcuchem znaków. Łańcuch zaczyna i kończy się znakiem <userinput>"</userinput>, dzięki niemu &kturtle; rozpoznaje łańcuch znakowy.</para>
+<para>Łańcuchy mogą być wkładane do <link linkend="containers">kontenerów</link>. ale nie mogą być używane w <link linkend="math">obliczeniach matematycznych</link> i <link linkend="questions">zapytaniach</link>.</para>
+<para>W <link linkend="the-code-editor">edytorze kodów</link> liczby są <glossterm>podświetlone</glossterm> na kolor ciemnoczerwony.</para>
 </sect2>
 
 
 <sect2 id="name">
-<title
->Nazwy</title>
-<para
->Przy użyciu języka programowania &logo; tworzy się nowe obiekty. Pisząc programy często potrzebować będziemy <link linkend="containers"
->kontenerów</link
-> a w  niektórych przypadkach <link linkend="learn"
->nauczyciela</link
-> do tworzenia nowych komend. Tworząc <link linkend="containers"
->kontener</link
-> lub nową komendę za pomocą <link linkend="learn"
->nauczyciela</link
-> należy określić ich nazwę.</para>
-<para
->Można wybrać dowolną nazwę, pod warunkiem, iż nie odnosi się ona już do niczego. Np. nie można nazwać kontenera <link linkend="forward"
->naprzód</link
->, jako, że jest to nazwa komendy. <screen>
+<title>Nazwy</title>
+<para>Przy użyciu języka programowania &logo; tworzy się nowe obiekty. Pisząc programy często potrzebować będziemy <link linkend="containers">kontenerów</link> a w  niektórych przypadkach <link linkend="learn">nauczyciela</link> do tworzenia nowych komend. Tworząc <link linkend="containers">kontener</link> lub nową komendę za pomocą <link linkend="learn">nauczyciela</link> należy określić ich nazwę.</para>
+<para>Można wybrać dowolną nazwę, pod warunkiem, iż nie odnosi się ona już do niczego. Np. nie można nazwać kontenera <link linkend="forward">naprzód</link>, jako, że jest to nazwa komendy. <screen>
 # tutaj naprzód jest używane jako kontener, ale ta nazwa jest już używana jako komenda
 # zatem pokaże się komunikat błędu:
 naprzód = 20
 
 # natomiast działać będzie:
 naprzód 20
-</screen
-> Nazwy mogą zawierać tylko litery, cyfry oraz linie poziome (_). ale muszą zaczynać się od litery. </para>
-<para
->Więcej przykładów oraz dokładniejsze wyjaśnienie znajduje się w dokumentacji <link linkend="containers"
->kontenerów</link
-> oraz <link linkend="learn"
->nauczyciela</link
->. </para>
+</screen> Nazwy mogą zawierać tylko litery, cyfry oraz linie poziome (_). ale muszą zaczynać się od litery. </para>
+<para>Więcej przykładów oraz dokładniejsze wyjaśnienie znajduje się w dokumentacji <link linkend="containers">kontenerów</link> oraz <link linkend="learn">nauczyciela</link>. </para>
 </sect2>
 
 <sect2 id="assignment">
-<title
->Przypisania</title>
-<para
->Przypisań dokonuje się za pomocą symbolu <userinput
->=</userinput
->. W językach programowania zaleca się czytanie symbolu <userinput
->=</userinput
-> nie jako równa się ale jako oznacza. Zwrot równa się bardziej  odpowiada symbolowi <userinput
->==</userinput
-> będącemu <link linkend="questions"
->zapytaniem</link
->.</para>
-<para
->Przypisań dokonuje się z dwóch powodów, (1) by dodać zawartość do <link linkend="containers"
->kontenerów</link
->, oraz (2) by zmodyfikować zawartość kontenerów. Na przykład: <screen
->x = 10
+<title>Przypisania</title>
+<para>Przypisań dokonuje się za pomocą symbolu <userinput>=</userinput>. W językach programowania zaleca się czytanie symbolu <userinput>=</userinput> nie jako równa się ale jako oznacza. Zwrot równa się bardziej  odpowiada symbolowi <userinput>==</userinput> będącemu <link linkend="questions">zapytaniem</link>.</para>
+<para>Przypisań dokonuje się z dwóch powodów, (1) by dodać zawartość do <link linkend="containers">kontenerów</link>, oraz (2) by zmodyfikować zawartość kontenerów. Na przykład: <screen>x = 10
 # kontener x zawiera teraz liczbę 10
 W = "Mój wiek to: "
 # kontener W zawiera teraz łańcuch"Mój wiek to: "
@@ -181,811 +60,359 @@ W = "Mój wiek to: "
 pisz W + x
 </screen>
 </para>
-<para
->Więcej przykładów znajduje się z sekcji wyjaśniającej <link linkend="containers"
->kontenery</link
->.</para>
+<para>Więcej przykładów znajduje się z sekcji wyjaśniającej <link linkend="containers">kontenery</link>.</para>
 </sect2>
 
 <sect2 id="math-symbols">
-<title
->Symbole matematyczne</title>
-<para
->&kturtle; rozpoznaje wszystkie podstawowe symbole matematyczne: plus (<userinput
->+</userinput
->), minus (<userinput
->-</userinput
->), mnożenie (<userinput
->*</userinput
->), dzielenie (<userinput
->/</userinput
->) oraz nawiasy <userinput
->(</userinput
-> i <userinput
->)</userinput
->.</para>
-<para
->Dokładniejsze wyjaśnienie i więcej przykładów znajduje się w sekcji <link linkend="math"
->matematyka</link
->.</para>
+<title>Symbole matematyczne</title>
+<para>&kturtle; rozpoznaje wszystkie podstawowe symbole matematyczne: plus (<userinput>+</userinput>), minus (<userinput>-</userinput>), mnożenie (<userinput>*</userinput>), dzielenie (<userinput>/</userinput>) oraz nawiasy <userinput>(</userinput> i <userinput>)</userinput>.</para>
+<para>Dokładniejsze wyjaśnienie i więcej przykładów znajduje się w sekcji <link linkend="math">matematyka</link>.</para>
 </sect2>
 
 <sect2 id="question">
-<title
->Zapytania</title>
-<para
->Możemy zadać proste pytania, na które możliwe są jedynie odpowiedzi 'prawda' lub 'fałsz'.</para>
-<para
->Użycie pytań jest dokładniej wyjaśnione w sekcji <link linkend="questions"
->zapytania</link
->.</para>
+<title>Zapytania</title>
+<para>Możemy zadać proste pytania, na które możliwe są jedynie odpowiedzi 'prawda' lub 'fałsz'.</para>
+<para>Użycie pytań jest dokładniej wyjaśnione w sekcji <link linkend="questions">zapytania</link>.</para>
 </sect2>
 
 <sect2 id="questions-glue">
-<title
->Wyrazy łączące pytania</title>
-<para
->Zapytania mogą być składane razem dzięki tak zwanym wyrazom łączącym. Takimi wyrazami są <userinput
->i</userinput
->, <userinput
->lub</userinput
->, oraz: <userinput
->nie</userinput
->.</para>
-<para
->Użycie wyrazów łączących pytania wyjaśnione jest w sekcji <link linkend="question-glue"
->Łączenie pytań</link
->.</para>
+<title>Wyrazy łączące pytania</title>
+<para>Zapytania mogą być składane razem dzięki tak zwanym wyrazom łączącym. Takimi wyrazami są <userinput>i</userinput>, <userinput>lub</userinput>, oraz: <userinput>nie</userinput>.</para>
+<para>Użycie wyrazów łączących pytania wyjaśnione jest w sekcji <link linkend="question-glue">Łączenie pytań</link>.</para>
 </sect2>
 
 
 <sect2 id="comment">
-<title
->Komentarze</title>
-<para
->Komentarzami są linie zaczynające się od <userinput
->#</userinput
->. Na przykład: <screen>
+<title>Komentarze</title>
+<para>Komentarzami są linie zaczynające się od <userinput>#</userinput>. Na przykład: <screen>
 # to jest komentarz!
 pisz "to nie jest komentarz"
 # poprzednia linia nie jest komentarzem natomiast wcześniejsza jest:
 # pisz "to nie jest komentarz"
-</screen
-> Do kodu możemy dodawać komentarze dla nas bądź dla innych czytających. Komentarzy używa się do: (1) dodawania krótkich opisów programu, (2) wyjaśniania jak działa dany fragment kodu, oraz (3) wykomentowania linii kodu, które powinny być ignorowane (chwilowo) (patrz ostatnia linia przykładu).</para>
-<para
->W <link linkend="the-code-editor"
->edytorze kodów</link
-> komentarze są <glossterm
->podświetlone</glossterm
-> na kolor ciemnożółty.</para>
+</screen> Do kodu możemy dodawać komentarze dla nas bądź dla innych czytających. Komentarzy używa się do: (1) dodawania krótkich opisów programu, (2) wyjaśniania jak działa dany fragment kodu, oraz (3) wykomentowania linii kodu, które powinny być ignorowane (chwilowo) (patrz ostatnia linia przykładu).</para>
+<para>W <link linkend="the-code-editor">edytorze kodów</link> komentarze są <glossterm>podświetlone</glossterm> na kolor ciemnożółty.</para>
 </sect2>
 
 </sect1>
 
 
 <sect1 id="commands">
-<title
->Komendy</title>
-<para
->Używając komend mówimy żółwiowi lub &kturtle; by wykonywał konkretne polecenia. Niektóre komendy wymagają argumentów wyjściowych a niektóre dają coś na wyjściu. W tej sekcji wyjaśniamy działanie wszystkich komend używanych przez &kturtle;. Należy zauważyć, że wszystkie omawiane tutaj wbudowane komendy są w <link linkend="the-code-editor"
->edytorze kodu</link
-> <glossterm
->podświetlone</glossterm
-> na kolor ciemnozielony, co pomaga je rozróżnić.</para>
+<title>Komendy</title>
+<para>Używając komend mówimy żółwiowi lub &kturtle; by wykonywał konkretne polecenia. Niektóre komendy wymagają argumentów wyjściowych a niektóre dają coś na wyjściu. W tej sekcji wyjaśniamy działanie wszystkich komend używanych przez &kturtle;. Należy zauważyć, że wszystkie omawiane tutaj wbudowane komendy są w <link linkend="the-code-editor">edytorze kodu</link> <glossterm>podświetlone</glossterm> na kolor ciemnozielony, co pomaga je rozróżnić.</para>
 
 <sect2 id="moving-the-turtle">
-<title
->Poruszanie żółwia</title>
-<para
->Do poruszania żółwia po ekranie służy kilka komend</para>
+<title>Poruszanie żółwia</title>
+<para>Do poruszania żółwia po ekranie służy kilka komend</para>
   
 <sect3 id="forward">
-  <title
->naprzód (np)</title>
+  <title>naprzód (np)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->naprzód</term>
-      <listitem
-><para
-><screen
->naprzód X</screen>
-<userinput
->naprzód</userinput
-> przesuwa żółwia do przodu o X pikseli. Gdy ołówek jest skierowany w dół żółw zostawia ślad. <userinput
->naprzód</userinput
-> może być użyty za pomocą skrótu <userinput
->np</userinput
-></para
-></listitem>
+    <varlistentry> 
+      <term>naprzód</term>
+      <listitem><para><screen>naprzód X</screen>
+<userinput>naprzód</userinput> przesuwa żółwia do przodu o X pikseli. Gdy ołówek jest skierowany w dół żółw zostawia ślad. <userinput>naprzód</userinput> może być użyty za pomocą skrótu <userinput>np</userinput></para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="backward">
-  <title
->wstecz (ws)</title>
+  <title>wstecz (ws)</title>
   <variablelist>
-    <varlistentry
->  
-      <term
->w tył</term>
-      <listitem
-><para
-><screen
->wstecz X</screen>
-<userinput
->wstecz</userinput
-> przesuwa żółwia do tyłu o X pikseli. Gdy ołówek jest skierowany w dół żółw zostawia ślad. <userinput
->wstecz</userinput
-> może być użyty za pomocą skrótu <userinput
->ws</userinput
->.</para
-></listitem>
+    <varlistentry>  
+      <term>w tył</term>
+      <listitem><para><screen>wstecz X</screen>
+<userinput>wstecz</userinput> przesuwa żółwia do tyłu o X pikseli. Gdy ołówek jest skierowany w dół żółw zostawia ślad. <userinput>wstecz</userinput> może być użyty za pomocą skrótu <userinput>ws</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="turnleft">
-  <title
->obróć_w_lewo (lw)</title>
+  <title>obróć_w_lewo (lw)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->skręć w lewo</term>
-      <listitem
-><para
-><screen
->obróć_w_lewo X</screen>
-<userinput
->obróć_w_lewo</userinput
-> powoduje, że żółw skręca w lewo o X stopni. <userinput
->obróć_w_lewo</userinput
-> może być użyty za pomocą skrótu <userinput
->lw</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>skręć w lewo</term>
+      <listitem><para><screen>obróć_w_lewo X</screen>
+<userinput>obróć_w_lewo</userinput> powoduje, że żółw skręca w lewo o X stopni. <userinput>obróć_w_lewo</userinput> może być użyty za pomocą skrótu <userinput>lw</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="turnright">
-  <title
->obróć_w_prawo (pw)</title>
+  <title>obróć_w_prawo (pw)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->skręć w prawo</term>
-      <listitem
-><para
-><screen
->obróć_w_prawo X</screen>
-<userinput
->obróć_w_prawo</userinput
-> powoduje, że żółw skręca w prawo o X stopni. <userinput
->obróć_w_prawo</userinput
-> może być użyty za pomocą skrótu <userinput
->pw</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>skręć w prawo</term>
+      <listitem><para><screen>obróć_w_prawo X</screen>
+<userinput>obróć_w_prawo</userinput> powoduje, że żółw skręca w prawo o X stopni. <userinput>obróć_w_prawo</userinput> może być użyty za pomocą skrótu <userinput>pw</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="direction">
-  <title
->kierunek (kie)</title>
+  <title>kierunek (kie)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->kierunek</term>
-      <listitem
-><para
-><screen
->kierunek X</screen>
-<userinput
->kierunek</userinput
-> ustawia kierunek ruchu żółwia na X stopni licząc od zera, nie wiąże się to z poprzednim kierunkiem ruchu żółwia. <userinput
->kierunek</userinput
-> może być użyty za pomocą skrótu <userinput
->kie</userinput
-></para
-></listitem>
+    <varlistentry> 
+      <term>kierunek</term>
+      <listitem><para><screen>kierunek X</screen>
+<userinput>kierunek</userinput> ustawia kierunek ruchu żółwia na X stopni licząc od zera, nie wiąże się to z poprzednim kierunkiem ruchu żółwia. <userinput>kierunek</userinput> może być użyty za pomocą skrótu <userinput>kie</userinput></para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="center">
-  <title
->środek</title>
+  <title>środek</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->środek</term>
-      <listitem
-><para
-><screen
->środek</screen>
-<userinput
->środek</userinput
-> przesuwa żółwia na środek płótna.</para
-></listitem>
+    <varlistentry> 
+      <term>środek</term>
+      <listitem><para><screen>środek</screen>
+<userinput>środek</userinput> przesuwa żółwia na środek płótna.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="go">
-  <title
->idź</title>
+  <title>idź</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->idź</term>
-      <listitem
-><para
-><screen
->idź X,Y</screen>
-Komenda <userinput
->idź</userinput
-> przesuwa żółwia na wskazaną lokalizację na płótnie. Ta lokalizacja to X <glossterm linkend="pixels"
->pikseli</glossterm
-> od lewej strony płótna oraz Y <glossterm linkend="pixels"
->pikseli</glossterm
-> od góry płótna. Użycie komendy <userinput
->idź</userinput
-> nie powoduje, że żółw rysuje linie.</para
-></listitem>
+    <varlistentry> 
+      <term>idź</term>
+      <listitem><para><screen>idź X,Y</screen>
+Komenda <userinput>idź</userinput> przesuwa żółwia na wskazaną lokalizację na płótnie. Ta lokalizacja to X <glossterm linkend="pixels">pikseli</glossterm> od lewej strony płótna oraz Y <glossterm linkend="pixels">pikseli</glossterm> od góry płótna. Użycie komendy <userinput>idź</userinput> nie powoduje, że żółw rysuje linie.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="gox">
-  <title
->idźx</title>
+  <title>idźx</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->idźx</term>
-      <listitem
-><para
-><screen
->idźx X</screen>
-<userinput
->idźx</userinput
-> powoduje przesunięcie żółwia do pozycji X <glossterm linkend="pixels"
->pikseli</glossterm
-> od lewej strony płótna, podczas gdy wysokość pozostaje bez zmiany.</para
-></listitem>
+    <varlistentry> 
+      <term>idźx</term>
+      <listitem><para><screen>idźx X</screen>
+<userinput>idźx</userinput> powoduje przesunięcie żółwia do pozycji X <glossterm linkend="pixels">pikseli</glossterm> od lewej strony płótna, podczas gdy wysokość pozostaje bez zmiany.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="goy">
-  <title
->idźy</title>
+  <title>idźy</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->idźy</term>
-      <listitem
-><para
-><screen
->idźy Y</screen>
-<userinput
->idźy</userinput
-> powoduje przesunięcie żółwia do pozycji Y <glossterm linkend="pixels"
->pikseli</glossterm
-> od góry płótna, podczas gdy odległość od lewego brzegu pozostaje bez zmian.</para
-></listitem>
+    <varlistentry> 
+      <term>idźy</term>
+      <listitem><para><screen>idźy Y</screen>
+<userinput>idźy</userinput> powoduje przesunięcie żółwia do pozycji Y <glossterm linkend="pixels">pikseli</glossterm> od góry płótna, podczas gdy odległość od lewego brzegu pozostaje bez zmian.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="pen">
-<title
->Żółw posiada ołówek</title>
-<para
->Żółw posiada ołówek, który rysuje linię gdy żółw się przesuwa. Istnieje kilka komend zarządzających ołówkiem. W tej sekcji wyjaśniamy te komendy.</para>
+<title>Żółw posiada ołówek</title>
+<para>Żółw posiada ołówek, który rysuje linię gdy żółw się przesuwa. Istnieje kilka komend zarządzających ołówkiem. W tej sekcji wyjaśniamy te komendy.</para>
 <sect3 id="penup">
-  <title
->podnieś (pod)</title>
+  <title>podnieś (pod)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->podnieś</term>
-      <listitem
-><para
-><screen
->podnieś</screen>
-<userinput
->podnieś</userinput
-> podnosi ołówek z płótna. Gdy ołówek jest <quote
->podniesiony</quote
-> nie będzie rysowana linia gdy porusza się żółw. Zobacz także <userinput
->opuść</userinput
->. <userinput
->podnieś</userinput
-> może być użyte za pomocą skrótu <userinput
->pod</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>podnieś</term>
+      <listitem><para><screen>podnieś</screen>
+<userinput>podnieś</userinput> podnosi ołówek z płótna. Gdy ołówek jest <quote>podniesiony</quote> nie będzie rysowana linia gdy porusza się żółw. Zobacz także <userinput>opuść</userinput>. <userinput>podnieś</userinput> może być użyte za pomocą skrótu <userinput>pod</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="pendown">
-  <title
->opuść (opu)</title>
+  <title>opuść (opu)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->opuść</term>
-      <listitem
-><para
-><screen
->opuść</screen>
-<userinput
->opuść</userinput
-> kładzie ołówek na płótnie. Gdy ołówek jest <quote
->położony</quote
-> będzie rysowana linia gdy porusza się żółw. Zobacz także <userinput
->podnieś</userinput
->. <userinput
->opuść</userinput
-> może być użyte za pomocą skrótu <userinput
->opu</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>opuść</term>
+      <listitem><para><screen>opuść</screen>
+<userinput>opuść</userinput> kładzie ołówek na płótnie. Gdy ołówek jest <quote>położony</quote> będzie rysowana linia gdy porusza się żółw. Zobacz także <userinput>podnieś</userinput>. <userinput>opuść</userinput> może być użyte za pomocą skrótu <userinput>opu</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="setpenwidth">
-  <title
->ustaw_grubość_pisaka (ugp)</title>
+  <title>ustaw_grubość_pisaka (ugp)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->ustaw_grubość_pisaka</term>
-      <listitem
-><para
-><screen
->ustaw_grubość_pisaka X</screen>
-<userinput
->ustaw_grubość_pisaka</userinput
-> ustawia grubość ołówka (grubość rysowanej linii) na X <glossterm linkend="pixels"
->pikseli</glossterm
->. <userinput
->ustaw_grubość_pisaka</userinput
-> może być użyte za pomocą skrótu<userinput
->ugp</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>ustaw_grubość_pisaka</term>
+      <listitem><para><screen>ustaw_grubość_pisaka X</screen>
+<userinput>ustaw_grubość_pisaka</userinput> ustawia grubość ołówka (grubość rysowanej linii) na X <glossterm linkend="pixels">pikseli</glossterm>. <userinput>ustaw_grubość_pisaka</userinput> może być użyte za pomocą skrótu<userinput>ugp</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="setfgcolor">
-  <title
->kolor_pisaka (kp)</title>
+  <title>kolor_pisaka (kp)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->kolor ołówka</term>
-      <listitem
-><para
-><screen
->kolor_pisaka R,G,B</screen>
-<userinput
->kolor_pisaka</userinput
-> ustawia kolor ołówka. <userinput
->kolor_pisaka</userinput
-> przyjmuje <glossterm linkend="rgb"
->kombinację RGB</glossterm
-> jako argument wejściowy. <userinput
->kolor_pisaka</userinput
-> może być użyty za pomocą skrótu <userinput
->kp</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>kolor ołówka</term>
+      <listitem><para><screen>kolor_pisaka R,G,B</screen>
+<userinput>kolor_pisaka</userinput> ustawia kolor ołówka. <userinput>kolor_pisaka</userinput> przyjmuje <glossterm linkend="rgb">kombinację RGB</glossterm> jako argument wejściowy. <userinput>kolor_pisaka</userinput> może być użyty za pomocą skrótu <userinput>kp</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="canvas">
-<title
->Komendy do zarządzania płótnem</title>
-<para
->Istnieje kilka komend sterujących płótnem.</para>
+<title>Komendy do zarządzania płótnem</title>
+<para>Istnieje kilka komend sterujących płótnem.</para>
 <sect3 id="resizecanvas">
-  <title
->przeskaluj_tło (pt)</title>
+  <title>przeskaluj_tło (pt)</title>
   <variablelist>
     <varlistentry>
-      <term
->przeskaluj_tło</term>
-      <listitem
-><para
-><screen
->przeskaluj_tło X,Y</screen>
-Za pomocą komendy <userinput
->przeskaluj_tło</userinput
-> można ustawić rozmiar płótna. Komenda przyjmuje jako argumenty wejściowe liczby X i Y, gdzie X jest nową szerokością płótna w <glossterm linkend="pixels"
->pikselach</glossterm
->, a Y jest nową wysokością płótna w <glossterm linkend="pixels"
->pikselach</glossterm
->. <userinput
->przeskaluj_tło</userinput
-> może być użyte za pomocą skrótu <userinput
->pt</userinput
->.</para
-></listitem>
+      <term>przeskaluj_tło</term>
+      <listitem><para><screen>przeskaluj_tło X,Y</screen>
+Za pomocą komendy <userinput>przeskaluj_tło</userinput> można ustawić rozmiar płótna. Komenda przyjmuje jako argumenty wejściowe liczby X i Y, gdzie X jest nową szerokością płótna w <glossterm linkend="pixels">pikselach</glossterm>, a Y jest nową wysokością płótna w <glossterm linkend="pixels">pikselach</glossterm>. <userinput>przeskaluj_tło</userinput> może być użyte za pomocą skrótu <userinput>pt</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="setbgcolor">
-  <title
->kolor_tła (kt)</title>
+  <title>kolor_tła (kt)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->kolor_tła</term>
-      <listitem
-><para
-><screen
->kolor_tła R,G,B</screen>
-Komenda <userinput
->kolor_tła</userinput
-> ustawia kolor płótna. <userinput
->kolor_tła</userinput
-> przyjmuje <glossterm linkend="rgb"
->kombinację RGB</glossterm
-> jako argument wejściowy. <userinput
->kolor_tła</userinput
-> może być użyty za pomocą skrótu <userinput
->kt</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>kolor_tła</term>
+      <listitem><para><screen>kolor_tła R,G,B</screen>
+Komenda <userinput>kolor_tła</userinput> ustawia kolor płótna. <userinput>kolor_tła</userinput> przyjmuje <glossterm linkend="rgb">kombinację RGB</glossterm> jako argument wejściowy. <userinput>kolor_tła</userinput> może być użyty za pomocą skrótu <userinput>kt</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="wrapon">
-  <title
->zawijaj</title>
+  <title>zawijaj</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->zawijaj</term>
-      <listitem
-><para
-><screen
->zawijaj</screen>
-Przy pomocy komendy <userinput
->zawijaj</userinput
-> można <quote
->włączyć</quote
-> <glossterm linkend="wrapping"
->zawijanie</glossterm
-> płótna. Znaczenie terminu <glossterm linkend="wrapping"
->zawijania</glossterm
-> znajduje się w słowniku.</para
-></listitem>
+    <varlistentry> 
+      <term>zawijaj</term>
+      <listitem><para><screen>zawijaj</screen>
+Przy pomocy komendy <userinput>zawijaj</userinput> można <quote>włączyć</quote> <glossterm linkend="wrapping">zawijanie</glossterm> płótna. Znaczenie terminu <glossterm linkend="wrapping">zawijania</glossterm> znajduje się w słowniku.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="wrapoff">
-  <title
->nie_zawijaj</title>
+  <title>nie_zawijaj</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->nie_zawijaj</term>
-      <listitem
-><para
-><screen
->nie_zawijaj</screen>
-Przy pomocy komendy <userinput
->zawijaj</userinput
-> można <quote
->wyłączyć</quote
-> <glossterm linkend="wrapping"
->zawijanie</glossterm
-> płótna. Oznacza to, że żółw może wyjść poza płótno i <quote
->zgubić się</quote
->. Znaczenie terminu <glossterm linkend="wrapping"
->zawijania</glossterm
-> znajduje się w słowniku.</para
-></listitem>
+    <varlistentry> 
+      <term>nie_zawijaj</term>
+      <listitem><para><screen>nie_zawijaj</screen>
+Przy pomocy komendy <userinput>zawijaj</userinput> można <quote>wyłączyć</quote> <glossterm linkend="wrapping">zawijanie</glossterm> płótna. Oznacza to, że żółw może wyjść poza płótno i <quote>zgubić się</quote>. Znaczenie terminu <glossterm linkend="wrapping">zawijania</glossterm> znajduje się w słowniku.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="clean">
-<title
->Komendy czyszczenia</title>
-<para
->Istnieją dwie komendy czyszczące płótno.</para>
+<title>Komendy czyszczenia</title>
+<para>Istnieją dwie komendy czyszczące płótno.</para>
 <sect3 id="clear">
-  <title
->czyść (cs)</title>
+  <title>czyść (cs)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->czyść</term>
-      <listitem
-><para
-><screen
->czyść</screen>
-Komenda <userinput
->czyść</userinput
-> usuwa wszystkie rysunki z płótna. Pozostałe rzeczy zostają: pozycja i kąt ruchu żółwia, kolor płótna, widoczność żółwia, i rozmiar płótna. <userinput
->czyść</userinput
-> może być użyta za pomocą skrótu <userinput
->cs</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>czyść</term>
+      <listitem><para><screen>czyść</screen>
+Komenda <userinput>czyść</userinput> usuwa wszystkie rysunki z płótna. Pozostałe rzeczy zostają: pozycja i kąt ruchu żółwia, kolor płótna, widoczność żółwia, i rozmiar płótna. <userinput>czyść</userinput> może być użyta za pomocą skrótu <userinput>cs</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="reset">
-  <title
->zeruj</title>
+  <title>zeruj</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->zeruj</term>
-      <listitem
-><para
-><screen
->zeruj</screen>
-Komenda<userinput
->zeruj</userinput
-> czyści bardziej dokładnie niż komenda <userinput
->czyść</userinput
->. Po wykonaniu komendy <userinput
->zeruj</userinput
-> płótno wygląda jak po rozpoczęciu pracy &kturtle;. Żółw umieszczony jest na środku ekranu, kolor płótna jest biały, żółw rysuje czarną linię.</para
-></listitem>
+    <varlistentry> 
+      <term>zeruj</term>
+      <listitem><para><screen>zeruj</screen>
+Komenda<userinput>zeruj</userinput> czyści bardziej dokładnie niż komenda <userinput>czyść</userinput>. Po wykonaniu komendy <userinput>zeruj</userinput> płótno wygląda jak po rozpoczęciu pracy &kturtle;. Żółw umieszczony jest na środku ekranu, kolor płótna jest biały, żółw rysuje czarną linię.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="sprites">
-<title
->Żółw jest sprajtem</title>
-<para
->Najpierw krótkie wytłumaczenia czym jest sprajt: sprajty to małe obrazki, które mogą być przesuwane po ekranie, jak często to widzimy w grach komputerowych. Nasz żółwik jest także sprajtem. Dokładniejsze wyjaśnienie znajduje się w słowniku pod hasłem <glossterm linkend="sprites"
->sprajty</glossterm
->. </para>
-<para
->Poniżej znajduje się pełen przegląd komend do pracy ze sprajtami.</para>
-<para
->[Obecna wersja &kturtle; nie obsługuje jeszcze użycia sprajtów innych niż żółw. Kolejne wersje będą umożliwiać zmianę żółwia na coś zaprojektowanego przez siebie]</para>
+<title>Żółw jest sprajtem</title>
+<para>Najpierw krótkie wytłumaczenia czym jest sprajt: sprajty to małe obrazki, które mogą być przesuwane po ekranie, jak często to widzimy w grach komputerowych. Nasz żółwik jest także sprajtem. Dokładniejsze wyjaśnienie znajduje się w słowniku pod hasłem <glossterm linkend="sprites">sprajty</glossterm>. </para>
+<para>Poniżej znajduje się pełen przegląd komend do pracy ze sprajtami.</para>
+<para>[Obecna wersja &kturtle; nie obsługuje jeszcze użycia sprajtów innych niż żółw. Kolejne wersje będą umożliwiać zmianę żółwia na coś zaprojektowanego przez siebie]</para>
 <sect3 id="spriteshow">
-  <title
->pokaż</title>
+  <title>pokaż</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->pokaż (pk)</term>
-      <listitem
-><para
-><screen
->pokaż</screen>
-Komenda <userinput
->pokaż</userinput
-> sprawia, że żółw staje się widoczny (gdy był ukryty). <userinput
->pokaż</userinput
-> może być użyty za pomocą skrótu <userinput
->pk</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>pokaż (pk)</term>
+      <listitem><para><screen>pokaż</screen>
+Komenda <userinput>pokaż</userinput> sprawia, że żółw staje się widoczny (gdy był ukryty). <userinput>pokaż</userinput> może być użyty za pomocą skrótu <userinput>pk</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="spritehide">
-  <title
->ukryj (uk)</title>
+  <title>ukryj (uk)</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->ukryj</term>
-      <listitem
-><para
-><screen
->ukryj</screen>
-Komenda <userinput
->ukryj</userinput
-> sprawia, że żółw jest ukrywany. Opcja używana gdy żółw nie pasuje do rysunku. <userinput
->pokaż</userinput
-> może być użyty za pomocą skrótu <userinput
->uk</userinput
->.</para
-></listitem>
+    <varlistentry> 
+      <term>ukryj</term>
+      <listitem><para><screen>ukryj</screen>
+Komenda <userinput>ukryj</userinput> sprawia, że żółw jest ukrywany. Opcja używana gdy żółw nie pasuje do rysunku. <userinput>pokaż</userinput> może być użyty za pomocą skrótu <userinput>uk</userinput>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="writing">
-<title
->Czy żółw może pisać?</title>
-<para
->Odpowiedź brzmi: <quote
->tak</quote
->. Żółw potrafi pisać: wszystko co każe mu się pisać.</para>
+<title>Czy żółw może pisać?</title>
+<para>Odpowiedź brzmi: <quote>tak</quote>. Żółw potrafi pisać: wszystko co każe mu się pisać.</para>
 <sect3 id="print">
-  <title
->pisz</title>
+  <title>pisz</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->pisz</term>
-      <listitem
-><para
-><screen
->pisz X</screen>
-<userinput
->pisz</userinput
-> każe żółwiowi pisać podany tekst na płótnie. <userinput
->pisz</userinput
-> przyjmuje jako argumenty wejściowe liczy i łańcuchy znaków. Używając symbolu <quote
->+</quote
-> można <userinput
->napisać</userinput
-> kilka liczb i łańcuchów znaków. Oto mały przykład: <screen
->rok = 2003
+    <varlistentry> 
+      <term>pisz</term>
+      <listitem><para><screen>pisz X</screen>
+<userinput>pisz</userinput> każe żółwiowi pisać podany tekst na płótnie. <userinput>pisz</userinput> przyjmuje jako argumenty wejściowe liczy i łańcuchy znaków. Używając symbolu <quote>+</quote> można <userinput>napisać</userinput> kilka liczb i łańcuchów znaków. Oto mały przykład: <screen>rok = 2003
 autor = "Cies"
 wypisuje autor + " rozpoczął projekt KTurtle w roku " + rok + " i dalej z radością nad nim pracuje!"
 </screen>
-      </para
-></listitem>
+      </para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="fontsize">
-  <title
->wielkość_czcionki</title>
+  <title>wielkość_czcionki</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->wielkość_czcionki</term>
-      <listitem
-><para
-><screen
->wielkość_czcionki X</screen>
-<userinput
->wielkość_czcionki</userinput
-> ustawia rozmiar czcionki używany przy<userinput
->wypisywaniu</userinput
->. <userinput
->wielkość_czcionki</userinput
-> przyjmuje liczbę jako argument wejściowy. Rozmiar czcionki podawany jest w <glossterm linkend="pixels"
->pikselach</glossterm
->.</para
-></listitem>
+    <varlistentry> 
+      <term>wielkość_czcionki</term>
+      <listitem><para><screen>wielkość_czcionki X</screen>
+<userinput>wielkość_czcionki</userinput> ustawia rozmiar czcionki używany przy<userinput>wypisywaniu</userinput>. <userinput>wielkość_czcionki</userinput> przyjmuje liczbę jako argument wejściowy. Rozmiar czcionki podawany jest w <glossterm linkend="pixels">pikselach</glossterm>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="random">
-<title
->Komenda rzucająca kości za użytkownika</title>
-<para
->Komenda rzucająca kości za użytkownika, nazywa się <userinput
->losowo</userinput
->, i jest bardzo użyteczna różnych przypadkach.</para>
+<title>Komenda rzucająca kości za użytkownika</title>
+<para>Komenda rzucająca kości za użytkownika, nazywa się <userinput>losowo</userinput>, i jest bardzo użyteczna różnych przypadkach.</para>
   <variablelist>
-    <varlistentry
-> 
-      <term
->losowo</term>
-      <listitem
-><para
-><screen
->losowo X,Y</screen>
-<userinput
->losowo</userinput
-> przyjmuje argumenty wejściowe i daje argumenty wyjściowe. Jako argumenty wejściowe wymagane są dwie liczby, pierwsza (X) określa minimum argumentu wyjściowego, natomiast druga (Y) określa maksimum. Argument wyjściowy jest losowo wybraną liczbą z przedziału ograniczonego przez podane minimum i maksimum. Oto przykład: <screen>
+    <varlistentry> 
+      <term>losowo</term>
+      <listitem><para><screen>losowo X,Y</screen>
+<userinput>losowo</userinput> przyjmuje argumenty wejściowe i daje argumenty wyjściowe. Jako argumenty wejściowe wymagane są dwie liczby, pierwsza (X) określa minimum argumentu wyjściowego, natomiast druga (Y) określa maksimum. Argument wyjściowy jest losowo wybraną liczbą z przedziału ograniczonego przez podane minimum i maksimum. Oto przykład: <screen>
 powtórz 500 [
   x = losowo 1,20
   naprzód x
   obróć_w_lewo 10 - x
 ]
-</screen
-> Używając komendy <userinput
->losowo</userinput
-> można dodać odrobiny chaosu do programu.</para
-></listitem>
+</screen> Używając komendy <userinput>losowo</userinput> można dodać odrobiny chaosu do programu.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="dialogs">
-<title
->Argumenty wejściowe i pomoc przez okna dialogowe</title>
-<para
->Okno dialogowe jest małym wyskakującym okienkiem, które zawiera pomoc dotyczącą argumentów wejściowych. &kturtle; posiada dwie komendy do okien dialogowych, mianowicie: <userinput
->wiadomość</userinput
-> i <userinput
->okno_wejścia</userinput
-></para>
+<title>Argumenty wejściowe i pomoc przez okna dialogowe</title>
+<para>Okno dialogowe jest małym wyskakującym okienkiem, które zawiera pomoc dotyczącą argumentów wejściowych. &kturtle; posiada dwie komendy do okien dialogowych, mianowicie: <userinput>wiadomość</userinput> i <userinput>okno_wejścia</userinput></para>
 <sect3 id="message">
-  <title
->wiadomość</title>
+  <title>wiadomość</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->wiadomość</term>
-      <listitem
-><para
-><screen
->wiadomość X</screen>
-Komenda <userinput
->wiadomość</userinput
-> przyjmuje jako argument wejściowy <link linkend="string"
->łańcuch znaków</link
->. Pokazuje się okno dialogowe zawierające tekst z <link linkend="string"
->łańcucha</link
->. <screen
->rok = 2003
+    <varlistentry> 
+      <term>wiadomość</term>
+      <listitem><para><screen>wiadomość X</screen>
+Komenda <userinput>wiadomość</userinput> przyjmuje jako argument wejściowy <link linkend="string">łańcuch znaków</link>. Pokazuje się okno dialogowe zawierające tekst z <link linkend="string">łańcucha</link>. <screen>rok = 2003
 autor = "Cies"
 wypisuje autor + " rozpoczął projekt KTurtle w roku " + rok + " i dalej z radością nad nim pracuje!"
 </screen>
-      </para
-></listitem>
+      </para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="inputwindow">
-  <title
->okno_wejścia</title>
+  <title>okno_wejścia</title>
   <variablelist>
-    <varlistentry
-> 
-      <term
->okno_wejścia</term>
-      <listitem
-><para
-><screen
->okno_wejścia X</screen>
-<userinput
->okno_wejścia</userinput
-> jako argument wejściowy przyjmuje <link linkend="string"
->łańcuch znaków</link
->. Pokazuje się wyskakujące okno dialogowe zawierające tekst z łańcucha, tak jak <link linkend="message"
->wiadomość</link
->. Dodatkowo dodaje to pole wejściowe do okna. Przez to pole użytkownik może wprowadzić <link linkend="number"
->liczbę</link
-> lub <link linkend="string"
->łańcuch</link
-> który może być przechowywany w <link linkend="containers"
->kontenerze</link
->. Na przykład <screen>
+    <varlistentry> 
+      <term>okno_wejścia</term>
+      <listitem><para><screen>okno_wejścia X</screen>
+<userinput>okno_wejścia</userinput> jako argument wejściowy przyjmuje <link linkend="string">łańcuch znaków</link>. Pokazuje się wyskakujące okno dialogowe zawierające tekst z łańcucha, tak jak <link linkend="message">wiadomość</link>. Dodatkowo dodaje to pole wejściowe do okna. Przez to pole użytkownik może wprowadzić <link linkend="number">liczbę</link> lub <link linkend="string">łańcuch</link> który może być przechowywany w <link linkend="containers">kontenerze</link>. Na przykład <screen>
 wejście = okno_wejścia "Jaki jest Twój wiek?"
 wyjście = 2003 - wejście
 pisz "W 2003 będziesz mieć " + wyjście + " lat."
-</screen
-> Gdy użytkownik kasuje okno dialogowe, lub nie wprowadza niczego <link linkend="containers"
->kontener</link
-> jest opróżniany.</para
-></listitem>
+</screen> Gdy użytkownik kasuje okno dialogowe, lub nie wprowadza niczego <link linkend="containers">kontener</link> jest opróżniany.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
@@ -996,45 +423,23 @@ pisz "W 2003 będziesz mieć " + wyjście + " lat."
 
 
 <sect1 id="containers">
-<title
->Kontenery</title>
-<para
->Kontenery są znakami bądź wyrazami używanymi przez programistów do przechowywania liczb lub tekstu. Kontenery zawierające liczby nazywane są <link linkend="variables"
->zmiennymi</link
->, kontenery zawierające tekst nazywane są <link linkend="string"
->łańcuchami</link
->.</para>
+<title>Kontenery</title>
+<para>Kontenery są znakami bądź wyrazami używanymi przez programistów do przechowywania liczb lub tekstu. Kontenery zawierające liczby nazywane są <link linkend="variables">zmiennymi</link>, kontenery zawierające tekst nazywane są <link linkend="string">łańcuchami</link>.</para>
 
-<para
->Kontenery nie używane nie zawierają niczego. Przykład: <screen>
+<para>Kontenery nie używane nie zawierają niczego. Przykład: <screen>
 pisz N
-</screen
-> Nie zostanie wyświetlone nic. Jeżeli spróbujemy wykonać jakieś <link linkend="math"
->działanie matematyczne</link
-> z pustym kontenerem pojawi się komunikat błędu. </para>
+</screen> Nie zostanie wyświetlone nic. Jeżeli spróbujemy wykonać jakieś <link linkend="math">działanie matematyczne</link> z pustym kontenerem pojawi się komunikat błędu. </para>
 
 <sect2 id="variables">
-<title
->Zmienne: kontenery liczbowe</title>
-<para
->Rozpoczniemy od przykładu: <screen>
+<title>Zmienne: kontenery liczbowe</title>
+<para>Rozpoczniemy od przykładu: <screen>
 x = 3
 pisz x
-</screen
-> W pierwszej linii litera <userinput
->x</userinput
-> staje się zmienną (kontenerem liczbowym). Jak widać wartość zmiennej <userinput
->x</userinput
-> ustawiona jest na 3. W drugiej linii wartość jest wypisywana.</para>
-<para
->Jeżeli chcielibyśmy wypisać znak <quote
->x</quote
-> powinniśmy napisać <screen
->pisz "x"
+</screen> W pierwszej linii litera <userinput>x</userinput> staje się zmienną (kontenerem liczbowym). Jak widać wartość zmiennej <userinput>x</userinput> ustawiona jest na 3. W drugiej linii wartość jest wypisywana.</para>
+<para>Jeżeli chcielibyśmy wypisać znak <quote>x</quote> powinniśmy napisać <screen>pisz "x"
 </screen>
 </para>
-<para
->To było łatwe, teraz trudniejszy przykład: <screen>
+<para>To było łatwe, teraz trudniejszy przykład: <screen>
 A = 2004
 B = 25
 C = A + B
@@ -1047,366 +452,148 @@ pisz A + " plus " + B
 wstecz 30
 # kolejna komenda wyświetli "1979"
 pisz A - B
-</screen
-> W dwóch pierwszych linijkach zmienne <userinput
->A</userinput
-> i <userinput
->B</userinput
-> zostają ustawione na 2004 i 25. W trzeciej linii <userinput
->C</userinput
-> zostaje ustawiona jako <userinput
->A + B</userinput
->, co wynosi 2029. Reszta przykładu składa się z 3 komend <userinput
->pisz</userinput
-> z <userinput
->wstecz 30</userinput
-> pomiędzy. <userinput
->wstecz 30</userinput
-> zapewnia, że każde wyjście drukowane jest w nowej linii. W przykładzie można zaobserwować użycie zmiennych w <link linkend="math"
->obliczeniach matematycznych</link
->.</para>
+</screen> W dwóch pierwszych linijkach zmienne <userinput>A</userinput> i <userinput>B</userinput> zostają ustawione na 2004 i 25. W trzeciej linii <userinput>C</userinput> zostaje ustawiona jako <userinput>A + B</userinput>, co wynosi 2029. Reszta przykładu składa się z 3 komend <userinput>pisz</userinput> z <userinput>wstecz 30</userinput> pomiędzy. <userinput>wstecz 30</userinput> zapewnia, że każde wyjście drukowane jest w nowej linii. W przykładzie można zaobserwować użycie zmiennych w <link linkend="math">obliczeniach matematycznych</link>.</para>
 </sect2>
 
 <sect2 id="strings">
-<title
->Kontenery zawierające tekst (łańcuchy)</title>
-<para
->W kodzie programistycznym zwykły tekst rozpoczyna się i kończy zazwyczaj cudzysłowami. Do tej pory widzieliśmy: <screen>
+<title>Kontenery zawierające tekst (łańcuchy)</title>
+<para>W kodzie programistycznym zwykły tekst rozpoczyna się i kończy zazwyczaj cudzysłowami. Do tej pory widzieliśmy: <screen>
 pisz "Cześć programisto!"
-</screen
-> Tekst jest ograniczony cudzysłowami. Kawałki tego tekstu nazywamy <link linkend="strings"
->łańcuchami</link
->.</para>
-<para
->Łańcuchy mogą być przechowywane w <link linkend="containers"
->kontenerach</link
-> tak jak <link linkend="number"
->liczby</link
->. Łańcuchy są bardzo podobne do zmiennych. Największą różnicą jest to, że zamiast liczb zawierają tekst. Z tego powodu łańcuchy nie mogą być używane w <link linkend="math"
->wyrażeniach matematycznych</link
-> i <link linkend="questions"
->pytaniach</link
->. Przykład użycia łańcuchów: <screen>
+</screen> Tekst jest ograniczony cudzysłowami. Kawałki tego tekstu nazywamy <link linkend="strings">łańcuchami</link>.</para>
+<para>Łańcuchy mogą być przechowywane w <link linkend="containers">kontenerach</link> tak jak <link linkend="number">liczby</link>. Łańcuchy są bardzo podobne do zmiennych. Największą różnicą jest to, że zamiast liczb zawierają tekst. Z tego powodu łańcuchy nie mogą być używane w <link linkend="math">wyrażeniach matematycznych</link> i <link linkend="questions">pytaniach</link>. Przykład użycia łańcuchów: <screen>
 x = "Cześć "
 imię = okno_wejścia "Podaj swoje imię..."
 pisz x + imię + ", jak się masz?"
-</screen
-> W pierwszej linii <userinput
->x</userinput
-> jest ustawiane jako <quote
->Cześć </quote
->. W drugiej linii łańcuch <userinput
->imię</userinput
-> jest ustawiany jako wyjście komendy <userinput
->okno_wejścia</userinput
->. W kolejnej linii program wypisuje kompozycję trzech linii na płótnie.</para>
-<para
->Program poprosi o podanie imienia. Po wprowadzeniu np. imienia <quote
->Paweł</quote
->, program wypisuje <quote
->Cześć Paweł jak się masz?</quote
->. Należy zauważyć, że plus (+) jest jedynym symbolem matematycznym używanym z łańcuchami.</para>
+</screen> W pierwszej linii <userinput>x</userinput> jest ustawiane jako <quote>Cześć </quote>. W drugiej linii łańcuch <userinput>imię</userinput> jest ustawiany jako wyjście komendy <userinput>okno_wejścia</userinput>. W kolejnej linii program wypisuje kompozycję trzech linii na płótnie.</para>
+<para>Program poprosi o podanie imienia. Po wprowadzeniu np. imienia <quote>Paweł</quote>, program wypisuje <quote>Cześć Paweł jak się masz?</quote>. Należy zauważyć, że plus (+) jest jedynym symbolem matematycznym używanym z łańcuchami.</para>
 </sect2>
 </sect1>
 
 <sect1 id="math">
-<title
->Czy żółw zna matematykę?</title>
-<para
->Tak, &kturtle; zna matematykę. Potrafi dodawać (+), odejmować (-), mnożyć (*), a także dzielić (/). Oto przykład, który korzysta ze wszystkich tych działań: <screen>
+<title>Czy żółw zna matematykę?</title>
+<para>Tak, &kturtle; zna matematykę. Potrafi dodawać (+), odejmować (-), mnożyć (*), a także dzielić (/). Oto przykład, który korzysta ze wszystkich tych działań: <screen>
 a = 20 - 5
 b = 15 * 2
 c = 30 / 30
 d = 1 + 1
 pisz "a: "+a+", b: "+b+", c: "+c+", d: "+d 
-</screen
-> Czy wiesz jakie wartości mają zmienne a, b, c oraz d? Proszę zauważyć <link linkend="assignment"
->przypisanie wartości zmiennej</link
-> za pomocą symbolu <userinput
->=</userinput
->.</para>
-<para
->Chcąc dokonać prostego obliczenia wpisujemy po prostu: <screen
->pisz 2004-12
-</screen
-></para>
-<para
->Teraz przykład z nawiasami: <screen>
+</screen> Czy wiesz jakie wartości mają zmienne a, b, c oraz d? Proszę zauważyć <link linkend="assignment">przypisanie wartości zmiennej</link> za pomocą symbolu <userinput>=</userinput>.</para>
+<para>Chcąc dokonać prostego obliczenia wpisujemy po prostu: <screen>pisz 2004-12
+</screen></para>
+<para>Teraz przykład z nawiasami: <screen>
 pisz ( ( 20 - 5 ) * 2 / 30 ) + 1
-</screen
-> Wyrażenia wewnątrz nawiasów obliczane są najpierw. W tym przykładzie, najpierw zostanie obliczone 20-5, później pomnożone 2, podzielone przez 30, i zostanie dodane 1(co daje 2).</para>
+</screen> Wyrażenia wewnątrz nawiasów obliczane są najpierw. W tym przykładzie, najpierw zostanie obliczone 20-5, później pomnożone 2, podzielone przez 30, i zostanie dodane 1(co daje 2).</para>
 </sect1>
 
 <sect1 id="questions">
-<title
->Zadawanie pytań, otrzymywanie odpowiedzi...</title>
-<para
-><link linkend="if"
-><userinput
->jeśli</userinput
-></link
-> i <link linkend="while"
-><userinput
->dopóki</userinput
-></link
-> są <link linkend="controlling-execution"
->instrukcjami sterującymi</link
-> które będą omawiane w następnej sekcji. W tej sekcji używamy instrukcji <link linkend="if"
-><userinput
->jeśli</userinput
-></link
-> by wyjaśnić zapytania.</para>
+<title>Zadawanie pytań, otrzymywanie odpowiedzi...</title>
+<para><link linkend="if"><userinput>jeśli</userinput></link> i <link linkend="while"><userinput>dopóki</userinput></link> są <link linkend="controlling-execution">instrukcjami sterującymi</link> które będą omawiane w następnej sekcji. W tej sekcji używamy instrukcji <link linkend="if"><userinput>jeśli</userinput></link> by wyjaśnić zapytania.</para>
 <sect2 id="q">
-<title
->Zapytania</title>
-<para
->Przykład prostego pytania: <screen>
+<title>Zapytania</title>
+<para>Przykład prostego pytania: <screen>
 x = 6
 jeśli x &gt; 5 [
   pisz "cześć"
 ]
-</screen
-> Pytaniem w tym przykładzie jest <userinput
->x &gt; 5</userinput
-> . Jeżeli odpowiedź jest prawdziwa wykonywany jest kod w nawiasach. Zapytania są bardzo istotną częścią częścią programowania i są często używane z <link linkend="controlling-execution"
->instrukcjami sterującymi</link
->, jak np. <link linkend="if"
-><userinput
->jeśli</userinput
-></link
->. Wszystkie liczby i <link linkend="variables"
->zmienne</link
-> (kontenery liczbowe) mogą być porównywane ze sobą przy pomocy zapytań.</para>
-<para
->Poniżej znajdują się wszystkie możliwe pytania: <table>
-<title
->Typy zapytań</title>
+</screen> Pytaniem w tym przykładzie jest <userinput>x &gt; 5</userinput> . Jeżeli odpowiedź jest prawdziwa wykonywany jest kod w nawiasach. Zapytania są bardzo istotną częścią częścią programowania i są często używane z <link linkend="controlling-execution">instrukcjami sterującymi</link>, jak np. <link linkend="if"><userinput>jeśli</userinput></link>. Wszystkie liczby i <link linkend="variables">zmienne</link> (kontenery liczbowe) mogą być porównywane ze sobą przy pomocy zapytań.</para>
+<para>Poniżej znajdują się wszystkie możliwe pytania: <table>
+<title>Typy zapytań</title>
 <tgroup cols="3">
 <tbody>
 <row>
-<entry
-><userinput
->a == b</userinput
-></entry>
-<entry
->równa się</entry>
-<entry
->odpowiedź jest <quote
->prawdą</quote
-> gdy <userinput
->a</userinput
-> równa się <userinput
->b</userinput
-></entry>
+<entry><userinput>a == b</userinput></entry>
+<entry>równa się</entry>
+<entry>odpowiedź jest <quote>prawdą</quote> gdy <userinput>a</userinput> równa się <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a != b</userinput
-></entry>
-<entry
->nie równe</entry>
-<entry
->odpowiedź jest <quote
->prawdą</quote
-> gdy <userinput
->a</userinput
-> nie równa się <userinput
->b</userinput
-></entry>
+<entry><userinput>a != b</userinput></entry>
+<entry>nie równe</entry>
+<entry>odpowiedź jest <quote>prawdą</quote> gdy <userinput>a</userinput> nie równa się <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &gt; b</userinput
-></entry>
-<entry
->większe niż</entry>
-<entry
->odpowiedź jest <quote
->prawdą</quote
-> gdy <userinput
->a</userinput
-> jest większe niż <userinput
->b</userinput
-></entry>
+<entry><userinput>a &gt; b</userinput></entry>
+<entry>większe niż</entry>
+<entry>odpowiedź jest <quote>prawdą</quote> gdy <userinput>a</userinput> jest większe niż <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &lt; b</userinput
-></entry>
-<entry
->mniejsze niż</entry>
-<entry
->odpowiedź jest <quote
->prawdą</quote
-> gdy <userinput
->a</userinput
-> jest mniejsze niż <userinput
->b</userinput
-></entry>
+<entry><userinput>a &lt; b</userinput></entry>
+<entry>mniejsze niż</entry>
+<entry>odpowiedź jest <quote>prawdą</quote> gdy <userinput>a</userinput> jest mniejsze niż <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &gt;= b</userinput
-></entry>
-<entry
->większe lub równe</entry>
-<entry
->odpowiedź jest <quote
->prawdą</quote
-> gdy <userinput
->a</userinput
-> jest większe lub równe <userinput
->b</userinput
-></entry>
+<entry><userinput>a &gt;= b</userinput></entry>
+<entry>większe lub równe</entry>
+<entry>odpowiedź jest <quote>prawdą</quote> gdy <userinput>a</userinput> jest większe lub równe <userinput>b</userinput></entry>
 </row>
 <row>
-<entry
-><userinput
->a &lt;= b</userinput
-></entry>
-<entry
->mniejsze lub równe</entry>
-<entry
->odpowiedź jest <quote
->prawdą</quote
-> gdy <userinput
->a</userinput
-> mniejsze lub równe <userinput
->b</userinput
-></entry>
+<entry><userinput>a &lt;= b</userinput></entry>
+<entry>mniejsze lub równe</entry>
+<entry>odpowiedź jest <quote>prawdą</quote> gdy <userinput>a</userinput> mniejsze lub równe <userinput>b</userinput></entry>
 </row>
 </tbody>
 </tgroup>
 </table>
 </para>
-<para
->W <link linkend="the-code-editor"
->edytorze kodu</link
-> pytania są <glossterm
->podświetlone</glossterm
-> na kolor jasno niebieski.</para
-> 
+<para>W <link linkend="the-code-editor">edytorze kodu</link> pytania są <glossterm>podświetlone</glossterm> na kolor jasno niebieski.</para> 
 </sect2>
 
 <sect2 id="question-glue">
-<title
->Łączniki pytań</title>
-<para
->Wyrazy łączące pytania umożliwiają łączenie kilku małych pytań w jedno duże. <screen>
+<title>Łączniki pytań</title>
+<para>Wyrazy łączące pytania umożliwiają łączenie kilku małych pytań w jedno duże. <screen>
 a = 1
 b = 5
 jeśli (a &lt; 5) i (b == 5) [
   pisz "cześć"
 ]
-</screen
-> W tym przykładzie wyraz łączący <userinput
->i</userinput
-> jest użyty do połączenia dwóch pytań (<userinput
->a &lt; 5</userinput
->, <userinput
->b == 5</userinput
->). Jeżeli po jednej stronie <userinput
->i</userinput
-> odpowiedź będzie <quote
->fałszywa</quote
-> odpowiedź na całe pytanie będzie <quote
->fałszem</quote
->, gdyż używając wyrazu <userinput
->i</userinput
-> obie strony muszą być <quote
->prawdziwe</quote
-> by całe pytanie było <quote
->prawdą</quote
->. Proszę nie zapominać o użyciu nawiasów wokół pytań!</para>
+</screen> W tym przykładzie wyraz łączący <userinput>i</userinput> jest użyty do połączenia dwóch pytań (<userinput>a &lt; 5</userinput>, <userinput>b == 5</userinput>). Jeżeli po jednej stronie <userinput>i</userinput> odpowiedź będzie <quote>fałszywa</quote> odpowiedź na całe pytanie będzie <quote>fałszem</quote>, gdyż używając wyrazu <userinput>i</userinput> obie strony muszą być <quote>prawdziwe</quote> by całe pytanie było <quote>prawdą</quote>. Proszę nie zapominać o użyciu nawiasów wokół pytań!</para>
 
-<para
->Poniżej znajduje się schematyczne wytłumaczenie: <table>
-<title
->Wyrazy łączące pytania</title>
+<para>Poniżej znajduje się schematyczne wytłumaczenie: <table>
+<title>Wyrazy łączące pytania</title>
 <tgroup cols="2">
 <tbody>
 <row>
-<entry
-><userinput
->i</userinput
-></entry>
-<entry
->By wyrażenie było prawdziwe obie strony muszą być prawdziwe</entry>
+<entry><userinput>i</userinput></entry>
+<entry>By wyrażenie było prawdziwe obie strony muszą być prawdziwe</entry>
 </row>
 <row>
-<entry
-><userinput
->lub</userinput
-></entry>
-<entry
->By wyrażenie było prawdziwe, wystarczy by jedna strona była prawdziwa</entry>
+<entry><userinput>lub</userinput></entry>
+<entry>By wyrażenie było prawdziwe, wystarczy by jedna strona była prawdziwa</entry>
 </row>
 <row>
-<entry
-><userinput
->nie</userinput
-></entry>
-<entry
->Wyjątkowy przypadek: działa jedynie z pytaniami! Zmienia prawdę na fałsz a fałsz na prawdę.</entry>
+<entry><userinput>nie</userinput></entry>
+<entry>Wyjątkowy przypadek: działa jedynie z pytaniami! Zmienia prawdę na fałsz a fałsz na prawdę.</entry>
 </row>
 </tbody>
 </tgroup>
 </table>
 </para>
-<para
->W <link linkend="the-code-editor"
->edytorze kodu</link
-> wyrazy łączące pytania są <glossterm
->podświetlone</glossterm
-> na purpurowo.</para>
+<para>W <link linkend="the-code-editor">edytorze kodu</link> wyrazy łączące pytania są <glossterm>podświetlone</glossterm> na purpurowo.</para>
 
 <sect3 id="and">
-<title
->i</title>
-<para
->Gdy dwa pytania są połączone za pomocą <userinput
->i</userinput
->, obie strony <userinput
->i</userinput
-> muszą być prawdziwe by wynik był prawdziwy. Na przykład: <screen>
+<title>i</title>
+<para>Gdy dwa pytania są połączone za pomocą <userinput>i</userinput>, obie strony <userinput>i</userinput> muszą być prawdziwe by wynik był prawdziwy. Na przykład: <screen>
 a = 1
 b = 5
 jeśli ((a &lt; 10) i (b == 5)) i (a &lt; b) [
   pisz "cześć"
 ]
-</screen
-> W tym przykładzie można zaobserwować pytanie zagnieżdżone w pytaniu.</para>
+</screen> W tym przykładzie można zaobserwować pytanie zagnieżdżone w pytaniu.</para>
 </sect3>
 
 <sect3 id="or">
-<title
->lub</title>
-<para
->Gdy jedno z dwóch wyrażeń połączonych wyrazem <userinput
->lub</userinput
-> jest prawdziwe wynik jest prawdziwy. Na przykład: <screen>
+<title>lub</title>
+<para>Gdy jedno z dwóch wyrażeń połączonych wyrazem <userinput>lub</userinput> jest prawdziwe wynik jest prawdziwy. Na przykład: <screen>
 a = 1
 b = 5
 jeśli ((a &lt; 10) lub (b == 10)) lub (a == 0) [
   pisz "cześć"
 ]
-</screen
-> W tym przykładzie można zaobserwować pytanie zagnieżdżone w pytaniu.</para>
+</screen> W tym przykładzie można zaobserwować pytanie zagnieżdżone w pytaniu.</para>
 </sect3>
 
 <sect3 id="not">
-<title
->nie</title>
-<para
-><userinput
->nie</userinput
-> jest specjalnym wyrazem, gdyż odnosi się tylko do jednego wyrażenia. <userinput
->nie</userinput
-> zamienia fałsz na prawdę a prawdę na fałsz. Na przykład: <screen>
+<title>nie</title>
+<para><userinput>nie</userinput> jest specjalnym wyrazem, gdyż odnosi się tylko do jednego wyrażenia. <userinput>nie</userinput> zamienia fałsz na prawdę a prawdę na fałsz. Na przykład: <screen>
 a = 1
 b = 5
 jeśli nie ((a &lt; 10) i (b == 5)) [
@@ -1414,14 +601,7 @@ jeśli nie ((a &lt; 10) i (b == 5)) [
 ] przeciwnie [
   pisz "nie cześć ;-)"
 ]
-</screen
-> W tym przykładzie wyrażenie jest prawdziwe, ale <userinput
->nie</userinput
-> zamienia je na fałszywe. Więc na końcu na<link linkend="the-canvas"
->płótnie</link
-><userinput
->"nie cześć ;-)"</userinput
->.</para>
+</screen> W tym przykładzie wyrażenie jest prawdziwe, ale <userinput>nie</userinput> zamienia je na fałszywe. Więc na końcu na<link linkend="the-canvas">płótnie</link><userinput>"nie cześć ;-)"</userinput>.</para>
 </sect3>
 
 </sect2>
@@ -1429,169 +609,69 @@ jeśli nie ((a &lt; 10) i (b == 5)) [
 </sect1>
 
 <sect1 id="controlling-execution">
-<title
->Kontola wykonywania</title>
-<para
->Kontrolery wykonania umożliwiają użytkownikowi sterowanie wykonywaniem programu przez &mdash;.</para>
-<para
->Komendy kontrolujące wykonanie programu  <glossterm
->podświetlone</glossterm
-> są na ciemnozielony kolor oraz mają pogrubioną czcionkę. Nawiasy kwadratowe używane są głównie z komendami kontrolującymi wykonanie i są <glossterm
->podświetlone</glossterm
-> na jasno zielono.</para>
+<title>Kontola wykonywania</title>
+<para>Kontrolery wykonania umożliwiają użytkownikowi sterowanie wykonywaniem programu przez &mdash;.</para>
+<para>Komendy kontrolujące wykonanie programu  <glossterm>podświetlone</glossterm> są na ciemnozielony kolor oraz mają pogrubioną czcionkę. Nawiasy kwadratowe używane są głównie z komendami kontrolującymi wykonanie i są <glossterm>podświetlone</glossterm> na jasno zielono.</para>
 
 <sect2 id="wait">
-<title
->Zatrzymanie żółwia</title>
-<para
->Napisawszy jakiś program w &kturtle; można zauważyć, że żółw bardzo szybko wykonuje rysunki. Poniższa komenda zatrzymuje żółwia na określoną ilość czasu.</para>
+<title>Zatrzymanie żółwia</title>
+<para>Napisawszy jakiś program w &kturtle; można zauważyć, że żółw bardzo szybko wykonuje rysunki. Poniższa komenda zatrzymuje żółwia na określoną ilość czasu.</para>
   <variablelist>
     <varlistentry>
-      <term
->czekaj</term>
-      <listitem
-><para
-><screen
->czekaj X</screen>
-<userinput
->czekaj</userinput
-> zatrzymuje żółwia na X sekund. <screen>
+      <term>czekaj</term>
+      <listitem><para><screen>czekaj X</screen>
+<userinput>czekaj</userinput> zatrzymuje żółwia na X sekund. <screen>
 powtórz 36 [
   naprzód 5
   obróć_w_prawo 10
   czekaj 0.5
 ]
-</screen
-> Kod powoduje rysowanie okręgu, ale po każdym kroku żółw zatrzymuje się na pół sekundy. Daje to wrażenie poruszania się żółwia w zwolnionym tempie.</para
-></listitem>
+</screen> Kod powoduje rysowanie okręgu, ale po każdym kroku żółw zatrzymuje się na pół sekundy. Daje to wrażenie poruszania się żółwia w zwolnionym tempie.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="if">
-<title
->Instrukcja "jeśli"</title>
+<title>Instrukcja "jeśli"</title>
   <variablelist>
     <varlistentry>
-      <term
->jeśli</term>
-      <listitem
-><para
-><screen
->jeśli <link linkend="questions"
->pytanie</link
-> [ ... ]</screen>
-Kod umieszczony w nawiasach jest wykonywany jedynie wtedy gdy <userinput
->jeśli</userinput
-> wartość <link linkend="questions"
->wyrażenia</link
-> jest <quote
->prawdziwa</quote
->. Więcej informacji na temat <link linkend="questions"
->wyrażeń</link
-> znaleźć można w <link linkend="questions"
->sekcji wyrażenia</link
->. <screen>
+      <term>jeśli</term>
+      <listitem><para><screen>jeśli <link linkend="questions">pytanie</link> [ ... ]</screen>
+Kod umieszczony w nawiasach jest wykonywany jedynie wtedy gdy <userinput>jeśli</userinput> wartość <link linkend="questions">wyrażenia</link> jest <quote>prawdziwa</quote>. Więcej informacji na temat <link linkend="questions">wyrażeń</link> znaleźć można w <link linkend="questions">sekcji wyrażenia</link>. <screen>
 x = 6
 jeśli x &gt; 5 [
   pisz "x jest większe niż pięć!"
 ]
-</screen
-> W pierwszej linijce <userinput
->x</userinput
-> jest ustawiane jako 6. W drugiej linijce, znajduje się <link linkend="questions"
->pytanie</link
-> <userinput
->x &gt; 5</userinput
->. Jako, że wyrażenie to jest <quote
->prawdziwe</quote
-> kontroler wykonania <userinput
->jeśli</userinput
-> zezwala na wykonanie kodu w nawiasie.</para
-></listitem>
+</screen> W pierwszej linijce <userinput>x</userinput> jest ustawiane jako 6. W drugiej linijce, znajduje się <link linkend="questions">pytanie</link> <userinput>x &gt; 5</userinput>. Jako, że wyrażenie to jest <quote>prawdziwe</quote> kontroler wykonania <userinput>jeśli</userinput> zezwala na wykonanie kodu w nawiasie.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="while">
-<title
->Pętla "dopóki"</title>
+<title>Pętla "dopóki"</title>
   <variablelist>
     <varlistentry>
-      <term
->dopóki</term>
-      <listitem
-><para
-><screen
->dopóki <link linkend="questions"
->wyrażenie</link
-> [ ... ]</screen>
-Wyrażenie sterujące <userinput
->dopóki</userinput
-> jest podobne do <link linkend="if"
-><userinput
->jeśli</userinput
-></link
->. Różnica polega na tym, że <userinput
->dopóki</userinput
-> powtarza wykonywanie kodu między nawiasami dopóki wartość <link linkend="questions"
->wyrażenia</link
-> nie będzie <quote
->fałszywa</quote
->. <screen>
+      <term>dopóki</term>
+      <listitem><para><screen>dopóki <link linkend="questions">wyrażenie</link> [ ... ]</screen>
+Wyrażenie sterujące <userinput>dopóki</userinput> jest podobne do <link linkend="if"><userinput>jeśli</userinput></link>. Różnica polega na tym, że <userinput>dopóki</userinput> powtarza wykonywanie kodu między nawiasami dopóki wartość <link linkend="questions">wyrażenia</link> nie będzie <quote>fałszywa</quote>. <screen>
 x = 1
 dopóki x &lt; 5 [
   naprzód 10
   czekaj 1
   x = x + 1
 ]
-</screen
-> W pierwszej linii zmienna <userinput
->x</userinput
-> ustawiana jest na 1. W drugiej linii znajduje się <link linkend="questions"
->wyrażenie</link
-> <userinput
->x &lt; 5</userinput
->. Jako, że wyrażenie to jest <quote
->prawdziwe</quote
-> wyrażenie sterujące <userinput
->dopóki</userinput
-> rozpoczyna wykonywanie kodu między nawiasami dopóki wartość <link linkend="questions"
->wyrażenia</link
-> nie będzie <quote
->fałszywa</quote
->. W tym przypadku kod w nawiasie zostanie wykonany 4 razy, gdyż po każdym wykonaniu piątej linii <userinput
->x</userinput
-> wzrasta o 1.</para
-></listitem>
+</screen> W pierwszej linii zmienna <userinput>x</userinput> ustawiana jest na 1. W drugiej linii znajduje się <link linkend="questions">wyrażenie</link> <userinput>x &lt; 5</userinput>. Jako, że wyrażenie to jest <quote>prawdziwe</quote> wyrażenie sterujące <userinput>dopóki</userinput> rozpoczyna wykonywanie kodu między nawiasami dopóki wartość <link linkend="questions">wyrażenia</link> nie będzie <quote>fałszywa</quote>. W tym przypadku kod w nawiasie zostanie wykonany 4 razy, gdyż po każdym wykonaniu piątej linii <userinput>x</userinput> wzrasta o 1.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="else">
-<title
->Jeżeli nie, innymi słowami: "przeciwnie"</title>
+<title>Jeżeli nie, innymi słowami: "przeciwnie"</title>
   <variablelist>
     <varlistentry>
-      <term
->przeciwnie</term>
-      <listitem
-><para
-><screen
->jeśli wyrażenie [ ... ] przeciwnie [ ... ]</screen>
-<userinput
->przeciwnie</userinput
-> może być użyte w dodatku do wyrażenia sterującego <link linkend="if"
-><userinput
->jeśli</userinput
-></link
->. Kod pomiędzy nawiasami po <userinput
->przeciwnie</userinput
-> zostanie tylko wtedy gdy wartość <link linkend="questions"
->wyrażenia</link
-> jest <quote
->fałszywa</quote
->. <screen>
+      <term>przeciwnie</term>
+      <listitem><para><screen>jeśli wyrażenie [ ... ] przeciwnie [ ... ]</screen>
+<userinput>przeciwnie</userinput> może być użyte w dodatku do wyrażenia sterującego <link linkend="if"><userinput>jeśli</userinput></link>. Kod pomiędzy nawiasami po <userinput>przeciwnie</userinput> zostanie tylko wtedy gdy wartość <link linkend="questions">wyrażenia</link> jest <quote>fałszywa</quote>. <screen>
 zeruj
 x = 4
 jeśli x &gt; 5 [
@@ -1599,56 +679,23 @@ jeśli x &gt; 5 [
 ] przeciwnie [
   pisz "x jest mniejsze niż 6!"
 ]
-</screen
-> <link linkend="questions"
->Wyrażenie</link
-> sprawdza czy <userinput
->x</userinput
-> jest większy niż 5. Ponieważ w pierwszej linijce <userinput
->x</userinput
-> wynosi 4, wartość wyrażenia jest <quote
->fałszywa</quote
->. Oznacza to, że kod  w nawiasach po <userinput
->przeciwnie</userinput
-> zostanie wykonany.</para
-></listitem>
+</screen> <link linkend="questions">Wyrażenie</link> sprawdza czy <userinput>x</userinput> jest większy niż 5. Ponieważ w pierwszej linijce <userinput>x</userinput> wynosi 4, wartość wyrażenia jest <quote>fałszywa</quote>. Oznacza to, że kod  w nawiasach po <userinput>przeciwnie</userinput> zostanie wykonany.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="for">
-<title
->Pętla "dla", pętla zliczająca</title>
+<title>Pętla "dla", pętla zliczająca</title>
   <variablelist>
     <varlistentry>
-      <term
->dla</term>
-      <listitem
-><para
-><screen
->dla <userinput
->punkt początkowy</userinput
-> do <userinput
->punkt końcowy</userinput
-> [ ... ]</screen>
-Pętla <userinput
->dla</userinput
-> jest <quote
->pętlą zliczającą</quote
->, &ie; zlicza za użytkownika. <screen>
+      <term>dla</term>
+      <listitem><para><screen>dla <userinput>punkt początkowy</userinput> do <userinput>punkt końcowy</userinput> [ ... ]</screen>
+Pętla <userinput>dla</userinput> jest <quote>pętlą zliczającą</quote>, &ie; zlicza za użytkownika. <screen>
 dla x = 1 do 10 [
   pisz x * 7
   naprzód 15
 ]
-</screen
-> Za każdym razem gdy kod w nawiasach jest wykonywany wartość zmiennej <userinput
->x</userinput
-> zwiększa się o 1, dopóki zmienna <userinput
->x</userinput
-> nie osiągnie wartości 10. Kod w nawiasach wypisuje wartość zmiennej <userinput
->x</userinput
-> pomnożonej przez 7. Po wykonaniu programu na płótnie będzie można zobaczyć tabele wielokrotności liczby 7.</para
-></listitem>
+</screen> Za każdym razem gdy kod w nawiasach jest wykonywany wartość zmiennej <userinput>x</userinput> zwiększa się o 1, dopóki zmienna <userinput>x</userinput> nie osiągnie wartości 10. Kod w nawiasach wypisuje wartość zmiennej <userinput>x</userinput> pomnożonej przez 7. Po wykonaniu programu na płótnie będzie można zobaczyć tabele wielokrotności liczby 7.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
@@ -1657,39 +704,15 @@ dla x = 1 do 10 [
 
 
 <sect1 id="learn">
-<title
->Tworzenie własnych komend za pomocą <quote
->nauczyciela</quote
-></title>
-<para
-><userinput
->nauczyciel</userinput
-> jest specjalną komendą, służącą do tworzenia własnych komend. Utworzone komendy mogą przyjmować argumenty <glossterm linkend="input-output"
->wejściowe</glossterm
-> i zwracać <glossterm linkend="input-output"
->argumenty wyjściowe</glossterm
->. Zobaczmy jak tworzone są nowe komendy: <screen>
+<title>Tworzenie własnych komend za pomocą <quote>nauczyciela</quote></title>
+<para><userinput>nauczyciel</userinput> jest specjalną komendą, służącą do tworzenia własnych komend. Utworzone komendy mogą przyjmować argumenty <glossterm linkend="input-output">wejściowe</glossterm> i zwracać <glossterm linkend="input-output">argumenty wyjściowe</glossterm>. Zobaczmy jak tworzone są nowe komendy: <screen>
 poznaj okrąg x [
   powtórz 36 [
     naprzód x
     obróć_w_lewo 10
   ]
 ]
-</screen
-> Nowa komenda zostanie nazwana <userinput
->okrąg</userinput
->. <userinput
->okrąg</userinput
-> oczekuje jednego <glossterm linkend="input-output"
->argumentu wejściowego</glossterm
->, liczby określającej rozmiar okręgu. <userinput
->okrąg</userinput
-> nie zwraca żadnego <glossterm linkend="input-output"
->argumentu wyjściowego</glossterm
->. Komenda <userinput
->okrąg</userinput
-> może być teraz używana jak normalna komenda w reszcie kodu. Oto przykład: <screen
->poznaj okrąg X [
+</screen> Nowa komenda zostanie nazwana <userinput>okrąg</userinput>. <userinput>okrąg</userinput> oczekuje jednego <glossterm linkend="input-output">argumentu wejściowego</glossterm>, liczby określającej rozmiar okręgu. <userinput>okrąg</userinput> nie zwraca żadnego <glossterm linkend="input-output">argumentu wyjściowego</glossterm>. Komenda <userinput>okrąg</userinput> może być teraz używana jak normalna komenda w reszcie kodu. Oto przykład: <screen>poznaj okrąg X [
   powtórz 36 [ 
     naprzód X 
     obróć_w_lewo 10 
@@ -1703,8 +726,7 @@ idź 40,40
 okrąg 50  
 </screen>
 </para>
-<para
->W następnym przykładzie tworzona jest komenda zwracająca wartość. <screen>
+<para>W następnym przykładzie tworzona jest komenda zwracająca wartość. <screen>
 zeruj
 
 poznaj pomnóżPrzezSiebie n [
@@ -1714,14 +736,7 @@ poznaj pomnóżPrzezSiebie n [
 ]
 i = okno_wejścia "Proszę wprowadzić liczbę i wcisnąć Enter"
 pisz i + " pomnożone przez siebie daje: " + pomnóżPrzezSiebie i
-</screen
-> W przykładzie tworzona jest komenda <userinput
->pomnóżPrzezSiebie</userinput
->. Argument wejściowy komendy jest mnożony przez siebie i zwracany, za pomocą komendy <anchor id="return"/><userinput
->powrót</userinput
->. Komenda <userinput
->powrót</userinput
-> umożliwia zwrócenie wartość z utworzonej własnej funkcji. </para>
+</screen> W przykładzie tworzona jest komenda <userinput>pomnóżPrzezSiebie</userinput>. Argument wejściowy komendy jest mnożony przez siebie i zwracany, za pomocą komendy <anchor id="return"/><userinput>powrót</userinput>. Komenda <userinput>powrót</userinput> umożliwia zwrócenie wartość z utworzonej własnej funkcji. </para>
 </sect1>
 
 </chapter>
diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/translator-guide.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/translator-guide.docbook
index aec8638d929..6c34887ad76 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/translator-guide.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/translator-guide.docbook
@@ -1,211 +1,52 @@
 <chapter id="translators">
-<title
->Podręcznik tłumacza &kturtle;</title>
-<para
->Jak już prawdopodobnie wiesz, szczególną cechą języka programowania &logo; jest to, że polecenia &logo; są często tłumaczone na język programisty. Usuwa to barierę dla niektórych uczących się osób, która utrudnia zrozumienie programowania. Przy tłumaczeniu &kturtle; na nowy język, należy przetłumaczyć niektóre dodatkowe pliki poza ciągami i dokumentacją. Większość jest generowana automatycznie przez skrypty Rafaela Beccar'a. Skrypty te można odnaleźć w <userinput
->tdeedu/kturtle/scripts</userinput
->, natomiast pliki, które wymagają tłumaczenia można odnaleźć w <userinput
->tdeedu/kturtle/data</userinput
->. W tych katalogach odnajdziesz także pliki README, które zawierają instrukcje dotyczące korzystania z nich. </para>
+<title>Podręcznik tłumacza &kturtle;</title>
+<para>Jak już prawdopodobnie wiesz, szczególną cechą języka programowania &logo; jest to, że polecenia &logo; są często tłumaczone na język programisty. Usuwa to barierę dla niektórych uczących się osób, która utrudnia zrozumienie programowania. Przy tłumaczeniu &kturtle; na nowy język, należy przetłumaczyć niektóre dodatkowe pliki poza ciągami i dokumentacją. Większość jest generowana automatycznie przez skrypty Rafaela Beccar'a. Skrypty te można odnaleźć w <userinput>tdeedu/kturtle/scripts</userinput>, natomiast pliki, które wymagają tłumaczenia można odnaleźć w <userinput>tdeedu/kturtle/data</userinput>. W tych katalogach odnajdziesz także pliki README, które zawierają instrukcje dotyczące korzystania z nich. </para>
  
 <sect1 id="make_directory">
-<title
->Tworzenie katalogu na przetłumaczone pliki</title>
-<para
->Najpierw, należy utworzyć katalog do przechowywania przetłumaczonych plików. Utwórz katalog o nazwie <filename class="directory"
->tde-i18n/<replaceable
-> kod</replaceable
->/data/tdeedu/kturtle/</filename
-> w swoim katalogu CVS KDE, gdzie <replaceable
->kod</replaceable
-> jest kodem kraju (litera 2- lub 4- kod <acronym
->ISO</acronym
->). </para>
-<para
->Skopiuj do tego katalogu plik <filename
->Makefile.am</filename
-> z <filename class="directory"
->tdeedu/kturtle/data/</filename
->. Otwórz go za pomocą dowolnego edytora tekstów, zamień każdą pozycję, w której występuje <quote
->en_US</quote
-> na kod Twojego kraju (ten pokazany powyżej). Następnie zapisz pliku. </para>
+<title>Tworzenie katalogu na przetłumaczone pliki</title>
+<para>Najpierw, należy utworzyć katalog do przechowywania przetłumaczonych plików. Utwórz katalog o nazwie <filename class="directory">tde-i18n/<replaceable> kod</replaceable>/data/tdeedu/kturtle/</filename> w swoim katalogu CVS KDE, gdzie <replaceable>kod</replaceable> jest kodem kraju (litera 2- lub 4- kod <acronym>ISO</acronym>). </para>
+<para>Skopiuj do tego katalogu plik <filename>Makefile.am</filename> z <filename class="directory">tdeedu/kturtle/data/</filename>. Otwórz go za pomocą dowolnego edytora tekstów, zamień każdą pozycję, w której występuje <quote>en_US</quote> na kod Twojego kraju (ten pokazany powyżej). Następnie zapisz pliku. </para>
 </sect1>
 <sect1 id="commands_trans">
-<title
->Jak tłumaczyć słowa kluczowe &logo; (polecenia)</title>
+<title>Jak tłumaczyć słowa kluczowe &logo; (polecenia)</title>
 <para>
 <itemizedlist>
-<listitem
-><para
->Skopiuj plik <filename
->logokeywords.en_US.xml</filename
-> z <filename class="directory"
->tdeedu/kturtle/data/</filename
-> do katalogu, który właśnie stworzyłeś, a następnie zmień nazwę pliku na <filename
->logokeywords.<replaceable
->kod</replaceable
->.xml</filename
->, gdzie <replaceable
->kod</replaceable
-> jest kodem Twojego kraju (litera 2- lub 4- kod <acronym
->ISO</acronym
->). </para>
+<listitem><para>Skopiuj plik <filename>logokeywords.en_US.xml</filename> z <filename class="directory">tdeedu/kturtle/data/</filename> do katalogu, który właśnie stworzyłeś, a następnie zmień nazwę pliku na <filename>logokeywords.<replaceable>kod</replaceable>.xml</filename>, gdzie <replaceable>kod</replaceable> jest kodem Twojego kraju (litera 2- lub 4- kod <acronym>ISO</acronym>). </para>
 </listitem>
-<listitem
-><para
->Przetłumacz zawartość tagu <sgmltag class="starttag"
->keyword</sgmltag
-> (&ie; informacje pomiędzy <sgmltag class="starttag"
->keyword</sgmltag
->, a <sgmltag class="endtag"
->keyword</sgmltag
->) na własny język gdziekolwiek to tylko możliwe. Również, przetłumacz zawartość tagu <sgmltag class="starttag"
->alias</sgmltag
->, (&ie; informacje pomiędzy <sgmltag class="starttag"
->alias</sgmltag
->, a <sgmltag class="endtag"
->alias</sgmltag
->): są one używane jako skróty dla słowa kluczowego.</para>
-<para
->Na przykład, przetłumacz <quote
->while</quote
-> w: <sgmltag class="starttag"
->keyword</sgmltag
->while<sgmltag class="endtag"
->keyword</sgmltag
-> </para>
-<para
->Pamiętaj, aby nie tłumaczyć czego innego oraz nie tłumaczyć angielskich słów w <sgmltag class="starttag"
->command name="angielskie_słowo"</sgmltag
->: muszą one pozostać w języku angielskim. </para>
-<para
->Ostatnia uwaga: nie zmieniaj kolejności tego pliku, jest on potrzebny do skryptów generacji automatycznych tłumaczeń Rafael'a Beccar'a. </para>
+<listitem><para>Przetłumacz zawartość tagu <sgmltag class="starttag">keyword</sgmltag> (&ie; informacje pomiędzy <sgmltag class="starttag">keyword</sgmltag>, a <sgmltag class="endtag">keyword</sgmltag>) na własny język gdziekolwiek to tylko możliwe. Również, przetłumacz zawartość tagu <sgmltag class="starttag">alias</sgmltag>, (&ie; informacje pomiędzy <sgmltag class="starttag">alias</sgmltag>, a <sgmltag class="endtag">alias</sgmltag>): są one używane jako skróty dla słowa kluczowego.</para>
+<para>Na przykład, przetłumacz <quote>while</quote> w: <sgmltag class="starttag">keyword</sgmltag>while<sgmltag class="endtag">keyword</sgmltag> </para>
+<para>Pamiętaj, aby nie tłumaczyć czego innego oraz nie tłumaczyć angielskich słów w <sgmltag class="starttag">command name="angielskie_słowo"</sgmltag>: muszą one pozostać w języku angielskim. </para>
+<para>Ostatnia uwaga: nie zmieniaj kolejności tego pliku, jest on potrzebny do skryptów generacji automatycznych tłumaczeń Rafael'a Beccar'a. </para>
 </listitem>
-<listitem
-><para
->Zapisz swoje pliki jako <acronym
->UTF-8</acronym
-> (w &kate;, wykorzystaj <guimenuitem
->Zapisz jako...</guimenuitem
-> i zmień na <guilabel
->utf8</guilabel
-> w polu po prawej stronie nazwy pliku). </para>
+<listitem><para>Zapisz swoje pliki jako <acronym>UTF-8</acronym> (w &kate;, wykorzystaj <guimenuitem>Zapisz jako...</guimenuitem> i zmień na <guilabel>utf8</guilabel> w polu po prawej stronie nazwy pliku). </para>
 </listitem>
-<listitem
-><para
->Dołącz swój plik (dodaj nazwę swojego pliku do <filename
->Makefile.am</filename
->) lub wyślij go do Anne-Marie. </para>
+<listitem><para>Dołącz swój plik (dodaj nazwę swojego pliku do <filename>Makefile.am</filename>) lub wyślij go do Anne-Marie. </para>
 </listitem>
-<listitem
-><para
->W razie jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf <email
->annemarie.mahfouf@free.fr</email
->, aby uzyskać dalsze informacje.</para>
+<listitem><para>W razie jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email>, aby uzyskać dalsze informacje.</para>
 </listitem>
 </itemizedlist>
 </para>
 </sect1>
 
 <sect1 id="examples_syntax">
-<title
->Jak tłumaczyć pliki składni</title>
-<para
->Tłumaczenie <filename
->logohighlightstyle.en_US.xml</filename
-> jest bardzo proste przy korzystaniu ze skryptu Rafael'a Beccar'a w <filename class="directory"
->tdeedu/kturtle/data/</filename
->. Pamiętaj o przeczytaniu pliku README w tym katalogu. </para>
-<para
->Dla pełnej kompatybilności z wszystkimi ludźmi, którzy nie chcą korzystać ze skryptów perla wspomnianych w poprzednim paragrafie, oda starsza metoda na wykonanie tej samej czynności: <itemizedlist>
-<listitem
-><para
->Skopiuj plik <filename
->logohighlightstyle.en_US.xml</filename
-> z <filename class="directory"
->tdeedu/kturtle/data/</filename
-> do katalogu, który utworzyłeś do przechowywania przetłumaczonych plików słów kluczowych, a następnie zmień jego nazwę na <filename
->logohighlightstyle.<replaceable
->kod</replaceable
->.xml</filename
->, gdzie <replaceable
->kod</replaceable
-> jest kodem Twojego kraju (litera 2- lub 4- kod <acronym
->ISO</acronym
->). </para>
+<title>Jak tłumaczyć pliki składni</title>
+<para>Tłumaczenie <filename>logohighlightstyle.en_US.xml</filename> jest bardzo proste przy korzystaniu ze skryptu Rafael'a Beccar'a w <filename class="directory">tdeedu/kturtle/data/</filename>. Pamiętaj o przeczytaniu pliku README w tym katalogu. </para>
+<para>Dla pełnej kompatybilności z wszystkimi ludźmi, którzy nie chcą korzystać ze skryptów perla wspomnianych w poprzednim paragrafie, oda starsza metoda na wykonanie tej samej czynności: <itemizedlist>
+<listitem><para>Skopiuj plik <filename>logohighlightstyle.en_US.xml</filename> z <filename class="directory">tdeedu/kturtle/data/</filename> do katalogu, który utworzyłeś do przechowywania przetłumaczonych plików słów kluczowych, a następnie zmień jego nazwę na <filename>logohighlightstyle.<replaceable>kod</replaceable>.xml</filename>, gdzie <replaceable>kod</replaceable> jest kodem Twojego kraju (litera 2- lub 4- kod <acronym>ISO</acronym>). </para>
 </listitem>
-<listitem
-><para
->We wierszu 4 pliku, znajduje się <sgmltag class="starttag"
->language name="en_US"</sgmltag
->...: tutaj zmieniasz <quote
->en_US</quote
-> na kod <acronym
->ISO</acronym
-> Twojego języka (litery 2 lub 4). </para
-></listitem>
-<listitem
-><para
->Przetłumacz na swój język zawartość tagu <sgmltag class="starttag"
->item</sgmltag
-> (&ie; informacje pomiędzy <sgmltag class="starttag"
->item</sgmltag
-> oraz <sgmltag class="endtag"
->item</sgmltag
->). Ta zawartość musi pasować do pliku <filename
->logokeyword</filename
->. Na przykład, przetłumacz <quote
->while</quote
-> w: <sgmltag class="starttag"
->item</sgmltag
-> while <sgmltag class="endtag"
->item</sgmltag
-> i pozostaw spacje na swoim miejscu (jedną na początku i jedną na końcu). Nie tłumacz niczego innego. </para
-></listitem>
-<listitem
-><para
->Zapisz swoje pliki jako <acronym
->UTF-8</acronym
-> (w &kate;, wykorzystaj <guimenuitem
->Zapisz jako...</guimenuitem
-> i zmień na <guilabel
->utf8</guilabel
-> w polu po prawej stronie nazwy pliku). </para
-></listitem>
-<listitem
-><para
->Dołącz swój plik (dodaj nazwę swojego pliku do <filename
->Makefile.am</filename
->) lub wyślij go do Anne-Marie. </para
-></listitem>
-<listitem
-><para
->W razie jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf <email
->annemarie.mahfouf@free.fr</email
->, aby uzyskać dalsze informacje. </para
-></listitem>
+<listitem><para>We wierszu 4 pliku, znajduje się <sgmltag class="starttag">language name="en_US"</sgmltag>...: tutaj zmieniasz <quote>en_US</quote> na kod <acronym>ISO</acronym> Twojego języka (litery 2 lub 4). </para></listitem>
+<listitem><para>Przetłumacz na swój język zawartość tagu <sgmltag class="starttag">item</sgmltag> (&ie; informacje pomiędzy <sgmltag class="starttag">item</sgmltag> oraz <sgmltag class="endtag">item</sgmltag>). Ta zawartość musi pasować do pliku <filename>logokeyword</filename>. Na przykład, przetłumacz <quote>while</quote> w: <sgmltag class="starttag">item</sgmltag> while <sgmltag class="endtag">item</sgmltag> i pozostaw spacje na swoim miejscu (jedną na początku i jedną na końcu). Nie tłumacz niczego innego. </para></listitem>
+<listitem><para>Zapisz swoje pliki jako <acronym>UTF-8</acronym> (w &kate;, wykorzystaj <guimenuitem>Zapisz jako...</guimenuitem> i zmień na <guilabel>utf8</guilabel> w polu po prawej stronie nazwy pliku). </para></listitem>
+<listitem><para>Dołącz swój plik (dodaj nazwę swojego pliku do <filename>Makefile.am</filename>) lub wyślij go do Anne-Marie. </para></listitem>
+<listitem><para>W razie jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email>, aby uzyskać dalsze informacje. </para></listitem>
 </itemizedlist>
 </para>
 </sect1>
 
 <sect1 id="examples_trans">
-<title
->Przykłady tłumaczeń</title>
-<para
->Podobnie i to zadanie jest w znacznym stopniu uproszczone dzięki skryptowi Rafael'a Beccar'a w <filename class="directory"
->tdeedu/kturtle/data/</filename
->. Pamiętaj, aby przeczytać plik w tym katalogu, ponieważ część pracy w dalszym ciągu musi zostać wykonana po tym jak pliki logo zostaną automatycznie przetłumaczone. </para>
-<para
->Jeżeli zastosowałeś się do instrukcji podanych w pliku README, który znalazłeś w katalogu skryptów, powinieneś być prawie gotowy. Pamiętaj, aby sprawdzić przetłumaczony przykładowy kod logo, który utworzyłeś, ponieważ często zdarza się, że wkrada się błąd. Upewnij się również, że plik <userinput
->Makefile.am</userinput
-> w <filename class="directory"
->tde-i18n/<replaceable
->kod</replaceable
->/data/tdeedu/kturtle/</filename
-> jest zaktualizowany zgodnie z nowymi plikami. W przypadku języka holenderskiego, plik <userinput
->Makefile.am</userinput
-> powinien wyglądać następująco: <screen
->txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
+<title>Przykłady tłumaczeń</title>
+<para>Podobnie i to zadanie jest w znacznym stopniu uproszczone dzięki skryptowi Rafael'a Beccar'a w <filename class="directory">tdeedu/kturtle/data/</filename>. Pamiętaj, aby przeczytać plik w tym katalogu, ponieważ część pracy w dalszym ciągu musi zostać wykonana po tym jak pliki logo zostaną automatycznie przetłumaczone. </para>
+<para>Jeżeli zastosowałeś się do instrukcji podanych w pliku README, który znalazłeś w katalogu skryptów, powinieneś być prawie gotowy. Pamiętaj, aby sprawdzić przetłumaczony przykładowy kod logo, który utworzyłeś, ponieważ często zdarza się, że wkrada się błąd. Upewnij się również, że plik <userinput>Makefile.am</userinput> w <filename class="directory">tde-i18n/<replaceable>kod</replaceable>/data/tdeedu/kturtle/</filename> jest zaktualizowany zgodnie z nowymi plikami. W przypadku języka holenderskiego, plik <userinput>Makefile.am</userinput> powinien wyglądać następująco: <screen>txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
 bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \
 kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo
 txtdir = $(kde_datadir)/kturtle/examples/nl
@@ -216,48 +57,20 @@ xmldir = $(kde_datadir)/katepart/syntax
 keywords_DATA = logokeywords.nl.xml
 keywordsdir = $(kde_datadir)/kturtle/data
 EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)
-</screen
-> 
+</screen> 
 </para>
-<para
->Oto jak wykonać tłumaczenie BEZ korzystania ze skryptów Rafael'a: <itemizedlist>
-<listitem
-><para
->Skopiuj przykłady angielskich plików z <filename class="directory"
->tdeedu/kturtle/data/</filename
-> do katalogu wykorzystywanego do przechowywania przetłumaczonych słów kluczowych i plików skryptów. Przetłumacz nazwy plików przykładów w swoim katalogu: pozwoli to użytkownikom na łatwe i szybkie zrozumienie tego, czego dotyczy przykład.</para>
+<para>Oto jak wykonać tłumaczenie BEZ korzystania ze skryptów Rafael'a: <itemizedlist>
+<listitem><para>Skopiuj przykłady angielskich plików z <filename class="directory">tdeedu/kturtle/data/</filename> do katalogu wykorzystywanego do przechowywania przetłumaczonych słów kluczowych i plików skryptów. Przetłumacz nazwy plików przykładów w swoim katalogu: pozwoli to użytkownikom na łatwe i szybkie zrozumienie tego, czego dotyczy przykład.</para>
 </listitem>
-<listitem
-><para
->Przetłumacz słowa kluczowe w przykładach, korzystając z tych w pliku <filename
->logokeywords.xml</filename
-> dla Twojego języka. Plik słów kluczowych musi zostać zrobiony przed tłumaczeniem przykładów.</para>
+<listitem><para>Przetłumacz słowa kluczowe w przykładach, korzystając z tych w pliku <filename>logokeywords.xml</filename> dla Twojego języka. Plik słów kluczowych musi zostać zrobiony przed tłumaczeniem przykładów.</para>
 </listitem>
-<listitem
-><para
->Zachowaj swój plik jako <acronym
->UTF-8</acronym
-> (w &kate;, wykorzystaj <guimenuitem
->Zapisz jako...</guimenuitem
-> i zmień na <guilabel
->utf8</guilabel
-> w polu po prawej stronie nazwy pliku)</para>
+<listitem><para>Zachowaj swój plik jako <acronym>UTF-8</acronym> (w &kate;, wykorzystaj <guimenuitem>Zapisz jako...</guimenuitem> i zmień na <guilabel>utf8</guilabel> w polu po prawej stronie nazwy pliku)</para>
 </listitem>
-<listitem
-><para
->Dołącz swój folder (dodaj <filename
->Makefile.am</filename
->) lub wyślij go do Anne-Marie.</para>
+<listitem><para>Dołącz swój folder (dodaj <filename>Makefile.am</filename>) lub wyślij go do Anne-Marie.</para>
 </listitem>
-<listitem
-><para
->W przypadku jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf, <email
->annemarie.mahfouf@free.fr</email
->.</para>
+<listitem><para>W przypadku jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf, <email>annemarie.mahfouf@free.fr</email>.</para>
 </listitem>
-<listitem
-><para
->Wreszcie, jeżeli chcesz, dodaj swoje własne przykłady do tego folderu.</para>
+<listitem><para>Wreszcie, jeżeli chcesz, dodaj swoje własne przykłady do tego folderu.</para>
 </listitem>
 </itemizedlist>
 </para>
diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/using-kturtle.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/using-kturtle.docbook
index 3b002756049..080aaefaf02 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/using-kturtle.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/using-kturtle.docbook
@@ -1,1085 +1,365 @@
 <!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
      Thanks a lot in advance.-->
 <chapter id="using-kturtle">
-<title
->Użycie &kturtle;</title>
+<title>Użycie &kturtle;</title>
 
 <screenshot>
-  <screeninfo
->Zrzut ekranowy &kturtle; podczas jego pracy</screeninfo>
+  <screeninfo>Zrzut ekranowy &kturtle; podczas jego pracy</screeninfo>
   <mediaobject>
     <imageobject>
       <imagedata fileref="mainwindow_flower_nrs.png" format="PNG"/>
     </imageobject>
     <textobject>
-      <phrase
->Okno główne &kturtle;</phrase>
+      <phrase>Okno główne &kturtle;</phrase>
     </textobject>
   </mediaobject>
 </screenshot>
 
-<para
->Okno główne &kturtle; składa się z dwóch głównych części: <link linkend="the-code-editor"
->edytora kodu</link
-> (3) po lewej, można tam wprowadzać komendy &logo;, oraz <link linkend="the-canvas"
->płótna</link
-> (4) po prawej, gdzie można zobaczyć efekty wprowadzanych instrukcji. <link linkend="the-canvas"
->Płótno</link
-> jest placem zabaw żółwia: żółw porusza się po płótnie i na nim rysuje. Trzy inne części w oknie głównym to: <link linkend="the-menubar"
->pasek menu</link
-> (1) gdzie mogą być wybrane wszystkie czynności, <link linkend="the-toolbar"
->pasek narzędzi</link
-> (2) powalający na szybki wybór najczęściej używanych czynności, oraz <link linkend="the-statusbar"
->pasek stanu</link
->, (5) gdzie można zobaczyć aktualny stan działania &kturtle;.</para>
+<para>Okno główne &kturtle; składa się z dwóch głównych części: <link linkend="the-code-editor">edytora kodu</link> (3) po lewej, można tam wprowadzać komendy &logo;, oraz <link linkend="the-canvas">płótna</link> (4) po prawej, gdzie można zobaczyć efekty wprowadzanych instrukcji. <link linkend="the-canvas">Płótno</link> jest placem zabaw żółwia: żółw porusza się po płótnie i na nim rysuje. Trzy inne części w oknie głównym to: <link linkend="the-menubar">pasek menu</link> (1) gdzie mogą być wybrane wszystkie czynności, <link linkend="the-toolbar">pasek narzędzi</link> (2) powalający na szybki wybór najczęściej używanych czynności, oraz <link linkend="the-statusbar">pasek stanu</link>, (5) gdzie można zobaczyć aktualny stan działania &kturtle;.</para>
 
 <sect1 id="the-code-editor">
-<title
->Edytor kodu</title>
-<para
->W edytorze kodu wprowadza się komendy &logo;. Posiada on wszystkie cechy, których można oczekiwać od nowoczesnego edytora. Większość z nich można znaleźć w menu <link linkend="the-edit-menu"
->Edycja</link
-> i <link linkend="the-tools-menu"
->Narzędzia</link
-> . Edytor kodu może być dowolnie przesuwany, przyczepiany do dowolnego miejsca na oknie głównym a także może być umieszczony w dowolnym miejscu na pulpicie.</para>
-<para
->Istnieje kilka sposobów uzyskania kodu w edytorze. Najprostszy to użycie istniejącego przykładu wybranego z menu <menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Otwórz przykład</guimenuitem
-> </menuchoice
-> w menu <link linkend="the-file-menu"
->Plik</link
-> a następnie wybrać plik. Nazwa pliku określa czego dotyczy plik (&eg; <filename
->square.logo</filename
-> narysuje kwadrat). Wybrany plik zostanie otworzony w <link linkend="the-code-editor"
->edytorze kodu</link
->, następnie wybierając z menu <menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Wykonaj komendy</guimenuitem
-> </menuchoice
-> można uruchomić kod.</para>
-<para
->Pliki &logo; można otworzyć wybierając <menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Otwórz...</guimenuitem
-> </menuchoice
->.</para>
-<para
->Trzecim sposobem jest wprowadzenie własnego kodu w edytorze bądź skopiowanie gotowego kodu z podręcznika użytkownika. </para>
-<para
->Pozycja kursora wskazywana jest po prawej stronie <link linkend="the-statusbar"
->pasku statusu</link
->, wraz z numerem linii i numerem kolumny. </para>
+<title>Edytor kodu</title>
+<para>W edytorze kodu wprowadza się komendy &logo;. Posiada on wszystkie cechy, których można oczekiwać od nowoczesnego edytora. Większość z nich można znaleźć w menu <link linkend="the-edit-menu">Edycja</link> i <link linkend="the-tools-menu">Narzędzia</link> . Edytor kodu może być dowolnie przesuwany, przyczepiany do dowolnego miejsca na oknie głównym a także może być umieszczony w dowolnym miejscu na pulpicie.</para>
+<para>Istnieje kilka sposobów uzyskania kodu w edytorze. Najprostszy to użycie istniejącego przykładu wybranego z menu <menuchoice><guimenu>Plik</guimenu><guimenuitem>Otwórz przykład</guimenuitem> </menuchoice> w menu <link linkend="the-file-menu">Plik</link> a następnie wybrać plik. Nazwa pliku określa czego dotyczy plik (&eg; <filename>square.logo</filename> narysuje kwadrat). Wybrany plik zostanie otworzony w <link linkend="the-code-editor">edytorze kodu</link>, następnie wybierając z menu <menuchoice><guimenu>Plik</guimenu><guimenuitem>Wykonaj komendy</guimenuitem> </menuchoice> można uruchomić kod.</para>
+<para>Pliki &logo; można otworzyć wybierając <menuchoice><guimenu>Plik</guimenu><guimenuitem>Otwórz...</guimenuitem> </menuchoice>.</para>
+<para>Trzecim sposobem jest wprowadzenie własnego kodu w edytorze bądź skopiowanie gotowego kodu z podręcznika użytkownika. </para>
+<para>Pozycja kursora wskazywana jest po prawej stronie <link linkend="the-statusbar">pasku statusu</link>, wraz z numerem linii i numerem kolumny. </para>
 </sect1>
 
 <sect1 id="the-canvas">
-<title
->Płótno</title>
-<para
->Płótno jest obszarem na którym komendy <quote
->rysują</quote
-> obrazy. Innymi słowami jest to plac zabaw żółwia. Po wprowadzeniu kodu do <link linkend="the-code-editor"
->edytora kodu</link
->, i wykonaniu go przy użyciu menu <menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Wykonaj komendy</guimenuitem
-> </menuchoice
->, mogą zdarzyć się dwie rzeczy: kod wykona się poprawnie i zobaczymy zmiany na płótnie; bądź w kodzie został popełniony błąd i pojawi się komunikat opisujący ten błąd.</para>
-<para
->Pojawiający się komunikat powinien pomóc rozwiązać problem związany z błędem.</para>
-<para
->Narysowany obrazek może być zapisany jak obraz (przy użyciu menu <menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Zapisz płótno</guimenuitem
-> </menuchoice
->) bądź wydrukowany (przy użyciu menu <menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Drukuj...</guimenuitem
-> </menuchoice
->).</para>
+<title>Płótno</title>
+<para>Płótno jest obszarem na którym komendy <quote>rysują</quote> obrazy. Innymi słowami jest to plac zabaw żółwia. Po wprowadzeniu kodu do <link linkend="the-code-editor">edytora kodu</link>, i wykonaniu go przy użyciu menu <menuchoice><guimenu>Plik</guimenu><guimenuitem>Wykonaj komendy</guimenuitem> </menuchoice>, mogą zdarzyć się dwie rzeczy: kod wykona się poprawnie i zobaczymy zmiany na płótnie; bądź w kodzie został popełniony błąd i pojawi się komunikat opisujący ten błąd.</para>
+<para>Pojawiający się komunikat powinien pomóc rozwiązać problem związany z błędem.</para>
+<para>Narysowany obrazek może być zapisany jak obraz (przy użyciu menu <menuchoice><guimenu>Plik</guimenu><guimenuitem>Zapisz płótno</guimenuitem> </menuchoice>) bądź wydrukowany (przy użyciu menu <menuchoice><guimenu>Plik</guimenu><guimenuitem>Drukuj...</guimenuitem> </menuchoice>).</para>
 </sect1>
 
 <sect1 id="the-menubar">
-<title
->Pasek menu</title>
-<para
->W pasku menu można znaleźć wszystkie akcje &kturtle;. Pogrupowane są one następująco: <guimenu
->Plik</guimenu
->, <guimenu
->Edycja</guimenu
->, <guimenu
->Widok</guimenu
->, <guimenu
->Narzędzia</guimenu
->, <guimenu
->Ustawienia</guimenu
->, oraz <guimenu
->Pomoc</guimenu
->. Pomoc opisuje wszystkie poprzednie.</para>
+<title>Pasek menu</title>
+<para>W pasku menu można znaleźć wszystkie akcje &kturtle;. Pogrupowane są one następująco: <guimenu>Plik</guimenu>, <guimenu>Edycja</guimenu>, <guimenu>Widok</guimenu>, <guimenu>Narzędzia</guimenu>, <guimenu>Ustawienia</guimenu>, oraz <guimenu>Pomoc</guimenu>. Pomoc opisuje wszystkie poprzednie.</para>
 
 <sect2 id="the-file-menu">
-<title
->Menu <guimenu
->Plik</guimenu
-></title>
+<title>Menu <guimenu>Plik</guimenu></title>
 
 <sect3 id="file-new">
-<title
->Nowy</title>
+<title>Nowy</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->N</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Nowy</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Tworzy nowy plik &logo;.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Nowy</guimenuitem> </menuchoice></term>
+      <listitem><para>Tworzy nowy plik &logo;.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-open">
-<title
->Otwórz</title>
+<title>Otwórz</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->O</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Otwórz...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Otwiera plik &logo;.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Otwórz...</guimenuitem> </menuchoice></term>
+      <listitem><para>Otwiera plik &logo;.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-open-recent">
-<title
->Otwórz ostatni</title>
+<title>Otwórz ostatni</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Plik</guimenu
-> <guimenuitem
->Otwórz ostatni</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Otwiera ostatnio używany plik &logo;.</para
-></listitem>
+      <term><menuchoice><guimenu>Plik</guimenu> <guimenuitem>Otwórz ostatni</guimenuitem> </menuchoice></term>
+      <listitem><para>Otwiera ostatnio używany plik &logo;.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-open-examples">
-<title
->Otwórz przykład</title>
+<title>Otwórz przykład</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->E</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Otwórz przykład</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Pokazuje katalog z przykładami programów w &logo;. Przykłady będą w ulubionym języku użytkownika wybranym w menu <menuchoice
-><guimenu
->Ustawienia</guimenu
-><guimenuitem
->Konfiguracja &kturtle;...</guimenuitem
-> </menuchoice
->.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Otwórz przykład</guimenuitem> </menuchoice></term>
+      <listitem><para>Pokazuje katalog z przykładami programów w &logo;. Przykłady będą w ulubionym języku użytkownika wybranym w menu <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja &kturtle;...</guimenuitem> </menuchoice>.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-save">
-<title
->Zapisz</title>
+<title>Zapisz</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->S</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Zapisz</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Zapisuje aktualnie otworzony plik &logo;.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Zapisz</guimenuitem> </menuchoice></term>
+      <listitem><para>Zapisuje aktualnie otworzony plik &logo;.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-save-as">
-<title
->Zapisz jako</title>
+<title>Zapisz jako</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Plik</guimenu
-> <guimenuitem
->Zapisz jako...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Zapisuje aktualnie otwarty plik &logo; w wybranej lokalizacji.</para
-></listitem>
+      <term><menuchoice><guimenu>Plik</guimenu> <guimenuitem>Zapisz jako...</guimenuitem> </menuchoice></term>
+      <listitem><para>Zapisuje aktualnie otwarty plik &logo; w wybranej lokalizacji.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-save-canvas">
-<title
->Zapisz płótno</title>
+<title>Zapisz płótno</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Plik</guimenu
-> <guimenuitem
->Zapisz płótno</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Zapisuje aktualny rysunek na płótnie jako obrazek.</para
-></listitem>
+      <term><menuchoice><guimenu>Plik</guimenu> <guimenuitem>Zapisz płótno</guimenuitem> </menuchoice></term>
+      <listitem><para>Zapisuje aktualny rysunek na płótnie jako obrazek.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-speed">
-<title
->Prędkość wykonania</title>
+<title>Prędkość wykonania</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Plik</guimenu
-> <guimenuitem
->Prędkość wykonania</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Lista możliwych prędkości wykonania, składa się z: Pełnej prędkości, Wolnej, Wolniejszej i Najwolniejszej. Gdy prędkość wykonania ustawiona jest na Pełną prędkość (domyślnie) z trudnością można zauważyć co dzieje się na ekranie. Czasami jest to pożądane a czasami chcemy zatrzymać ślad wykonania. W tym wypadku należy ustawić prędkość wykonania na Wolną, Wolniejszą bądź Najwolniejszą. Gdy wybrana jest któraś z tych prędkości aktualnie wykonywana pozycja będzie wskazywana w edytorze.</para
-></listitem>
+      <term><menuchoice><guimenu>Plik</guimenu> <guimenuitem>Prędkość wykonania</guimenuitem> </menuchoice></term>
+      <listitem><para>Lista możliwych prędkości wykonania, składa się z: Pełnej prędkości, Wolnej, Wolniejszej i Najwolniejszej. Gdy prędkość wykonania ustawiona jest na Pełną prędkość (domyślnie) z trudnością można zauważyć co dzieje się na ekranie. Czasami jest to pożądane a czasami chcemy zatrzymać ślad wykonania. W tym wypadku należy ustawić prędkość wykonania na Wolną, Wolniejszą bądź Najwolniejszą. Gdy wybrana jest któraś z tych prędkości aktualnie wykonywana pozycja będzie wskazywana w edytorze.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-execute">
-<title
->Wykonaj</title>
+<title>Wykonaj</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Alt;<keysym
->Powrót</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Wykonaj komendy</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Rozpoczyna wykonanie komend w edytorze kodu.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Alt;<keysym>Powrót</keysym></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Wykonaj komendy</guimenuitem> </menuchoice></term>
+      <listitem><para>Rozpoczyna wykonanie komend w edytorze kodu.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-pause">
-<title
->Pauza</title>
+<title>Pauza</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
-><keysym
->Pauza</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Zatrzymanie wykonania</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Zatrzymuje wykonanie programu. Akcja dostępna jedynie podczas wykonywania komend.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo><keysym>Pauza</keysym></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Zatrzymanie wykonania</guimenuitem> </menuchoice></term>
+      <listitem><para>Zatrzymuje wykonanie programu. Akcja dostępna jedynie podczas wykonywania komend.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-stop">
-<title
->Stop</title>
+<title>Stop</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
-><keysym
->Wyjście</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Przerwanie wykonywania</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Przerywa wykonywanie. Akcja dostępna jedynie podczas wykonywania komend.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo><keysym>Wyjście</keysym></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Przerwanie wykonywania</guimenuitem> </menuchoice></term>
+      <listitem><para>Przerywa wykonywanie. Akcja dostępna jedynie podczas wykonywania komend.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-print">
-<title
->Drukuj</title>
+<title>Drukuj</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->P</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Drukuj...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Drukuje aktualny kod w edytorze bądź aktualny rysunek znajdujący się na płótnie.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Drukuj...</guimenuitem> </menuchoice></term>
+      <listitem><para>Drukuje aktualny kod w edytorze bądź aktualny rysunek znajdujący się na płótnie.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 <sect3 id="file-quit">
-<title
->Wyjście</title>
+<title>Wyjście</title>
   <variablelist>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->Q</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Plik</guimenu
-> <guimenuitem
->Wyjście</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Wychodzi z &kturtle;.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Plik</guimenu> <guimenuitem>Wyjście</guimenuitem> </menuchoice></term>
+      <listitem><para>Wychodzi z &kturtle;.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect3>
 </sect2>
 
 <sect2 id="the-edit-menu">
-  <title
->Menu <guimenu
->Edycja</guimenu
-></title>
+  <title>Menu <guimenu>Edycja</guimenu></title>
   <variablelist>
     <anchor id="edit-undo"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->Z</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Cofnij</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Anuluje ostatnią zmianę w kodzie. &kturtle; posiada nieskończona liczbę kroków cofania.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>Z</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Cofnij</guimenuitem> </menuchoice></term>
+      <listitem><para>Anuluje ostatnią zmianę w kodzie. &kturtle; posiada nieskończona liczbę kroków cofania.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-redo"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;&Shift;<keycap
->Z</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Powtórz</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Powtarza ostatnio wprowadzoną zmianę w kodzie</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;&Shift;<keycap>Z</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Powtórz</guimenuitem> </menuchoice></term>
+      <listitem><para>Powtarza ostatnio wprowadzoną zmianę w kodzie</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-cut"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->X</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Wytnij</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Wycina zaznaczony w edytorze tekst do schowka.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>X</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Wytnij</guimenuitem> </menuchoice></term>
+      <listitem><para>Wycina zaznaczony w edytorze tekst do schowka.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-copy"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->C</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Kopiuj</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Kopiuje zaznaczony w edytorze tekst do schowka.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Kopiuj</guimenuitem> </menuchoice></term>
+      <listitem><para>Kopiuje zaznaczony w edytorze tekst do schowka.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-paste"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->V</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Wklej</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Wkleja tekst ze schowka do edytora.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>V</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Wklej</guimenuitem> </menuchoice></term>
+      <listitem><para>Wkleja tekst ze schowka do edytora.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-find"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->F</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Znajdź...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Znajduje z kodzie wskazaną frazę.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>F</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Znajdź...</guimenuitem> </menuchoice></term>
+      <listitem><para>Znajduje z kodzie wskazaną frazę.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-find-next"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
-><keysym
->F3</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Znajdź następny</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Znajduje kolejne pojawienie się wybranej fazy.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo><keysym>F3</keysym></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Znajdź następny</guimenuitem> </menuchoice></term>
+      <listitem><para>Znajduje kolejne pojawienie się wybranej fazy.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="edit-replace"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->R</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Edycja</guimenu
-> <guimenuitem
->Zamień...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Zamienia frazy  w kodzie.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>R</keycap></keycombo> </shortcut> <guimenu>Edycja</guimenu> <guimenuitem>Zamień...</guimenuitem> </menuchoice></term>
+      <listitem><para>Zamienia frazy  w kodzie.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="the-view-menu">
-  <title
->Menu <guimenu
->Widok</guimenu
-></title>
+  <title>Menu <guimenu>Widok</guimenu></title>
   <variablelist>
     <anchor id="view-fullscreen"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;&Shift;<keycap
->F</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Widok</guimenu
-> <guimenuitem
->Tryb pełnego ekranu</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Włączenie trybu pełnego ekranu.</para>
-                <para
->Uwaga: Gdy kod jest wykonywany w trybie pełnego ekranu wszystko poza płótnem jest zakryte. Daje to możliwość pisania programów w &kturtle; działających w <quote
->trybie pełnoekranowym</quote
->.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;&Shift;<keycap>F</keycap></keycombo> </shortcut> <guimenu>Widok</guimenu> <guimenuitem>Tryb pełnego ekranu</guimenuitem> </menuchoice></term>
+      <listitem><para>Włączenie trybu pełnego ekranu.</para>
+                <para>Uwaga: Gdy kod jest wykonywany w trybie pełnego ekranu wszystko poza płótnem jest zakryte. Daje to możliwość pisania programów w &kturtle; działających w <quote>trybie pełnoekranowym</quote>.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="view-linenumbers"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
-><keysym
->F11</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Widok</guimenu
-> <guimenuitem
->Pokaż numery linii</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Opcja ta pokazuje numer linii w edytorze kodu. Może być użyteczne przy znajdowaniu błędów.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo><keysym>F11</keysym></keycombo> </shortcut> <guimenu>Widok</guimenu> <guimenuitem>Pokaż numery linii</guimenuitem> </menuchoice></term>
+      <listitem><para>Opcja ta pokazuje numer linii w edytorze kodu. Może być użyteczne przy znajdowaniu błędów.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="the-tools-menu">
-  <title
->Menu <guimenu
->Narzędzia</guimenu
-></title>
+  <title>Menu <guimenu>Narzędzia</guimenu></title>
   <variablelist>
     <anchor id="tools-color-picker"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Alt;<keycap
->C</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Narzędzia</guimenu
-> <guimenuitem
->Wybór koloru</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Otwiera okno wyboru koloru. Przy jego użyciu z łatwością można wybrać <glossterm linkend="rgb"
->kod koloru</glossterm
-> i wstawić go do <link linkend="the-code-editor"
->edytora kodu</link
->.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Alt;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Narzędzia</guimenu> <guimenuitem>Wybór koloru</guimenuitem> </menuchoice></term>
+      <listitem><para>Otwiera okno wyboru koloru. Przy jego użyciu z łatwością można wybrać <glossterm linkend="rgb">kod koloru</glossterm> i wstawić go do <link linkend="the-code-editor">edytora kodu</link>.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="tools-indent"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->I</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Narzędzia</guimenu
-> <guimenuitem
->Wcięcie</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Dodaje <quote
->wcięcie</quote
-> (spację) na początku wybranych linii. Właściwe użycie <quote
->wcięć</quote
-> znacznie poprawia czytelność kodu. Wszystkie przykłady korzystają ze wcięć.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>I</keycap></keycombo> </shortcut> <guimenu>Narzędzia</guimenu> <guimenuitem>Wcięcie</guimenuitem> </menuchoice></term>
+      <listitem><para>Dodaje <quote>wcięcie</quote> (spację) na początku wybranych linii. Właściwe użycie <quote>wcięć</quote> znacznie poprawia czytelność kodu. Wszystkie przykłady korzystają ze wcięć.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="tools-unindent"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;&Shift;<keycap
->I</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Narzędzia</guimenu
-> <guimenuitem
->Bez wcięć</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Usuwa wszystkie <quote
->wcięcia</quote
-> z wybranych linii.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;&Shift;<keycap>I</keycap></keycombo> </shortcut> <guimenu>Narzędzia</guimenu> <guimenuitem>Bez wcięć</guimenuitem> </menuchoice></term>
+      <listitem><para>Usuwa wszystkie <quote>wcięcia</quote> z wybranych linii.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="tools-clean-indent"/>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Narzędzia</guimenu
-> <guimenuitem
->Wyczyść wcięcia</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Czyści wszystkie <quote
->wcięcia</quote
-> na początku wybranych linii.</para
-></listitem>
+      <term><menuchoice><guimenu>Narzędzia</guimenu> <guimenuitem>Wyczyść wcięcia</guimenuitem> </menuchoice></term>
+      <listitem><para>Czyści wszystkie <quote>wcięcia</quote> na początku wybranych linii.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="tools-comment"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;<keycap
->D</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Narzędzia</guimenu
-> <guimenuitem
->Komentarz</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Dodaje znak komentarza (#) w wybranych liniach. Linie rozpoczynające się od znaku komentarza są ignorowane przy wykonywaniu kodu. Komentarz pozwala twórcy kodu na jego wytłumaczenie, bądź chwilowe wyłączenie pewnych linii w wykonywania.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;<keycap>D</keycap></keycombo> </shortcut> <guimenu>Narzędzia</guimenu> <guimenuitem>Komentarz</guimenuitem> </menuchoice></term>
+      <listitem><para>Dodaje znak komentarza (#) w wybranych liniach. Linie rozpoczynające się od znaku komentarza są ignorowane przy wykonywaniu kodu. Komentarz pozwala twórcy kodu na jego wytłumaczenie, bądź chwilowe wyłączenie pewnych linii w wykonywania.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="tools-uncomment"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Ctrl;&Shift;<keycap
->D</keycap
-></keycombo
-> </shortcut
-> <guimenu
->Narzędzia</guimenu
-> <guimenuitem
->Usuń komentarz</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Usuwa znaki komentarza z wybranych linii.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Ctrl;&Shift;<keycap>D</keycap></keycombo> </shortcut> <guimenu>Narzędzia</guimenu> <guimenuitem>Usuń komentarz</guimenuitem> </menuchoice></term>
+      <listitem><para>Usuwa znaki komentarza z wybranych linii.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
 
 <sect2 id="the-setting-menu">
-  <title
->Menu <guimenu
->Ustawienia</guimenu
-></title>
+  <title>Menu <guimenu>Ustawienia</guimenu></title>
     <variablelist>
     <anchor id="toggle-toolbar"/>
     <varlistentry>
-<term
-><menuchoice
-><guimenu
->Ustawienia</guimenu
-> <guimenuitem
->Pasek narzędzi pokaż/ukryj</guimenuitem
-> </menuchoice
-></term>
-<listitem
-><para
-><action
->Włączenie</action
-> głównego paska narzędzi</para
-></listitem>
+<term><menuchoice><guimenu>Ustawienia</guimenu> <guimenuitem>Pasek narzędzi pokaż/ukryj</guimenuitem> </menuchoice></term>
+<listitem><para><action>Włączenie</action> głównego paska narzędzi</para></listitem>
 </varlistentry>
-  </variablelist
->  
+  </variablelist>  
   <variablelist>
       <anchor id="toggle-statusbar"/>
    <varlistentry>
-<term
-><menuchoice
-><guimenu
->Ustawienia</guimenu
-> <guimenuitem
->Pokaż/ukryj pasek statusu</guimenuitem
-> </menuchoice
-></term>
-<listitem
-><para
-><action
->Włączenie/wyłączenie</action
-> paska statusu</para
-></listitem>
+<term><menuchoice><guimenu>Ustawienia</guimenu> <guimenuitem>Pokaż/ukryj pasek statusu</guimenuitem> </menuchoice></term>
+<listitem><para><action>Włączenie/wyłączenie</action> paska statusu</para></listitem>
 </varlistentry>
   </variablelist>
     <variablelist>
     <anchor id="tools-advanced"/>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Ustawienia</guimenu
-> <guisubmenu
->Ustawienia zaawansowane</guisubmenu
-> </menuchoice
-></term>
-      <listitem
-><para
->Można dokonać zmian, których zazwyczaj nie dokonujemy. Podmenu <guisubmenu
->Ustawienia zaawansowane</guisubmenu
-> składa się z trzech części: <guimenuitem
->Edytor konfiguracji...</guimenuitem
-> (ustawienia standardowego edytora  &kate;), <guimenuitem
->Skróty konfiguracji...</guimenuitem
-> (standardowe ustawienia skrótów &kde;), i <guimenuitem
->Paski narzędzi konfiguracji...</guimenuitem
-> (standardowe ustawienia pasków narzędzi &kde;).</para
-></listitem>
+      <term><menuchoice><guimenu>Ustawienia</guimenu> <guisubmenu>Ustawienia zaawansowane</guisubmenu> </menuchoice></term>
+      <listitem><para>Można dokonać zmian, których zazwyczaj nie dokonujemy. Podmenu <guisubmenu>Ustawienia zaawansowane</guisubmenu> składa się z trzech części: <guimenuitem>Edytor konfiguracji...</guimenuitem> (ustawienia standardowego edytora  &kate;), <guimenuitem>Skróty konfiguracji...</guimenuitem> (standardowe ustawienia skrótów &kde;), i <guimenuitem>Paski narzędzi konfiguracji...</guimenuitem> (standardowe ustawienia pasków narzędzi &kde;).</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="settings-configure"/>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Ustawienia</guimenu
-> <guimenuitem
->Konfiguracja &kturtle;...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Konfiguracja &kturtle;. Tutaj można zmienić język komend &logo; bądź ustawić nowy domyślny rozmiar płótna.</para
-></listitem>
+      <term><menuchoice><guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja &kturtle;...</guimenuitem> </menuchoice></term>
+      <listitem><para>Konfiguracja &kturtle;. Tutaj można zmienić język komend &logo; bądź ustawić nowy domyślny rozmiar płótna.</para></listitem>
     </varlistentry>
   </variablelist>
 
 </sect2>
 
 <sect2 id="the-help-menu">
-  <title
->Menu <guimenu
->Pomoc</guimenu
-></title>
+  <title>Menu <guimenu>Pomoc</guimenu></title>
   <variablelist>
     <anchor id="help-handbook"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
-><keysym
->F1</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Pomoc</guimenu
-> <guimenuitem
->Podręcznik &kturtle;</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Pokazuje gotowy do użycia podręcznik.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo><keysym>F1</keysym></keycombo> </shortcut> <guimenu>Pomoc</guimenu> <guimenuitem>Podręcznik &kturtle;</guimenuitem> </menuchoice></term>
+      <listitem><para>Pokazuje gotowy do użycia podręcznik.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="help-whats-this"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
->&Shift;<keysym
->F1</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Pomoc</guimenu
-> <guimenuitem
->Co to takiego?</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Po aktywacji tej opcji wskaźnik myszki zostanie zamieniony w <quote
->znak zapytania</quote
->. Gdy wtedy klikniemy na część okna głównego &kturtle; wyskoczy opis części na której kliknęliśmy.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo>&Shift;<keysym>F1</keysym></keycombo> </shortcut> <guimenu>Pomoc</guimenu> <guimenuitem>Co to takiego?</guimenuitem> </menuchoice></term>
+      <listitem><para>Po aktywacji tej opcji wskaźnik myszki zostanie zamieniony w <quote>znak zapytania</quote>. Gdy wtedy klikniemy na część okna głównego &kturtle; wyskoczy opis części na której kliknęliśmy.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="help-context-help"/>
     <varlistentry>
-      <term
-><menuchoice
-><shortcut
-> <keycombo
-><keysym
->F2</keysym
-></keycombo
-> </shortcut
-> <guimenu
->Pomoc</guimenu
-> <guimenuitem
->Pomoc na temat: ...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Bardzo użyteczna funkcja: wyświetla pomoc do części kodu na której klikniemy. Np. w kodzie została użyta komenda <userinput
->pisz</userinput
->, i chcemy się dowiedzieć co na temat tej komendy mówi podręcznik. Należy ustawić kursor na komendzie<userinput
->pisz</userinput
-> i wcisnąć przycisk <keysym
->F2</keysym
->. Zostanie wtedy wyświetlona informacji z podręcznika na temat komendy <userinput
->pisz</userinput
->.</para>
-      <para
->Funkcja jest bardzo użyteczna przy nauce programowania.</para
-></listitem>
+      <term><menuchoice><shortcut> <keycombo><keysym>F2</keysym></keycombo> </shortcut> <guimenu>Pomoc</guimenu> <guimenuitem>Pomoc na temat: ...</guimenuitem> </menuchoice></term>
+      <listitem><para>Bardzo użyteczna funkcja: wyświetla pomoc do części kodu na której klikniemy. Np. w kodzie została użyta komenda <userinput>pisz</userinput>, i chcemy się dowiedzieć co na temat tej komendy mówi podręcznik. Należy ustawić kursor na komendzie<userinput>pisz</userinput> i wcisnąć przycisk <keysym>F2</keysym>. Zostanie wtedy wyświetlona informacji z podręcznika na temat komendy <userinput>pisz</userinput>.</para>
+      <para>Funkcja jest bardzo użyteczna przy nauce programowania.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="help-report-bug"/>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Pomoc</guimenu
-> <guimenuitem
->Raport błędów...</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Wysłanie do twórców &kturtle; raportu na temat błędów. Raporty przyczyniają się do poprawienia kolejnej wersji &kturtle;.</para
-></listitem>
+      <term><menuchoice><guimenu>Pomoc</guimenu> <guimenuitem>Raport błędów...</guimenuitem> </menuchoice></term>
+      <listitem><para>Wysłanie do twórców &kturtle; raportu na temat błędów. Raporty przyczyniają się do poprawienia kolejnej wersji &kturtle;.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="help-about-kturtle"/>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Pomoc</guimenu
-> <guimenuitem
->O &kturtle;</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Tutaj znajdują się podstawowe informacje na temat &kturtle;, takie jak autorzy i licencja.</para
-></listitem>
+      <term><menuchoice><guimenu>Pomoc</guimenu> <guimenuitem>O &kturtle;</guimenuitem> </menuchoice></term>
+      <listitem><para>Tutaj znajdują się podstawowe informacje na temat &kturtle;, takie jak autorzy i licencja.</para></listitem>
     </varlistentry>
   </variablelist>
   <variablelist>
     <anchor id="help-about-kde"/>
     <varlistentry>
-      <term
-><menuchoice
-><guimenu
->Pomoc</guimenu
-> <guimenuitem
->O &kde;</guimenuitem
-> </menuchoice
-></term>
-      <listitem
-><para
->Znajdują się tu podstawowe informacje na temat &kde;. Jeżeli nie znamy jeszcze &kde; na pewno warto tutaj zajrzeć.</para
-></listitem>
+      <term><menuchoice><guimenu>Pomoc</guimenu> <guimenuitem>O &kde;</guimenuitem> </menuchoice></term>
+      <listitem><para>Znajdują się tu podstawowe informacje na temat &kde;. Jeżeli nie znamy jeszcze &kde; na pewno warto tutaj zajrzeć.</para></listitem>
     </varlistentry>
   </variablelist>
 </sect2>
@@ -1087,31 +367,14 @@
 </sect1>
 
 <sect1 id="the-toolbar">
-<title
->Pasek narzędzi</title>
-<para
->Bardzo łatwo można dotrzeć do najczęściej używanych akcji. Domyślnie znajdują się tutaj wszystkie najczęściej używane komendy kończące się ikonami  <guiicon
->Wykonaj rozkaz</guiicon
-> i <guiicon
->Zatrzymaj wykonywanie</guiicon
->.</para>
-<para
->Pasek narzędzi można skonfigurować przy użyciu menu <menuchoice
-><guimenu
->Ustawienia</guimenu
-><guimenuitem
->Ustawienia zaawansowane</guimenuitem
-><guimenuitem
->Konfiguracja paska narzędzi...</guimenuitem
-></menuchoice
-></para>
+<title>Pasek narzędzi</title>
+<para>Bardzo łatwo można dotrzeć do najczęściej używanych akcji. Domyślnie znajdują się tutaj wszystkie najczęściej używane komendy kończące się ikonami  <guiicon>Wykonaj rozkaz</guiicon> i <guiicon>Zatrzymaj wykonywanie</guiicon>.</para>
+<para>Pasek narzędzi można skonfigurować przy użyciu menu <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Ustawienia zaawansowane</guimenuitem><guimenuitem>Konfiguracja paska narzędzi...</guimenuitem></menuchoice></para>
 </sect1>
 
 <sect1 id="the-statusbar">
-<title
->Pasek statusu</title>
-<para
->W pasku statusu można znaleźć pomoc dotyczącą działania &kturtle;. Po lewej stronie pokazany jest opis ostatniej czynności. Po prawej stronie można znaleźć obecną lokalizację kursora (numer linii i kolumny). W środku paska statusu pokazany jest obecny język komend.</para>
+<title>Pasek statusu</title>
+<para>W pasku statusu można znaleźć pomoc dotyczącą działania &kturtle;. Po lewej stronie pokazany jest opis ostatniej czynności. Po prawej stronie można znaleźć obecną lokalizację kursora (numer linii i kolumny). W środku paska statusu pokazany jest obecny język komend.</para>
 </sect1>
 
 </chapter>