~ubuntu-branches/ubuntu/maverick/vice/maverick

« back to all changes in this revision

Viewing changes to doc/ReadmeMacOSX.txt

  • Committer: Bazaar Package Importer
  • Author(s): Zed Pobre
  • Date: 2005-02-01 11:30:26 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20050201113026-3eyakzsmmheclvjg
Tags: 1.16-1
* New upstream version
* Fixes crash on 64-bit architectures (closes: #287640)
* x128 working again (closes: #286767)
* Works fine with /dev/dsp in use (not in the main changelog, but tested
  on my local machine as working).  Presumably, this also takes care of
  the issue with dsp being held.  I'm not sure if this is because I'm
  testing it on a 2.6 kernel now -- if you are still having problems
  with /dev/dsp, please reopen the bugs. (closes: #152952, #207942)
* Don't kill Makefile.in on clean

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
  __  __          __     _____ ____ _____
 
2
 |  \/  | __ _  __\ \   / /_ _/ ___| ____|
 
3
 | |\/| |/ _` |/ __\ \ / / | | |   |  _|
 
4
 | |  | | (_| | (__ \ V /  | | |___| |___
 
5
 |_|  |_|\__,_|\___| \_/  |___\____|_____|
 
6
 
 
7
 
 
8
IMPORTANT INFORMATION
 
9
_____________________
 
10
 
 
11
There are some special considerations when using VICE on MacOS X I therefor 
 
12
urge you to read through this file before using any of the software installed 
 
13
with this package!
 
14
 
 
15
ABOUT MACVICE
 
16
______________
 
17
 
 
18
The MacVICE application is not a part of the normal VICE package and its only 
 
19
purpose is to make life a bit easier for the average Mac user for further 
 
20
details on MacVICE see the end of this file.
 
21
 
 
22
MAC SPECIFIC ISSUES
 
23
___________________
 
24
You will need X11 installed to use this software.
 
25
 
 
26
The VICE emulators heavily rely on the use of a two-button mouse. Most Mac 
 
27
users do not have this type of mouse, however it is possible for X11 to 
 
28
emulate a two (or three) button mouse. If you are using Apples X11.app go to 
 
29
Preferences... under the X11 menu and select the appropriate option.
 
30
 
 
31
It is not possible to move the files (or the VICE directory itself) to 
 
32
another location.
 
33
 
 
34
The VICE emulators do not have a "normal" menu, instead the (two) menus are
 
35
activated by the left and right mouse-buttons. Important menu options 
 
36
(for x64) would be (LB = Left mouse-button, RB = You guess):
 
37
 
 
38
* LB->Attach Disk Image->Unit #8
 
39
     Attach a disk image
 
40
* RB->Keyboard Settings->Keyboard mapping type->Positional Mapping (US)
 
41
     Make the keyboard act like a c64 keyboard so you can write all the 
 
42
     characters as you would on a regular c64 keyboard, this option might be 
 
43
     especially important on non US keyboards.
 
44
* RB->Drive settings->Enable true drive emulation
 
45
     Disable this option to speed up load time (less compatible)
 
46
 
 
47
MACVICE
 
48
_______
 
49
 
 
50
MacVICE is NOT an emulator and is NOT (yet) connected to the VICE project. 
 
51
MacVICE is simply a launcher for the wonderful emulators produced by the VICE 
 
52
team that allows Mac users to start there emulator sessions in a way more 
 
53
natural for them.
 
54
 
 
55
THE VICE TEAM SHOULD NOT BE BLAMED OR DISCREDITED IN ANY WAY FOR THIS 
 
56
SOFTWARE. NOR SHALL I (Daniel Aarno) RECEIVE ANY CREDIT FOR THE WORK DONE ON 
 
57
THE EMULATORS WHICH IS THE PRODUCT OF THE HARD WORKING VICE TEAM.
 
58
 
 
59
MacVICE is licensed under the Attribution assurance license, see the file 
 
60
LICENSE.txt for more information. The set of VICE emulators are licensed under 
 
61
the GPL see the file GPL.txt for further information.
 
62
 
 
63
Hopefully you will find this piece of software useful, any comments, 
 
64
questions or bug-reports may be sent to: macbishop@users.sf.net.
 
65
 
 
66
Note: Since MacVICE is a quick 'hack' it silently ignores all errors.
 
67
 
 
68
ABOUT THIS BINARY DISTRIBUTION
 
69
______________________________
 
70
 
 
71
This binary distribution of VICE for MacOS X was put together by 
 
72
Daniel Aarno - macbishop@users.sf.net. If you have any questions or comments 
 
73
regarding this binary distribution please send an e-mail to 
 
74
macbishop@users.sf.net with VICE in the subject, if you have questions about 
 
75
VICE in general see the FEEDBACK and README files.
 
76
 
 
77
The binaries are optimized for the MPPC750 (G3) microprocessor.
 
78
 
 
79
INSTALLATION
 
80
------------
 
81
 
 
82
Simply double-click the MacVICE.pkg icon and follow the instructions.