OS/2 Shareware BBS: 8 Other/08-Other.zip/vmac192.zip/vMac.INF

OS/2 Help File | 1998-03-29 | 20KB | 414 lines

ΓòÉΓòÉΓòÉ 1. End User License Agreement ΓòÉΓòÉΓòÉ

vMac Group

License for vMac software

PLEASE READ THIS SOFTWARE LICENSE AGREEMENT "LICENSE" CAREFULLY BEFORE
DOWNLOADING THE SOFTWARE.  BY DOWNLOADING THE SOFTWARE, YOU ARE AGREEING TO BE
BOUND BY THE TERMS OF THIS LICENSE.  IF YOU DO NOT AGREE TO THE TERMS OF THIS
LICENSE, YOU ARE NOT AUTHORIZED TO DOWNLOAD THIS SOFTWARE.

vMac Terms:

1. License.  The software and data accompanying this License whether on disk,
or on any other media (the vMac Software) are licensed, not sold, to you by the
vMac Group (The vMac group being members of the vMac development or support
team.  A list of people is available apon request.). You own the media on which
the vMac Software is recorded but the vMac Group and/or vMac Group's
licensor(s) retain title to the vMac Software.

2. Permitted Uses and Restrictions.  This License allows you to install and use
the vMac Software, provided that the software's distribution archive's contents
are on each machine vMac is used on. Your rights under this License will
terminate automatically without notice from the vMac Group if you fail to
comply with any term(s) of this License.

3. Distribution.  You may not charge money (excluding distribution costs) for
the vMac software. vMac, is a free application, and can be distributed freely
as long as all original and unmodified files are in the archive are included.
It my not be distributed along with any Macintosh ROM in any form, or any other
copyrighted material.

4. Disclaimer of Warranty on vMac Software.  You expressly acknowledge and
agree that use of the vMac Software is at your sole risk.  The vMac Software is
provided AS IS and without warranty of any kind and the vMac Group EXPRESSLY
DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
VMAC GROUP DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE VMAC SOFTWARE
WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE VMAC SOFTWARE WILL BE
UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE VMAC SOFTWARE WILL BE
CORRECTED. FURTHERMORE, VMAC DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS
REGARDING THE USE OR THE RESULTS OF THE USE OF THE VMAC SOFTWARE OR RELATED
DOCUMENTATION IN TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY, OR
OTHERWISE.  NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY VMAC OR A VMAC
GROUP MEMBER SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS
WARRANTY.  SHOULD THE VMAC SOFTWARE PROVE DEFECTIVE, YOU (AND NOT VMAC OR VMAC
GROUP MEMBER) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED
WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU.

5. Limitation of Liability.  UNDER NO CIRCUMSTANCES, INCLUDING NEGLIGENCE,
SHALL VMAC BE LIABLE FOR ANY INCIDENTAL, SPECIAL, INDIRECT OR CONSEQUENTIAL
DAMAGES, OR LEGAL ACTION ARISING OUT OF, RELATING TO THIS LICENSE, OR USE OF
THE VMAC SOFTWARE IN VIOLATING OTHER COPYRIGHTS OR PATENTS. SOME JURISDICTIONS
DO NOT ALLOW THE LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THIS
LIMITATION MAY NOT APPLY TO YOU.  In no event shall the vMac Groups' total
liability to you for all damages exceed the amount paid to the vMac Group for
this License to the vMac Software.

6. Export Law Assurances.  You agree that the vMac Software will not be
exported outside the United States except as authorized by United States law.
You also agree that vMac Software that has been rightfully obtained outside of
the United States shall not be re-exported except as authorized by the laws of
the United States and of the jurisdiction in which the vMac Software was
obtained.

8. Controlling Law and Severability.  This License shall be governed by the
laws of the United States. If for any reason a court of competent jurisdiction
finds any provision, or portion thereof, to be unenforceable, the remainder of
this License shall continue in full force and effect.

9. Association.  The vMac Team has no affiliations with Apple Computer
Corporation, nor claims to.  The vMac Group will not be held responsible for
any illegal ROM file distribution, Illegal MacOS use, or any illegal act
committed with or to use the vMac Software.

10. Apple Provisions.  The following is provided as a CURTISY AND MAY NOT BE
VALID OR ACURATE IN ANYWAY.  FOR INFORMATION ON THE USE OF APPLE'S SOFTWARE,
REFFER TO APPLE'S LISCENCE AGREEMENT.  To use vMac legally, you must have your
own physical Macintosh ROM Chip.  You may not use the physical ROM and the ROM
image at the same time. "Using" a ROM is defined as having the machine turned
on, or the vMac product running on a machine.

11. Complete Agreement.  This License constitutes the entire agreement between
the parties with respect to the use of the vMac Software and supersedes all
prior or contemporaneous understandings regarding such subject matter.  No
amendment to or modification of this License will be binding unless in writing
and signed by the vMac Group.


ΓòÉΓòÉΓòÉ 2. Start Here ΓòÉΓòÉΓòÉ

vMac for OS/2 README

Port by:

     David Bacher ([e-mail])
     Marcus Childs ([e-mail])

 README by:

     Ray Ruvinskiy ([e-mail], [e-mail])

 NOTE: Using this software shows your acceptance to the End User License
 Agreement (EULA.TXT) which was shown to you before downloading vMac. If you
 have not read or accepted it, you are not entitled to use this software!!!

 Please read the End User License Agreement (EULA.TXT) and make sure you
 understand it and accept its terms. If you don't accept vMac's End User
 License Agreement, please delete vMac from your machine.

     End User License Agreement (EULA.TXT)


ΓòÉΓòÉΓòÉ 3. Brief Introduction to vMac for OS/2 ΓòÉΓòÉΓòÉ

What is vMac? vMac is a free software emulator that emulates the Apple
Macintosh Plus(tm). That means that vMac does not cost anything, and does not
use any hardware. A lot of the Macintosh Plus' functionality is already
implemented in this port, and that includes:

     68000 CPU, 68010 CPU, 68020 CPU + 68881 FPU emulation
     4 MB of RAM
     Keyboard support
     Mouse support
     Floppy drive support
     HardDrive support (vMac can now mount all HFS media; however, vMac will
      treat all media as floppy disks)
     Can run MacOS (System Software) versions up to 7.5.5

 Currently, work is being done on IceCube, a new CPU emulator that would
 replace UAE's CPU emulator which we use currently, Hard Disk suppport, and
 other stuff.

 The system requirements for vMac are:

     OS/2 Warp 3.0 revision 17 *required* or newer
     OS/2 Warp 4.0 highly recommended
     80486 with a 80487 FPU
     A Video card with support for DIVE
     A Pentium 133 recommended
     A minimum of 8 MB of RAM
     16 MB of RAM recommended
     Mouse
     About 3 - 4 MB of harddrive space for minimum install (vMac + ROM file +
      disk image)
     15 - 20 MB of harddrive space recommended (You do want to use some Mac
      software with vMac, right?)


ΓòÉΓòÉΓòÉ 4. Getting vMac for OS/2 ΓòÉΓòÉΓòÉ

vMac's homepage is at http://www.vMac.org. If that doesn't work, try
http://leb.net/vmac. If *that* doesn't work, try again another day, the site is
probably down :\. Click on the Download link, fill a few blanks and download
vMac. If you are reading this, however, you have probably already downloaded
vMac. This section is here just in case...


ΓòÉΓòÉΓòÉ 5. Installing vMac for OS/2 ΓòÉΓòÉΓòÉ

Important!  Read End User License Agreement (EULA.TXT) before installing or
using vMac for OS/2!

Unzip the file you downloaded into a directory of your choice. You have to have
a ROM in a file taken from a real Macintosh Plus in order to use the emulator.

NOTE: LEGALLY, YOU HAVE THE RIGHT TO USE A MAC ROM _ONLY_ IF YOU OWN A REAL MAC
PLUS. ALSO, YOU MUSTN'T USE YOUR REAL MAC AND HAVE vMac RUNNING AT THE SAME
TIME.

If you do not have a ROM in a file, and you do own a real Macintosh Plus, read
the file vmac_rom.txt.

You also need a System Software disk image. System 6.0.8, System 7.0, and
System 7.0.1 are distributed freely and can be downloaded from Apple's FTP site
(ftp://ftp.apple.com), or the vMac Application Site (VAS -
http://www.hostus.com/vas). A considerably large selection of Macintosh
applications and games can also be found on VAS.

Once you've got your ROM and MacOS disk image, edit vMac.cfg and modify it to
suite your system (and desires). All options are self explanatory. For example:
to boot off Disk1.dsk put "Disk1.dsk" (without the quotes) beside DrivePath1=.

To boot off a real floppy put "A:" besides DrivePath1 (if your HFS formatted
floppy is in drive A:, and you want to mount it as the first disk in vMac).

To mount an HFS formatted HDD or any other media put the drive letter that
corresponds to that media in OS/2 besides "DrivePathx".


ΓòÉΓòÉΓòÉ 6. Running vMac for OS/2 ΓòÉΓòÉΓòÉ

There are four binaries:

     vmac.exe for vMac with a 68000 CPU
     vmac010 for vMac with a 68010 CPU
     vmac020.exe for vMac with a 68020 CPU
     vmac881.exe for vMac with a 68020 CPU + 68881 FPU.

 In the examples in this README we will always use "vmac". Note, however, that
 you can always substitute "vmac" with of the above mentioned filenames.

 Launch vMac (by typing "vmac") and if everything is alright, vMac should boot
 within a minute. Voila, you can run Macintosh software on your PC.


ΓòÉΓòÉΓòÉ 7. While vMac is running... ΓòÉΓòÉΓòÉ

The default keyboard mappings:

     Alt   : This key emulates the Command [or Pretzel] key on the Mac.
     Ctrl   : This key emulates the Option key on the Mac.
     Shift  : This key emulates the Shift key on the Mac.
     CapsLock: This key emulates the CapsLock key on the Mac.
     Keypad  : The gray keypad emulates the Macintosh Plus keypad. The regular
      [white] keypad acts like under Num-Lock.

 The default toolbar:

     Setup  : Open the vMac Preferences Notebook
     Drive 1 : Insert a disk or image into drive 1.
     Drive 2 : Insert a disk or image into drive 2.
     Drive 3 : Insert a disk or image into drive 3.
     Drive 4 : Insert a disk or image into drive 4.


ΓòÉΓòÉΓòÉ 8. Troubleshooting vMac for OS/2. ΓòÉΓòÉΓòÉ

Troubleshooting is divided into two sections:

     General Troubleshooting
     OS/2 Troubleshooting


ΓòÉΓòÉΓòÉ 8.1. General Troubleshooting ΓòÉΓòÉΓòÉ

This section currently deals with very elementary stuff. Hopefully (or then
again, maybe not) it will be expanded in the future.

     When vMac starts, a floppy with a question mark on it appears - the Mac
      can't find your disk image/parition/floppy. Double check the path.


     When vMac starts, a floppy with an X on it appears - the Mac can't boot
      off your floppy/disk image/partition.


     It takes longer for vMac to boot when I run it with 4 MB RAM than when I
      run it with 1 MB of RAM - this is natural. It takes time to check for all
      that RAM. In this version, however, you can disable the memory in
      vMac.cfg.


     MacOS 7.6 and higher won't boot! - MacOS version 7.6 and higher don't
      even work on a real Macintosh Plus. Downgrade...


     vMac is running incredibly slowly with MacOS x.x.x - You might have a
      slow machine. You might try to remove extensions and control panels from
      System Folder:Extensions and/or System Folder:Control Panels. You might
      not have enough RAM on your machine. You might want to try to downgrade
      your MacOS version. You may want to try using the 68000 binary if you're
      using the 68020 one. You may want to try to increase the frame rate
      (video quality will be worse though).


     When I try to boot System 7 or higher, the Mac writes something like "You
      need more RAM to boot this version of the System Software" - tell vMac to
      emulate more RAM.


     The System 7.0.1/System 7.1 disk image I downloaded from VAS doesn't work
      - Some people have problems downloading from VAS. Try downloading a
      couple of times. If you still don't succeed, there's nothing we can do,
      so stop e-mailing the port authors about it! :-)
 If none of these answers your question, try the

 OS/2 Troubleshooting section, and then contact the port author.


ΓòÉΓòÉΓòÉ 8.2. OS/2 Troubleshooting ΓòÉΓòÉΓòÉ

     Do I need EMXRT.DLL or a similar file to run vMac for OS/2?

      No.  vMac is compiled with IBM VisualAge for C++, and is self contained.
      You will need to install the Multimedia Support in OS/2, however, for
      this release.


     What versions of OS/2 is vMac compatible with?

      Version 3.0 Fixpack 17 or newer, and all Version 4 systems are supported.
      You must have Multimedia Support installed, however.


     Where is vMac.cfg located?  It doesn't seem to take effect when I change
      the one in the vMac directory.

      Do to changes in the X-Windows version, from which this version is
      derived, the vMac.cfg file is now stored in your home directory, if it is
      defined.  The home directory (in OS/2) can be set by typing "SET
      HOME=<directory" in Config.Sys. If a home directory is not defined, vMac
      will store the file in the current directory.


     How do I mount a real 3.5" disk?

      Insert the disk into drive A.  In vMac, make sure that one of the three
      floppy drives is available, and then click on its Icon.  A window will
      appear with two radio buttons -- choose Disk Drive, and make sure the
      edit box says A:\. Click on OK.  You can mount any disk drive this way.
      vMac can not currently format floppies because it thinks that the disk
      drive is an 800k drive.


     How do I mount an IoMega Zip 100, Jaz 1g, Jaz 2g or Syquest EzDrive
      cartridge?

      See instructions for mounting a floppy.  Use the drive letter of your
      drive instead of A.


     The mouse seems kinda slow, and the keyboard lags behind a little.

      Due to how we had to do the code to prevent OS/2 4 from believing that
      vMac had locked the system on slow machines, this minor annoyance must
      just be tolerated. We are working on it.  The mouse is "polled" 60 times
      a second.


     What happened to the Skip Frames if Behind box?

      The code always skips frames when it falls behind now.  The option was
      removed.


     What happened to the Vertical Blank Rate box?

      The code sends *EXACTLY* sixty blanks per second now.  The code evenly
      spaces these over the course of a second.  If you don't want 60 screen
      redraws, use the Frame Rate option on the Performance tab.


     The splash screen window is way too big for the image...

      Run at 640 x 480.  We're working on it, but at the moment I'm expecting a
      new C compiler any day, and want to postpone fixing the code until it
      arrives.  It only effects the splash screen, so it's sorta a low
      priority.


     The new version seems alot faster.

      We changed C compilers from Watcom to IBM Visual Age for C++.  Watcom had
      gained us a significant improvement over EMX, and IBM's gained us a 50%
      improvement over Watcom.  If you're running an AMD K6 200, you should
      score over three times a Mac Plus.To get help with any other problem,
      e-mail the port author.


     There is a vMac.INI in my home directory, what does it hold?

      vMac.ini is used to contain the user defined toolbars and other data.  If
      you are running OS/2 Warp 4 with Fixpack 3 or newer, you can use RegEdit2
      to look at the file, but there isn't anything in it (yet) that makes any
      sense to look at.  If you delete the file, your toolbar will be reset to
      the default.


ΓòÉΓòÉΓòÉ 9. How to help vMac for OS/2 ΓòÉΓòÉΓòÉ

If you'd like to help, please e-mail the port author you want to help to. The
e-mail addresses of porters are located on vMac's site (http://www.vMac.org),
in the Port Roster. We appreciate all help we can get so if you are
able/willing to donate some of your time, we'll probably find something for you
to do.


ΓòÉΓòÉΓòÉ 10. vMac for OS/2 toolbars ΓòÉΓòÉΓòÉ

vMac for OS/2 uses the IBM UCMenus package to drive the toolbar.  If you use
the Enhanced Editor (EPM) or Internet Adventurer, you are already familiar with
this toolbar and how it works.

This reference details the commands that are available within the toolbar
system.  These are the only commands that have code associated with them, and
therefore you should use only these commands when creating buttons.

     Cmd: Setup

      Display the vMac Preferences Tabbed dialog box.  OS/2 Warp 3 will show
      this as a notebook control on many systems.


     Cmd: Disk 1, Cmd: Disk 2, Cmd: Disk 3, Cmd: Disk 4

      Insert a disk or image specified by the user when the button is clicked.
      The number on the command determines which disk drive will be used.


     Cmd: Image 1, Cmd: Image 2, Cmd: Image 3, Cmd: Image 4

      Insert a disk or image specified in Parameters when the button is
      clicked.  The number on the command determines which disk drive will be
      used.  This will not prompt the user at all, and will insert a
      predetermined disk into the drive.

      Example:

      "Cmd: Image 1" and Parameters are "a:\".  vMac will, when the button is
      clicked, mount a: as drive 1.