================================
.D80 esxDOS dot command - MANUAL
================================

Podporovane formaty (obrazu)
disket: MDOS1.x,2.x (D40/D80).

Vyvijeno a testovano na
  pocitaci eLeMeNt ZX
  a rozhrani MB03+

Omezeni (verze):
  0.7f netestovano s obrazy
       disket pro MDOS3 

2026  SCjoe / eZX / MB

Varovani:
  Nepouzivejte starou verzi
  esxDOSu 0.8.8 (v nekterych
  pocitacich Omni). Muze dojit
  k poskozeni souboru nebo SD
  karty!

================================
POUZITI
================================
.D80 obraz[.ext] vypis adresare

.D80 [prepinace] obraz[.ext]

Pokud neni zadana pripona,
prikaz zkusi nejprve pridat
.D80, pak .D40. Pokud zadna
z nich neexistuje, vypise se
chyba.

Povolene varianty zadani jmena:
  DISKETA
  DISKETA.
  DISKETA.D80
  DISKETA.D40

================================
PREPINACE
================================
-x  Export souboru z obrazu
    diskety na SD kartu.

-c  Vytvoreni noveho prazdneho
    obrazu diskety (pouze .D80).

-n  Bez dotazu Scroll? Vypne
    dotaz po vypisu cele
    stranky.

-d  Zapis vypisu adresare do
    souboru misto na obrazovku.
  Jmeno vystupniho souboru:
    DISKETA       -> DISKETA.DIR
    DISKETA.      -> DISKETA.DIR
    DISKETA.EXT   -> DISKETA.EXT
      (EXT je libovolna jina
       pripona, LST, PRN, OUT,
       s vyjimkou D80 a D40)
    Pokud soubor uz existuje,
    program se zepta:
      Overwrite? Y/N

-i  Zobrazeni informaci o
    obrazu diskety: format,
    kapacita, statistiky FAT
    a pocty slotu adresare
    podle typu souboru.

================================
VYPIS ADRESARE
================================
Bez uvedeni prepinace, jen po
zadani jmena souboru diskoveho
obrazu, prikaz zobrazi obsah
adresare obrazu diskety:

  Filename  Bytes Start Attrib.
P jmeno        82     0----RWED
B soubor     1024 49152----RWED

Sloupce:
  typ     pismeno typu souboru
  jmeno   jmeno souboru (10zn.)
  Bytes   velikost v bajtech
  Start   u typu P: startovni
          radek BASICu
          u ostatnich: adresa
          nacteni do pameti
  Attrib. HSPARWED, pomlcka
          znamena nenast. bit

Na konci je pocet souboru a
volne misto v bajtech.

================================
TYPY SOUBORU MDOS
================================
MDOS pouziva jednopismenne typy:

P  BASIC program
B  Bajty (binarni data)
N  Ciselne pole
C  Znakove pole
S  Snapshot (pamet 48K)
Q  Sekvence (velky soubor)

================================
EXPORT (-x) KONVERZE SOUBORU
================================
Pri exportu je kazdy soubor
z obrazu diskety preveden do
souboru v esxDOSu.

Vystupni format zavisi na
puvodnim typu souboru v MDOSu:

P  -> .BAS  s hlavickou +3DOS
       typ 0 (BASIC program)

B  -> .SCR  RAW, bez hlavicky
       pokud delka = 6912 bajtu
       (screen, libovolna
       adresa)

B  -> .COD  s hlavickou +3DOS
       typ 3 (Code)

N  -> .NAR  s hlavickou +3DOS
       typ 2 (ciselne pole)

C  -> .CAR  s hlavickou +3DOS
       typ 1 (znakove pole)

S  -> .SNP  RAW, bez hlavicky
       (48K snapshot, 49152B)

Q  -> .BIN  RAW, bez hlavicky

ostatni -> .BIN  RAW, bez
                      hlavicky

================================
KONVERZE JMEN SOUBORU
================================
Jmena souboru MDOS maji 10
znaku. esxDOS (FAT) ma jmena
kratsi, 8 znaku + pripona
(format 8.3).

Pravidla prevodu:
- Z MDOS jmena se prevezme az
  8 platnych znaku pro FAT.
- Ponechana jsou velka a mala
  pismena, cislice a znak 
  pomlcky a carky, ostatni jsou
  odstraneny, vcetne mezer a
  tecek.
- Vysledek je preveden na
  velka pismena.
- Pripona je doplnena (.BAS,
  .COD, .SCR apod.) dle vyse.

Reseni kolizi jmen:
Pokud soubor se stejnym jmenem
uz na SD/CF karte existuje,
pred priponu se vlozi
dvouciferna cislice (napr.
HRA01.BAS, HRA02.BAS).
Lze zpracovat az 99 kolizi.

================================
STRUKTURA ADRESARE PRI EXPORTU
================================
Pri pouziti -x se nejdrive
vytvori adresar na SD karte.
Jeho jmeno je odvozeno od
jmena SOUBORU obrazu (nikoli
od jmena diskety ulozeneho
uvnitr obrazu), az 8 znaku,
bez pripony.
Priklad: HRY.D80 -> HRY/

Vsechny soubory jsou pak
exportovany do tohoto adresare.

Pokud uz adresar existuje,
program se zepta:
  Directory NAZEV exists.
  Overwrite? Y/N
  Y: vstoupi do nej a prepise
     soubory se stejnym jmenem.
  N: export je zrusen.

Soubory typu P (BASIC) dostanou
vlastni podadresar pojmenovany
podle jmena souboru BASIC.
To sdruzuje vicesouborove
programy. Priklad:
  HRY/
    GAME1/
      START.BAS
      ...
    GAME2/
      CAST1.BAS
      ...

Vsechny ostatni typy jdou primo
do adresare obrazu:
  HRA/
    HRA.BAS
    OBRAZEK.SCR
    DATA.COD

================================
VYTVORENI OBRAZKU (-c)
================================
Vytvori novy prazdny formatovany
obraz diskety D80.
  80 stop, 1440 sektoru
  kapacita: 728064 B
  9 sektoru na stopu
  512 bajtu na sektor
  oboustranny
  standardni format MDOS

Struktura obrazu:
  Sektor 0:    Boot sektor
  Sektory 1-5: FAT (volne)
  Sektory 6-13: Adresar
                (128 prazd.
                 slotu)
  Sektory 14+: Datova oblast

Jmeno diskety je nastaveno na
"EMPTY". Vsechny sloty adresare
jsou prazdne (32 bajtu $E5).

================================
INFORMACE O DISKU (-i)
================================
Zobrazi informaci o strukture
a obsazeni obrazu diskety.

Jmeno souboru obrazu
(nebo MDOS verze a jmeno
diskety u MDOS 2.1/2.2)
a nahodne ID v hexa.

Priklady:
  FLOPPY.D80         ID: $A3F2
  MDOS21: NAME.D80   ID: $A3F2


capacity: celkova kapacita v KB
          a pocet slotu
          adresare.

format:   pocet stran, stopy/
          sektory na stopu,
          celkovy pocet sektoru.

sectors:
  system   sektory 0-13 (boot,
           FAT, adresar)
  pad/bad  zalomeni FAT / vadne
           sektory
  used     sektory obsazene
           soubory
  free     volne sektory

directory:
  pocty podle typu (P,B,N,
  C,S,Q a ostatni)
  pocty skrytych, jen-pro-cteni
  a systemovych souboru
  sloty pouzite / sloty volne
  (smazane soubory se pocitaji
  jako volne; slot je "smazany"
  pokud byte 0 je $E5 ale
  zbytek zaznamu zustava)

bytes used / bytes free:
  celkova obsazenost a volnost
  datove oblasti v bajtech.

================================
CHYBOVA HLASENI
================================
Not a D80/D40 image
  Soubor neobsahuje platny
  podpis MDOS "SDOS".

File read/write error
  Chyba I/O pri cteni nebo
  zapisu obrazu ci vystupniho
  souboru.

Only extensions d80/d40 allowed
  Byla zadana jina pripona nez
  .D80 nebo .D40 (bez prepinace
  -d).

Only D80 extension expected
  Prepinac -c vyzaduje .D80.

DIR extension expected
  Pri pouziti -d byla zadana
  nepripustna pripona (.D80
  nebo .D40).

File NAME.EXT not found
  Soubor obrazu neexistuje.

Invalid switch
  Neznamy prepinac za pomlckou.

================================
POZNAMKY
================================

- Prepinace lze kombinovat,
  .D80 -n -d IMAGE.D40
  (vypis do souboru, bez dotazu
  Scroll?).

- Prepinace -x a -d lze
  kombinovat: exportuje soubory
  a ulozi vypis adresare
  do souboru.

- Verze MDOS je detekovana u
  MDOS 2.1/2.2.

- Starsi MDOSy vetsinou nemaji
  diskety oznaceny nazvem.

================================
KONEC MANUALU
================================
