ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/README
(Generate patch)

Comparing BasiliskII/README (file contents):
Revision 1.7 by cebix, 1999-10-21T18:29:04Z vs.
Revision 1.31 by cebix, 2002-10-15T16:25:02Z

# Line 1 | Line 1
1  
2 <        Basilisk II, Version 0.8
3 <        A free, portable Mac II emulator
2 >  Basilisk II
3 >  A 68k Macintosh emulator
4  
5 <        Copyright (C) 1997-1999 Christian Bauer et al.
6 <        Freely distributable
5 >  Copyright (C) 1997-2002 Christian Bauer et al.
6  
7  
8   License
# Line 16 | Line 15 | See the file "COPYING" that is included
15   Overview
16   --------
17  
18 < Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires
19 < a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and
20 < distributed under the GNU General Public License.
18 > Basilisk II is an Open Source 68k Macintosh emulator. That is, it enables
19 > you to run 68k MacOS software on you computer, even if you are using a
20 > different operating system. However, you still need a copy of MacOS and
21 > a Macintosh ROM image to use Basilisk II.
22  
23   Basilisk II has currently been ported to the following systems:
24    - BeOS R4 (PowerPC and x86)
25 <  - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x and IRIX 6.5)
25 >  - Unix (tested under Linux, Solaris 2.x, FreeBSD 3.x, NetBSD 1.4.x and
26 >    IRIX 6.5)
27    - AmigaOS 3.x
28    - Windows NT 4.0 (mostly works under Windows 95/98, too)
29 +  - Mac OS X 10.1
30  
31   Some features of Basilisk II:
32    - Emulates either a Mac Classic (which runs MacOS 0.x thru 7.5)
# Line 41 | Line 43 | Some features of Basilisk II:
43    - Serial drivers
44    - SCSI Manager (old-style) emulation
45    - Emulates extended ADB keyboard and 3-button mouse
46 <  - Uses UAE 68k emulation or (under AmigaOS) real 68k processor
46 >  - Uses UAE 68k emulation or (under AmigaOS and NetBSD/m68k) real 68k
47 >    processor
48  
49   The emulator is not yet complete. See the file "TODO" for a list of
50   unimplemented stuff.
# Line 66 | Line 69 | The settings are stored in a text file:
69   BeOS:
70    /boot/home/config/settings/BasiliskII_prefs
71  
72 < Unix:
72 > Unix, Mac OS X:
73    ~/.basilisk_ii_prefs
74  
75   AmigaOS:
# Line 92 | Line 95 | disk <volume description>
95    This item describes one MacOS volume to be mounted by Basilisk II.
96    There can be multiple "disk" lines in the preferences file. Basilisk II
97    can handle hardfiles (byte-per-byte images of HFS volumes in a file on
98 <  the host system) as well as HFS partitions on hard disks etc. (but Basilisk
99 <  II doesn't know about MacOS partition tables; it relies on the host OS to
100 <  handle this). The "volume description" is either the pathname of a hardfile
101 <  or a platform-dependant description of an HFS partition or drive. If the
102 <  volume description starts with an asterisk ("*"), the volume is write
103 <  protected for MacOS (and the "*" is discarded).
98 >  the host system), HFS partitions on hard disks etc., and MacOS-partitioned
99 >  disks (it can only access the first partition, though). The "volume
100 >  description" is either the pathname of a hardfile or a platform-dependant
101 >  description of an HFS partition or drive. If the volume description is
102 >  prefixed by an asterisk ("*"), the volume is write protected for MacOS.
103 >
104 >  Basilisk II can also handle some types of Mac "disk image" files directly,
105 >  as long as they are uncompressed and unencoded.
106  
107    BeOS:
108      To specify an HFS partition, simply specify its path (e.g.
109 <    "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volume, Basilisk II
109 >    "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volumes, Basilisk II
110      will search for and use all available HFS partitions.
111  
112    Unix:
113 <    To specify an HFS partition, simply specify its path (e.g.
114 <    "/dev/sda5").
113 >    To specify an HFS partition, simply specify its path (e.g. "/dev/sda5").
114 >    If you want to access a MacOS-partitioned hard disk or removable volume
115 >    (Jaz, Zip etc.) and your operating system doesn't understand MacOS
116 >    partition tables, you can specify the block device name (e.g. "/dev/sda")
117 >    to access the first HFS partition on the device. Under Linux, if you
118 >    don't specify any volumes, Basilisk II will search /etc/fstab for
119 >    unmounted HFS partitions and use these.
120  
121    AmigaOS:
122      Partitions/drives are specified in the following format:
# Line 144 | Line 154 | extfs <direcory path>
154    This item specifies the root directory for the "Host Directory Tree"
155    file system (the "Unix/BeOS/Amiga/..." icon on the Finder desktop).
156    All objects contained in that directory are accessible by Mac applications.
157 +
158    This feature is only available when File System Manager V1.2 or later
159    is installed on the Mac side. FSM 1.2 is built-in beginning with MacOS 7.6
160    and can be installed as a system extension (downloadable from Apple, look
# Line 183 | Line 194 | scsi0 <SCSI target> ... scsi6 <SCSI targ
194  
195   screen <video mode>
196  
197 <  This item describes the type of video display to be used by Basilisk II.
198 <  If you are using a Mac Classic ROM, the display is always 1-bit 512x342
199 <  and this item is ignored. The format of the "video mode" is platform
200 <  specific.
197 >  This item describes the type of video display to be used by default for
198 >  Basilisk II. If you are using a Mac Classic ROM, the display is always
199 >  1-bit 512x342 and this item is ignored. The format of the "video mode" is
200 >  platform specific.
201  
202    BeOS:
203      The "video mode" is one of the following:
# Line 206 | Line 217 | screen <video mode>
217    Unix:
218      The "video mode" is one of the following:
219        win/<width>/<height>
220 <        Color display in an X11 window of the given size. The color depth
221 <        (8/15/24 bit) depends on the depth of the underlying X11 screen.
222 <        This is the default.
220 >        Color display in an X11 window of the given size. There are several
221 >        resolutions and color depths available. The set of color depths
222 >        depends on the capabilities of the X11 server, the operating system,
223 >        and Basilisk II compile-time options, but 1 bit and the default depth
224 >        of the X11 screen should always be available.
225        dga/<width>/<height>
226          [if Basilisk II was configured with --enable-xf86-dga]
227          Full-screen display using the XFree86 DGA extension. The color depth
# Line 234 | Line 247 | screen <video mode>
247          15-bit truecolor display in a Picasso96 PIP. This requires
248          Picasso96 as well as a PIP-capable graphics card (e.g. Picasso IV).
249        scr/<hexadecimal mode ID>
250 <        8/15/24-bit fullscreen display on a Picasso96 screen with the given
251 <        mode ID. This requires Picasso96. For 15 and 24 bit, the frame buffer
252 <        format must be QuickDraw-compatible (big-endian, xRGB 1:5:5:5 or
253 <        xRGB 8:8:8:8). The screen size will be the default size for that
254 <        mode ID.
250 >        8/15/24-bit fullscreen display on a Picasso96/CyberGraphX screen with
251 >        the given mode ID. This requires Picasso96 or CyberGraphX. For 15 and
252 >        24 bit, the frame buffer format must be QuickDraw-compatible
253 >        (big-endian, xRGB 1:5:5:5 or xRGB 8:8:8:8). The screen size will be
254 >        the default size for that mode ID.
255  
256    Windows:
257      The "video mode" is one of the following:
# Line 272 | Line 285 | screen <video mode>
285      application via Alt-Tab, Basilisk II is put in "snooze" mode (i.e. MacOS
286      is frozen).
287  
288 +  Mac OS X:
289 +    The "video mode" is one of the following:
290 +      win/<width>/<height>
291 +      win/<width>/<height>/<bits per pixel>
292 +        A refreshed (and buffered) [and very slow] Quartz window.
293 +        The default <bits> is 32, which is the only depth currently supported.
294 +      full/<width>/<height>
295 +      full/<width>/<height>/<bits per pixel>
296 +        A CGDirectDisplay full screen mode. <bits> can currently be 8, 16 or 32.
297 +        If not specified, the default is 32. There is currently no way to switch
298 +        between the Mac OS X and Basilisk II display, but Apple-Option-Escape
299 +        instantly and safely terminates the Basilisk II program.
300 +      opengl/<width>/<height>
301 +      opengl/<width>/<height>/<bits per pixel>
302 +        Currently unimplemented, will be a fast windowed mode.
303 +
304   seriala <serial port description>
305  
306    This item describes the serial port to be used as Port A (Modem Port)
# Line 322 | Line 351 | ether <ethernet card description>
351    is not available and this setting is ignored. The "ethernet card description"
352    is a platform-dependant description of an ethernet card.
353  
354 +  General note: To use TCP/IP from MacOS, you should assign a different IP
355 +  address to the MacOS (entered into the MacOS TCP/IP (or MacTCP) control
356 +  panel). Otherwise there will be confusion about which operating system will
357 +  handle incoming packets.
358 +
359    BeOS:
360      It doesn't matter what you give as "ethernet card description", Basilisk II
361      will always use the first Ethernet card it finds as long an an "ether"
362 <    line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net
363 <    net server add-on from SheepShaver, you can only use Ethernet on PowerPC
364 <    machines.
362 >    line exists (e.g. say "ether yes"). Using Ethernet requires the "sheep_net"
363 >    Net Server add-on to be installed. The first time you start Basilisk II
364 >    with Ethernet enabled you will be asked whether it's OK to make the
365 >    necessary changes to your BeOS network configuration to enable sheep_net.
366  
367    Linux:
368      The "ethernet card description" is the name of an Ethernet interface.
369      There are two approaches to networking with Basilisk II:
370 <      1. Direct access to an Ethernet card via the "sheep_net" driver.
371 <         In this case, the "ethernet card description" must be the name
372 <         of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
373 <         driver to be installed and accessible. This approach will allow you
374 <         to run all networking protocols under MacOS (TCP/IP, AppleTalk, IPX
375 <         etc.) but there is no connection between Linux networking and MacOS
376 <         networking. MacOS will only be able to talk to other machines on
377 <         the Ethernet, but not to other networks that your Linux box routes
378 <         (e.g. a second Ethernet or a PPP connection to the Internet).
370 >
371 >      1. Direct access to an Ethernet card via the "sheep_net" kernel module.
372 >         The "ethernet card description" must be the name of a real Ethernet
373 >         card, e.g. "eth0".
374 >
375 >         The sheep_net module is included in the Basilisk II source
376 >         distribution in the directory "src/Unix/Linux/NetDriver". You have
377 >         to compile and install the module yourself:
378 >
379 >           $ su
380 >           [enter root password]
381 >           # make
382 >           # make dev
383 >           [this will create a /dev/sheep_net device node; you should give
384 >            appropriate access rights to the user(s) running Basilisk II]
385 >           # insmod sheep_net.o
386 >
387 >         If you copy the sheep_net.o module to a place where it can be found
388 >         by the kernel module loader ("/lib/modules/<version>/kernel/drivers/net"
389 >         for 2.4 kernels) and add the line
390 >
391 >           alias char-major-10-198 sheep_net
392 >
393 >         to "/etc/modules.conf", the kernel should be able to load the module
394 >         automatically when Basilisk II is started.
395 >
396 >         The sheep_net module will allow you to run all networking protocols
397 >         under MacOS (TCP/IP, AppleTalk, IPX etc.) but there is no connection
398 >         between Linux networking and MacOS networking. MacOS will only be
399 >         able to talk to other machines on the Ethernet, but not to other
400 >         networks that your Linux box routes (e.g. a second Ethernet or a PPP
401 >         connection to the Internet).
402 >
403        2. Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
404           In this case, the "ethernet card description" must be the name
405           of an ethertap interface, e.g. "tap0". It also requires that you
406 <         configure your kernel to enable routing and the ethertap device:
406 >         configure your kernel to enable routing and ethertap support:
407           under "Networking options", enable "Kernel/User netlink socket" and
408           "Netlink device emulation", under "Network device support", activate
409 <         "Ethertap network tap". Next, see /usr/src/linux/Documentation/
410 <         networking/ethertap.txt for information on how to set up /dev/tap*
411 <         device nodes and activate the ethertap interface. Under MacOS,
412 <         select an IP address that is on the virtual network and set the
413 <         default gateway to the IP address of the ethertap interface. This
414 <         approach will let you access all networks that your Linux box has
415 <         access to (especially, if your Linux box has a dial-up Internet
416 <         connection and is configured for IP masquerading, you can access
417 <         the Internet from MacOS). The drawback is that you can only use
418 <         network protocols that Linux can route, so you have to install and
419 <         configure netatalk if you want to use AppleTalk.
409 >         "Ethertap network tap". You also have to modify drivers/net/ethertap.c
410 >         a bit before compiling the new kernel:
411 >
412 >          - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the
413 >            #include lines)
414 >          - comment out the line "dev->flags|=IFF_NOARP;" in ethertap_probe()
415 >
416 >         Next, see /usr/src/linux/Documentation/networking/ethertap.txt for
417 >         information on how to set up /dev/tap* device nodes and activate the
418 >         ethertap interface. Under MacOS, select an IP address that is on the
419 >         virtual network and set the default gateway to the IP address of the
420 >         ethertap interface. This approach will let you access all networks
421 >         that your Linux box has access to (especially, if your Linux box has
422 >         a dial-up Internet connection and is configured for IP masquerading,
423 >         you can access the Internet from MacOS). The drawback is that you
424 >         can only use network protocols that Linux can route, so you have to
425 >         install and configure netatalk if you want to use AppleTalk. Here is
426 >         an example /etc/atalk/atalkd.conf for a LAN:
427 >
428 >           eth0 -seed -phase 2 -net 1 -addr 1.47 -zone "Ethernet"
429 >           tap0 -seed -phase 2 -net 2 -addr 2.47 -zone "Basilisknet"
430 >
431 >         (the "47" is an arbitrary node number). This will set up a zone
432 >         "Ethernet" (net 1) for the Ethernet and a zone "Basilisknet" (net 2)
433 >         for the internal network connection of the ethertap interface.
434 >         MacOS should automatically recognize the nets and zones upon startup.
435 >         If you are in an existing AppleTalk network, you should contact
436 >         your network administrator about the nets and zones you can use
437 >         (instead of the ones given in the example above).
438 >
439 >  FreeBSD:
440 >    The "ethertap" method described above also works under FreeBSD, but since
441 >    no-one has found the time to write a section for this manual, you're on
442 >    your own here...
443  
444    AmigaOS:
445      You have to specify the name of the SANA-II Ethernet device and the device
# Line 366 | Line 448 | ether <ethernet card description>
448      not an Ethernet device, Basilisk II will display a warning message and
449      disable Ethernet networking.
450  
451 +  See the next item for an alternative way to do networking with Basilisk II.
452 +
453 + udptunnel <"true" or "false">
454 +
455 +  Setting this to "true" enables a special network mode in which all network
456 +  packets sent by MacOS are tunnelled over UDP using the host operating
457 +  system's native TCP/IP stack. This can only be used to connect computers
458 +  running Basilisk II (and not, for example, for connecting to the Internet
459 +  or an AppleShare server running on a real Mac), but it is probably the
460 +  easiest way to set up a network between two instances of Basilisk II
461 +  because the UDP tunnelling doesn't require any special kernel modules or
462 +  network add-ons. It relies on IP broadcasting, however, so its range is
463 +  limited. It should be fine though for doing a little file sharing or
464 +  playing Spectre.
465 +
466 + udpport <IP port number>
467 +
468 +  This item specifies the IP port number to use for the "UDP Tunnel" mode.
469 +  The default is 6066.
470 +
471   rom <ROM file path>
472  
473    This item specifies the file name of the Mac ROM file to be used by
# Line 394 | Line 496 | frameskip <frames to skip>
496    For refreshed graphics modes (usually window modes), this specifies
497    how many frames to skip after drawing one frame. Higher values make
498    the video display more responsive but require more processing power.
499 <  The default is "8".
499 >  The default is "8". Under Unix/X11, a value of "0" selects a "dynamic"
500 >  update mode that cuts the display into rectangles and updates each
501 >  rectangle individually, depending on display changes.
502  
503   modelid <MacOS model ID>
504  
505 <  Specifies the Model ID that Basilisk II should report to MacOS.
506 <  The default is "5" which corresponds to a Mac IIci. If you want to
507 <  run MacOS 8, you have to set this to "14" (Quadra 900). Other values
508 <  are not officially supported and may result in crashes. MacOS versions
509 <  earlier than 7.5 may only run with the Model ID set to "5". If you are
510 <  using a Mac Classic ROM, the model is always "Mac Classic" and this
511 <  setting is ignored.
505 >  Specifies the Macintosh model ID that Basilisk II should report to MacOS.
506 >  The default is "5" which corresponds to a Mac IIci. If you want to run
507 >  MacOS 8, you have to set this to "14" (Quadra 900). Other values are not
508 >  officially supported and may result in crashes. MacOS versions earlier
509 >  than 7.5 may only run with the Model ID set to "5". If you are using a Mac
510 >  Classic ROM, the model is always "Mac Classic" and this setting is
511 >  ignored.
512  
513   nosound <"true" or "false">
514  
# Line 456 | Line 560 | Unix:
560      is /usr/local/share/BasiliskII/fbdevices. A sample file is included
561      with Basilisk II.
562  
563 +  mousewheelmode <mode>
564 +
565 +    If you have a mouse with a wheel, this option specifies whether moving
566 +    the wheel will be reported to the MacOS as "Page up/down" (mode 0) or
567 +    "Cursor up/down" (mode 1) keys.
568 +
569 +  mousewheellines <number of lines>
570 +
571 +    If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets
572 +    the number of key events sent to MacOS for each wheel movement (the
573 +    number of lines to scroll).
574 +
575 +  ignoresegv <"true" or "false">
576 +
577 +    Set this to "true" to ignore illegal memory accesses. The default
578 +    is "false". This feature is only implemented on the following
579 +    platforms: Linux/x86, Linux/ppc, Darwin/ppc.
580 +
581 +  dsp <device name>
582 +  mixer <device name>
583 +
584 +    Under Linux and FreeBSD, this specifies the devices to be used for sound
585 +    output and volume control, respectively. The defaults are "/dev/dsp" and
586 +    "/dev/mixer".
587 +
588   AmigaOS:
589  
590    sound <sound output description>
# Line 466 | Line 595 | AmigaOS:
595  
596        ahi/<hexadecimal mode ID>
597  
598 +  scsimemtype <type>
599 +
600 +    This item controls the type of memory to use for SCSI buffers. Possible
601 +    values are:
602 +      0 Chip memory
603 +      1 24-bit DMA capable memory
604 +      2 Any memory
605 +
606 +    Be warned that many SCSI host adapters will not work with the "Any memory"
607 +    setting. Basilisk II has no way of knowing which memory type is supported
608 +    by the host adapter and setting an unsupported type will result in data
609 +    corruption.
610 +
611   Windows:
612  
613    noscsi <"true" or "false">
# Line 476 | Line 618 | Windows:
618      means is that the control is not returned to the application until the
619      command is completely finished. Normally this is not an issue, but when a
620      CDR/CDRW is closed or erased the burner program typically wants to wait in
621 <    some progress dialog The result may be that the application reports a
621 >    some progress dialog the result may be that the application reports a
622      time-out error, but the operation completes all right anyway.
623  
624    nofloppyboot <"true" or "false">
# Line 490 | Line 632 | Windows:
632      This is very useful since many devices have almost identical ATAPI and SCSI
633      versions of their hardware, and MacOS applications usually support the SCSI
634      version only. The example below is typical:
635 <  
635 >
636        replacescsi "HP" "CD-Writer+ 7100" "PHILIPS" "CDD3600"
637 <  
637 >
638      Note the use of quotes.
639  
640    rightmouse <0/1>
# Line 517 | Line 659 | Windows:
659      and some other need it to be turned off. Consult the documentation
660      of your CD software to learn which one is optimal for you.
661  
662 <  framesleepticks <milliseconds>    
662 >  framesleepticks <milliseconds>
663  
664      The amount of time between video frames.
665  
# Line 527 | Line 669 | Windows:
669  
670    stickymenu <true/false>
671  
672 <    If true, the main menu bar is kept open even after the mouse button is released,
673 <    under all OS versions (OS 8 has this feature already). There are extensions to do
674 <    the same thing, but it's faster to handle this in native code.
675 <    Default is "true".
672 >    If true, the main menu bar is kept open even after the mouse button is
673 >    released, under all OS versions (OS 8 has this feature already). There
674 >    are extensions to do the same thing, but it's faster to handle this in
675 >    native code. Default is "true".
676  
677    ntdx5hack <"true" or "false">
678  
679 <    You may need this on NT if your display adapter driver has a bug in DirectX
680 <    palette support. Black and white are reversed. It fixes the palette issue
681 <    by using GDI palette instead of D3D palette. Default is false.
679 >    You may need this on NT if your display adapter driver has a bug in
680 >    DirectX palette support. Black and white are reversed. It fixes the
681 >    palette issue by using GDI palette instead of D3D palette. Default is
682 >    false.
683  
684  
685   Usage
# Line 561 | Line 704 | Keyboard:
704    On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows"
705    key is the Mac "Option" key.
706  
707 + Mouse:
708 +  Under Unix, pressing Ctrl-F5 while the Basilisk II window is active will
709 +  grab the mouse. This is needed for compatibility with some MacOS programs,
710 +  especially games such as flight simulators. Press Ctrl-F5 again to return
711 +  to normal mouse operation.
712 +
713   Floppy:
714    Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
715 <  flopyy disk changes might not be detected automatically. Under Linux, press
715 >  floppy disk changes might not be detected automatically. Under Unix, press
716    Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu
717    item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11.
718  
719   HFS partitions:
720    Having HFS partitions mounted for read-write access under Basilisk II while
721    they are also mounted on the host OS will most likely result in volume
722 <  corruption and data losses. Unmount your HFS volumes before starting
722 >  corruption and data loss. Unmount your HFS volumes before starting
723    Basilisk II.
724  
725   ZIP drives:
# Line 589 | Line 738 | Mac Classic emulation:
738    ROM. Also, the video display is fixed to 512x342 in monochrome. The AmigaOS
739    and BeOS/PPC versions of Basilisk II cannot do Mac Classic emulation.
740  
741 + Video resolution switching:
742 +  Run-time switching of video resolutions requires the Display Manager. This
743 +  is included in MacOS versions 7.6 and above, and available as a system
744 +  extension for earlier MacOS versions as a free download from ftp.apple.com
745 +  (look for "Display Software 2.x"). Click on "Options..." in the "Monitors"
746 +  control panel to select the resolution.
747 +
748   Sound output:
749    Sound output under Basilisk II requires Sound Manager 3.0 or later. This
750 <  is included starting with MacOS 7.5 and available as a system extension
751 <  for earlier MacOS versions. Sample rate, bit resolution and mono/stereo
752 <  can be selected in the Sound control panel (section "Sound Out").
750 >  is included in MacOS versions 7.5 and above, and available as a system
751 >  extension for earlier MacOS versions as a free download from ftp.apple.com.
752 >  Sample rate, bit resolution and mono/stereo can be selected in the Sound
753 >  control panel (section "Sound Out").
754  
755   Ethernet:
756    Basilisk II supports all Ethernet protocols. Running a protocol under
757    Basilisk II that already runs within the host operating system on the same
758    network card (e.g. running MacTCP under Basilisk II on a BeOS machine) may
759    or may not work (generally, it should work, but some specific things like
760 <  "ping" may not). If you have problems with FTP, try setting your FTP client
760 >  "ping" may not). If you have problems with FTP, try setting the FTP client
761    to passive mode.
762  
763   LocalTalk:
# Line 610 | Line 767 | LocalTalk:
767  
768   Serial:
769    You can use the serial ports in Basilisk II to connect to the Internet
770 <  with a modem and "MacPPP".
770 >  with a modem and the "MacPPP" or "Open Transport/PPP" software.
771  
772  
773   Technical Documentation
# Line 622 | Line 779 | Please see the included file "TECH" for
779   Acknowledgements
780   ----------------
781  
782 < Contributions by:
626 < - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
627 < - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
628 <   and networking
629 < - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
782 > Contributions by (in alphabetical order):
783   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
784 < - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
784 > - Gwenolé Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations,
785 >   lots of work on the Unix video code
786   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
787 + - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
788 +   and networking
789   - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
790     window support
791 + - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
792 + - Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support
793 + - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
794   - David Lawrence <davidl@jlab.org>: incremental window refresh code
795 < - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
796 <   fbdev video code
795 > - Nigel Pearson <nigel@ind.tansu.com.au>: Mac OS X port
796 > - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
797 > - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
798   - and others...
799  
800   Special thanks to:
# Line 652 | Line 812 | You found a bug? Well, use the source, f
812    <Christian.Bauer@uni-mainz.de>
813   for inclusion in the next release of Basilisk II.
814  
815 + If you don't have a fix, you should post a bug report using the Source Forge
816 + bug tracker, supplying as much information as possible (operating system and
817 + versions of Basilisk II and MacOS being used, relevant hardware information,
818 + the exact steps to reproduce the bug, etc.):
819 +  http://sourceforge.net/tracker/?group_id=2123&atid=102123
820 +
821 + I also strongly suggest reading this before posting a bug report:
822 +  http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
823 +
824  
825   Author
826   ------
827  
828 < You can contact me at <Christian.Bauer@uni-mainz.de>. Don't send bug
829 < reports, send fixes. Ports to other platforms are also very welcome.
830 < Please contact me before you intend to make major changes to the source.
831 < You might be working on something that I have already done or I may have
832 < different ideas about the Right Way to do it.
833 <
834 < Questions about ROM files will not be answered. There is also no point in
835 < sending me questions etc. that are specific to the Windows port of
836 < Basilisk II. I don't have Windows and can't say anything about that.
837 < Ask Lauri Pesonen instead.
828 > You can contact me at <Christian.Bauer@uni-mainz.de>, but please don't do
829 > so unless absolutely necessary. I'm maintaining Basilisk II in my spare
830 > time and am not able to provide technical support for everyone. If you have
831 > questions, consider posting them to one of the support forums mentioned
832 > below.
833 >
834 > You are encouraged to contact me personally when
835 > - you have bug fixes or small enhancements for the code
836 > - you want to port Basilisk II to another platform
837 > - you want to discuss technical issues
838 > - you intend to make major changes to the source; you might be working on
839 >   something that I have already done, or I may have different ideas about
840 >   the Right Way to do it
841 >
842 > There is no point in sending me questions about
843 > - ROM files and how/where to get them
844 > - versions of Basilisk II that run on operating systems other than Unix,
845 >   BeOS and AmigaOS. If you are using any other operating system, there's
846 >   no point in asking me how to to X or why Y doesn't work because I won't
847 >   know either. Instead, you should look in the "Acknowledgements" section
848 >   of this manual to find the person responsible. For example, if your
849 >   question is specific to the Windows operating system, ask Lauri Pesonen.
850 >   I don't have Windows and can't answer your questions and I'm too lazy to
851 >   forward mail to Lauri myself. In any case, it would probably be better
852 >   to post your questions to a public forum as it will get a much wider
853 >   audience there.
854  
855  
856   Support
# Line 674 | Line 859 | Support
859   The official Basilisk II home page is at
860    http://www.uni-mainz.de/~bauec002/B2Main.html
861  
862 < There is no user-level support for Basilisk II at the moment.
862 > The Basilisk II project page on SourceForge is at
863 >  http://sourceforge.net/projects/basilisk/
864 >
865 > If you have problems, you may want to visit the Basilisk II forums:
866 >  http://sourceforge.net/forum/?group_id=2123
867 >
868 > There is also a mailing list for Basilisk II users:
869 >  http://lists.sourceforge.net/lists/listinfo/basilisk-user
870 >
871 > And another mailing list for Basilisk II developers:
872 >  http://lists.sourceforge.net/lists/listinfo/basilisk-devel
873 >
874 > Some general advice about asking technical support questions can be found at
875 >  http://www.tuxedo.org/~esr/faqs/smart-questions.html
876 >
877 > Keeping this in mind will greatly increase your chances of getting a useful
878 > answer.
879  
880  
881   History

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines