%format latexg

\documentstyle[din_a4,german]{article}

\title{Backward II}
\author{Cyrille Dupuydauby}
\date{V 2.64, July 1994}

\begin{document}
\maketitle
This document provides information about installation procedure and use of Backward
as well as some hints and tips.
\section{Foreword}
This program is Shareware, which means you are supposed to send a donation
to its author if you intend to use it on a regular basis. More information
about registering will be found later in this text.

Backward II is a program which is supposed to increase the amount of ATARI ST
softwares which can be run on ATARI Falcon 030. No guarantee is given
that it could fullfill any specific goal or purpose.
This program works at a very low level, so a crash may occur. I deny any
responsability for any loss of data, hardware damage or any other trouble
that may be caused by this piece of software.

I deny also any responsability for problems which may occur with programs from other authors
that may be distributed with the Backward kit.

Commercial use of this kit are forbidden, but fees can be charged for mailing and duplication
costs. It can be distributed as long as it is not altered in any way (altering,
adding or removing files).

\section{Introduction}
Welcome aboard Backward II kit. This document deals specifically with
Backward main program. Information about other included programs may be found
in various text file included with them.

Backward II is an ATARI ST ehancer for ATARI Falcon 030, which means it is supposed
to help you running ST programs on your Falcon. Backward needs a at least a four megs
Falcon. Having a hard disk is not required.

\subsection{Inventory}
The Backward package consists at least of :
\begin{itemize}
	\item DOC\_ENG.TEX, this english documentation in TEX format.
	\item BACKWARD.APP, the main program file.
	\item BCKWUSA.RSC, its ressource file.
	\item DOC\_ENG.TXT, this documentation in ASCII format.
	\item various DOC\_???.TEX, DOC\_???.TXT, BCKW???.RSC files which are the same as above
	      but in other languages.
\end{itemize}
Registered user will also find :
\begin{itemize}
	\item BACKWARD.INF, the configuration file.
	\item BACKWARD.DAT, a Backward library file.
\end{itemize}
\subsection{Installation procedure}
Just copy the BACKWARD.II directory where you want. Double-click on BACKWARD.APP, now
you can use it. Backward runs in any video mode, but some dialog boxes may be too large 
for 40 colons mode. Suggested video mode is 640*400(or 480)*16 colors.

The front-end program should work with any TSRs programs (like NVDI, WinniX,
GemRam etc.); the ehancer should work also fine, but they may be conflicts
with 68030 aware TSRs (like Outside, Vram etc.). The front-end program
works fine under Multitos, but the ehancer does not.

\subsection{General use}
This section gives some general ideas about the use of Backward. Detailed information about
menu entries, set-up page etc.\ will be found in other sections.

Backward II is a GEM-based application. There are windows, dialog boxes, menus, mouse cursor etc.
Information about GEM will be found in ATARI's documentation. This document supposes that the user
is used to GEM concepts such as double-clicks, pull-down menus, radio-buttons etc.

Like many ehancers, the use of Backward II is a three steps operation:
\begin{enumerate}
	\item You run the front-end program (BACKWARD.APP) to set-up the ehancer part.
	\item You install the ehancer itself.
	\item The ehancer is now resident, and some keys allow you to change set-up in real-time.
\end{enumerate}
The front-end program allows you to alter ehancer's set-up, but it also allows you to store
predefined set-ups that are specific to a program.

They are two installation procedures : with or without reboot.

Finally, when Backward is running, some key short-cuts allow you to alter the current
set-up in a real-time fashion.

\section{How to use Backward}
Backward II works with a user-friendly interface, which eventually
allows to use it without reading this document. But reading it ensures you
to take the best from Backward.
\subsection{Menu Entries}
Here is a list of all menu entries. Some menu entries have keyboard short-cuts, which
means that pressing some keys have exactly the same effect than selecting this entry. Those
keys are printed in menus just after the entry text (e.g. `Reboot ! [RETURN]').
\subsubsection{BACKWARD menu}
	\begin{itemize}
		\item About... This entry displays a dialog box
		with general information about Backward.
	\end{itemize}
\subsubsection{File menu}
Here stands entries for installing, quitting and
	saving preferences.
	\begin{itemize}
		\item Makes resident !: This entry allow you to install
		Backward (i.e. ehance a ST) without rebooting. If you
		select this entry, you will be asked to confirm your
		decision; then (if you are positive) you will return to
		the Desktop and will be able to run ST programs\footnote
		{Some ehancer options (such as memory size) are uneffective
		with this installation mode.}. This mode will be called `resident mode'.
	
		\item Reboot !: This entry selects the other installation
		routine. After selecting this entry, you will be asked
		to confirm your decision and if you are positive, your
		computer will reboot\footnote{
		Be sure to save any data you may be working on before
		selecting this entry !}. This mode will be called `boot mode'.
		If Backward II can not recognize
		your ROMs, please take a look at the `Unknown ROMs' section.
		
		
		\item Save Defaults : To save general options and current ehancer set-up as
		the default ones.
		
		\item Quit : Let you back to the Desktop without installing
		the ST ehancer.
		
	\end{itemize}
\subsubsection{Library menu}
Here stands various entries for library handling.
	\begin{itemize}
		\item Add Disk... this is for adding a Disk in library. What Backward
		calls a disk is simply a named set-up that may be linked to a floppy disk.
	
		After selecting this entry, you will be prompted to enter a name. You can
		enter up to 32 characters. Then Backward II will attempt to read a floppy disk
		in drive A.
		
		If the disk is present, the program will compute some keys. It
		would be able this way to recognize this disk in the future and to select the
		associated set-up (see Rescan Disk).
		
		If no disk is present or there is a read error,
		an alert box pops up, which proposes to retry access, cancel operation or ignore
		this error. If you ignore this error, this named set-up will not have the computed
		keys and can not be automatically selected.

		The computed keys have to be UNIQUE, which means you can not have two named
		set-ups linked to the same disk. If two different disks have the same keys (which
		is very unlikely), the solution is to make a file-copy of one disk on a new
		formatted disk (see FALCON operation manual).
		
		The set-up's name have to be unique too. If you enter an already used name, the
		operation will be cancelled.
		
		Once you have gone through all steps, the named and the disk keys (if any) will be
		associated with the current ehancer's set-up and added to the library. It will then
		appears as selected in the library window.
		
		Here is an example :
		
		You have found a set-up which allows you to run Dungeon Master, and you would
		like not to have to reenter this set-up each time you would like to play. Enter
		this set-up through the set-up box. Then
		just insert the Dungeon Master disk and select `Add Disk...'. Enter the game name,
		Backward reads the disk and finally Dungeon Master appears in the window. Now save
		your library (with `Save library').
		
		Now, each time you would like to run Dungeon Master, just insert the disk, run
		Backward and select `Reboot !' (because Dungeon Master is an auto-boot game).
		
		And now, another example:
		
		You have Civilization on your hard disk, and as before you have just found
		a good set-up. After having entered the set-up, remove any disk in drive A and
		then select Add disk... The alert box appears, now select Ignore. The Civilization's
		set-up is added to the library, and now you have to save it with `Save library'. From
		now on, each time you would like to play with Civilization, just run Backward and click
		on Civilization before selecting an installation mode (resident or reboot).
		
		\item Delete Disk; with this entry you can remove the selected named set-up from the library.
		
		\item Rescan Disk\footnote{
			A rescan operation is done each time you run Backward. Pressing [CONTROL] at this time
		installs Backward in boot mode if the current disk is in library (try it to understand).
		}; if you select this entry, Backward reads the floppy disk which is in
		drive A (if any) and then compute the disk keys. Then it looks for a named set-up
		which has the same keys and selects it (if any).
		
		Example :
		Let us imagine that you have a Dungeon Master copy and that you
		have added a set-up for it in the library (see `Add disk...'). If you insert
		your Dungeon Master disk in drive A and then you select `Rescan disk', the
		set-up for Dungeon Master will automatically be selected.
		
		\item Save library; it saves the library on disk. If you alter the library
		in any way, the window's title get an `*' to signal it. Be sure to save your
		library before quitting or rebooting, or else your changes will be lost.
		
	\end{itemize}
\subsubsection{Options menu}
Here stands entries for registering, altering the ehancer's set-up
	and some predefined set-up.
	\begin{itemize}
		\item Register... If you are a registered user, you can use the registered version
		if you enter your user name and user key in the dialog box (this informations
		can be found in the REGISTER.TXT file). Wrong entries does not change the kind
		of Backward's version you are using (i.e. if you are using the registered version
		and you made a mistake while entering your name or key, you will stay in the
		registered mode).
		
		Information about your Backward's version may be found in the `About...' box.
		
		\item Configure... This entry gives you access to the ehancer's set-up box,
		 which will be fully explained in another section.
		 
		\item General... This option give you access to some preferences. See below.

	\end{itemize}
	
	After this two entries is a list of predefined set-ups. Selecting of one them simply
	change the current ehancer set-up.
	

\subsection{Ehancer's set up}
All these options may be selected through the set-up dialog box.
Options in italic (like \mbox{\em Memory}) are uneffective in resident mode.

Finally, some of them may be altered after installing the ehancer.
This is done by pressing [Control] +[Alternate] +a numeric keypad key.

\subsubsection{Mc68030 options}
\begin{itemize}
	\item Frequency. ST's frequency is 8Mhz. Some disk loading routines can not cope
	with 16Mhz. Select 8Mhz if your program runs too fast.

	Keys : [(] for 16Mhz, [)] for 8Mhz.
	
	\item Caches. The 68030 has two onboard caches that are not present on a 68000.
	This option allows you to select which caches (if any) are active. Instruction
	cache often causes problems, data cache sometimes.

	Keys : [7] for Instruction cache on, [8] for off.
	[9] for Data cache on, [-] for off.
	
	\item Exceptions' Table. The 68030 allows to move this table anywhere in memory. Backward
	uses it for his own purposes, thus preventing programs from disabling it. I never found
	a case where this option has to be turned off.
	
\end{itemize}
\subsubsection{Hardware options}
\begin{itemize}
	\item Blitter frenquency. Same as for 68030; turning it to 8Mhz just slows the
	computer, it will probably not improve compatibility.

	Keys : [/] for 16Mhz, [*] for 8Mhz.
	
	\item Errors : It is a crucial choice, because it deals with one major cause
	of problems. Hardware accesses (especially to ST's sound processor) have changed
	and ST's programs are not aware of it. This option offers ways to cope with this.
	Most of the time, problems occur with digitized sound or music.
	\begin{itemize}
		\item Left : Nothing is done, if an error occurs, your computer will
		simply crash (two bombs error).
		
		\item Corr. : Stands for corrected; if an illegal hardware access is done,
		Backward redoes the access itself. Efficient but slow. Keeping 68030 at
		16Mhz may be necessary for some games.
		
		\item Spec. :Stands for special. Backward will try to patch the program which
		caused the error in real time; if it can not, just redoes the access. Efficient
		but if the program can not be patched, Backward will try to patch the program
		each time an error occurs (thousand times a second for digitized sound !). So
		if it dramatically slows everything down, select the Corr. option.
		
		\item STmode : Illegal accesses will simply be ignored. Efficient, but
		sounds may be distorted. Use it as a last solution.
	\end{itemize}
	
	\item DMA Sound Int. : STE's digitized sound uses the Timer A interrupt. But the
	Falcon allows to use MFPi7 instead. Another option wich seems to have no reason to
	be changed.
	
	\item \mbox{\em Memory Size} : Some programs get mad when they have too much memory (especially
	old ones).
\end{itemize}

\subsubsection{Other options}
\begin{itemize}
	\item TOS's patches : Does a lot of system patches : screen address, jokers for file
	handling, memory management, Esc codes for colored text and a patch for Blitmode
	call. I have been reported that some games written in BASIC requires to have this
	option off, but never I have encountered such games.
	
	\item Internal Speaker : You can turn it off with this option. Sadly, some games
	turn it on anyway !
	
	\item \mbox{\em Hard Disk Boot} : Most games dislike hard disk. This option is uneffective
	with unknown ROMs (see the specific section in this document).
	
	\item \mbox{\em GEM} : Turning the GEM off frees some memory at boot time (it allows some old
	game to work, even those which refuse to run on some STs or on STE !). You
	cannot have access to the GEM Desktop, but the Minidesk program is used instead (see
	the Minidesk section for further information). This option does not work with unknown
	ROMs.
\end{itemize}

\subsection{General preferences}
For the moment, this box offers two options:
\begin{itemize}
	\item Multiscan : Backward is now able to ehance ST refresh rate more accurately.
			The ST offers two video mode : 50hz (PAL) or 60Hz (NTSC). If you have a TV
			or a RGB monitor, Backward handles this automatically \footnote{You can toggle
			between those video modes by using [Control] [Alternate] [6] short cut.}.
			But this feature is turned off for VGA monitor (which handles only 60Hz) by default. If you have
			a VGA/SVGA monitor which can cope with 50Hz, just select the Multiscan button to
			turn this feature on.
	\item Autoboot : If you turn this option on, Backward will automatically reboot if it recognizes
	the disk in drive at start.
	
\end{itemize}
\subsection{The library}
The library is displayed in a window (titled `Library'). It stores ehancer's set-ups for various
programs. The display is a list of named set-up.

Clicking once selects a set-up as the current one;
double-clicking allow to edit the name and to compute new keys from the disk. Those keys allow
Backward to automatically recognize a disk (see also `Add disk...' and `Rescan Disk'). Be aware
of the fact that you can not edit the name without having the keys recomputed, which means
you need to insert the disk which is linked with this named set-up to avoid loosing the link !

To edit the set-up, just selects it and use the ehancer's set-up box.

Once the library has been altered in any way, the window title is changed to `* Library'
to signal the change. If you save the library, the title goes back to `Library'.

The library window acts like any window : you can move and resize it. Arrow buttons and lifts
allow to change the part of the list which is displayed. Pressing a letter key changes the
displayed part to the one which contains named set-ups starting with this letter.

The window's info bar displays the name of the current selected set-up or `No selection.' if
none is selected.

The size of the library allows two thousands (2000) entries for the registered version,
and twenty (20) only for the unregistered one.

\section{Minidesk manual}
If you boot with GEM off, you can not have access to the GEM desktop. But Minidesk is provided
instead. This program allows you to change current drive and directory and to execute programs
on disk.

Minidesk displays a list of directories and executable files. Directories are shown in brackets
(like [AUTO]). The cursor keys allow you to change current selection (displayed in inverse video
mode). Pressing [ENTER] changes the current path if current selection is a directory or
executes the selected file. Letter keys change the current drive ([A] for drive A and so on).

\section{Unknown ROMs}
Backward checks your TOS version and displays a `Unknown ROMs ' alert box if it can not
be recognized. If you are in such a case, Backward will be a little less efficient.

GEM can not be turned off. Under GEM desktop, caches are both active or inactive.
Finally, turning off Hard Disk must be done manually at boot time by pressing the
[ALTERNATE] key while the hard disk is booting (this operation is explained
in the Falcon manual).

WARNING, you must remove any disk that may be in drive A when rebooting. You will
be asked to insert your disk once Backward will be installed.

\section{Tips}
Or how to choose a set up. First of all try your program whith Best Compatibility set-up
 (F1 key) and if your program uses GEM (i.e has standard windows, menus ...) , turn GEM on
 (it is off by default for Best Comp.).
 \begin{itemize}
 \item If your program still crash, try again with more memory.
 \item If you are still in trouble, disable Tos Patches.
 \item If nothing works here, you'll have to wait for a new version.
 \end{itemize}
 
 If your program works, you can now try to improve your set-up. You'll just have to
 try altering some options, and if it does not work, get back to your previous set-up.
 \begin{itemize}
 \item If your program has bad sounds, try Special mode (Bus Error Handling). If it does
 no work, try Corrected.
 \item Try 16Mhz for 68030 and/or blitter. If it crashes or runs to fast, go back to 8Mhz.
 \item Try data cache on.
 \item Try instruction cache on (or both).
 \end{itemize}
 
 Finally, take care when altering set-up with key short-cuts. Many programs refuse
 caches when loading and run very well after that, thus you can turn caches on AFTER it
 has loaded. BUT BEWARE, if your program makes disk accesses later (for game saving as an example),
 it may crash ! So take care.\\
 The safetiest change that can be made is video mode with [Control] [Alternate] [6].
 

\section{Messages}
Here is a list of alert boxes that may be displayed by Backward and their explainations.
\begin{itemize}
	\item No RSC found : The ressource file is missing.
	
	\item This is not a Falcon : Sorry, it is not a Falcon ehancer for ST.
	
	\item Not enough memory : Backward needs about 400Kb, so please free
	some memory to start it again.
	
	\item Disk is already in library : Displayed after Backward has
	computed the keys of the disk in drive A. Another disk has the same
	ones. You may redo the operation without disk in drive (see Library menu).
	
	\item Name is already in library : You have tried to enter an already used
	name (see Library menu).
	
	\item Can't read disk : Backward can not compute the disk keys. Maybe your
	disk is corrupted. You can retry, cancel operation or ignore (which means
	your set-up will not be linked to the disk, see Library menu).
	
	\item Library is full : If you are a registerd user, write to me and you
	will receive a copy with more room. If you are not registered, twenty is
	the normal limit; please get registered.
	
	\item Unknwon ROMs : Backward can not recognize your TOS. See Unknown ROMs
	section (TOS 4.01, 4.02 and 4.04 are recognized).
\end{itemize}

\section{Registration}
\subsection{Getting registered}
To be a registered user, send a donation to the following address :

Mr DUPUYDAUBY Cyrille

53 domaine des aigles

60500 Chantilly

FRANCE

Standart donations are 100FF, \$ 20, 30DM... Those donations will be used for user support
and for various fees due to Backward developpment.

\subsection{Registration for Sweden}
I am glad to announce a new Sweedish distributor. Please contact him for more information.

Sven Bornemark Music

Lergodsvagen 79

S-238 40 OXIE
\subsection{User Support}

Registered user receive the latest version and the key for using the registered version, they
also receive the full Backward package which includes a library file, various patchs (for
Interface, A debug and for the desktop) and various tools. I support also a kind of
'Hot line' for questions, remarks and ideas. Registered user will also be advised each time
an update is suggested; update service cost is two HD disks (one for mail charges, and one
which will be sended back).

If you don't want to be a registered user, please use versions 1.xx because they are freeware.

Finally, Backward III (still under work) will be available only to registered users.

\section{Thanks}
Thanks to Sven Bornemark, my new Sweedish distributor, for his kindness and trust.

Thanks to Patrice BENSOUSSAN for his overactive support and his ideas (which have been taken
in account).

Thanks to Peter SEGERDAHL for his patience and his support.

Thanks also to Mathias AGOPIAN whose article about Magi help me a lot at the start (PMMU's tree
location and Blitter frequency control).

Thanks to all my registered users, who give me the courage to improve Backward.



This document was done with TeX.

\end{document}
