                        Dokumentace k programu aFTP
                        ===========================
                        v1.4beta2 ze dne 03.05.1998 

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

   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 popup- a sub-menu (AES alespon 3.30 nebo
     MagiC s XMEN_MGR.PRG)
   
   Co doporucujeme
   ---------------
   * MiNT 1.14.x a MiNTnet 1.01
   * N.AES 1.10
   * THING nebo Jinnee 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, pocatecniho
adresare a portu, na jakem se ma program pokusit napojit na FTP server.
Polozek ulozenych v Hotlitu muzete pozdeji vyuzit k rychlemu napojeni
zvolenim polozky primo v rozbalenem submenu po najeti na polozku
Napojit na ->' 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 a odpoji se z ftp_serveru.

   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 TEMP adresare 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 jsou oznaceny i adresare, stahnou
se take, vcetne eventuelnich podadresaru a samozrejme se vytvori patricna
adresarova struktura i na vasem lokalnim disku.
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.
Opet zde funguje posilani celych adresarovych struktur, jako je tomu
u downloadu adresaru.
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.def, 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.

  Format hotlistu
  ---------------
  Od verze je pouzit novy format souboru s nejcasteji navstevovanymy servery.
Tento soubor je nyni v ASCII forme a muzete jej tedy upravovat jakymkoliv
textovym editorem. Pokud prechazite ze starsi verze (nizsi nez 1.4), muzete si
vas hotlist zkonvertovat programem hotconv.tos, ktery je obsazen v baliku
aFTP 1.4 ci na nasi WWW strance.

  Soubor s hotlistem ma na kazde radce jeden prikaz. Kazda polozka v hotlistu
musi zacit klicovym slovem SERVER, za nimz nasleduje adresa serveru. Na dalsich
radkach jsou nepovinna klicova slova, ale pozor: tyto dalsi radky musi zacinat
mezerou ci tabulatorem !
Klicova slova (nerozlisuji se velka/mala pismena):
SERVER nazev_ftp_serveru
STARTDIR pocatecni_adresar
   - pokud neni uvedeno, po napojeni zustane program v aktualnim adresari
NAME jmeno_pro_prihlaseni
   - pokud neni uvedeno, program se prihlasi jako anonymni uzivatel
PLAIN heslo
   - nezakodovane heslo. Toto heslo se zakoduje pri ukladani hotlistu programem
     aFTP.
PASSWORD zakodovane_heslo
   - toto je jiz zakodovane heslo programem aFTP.
PORT cislo_portu
   - program se nenapoji na standartnim portu pro sluzbu ftp, ale na vami
     zadanem portu.

  Takze soubor muze vypadat napr. takto:
SERVER ftp.zcu.cz
 STARTDIR /tmp
SERVER ftp.eunet.cz
 PORT 22

   o Menu 'Nastaveni'
     ~~~~~~~~~~~~~~~

   Polozka 'Celkove ...'
   ---------------------
Polozka CELKOVE otevre dialog, ve kterem 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 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.

 [X] Zachovavat datum souboru
     - po stazeni se nastavi datum/cas lokalniho souboru na stejne hodnoty,
     jake ma soubor na FTP serveru
     
 [X] Zachovavat pristupova prava
     - po stazeni se nastavi pristupova prava (rwx) lokalniho souboru na stejne
     hodnoty, jake ma soubor na FTP serveru (pokud to samozrejme lokalni
     filesystem umoznuje) a pokud FTP server bezi na operacnim systemu
     UNIX (ftp servery na Windozich vubec netusi, co to nejaka pristupova
     prava jsou; bohuzel se nektere servery na windozich hlasi jako UNIXove
     a tahle funkce nastavi nesmyslna prava, ale s tim se neda nic delat).
     
 [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] Automaticky obnovovat seznam
     - pri stahovani seznamu adresare se okamzite vykresluji polozky jedna
     za druhou tak, jak prichazeji z FTP serveru do okna s vypisem adresare.
     Po stazeni celeho seznamu se polozky pretridi podle vaseho nastaveni.
     
 [X] DHST protokol
     - je to protokol pouzivany napr. v utilitce StartMeUp! verze >= 7.01.
     Pokud zapnete tento protokol, zapisi se do DHST serveru vsechny FTP
     servery, na ktere se napojite.
     Vice informaci o tomto protokolu ziskate napr. v dokumentaci od SMU 7.01.

 [Popup] Akce po uzavreni okna
     - 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 ;)
     - po uzvareni okna se program odpoji od aktualniho ftp serveru
     - po uzavreni okna se program ukonci

   Polozka 'Cesty ...'
   -------------------
 [X] Soubor pro zaznam
     - zde se zapina a nastavuje, zda a kam se maji ukladat vsechny posilane
     prikazy na server a odpovedi z FTP serveru.
     
 [X] Cache
     - zde se zapina cache a nastavuje se cesta, kde se muze cache zalozit.
     Jsou to dva soubory (indexovy a datovy). Prochazeni adresaru na FTP
     serveru je pak o neco rychlejsi (pokud vstoupite do adresare, kde jste jiz
     byli, obsah se okamzite nacte z cache misto toho, aby se znovu tahal z FTP
     serveru.
     Poznamka: Pokud chcete tahat rekurzivne cele adresare z FTP serveru,
     musi byt cache zapnuta a nastavena existujici cesta !

 TEMP/Download adresar
     - zde se nastavuje cesta pracovniho adresare, kam se stahuji sobory
     po dvojkliku a kam se stahuji soubory po stahovani souboru pomoci
     polozky v menu.
     Tip: Pokud pouzivate KGMD instalaci MiNTu, nastavte si tuto cestu
     do adresare /tmp, ktery se maze automaticky pri startu systemu.

   Polozka 'Potvrzovani ...'
   -------------------------
   Zde 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.

   Polozka 'Font ...'
   ------------------
   Po zvolenim teto polozky se program pokusi zavolat fontselector a vy si
muzete vybrat font a jeho barvu pro okno s vypisem obsahu adresare.

   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
   Zatim nefunguje rekurzivni mazani adresaru
-------------------------------------------------------------  

   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://www.pwp.cz/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 ! ;)
