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)