@DATABASE PCC.guide

@(C) "Copyright 1995 Rafaī Mantiuk"

@$VER: PCC.guide 1.0 (8.5.95)

@NODE Main "PCC"

    @{b}NAZWA@{ub}
	PCC - Konwerter zbiorów tekstowych.             ( v2.0   7-5-95 )

    @{b}WZÓR@{ub}
	FROM/A,TO/A,ALL/S,DESTPCS,SOURCEPCS,RELOAD/S,PF=PCSFILE/K,
	OA=ONLYASCII/S,NOCOM/S,NOREQ/S,QUIET/S,PACK/S,UNPACK/S,
	METHOD/K,PASSWORD/K,@{"STRIPCR/S" link StripCR},@{"CHAR=STRIPCHAR/K/N" link StripChar},
	@{"REM=STRIPREM/K" link StripREM},@{"SELINES/S" link SElines},@{"OPT/S" link Opt},@{"LONGLINES/S" link Opt},@{"UNFORMAT/S" link Unformat},
	@{"SLMARGIN/S" link SLMargin}:

    @{b}WYMAGANIA@{ub}
	PCC v2.0 wymaga OS 2.0 lub nowszego. W przypadku OS 1.3 moūna
	wykorzystaź PCC v1.2, który wspóīpracuje z kaūdym systemem.

	PCC v2.0 wykorzystuje bibliotekė "xpkmaster.library" wraz z jej
	podbibliotekami do obsīugi zbiorów skompresowanych. Biblioteka ta
	nie jest niezbėdna do uruchomienia programu.

	W systemie muszā byź zaīoūone wolumeny ENV: oraz T:.

    @{b}OPIS@{ub}
	PCC v2.0 jest komendā CLI umoūliwiajāca zamiane kodów polskich
	znaków ( "ó", "ī", etc. ) z jednego standardu ( Mazovia, AmigaPL,
	etc. ) na drugi. Ponadto program posiada wiele innych komend, które
	zostanā opisane poniūej.

	PCC potrafi obsīuūyź kaūdy standard polskich znaków. Wszystkie
	standardy aktualnie obsīugiwane przez program zawarte sā w zbiorze
	"PolCharsSets". Zbiór ten powinieļ znajdowaź siė w katalogu S:. Przy
	pierwszym uruchomieniu zbiór ten zostanie skopiowany do katalogu
	ENV:, po czym przy nastėpnych uruchomieniach wykorzystywana bedzie
	kopia z ENV:. Dodatkowe standardy moūna dopisywaź @{"edytujāc" link EditPCS} plik
	"PolCharsSets".

	Parametr "@{b}RELOAD@{ub}" powodujė ūe zbiór ze zdefiniowanymi standardami
	zostanie odczytany z kalogu S:, jak przy pierwszym uruchomieniu.

	Parametr "@{b}PCSFILE@{ub}" powinieļ zawieraź nazwė i ōcieūkė dostėpu do
	zbioru zawierajācego definicje standardów. Umoūliwia to umieszczenie
	tego zbioru w innym katalogu niū S:.

	PCC moūe dziaīaź nie tylko na pojedyļczych zbiorach, lecz równieū na
	caīych katalogach wraz z podkatalogami.

	Parametr "@{b}FROM@{ub}" oznaczajācy zbiór śródīowy moūe zawieraź wildcards'y
	( znaki ?,#,*, etc. ). Parametr "@{b}TO@{ub}" zawierajācy zbiór docelowy
	oznacza katalog do którego majā zostaź zapisane pliki (jeūeli
	konwertujemy wiėcej niū jeden zbiór, lub na koļcu nazwy znajduje siė
	znak (/)) lub nazwė zbioru wynikowego. Jeūeli docelowy katalog nie
	istnieje zostanie on utworzony.

	Parametr "@{b}ALL@{ub}" oznacza, ūe przekonwertowane majā byź równieū zbiory
	znajdujāce siė w podkatalogach katalogu ūródīowego.

	Parametr "@{b}DESTPCS@{ub}" oznacza nazwė standardu docelowego. Jeūeli nazwa
	zawiera odstėp, parametr naleūy podaź w cudzysīowie ("). Jeūeli
	parametr ten zostanie pominiėty, zbiory nie bėdā konwertowane.
	Wykonane zostanā jedynie ewentualnie podane komendy dodatkowe.

	Parametr "@{b}SOURCEPCS@{ub}" oznacza nazwė standardu śródīowego. UWAGA:
	Musi byź on podany PO "DESTPCS". Parametr nie jest wymagany.
	Standard śródīowy zostanie samoczynnie rozpoznany. Parametr ten
	sīuūy do wymuszenia standardu jeūeli jest on śle rozpoznawany.
	UWAGA: Podanie tego parametru wyīācza rozpoznawanie standardu
	śródīowego dla wszystkich przetwarzanych zbiorów.

	Kaūdy zbiór śródīowy zostanie sprawdzony czy zawiera on tekst ASCII.
	Jeūeli istnieje podejrzenie ūe zawiera on inne dane to wyōwietlony
	zostaje requester/okno dialogowe z pytaniem, jak ma zostaź ten zbiór
	potraktowany. Parametr "@{b}ONLYASCII@{ub}" powoduje samoczynne pominiėcie
	tych zbiorów.

	Jeūeli zbiór śródīowy zawiera komentarz zbioru (file note) to
	zostanie on przekopiowany do zbioru docelowego. Parametr "@{b}NOCOM@{ub}"
	powoduje, ūe komentarze nie bėdā kopiowane.

	Parametr "@{b}NOREQ@{ub}" powoduje ūe nie bėdā wyōwietlane ūadne
	requester'y/okna dialogowe. Domyōlnie przyjmowana bėdzie odpowiedś
	pozytywna. UWAGA: requester'y/okna dialogowe wymagajā biblioteki
	"reqtools.library".

	Parametr "@{b}QUIET@{ub}" filtruje komunikaty wyprowadzane na konsole.
	Wyōwietlane bėdā tylko informacje o bīėdach.

	Dziaīanie programu moūna w kaūdej chwili przerwaź kombinacjā
	klawiszy "ctrl" + "c".

	Oprócz konwertowania tekstów pomiėdzy standardami program umoūliwia:

		-) @{"usuwanie znaku CR" link StripCR}
		-) @{"usuwanie dowolnego znaku" link StripChar}
		-) @{"optymalizacje tekstu" link Opt}
		-) @{"usuwanie komentarzy" link StripREM}
		-) @{"rozformatowywanie tekstu" link Unformat}
		-) @{"usuwanie twardych EOL" link LongLines}
		-) @{"usuwanie lewego marginesu" link SLMargin}
		-) @{"usuwanie pustych linii" link SELines}

	Zbiory poddawane procesowi konwersji mogā byź skompresowane dowolnym
	algorytmem z biblioteki "xpkmaster.library", oraz programem Power
	Packer.

	Zbiory przekonwertowane mogā byź zapisywane w postaci
	skompresowanej. Moūna wybraź dowolny algorytm z biblioteki
	"xpkmaster.library". Sīuūy do tego parametr "@{b}METHOD@{ub}".

	Program stara siė zapisywaź zbiory docelowe w takiej postaci jak
	zbiory śródīowe; jeūeli byīy skompresowane - kompresuje, w
	przeciwnym wypadku niekompresuje.

	Parametr "@{b}PACK@{ub}" powoduje ūe zbiory docelowe bėdā kompresowane, bez
	wzglėdu na to czy zbiór śródīowy jest skompresowany.

	Parametr "@{b}UNPACK@{ub}" powoduje ūe zbiory docelowe bėdā
	zapisywane  w postaci nie skompresowanej, bez wzglėdu na zbiór
	śródīowy.

	Parametr "@{b}PASSWORD@{ub}" umoūliwia nadanie hasīa zbiorom kompresowanym,
	oraz dekompresje zbiorów zakodowanych hasīem.

    @{b}PRZYKĪAD@{ub}
	PCC ram:aa/#? ram:bb "Windows EE" "AmigaPL" OPT PACK METHOD "SHRI"

	@{i}Konwersja AmigaPL -> Windows EE. Wszystkie zbiory z katalogu ram:aa
	do katalogu ram:bb (który nie musi istnieź). Zbiory docelowe zostanā
	skomresowane algorytmem "SHRI".@{ui}

	PCC ZbiórA.txt ZbiórB.txt xJP

	@{i}Przekonwertowany zostanie zbiór "ZbiórA.txt" i zapisany pod nazwā
	"ZbiórB.txt".@{ui}

	PCC ZbiórA.txt Katalog/ xJP

	@{i}Przekonwertowany zostanie zbiór "ZbiórA.txt" i zapisany pod tā samā
	nazwā do katalogu "Katalog".@{ui}

	PCC kat1/#?.txt kat2 ALL OPT LONGLINES

	@{i}Konwersja miėdzy standardami nie nastāpi. Wszystkie zbiory wraz z
	podkatalogami katalogu kat1 zostanā przetworzone i zapisane w
	katalogu kat2.@{ui}

    @{b}AUTOR@{ub}
	Wszelkie uwagi, sugestie, informacje o bīėdach proszė kierowaź do
	autora:
							Rafaī Mantiuk
							Róūowa 4/9
							70-781 Szczecin

@ENDNODE

@NODE StripCR "Usuwanie znaku CR"

    @{b}WZÓR@{ub}
	STRIPCR/S

    @{b}OPIS@{ub}
	Zbiory tekstowe stworzone na klonach PC majā zazwyczaj koniec linii
	podwójnie zasygnalizowany: znakiem LF (kod 10) oraz CR (kod 13).
	Na Amidze stosowany jest tylko znak LF.

	Dodanie do listy parametrów "STRIPCR" powoduje usuniėcie ze
	wszystkich konwertowanych zbiorów znaku CR o kodzie 13.

    @{b}PRZYKĪAD@{ub}
	PCC IBMTexts/#? AmigaTexts/ STRIPCR

	Kaūdy zbiór z katalogu IBMTexts/ zostanie zapisany bez znaków CR w
	katalogu AmigaTexts/.

@ENDNODE

@NODE StripChar "Usuwanie dowolnego znaku"

    @{b}WZÓR@{ub}
	CHAR=STRIPCHAR/K/N

    @{b}OPIS@{ub}
	Czasem zbiór tekstowy zawiera niepoūādane znaki (np. FF - 12). Moūna
	je usunāź komendā "STRIPCHAR".

    @{b}PRZYKĪAD@{ub}
	PCC PrnTexts/#? ViewTexts/ STRIPCHAR 12

	Kaūdy zbiór z katalogu PrnTexts/ zostanie zapisany bez znaków FF
	(kod 12) w katalogu ViewTexts/.

@ENDNODE

@NODE Opt "Optymalizacja tekstu"

    @{b}WZÓR@{ub}
	OPT/S

    @{b}OPIS@{ub}
	Czėsto zbiór tekstowy zawiera zbėdne i niepīywajāce na wyglād tekstu
	znaki tabulacji (kod 9) oraz odstėpu (kod 32) na koļcu wiersza.

	Komenda OPT usuwa zbėdne znaki. Zalecane jest czėste stosowanie tej
	komendy.

    @{b}PRZYKĪAD@{ub}
	PCC Texts/#? OptTexts/ OPT

	Kaūdy zbiór z katalogu Texts/ zostanie zoptymalizowany i zapisany w
	katalogu OptTexts/.

@ENDNODE

@NODE StripREM "Usuwanie komentarzy"

    @{b}WZÓR@{ub}
	REM=STRIPREM/K

    @{b}OPIS@{ub}
	Komenda okaūe siė szczególnie przydatna programistom.

	Standardowe Includes'y dostarczane przez ō.p. Commodore zawierajā
	znacznā iloōź komentarzy. Wprawdzie sā one niezbėdne przy
	studiowaniu dokumentacji do systemu, lecz nie sā one potrzebne
	kompilatorowi. I tak niepotrzebnie zabierajā znacznā iloōź pamiėci,
	jak równieū w pewnym stopniu spowalniajā proces kompilacji.

	Szczególnie jest to widoczne przy kompilatarach, które nie tworzā
	GST takich jak Maxon C++, czy asemblerach typu AsmOne.

	Komentarze moūna podzieliź na:

		a) takie które rozpoczyna odpowiednie wyraūenie, a koļczy koniec
	linii (np. "//" w C++, ";" i "*" w asemblerze )

		b) takie które rozpoczyna i koļczy odpowiednie wyraūenie (np.
	"/*...*/" w C, "{...}" w Pascal'u )

	Komenda "STRIPREM" wymaga parametrów okreōlajācych wyraūenia
	definiujāce komentarze. W przypadku komentarzy typu "a" podajemy
	tylko jedno wyraūenie rozpoczynajāce komentarz. W przypadku
	kometarzy typu "b" podajemy dwa wyraūenia odpowienio rozpoczynajāce
	i koļczoļce komentarz oddzielone kropkami (..). Iloōź kropek jest
	dowolna.

	Moūna usunāź na raz dowolnā iloōź komentarzy obydwu typów. Kolejne
	definicje komentarzy naleūy oddzielaź przeciļkiem (,). Nie moūna
	stosowaź spacji. Caīa definicja musi byź przyjėta jako jeden
	parametr CLI. W razie koniecznoōci definicje naleūy zapisaź w
	cudzysīowie (").

	Zalecane jest stosowanie tej komendy w poīāczeniu z "OPT" i
	"SELINES".

    @{b}PRZYKĪAD@{ub}
	PCC INCLUDE:#?.h NewInclude/ ALL REM "//,/**..**/" OPT SELINES

	Ze zbiorów include do C zostanā usuniėte komentarze, puste linie.
	Caīoōź zostanie zapisana w katalogu NewInclude/

	PCC INCLUDE:#?.i NewInclude/ ALL REM "**,;" OPT SELINES

	Tak jak wyūej, tylko dla asemblera.

@ENDNODE

@NODE Unformat "Rozformatowywanie tekstu"

    @{b}WZÓR@{ub}
	UNFORMAT/S

    @{b}OPIS@{ub}
	Tekst ASCII moūna wyrównaź do prawego i lewego marginesu, podobne
	jak justify w programach DTP, dodajāc odstėp pomiėdzy wyrazami.
	Komende takā posiada CED (Special/Format). Tekst poddany takiemu
	zabiegowi jest bardziej estetyczny, lecz nie moūe byź przeniesiony
	do programu DTP.

	Komenda "UNFORMAT" usuwa odstėpy dodane komendā formatujācā.

	UWAGA: Komenda ta moūe zniszczyź wszelkiego rodzaju tabele itp.
	znajdujāce siė w tekscie.

    @{b}PRZYKĪAD@{ub}
	PCC AsciiTexts/#? DTPTexts/ UNFORMAT

	Kaūdy zbiór z katalogu AsciiTexts/ zostanie rozformatowany i
	zapisany w katalogu DTPTexts/.

@ENDNODE

@NODE LongLines "Usuwanie twardych EOL"

    @{b}WZÓR@{ub}
	LONGLINES/S

    @{b}OPIS@{ub}
	Normalny tekst ASCII posiada znak koļca linii na koļcu kaūdego
	wiersza. Natomiast tekst DTP tylko na koļcu akapitu. Akapit
	automatycznie dzielony jest na wiersze.

	Komenda "LONGLINES" usuwa znaki koļca linii, pozostawiajāc je tylko
	na koļcu kaūdego akapitu, oraz przy pustych liniach. Akapit
	rozpoznawany jest po dwóch kolejnych znakach koļca linii (pusta
	linia pomiėdzy wierszami). Obsīugiwane sā dzielenia, przeniesienia
	wyrazów zaznaczone znakiem (-).

	Wysoce wskazane jest stosowane tej komendy wraz z "OPT".

    @{b}PRZYKĪAD@{ub}
	PCC AsciiTexts/#? DTPTexts/ LONGLINES OPT

	Kaūdy zbiór z katalogu AsciiTexts/ zostanie przetworzony na standard
	programów DTP i	zapisany w katalogu DTPTexts/.

@ENDNODE

@NODE SLMargin "Usuwanie lewego marginesu"

    @{b}WZÓR@{ub}
	SLMargin/S

    @{b}OPIS@{ub}
	W celach estetycznych tekst ASCII jest czėsto centrowany i przesuwany
	przy pomocy znaków odstėpu (kod 32) i tabulacji (kod 9). W
	programach DTP sīuūā do tego specjalne narzėdzia, zaō jakiekolwiek
	odtėpy na poczātku wiersza sā niewskazane.

	Komenda "SLMargin" usuwa wszystkie odstėpy rozpoczynajāce tekst.

    @{b}PRZYKĪAD@{ub}
	PCC AsciiTexts/#? DTPTexts/ SLMARGIN

	W kaūdym zbiórze z katalogu AsciiTexts/ zostanā usuniėte odstėpy na
	poczādku kaūdego wiersza, zaō caīoōź zostanie zapisana w katalogu
	DTPTexts/.

@ENDNODE

@NODE SELines "Usuwanie pustych linii"

    @{b}WZÓR@{ub}
	SELINES/S

    @{b}OPIS@{ub}
	Komenda usuwa puste linie - takie które nie zawierajā ūadnego
	tekstu.

    @{b}PRZYKĪAD@{ub}
	PCC AsciiTexts/#? DTPTexts/ SELINES

	W kaūdym zbiórze z katalogu AsciiTexts/ zostanā usuniėte puste
	linie, zaō caīoōź zostanie zapisana w katalogu DTPTexts/.

@ENDNODE

@NODE EditPCS "Edytacja pliku PolCharsSets"

    @{b}OPIS@{ub}
	Kaūda linia w pliku PolCharsSets oznacza jeden standard. Kaūda linia
	rozpoczyna siė od nazwy standardu, nastėpnie wystėpuje znak (-),
	oraz kody polskich znaków dla danego standardu. Kody powinny byź
	podane w postaci liczby szesnastkowych poprzedzonych znakiem ($).

	Linia definujāca standard powinna wyglādaź nastėpujāco:

	|*|<nazwa standardu> - Ā/ā,Ź/ź,Ė/ė,Ī/ī,Ļ/ļ,Ó/ó,Ō/ō,Ū/ū,Ś/ś

	gdzie zamiast liter powinny znajdowaź siė ich kody w danym
	standardzie.

	Znak (*) poprzedzajācy nazwė standardu, oznacza ūe standart moūe byź
	uūyty tylko jako docelowy. W procesie rozpoznania standardu zostanie
	on pominiėty.

	UWAGA: Caīa definicja standardu powinna znajdowaź siė w jednym
	wierszu

    @{b}PRZYKĪAD@{ub}
	AmigaPL - $C2/$E2,$CA/$EA,$CB/$EB,$CE/$EE,$CF/$EF,$D3/$F3,$D4/$F4,$DB/$FB,$DA/$FA

@ENDNODE