Provided by: potool_0.19-1_amd64
NAZWA
potool - program do manipulowania plikami po gettext
SKŁADNIA
potool PLIK1 [ PLIK2 ] [-f f|nf|t|nt|nth|o|no] [-n ctxt|id|str|cmt|ucmt|pcmt|scmt|dcmt|tr|linf]... [-s] [-p] [-c] potool -h
OPIS
potool 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 PLIK1 tłumaczeniami z pliku PLIK2 (zatem pierwszy plik jest plikiem bazowym, zaś drugi - naszym roboczym).
OPCJE
-f filtr opisuje filtr, który określa, jakie wpisy w pliku .po powinny być zachowane (jest to filtr działający przy odczycie pliku). W drugim trybie pracy filtr uwzględniany jest tylko dla pliku PLIK2 (roboczego). Istniejące filtry: t - wpisy przetłumaczone, nt - wpisy nie przetłumaczone, nth - wpisy nie przetłumaczone i nagłówek, 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ć, używając kilku opcji -f. -n filtr 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: ctxt - nie wypisuj części 'ctxt' 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. Ostatni parametr powoduje zamianę numerów linii na '1'. Jest to przydatne w przypadku porównywania dwóch plików po lub pot przy pomocy diff(1), gdyż w zazwyczaj jego wyjście jest zaciemnione wieloma informacjami o mało interesujących zmianach numerów linii. -s powoduje wypisanie tylko liczby wpisów zamiast ich treści -p powoduje zachowanie oryginalnego formatowania. Bez tej opcji program zawija na znakach końca linii lub między wyrazami wszystkie linie na wyjściu tak aby zmieściły się w 80 kolumnach. -c kopiuje we wszystkich wpisach część 'id' do 'str' (być może zastępując tłumaczenie) -h wyświetla krótką informację na temat użycia.
PRZYKŁADY
potool x.po -s -ft wyświetla liczbę przetłumaczonych wpisów. Patrz także postats(1). potool x.po -nstr oczyszcza plik z tłumaczeń - a więc możemy zaczynać od zera ;) potool x.po -ft && potool x.po -fnt 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 -fnt > tmp.po && editor tmp.po && potool x.po tmp.po pozwala na proste dodawanie nowych tłumaczeń, bez przeglądania starych. Ostatnie dwa przykłady są zaimplementowane jako program potooledit(1).
PRZESTROGI
Domyślnie ten program zawija po swojemu wszystkie linie na wyjściu. Patrz też opcja -p
ZOBACZ TAKŻE
potooledit(1), postats(1), msgmerge(1), msgfmt(1).
AUTOR
Potool został napisany przez Zbigniewa Chylę, a obecnie jego opiekunem jest Marcin Owsiany <porridge@debian.org>. 21 września 2007 POTOOL(1)