                        Dokumentace k programu aFTP
                        ===========================
                        v1.3beta ze dne 18.07.1997 

   Program aFTP je GEMovy FTP klient (pracujici pres MiNT-NET nebo STiK)
vyuzivajici AV protokolu, ktery je napr. implementovan ve vynikajicim
desktopu Thing.

   Upozorneni !
   ------------
   Existuji dve verze programu, jedna pro MiNTnet a druha po STiK !
   Typ je uveden v 'about' dialogu.
   
   Co tedy potrebujete?
   --------------------
   * MiNT alespon 1.08 + MiNTnet nebo STiK/STiNG
   * AES podporujici funkce AESu alespon 3.40
   
   Co doporucujeme
   ---------------
   * MiNT 1.12.6 nebo 1.14.3 a MiNTnet 1.01
   * N.AES 1.10
   * THING jako desktop a hlavne jako AV-SERVER, 
     popr. aplikaci, zvladajici reagovat na zpravy AV protokolu
   
   Napojeni na server
   ------------------
   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 a 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 stahnout 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. Samozrejme
muzete pouzit i funkci v menu Prikazy->Stahnout - v tom pripade se oznacene
soubory stahnou do TEMP adresare.
Pokud je pri drag&dropu stisknuta klavesa 'Control', oznacene soubory se
presunou na vas disk, tzn. ze se po uspesnem prenosu z FTP serveru smazou
(samozrejme pokud mate prislusna prava).

   Smazani souboru na serveru
   --------------------------
   Je to podobne jako pri downloadu souboru. Pozadovane soubory ale hodite
na ikonu popelnice na desktopu nebo muzete zvolit polozku Prikazy -> Smazat.

   Poslani souboru na server
   -------------------------
   Je to podobna operace, jako download. Vezmete ikonu souboru z desktopu nebo
libovolneho programu podporujici VA_START ci Drag&Drop a hodite ji na okno aFTP
s vypisem aktualniho adresare na serveru, kam chcete soubor poslat.
Upozorneni: 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.
Pokud je pri drag&dropu na okno aFTP stisknuta klavesa 'Control', oznacene
soubory se presunou na FTP server, tzn. ze se po uspesnem prenosu smazou
z lokalniho (Vaseho) disku.

   Prejmenovani souboru
   --------------------
   Vsechny oznacene soubory/adresare budou prejmenovany po zvoleni polozky 
Prikazy -> Prejmenuj

   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
   -------------------

    o Fonty
      ~~~~~
   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.
promenne FONTSELECT ci po nainstalovanem xFSL a zavola nastveny Fontselector.
Ve vsech pripadech muzete nastavit jak typ a velikost fontu, tak i jeho barvu!

   o Konfiguracni soubory
     ~~~~~~~~~~~~~~~~~~~~
   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
pouzivate MiNTnet), zkousi program nacist cfg soubory z adresare, odkud byl 
spusten.

   o Menu 'Nastaveni'
     ~~~~~~~~~~~~~~
   Z menu NASTAVENI se da zavolat vyse zmineny fontselector polozkou FONT ;)
Polozka CELKOVE otevre dialog, ve kterm se nastavuji zakladni udaje 
o prihlasovani se na server, jako je pocet pokusu a doba mezi pokusy, jmeno
a heslo pro anonymni prihlaseni. Dale se zaskrtavaji checkboxy:

 [X] Konvertovat nazvy souboru na mala pismena 
     - tato volba umozni pri posilani souboru na server konvertovat nazvy
     souboru na mala pismena. Konverze se provadi pouze pri posilani souboru
     z filesystemu, ktery nerozlisuje velka/mala pismena v nazvu souboru.
     Takze pokud posilate soubor z minixove partition, konverze se neprovede,
     pokud posilate soubor z normalni TOSove FATky, vsechna pismena v nazvu
     budou na serveru mala.

 [X] Automaticke zjistovani linku
     - pokud se pri stahovani seznamu souboru v adresari na FTP serveru objevi
     nejaky link, automaticky se provede zjisteni, na co link ukazuje, jakou ma
     soubor velikost a zda-li to neni adresar. 

 [X] Napoj se na dalsi server z Hotlistu ....
     - po zavreni okna s vypisem souboru se program automaticky napoji na dalsi
     server v Hotlistu. Takze pokud projizdite sve oblibene servery a hledate,
     co je kde noveho, usetrite cas jizdou mysi do menu ;)

 [X] Automaticke dotahovani souboru
     - pokud skonci prenos souboru neuspesne, program se pokusi spustit
     stahovani souboru znovu. Opakuje to do uplneho dotazeni souboru nebo
     do preruseni prenosu uzivatelem.

   V polozce CESTY se nastavuje, zda-li a kam se maji zapisovat vsechny prikazy
poslane na server a vsechny odpovedi prisle ze serveru. Take zde muzete zapnout
cache a nastavit pro ni cestu. Dale se zde nastavuje cesta, kde se uklada cache
a cesta pracovniho adresare, pripadne adresare pro download.
   V polozce POTVRZOVANI se nastavuje, zda-li si ma program, pred provedenim
vetsinou nevratnych zmen, vyzadat Vase potvrzeni a zda-li se ma mazat pracovni
adresar pri ukonceni programu (v KGMD doporucujeme nastavit pracovni adresar
na /tmp, ktery se maze automaticky pri startu systemu).

   o Environment promenne
     ~~~~~~~~~~~~~~~~~~~~
   Zatim je v programu pouzita jen jedna a to AFTP_LIST, kterou nastavujete
maximalni pocet polozek (souboru+adresaru+linku) v adresari na FTP serveru.
Nastavujete tim tedy v podstate pametove naroky programu. Pokud neni tato
promenna nastavena, je pouzito defaultne bud 1000 polozek a pokud se ani tolik
nevejde do pameti, pak na kolik vystaci 1/3 volne pameti.
	Program samozrejme nacita a pouziva i globalni env. promenne, jako napr.
CLIPBRD, HOME, AVSERVER, FONTSELECT, ...

   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
-------------------------------------------------------------  

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

   Nejnovejsi verze programu najdete na nasi WWW strance na adrese
http://plzen.eunet.cz/consul/atari/atack/

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

   Pokud mate pristup na Web, rozhodne navstivte nasi WWW stranku a vyplnte
HTML bugreport !

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