Return to readme.previous.txt CVS log

Up to [Previous NeXT emulator] / previous

Annotation of previous/readme.previous.txt, revision 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: 

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