.\" Copyright (c) 2002 Andrzej Krzysztofowicz
.\"
.TH QPL 7 "28 lutego 2002" "ConvPL"
.SH NAZWA
qpl \- rozpoznawanie standardów polskich znaków v2.03
.SH SKLADNIA
.B qpl
.RB [ - ]
.RI [ plik1.txt ]
.RI [ plik2.txt " ...]"
.RB [ -v | -b ]

.SH OPIS
Argumentami polecenia są nazwy plików, których standard kodowania ma
być rozpoznany. Ograniczeniem dla ilości nazw jest długość linii
poleceń i wielkość pamięci. Po nazwach plików mogą następować trzy
opcjonalne argumenty:
.TP
.B -v
wyświetlenie tabeli zgodności znaków, na podstawie której wyznaczany jest
standard badanego tekstu
.TP
.B -b
podanie wyniku analizy w postaci parametru dla programu
.I ConvPL
\- cyfry lub litery; opcji tej można uzyć do automatycznego konwertowania
plików o nieznanym standardzie, podstawiajac uzyskany znak do linii poleceń
.B cpl
jako standard źródłowy; patrz dokumentacja
.IR ConvPL ;
opcja
.B -b
automatycznie wyłącza opcję
.BR -v ;
opcje
.BR -b " i " -v
są automatycznie wyłączane, gdy badany ma być więcej niż jeden plik.
.PP
Podanie "-" zamiast nazwy pliku powoduje pracę w trybie filtru \- dane będą
pobierane ze standardowego wejścia.

.SH ALGORYTM
Zasada działania jest następująca: zliczane są wszystkie wystąpienia
wszystkich polskich znaków narodowych. Ponieważ znaki powtarzają się
w różnych standardach, każde znak jest zliczany oddzielnie dla każdego
ze standardów. Obecne w tekście znaki o funkcji innej niż polskie litery
(np. ramki), ale wchodzące w skład któregoś ze standardów mogą spowodować
zafałszowanie wyników zwykłego zliczania. Dla uniknięcia takich zmian
liczba wystąpień każdego znaku jest mnożona przez przypisany znakowi
współczynnik, odzwiercielający częstość jego występowania w przeciętnym
polskim tekście. Następnie wystąpienia wszystkich znaków są sumowane
w obrębie standardów. Wygrywa standard o największym wyniku \- czyli
najbardziej przypominający ten obecny w tekście.
.PP
Tabelę zliczeń znaków wyświetla opcja
.BR -v .
W ostatniej kolumnie znajduje
się suma każdego wiersza. Pozwala to na samodzielne ocenienie wyników
zliczania w szczególnie problematycznych przypadkach.

.SH UWAGI
.TP 3
1)
Winietka programu i wszystkie informacje są wyświetlane na stderr,
dzięki czemu są "niewidzialne" przy zrzucaniu wyjścia do pliku,
filtrowaniu itp. Tabela zgodności
.RB ( -v )
i wynik \- parametr dla
.I ConvPL
.RB ( -b )
są natomiast wyświetlane na stdout (nigdy razem, bo jedno wyklucza drugie).
.TP 3
2)
.B qpl
jest rozprowadzany razem z konwerterem
.IR ConvPL .
Autor zdecydował się na rozprowadzanie go w postaci odrębnego programu
z powodów praktycznych. Jako taki, może on mieć większe możliwości, więcej
zastosowań i bogatszą linię poleceń. Współpracę między obydwoma programami
\- w celu np. automatyzacji konwersji można bardzo łatwo zapewnić sobie za
pomocą skryptów (Unix) lub baczów (MSDOS/4DOS).
.TP 3
3)
Rozróżnienie standardów DHN i Logic oraz FX i KWK jest trudne, bo składają
się one z tych samych znaków w innej kolejności. QPL zazwyczaj trafnie
rozpoznaje różnicę w przypadku przeciętnej długości tekstów, jednak w wyniku
podaje na wszelki wypadek obie możliwości.
.TP 3
4)
Opcje
.BR -b " i " -v
są wyłączane, jeśli w linii poleceń występuje więcej niż jeden plik.
Ponadto opcje
.BR -b " i " -v
wykluczają się nawzajem
.TP 3
5)
Autor nie kształci się na kierunku mającym cokolwiek wspólnego z informatyką,
a oba algorytmy sam sobie wykombinował. W związku z tym przyjmuje każdy
zarzut o nieefektywność, brak oryginalności, poziom przedszkola itp. byle
na odpowiednim poziomie merytorycznym. ;)

.SH "ZOBACZ TAKŻE"
.BR cpl (7)

.SH AUTOR
.B Paweł Krawczyk
\- wlaściciel praw autorskich programu
.B qpl
.br
.I <kravietz@pipeta.chemia.pk.edu.pl>
