diff --git a/pages.pl/common/tldr.md b/pages.pl/common/tldr.md
index d85b2f43c..b8a1e932c 100644
--- a/pages.pl/common/tldr.md
+++ b/pages.pl/common/tldr.md
@@ -1,17 +1,29 @@
 # tldr
 
-> Klient wiersza polecenia dla stron tldr.
-> Wyświetla uproszczone i obsługiwane przez społeczność strony podręcznika man.
-> Więcej informacji: <https://tldr.sh>.
+> Wyświetl proste strony pomocy dla narzędzi wiersza poleceń z projektu tldr-pages.
+> Uwaga: opcje `--language` i `--list` nie są wymagane przez specyfikację, ale większość klientów je implementuje.
+> Więcej informacji: <https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md#command-line-interface>.
 
-- Uzyskaj typowe zastosowania polecenia (wskazówka: oto jak się tu dostałeś!):
+- Wyświetl stronę tldr dla podanej komendy (wskazówka: w ten sposób tu trafiłeś/aś!):
 
-`tldr {{polecenie}}`
+`tldr {{komenda}}`
 
-- Pokaż tar tldr page dla Linux:
+- Wyświetl stronę tldr dla podanej podkomendy:
 
-`tldr -p {{linux}} {{tar}}`
+`tldr {{komenda}} {{podkomenda}}`
 
-- Uzyskaj pomoc dotyczącą komendy Git:
+- Wyświetl stronę tldr dla komendy w podanym języku (jeżeli jest dostępna, w przeciwnym razie po angielsku):
 
-`tldr {{git-checkout}}`
+`tldr --language {{kod_języka}} {{komenda}}`
+
+- Wyświetl stronę tldr dla komendy z podanej platformy:
+
+`tldr --platform {{android|common|freebsd|linux|osx|netbsd|openbsd|sunos|windows}} {{komenda}}`
+
+- Zaktualizuj lokalną pamięć podręczną stron tldr:
+
+`tldr --update`
+
+- Wyświetl listę stron tldr dla aktualnej platformy i `common`:
+
+`tldr --list`