@database InBoot.guide
@author "Tomasz Bieliïski"
@(c) "Copyright © 1996-1999 Siumot/BlaBla"
@$VER: InBoot.guide 1.7 (02.08.99)

@node main "Manual - main menu"
@{fg highlight}
       ---------  ___          ______ ________  ____
      |     --- ||   |____ ___|_____ |    ___ ;|    |____    _______
      |      ---'|   |    |  ______  |    --- `|    |    |__|______ |
      |      ---  `_______|`---------'--------'`---------'_______   |
       tF!--------' -  - ------ pRESENTs ------ -  -   `---------gth'


                                @{u}@{b} InBoot 1.7 @{uu}
                             @{fg fill}@{i} Data 02.08.1999 @{fg text}@{ui}
                    Copyright © 1996-1999 Siumot/BlaBla
@{fg fill}
                           BootBlock uruchamialny @{fg text}
                    Copyright © 1998-1999 Zeeball/Apathy @{ub}

@{fg highlight}
                             Instrukcja obsîugi
@{fg text}
              1. @{" Prawa autorskie i rozpowszechnianie.    " link Prawa}
              2. @{" Do czego ten program sîuûy?             " link Do_czego}

              3. @{" Uruchomienie programu                   " link uruchom}
              4. @{" Wbudowany system pomocy                 " link help}
              5. @{" Funkcje programu                        " link funkcje}
              6. @{" Port ARexxa                             " link arexx}

              7. @{" Wymagania, biblioteki, dane techniczne. " link Wymagania}
              8. @{" Co w przyszîoôci?                       " link Future}
              9. @{" Historia programu.                      " link History}
             10. @{" Co to jest BlaBla?                      " link BlaBla}
             11. @{" Pozostaîe informacje.                   " link Rest}

@endnode


@node Prawa "Prawa autorskie i rozpowszechnianie"

Ten program podlega @{"Standard Amiga FD-Software Copyright Note" link AFD-COPYRIGHT.pl/main 178}.

Ten program jest FreeWare, jak zostaîo to okreôlone w punkcie @{"4a" link AFD-COPYRIGHT.pl/main 92}.

Jeôli szukasz wiëcej szczegóîów, proszë przeczytaê @{"AFD-COPYRIGHT" link AFD-COPYRIGHT.pl/main 1} (wersjë
1 lub nowszâ).


      @{" Prawa autorskie " link AFD-COPYRIGHT.pl/main 30}
      @{" Dystrybucja     " link AFD-COPYRIGHT.pl/main 44}
      @{" Oôwiadczenie    " link AFD-COPYRIGHT.pl/main 63}
      @{" Opîaty          " link AFD-COPYRIGHT.pl/main 80}
@endnode

@node Do_czego "Do czego ten program sîuûy?"

Program sîuûy do instalacji bootblocku na dysk. Dziëki niemu moûna w wygodny
i szybki sposób zainstalowaê bootblock na dysk, skasowaê, zapisaê, oraz
odczytaê ze zbioru.

Programem moûna zapisaê bootblock w postaci pliku uruchamialnego.

Programem moûna zainstalowaê bootblocki we wszystkich dotychczasowych
systemach zapisu (do systemu 3.0). Potrafi równieû obsîugiwaê gëste stacje
dysków (1.76 Mb).

Program jest zlokalizowany. Osoby posiadajâce system 2.1+ mogâ skorzystaê 
z polskiej wersji jëzykowej.

InBoot ma wbudowany port ARexxa i system pomocy On-Line Help!

Program nie wymaga ûadnych niestandardowych  bibliotek, wszystkie potrzebne
pliki znajdziesz na dysku z Workbenchem.

Program wykorzystuje bibliotekë xvs.library, dziëki której potrafi wykryê
wirusy bootblockowe.
@endnode

@node uruchom "Uruchomienie programu"

Program uruchomiê moûna z Shella (lub CLI) albo z Workbencha.

@{fg fill}Uruchamiajâc program z Shella moûna podaê kilka parametrów:@{fg text}

 PUB= Za sîowem kluczowym "PUB=" naleûy wpisaê nazwë ekranu publicznego,
      na którym ma sië otworzyê program. W wypadku pominiëcia tego
      parametru program uruchomi sië na standardowym ekranie publicznym
      (przewaûnie "Workbench").
      @{fg highlight}@{b}@{u}Uwaga!@{uu} Wielkoôê liter nazwy ekranu musi byê zachowana!@{fg text}@{ub}

 X=   Za sîowem kluczowym "X=" naleûy podaê wspóîrzëdnâ poziomâ lewego
      górnego rogu okna. Jeûeli pominiemy ten argument - okno otworzy sië
      na ôrodku ekranu.

 Y=   Tutaj ustaliê moûemy pionowâ wspóîrzëdnâ okna. Jeûeli pominiemy
      ten parametr to okno otworzy sië z takâ wspóîrzëdnâ, aûeby nie
      zasîaniaîo belki tytuîowej ekranu.

 SX=  Pozioma wspóîrzëdna lewego rogu okna, którâ program wykorzystuje
      po przyciôniëciu gadûetu @{"uôpienia" link uôpienie}. Domyôlnie jest ustawiona wartoôê
      wspóîrzëdnej poziomej X.

 CENTRE Jest to tzw. dyrektywa. Jeûeli podamy jâ jako argument, program
        ustawi wspóîrzëdnâ Y w ten sposób, aby okno otworzyîo sië
        na ôrodku ekranu.

 BOOTPATH= Za sîowem kluczowym naleûy podaê ôcieûkë, pod którâ znajdujâ sië
           bootblocki. Domyôlnie "PROGDIR:Bootblocks"

 AGDOCPATH= Za sîowem kluczowym naleûy podaê ôcieûkë, pod którâ znajduje sië
            dokumentacja. Domyôlnie "PROGDIR:Docs/English"

Poniûej znajduje sië wzorzec argumentów dla Cli (taki sam wzorzec pojawi sië
po uruchomieniu programu z parametrem "?").

PUB/K,X/N/K,Y/N/K,SX/N/K,CENTRE/S,BOOTPATH/K,AGDOCPATH/K


@{fg fill}Uruchamiajâc program z Workbencha,@{fg text} moûemy równieû ustawiê parametry
programu. Tym razem posîuûymy sië ikonkâ, w której parametry zmienia sië
komendâ Information z menu Workbencha. W ikonce znajduje sië pole ToolTypes,
w którym umieszcza sië parametry prawie analogiczne do parametrów Shella.
Zmienia sië tylko sîowo kluczowe PUB na rozszerzonâ formë PUBSCREEN.
@endnode

@node help "Wbudowany system pomocy"

W program jest wbudowany system pomocy tzw. On-Line Help w standardzie
AmigaGuide. Naciôniëcie klawisza "Help" spowoduje wyôwietlenie niniejszej
dokumentacji. Naleûy jednak zwróciê uwagë, aby w katalogu "Libs:" znajdowaîa
sië biblioteka amigaguide.library, a w katalogu, wskazanym przez parametr
@{"AGDOCPATH" link uruchom 30} dokumentacja "InBoot.guide". W przypadku nie speînienia tych
warunków, bâdú wystâpienia bîëdu system pomocy po prostu nie zadziaîa,
wyôwietlajâc stosowny komunikat informujâcy o bîëdzie. Okno pomocy jest
asynchroniczne, tzn. nie blokuje programu (InBoot moûna nadal obsîugiwaê).
Jeûeli w momencie naciôniëcia klawisza HELP wskaúnik myszy znajdzie sië nad
jakimô gadûetem programu, to w oknie pomocy zostanie wyôwietlona informacja
o funkcji tego gadûetu. Przed ponownym wywoîaniem pomocy nie trzeba zamykaê
okna z juû wyôwietlanâ pomocâ, w takim przypadku zmieni sië tylko rozdziaî
w oknie pomocy. Tryb pomocy nie dziaîa w oknie "Od Autora" i "Pokaû",
gdyû uwaûam, ûe nie ma sensu implementowaê do tych okien pomocy. Jeûeli
posiadasz system 3.0 lub nowszy polecam wykorzystywaê moûliwoôci biblioteki
amigaguide.library w wersji 39, gdyû dysponuje ona moûliwoôciami zmiany
atrybutów pisma (kolory, pogrubienia, podkreôlenia, itp.).
@endnode

@node funkcje "Opis funkcji programu"

Z programem moûna sië komunikowaê przy pomocy myszki i klawiatury. Funkcje
umieszczone sâ bezpoôrednio w oknie programu, w formie przycisków (gadûetów).
Podkreôlona literka w gadûecie odpowiada klawiszowi wywoîujâcemu danâ opcjë.
Poniûej przedstawiam wszystkie funkcje programu wraz z ich opisem.

@{" Zakoïczenie programu      " link koniec}
@{" Od Autora                 " link About}
@{" Tryb                      " link Mode}
@{" Stacja                    " link Drives}
@{" System                    " link System}
@{" Instaluj                  " link Install}
@{" Uôpienie programu         " link Uôpienie}
@{" Okno informacyjne         " link info}
@{" Wczytaj                   " link Load}
@{" Zapisz                    " link Save}
@{" Zapisz uruchamialny       " link SaveExe}
@{" Îaduj                     " link Read}
@{" Pokaû                     " link View}
@endnode

@node koniec "Zakoïczenie programu"

Aby zakoïczyê wspóîpracë z programem trzeba najechaê na gadûet wyjôcia.
Jest to standardowy przycisk systemu operacyjnego znajdujâcy sië w lewym
górnym rogu okna. Odpowiednikiem gadûetu wyjôcia jest klawisz 'Esc'.
@endnode

@node About "Od Autora"

Opcja wyôwietla krótkâ informacjë o programie i jego twórcy, oraz nazwë
portu ARexxa.
@endnode

@node Mode "Tryb"

Mamy moûliwoôê wyboru trybu pracy programu. W obecnej wersji sâ do wyboru
trzy tryby pracy:

1. Boot - program bëdzie sam generowaî standardowy bootblock.
2. NoBoot - program bëdzie kasowaî bootblocki.
3. Bufor - program przeîâczy sië w tryb pracy z buforem.

Jeôli wîâczymy pracë z buforem uaktywniâ sië nastëpujâce funkcje:

@{" Wczytaj            " link Load}
@{" Zapisz             " link Save}
@{" Îaduj              " link Read}
@{" Pokaû              " link View}

W tak ustawionym trybie pracy moûliwe jest przegranie bootblocku z innej
dyskietki, zapisanie do pliku, odczytanie z pliku i obejrzenie jego
zawartoôci.
@endnode

@node Drives

Tym gadûetem naleûy wskazaê programowi napëd, w którym znajduje sië dysk, na
który chcemy zainstalowaê bootblock. Moûna to zrealizowaê przez naciôniëcie
na symbol danego napëdu lub wciôniëcie klawisza odpowiadajâcego tej opcji,
co spowoduje wybranie nastëpnego napëdu. Operacjë odwrotnâ umoûliwia
kombinacja tegoû klawisza z 'Shift' (spowoduje wybranie poprzedniego napëdu
z listy).
@endnode

@node System

Program umoûliwia wybranie systemu pod jakim sformatowaliômy dysk, jednakûe
nie polecam uûywaê tego gadûetu, gdyû jest on samoczynnie przestawiany
(program sprawdza dysk znajdujâcy sië w wybranym napëdzie i ustawia go
w prawidîowym poîoûeniu). Opcjâ tâ moûna zmieniê system zapisu, tylko
gdy dysk jest pusty, w przeciwnym wypadku wystâpiâ konflikty, wynikajâce
z innego systemu zapisu plików znajdujâcych sië na dysku.
@endnode

@node Install

Przycisk sîuûy do instalacji bootblocku i zaleûnie od ustawienia trybu pracy
spowoduje wygenerowanie, skasowanie lub zainstalowanie bootblocku
znajdujâcego sië w buforze.

Przycisk jest nieaktywny (zaciemniony) jeûeli nie ma dysku w wybranym
napëdzie, jest zabezpieczony przed nagrywaniem, nie jest sformatowany,
lub jest pusty bufor (jeûeli program pracuje w @{"trybie bufor" link mode}). W wypadku
pojawienia sië bîëdu podczas instalowania zostaniemy o nim poinformowani
komunikatem w @{"okienku informacyjnym" link Info}.
@endnode

@node Uôpienie

Po naciôniëciu na systemowy gadûet "zoom" (jest to gadûet znajdujâcy sië
obok przycisku przesuwajâcego okno za lub przed inne okna) zostanâ
zmniejszone wymiary okna do minimalnych. Program przejdzie w stan uôpienia.
Ponowne przyciôniëcie na gadûet "zoom" spowoduje "obudzenie" programu.
@endnode

@node info "Okno informacyjne"

Okno informacyjne jest umieszczone pod przyciskiem @{"Od Autora" link About}. Jego zadaniem
jest przedstawienie informacji o wîoûonej dyskietce. Patrzâc od lewej strony:
 - nazwa wybranego napëdu,
 - typ wîoûonego dysku (DD lub HD)
 - bootblock uruchamialny (Boot) bâdú nie (NoBoot).

Jeûeli w wybranym napëdzie nie ma dysku, lub do tej stacji wîoûymy
zabezpieczony dysk to równieû w oknie pojawi sië odpowiedni komunikat.
W oknie moûe pojawiê sië po nazwie napëdu komunikat "Bîâd!!!", który
oznacza, ûe w stacji znajduje sië dyskietka, która nie jest sformatowana.

W oknie sâ równieû wyôwietlane informacje o ewentualnych bîëdach przy
instalacji bootblocku.
@endnode

@node Load

Przycisk umoûliwia odczytanie bootblocku ze zbioru do bufora. Po naciôniëciu
gadûetu ukazuje sië okno wyboru plików, w którym naleûy wskazaê nazwë
pliku, który zostanie wczytany do bufora.
@endnode

@node Save "Zapisz"

Gadûet umoûliwia zapisanie bootblocku do zbioru. Po wybraniu funkcji ukazuje
sië okno wyboru plików, w którym naleûy podaê nazwë jakâ przyjmie bootblock
zawarty w buforze. Jeûeli zbiór o takiej nazwie juû sië znajduje na dysku
to zostaniemy o tym poinformowani stosownym komunikatem.
@endnode

@node SaveExe "Zapisz uruchamialny"

Opcja umoûliwia zapisanie bootblocku znajdujâcego sië w buforze na dysk
w postaci pliku uruchamialnego (takiego, którego moûna uruchomiê z poziomu
dosa, lub Workbencha). Niektóre bootblocki mogâ zawieszaê system podczas
uruchomienia, jednakûe nie jest to winâ InBoota, lecz úle napisanych
bootblocków. Poza tym nie moûna wyôwietliê bootblocków w innych trybach niû
PAL lub NTSC.
@{b}
Autorem powyûszej funkcji jest Zbigniew Trzcionkowski (Zeeball/Apathy).@{ub}
@endnode

@node Read "Îaduj"

Opcja powoduje zaîadowanie bootblocku z dyskietki i umieszczenie jego
zawartoôci w buforze. Jest Równieû moûliwe wczytanie wygenerowanego przez
program bootblocku uruchamialnego. Opcja nie jest aktywna gdy w wybranym
napëdzie nie ma dysku.
@endnode

@node View "Pokaû"

Po wybraniu opcji program otworzy drugie okno, w którym zostanie wyôwietlony
bootblock zawarty w buforze. Do wyôwietlania zawartoôci bufora uûywana jest
czcionka systemowa.
@endnode

@node ARexx "Port ARexxa"

Program posiada wewnëtrzny zestaw komend pozwalajâcych na sterowanie nim
od zewnâtrz przez port ARexxa. Komendy te pozwalajâ na sterowanie prawie
wszystkimi funkcjami programu.

InBoot tworzy port komunikacyjny o nazwie "2b_InBoot_rexx", nazwa ta jest
wyôwietlana w oknie @{"Od Autora" link about} (w przypadku jej braku port ARexxa jest
nieaktywny). Aby ARexx wiedziaî gdzie ma wysyîaê komendy InBoota, naleûy
wskazaê port komendâ: "Address '2b_InBoot_rexx'". Naleûy pamiëtaê, ûe
korzystaê z tego portu moûna dopiero po uruchomieniu serwera ARexxa (program
RexxMast).

Skîadnia rozkazów jest nastëpujâca:

ROZKAZ  argumenty

Jeûeli argumenty objëte sâ nawiasami kwadratowymi, to nie muszâ byê podawane.
Rozkazy zwracajâ ARexxowi wyniki operacji w zmiennej RC i w RESULT. Zmienna
RC jest przeznaczona do obsîugi bîëdów. Jeûeli dowolny rozkaz zwróci
wartoôê 10 oznacza bîâd skîadniowy, jeôli 5 oznacza niemoûliwoôê wykonania
tego rozkazu, a jeôli wartoôê zmiennej RC bëdzie równa 0 to operacja sië
powiodîa.  Aby InBoot zwróciî jakâô wartoôê w zmiennej RESULT, musimy
na poczâtku programu wpisaê rozkaz: "OPTIONS RESULTS". Powiadomi on ARexxa,
ûe interesujâ nas zwracane wartoôci. Jeôli rozkaz nic nie zwraca, zmienna
RESULT bëdzie sië równaê ciâgu znaków 'RESULT'. Rozkazy mogâ byê pisane
duûymi, bâdú maîymi literami. A oto wykaz rozkazów:

@{" Drive           " link DriveRexx}
@{" Help            " link HelpRexx}
@{" InBoot To Back  " link BackRexx}
@{" InBoot To Front " link FrontRexx}
@{" Info            " link InfoRexx}
@{" Install         " link InstallRexx}
@{" Load            " link LoadRexx}
@{" Mode            " link ModeRexx}
@{" Quit            " link QuitRexx}
@{" Read            " link ReadRexx}
@{" Save            " link SaveRexx}
@{" Save Executable " link SaveExeRexx}
@{" System          " link SystemRexx}
@{" View            " link ViewRexx}
@{" Zoom            " link ZoomRexx}

@endnode

@node DriveRexx "Drive"

DRIVE [drive]

Rozkaz sîuûy do zmienienia napëdu, lub sprawdzenia, który jest aktualnie
wybrany. Jeôli nie podamy parametru drive, to rozkaz w zmiennej RESULT
zapisze nazwë aktualnie wybranego napëdu ('DF0:', 'DF1:', itp.). Podajâc
argument drive powodujemy zmianë napëdu, a do wyboru mamy: 'DF0:', 'DF1:',
'DF2:' i 'DF3:'. Jeôli nie podîâczyliômy któregoô z tych napëdów rozkaz
w zmiennej RC zwróci wartoôê 5. Naleûy jeszcze pamiëtaê, ûe nazwy napëdów
muszâ byê umieszczone w apostrofach i muszâ byê napisane duûymi literami.

Argumenty:
        drive - nazwa napëdu ('DF0:', 'DF1:', 'DF2:', 'DF3:'), lub brak
                parametru

Rezultat:
        RESULT - nazwa wybranego napëdu
        RC - 10 - bîâd skîadniowy, 5 - brak napëdu, 0 - sukces.

Przykîad:
        Drive
        Say 'Stacja:' result
        Drive 'DF1:'
@endnode

@node HelpRexx "Help"

HELP

Rozkaz otwiera system pomocy na @{"gîównej stronie" link main} dokumentacji.

Przykîad:
        Help
@endnode

@node BackRexx "InBoot To Back"

INBOOT TO BACK

Rozkaz przesuwa okno programu za pozostaîe okna na danym ekranie publicznym.

Przykîad:
        InBoot To Back
@endnode

@node FrontRexx "InBoot To Front"

INBOOT TO FRONT

Rozkaz wysuwa ekran, na którym jest InBoot, przed pozostaîe, przesuwa okno
programu przed pozostaîe i je uaktywnia.

Przykîad:
        InBoot To Front
@endnode

@node InfoRexx "Info"

INFO argument

Funkcja w zaleûnoôci od podanego argumentu udziela nam odpowiedzi, które
sâ przekazywane w zmiennej RESULT.

Argumenty:

Buffer - Sprawdza czy w buforze znajduje sië bootblock, i w zaleûnoôci od
         tego zwróci wartoôê 1 (bufor zawiera bootblock), lub 0 (bufor pusty).

Bootable - Sprawdza czy na dysku jest zainstalowany bootblock uruchamialny i
           w zaleûnoôci od tego zwróci wartoôê 1 (uruchamialny), bâdú
           0 nieuruchamialny. W przypadku braku dysku w RC zwróci wartoôê 5.

Disk - Sprawdza typ wîoûonej dyskietki (DD, bâdú HD) i w zaleûnoôci od tego
       zwraca ciâg tekstowy 'DD', 'HD' lub w przypadku braku dysku nic nie
       zwróci.

Protect - Sprawdza czy dysk jest zabezpieczony przed zapisem i w zaleûnoôci
          od tego zwróci wartoôê 1 (dysk zabezpieczony), 0 (dysk
          odbezpieczony), bâdú w przypadku braku dysku zwróci w RC 5 (brak
          dysku).

Pubscreen - Zwróci nazwë ekranu publicznego, na którym znajduje sië InBoot.

Version - Zwróci numer wersji programu. Szczególnie moûe byê to przydatne
          w kolejnych wersjach InBoota, w przypadku gdy dojdâ jakieô funkcje
          ARexxa. Bëdzie moûna napisaê skrypty, które bëdâ rozróûniaîy wersjë
          uruchomionego InBoota i w przypadku, gdy bëdzie za stara, grzecznie
          zakoïczâ dziaîanie.

Rezultat:
        RESULT - Ûâdane informacje
        RC - 0 sukces, 5 jeôli program nie mógî podaê ûâdanej informacji.

Przykîad:
        Info Version
        Say 'nr wersji InBoota:' result
@endnode

@node InstallRexx "Install"

INSTALL

Rozkaz powoduje instalacjë bootblocku na dysk (jest odpowiednikiem gadûetu
@{"Install" link install}). Jeûeli chcemy zainstalowaê bootblock zawarty w buforze, naleûy
przeîâczyê rozkazem @{"MODE" link moderexx} tryb programu, na tryb pracy z buforem. Jeôli
instalacja sië nie  powiodîa w zmiennej RC zostanie zwrócona wartoôê 5.
Jeôli chcemy dowiedzieê sië przyczyny bîëdu naleûy sprawdziê rozkazem
@{"INFO" link inforexx} czy w wybranym napëdzie znajduje sië dysk, czy jest odbezpieczony i
w przypadku trybu z buforem, naleûy sprawdziê bufor (czy nie jest pusty).

Rezultat:
        RC - 0 jeôli instalacja sië powiodîa, 5 jeôli wystâpiî bîâd.

Przykîad:
        Install
@endnode

@node LoadRexx "Load"

LOAD [filename]

Rozkaz wczytuje bootblock do buforu. Jeôli nie podamy argumentu to otworzy
sië okno wyboru plików, analogicznie jak przy korzystaniu z @{"gadûetów" link load}. Rozkaz
zwraca wynik w zmiennej RC. Jeôli RC jest równe 0 oznacza sukces, jeôli
równa sië 5 oznacza niemoûliwoôê wczytania zbioru (najprawdopodobniej zbiór
nie istnieje, lub jest uszkodzony), a jeôli równa sië 1 to uûytkownik
podczas wybierania zbioru, w oknie wyboru plików, wcisnâî gadûet "Pomiï".

Argumenty:
        filename - nazwa pliku wraz z ôcieûkâ dostëpu.

Rezultat:
        RC - 0 jeôli sukces, 1 jeôli uûytkownik zrezygnowaî z wyboru pliku,
             5 jeôli odczytanie pliku nie jest moûliwe.

Przykîad:
        Load 'ram:bootblock_1'
@endnode

@node ModeRexx "Mode"

MODE [mode]

Rozkaz sîuûy do zmiany trybu pracy programu. Jeûeli nie podamy parametru
mode rozkaz zwróci aktualne ustawienie trybu pracy w zmiennej RESULT.
Tryby pracy sâ przyporzâdkowane wartoôciom:
   0 - Boot
   1 - No Boot
   2 - Bufor

Argumenty:
        node - Tryb pracy (od 0 do 2)

Rezultat:
        RESULT - Numer ustawionego trybu pracy
        RC - 0 sukces, 10 bîëdny parametr

Przykîad:
        Mode
        Say 'nr trybu:' result
        Mode 2
@endnode

@node QuitRexx "Quit"

QUIT

Rozkaz powoduje zakoïczenie wspóîpracy z programem.

Przykîad:
        Quit
@endnode

@node ReadRexx "Read"

READ

Rozkaz odczytuje bootblock z dysku. Jeôli jego odczytanie nie jest moûliwe
zostanie zwrócona wartoôê 5 w zmiennej RC.

Rezultat:
        RC - 0 jeôli sukces, 5 jeôli niepowodzenie.

Przykîad:
        Read
@endnode

@node SaveRexx "Save"

SAVE [filename]

Rozkaz zapisuje bootblock z bufora. Jeôli nie podamy argumentu to otworzy
sië okno wyboru plików, analogicznie jak przy korzystaniu z @{"gadûetów" link save}.
Rozkaz zwraca wynik w zmiennej RC. Jeôli RC jest równe 0 oznacza sukces,
jeôli równa sië 5 oznacza niemoûliwoôê zapisania zbioru, a jeôli równa sië
1 to uûytkownik podczas wybierania zbioru, w oknie wyboru plików, wcisnâî
gadûet "Pomiï".

Argumenty:
        filename - nazwa pliku wraz z ôcieûkâ dostëpu.

Rezultat:
        RC - 0 jeôli sukces, 1 jeôli uûytkownik zrezygnowaî z wyboru pliku,
             5 jeôli zapisanie pliku nie jest moûliwe.

Przykîad:
        Save 'ram:bootblock_1'
@endnode

@node SaveExeRexx "Save"

SAVE EXECUTABLE [filename]

Rozkaz zapisuje bootblock z bufora w postaci pliku uruchamialnego. Jeôli
nie podamy argumentu to otworzy sië okno wyboru plików, analogicznie jak
przy korzystaniu z @{"gadûetów" link saveexe}. Rozkaz zwraca wynik w zmiennej RC. Jeôli RC
jest równe 0 oznacza sukces, jeôli równa sië 5 oznacza niemoûliwoôê
zapisania zbioru, a jeôli równa sië 1 to uûytkownik podczas wybierania
zbioru, w oknie wyboru plików, wcisnâî gadûet "Pomiï".

Argumenty:
        filename - nazwa pliku wraz z ôcieûkâ dostëpu.

Rezultat:
        RC - 0 jeôli sukces, 1 jeôli uûytkownik zrezygnowaî z wyboru pliku,
             5 jeôli zapisanie pliku nie jest moûliwe.

Przykîad:
        Save Executable 'ram:bootblock.exe'
@endnode

@node SystemRexx "System"

SYSTEM [name]

Rozkaz umoûliwia zmianë systemu zapisu dysku. Jeôli nie podamy nazwy systemu
w zmiennej RESULT zostanie zwrócona nazwa aktualnie wybranego systemu, lub
"BAD" gdy dysk nie jest sformatowany.

Argumenty:
        name - nazwa systemu zapisu (OFS, FFS, OFS-INT, FFS-INT, OFS-DC lub
               FFS-DC)

Rezultat:
        RESULT - nazwa aktualnie wybranego systemu zapisu
        RC - 0 jeôli sukces, 5 jeôli dysk nie jest sformatowany, 10 jeôli
             bîëdny argument

Przykîad:
        System FFS
        System
        Say 'nazwa systemu zapisu:' result
@endnode

@node ViewRexx "View"

VIEW

Rozkaz wyôwietla zawartoôê buforu (analogicznie jak z @{"gadûetu" link View}). Jeôli
wykonanie tego rozkazu nie jest moûliwe, zostanie zwrócona wartoôê 5
w zmiennej RC. Wyôwietlenie nie jest moûliwe tylko i wyîâcznie w przypadku
pustego buforu.

Rezultat:
        RC - 0 jeôli sukces, 5 jeôli jest niemoûliwe wyôwietlenie
             zawartoôci buforu.

Przykîad:
        View
@endnode

@node ZoomRexx "Zoom"

ZOOM [mode]

Rozkaz zmniejsza okno programu do minimalnych wymiarów. Jeûeli nie podamy
parametru, rozkaz zwróci obecne ustawienie.

Argumenty:
        mode - 0 - normalne wymiary okna programu
             - 1 - zmniejszone wymiary okna programu

Rezultat:
        RESULT - obecne ustawienie (0, lub 1)
        RC - 0 jeôli sukces, 10 jeôli bîëdny parametr.

Przykîad:
        Zoom 1
        Zoom
        Say 'Zoom:' RESULT
@endnode

@node Wymagania "Wymagania, biblioteki, dane techniczne"
@{fg fill}@{b}
Wymagania:@{fg text}@{ub}
 - dowolny model Amigi,
 - biblioteka Asl.library v38+,
 - system 2.04 lub nowszy,
@{fg fill}@{b}
Zalecenia:@{fg text}@{ub}
 - system 3.0+,
 - biblioteka locale.library (lokalizacja),
 - biblioteka amigaguide.library (On-Line Help),
 - biblioteka rexxsyslib.library (port ARexxa),
 - biblioteka screennotify.library,
 - biblioteka xvs.library (wykrywanie wirusów).
@endnode

@node Future "Co w przyszîoôci?"

 Do programu chcë dorobiê kilka opcjë:

  - opcjë analizujâcâ bootblocki.
@endnode

@node History "Historia programu"

wersja 0.2       18.08.1996     o Pierwsza wersja publiczna.

wersja 0.4       21.10.1996

     - Dodaîem odczytywanie parametrów z ikony,
     - Dodaîem cztery parametry X, Y, SX, CENTRE,
     - Dodaîem opcjë uôpienia programu,
     - Dodaîem obsîugë klawiatury,
     - Nie moûna jednoczeônie uruchomiê dwóch tych samych programów,
     - Program do uruchomienia potrzebuje systemu 2.04.


wersja 0.5       01.12.1996

     - Napisaîem procedurë zapisujâcâ bootblock,
     - Zautomatyzowaîem gadûet Boot,
     - W oknie informacyjnym ukazuje sië trochë wiëcej informacji.


wersja 1.0       26.12.1996

     - Dodaîem moûliwoôê zapisywania i odczytywania bootblocku z pliku,
     - Program wykorzystuje ReqTools.library.


wersja 1.1       12.01.1997

     - Dodaîem opcjë umoûliwiajâcâ obejrzenie zawartoôci bufora,
     - Notka o programie jest teraz pod osobnym gadûetem (przedtem byîa
       wyôwietlana po naciôniëciu gadûetu wyjôcia),
     - Dodaîem zamianë wskaúnika myszy na "zegarek" w czasie gdy program
       wykonuje jakâô czynnoôê,
     - Poprawiîem bîâd który zawieszaî program po zapisaniu bootblocku do
       pliku a nastëpnie wybraniu opcji odczytania bootblocku z pliku.

wersja 1.2       04.11.1997

     - Program umie liczyê sumë kontrolnâ bootblocku,
     - Przystosowaîem program do wymogów grupy BlaBla.
     - Drobne zmiany w GUI (usunâîem gadûet "Boot" a do gadûetu "Tryb"
       doîoûyîem pozycjë "No Boot", dziëki czemu interfejs uûytkownika jest
       zgrabniejszy),
     - Dodaîem lokalizacjë programu,
     - Zmieniîem opcjë "Od Autora..." - w okienku z informacjami wyôwietlane
       jest logo grupy BlaBla.

wersja 1.3       25.11.1997

     - Dodaîem system pomocy tzw. On-Line Help,
     - Dodaîem port ARexxa.

wersja 1.4      10.01.1998

     - Poprawiîem skalowanie.
     - Usunâîem bîâd zawieszajâcy program,
     - Dokumentacja moûe znajdowaê sië w dowolnym katalogu (dodaîem parametr
       AGDOCPATH)
     - Do wyôwietlania zawartoôci bootblocku uûywana jest czcionka systemowa
       (nieproporcjonalna).

wersja 1.5      24.05.1998

     - Program wykorzystuje cechy biblioteki: "screennotify.library".
     - Poprawiîem drobne bîëdy.

wersja 1.6      27.12.1998

     - Dodaîem opcjë zapisujâcâ bootblocki jako pliki uruchamialne.

wersja 1.7      02.08.1999     o Obecna wersja programu.

     - Dodaîem obsîugë biblioteki: "xvs.library".
@endnode

@node BlaBla "Co to jest BlaBla?"

@{B}@{FG HIGHLIGHT}BlaBla @{UB}@{FG TEXT}jest to grupa zrzeszajâca programistów piszâcych programy
wspóîpracujâce z systemem. Gwarantuje to poprawnâ pracë na wielu modelach
Amig, oraz zapewnia zachowanie kompatybilnoôci "w górë". Pozwala to równieû
na korzystanie z tak waûnej cechy, jakâ posiada @{I}@{FG FILL}Amiga, @{UI}@{FG TEXT}jak wielozadaniowoôê.
Nasze programy majâ zazwyczaj status PublicDomain, FreeWare lub ShareWare,
co pozwala na ich darmowe rozpowszechnianie.

@{B}Grupa posiada wîasnâ stronë Internetowâ @{UB}. Nasze najnowsze
programy moûna równieû znaleúê w wydawanym przez nas pakiecie polskich
programów uûytkowych @{B}PolWare. @{UB}Zapraszamy równieû do lektury redagowanego
przez nas magazynu dyskowego @{B}Izviestia. @{UB}Traktuje on gîównie o programowaniu
i zawiera opisy wielu ciekawych programów. Wszystkich internetowców
zachëcamy do obejrzenia naszej strony WWW, pod adresem:

   @{FG HIGHLIGHT}http://www.blabla.w.pl @{FG TEXT}
   @{FG HIGHLIGHT}http://amiga.org.pl/~krashan@{FG TEXT}

Zainteresowanych wspóîpracâ z naszâ grupâ, bâdú chëtnych do wymiany
doôwiadczeï i uwag na temat programów, prosimy o kontakt z którymô z
czîonków @{B}@{FG HIGHLIGHT}BlaBla. @{UB}@{FG TEXT}
@endnode

@node Rest "Pozostaîe informacje"

Jeôli znajdziesz jakiô bîâd lub masz jakieô sugestie, to napisz pod adres:


@{i}Mój adres:@{ui}
            Tomasz Bieliïski
           os. Kaszubskie 5/33
            84-200 Wejherowo

E-mail: siumot@amiga.org.pl
WWW: http://amiga.org.pl/~siumot


@{i}Podziëkowania: @{ui}

- Zbigniewowi Trzcionkowskiemu (Zeeball/Apathy), za opracowanie procedury
  generujâcej uruchamialny bootblock,

- Krashanowi, za bug raport i sugestie do wersji 1.3,

- Bogu, za Amigë, cierpliwoôê i pomysîy!!!


@{i}Pozdrowienia: @{ui}

- Pozdrawiam Zeeballa oraz wszystkich Blablowiczów!
@endnode
