Annotation of previous/readme.previous.txt, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3:                                  Previous 1.3
                      4: 
                      5: 
                      6:                     http://previous.alternative-system.com/
                      7: 
                      8: 
                      9: Contents:
                     10: ---------
                     11: 1. License
                     12: 2. About Previous
                     13: 3. Compiling and installing
                     14: 4. Known problems
                     15: 5. Running Previous
                     16: 6. Contributors
                     17: 7. Contact
                     18: 
                     19: 
                     20:  1) License
                     21:  ----------
                     22: 
                     23: This program is free software; you can redistribute it and/or modify it under
                     24: the terms of the GNU General Public License as published by the Free Soft-
                     25: ware Foundation; either version 2 of the License, or (at your option) any
                     26: later version.
                     27: 
                     28: This program is distributed in the hope that it will be useful, but WITHOUT ANY
                     29: WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
                     30: FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
                     31: 
                     32: You should have received a copy of the GNU General Public License along with
                     33: this program; if not, write to the
                     34:  Free Software Foundation, Inc.,
                     35:  51 Franklin Street, Fifth Floor, Boston,
                     36:  MA  02110-1301, USA
                     37: 
                     38: 
                     39:  2) About Previous
                     40:  -----------------
                     41: 
                     42: Previous is a NeXT Computer emulator based on the Atari emulator Hatari. It uses
                     43: the latest CPU emulation core from WinUAE. Previous is confirmed to compile and 
                     44: run on Linux, Mac OS X and Windows. It may also work on other Systems which are 
                     45: supported by the SDL library, like FreeBSD, NetBSD and BeOS.
                     46: 
                     47: Previous emulates the following machines:
                     48:  NeXT Computer (original 68030 Cube)
                     49:  NeXTcube
                     50:  NeXTcube Turbo
                     51:  NeXTstation
                     52:  NeXTstation Turbo
                     53:  NeXTstation Color
                     54:  NeXTstation Turbo Color
                     55: 
                     56: 
                     57:  3) Compiling and installing
                     58:  ---------------------------
                     59: 
                     60: For using Previous, you need to have installed the following libraries:
                     61: 
                     62: Required:
                     63: - The SDL library v2.0.3 or later (http://www.libsdl.org)
                     64: - The zlib compression library (http://www.gzip.org/zlib/)
                     65: 
                     66: 
                     67: Don't forget to also install the header files of these libraries for compiling
                     68: Previous (some Linux distributions use separate development packages for these
                     69: header files)!
                     70: 
                     71: For compiling Previous, you need a C compiler (preferably GNU C), and a working
                     72: CMake installation (see http://www.cmake.org/ for details).
                     73: 
                     74: CMake can generate makefiles for various flavors of "Make" (like GNU-Make)
                     75: and various IDEs like Xcode on Mac OS X. To run CMake, you've got to pass the
                     76: path to the sources of Previous as parameter, for example run the following if
                     77: you are in the topmost directory of the Previous source tree:
                     78:        cmake .
                     79: 
                     80: If you're tracking Previous version control, it's preferable to do
                     81: the build in a separate build directory as above would overwrite
                     82: the (non-CMake) Makefiles coming with Previous:
                     83:        mkdir -p build
                     84:        cd build
                     85:        cmake ..
                     86: 
                     87: Have a look at the manual of CMake for other options. Alternatively, you can
                     88: use the "cmake-gui" program to configure the sources with a graphical
                     89: application.
                     90: 
                     91: After cmake finished the configuration successfully, you can compile Previous
                     92: by typing "make". If all works fine, you'll get the executable "Previous" in 
                     93: the src/ subdirectory of the build tree.
                     94: 
                     95: 
                     96:  4) Status
                     97:  ---------
                     98: 
                     99: Previous is still work in progress. Some hardware is not yet emulated:
                    100: CPU            good
                    101: MMU            good
                    102: FPU            good
                    103: DSP            buggy
                    104: DMA            good
                    105: NextBus                missing
                    106: Memory         good
                    107: 2-bit graphics good
                    108: Color graphics good
                    109: RTC            good
                    110: Timers         buggy
                    111: SCSI drive     good
                    112: MO drive       good (single drive)
                    113: Floppy drive   good
                    114: Ethernet       good
                    115: Serial         dummy
                    116: Printer                good
                    117: Sound          partial (no microphone)
                    118: Keyboard       good
                    119: Mouse          good
                    120: ADB            dummy
                    121: Nitro          dummy
                    122: 
                    123: 
                    124: There are remaining problems with the host to emulated machine interface for
                    125: input devices.
                    126: 
                    127: 
                    128:  5) Known issues
                    129:  ---------------
                    130: 
                    131: - Un-emulated hardware may cause problems in certain situations (see above).
                    132: - The MO drive causes problems (mainly hangs) when both drives are used (disabled).
                    133: - Shortcuts do not work properly or overlap with host commands on some platforms.
                    134: - The clock does not tick accurately. Real time clock power-on test may fail
                    135:   sporadically on fast host systems.
                    136: - There is a lot of instability when running Mac OS via Daydream.
                    137: - FPU only works on x86 hosts.
                    138: - Slirp: In certain rare conditions Slirp may crash.
                    139: - Mac OS X: When minimizing and maximizing the application window the mouse
                    140:   gets unlocked and sometimes is clicking is ignored (SDL bug).
                    141: 
                    142: 
                    143:  6) Release notes
                    144:  ----------------
                    145: 
                    146:   Previous v1.0:
                    147:   > Initial release.
                    148: 
                    149:   Previous v1.1:
                    150:   > Adds Turbo chipset emulation.
                    151:   > Improves DSP interrupt handling.
                    152:   > Improves hardclock timing.
                    153: 
                    154:   Previous v1.2:
                    155:   > Adds support for running Mac OS via Daydream.
                    156:   > Improves mouse movement handling.
                    157:   > Adds dummy Nitro emulation.
                    158:   > Improves dummy SCC emulation.
                    159: 
                    160:   Previous v1.3:
                    161:   > Adds Laser Printer emulation.
                    162:   > Introduces option for swapping cmd and alt key.
                    163: 
                    164: 
                    165:  7) Running Previous
                    166:  -------------------
                    167: 
                    168: For running the emulator, you need an image of the boot ROM of the emulated 
                    169: machine.
                    170: 
                    171: While the emulator is running, you can open the configuration menu by
                    172: pressing F12, toggle between fullscreen and windowed mode by pressing F11 
                    173: and initiate a clean shut down by pressing F10 (emulates the power button).
                    174: 
                    175: 
                    176:  8) Contributors
                    177:  ---------------
                    178: 
                    179: Many thanks go to the members of the NeXT International Forums for their
                    180: help. Special thanks go to Gavin Thomas Nicol, Piotr Twarecki, Toni Wilen,
                    181: Michael Bosshard, Thomas Huth, Olivier Galibert, Simon Schubiger,
                    182: Jason Stevens, Vaughan Kaufman and Peter Leonard!
                    183: This emulator would not exist without their help.
                    184: 
                    185: 
                    186:  9) Contact
                    187:  ----------
                    188: 
                    189: If you want to contact the authors of Previous, please have a look at the 
                    190: NeXT International Forums (http://www.nextcomputers.org/forums).
                    191: 
                    192: Visit the project page of Previous for more details:
                    193: 
                    194:  http://previous.alternative-system.com/
                    195: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.