If the destination filename is not given, it's based on the source name, with the .zip extension removed and .st prefix added. If basename tool is present, file is saved to current directory, otherwise to the directory where the source directory/archive is.
Any single directories (other than 'auto') within the source zip / directory hierarchy are traversed down, to avoid adding redundant intermediate directories to the generated disk image.
The .st disk image is a raw disk image, and can be written to a floppy using dd(1), or converted to a .msa disk image with hmsa(1).
The contents of the uncompressed zip file needs to be smaller than 2.88MB (the largest floppy image size supported by Hatari).
If the source file names are longer than 8+3, use atari-convert-dir script to convert them into Atari compatible ones. If the files are within a .zip archive, you need to extract them before conversion.
This manual page was written by Teemu Hukkanen <tjhukkan at iki.fi> for the Debian project and later modified by Eero Tamminen to suit the latest version of Hatari.