                        Dokumentace k programu aFTP
                        ===========================
                        v1.0beta ze dne 06.11.1996

   Program aFTP je GEMovy FTP klient, pracujici pouze pres MiNT-NET a
vyuzivajici AV protokolu, ktery je napr. implementovan ve vynikajicim
desktopu Thing.

   Co tedy potrebujete?
   --------------------
   
   * MiNT alespon 1.08
   * MiNT-NET
   * AES podporujici funkce AESu alespon 4.0
   * AV-SERVER, popr. aplikaci, zvladajici reagovat na zpravy AV protokolu

   Napojeni
   ________
   Po zvoleni polozky 'Hotlist' v menu 'File' se objevi dialog, kde zadate
jmeno ftp serveru, kam se chcete napojit a to bud ve forme ciselne adresy
(napr. 127.0.0.1) nebo nazvu hosta (napr. ftp.zcu.cz) a pak zvolte budto
anonymni prihalseni na server nebo po odskrtnuti anonymniho prihlaseni zadejte
uzivatelske jmeno a heslo pro prislusny server. V dialogu je jeste moznost
zadani adresare, do ktereho se klient pokusi prepnout ihned po napojeni
na server, coz je vyhodne napr. pri male pruchodnosti site. Po odklepnuti
buttonu 'Connect' se klient pokusi napojit na zadany server a pokud se mu
podari jej nalezt a napojit se, pokusi se o prihlaseni.
Po prihlaseni se stahne seznam adresare, ve kterem se prave nechazite
(domovsky adresar na vzdalenem serveru) a otevre se okno se soubory a
adresari. 
   Samozrejme muzete k napojeni pouzit i Hotlistu, kde lze uschovat az 25
nejcasteji navstevovanych serveru, vcetne zpusobu prihlaseni a pocatecniho
adresare. Polozek ulozenych v Hotlitu muzete pozdeji vyuzit k rychlemu
napojeni zvolenim polozky primo v rozbalenem submenu po najeti na polozku
'Connect to' v menu 'Server'.

   Prikazova radka ci VA_START
   ---------------------------
   Pokud program spustite s parametrem nebo mu poslete VA_STARTem retezec,
ktery je ve tvaru 'ftp://ftp_server/adresar/', program se po spusteni napoji
na ftp_server, prihlasi se jako anonymni uzivatel, prepne se do urceneho
adresare a otevre okno se seznamem souboru v danem adresari nebo pokud je
ve tvaru 'ftp://ftp_server/adresar/soubor', napoji se na ftp_server, prihlasi
se jako anonymni uzivatel, zjisti informace o zadanem souboru, stahne ho
do adresare zadaneho v nastavovacim dialogu, odpoji se z ftp_serveru a skonci.

   Download souboru
   ----------------
   Nyni se muzete dvojklikem pohybovat po vzdalenem pocitaci a dvojklikem
na soubory je prohlizet na svem stroji - pri prohlizeni se stahne soubor
na lokalni disk do CLIPBOARDU a zbrazi se jako byste na nej dvojklikli
v desktopu. Pokud chcete soubor stahnou k sobe na lokalni disk do libovolneho
adresare (kam mate pristup na zapis), oznacite jeden ci vice souboru
na vzadalenem serveru (gumickou ci klikanim na jednotlive polozky) a 
drag&dropem je hodite budto na ikonu disku, adresare kam se maji stahnout,
nebo na ikonu popelnice a soubory na ftp serveru se smazou.

   Poslani souboru na server
   -------------------------
   Je to podobna operace, jako download. Vezmete ikonu souboru z desktopu nebo
libovolneho programu podporujici VA_START a hodite ji na okno aFTP s vypisem
aktualniho adresare na serveru, kam chcete soubor poslat. Jsou tu dve male
odlisnosti: 1) soubor hozeny na okno se posle na server do aktualniho
adresare, tedy do toho, jehoz vypis mate v okne, na to, zdali jste soubor
pustili nad nazvem adresare nebo souboru se nebere zretel, 2) lze zatim
posilat po jednom souboru (toto se brzy zmeni a pujde poslat nekolik
oznacenych souboru najednou).

   Menu EDIT
   ---------
   Pokud jste napojeni na server a mate tedy otevrene okno se seznamem souboru,
muzete vyuzit funkci v menu edit. Budto oznacit nebo naopak odznacit vsechny
soubory v seznamu - pak muzete pouzit obvykly postup na stazeni oznacenych
souboru nebo muzete seznam oznacenych souboru zkopirovat do CLIPBOARDu. Pokud
neni zvolen zadny soubor, zkopiruje se seznam vsech souboru. Seznam je presna
kopie seznamu v okne (razeni; zobrazeni delky, datumu, ...) a jeste obsahuje
jednu radku popisu k jakemu serveru a jakemu jeho adresari patri tento seznam.
Jestlize pri kliku mysi nebo stisknuti hotkeje na kopii do clipboardu drzite
klavesu SHIFT, seznam se pripoji k soucasnemu clipboardu, v jinem pripade se
clipboard (soubor SCRAP.TXT) prepise.

   Nastaveni prostredi
   -------------------
   Z dalasich podporovanych protokolu se jeste zminime o FONT protokolu, pokud
se vam tedy nelibi font, jakym je psan listing adresare v okne (obvykle je to
systemovy font ;), pouzijte nejblizsi font selector a hodte vysledek na okno
aFTP listingu. S uspechem se setkate urcite u Thingu, jehoz interni font
selector pracuje dobre. Doporucujeme pouzivat proporcionalni fonty, jinak je
v okne zmatek ;) Pri zvoleni polozky v menu se program poohledne po env.
promene FONTSELECT a zavola nastveny Fontselector. V obou pripadech muzete
nastavit jak typ a velikost fontu, tak i jeho barvu!
Pri spusteni program hleda v $HOME adresari svuj konfiguracni soubor aftp.cfg a
pokud ho nenalezne nebo spatne nacte, pouzije defaultni nastaveni. Konfigur.
soubor obsahuje informace o vsech zakladnich vecech, ktere lze v programu
nastavit. V temze adresari je ukladan i ahotlist.ftp, soubor obsahujici Vami
nadefinovany Hotlist.
Poznamka: Pokud nemate nastavenu env. promenou HOME (coz byste mit meli, kdyz
uz pouzivate MiNT-Net ;), zkousi program nacist cfg soubory z adresare, odkud
byl spusten.
   V menu SETUP se nastavuje jak vyse zmineny font v hlavnim okne programu,
tak i v dialogu GLOBAL cesty na pracovni adresar (defaultne je cesta nastavena
na CLIPBOARD), do nehoz se stahuji vsechny soubory ze serveru pri dvojkliku
(prohlizeni souboru) a lze tam i nastavit, zda se ma adresar mazat a zda o tom
chcete byt vzdy informovani. Lze tam take nastavit podminky pri prihlasovani
na server: jmeno a heslo pro prihlaseni se jako anonymni uzivatel, pocet pokusu
o prihlaseni a doba v sekundach mezi jednotlivymi pokusy.

   Zname chyby a omezeni
   ---------------------
   Jednak proto, ze se jedna o testovaci verzi a jednak proto, ze ma kazdy
program nejake mouchy, uvadime zde par drobnosti ;-)

-------------------------------------------------------------
   Nedoresene TIMEOUTy
   Spatne pracujici dialogy (konkretne editacni pole)
-------------------------------------------------------------  

   Kontakt
   -------
   
   ATACK                         e-mail:  atack@szt.cdrail.cz
   Jan a Tomas Krivankove        FIDO  :  2:423/33
   Zizkova 26                    NeST  :  90:1200/7
   320 16  Plzen                 PR    :  OK1XKN @ OK0PPL

   Na vyse uvedene adresy nam zasilejte Vase navrhy, nalezene chyby,
zkusenosti s programem, penize, dary, ... :-)

   Mnoho prijemnych chvil stravenych na InterNETu a mnoho zajimavych souboru
stazenych nasim programem Vam preje ATACK InterNET Division ! ;)
