                  DosAcc 2.8 - by Les Kneeling
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     DosAcc is Public Domain. It may not be sold for profit, but may be 
copied and distributed freely on condition that it is not altered in any way, 
and this documentation is supplied with it.

     The files supplied in the package are:

          DOSACC.ACC     The accessory itself
          DOSACC.PRG     Another version which can be run as either an
                         accessory or as a program depending on how you
                         name it (rename it DOSACC.ACC for the accessory mode)
          DAMONO.RSC     The monochrome resource file
          DACOLOUR.RSC   The colour resource file
          DOSACC.SYS     A sample sys file for the NEC P2200
          DOSACC.TXT     This document
          ACP.PRG        The editor for the DOSACC.SYS file
          ACP.RSC        The resource file for ACP
          What does it do?

     DosAcc is intended to provide all of the functions needed in the day to 
day use of an Atari, and to replace the Atari Control Panel. The parts of the 
Atari Control which it is not essential to have memory resident have been 
incorporated into the Alternative Control Panel, which is a standard program. 
My intention was to provide as many facilities as possible in as small a 
space is possible, one aspect of this is that I have not provided functions 
which seem unnecessary to me. Having said this I would obviously like DosAcc 
to be of use to as many people as possible so if you have any suggestions I 
would certainly consider them, I have found this kind of suggestion useful in 
the past.

     An earlier version (1.5) was featured on the ST/Amiga Format cover disk, 
but the code has been completely rewritten since then, although a superficial 
resemblance remains in the dialogs, and many more functions have been 
included in the various versions since then, the most obvious being the user 
defined buttons for sending commands to the printer.

     Version 2.4 was reviewed in ST World, since then a number of new 
facilities have been added - the diskcopy, disk renumber, disk name, and 
multiple file copy/deletes spring to mind, but there may be others I have 
forgotten about.

The full list of functions to date is:

     Activates DESKTOP.INF settings for key click, delay and repeat, bell, 
     printer, mouse double click and colours
     Free menu display
     Free disk space display
     Date display and setting
     Time display and setting - for the system and keyboard-installed clocks
     Current drive display and setting
     Keyclick, bell, and disk write verify flag display and setting
     Computer reset, with safety lock
     Disk format, with standard and extended capacity
     DiskCopy standard or extended format disks
     Query a disk format
     Display and setting of the disk label and serial number
     Display and setting of system printer settings
     Display and setting of printer internal settings
     User-definable buttons for printer setting
     Directory listing for current disk/folder - with wildcard facility
     Display the number of sectors and tracks on a floppy
     Printout of directory in three columns
     Create folder
     Printout of file
     Display file size
     Copy or erase single or multiple files
     Rename a file
     Display and change attributes of file (read only/read write)
     Touch file (set date and time to the current value)

Resources:
~~~~~~~~~~
     Two resource files are supplied with DosAcc 2.8, for colour and 
monochrome and the program will look for the one it wants. If the accessory 
is being used in monochrome and it cannot find the mono resource, it will use 
the colour resource instead. If it cannot find a suitable resource file the 
program renames itself "DOSACC.ACX" to stop the computer trying again.

     Atari computers automatically load the desktop.inf file, if present, 
when they are booted. The settings contained in the file are not implemented 
unless the Control Panel is present. Since DosAcc was intended to be used 
instead of the Control Panel it was necessary to duplicate this function, but 
not all of the settings were deemed necessary. For example, it is unlikely 
that any package which uses the serial port will not have its own way of 
setting it up - so DosAcc does not provide this facility. It does, however, 
read and set up the colour palette, printer, keys, mouse and bell.

     The keyclick, bell and printer settings can be set from DosAcc, but the 
colour palette cannot. The Alternative Control Panel is used to set these 
values, and the desktop is then saved in the normal way. Once this is done 
DosAcc can make use of them.

DosAcc in use
~~~~~~~~~~~~~
     There are two kinds of button on the main dialog - the printer, files 
and disk icons which bring up other dialogs, and the rest which work 
immediately.

Free Memory displays the amount of memory currently free in the computer.

Free Disk is switched off as default. Clicking on the box activates it, it is 
then displayed as white text on a black background, and it remains active 
until the box is clicked on again. The display will show the space remaining 
on the current drive, and is updated when another drive is selected. The 
display is normally turned off because it takes some time to obtain the 
information, especially on a hard disk with the old operating system (up to 
TOS 1.4).

Date and time work in exactly the same way as their counterparts on the 
Control Panel. Click on the box to select it, edit the display (ESC will 
clear it) until the new date or time is shown and hit return to make the 
setting. No other buttons will work until return is hit, incomplete or 
impossible settings will be ignored and the system setting displayed again. 
The keyboard clock will be set as well as the system clock, this is to allow 
for the use of a clock card, it will be necessary to use other software to 
read the clock card to begin with.

     The drive selectors A-F show the state of the system. Drives which are 
available are shown in black on white, drives which are not available are 
shown in light text, and the current drive is shown in white text on black. 
To select another drive, click on the letter. The button with the arrow in it above the drive selectors brings up 
the buttons for drives G-L.

     The A and B buttons have another function if one of the shift buttons is 
held down when they are clicked. The disk in the appropriate drive will be 
checked and the format and serial number displayed in a dialog. From this 
dialog the serial number can be changed to another random number, or a 
diskcopy can be made. The diskcopy will only be available if there is enough 
free memory to hold one side of the disk, which will then be copied in one or 
two passes depending on the number of sides. A graphic will show the progress 
of the copy routines.

     The keyclick and bell icons are shown normally if the keyclick is 
enabled, or inverted, with the word "Off" in it if it is disabled. The 
setting in the desktop.inf file will be the initial state. If you change the 
setting in DosAcc, it can be save using the Save Desktop selection from the 
Desktop menus. The disk write verify icon acts in the same way, but the 
setting cannot be saved.

     The Reset icon is normally inoperative. To use this icon first click on 
the safety lock to remove the protection then click on reset. This is the 
equivalent of switching the computer off and on again. To avoid errors, the 
safety catch will be reset if any other button is clicked.

The disk icon brings up another piece of dialog at the bottom of the box.

     A default setting is built into this so that a double sided disk in 
drive A will be formatted in standard Atari format if you click on Format. 
Any other selection must be made explicitly. Single and double refer to the 
number of sides on the disk. Extended format is ten sectors per track and 
eighty two tracks.

     Bad sectors are not allowed for, if they turn up the routine will stop 
and the disk will be unusable, use the Desktop formatting routine instead 
(and change your brand of disks!). To leave this routine without formatting a 
disk, click on EXIT.

     The printer icon brings up a whole new dialog box. The top six pairs of 
buttons refer to the system settings for the printer, and will reflect the 
settings made in the Desktop.Inf. Changes made by clicking on these buttons 
can be saved using the Save Desktop menu.

     The middle three pairs of buttons are the internal settings of the 
printer and assume an Epson (or NEC P2200) compatible. Of course, it is not 
possible to interrogate the printer to find out what settings it already has 
- so clicking on the Reset button first will make sure that the printer and 
DosAcc agree.

     If a DosAcc.inf file was present when the computer was booted up there 
will be a further group of user defined buttons at the bottom. The example 
provided is for an NEC P2200. This file is created using the companion 
program Alternative Control Panel, see the appropriate documentation for 
further information. The top row are radio buttons, the bottom row are 
independent.

     These settings do not mesh with the other printer settings so caution is 
necessary. For example changing the NLQ typeface on the NEC also resets the 
pitch to 10 cpi - but the button on DosAcc will not reflect this change, in 
this case you would choose the typeface first and then make all the other 
settings afterwards. It is not possible to be more specific than this or to 
make the routine more efficient without reducing the general aspect of these 
buttons. ( I intend to remedy this situation on a later version of DosAcc, so 
an extra seven bytes is provided for each key which are not accessible from 
the current version of the Alternative Control Panel )

Files
~~~~~
Most of the functions in this dialog must have a file selected before they 
can be used. If a folder is selected, the directory of the folder will be 
displayed. If a filename is selected a tick will appear in the display, this 
is used for the multiple copy and multiple erase functions. The presence of 
more than one tick will automatically switch the copy, move and erase 
routines into multiple mode. All ticks are cleared whenever the directory is 
read from the disk, i.e. when a folder is opened or closed or when the disk 
is changed. Shift-clicking on a filename will set all clicks if none are set 
to begin with, or clear all ticks if one or more are clear at the time. The 
total size of the files currently ticked is shown in the top left corner.

     The top display line in the files dialog acts as a general area for 
communication between the user and DosAcc. In the default state it shows the 
current drive/path/wildcard specification for the directory listing, if a 
file has been selected, its name will be shown too.

     To change the wildcards click on the box, the display will change to 
"Wildcards : *.*___________". Edit the default "*.*" to whatever you want - 
say "*.PRG" and hit return. The directory listing will change automatically.

     To the left of this box (in monochrome, above it in colour) is a message 
box which will say "Path:" normally. This has a second use in that if it is 
clicked, it will report the free space on the current drive, this can be 
useful if your are trying to create enough space to copy a file.

     The drive selector at the left hand side is a twin of the one on the 
first dialog box.

     The listing in the largest box is of the files described by the 
drive/path/wildcard specification currently shown in the top line. Folders 
are preceded by the "close box" symbol. The listing can be "paged" up and 
down using the arrows at the bottom left hand corner. Holding down a shift 
button while clicking on the arrows will take the listing to the top or 
bottom, as appropriate.

New - to create a new folder click on New and a dialog box will appear, type 
in the name you want the folder to have and click on Create.

Erase - to erase a file click on the name in the listing then on Erase. If 
more than one file has been ticked an alert will say how many files will be 
deleted. If a file has its attributes set to "Read Only" an error dialog will 
appear and wait for the user to acknowledge.

Print Directory - prints a full listing of the current directory in three 
columns (on the printer). The listing can be interrupted by hitting any key.

Print Text File - dumps a text file to the printer. Make sure the file is 
text, non-ASCII characters can do strange things to your listing. The listing 
will abort if the printer is taken off-line.

Copy - to copy a file - click on the name and then on Copy. The 
drive/path/filename will appear in the top line. Edit this until you have the 
destination drive/path/filename and hit return. If you change your mind at 
this point hit return without changing the name, or if you have messed it up 
hit Esc to clear the display and hit return - in either case nothing happens. 
Finally an alert box will be displayed detailing the source and destination 
drive/path/filenames and you have another chance to cancel or click on OK. 
The date and time stamp of the copy file is the same as that of the original.

     If more than one file is ticked the routine switches into multiple mode. 
In this case it is not possible to rename the files, the path display shows 
"A:\" as a default, this should be edited. The routine can be aborted at this 
stage by hitting ESC to clear the display and hitting RETURN. A dialog box 
appears displaying the number of files to be copied and allows the user to 
quit the routine if required.

     Should there be insufficient room on the target disk, or a problem 
occurs during the copy, an error box is displayed.

     The progress of the copy routine is shown in the top box. Where possible 
the file is copied in one pass, if there is insufficient memory available for 
this the display will show the cumulative total is displayed. In the case of 
multiple copy, the file names are also displayed as they are copied.

     After the multiple copy routine has finished the ticks remain in place. 
The files can then be erased by clicking on the ERASE button. Care is advised 
if this is done, a file which has not been copied because of insufficient 
space on the target disk or an existing file with the attributes set to "Read 
Only" will still have its tick.

Move - this works in exactly the same way as the copy routine

Rename - the file name is shown in an editable box. If you wish to rename it 
type the new one in and then click on the box. The small boxes at the bottom 
of the display have these functions:

     The "close box" closes the current folder and the directory of its 
parent is displayed.

     The boxes NM, DT, SZ and NO select the way that the directory listing is 
sorted. The default is sorting by name, this can be reset by clicking on NM. 
DT means sorting by date (not by time), SZ by size. NO means that the 
directory is not sorted, the filenames are listed in the order that they 
occur, this would show the order that programs in an AUTO folder would be 
executed, for example. The mouse form changes to "bubbles" while the sort is 
taking place since it takes a little time to sort a lot of files.

     The date, time and size are displayed in the next box, click on this box 
and the date and time of the currently selected file will be changed to the 
current date and time (touch). The attributes of the file can be changed by 
clicking on the display box. They will toggle from RO (read only) to RW 
(read/write and back. This box will show FD if the last name that was 
selected was a folder.

     The last box displays "hard disk" if the drive is a hard disk. If the 
drive is a floppy the volume label of the disk will be shown. If there is no 
label "no name" is shown, and the disk can be named by clicking on it to 
bring up a dialog box, type in the name, and click on the name box. Once a 
name is applied to the disk, it cannot be changed.

Exit ... back to the files dialog without changing anything. When the path is 
changed in DosAcc, the default path is changed. This can be useful if a 
program doesn't allow the path to be specified, it is possible that setting 
the path with DosAcc will allow files to be saved in another area. It can 
cause problems, and so DosAcc will display a warning if the path has been 
changed and allows it to be reset before quitting.

                             Alternative Control Panel
                             ~~~~~~~~~~~~~~~~~~~~~~~~~
     The ACP is a normal program, not a desk accessory like the Atari Control 
Panel, I see little value in tying up memory for rarely used functions. There 
are three dialogs in the program, pallete, ports and DosAcc.

Palette
~~~~~~~
     The logic of grouping these settings together is simply that they come 
from the same area of the desktop.inf.

     The colours in the boxes reflect the settings in the desktop.inf. To 
change a colour, click on the box containing the numbers underneath the 
coloured box. The larger sample box will change to the same colour. The 
groups of three arrows can then be used to change the red, green and blue 
elements to be changed. In monochrome, attempting to change either of the 
first two indices will invert the colours.

     The box with the legend "Default", resets the colour pallete to the 
original as contained in the Atari ROM.

     The mouse speed, keyclick and bell settings are self explanatory. The 
initial and delay settings are altered by clicking on the arrows at either 
side. The effects of the settings can be tried out by holding down a key and 
clicking on the boxes at the same time.

Ports
~~~~~
     The boxes on this dialog show the current state of the settings for the 
serial and parallel ports, the settings are the values held in the copy of 
the desktop.inf file currently in memory, clicking on the serial port buttons 
does not change the system setting, but will change the desktop.inf file.

DosAcc
~~~~~~
     The eight sections of the dialog refer to the eight user defined buttons 
on the printer dialog of DosAcc. The left hand section is the legend for the 
button, and the right is the string that will be sent to the printer. The hex 
numbers will be converted into characters for the DosAcc.sys file. There must 
be no unused spaces, any positions left over must be filled with zeros.

     An existing sys file can be loaded by clicking on "Load", an edited or 
newly created file can be saved by clicking on "Save". Desktop.inf

     The settings made in ACP are put into the copy of desktop.inf held in 
the computer memory when the program exits. To save the settings the "Save 
Desktop" setting must be used on the desktop menu.

-------------------------------------------------------------------------

This revision is dated 1st. January 1990, further updates will be available 
from

          Les Kneeling
          38 Francis Avenue
          Ilford
          Essex IG1 1TS

in addition the latest version is always available from the ST Club and ST UK 
PD libraries.

I actively support DosAcc, if you have any queries or problems, please write 
to the above address.
-------------------------------------------------------------------------
Additional info for use with Quick ST:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Although Messrs. Mihocka and Kolenko tested DosAcc 1.5 with Quick ST, the 
combination of the two with programs like First Word Plus corrupts the screen 
when the Fast Gem mode is used.  The current version of DosAcc will avoid 
this as long as the window is not moved.

