DOCS: adds Atari/FreeMiNT page

doc/docportal/other_platforms/atari.rst

@@ -0,0 +1,73 @@
+=============================
+Atari/FreeMiNT
+=============================
+
+Install ScummVM
+===================
+
+Prerequisites
+****************
+
+- A powerful Atari system or clone; minimum CPU 68060. 
+- FreeMiNT, TOS or MagiC.
+
+Download and install ScummVM
+*********************************
+
+A binary package is provided for the m68000 CPU, one for the m68020 to m68060 range of CPUs, and one for the Coldfire (FireBee) CPU. All are available for download from the ScummVM `Downloads page <https://www.scummvm.org/downloads>`_.  To install ScummVM, extract the selected ScummVM archive into a folder on the hard disk.
+
+Run ``scummvm.gtp`` to start Scummvm.  The ``scummvm.gtp`` command will take :doc:`command line options <../advanced_topics/command_line>` to set parameters for the ScummVM session. 
+
+To run ScummVM from a FreeMiNT Command Line Interface, make the program executable with the following command:  
+    
+    chmod +x scummvm.gtp
+
+For the best performance, run ScummVM under FreeMiNT, from the command line, and without the AES started. 
+
+Transfer game files
+=======================
+
+Transfer files to the Atari as you normally would, such as through a network connection or by optical disc. 
+
+Controls
+=================
+
+Controls can be manually configured in the :doc:`Keymaps tab <../settings/keymaps>`.
+
+See the :doc:`../using_scummvm/keyboard_shortcuts` page for common keyboard shortcuts. 
+
+
+Paths 
+=======
+
+FreeMiNT
+***************
+Saved games and the configuration file are found in the user’s defined home directory. 
+
+MagiC/TOS
+***************
+Saved games and the configuration file are found in the ScummVM installation directory.
+
+
+
+Settings
+==========
+
+For more information, see the Settings section of the documentation. Only platform-specific differences are listed here. 
+
+Graphics
+************
+
+For video rendering, define the variable ``SDL_VIDEODRIVER=XBIOS`` in your environmental variables. Either XBIOS or GEM might be set by default. XBIOS works better than GEM, since GEM rendering seems to be slower. Note that this is not a ScummVM setting, but rather a system-wide setting. 
+
+
+Known issues
+==============
+
+- There is no Cloud/LAN functionality.
+
+- The native MIDI driver (STMIDI) does not work. This is due to an issue with SDL timers not functioning properly from the Atari version of SDL 1.2.
+
+- While support for ``.FLAC``, ``.OGG`` and ``.MP3`` audio formats is available in the Atari port of ScummVM, these decoding libraries are extremely CPU intensive and greatly slow down the user experience.  ScummVM is best run with uncompressed audio, when available.
+
+- While all supported engines are included in the Atari ScummVM release, not all games will run well due to the lack of resources.  For example, the Curse of Monkey Island will run on a CT60-equipped Atari Falcon, but very poorly.