@DATABASE Convert.guide
@AUTHOR "Jazz of Abstract"
@(C) "Copyright 1997 Abstract"
@$VER: Convert.guide 36.3 (12.4.97)
@SMARTWRAP

@NODE MAIN "Convert dokumentacja"
@{JCENTER}@{B}Convert 1.11@{UB}@{LINE}@{JLEFT}

Niniejszy plik opisuje program Convert, bėdācy konwerterem tekstu.@{LINE}

Plik wykonywalny, dokumentacja oraz sterowniki formatów stanowiā FREEWARE,
przy czym pozostajā wyīācznā wīasnoōciā autora.@{LINE}

 @{" Dystrybucja " LINK DYSTRYBUCJA}			o kopiowaniu i rozpowszechnianiu@{LINE}
 @{" Wprowadzenie " LINK WPROWADZENIE}			do czego sīuūy ten pakiet?@{LINE}
 @{" Wymagania " LINK WYMAGANIA}			wymagania sprzėtowe@{LINE}
 @{" Sterowniki " LINK STEROWNIKI}			doīāczone sterowniki@{LINE}
 @{" Uūytkowanie " LINK CONVERT}			jak tego uūywaź@{LINE}
 @{" Historia " LINK HISTORIA}			historia pakietu@{LINE}
 @{" Przyszīe wersje " LINK PRZYSZĪOŌŹ}		co nowego w przyszīych wersjach?@{LINE}
 @{" Adres autora " LINK AUTOR}			gdzie jest autor?@{LINE}
@ENDNODE

@NODE DYSTRYBUCJA "Zasady dystrybucji"
Archiwum @{FG HIGHLIGHT}convert.lha@{FG TEXT} w skīad którego wchodzā nastėpujāce pliki:@{LINE}

 @{" Convert " LINK CONVERT}		- gīówny program@{LINE}
  Convert.guide		- instrukcja@{LINE}
  Convert.guide.info	- ikona instrukcji (MWB i NI)@{LINE}
 @{" L/FileSystem_Trans " LINK STEROWNIKI}	- katalog zawierajācy sterowniki formatów@{LINE}

dostėpne jest na Aminecie w katalogu text/misc oraz na stronie WWW:@{LINE}
http://andante.ae.katowice.pl/~stawiarz/amiga/convert.html@{LINE}

Kopiowanie i rozpowszechnianie programu dozwolone jest pod warunkiem, ūe
opīata za tė czynnoōź nie bėdzie wiėksza od kosztu jednej czystej
dyskietki, a archiwum pozostanie niezmienione.@{LINE}
@ENDNODE

@NODE WPROWADZENIE "Do czego sīuūy ten pakiet?"
Mnogoōź formatów (a nie standardów, bo standard moūe byź tylko jeden)
kodowania polskich liter jest wrėcz przeraūajāca. Skutkiem tego jest z
kolei powstawanie przeróūnych konwerterów polskich liter, co wprowadza
jeszcze wiėksze zamieszanie w temacie polskich liter. Jakby tego nie byīo
maīo nie spotkaīem jeszcze konwertera, który speīniaīby jednoczeōnie, dwie
bardzo waūne, w moim przekonaniu, cechy:@{LINE}

 - po pierwsze - program taki powinien mieź konstrukcjė moduīowā, aby kaūdy
jego uūytkownik mógī w razie potrzeby rozbudowaź go sobie o nowy format@{LINE}

 - po drugie - powinien poddawaź konwersji nie tylko 18 polskich liter,
lecz caīā tablicė ASCII - cóū z tego, ūe bėdė miaī wszystkie polskie
ogonkowce, gdy zamiast znaków takich jak np:. © « » ÷ czy niemieckich
umlautów dostanė jakieō krzaczki@{LINE}

Rozwiāzanie tego problemu jest wbrew pozorom bardzo proste, skorzystali z
niego twórcy CrossDOS'a. Jako, ūe powtórne odkrywanie Ameryki jest maīo
sensowne postanowiīem skorzystaź z tego samego rozwiāzania. Wszystkie
@{" sterowniki " LINK STEROWNIKI} znajdujāce siė w pakiecie mogā byź uūywane wraz z CrossDOS'em
- jest to szalenie wygodne rozwiāzanie dla wszystkich, którzy czėsto majā
do czynienia z pecetowymi dyskietkami. W pozostaīych przypadkach,
korzystanie z poōredniczācego urzādzenia PCx: byīoby doōź uciāūliwe,
napisaīem wiėc program obsīugujācy takowe sterowniki. @{" Convert " LINK CONVERT} razie
prostā komendā, moūliwā do uruchomienia tylko z poziomu Shell'a.@{LINE}
@ENDNODE

@NODE WYMAGANIA "Wymagania sprzėtowe"
@{" Convert " LINK CONVERT} wymaga systemu co najmniej w wersji 2.0 (V36). Jego
zapotrzebowanie na pamiėź zaleūy od dīugoōci konwerterowanego tekstu.@{LINE}

Dokumentacja napisna jest w formacie @{B}AmigaGuide® V40@{UB} - oznacza to, ūe aby
jā odczytaź konieczna jest biblioteka amigaguide.library w dowolniej
wersji. Szerokoōź tekstu wynosi maxymalnie 76 kolumn, wiėc tekst bėdzie
moūna swobodnie przeczytaź przy pomocy czcionki o szerokoōci 8 punktów
(np:. topaz.font/8). Jeōli jednak korzystasz z systemu 3.1 (V40) szerokoōź
tekstu zostanie automatycznie dostosowana do szerokoōci okna progrmu
MultiView i uūywanej czcionki (nawet proporcjonalnej).@{LINE}
@ENDNODE

@NODE STEROWNIKI "Sterowniki"
Obecnie dostėpne sā nastėpujāce sterowniki. Wszystkie z nich dostosowane sā
do standardu @{" AmigaPL " LINK AMIGAPL}. Sterowniki formatów peceta posiadajā rozszerzenie
@{FG HIGHLIGHT}.crossdos@{FG TEXT}, co pozwala na korzystanie z nich takūe spod CrossDOS'a.@{LINE}

@{B}Finder@{UB}@{LINE}

 @{" MacCE " LINK MACCE}		Macintosh Central Eupropean@{LINE}

@{B}MS-DOS@{UB}@{LINE}

 @{" CSK " LINK MAZOVIA}			Computer Studio Kajkowski@{LINE}
 @{" Cyfromat " LINK MAZOVIA}		Cyfromat@{LINE}
 @{" DHN " LINK MAZOVIA}			Dom Handlowy Nauki@{LINE}
 @{" Latin-1 " LINK LATIN-1}		Latin-1 Code Page 437@{LINE}
 @{" Latin-2 " LINK LATIN-2}		Latin-2 Code Page 852@{LINE}
 @{" Mazovia " LINK MAZOVIA}		Mazovia@{LINE}
 @{" Microvex " LINK MAZOVIA}		Microvex@{LINE}
 @{" TAG " LINK MAZOVIA}			TAG@{LINE}

@{B}MS-Windows@{UB}@{LINE}

 @{" ISO-Latin-1 " LINK ISO-LATIN-1}		ISO-8859-1 ECMA-94 Latin-1 International@{LINE}
 @{" Latin-2 EE " LINK EE}		Latin-2 Eastern European Code Page 1250@{LINE}

@{B}Unix@{UB}, @{B}Linux@{UB} i @{B}X-Windows@{UB}@{LINE}

 @{" ISO-Latin-1 " LINK ISO-LATIN-1}		ISO-8859-1 ECMA-94 Latin-1 International@{LINE}
 @{" ISO-Latin-2 " LINK ISO-LATIN-2}		ISO-8859-2 Polska Norma@{LINE}

@{B}Workbench@{UB}@{LINE}

 @{" AmigaPL " LINK AMIGAPL}		AmigaPL@{LINE}
 @{" ISO-Latin-1 " LINK ISO-LATIN-1}		ISO-8859-1 ECMA-94 Latin-1 International@{LINE}
 @{" xJP " LINK XJP}			Ksiādz Jan Pikul@{LINE}

@{B}inne@{UB}@{LINE}

 @{" FIDO-Mazovia " LINK FIDO-MAZOVIA}		FIDO-Mazovia@{LINE}
 @{" Pomocnik " LINK POMOCNIK}		Pomocnik Krzyūówkowicza@{LINE}
 @{" US-ASCII " LINK US-ASCII}		US-ASCII@{LINE}
@ENDNODE

@NODE MACCE "Macintosh Central Eupropean"
Format @{FG HIGHLIGHT}MacCE@{FG TEXT} jest standardem stosowanym przez ōrodkowoeuropejskich
uūytkowników Macintosh'y. Idea powstania tego formatu jest taka sama jak
formatu @{" ISO-Latin-2 " LINK ISO-LATIN-2}, niestety powstaī on z oryginalnego formatu Mac,
a nie z @{" ISO-Latin-1 " LINK ISO-LATIN-1}, wiėc w przypadku Macintosh'a przejōcie na
@{" ISO-Latin-2 " LINK ISO-LATIN-2} nie bėdzie īatwe.@{LINE}

@{I}UWAGA: Sterownik ten jest niepeīny - nie znam kodów wszystkich znaków.@{UI}@{LINE}
@ENDNODE

@NODE LATIN-1 "Latin-1 code page 437"
Format @{FG HIGHLIGHT}Latin-1@{FG TEXT} jest oryginalnym formatem uūywanym w niespolszczonym
MS-DOS'ie.@{LINE}
@ENDNODE

@NODE LATIN-2 "Latin-2 code page 852"
Format @{FG HIGHLIGHT}Latin-2@{FG TEXT} zostaī zaproponowany jako standard kodowania liter
charakterystycznych dla Ōrodkowej Europy przez IBM dla uūytkowników MS-DOS'a.@{LINE}

@{I}UWAGA: Sterownik ten jest niepeīny - jest to bowiem Latin-1 z polskimi
literami.@{UI}@{LINE}
@ENDNODE

@NODE MAZOVIA "Formaty MS-DOS'a"
Kreatywnoōź uūytkowników peceta w tworzeniu formatów kodowania polskich
liter jest imponujāca. Na szczėōcie proces tworzenia nowych formatów zostaī
juū zahamowany, a i sam MS-DOS odchodzi do lamusa. Spoōród wyūej
wymienionych najwiėkszā popularnoōź zyskaīa sobie Mazovia.@{LINE}
@ENDNODE

@NODE EE "Latin-2 Eastern European code page 1250"
Format @{FG HIGHLIGHT}Latin-2 EE@{FG TEXT} jest standardem stosowanym przez ōrodkowoeuropejskich
uūytkowników pecetów. Idea powstania tego formatu jest taka sama jak
formatu @{" ISO-Latin-2 " LINK ISO-LATIN-2}, logicznym wydaje siė byź dāūenie uūytkowników do
przejōcia na tenūe standard.
@ENDNODE

@NODE ISO-LATIN-1 "ISO-8859-1 ECMA-94 Latin-1 International"
Format @{FG HIGHLIGHT}ISO-Latin-1@{FG TEXT} jest standardem stosowanym we wszystkich obecnie uūywanych
systemach, niestety nie zawiera on liter charakterystycznych dla jėzyków
uūywanych w Ōrodkowej Europie. Wīaōnie na potrzeby ōrodkowoeuropejskich
uūytkowników powstaī standard @{" ISO-Latin-2 " LINK ISO-LATIN-2}.@{LINE}
@ENDNODE

@NODE ISO-LATIN-2 "ISO-8859-2 Polska Norma"
Format @{FG HIGHLIGHT}ISO-Latin-2@{FG TEXT} jest standardem kodowania liter paļstw Europy Ōrodkowej.
Caīkowicie zdominowaī Internet. Jest standardem niekwestionowanym
absolutnie przez nikogo, nawet przez uūytkowników systemów, na których
stosuje siė inne formaty, wynikiem tego sā propozycje przejōcia na ten
standard wysuwane przez uūytkowników m.in. Workbench'a i
MS-Windows'a.@{LINE}
@ENDNODE

@NODE AMIGAPL "AmigaPL"
Format @{FG HIGHLIGHT}AmigaPL@{FG TEXT} zostaī stworzony przez profesora Wojciecha Bruszewskiego.
Obecnie jest on standardem kodowania polskich liter na Amidze, choź tu i
ówdzie sīyszy siė propozycje przejōcia na standard @{" ISO-Latin-2 " LINK ISO-LATIN-2}. Z tego
powodu wszystkie sterowniki zostaīy przystosowanie do standardu AmigaPL,
dziėki czemu nie musi istnieź osobny sterownik dla tego formatu.@{LINE}
@ENDNODE

@NODE XJP "ksiādz Jan Pikul"
Format @{FG HIGHLIGHT}xJP@{FG TEXT} zostaī stworzony przez ksiėdza Jana Pikula i swego czasu byī on
standardem kodowania polskich liter na Amidze. Obecnie zostaī caīkowicie
zastāpiony standardem @{" AmigaPL " LINK AMIGAPL}.@{LINE}
@ENDNODE

@NODE FIDO-MAZOVIA "FIDO-Mazovia"
Format @{FG HIGHLIGHT}FIDO-Mazovia@{FG TEXT} jest standardem kodowania polskich liter w sieci FIDO.@{LINE}
@ENDNODE

@NODE POMOCNIK "Pomocnik Krzyūówkowicza"
Format @{FG HIGHLIGHT}Pomocnik@{FG TEXT} jest formatem zastosowanym kiedyō w doōź starym programie
Pomocnik Krzyūówkowicza do zapisu jego sīowników. Format ten jest
historycznie pierwszym jaki stworzyīem, po to by móc edytowaź jego sīowniki.@{LINE}

@{I}UWAGA: Format ten jest bardzo nietypowy, nie nadaje siė do konwersji
zwykīych tekstów (bo i po co?). Nie moūna teū przywróciź do "normalnej"
postaci tekstów przekonwerterowanych na ten format.@{UI}@{LINE}
@ENDNODE

@NODE US-ASCII "US-ASCII"
Format @{FG HIGHLIGHT}US-ASCII@{FG TEXT} to po prostu pierwsze 128 znaków w tablicy ASCII, co do
których wszyscy siė zgodzili i które sā punktem wyjōcia kaūdego formatu.@{LINE}

@{I}UWAGA: Format ten jest doōź nietypowy - uūywany jako exporter zachowuje siė
jak kaūdy inny sterownik, uūywany jako importer dziaīa tak jak CrossDOS w
trybie ASCII-7 - obcina najbardziej znaczācy bit.@{UI}@{LINE}
@ENDNODE

@NODE CONVERT "Jak tego uūywaź?"
@{CODE}    @{B}NAZWA@{UB}

	Convert - dokonuje konwersji tekstu.


    @{B}SZABLON@{UB}

	Convert FROM/A,TO,IMPORT/K,EXPORT/K,MAIL/S


    @{B}FORMAT@{UB}

	Convert [FROM] <śródīo> [[TO] <cel>] [IMPORT <format śródīa>]
	[EXPORT <format celu>] [MAIL]


    @{B}OPIS@{UB}

	Dokonuje konwersji tekstu, korzystajāc ze sterowników formatów
	tekstu kompatebilnych z CrossDOS'em oraz odkodowuje mail'e.


    @{B}PARAMETRY@{UB}

	FROM	Tekst śródīowy poddawany konwersji.

	TO	Plik, w którym ma byź zapisany przekonwerterowany tekst.
		Jeōli ten parametr nie zostaī podany, przekonwerterowany
		tekst zostanie zapisany bezpoōrednio na starym pliku.

	IMPORT	Sterownik formatu tekstu śródīowego. Jeōli sterownik
		znajduje siė w standardowym katalogu @{FG HIGHLIGHT}L:FileSystem_Trans@{FG TEXT},
		nie trzeba podawaź peīnej ōcieūki dostėpu do sterownika,
		ani ewentualnego standardowego rozszerzenia @{FG HIGHLIGHT}.crossdos@{FG TEXT}.

	EXPORT	Sterownik formatu tekstu docelowego. Jeōli sterownik
		znajduje siė w standardowym katalogu @{FG HIGHLIGHT}L:FileSystem_Trans@{FG TEXT},
		nie trzeba podawaź peīnej ōcieūki dostėpu do sterownika,
		ani ewentualnego standardowego rozszerzenia @{FG HIGHLIGHT}.crossdos@{FG TEXT}.

	MAIL	Unixowe terminale majā to do siebie, ūe nie potrafiā
		wyōwietliź znaków o kodach wiėkszych od 127, zmieniajā je
		oraz kilka innych na sekwencje @{FG HIGHLIGHT}=XX@{FG TEXT}, gdzie @{FG HIGHLIGHT}XX@{FG TEXT} to
		szestnastkowa liczba okreōlajāca kod znaku. Podobnie za
		dīugie linie sā dzielone na mniejsze, a miejsce podziaīu
		zaznaczane jest znakiem @{FG HIGHLIGHT}=@{FG TEXT}. Jest to szczególnie odczuwalne w
		programach do obsīugi poczty.
		Podanie parametru @{FG HIGHLIGHT}MAIL@{FG TEXT} spowoduje odkodowanie tak
		zakodowanego pliku.


    @{B}PRZYKĪAD@{UB}

	Dla osób tworzācych polskie strony WWW na Amidze:

	Convert index.html EXPORT ISO-Latin-2


    @{B}UWAGI@{UB}

	Convert moūe byź uruchomiony tylko z Shell'a. Convert jest "czysty"
	i moūe byź rezydentny.
@ENDNODE

@NODE HISTORIA "Historia pakietu"
@{B}1.11 (12.04.97)@{UB}@{LINE}

 - usunāīem bīād polegajācy na tym, ūe w poprzedniej wersji podanie katalogu
jako parametru @{" FROM " LINK CONVERT} skutkowaīo zaweszeniem komputera@{LINE}


@{B}1.1 (01.02.97)@{UB}@{LINE}

 - odkodowywanie mail'i@{LINE}
 - usunāīem bīād polegajācy na tym, ūe w poprzedniej wersji parametr
@{" EXPORT " LINK CONVERT} byī jednak konieczny@{LINE}
 - dokumentacja w formacie @{B}AmigaGuide® V40@{UB}@{LINE}
 - jeszcze szybsza konwersja@{LINE}
 - poprawiony sterownik @{" Latin-2 EE " LINK EE}@{LINE}


@{B}1.0 (01.01.97)@{UB}@{LINE}

 - napisana caīkowicie na nowo komenda @{" Convert " LINK CONVERT}@{LINE}
 - jeōli konwerterujesz z/na @{" AmigaPL " LINK AMIGAPL} nie musisz podawaź parametrów
@{" IMPORT/EXPORT " LINK CONVERT}@{LINE}
 - dokumentacja w formacie @{B}AmigaGuide® V33@{UB}@{LINE}
 - nareszcie peīny sterownik @{" ISO-Latin-2 " LINK ISO-LATIN-2}@{LINE}
 - poprawiony sterownik @{" Latin-2 EE " LINK EE}@{LINE}
 - sterownik MacCentralEuro zmieniī nazwė na @{" MacCE " LINK MACCE}@{LINE}


@{B}0.9 (20.08.95)@{UB}@{LINE}

 - pierwsze wydanie@{LINE}
@ENDNODE

@NODE PRZYSZĪOŌŹ "Co nowego w przyszīych wersjach?"
W nastėpnych wersjach @{" Convert'a " LINK CONVERT} dodane zostanā nastėpujāce elementy:@{LINE}

 - konwersja EOL'i (LF<->CRLF<->CR)@{LINE}
 - konwersja EOF'ów@{LINE}
 - konwersja wielu sāsiadujācych spacji na jednā - unformatowanie ;-)@{LINE}
 - īāczenie linii@{LINE}
 - usuwanie niepotrzebnych TAB'ów i spacji na koļcu linii@{LINE}

oraz jeszcze wiėcej @{" sterowników " LINK STEROWNIKI}.@{LINE}
@ENDNODE

@NODE AUTOR "Gdzie jest autor?"
Wszelkie uwagi, sugestie, pytania proszė kierowaź na adres:@{LINE}@{JCENTER}

Borys Stawiarz@{LINE}
ul. Kaliska 19a/47@{LINE}
41-200 Sosnowiec@{LINE}
e-mail: stawiarz@andante.ae.katowice.pl@{LINE}

@{JLEFT}Odwiedś takūe stronė WWW z @{" Convert'em " LINK CONVERT}@{LINE}
http://andante.ae.katowice.pl/~stawiarz/amiga/convert.html@{LINE}
@ENDNODE