potool jest programem wspomagającym edycję plików po
Copyright (C) 1999-2003 Zbigniew Chyla

Licencja znajduje się w pliku LICENSE

Pakiety potrzebne do kompilacji programu:
	gcc, bison, flex, glib 2.x w wersji -devel

Wywołanie programu:

	potool FILENAME1 [FILENAME2] [-h] [-f f|nf|t|nt] [-s]
	       [-n id|str|cmt|ucmt|pcmt|scmt|dcmt|tr|linf]...

Program pracuje w jednym z dwóch (na razie) trybów. W pierwszym wymaga
podania jednej nazwy pliku i działa wówczas jak filtr. W drugim - powoduje
_zastąpienie_ tłumaczeń w pliku FILENAME1 tłumaczeniami z pliku FILENAME2
(zatem pierwszy plik jest plikiem bazowym, zaś drugi - naszym roboczym).

Opcja -f opisuje filtr, który określa, jakie wpisy w pliku .po powinny być
uwzględniane (jest to filtr działający przy odczycie pliku). W drugim
trybie pracy filtr uwzględniany jest tylko dla drugiego pliku (roboczego).

Istniejące filtry:
	t  - wpisy przetłumaczone,
	nt - wpisy nie przetłumaczone,
	f  - wpisy 'fuzzy',
	nf - wpisy bez oznaczenia fuzzy,
	o  - wpisy nieużywane (oznaczone przedrostkiem "#~ ")
	no - wpisy używane

Filtry można na siebie nakładać, np:

	potool gnumeric.po -fnt -nf

wyświetli wpisy z pliku 'gnumeric.po', które nie zostały przetłumaczone i
nie mają oznaczenia 'fuzzy'.

Opcja -n działa w obu trybach pracy tak samo i określa, jakie informacje w
każdym z wpisów _nie_ powinny być wyświetlane przy wypisywaniu ich przez
program. Dozwolona jest dowolna liczba opcji -n.

Dopuszczalne parametry:
	id   - nie wypisuj części 'id'
	str  - nie wypisuj części 'str'
	tr   - nie wypisuj tłumaczeń (lecz pustą część 'str')
	ucmt - nie wypisuj komentarzy użytkownika
	pcmt - nie wypisuj komentarzy określających położenie w plikach
	scmt - nie wypisuj komentarzy specjalnych ('#, fuzzy, c-format, ...')
	dcmt - nie wyświetlaj komentarzy zarezerwowanych (głównie
               rozpoczynających się kropką - '#. ...'
	cmt  - nie wyświetlaj żadnych komentarzy (połączenie ucmt, pcmt,
               scmt, dcmt)
	linf - usuwaj informację o numerach linii w komentarzach
               określających położenie w plikach (numery linii zamieniane są
               na '1')

Dodatkowe opcje:
    -s powoduje wypisanie tylko liczby wpisów zamiast ich treści
    -c kopiuje we wszystkich wpisach część 'id' do 'str'
       (być może zastępując tłumaczenie)

Przykłady użycia:

	potool x.po -ftr
	- wyświetla liczbę przetłumaczonych wpisów

	potool x.po -nstr
	- oczyszcza plik z tłumaczeń - a więc możemy zaczynać od zera ;)

	(potool x.po -ftr && potool x.po -fntr)
	- wyświetla z pliku najpierw wpisy przetłumaczone, a następnie nie
	  posiadające tłumaczenia (ze względu na pierwszy wpis nie zaleca
	  się stosowania odwrotnej kolejności).
	  Plik taki zawiera wszystkie informacje z x.po, natomiast braki w
	  tłumaczeniach są skupione w jednym miejscu

	potool x.po -fntr > tmp.po
	joe tmp.po
	potool x.po tmp.po
	- pozwala na proste dodawanie nowych tłumaczeń, bez przeglądania
	  starych.
