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)