             EXECUTOR FREQUENTLY ASKED QUESTIONS WITH ANSWERS
                            17 Jul 1996
                        ARDI Staff <info@ardi.com>
               http://www.ardi.com/executor-faq.html

This is the list of Frequently Asked Questions about Executor, the
commercial Macintosh emulator for DOS, Windows, OS/2, Linux and NEXTSTEP
[see Q1.1 `What is Executor?' for more details].  This set of answers to
Frequently Asked Questions is not designed to take the place of our
Executor manual.  However, currently our manual is not available on-line,
so this FAQ does briefly touch on some issues that are covered more in
depth in our manual.

In addition to this FAQ, there should be README files bundled with
Executor and there is also an Executor/DOS document that describes how to
get started with Executor/DOS from a DOS user's point of view, which may
be useful to users of Executor on other platforms as well.  That document
is called "ERNSTOUD.TXT", since it's hard to come up with useful names
when constrained by the DOS 8.3 filename limits and the author of the
document is Ernst J. Oud.

Please check out these documents and this FAQ, before sending e-mail to
ARDI [see Q1.27 `Why shouldn't I send e-mail to ctm@ardi.com?'] or the
Executor Interest mailing list [see Q1.25 `What's the best way to keep
informed about Executor?'].

See Q5.2 `In what formats is this FAQ available?' for details of where to
get the PostScript, Emacs Info, HTML (WWW) and plain ASCII versions of
this document.

A new version of this document appears frequently.  If this copy is more
than a month old it may be out of date.

===============================================================================

Index

 Section 1.  Executor in General
 Q1.1        What is Executor?
 Q1.2        How can I get more information about Executor?
 Q1.3        On which platforms is Executor available?
 Q1.4        How much does Executor cost?
 Q1.5        Who makes Executor?
 Q1.6        How do I order Executor?
 Q1.7        What is the correct pronunciation?
 Q1.8        How fast is Executor?
 Q1.9        Does Executor require ROMs or System Files from Apple?
 Q1.10       What version of the Macintosh operating system does Executor emula
 Q1.11       How long has Executor been in development?
 Q1.12       What techniques were used to rewrite the OS and Toolbox?
 Q1.13       What limitations does Executor 2 have?
 Q1.14       If I have 800 KB floppies, what can I do?
 Q1.15       Does Executor run all applications?
 Q1.16       What percentage of applications will run under Executor?
 Q1.17       Where can I pick up the Executor demos?
 Q1.18       Where are the Cmd (Clover) and Option keys?
 Q1.19       How do the demo versions differ from the full versions?
 Q1.20       What's next?
 Q1.21       Does Executor have networking support?
 Q1.22       How do you install Fonts and Desk Accessories (DAs)?
 Q1.23       Will Desk Accessories work under Executor?
 Q1.24       Does Executor run xxx?
 Q1.25       What's the best way to keep informed about Executor?
 Q1.26       What's the Executor Interest mailing list?
 Q1.27       Why shouldn't I send e-mail to ctm@ardi.com?
 Q1.28       What is an HFV file?
 Q1.29       Can I launch applications directly from the command line?
 Q1.30       I installed a font in Executor, but I still can't print in it.  Wh
 Q1.31       What are all the command line switches?
 Q1.32       Are there other parameters I can adjust? [aka "Preferences Panel"]
 Q1.33       Can I have Executor use more than 8 MB for the application zone?
 Q1.34       An application I'm trying crashes.  What should I do?
 Q1.35       How do Executor's "license keys" work?
 Q1.36       May I bundle the DEMO version of Executor on a CD-ROM?
 Q1.37       Why do some applications claim I don't have an FPU?
 Q1.38       Can Executor run Japanese system software?
 Q1.39       Why does Compact Pro have trouble with multi-volume archives?
 Q1.40       What is makehfv?
 Q1.41       How can I create my own HFV files?
 Q1.42       How can I use Mac software from the internet?
 Q1.43       How can I use Mac software from Bulletin Boards?
 Q1.44       How can I use Mac software from AOL?
 Q1.45       How does your Browser show file size?
 Q1.46       How does your Browser show free space?
 Q1.47       Why do some installers not work?
 Q1.48       What is Speedometer?
 Q1.49       How can I get a screen dump of Executor?

 Section 2.  Executor/DOS
 Q2.1        Which FTP sites carry stable versions of Executor/DOS?
 Q2.2        What are the hardware requirements for Executor/DOS?
 Q2.3        What do I do if my Super VGA card isn't VESA compliant?
 Q2.4        E/D dies during startup.  Why?
 Q2.5        E/D runs under DOS, but not from Windows.  What do I do?
 Q2.6        What causes error -42 when transferring files?
 Q2.7        Why does my screen look funny when I run Executor?
 Q2.8        Does E/D require an ASPI driver to access SCSI?
 Q2.9        Have you released Executor for OS/2 yet?
 Q2.10       Why won't Executor/DOS work with my Diamond Viper PCI card?
 Q2.11       Why doesn't my mouse work when I run Executor under OS/2 Warp?
 Q2.12       Any OS/2 Warp suggestions?
 Q2.13       Does Executor work under Windows '95?
 Q2.14       How do I get E/D to see my CD-ROM drive?
 Q2.15       Executor dies, what should I do?
 Q2.16       Should I send in my registration card?
 Q2.17       How does printing work under E/D?
 Q2.18       Why does E/D under Windows 3.x have problems hot-keying?
 Q2.19       Why can't I eject or format my DOS formatted floppy?
 Q2.20       Do E/D and QEMM fight?
 Q2.21       Does Executor fight with Novell DPMS?
 Q2.22       How can I speed up Executor/DOS?

 Section 3.  Executor/Linux
 Q3.1        I can't get the option key to work. What should I do?
 Q3.2        What kernel do you recommend?
 Q3.3        Why is there no Executor for NetBSD or FreeBSD?
 Q3.4        Can I run Executor on FreeBSD?
 Q3.5        Where are the bitmaps stored on the Linux version of executor?
 Q3.6        Why do other windows get creepy colors when Executor is running?
 Q3.7        How does printing work under Executor/Linux?
 Q3.8        My mouse won't work with the SVGALIB version.  What's the deal?
 Q3.9        Why does Executor complain that it cannot find 'libXt.so.6'?
 Q3.10       How do I get E/L to see my b: drive?
 Q3.11       Which FTP sites have E/L?
 Q3.12       Why does Lemmings's splash screen take so long to be drawn?
 Q3.13       What free projects has ARDI supported?
 Q3.14       Is Executor localized for languages other than English?
 Q3.15       Can I Macintosh format disk drives?
 Q3.16       How can Executor be configured for multiple users?

 Section 4.  Executor/NEXTSTEP
 Q4.1        How much longer will Executor/NEXTSTEP be supported?

 Section 5.  Administrative information and acknowledgements
 Q5.1        Is feedback invited?
 Q5.2        In what formats is this FAQ available?
 Q5.3        Who wrote this FAQ?  Who helped?
 Q5.4        Is this FAQ Disclaimed and Copyrighted?

===============================================================================

Section 1.  Executor in General

 Q1.1        What is Executor?
 Q1.2        How can I get more information about Executor?
 Q1.3        On which platforms is Executor available?
 Q1.4        How much does Executor cost?
 Q1.5        Who makes Executor?
 Q1.6        How do I order Executor?
 Q1.7        What is the correct pronunciation?
 Q1.8        How fast is Executor?
 Q1.9        Does Executor require ROMs or System Files from Apple?
 Q1.10       What version of the Macintosh operating system does Executor emula
 Q1.11       How long has Executor been in development?
 Q1.12       What techniques were used to rewrite the OS and Toolbox?
 Q1.13       What limitations does Executor 2 have?
 Q1.14       If I have 800 KB floppies, what can I do?
 Q1.15       Does Executor run all applications?
 Q1.16       What percentage of applications will run under Executor?
 Q1.17       Where can I pick up the Executor demos?
 Q1.18       Where are the Cmd (Clover) and Option keys?
 Q1.19       How do the demo versions differ from the full versions?
 Q1.20       What's next?
 Q1.21       Does Executor have networking support?
 Q1.22       How do you install Fonts and Desk Accessories (DAs)?
 Q1.23       Will Desk Accessories work under Executor?
 Q1.24       Does Executor run xxx?
 Q1.25       What's the best way to keep informed about Executor?
 Q1.26       What's the Executor Interest mailing list?
 Q1.27       Why shouldn't I send e-mail to ctm@ardi.com?
 Q1.28       What is an HFV file?
 Q1.29       Can I launch applications directly from the command line?
 Q1.30       I installed a font in Executor, but I still can't print in it.  Wh
 Q1.31       What are all the command line switches?
 Q1.32       Are there other parameters I can adjust? [aka "Preferences Panel"]
 Q1.33       Can I have Executor use more than 8 MB for the application zone?
 Q1.34       An application I'm trying crashes.  What should I do?
 Q1.35       How do Executor's "license keys" work?
 Q1.36       May I bundle the DEMO version of Executor on a CD-ROM?
 Q1.37       Why do some applications claim I don't have an FPU?
 Q1.38       Can Executor run Japanese system software?
 Q1.39       Why does Compact Pro have trouble with multi-volume archives?
 Q1.40       What is makehfv?
 Q1.41       How can I create my own HFV files?
 Q1.42       How can I use Mac software from the internet?
 Q1.43       How can I use Mac software from Bulletin Boards?
 Q1.44       How can I use Mac software from AOL?
 Q1.45       How does your Browser show file size?
 Q1.46       How does your Browser show free space?
 Q1.47       Why do some installers not work?
 Q1.48       What is Speedometer?
 Q1.49       How can I get a screen dump of Executor?

-------------------------------------------------------------------------------

Question 1.1.  What is Executor?

Executor is a commercial emulator that allows non-Macintosh hardware to
run many applications originally written on a Macintosh.  Executor has
many limitations [see Q1.13 `What limitations does Executor 2 have?'], but
surprisingly, speed is not one of them [see Q1.8 `How fast is Executor?'].

If your only experience with emulators is Soft-PC or Soft-Windows making a
Mac emulate a PC, please check out a demo of Executor [see Q1.17 `Where
can I pick up the Executor demos?'] to see just how quickly Executor can
do the reverse.

-------------------------------------------------------------------------------

Question 1.2.  How can I get more information about Executor?

This FAQ contains much information, but it is pale when compared to a demo
of Executor [see Q1.17 `Where can I pick up the Executor demos?'].  Beyond
the demo, almost all the publicly available information on Executor is
found either at our official ftp site, ftp.ardi.com (204.134.8.1), or in
our WWW pages http://www.ardi.com.  There are also  unofficial Executor
WWW pages: http://vorlon.mit.edu/arditop.html.

-------------------------------------------------------------------------------

Question 1.3.  On which platforms is Executor available?

Executor/DOS (E/D) is an implementation that runs under DOS, Windows 3.x,
Windows '95 and OS/2.  Executor/NEXTSTEP (E/NS) is an implementation that
runs under NEXTSTEP, both on original NeXT hardware and Intel-based
hardware running NEXTSTEP.  Executor/Linux (E/L) is an implementation that
runs under Linux, with a.out and ELF versions for both X-Windows and
SVGAlib.

-------------------------------------------------------------------------------

Question 1.4.  How much does Executor cost?

Executor 2 has a suggested retail price of US$249.  Executor 2 will be
sold through resellers and the street price may be lower than US$249.

-------------------------------------------------------------------------------

Question 1.5.  Who makes Executor?

ARDI
Suite 4-101
1650 University Blvd., NE
Albuquerque, NM  87102

+1 505 766 9115 Phone
+1 505 766 5153 FAX

<info@ardi.com> general information and questions
<bugs@ardi.com> bug reports
<sales@ardi.com> information about ordering

-------------------------------------------------------------------------------

Question 1.6.  How do I order Executor?

Before you order, please read and understand Executor's current
limitations [see Q1.13 `What limitations does Executor 2 have?'] and
Executor's price [see Q1.4 `How much does Executor cost?'].  We
specifically make demo versions [see Q1.17 `Where can I pick up the
Executor demos?'] available so you'll know exactly what you're getting.
If you like what you see, you can use our web pages to get Executor's
price and even to place the order itself.

You may be able to get Executor from your favorite mail-order software
place or from a local software store.  Call them and ask them if they
carry Executor.

You can also order directly from ARDI by means other than the WWW pages.
An alternative is to get Executor's current price (via the web or by
calling or FAXing us) and mail us a check [see Q1.5 `Who makes
Executor?'], FAX us (+1 505 766 5153) credit card information (VISA,
MasterCard or EuroCard only) or call us up (+1 505 766 9115) so we can
take down your credit card information.

We accept domestic purchase orders from most universities and most large
companies.  We no longer accept non-U.S. purchase orders without
accompanying payment and we reserve the right to refuse U.S. purchase
orders as we see fit.

NOTE: All checks and money orders must be payable in U.S. funds and be
written from a U.S. bank.

Here's an order form:

Name	       ______________________  Name on Card ______________________

Organization   ______________________  Visa or MC   ______________________

Street Address ______________________  Card Number  ______________________

Street Address ______________________  Expiration Date ___________________

City	       ______________________  E-mail Address ____________________

State	       ______________________  FAX Number  _______________________

Postal Code    ______________________  Phone Number ______________________

				       Educational Country	       ______________________  Affiliation
_______________________

                                    Number of     Cost Description
Quantity    Machines     Each

Executor CD		  _____   x   _____   x   $249  =  _____

International Shipping (US $20) may be needed if the destination address
is outside the United States.  We ship Global Priority (free) when we can.
Is International Shipping OK if necessary?
_____

Sales Tax ($14.47 per CD;  needed if destination is in New Mexico)
_____

Total                                                      _____

-------------------------------------------------------------------------------

Question 1.7.  What is the correct pronunciation?

Ig-ZEK-yu-tor

-------------------------------------------------------------------------------

Question 1.8.  How fast is Executor?

Executor converts mc680x0 instructions into 80x86 instructions and then
runs the new instructions.  There is some overhead associated with this
process, but for cpu intensive tasks, a 75 MHz 486DX4 will run
approximately as quickly as a 25 MHz 68040.  NOTE: Lately some people have
begun calling 25 MHz 68040s "50 MHz 68040s", but we're not using that
trickery in our description.  The paper /pub/SynPaper available on
ftp.ardi.com describes how we can run mc68040 code so quickly on an 80x86.
SynPaper compares a few different systems and shows that a 90 MHz Pentium
runs almost as fast as a 50 MHz 68040.

Graphics performance depends on which version of Executor you have, and
what type of video card you have.  Executor runs fastest when it can grab
the frame buffer and write directly to it.  We have recently rewritten
much of our low-level graphics and do not yet have a rule of thumb for
systems in general, although one of our testing machines is a 66 MHz DX2
with a built-in VLB video card and in 256 color mode it displays graphics
at about the same speed as our 25 MHz 68040 based Quadra 605 for some
common operations and at about half speed for less common operations.

-------------------------------------------------------------------------------

Question 1.9.  Does Executor require ROMs or System Files from Apple?

No.  Executor reimplements from scratch a subset of the routines that make
up Apple's Macintosh Operating System and Toolbox.

-------------------------------------------------------------------------------

Question 1.10.  What version of the Macintosh operating system does Executor emulate?

The default is System 6.0.7, because support for that version is complete.
But you can set Executor to report any System version to the Macintosh
software.  It doesn't do any good to set it as high as 7.5, because we
don't support that yet, but setting it to System 7 will invoke Executor's
System 7 support.

To do this, start Executor and call up the Preferences Panel with
alt-shift-5.  Set the System to 7 and click OK (don't save yet; these are
just the Browser settings).  Now start your application, call up the
Preferences Panel again, and save it with the System 7 setting.  After
that, Executor will automatically invoke System 7 support when you run
that application.

-------------------------------------------------------------------------------

Question 1.11.  How long has Executor been in development?

Work began in July of 1986.

-------------------------------------------------------------------------------

Question 1.12.  What techniques were used to rewrite the OS and Toolbox?

Entirely clean-room techniques.  That is to say none of the Apple ROMs or
Apple System File were ever disassembled.  Instead ROMlib (the section of
Executor that emulates the OS and Toolbox) was written from the manuals
"Inside Macintosh", and Tech. notes.  That isn't sufficient to get the
degree of compatibility that we need, so tests were written and run on
Macs to see what a real Mac would do.  In addition, we run applications
under Executor and when they deviate from how they would behave on a Mac,
we take a look at what is going on and fix Executor accordingly.

-------------------------------------------------------------------------------

Question 1.13.  What limitations does Executor 2 have?

Because the OS and Toolbox have been rewritten from scratch, Executor 2
has many limitations, including no serial port access, no modem use, no
AppleTalk, primitive sound, limited System 7 support, no INITs, no CDEVs
and no Internationalization.

Executor can read and write 1.44 MB Mac formatted floppy disks, but due to
limitations in PC hardware, *can't* read or write 800 KB floppy disks.

We hope to support serial port access and improve sound within six months
of releasing Executor 2, but that is only speculation.

-------------------------------------------------------------------------------

Question 1.14.  If I have 800 KB floppies, what can I do?

Very little.  It is not ARDI's fault and there's nothing we can do about
it, but the way that Apple squeezed 800 KB onto floppies when PCs were
only getting 720 KB on floppies was to write more data on the floppy
tracks far from the center than on the tracks near the center.  This was
clever, but extremely incompatible.

There *are* ways to squeeze more information onto PC floppy drives than
PCs usually use.  However, these methods *cannot* be used to write or even
read 800 KB Macintosh formatted floppies.

Luckily, very little is supplied on 800 KB floppies anymore, but if you
have some, you're almost definitely going to need the use of a Macintosh
somewhere to copy the contents onto "HD" 1.4 MB formatted floppies (PCs
and Macs use the same low-level format for 1.4 MB floppies).

One Executor Enthusiast suggested using Kinko's public Macs for this
purpose, and this description was given:

1.  Moving 800 KB Mac Files onto 1.44 MB Macdisks.  The easiest thing
that I have found when working on a real Mac is to preformat the
Macdisks to 1.44 MB.  Insert the 1.44 MB disk and eject it with
(Cmd-E).  Then insert the 800 KB mac disk.  Drag the icon of the 800
KB disk over the 1.44 MB disk.  All the files will be transferred as
will the file names.  The Mactools fastcopy program can also copy
between densities.

2.  Kinko's Public Machines.  Kinko's public Macs are equipped with a
program known as "Desk Tracy" which is designed to stop people from
pirating Kinko's software from the harddisk.  The problem is that when
you are copying files between your own disks the program will still
trigger if the file has a namesake on the Kinko's machine. What you
will need to do is get a Kinko's employee to shut the program off,
which is obviously a discretionary call with them.  I didn't have a
problem and have done it twice, but we obviously will be using
different Kinko's.

-------------------------------------------------------------------------------

Question 1.15.  Does Executor run all applications?

Currently, no.  In addition to applications that won't run because they
require something that we currently don't support (e.g.  some of System
7), due to our rewriting of the OS and Toolbox, there is room for enough
incompatibility that many large programs do not work.  For this reason, we
make demo versions of Executor available for potential customers to run
before purchasing Executor [see Q1.17 `Where can I pick up the Executor
demos?'].

We are in the process of cataloging what we have tested.  The catalog,
which is not yet complete is available on our WWW pages:
http://www.ardi.com/compatibiliy/

-------------------------------------------------------------------------------

Question 1.16.  What percentage of applications will run under Executor?

This is another question that is tough to answer.  We have not had the
resources necessary to do the thorough testing needed to make an accurate
estimate.

A *very rough* estimate is that Executor will run somewhere between 60%
and 80% of Macintosh programs which don't run into one of its known
limitations (see Q1.13 `What limitations does Executor 2 have?').  If
you're interested in a particular Macintosh program, your best bet is to
check the compatibility database on our WWW pages:
http://www.ardi.com/compatibiliy/

-------------------------------------------------------------------------------

Question 1.17.  Where can I pick up the Executor demos?

The downloading page of our WWW site (http://www.ardi.com/download.html)
will give you a choice of ftp sites.  You can also use direct ftp to
ftp.ardi.com.  When you connect to ftp.ardi.com it will give you a current
list of sites which are mirroring ftp.ardi.com.

Here are our main mirror sites:

* vorlon.mit.edu in /pub/ardi
* ftp.tcel.com in /pub/mirrors/ardi
* ftp.pht.com in /pub/linux/ardi
* ftp.mpik-tueb.mpg.de in /pub/phil/ardi


CompuServe users may be able to find the latest DOS Executor demo in the
PC Utilities (go pcutil) or the PC Applications (go pcapp) forums, in the
demos section in both cases.  The Linux version's demo may also be on
CompuServe, in the Linux add-ons section of the Unix forum (go unix).
America OnLine users may find the Executor/DOS demo under the Top Picks
button in the software library of the DOS section (keyword: DOS).

We don't mind people making our current demos available on other sites,
but *please* be sure to include all the READMEs and FAQs.

In general, use ftp.ardi.com or a mirror to get the latest version.

-------------------------------------------------------------------------------

Question 1.18.  Where are the Cmd (Clover) and Option keys?

On a PC keyboard, Executor uses the left "Alt" key as a Cmd key and the
right "Alt" key as the Option key.

-------------------------------------------------------------------------------

Question 1.19.  How do the demo versions differ from the full versions?

Starting with Executor 2, there are two separate Executor binaries for
each platform supported.  The commercial version is distributed on CD-ROM
and can not be redistributed.  The demo version, which can be
redistributed under certain circumstances, has a few limitations.

The demo will only run for ten minutes before it will force you to exit.
In addition, all pages printed from the demo version will have "Demo"
written on them.  The demo version of Executor will read Macintosh
formatted floppies and hard drives but will not allow you to write to or
format them.  The remaining difference between the demo version and the
commercial version of Executor is that Command-Key equivalents will not
work in this demo version.

-------------------------------------------------------------------------------

Question 1.20.  What's next?

Beyond Executor 2, we want to make Executor compatible with Apple's System
7.5, so you'll be able to purchase a copy of System 7.5, install it on top
of Executor and get even more compatibility and features.  This will be
done incrementally at the same time that we work on ports to other
platforms.  The Executor mailing list (and its reflection in
comp.emulators.mac.executor) is a good source of information about what
we're currently doing.

Our plans for post-Executor 2 work are subject to change.  We try very
hard to spend development time on the right mix of implementing features
or fixing bugs that according to our existing customers desires and also
making modifications to Executor to make it more widely appealing.

-------------------------------------------------------------------------------

Question 1.21.  Does Executor have networking support?

Currently, no.  Networking support is planned for release 3, but we do not
yet have an estimated date of completion for Executor 3.  The first
platform to have networking support built in will probably be Linux.
NOTE: networking support will most likely first be an implementation of
OpenTransport and/or MacTCP, followed by EtherTalk.  Supporting AppleTalk
over serial lines is unlikely to happen due to differences in PC and Mac
hardware.

-------------------------------------------------------------------------------

Question 1.22.  How do you install Fonts and Desk Accessories (DAs)?

You just drag them into the hot-band and our browser will do the right
thing.  However, we only support bit-mapped fonts, not Type 1 or TrueType
fonts.  In addition, there is a bug which causes the hot-band to forget
which desk accessories have been loaded, which then makes it imposible to
remove desk accessories.

-------------------------------------------------------------------------------

Question 1.23.  Will Desk Accessories work under Executor?

Currently Desk Accessory support is very weak; most will not run.  Now
that Executor 2 has been released, we'll spruce up our DA code and work on
insuring that some of the more popular DAs work.

-------------------------------------------------------------------------------

Question 1.24.  Does Executor run xxx?

We are providing a database of what works and what doesn't on our WWW
pages: http://www.ardi.com/compatibility/ The database is not complete,
but it covers most of the applications people ask about most often.

-------------------------------------------------------------------------------

Question 1.25.  What's the best way to keep informed about Executor?

If you have access to Usenet, read comp.emulators.mac.executor, the Usenet
newsgroup devoted to Executor.  If not, join the Executor Interest mailing
list.  That's where the Executor Enthusiasts are.  Send a message to
<executor-request@ardi.com>.  The message body should say:

subscribe

We try to post important events to the net, and send new release
information via U.S. mail to our current customers, but the Executor
mailing list is where we post news about our experimental versions and
where you can send mail to talk with other people who are using Executor.

If you'd rather get the Executor Interest information in a daily digest
form, send the same subscribe message to

<executor-digest-request@ardi.com>, instead of
<executor-request@ardi.com>.

To remove yourself from either mailing list, send a message to the address
that you used to subscribe, saying:

unsubscribe

This will work only if you send the unsubscribe message from the same
account that you used to send the subscribe message.  You can also send a
message of "help" to <majordomo@ardi.com> and more information about how
to use it will be e-mailed to you.  If you are still having trouble, you
can send e-mail to <majordomo-owner@ardi.com> and that will be processed
by a person, although it may take a few days for the person to get around
to to your request.

Even after you have unsubscribed to the list, you will continue to get any
messages that were posted to the list before you unsubscribed but were not
actually sent immediately, but once you have unsubscribed, any new
messages that come in will not be sent to you.

The comp.emulators.mac.executor newsgroup and Executor mailing list are
unmoderated and usually have several messages a day posted to them (NOTE:
they provide exactly the same information, since there is a bi-directional
gateway connecting them both).  There is a separate mailing list that only
ARDI employees can post to and is used only to announce new Executor
things (experimental releases, major bugs, etc.).  It works just like the
other two mailing lists, in that you send "subscribe" e-mail to a special
address to be added to the list.  The address you send to is
<executor-announce-request@ardi.com>.

-------------------------------------------------------------------------------

Question 1.26.  What's the Executor Interest mailing list?

See Q1.25 `What's the best way to keep informed about Executor?'.

-------------------------------------------------------------------------------

Question 1.27.  Why shouldn't I send e-mail to ctm@ardi.com?

Cliff gets tons of e-mail.  E-mail sent to any of the generic ARDI
addresses: <info@ardi.com> , <questions@ardi.com> , <bugs@ardi.com> is
answered much more punctually.

-------------------------------------------------------------------------------

Question 1.28.  What is an HFV file?

Executor has the ability to store an entire Macintosh "volume" (i.e.
filesystem corresponding to a disk drive or a partition within a disk
drive) in a DOS or UNIX file.  Under DOS, this feature is very handy
because there is no way to have files with long names and upper and lower
case characters in their names unless you use an HFV file.  See Q1.40
`What is makehfv?'.

In general, HFV files should have filenames that end in ".hfv".

-------------------------------------------------------------------------------

Question 1.29.  Can I launch applications directly from the command line?

Yes.  If an application resides within a UNIX or DOS filesystem, you can
specify the name of the application, and documents that you would like the
application to open when it starts up, on the command line.  Applications
that reside in HFV files are specified using colons to delimit the
pathname, e.g. "MyVolume:directory:application".

-------------------------------------------------------------------------------

Question 1.30.  I installed a font in Executor, but I still can't print in it.  What's the deal?

You have to install the same font in Ghostscript.  Otherwise, Ghostscript
will use the default Helvetica font since it can't find the one you want.
Don't forget to add the paths to the fonts into your fonts pfb file.

-------------------------------------------------------------------------------

Question 1.31.  What are all the command line switches?

If you run "executor -help" it will list all the command line switches it
knows about and give a brief description of what they do.

Here is a list of the most useful switches:

The "desperate" switch for DOS will start Executor in minimalist mode.
This is useful when trying to track down a problem which is preventing
Executor from running.

The switch "system 7" causes Executor to invoke its limited System 7
support.  In order to run programs which require system 7, you must either
use this switch or set System 7 in the Preferences Panel (see Q1.10 `What
version of the Macintosh operating system does Executor emulate?').

The "nobrowser" switch prevents Executor from trying to run the file
browser upon startup.  Sometimes this is a handy to start an appliction a
little more quickly and other times it can be useful if the browser save
file gets corrupted and the browser refuses to run.

The switches "bpp" and "refresh" affect how the screen is emulated.  The
number of bits per pixel that the program running under Executor sees is
specified by bpp.  If bpp is set to 1, then there are only two "colors"
(black and white) available.  If it is set to 8, then 256 colors are
available.  For Executor/DOS, you need a SVGA board with a VESA compatible
driver to get 8 bits per pixel and screen sizes larger than 640x480.

The "size" switch lets you set the screen size.  Executor/Linux under
XWindows also understands the standard "geometry" switch.

The switches applzone, syszone and stack control how much memory is
allocated to the application, the system, and the application stack. The
memory switch asssigns a certain amount of memory to to Executor and lets
Executor choose how it should be divided.  In general, if you have more
than 4 MB, you should override the default and allow Executor to use more
memory.  All four of these switches can understand values expressed with m
(for MB) or k (for kilobytes).

For X windows users, privatecmap specifies that Executor should use a
private colormap.  This is the fastest graphics mode and gives you the
most accurate colors, but at the expense of radically changed colors in
your other windows whenever the cursor is in the Executor window, and
radically changed colors in the Executor window whenever the cursor is
outside of it.  Because this is annoying, this mode is not the default.
When not in this mode, the pixels in Executor's internal frame buffer are
converted to the nearest X colors before being drawn to the screen.

Executor 2 uses a new "synthetic CPU" which is much faster than the
synthetic CPU in previous releases of Executor.  The speed increase is due
to our use of native code; Executor now translates the 68k code being
emulated into 80x86 code "on the fly" and runs the 80x86 code.  However,
like anything that is new, there's a chance that our improvement has some
hidden drawbacks.  You can turn off the use of native code by specifying
"-notnative" on the command line.

Here is an example of some of those switches:

executor -applzone 4m -notnative

That would allocate 4 MB of memory for the application's use and revert to
a slower type of 68LC040 emulation -- an unlikely combination of switches.

-------------------------------------------------------------------------------

Question 1.32.  Are there other parameters I can adjust? [aka "Preferences Panel"]

Yes, when Executor is running, you can hold down Cmd-Shift-5 and get a
preferences panel.  That panel will let you adjust various settings,
similar to, but not as slick, as a Macintosh Control Panel.  If you Save a
preferences panel configuration, the values are saved for the particular
application you are running at the time.  This is handy, because some
games need to be run in 16 colors mode, so you can have Executor do that
automatically.

-------------------------------------------------------------------------------

Question 1.33.  Can I have Executor use more than 8 MB for the application zone?

You can use up to 64 MB for the applzone.

-------------------------------------------------------------------------------

Question 1.34.  An application I'm trying crashes.  What should I do?

Perhaps the most common avoidable cause of crashes is insufficient memory
for the emulated application.  You can fix this by increasing the
"applzone" parameter.  For example, many programs which normally die
quickly will work with "executor -applzone 4m" (which allocates 4 MB of
space for the emulated application; see the list of command line switches
and their meanings elsewhere in this document).

DOS NOTE: If you run "executor -info", it will tell you how much DPMI
memory is available and how much memory is being used by the applzone,
syszone and stack.  If there is less DPMI memory available than the sum of
the applzone, syszone and stack memory requirements, then Executor will
page between DPMI memory and a special "paging" disk file.  This paging
slows you down and also consumes disk space.  It is possible to manually
override the applzone, syszone and stack defaults with smaller values, but
when you do so, you run the risk of not having enough memory for an
application to run.  Unfortunately, Macintosh programs are often not
polite at all when they do not have enough memory.  The Lemmings demo is
an example of such a program; if you run that program on a real Mac and
only give it 1200k of memory, wierd errors will occur.  Doing the same
under Executor will also yield wierd errors.

If Executor needs to make a paging file, and there is not enough disk
space to create one, you will get an error message during Executor's
startup.  If you have the environment variable "TEMP" set, then Executor
will try to place its paging file there, so if TEMP is set to point to a
small RAM disk, or a disk that is nearly filled, Executor may run out of
memory too easily.

Some programs are unhappy with Executor's limited sound support, and
crash.  You can turn on the "pretend sound" option before running the
application in question and see if this helps.  In addition, some programs
have menu items, or preference check boxes that can be used to disable
sound.  It is always recommended that you disable sound from within a
program in addition to using the Executor sound preferences, if you have
to disable sound.

One example of a program that will have problems with sound is "Ultimate
Solitaire".  If you do not disable sound from within Ultimate Solitaire,
the game will play fine, until you win.  At that point it will tell
Executor to start playing a sound and request that Executor notify it when
the sound is done playing.  Even with "pretend sound" enabled, this will
result in Ultimate Solitaire hanging after you win a game.

Some programs also save preferences in a file, and if something bad
happens to that file, the program can then get confused and will not run
properly.  Occasionally this happens to Microsoft Word, and you need to
use the browser to delete the file "Word Preferences" from your "System
Folder".

Although it should not happen, even our file browser keeps a file around
that can cause trouble if it becomes corrupt.  That file is "godata.sav".
It stores which folders you have open and the contents of your "hot-band".
If that file gets corrupt, the file browser may not run.  In the rare case
that the browser won't run, you can use the "-nobrowser" switch when you
start Executor to bypass the browser, but to get the browser back you'll
need to either delete "godata.sav" somehow or replace exsystem.hfv with
one from the original distribution.

-------------------------------------------------------------------------------

Question 1.35.  How do Executor's "license keys" work?

The demo version of Executor 2 can not be converted to the commercial
version -- you must have an Executor 2 CD-ROM to get the fully functional
copy of Executor.  With your CD-ROM you'll also receive a serial number
and authorization key so that once you've installed Executor on your hard
disk, it will be personalized to uniquely identify its owner.

We will make updates to the CD-ROM available via the net, they will just
require data from the CD-ROM in order to be useful.  That allows us to
continue making "minor" upgrades free.

-------------------------------------------------------------------------------

Question 1.36.  May I bundle the DEMO version of Executor on a CD-ROM?

The short answer is "yes".

You are able to freely copy and distribute demo versions of Executor, as
long as you follow the restrictions set forth in Executor's license panel.
Please run the demo version of Executor and choose "About Executor..." to
see the restrictions that you must follow.

A suggestion: contact us to make sure you have the latest version of
Executor.  We can tell you if a new release is imminent.

-------------------------------------------------------------------------------

Question 1.37.  Why do some applications claim I don't have an FPU?

The problem is probably that the applications you are trying to use try to
directly manipulate the FPU unit that some Macintoshes have.

The key words are "directly manipulate".  Apple warned software makers to
not directly manipulate the FPU, but to instead use their numerics library
("SANE" Standard Apple Numerics Environment).  Programs that don't use
SANE, but directly manipulate the FPU run faster on macs that have FPUs,
but don't run at all on Macs that don't have FPUs.  If that is actually
the source of your problems, then such programs also wouldn't run on Apple
machines like the Quadra 605.  This limitation is also present on Apple's
PowerPC based Macs.

One workaround for this problem is an "INIT" called "SoftFPU".  SoftFPU
will make a Mac without a co-processor work as though there is one there,
however the floating point computation will be done very slowly.
Unfortunately, SoftFPU can't be used with Executor, because, currently,
Executor doesn't support INITs.

-------------------------------------------------------------------------------

Question 1.38.  Can Executor run Japanese system software?

Not in 2, and Executor 3 probably won't be out in 1996.

-------------------------------------------------------------------------------

Question 1.39.  Why does Compact Pro have trouble with multi-volume archives?

Executor takes a short cut that causes trouble for some programs; Compact
Pro is one of them.  The problem is that a real Macintosh can keep track
of volumes that are not physically in the drive.  That is why Macintoshes
sometimes tell you to put one disk in their floppy drive, then they eject
it and ask for another one, then eject it and ask for the first one.
Executor currently isn't so clever.  When a disk is ejected, Executor
forgets about it.  Few programs count on the behaviour of a real Mac, but
those that do currently won't work with Executor.

In Compact Pro's case you can just copy all of the pieces of the archive
to your hard disk, then open the last piece from the hard disk and
everything will work properly.  This workaround requires more hard disk
space than you'd need if you could just read the pieces off a succession
of floppies.

This problem probably will not be fixed by the time Executor 2 is
released.  Since it affects very few programs, it's not as high priority
as some other known bugs.

-------------------------------------------------------------------------------

Question 1.40.  What is makehfv?

The program makehfv (formerly called mkvol) allows you to create virtual
Macintosh volumes [see Q1.28 `What is an HFV file?'].  It is now part of
all Executor distributions, although it is more useful under DOS than
under Linux or NEXTSTEP.

To use makehfv you need to pick a name for the new HFV file, a name for
the Macintosh volume that your new HFV file will represent and the number
of kilobytes or megabytes that you want the HFV file to use.  Here's an
example that creates a file named "bigtest.hfv" that will appear in
Executor as "BigTest" and will have 10 MB of space in it.

makehfv bigtest.hfv BigTest 10m

Executor/DOS will automatically see HFV files if they are placed in the
same directory as executor.exe, which is usually C:EXECUTOR and their
names have the suffix ".hfv".

Executor/Linux will automatically see HFV files if they are placed in the
same directory as ExecutorVolume (NOTE: *not* in ExecutorVolume itself),
which is usually /usr/local/lib/executor and their names have the suffix
".hfv".

-------------------------------------------------------------------------------

Question 1.41.  How can I create my own HFV files?

See Q1.40 `What is makehfv?'.

-------------------------------------------------------------------------------

Question 1.42.  How can I use Mac software from the internet?

Find a site that legitimately has Mac software for use.  There is a
Macintosh FAQ that lists many sites -- here are some of them:

* grind.isca.uiowa.edu : /mac/infomac (USA)
* wuarchive.wustl.edu : /systems/mac/info-mac (USA)
* ftp.technion.ac.il : /pub/unsupported/mac (Israel)
* ftp.sunset.se : /pub/mac (Sweden)
* src.doc.ic.ac.uk : /packages/info-mac (UK)

Before transferring a large application, you might want to see what the
requirements of that application are, most sites have a collection of
small notes about applications that you can look at first.

Use BINARY mode to transfer the files that you want to use.  Files whose
names end in ".hqx" are usually the easiest to handle.

Under DOS, you need to make an HFV file [see Q1.40 `What is makehfv?']
that will be large enough to hold the files as you've downloaded them and
also hold the files after they've been expanded.  Once you've made the HFV
file, copy all the files you've downloaded into it, then follow the
remaining directions.

Under all operating systems, your next step is to run Stuffit Expander
ande use the "Expand..." menu item from the "File" menu to open each of
the files you've downloaded.  In general, especially when dealing with
files whose names end in ".hqx", Stuffit Expander will do the right thing.
However, some sites do not store files in ".hqx" format, and Stuffit
Expander may fail.  Remember, under DOS, you must do the Stuffit Expansion
inside an HFV file.

If Stuffit Expander fails, you can try using the Get Info option of
Executor's browser to change the creator and type information of the file.
If you believe the downloaded file in question is a Stuffit Archive, you
can change the type and creator each to "SIT!" and then try Stuffit
Expander again.  If you believe the downloaded file is a Compact Pro
archive, you can change the creator to "CPCT" and the type to "PACT" and
then try Stuffit Expander again.

-------------------------------------------------------------------------------

Question 1.43.  How can I use Mac software from Bulletin Boards?

In general, follow the procedure in Q1.42 `How can I use Mac software from
the internet?' -- know the limitations of what Executor can run, transfer
in binary mode and use Stuffit Expander to unpack the files you download.
Just like with files downloaded from the internet, sometimes you'll need
to change the file type and creator, first.

-------------------------------------------------------------------------------

Question 1.44.  How can I use Mac software from AOL?

AOL sometimes (about half the time) uses a format that Stuffit Expander
under Executor has trouble with.  For DOS/Windows users, use this
workaround.  Get a copy of unstuff.exe (available on AOL compressed as
unsitins.exe) and use the -mb tag to convert your downloaded files to
MacBinary format before ever moving them into Executor.  E.g.:

unstuff -mb somefile.sit
And you'll get somefile with a different extension.

Then start up Executor and use BinHex's Download --> Application function
to convert the file to an application and move it into an Executor volume
simultaneously.

Note that if the file can be unstuffed in the usual manner, then trying to
use this workaround will break it.  It's usually best, therefore, to try
normal unstuffing first.

-------------------------------------------------------------------------------

Question 1.45.  How does your Browser show file size?

Listing mode will show you the combined size of a file's resource and data
fork.  There is currently no way to determine the size of a folder.

-------------------------------------------------------------------------------

Question 1.46.  How does your Browser show free space?

Select the volume, then choose "Get Info" from the File menu.

-------------------------------------------------------------------------------

Question 1.47.  Why do some installers not work?

Currently there are two major classes of application installers that are
known not to work with Executor.  Installers based on Apple's Installer
break, and installers based on Bill Goodman's "Smaller Installer" also do
not work.  An example of the former is Microsoft Word 5's installer, an
example of the latter is Maelstrom 1.4.

The exact reasons these installers don't work is not known.  We have made
some progress with "Smaller Installer" based installers and hope to have
them running by the time Executor 2 ships; we are less sure about
Installers based on Apple's installer.

-------------------------------------------------------------------------------

Question 1.48.  What is Speedometer?

Speedometer is a shareware application that we have included with Executor
for demonstrational purposes.  We have done so with permission of
Speedometer's author, Scott Berfield.  It benchmarks Macintoshes (and PCs
running Executor) to find out how quickly their CPU, graphics, floating
point and disk subsystems work.  The current version of Speedometer is
Speedometer 4.x, but that uses a timing mechanism that Executor currently
doesn't support.  Speedometer 3.23 can give you a rough approximation of
how quickly your PC is emulating a Mac.  Remember, Speedometer is
shareware, and ARDI has not paid the shareware fee for you.  If you
repeatedly use Speedometer, please register it with Scott.

Speedometer will show you that Executor is a very efficient emulator.
Please note, ARDI has not put special hooks into Executor to recognize
Speedometer's code and bypass it; Speedometer is treated just like any
other application when run under Executor.  Yes, it would be possible for
us to cheat and make Speedometer return values that are higher than you
could expect to see in real life, but we don't do that sort of thing.
Speedometer 4.0 produces ridiculously high numbers under Executor, but
that is due to our not supporting the higher resolution timing mechanisms
that Speedometer 4.0 uses.  We are working with Scott to make sure that
future versions of Executor and Speedometer do not have this problem --
luckily, the 4.0 numbers are so high that it's obvious they are mistaken.

-------------------------------------------------------------------------------

Question 1.49.  How can I get a screen dump of Executor?

Just type Cmd-Shift-3, just like on a Mac.  The difference is that the
screen shot will be in TIFF format (uncompressed, for now) and will be
written in the directory that contains executor.exe under DOS, or in /tmp
under Linux and NEXTSTEP.

===============================================================================

Section 2.  Executor/DOS

 Q2.1        Which FTP sites carry stable versions of Executor/DOS?
 Q2.2        What are the hardware requirements for Executor/DOS?
 Q2.3        What do I do if my Super VGA card isn't VESA compliant?
 Q2.4        E/D dies during startup.  Why?
 Q2.5        E/D runs under DOS, but not from Windows.  What do I do?
 Q2.6        What causes error -42 when transferring files?
 Q2.7        Why does my screen look funny when I run Executor?
 Q2.8        Does E/D require an ASPI driver to access SCSI?
 Q2.9        Have you released Executor for OS/2 yet?
 Q2.10       Why won't Executor/DOS work with my Diamond Viper PCI card?
 Q2.11       Why doesn't my mouse work when I run Executor under OS/2 Warp?
 Q2.12       Any OS/2 Warp suggestions?
 Q2.13       Does Executor work under Windows '95?
 Q2.14       How do I get E/D to see my CD-ROM drive?
 Q2.15       Executor dies, what should I do?
 Q2.16       Should I send in my registration card?
 Q2.17       How does printing work under E/D?
 Q2.18       Why does E/D under Windows 3.x have problems hot-keying?
 Q2.19       Why can't I eject or format my DOS formatted floppy?
 Q2.20       Do E/D and QEMM fight?
 Q2.21       Does Executor fight with Novell DPMS?
 Q2.22       How can I speed up Executor/DOS?

-------------------------------------------------------------------------------

Question 2.1.  Which FTP sites carry stable versions of Executor/DOS?

The first place a new version of E/D will appear is ftp.ardi.com in
/pub/Executor_DOS.  However, when you log on to ftp.ardi.com, a list of
mirrors will be provided and depending on where you're located, one of the
mirrors may be much faster than ftp.ardi.com.

See also Q1.17 `Where can I pick up the Executor demos?'

-------------------------------------------------------------------------------

Question 2.2.  What are the hardware requirements for Executor/DOS?

Required: '386 or better, VGA, 7 MB disk space, and 4 MB RAM.  A SCSI
Controller is needed only if you want to access external Macintosh hard
disks or PowerBooks.

Recommended: '486 or better, SVGA, 7 MB disk space, and 8 MB RAM.  A SCSI
Controller is needed only if you want to access external Macintosh hard
disks or PowerBooks.

Executor/DOS 2 should work in sixteen colors on any VGA, although we do
not have the facilities to test more than a few in house.  In addition, if
you have a Super VGA that is VESA 1.0 compliant, Executor/DOS should be
able to provide 256 colors and a range of screen sizes.  If you have a
video card that is VESA 2.0 compliant, Executor's graphics will be even
faster.

-------------------------------------------------------------------------------

Question 2.3.  What do I do if my Super VGA card isn't VESA compliant?

There is a shareware SVGA utility that provides VESA compliance for SVGA
cards that normally are not VESA compliant.  It is not a product of ARDI,
but as a convenience to people picking up experimental versions of
Executor, the file uvbe51a.zip is available on ftp.ardi.com in
/pub/ardi/Executor_DOS.  If you use it, you should pay the shareware fee
as described in the documentation included in the zip file.  If you have a
recent SVGA card you probably don't need UniVBE, although it may improve
Executor's performance.  There may be a more recent version of UniVBE on
ftp.scitechsoft.com.  ftp.coast.net in /SimTel/msdos/graphics also has
several other card specific VESA drivers, some of which can be found in
vesa-tsr.zip and vesadrv2.zip.

-------------------------------------------------------------------------------

Question 2.4.  E/D dies during startup.  Why?

The most common cause of E/D not running under DOS is the lack of file
descriptors that you might get if you don't have the line:

FILES=30
in your config.sys.  If Executor is giving you trouble and you don't have
such a line in your config.sys file, please add it, or if you have a
smaller number than 30, please increase your number to 30.  There is no
reason to decrease your number if it is greater than 30.

-------------------------------------------------------------------------------

Question 2.5.  E/D runs under DOS, but not from Windows.  What do I do?

There are several things you can check:

* Are you running in 386-enhanced mode?
* Is virtual memory turned on?
* Is your mouse driver loaded and enabled (not just installed)?

If this checking produces no insights, write to <info@ardi.com> and we'll
try to track down the cause of the problem.

-------------------------------------------------------------------------------

Question 2.6.  What causes error -42 when transferring files?

Error -42 is the error code generated inside a Macintosh when too many
files are open.  Executor internally generates this error when the
underlying operating system disallows the opening of a file.  This error
is usually symptomatic of not properly setting FILES in your config.sys
[see Q2.4 `E/D dies during startup.  Why?'].

Similar errors may result when you try to copy Macintosh file to a DOS
disk because many Macintosh file names are illegal under DOS.  You can fix
this by renaming the file to a normal DOS eight-dot-three name.

-------------------------------------------------------------------------------

Question 2.7.  Why does my screen look funny when I run Executor?

Your video driver may not be fully VESA compliant.  If Executor detects
VESA compliance, it will try to use VESA modes.  In general, this is a
good thing, however, if these modes have bugs in them, Executor will
invoke the bugs, and Executor may fail.  Try getting a newer driver for
your video card if this happens [see Q2.3 `What do I do if my Super VGA
card isn't VESA compliant?'].

NOTE: If you run Executor with the "-info" switch, Executor will print out
information it finds out about your video card.  That information may be
helpful in tracking down your problem.

-------------------------------------------------------------------------------

Question 2.8.  Does E/D require an ASPI driver to access SCSI?

If your SCSI drivers patch the "INT 13" BIOS calls, then an ASPI driver is
not needed.  As long as "INT 13" can allow Executor to read a SCSI drive,
there is no need to use ASPI.

-------------------------------------------------------------------------------

Question 2.9.  Have you released Executor for OS/2 yet?

We plan on making an OS/2 specific version of Executor, but only after we
get Executor 2 shipping.  However, Executor/DOS is reported to work well
under OS/2 Warp.

-------------------------------------------------------------------------------

Question 2.10.  Why won't Executor/DOS work with my Diamond Viper PCI card?

Executor/DOS requires VESA compliant graphics cards.  Many cards are not
directly VESA compliant and need a tsr to be run before they will work
with Executor/DOS.  On a Gateway computer, you can do this with the
"vprmode VESA" command [see Q2.3 `What do I do if my Super VGA card isn't
VESA compliant?'].

-------------------------------------------------------------------------------

Question 2.11.  Why doesn't my mouse work when I run Executor under OS/2 Warp?

If it's not already there, you may need to add this line:
DEVICE=C:\OS2\MDOS\VMOUSE.SYS
to your CONFIG.SYS.  This, and related issues, are described on pages
206-207 of _User's Guide to OS/2 Warp_.  This line should already have
been added for you when you installed Warp.

Also, you may need to load MOUSE.COM in your AUTOEXEC.BAT, for example:
LOADHIGH C:\OS2\MDOS\MOUSE.COM
You can also create an AUTOEXEC file specifically for Executor, place it
in the same directory as Executor, and configure Warp to execute that file
whenever you launch Executor.

-------------------------------------------------------------------------------

Question 2.12.  Any OS/2 Warp suggestions?

Here is the advice of an Executor Enthusiast:

I haven't been having any problems with running Executor/Dos in
OS/2. What he needs to do (assuming he has Warp) is to run "Add
Programs" object in the "System Setup" folder. This will make a object
for Executor on his desktop (usually in the "Additional Dos Programs"
folder). Go into the settings for that object, and select the
"Session" tab. Set it to "Dos Full Screen", and choose "Dos
Settings". He wants "All Dos Settings". Primarily, Executor needs the
"DPMI Memory Limit" set to 16 megs, and "DPMI Memory Limit" set to
enabled. Since it defaults to 4 megs and automatic, it won't work. For
additional performance, he should set "Dos High" to on, "EMS Memory
Limit" to 0, "Video 8514a XGA IOtrap" to off, "Video Retrace
Emulation" to off, "XMS Memory Limit" to 0, and "XMS Minimum HMA" to
63. The biggest boost comes from "Session Priority". Set this to at
least 16, and if he is going to run no other programs, set it
higher. If he is going to run other programs, this should be left
at 16, and the "Dos Backround Execution" needs to be set to on.

-------------------------------------------------------------------------------

Question 2.13.  Does Executor work under Windows '95?

Yes, Executor/DOS works well under Windows '95.  We have not yet created a
version of Executor specifically for Windows '95, but we plan to do so in
the future.

-------------------------------------------------------------------------------

Question 2.14.  How do I get E/D to see my CD-ROM drive?

Executor accesses CD-ROMs through the Microsoft CD-ROM Extensions
(mscdex).  You need to have mscdex installed on your machine for Executor
to see your CD-ROM.

Under Windows '95, there is a different way to access CD-ROMs -- a way
that Executor doesn't use.  However, Windows '95 can also use mscdex.  To
do so, you need to find and remove the:

rem - By Windows 95 Setup 

portion from the mscdex line in your AUTOEXEC.BAT file.  You will also
need to edit your CONFIG.SYS file and make sure the CD-ROM driver is also
not commented out.

-------------------------------------------------------------------------------

Question 2.15.  Executor dies, what should I do?

If Executor dies even running the demo applications, try temporarily
moving your config.sys and autoexec.bat files aside and create minimal
versions of each, leaving only the lines that you need to initialize your
mouse driver and the
FILES=30
line in your config.sys.  Then reboot and try running Executor.  If
Executor then starts working, you will have to slowly add back the things
that are in your normal autoexec.bat and config.sys files until you know
exactly what is causing the problem.  Once you know that, you should send
information to <bugs@ardi.com>.

If Executor only dies on a particular application, try increasing the
amount of RAM dedicated to the application by using the "-applzone" switch
when you run Executor.  Also try turning on "Pretend Sound" [see Q1.32
`Are there other parameters I can adjust? [aka "Preferences Panel"]'], or
if the screen seems to be only partially updated, try turning on
"Refresh".

Once you've done as much as you can to figure out the problem, send a bug
report via http://www.ardi.com/bugform.html or via email to
<bugs@ardi.com>.  Run Executor with the "-info" switch and include that
information.  Make sure you also include the version of Executor you're
running (e.g. Executor/DOS 2), the name and version of the application
that is dying (e.g. HyperCard 2.1), the name and version of the operating
system you're runing (e.g. DOS 6.22) and enough details to reproduce the
crash (e.g. "start the application, choose the "more Elvis" from the
"adjust music" menu and the applicaton will crash").  If the application
you are running is publicly available via anonymous ftp, telling us where
we can pick it up for testing purposes also helps.

We accept bug reports from everyone, although paid customers bug reports
are almost always higher priority than those of potential customers.

-------------------------------------------------------------------------------

Question 2.16.  Should I send in my registration card?

Yes.  We use that card to assign your serial number and authorization key
so you can continue to download and unlock experimental versions of
Executor.  In general, we do not assign such numbers when you first
purchase Executor because we do not know if you're purchasing Executor as
a gift for someone else, or if it's being purchased through a company
purchasing department, or what.  We want to make sure that we have the
address of the eventual owner of Executor and the surest way to avoid
mistakes is to send in that card.

-------------------------------------------------------------------------------

Question 2.17.  How does printing work under E/D?

Executor/DOS will print directly to a PostScript-compatible printer if
started with the switch -printer lpt1 (or lpt2, lpt3, or whatever as
appropriate).  Otherwise, it prints to a PostScript file.  The first time
you print, the file will be named execout1.ps and will be located in the
same directory that executor.exe is located in. You can then print this
file on a PostScript printer, or if you have a PostScript compatible
driver, you can use a non-PostScript printer.  Two popular PostScript
compatible printer drivers are "GhostScript", available for free, and
"ZScript", a commercial program from ZenoGraphics.

-------------------------------------------------------------------------------

Question 2.18.  Why does E/D under Windows 3.x have problems hot-keying?

When you use a hot-key to switch away from Executor, Windows 3.x doesn't
know how to save the screen, because it only knows about the original VGA
screen modes, but Executor uses SVGA/VESA screen modes.  So when you
switch back, Windows 3.x doesn't know how to replace the screen with what
it used to contain.

This problem is further compounded by the fact that Executor has no way of
knowing when it's been switched out and switched back.  To make matters
worse, some Windows drivers (ATI Mach 32, for example) don't even restore
the mode properly, so not only will the screen be incorrect, but Executor
will die shortly after you switch back.

Luckily this is not a problem in Windows '95 or OS/2.

-------------------------------------------------------------------------------

Question 2.19.  Why can't I eject or format my DOS formatted floppy?

Executor/DOS allows you to see DOS drives other than the drive you install
Executor on.  It also allows you to format floppies in the Macintosh
format (it used to read and write Mac formatted floppies, but it wouldn't
do the formatting itself).

Currently, the two abilities conflict.  What we do is if a DOS formatted
floppy is in the drive when E/D starts, we treat that drive as a fixed
drive from that point on.  You can no longer eject the floppy, nor can you
convince Executor to consider that floppy as a Mac formatted floppy or a
candidate for Mac formatting.  This is confusing and ugly; but we haven't
found a better solution yet.

-------------------------------------------------------------------------------

Question 2.20.  Do E/D and QEMM fight?

We don't have QEMM in house for testing, but apparently older versions of
QDPMI are incompatible DPMI providers for Executor.  We have heard that
QEMM 8.0 works with Executor, but we have not tested it.  DPMI providers
that are known to work are the supplied CWSDPMI, the DPMI provider in
Windows 3.x and Windows '95, the DPMI provider in OS/2, and 386Max.

For now, if you have lines similar to these two:

DEVICE=C:\QEMM\LOADHI.SYS /R:1 /SIZE=8880 C:\QEMM\QDPMI.SYS 

SWAPFILE=DPMI.SWP SWAPSIZE=1024.

in your config.sys file, you should "rem them out" -- i.e. add "rem " to
the beginning of each line -- at least when using Executor:

REM DEVICE=C:\QEMM\LOADHI.SYS /R:1 /SIZE=8880 C:\QEMM\QDPMI.SYS 
REM SWAPFILE=DPMI.SWP SWAPSIZE=1024.

-------------------------------------------------------------------------------

Question 2.21.  Does Executor fight with Novell DPMS?

Yes.  Novell DOS and Stacker both use this memory manager, but Executor
will crash when Novell DPMS (DOS Protected Mode Services) is running.
Fortunately, Stacker can be run without it if you are using another memory
manager such as 386Max.  Additionally, Stacker won't use DPMS when run
under Windows.

This is another compatibility problem that we're looking into, although it
has been reported that some other well known programs crash under DPMS's
DPMI support (PKZIP, Geoworks and Logic Magician's Oberon System).

-------------------------------------------------------------------------------

Question 2.22.  How can I speed up Executor/DOS?

Executor/DOS is of course dependent on the speed and type of CPU in your
PC.  Obviously you can make E/D run faster if you upgrade your 386 to a
Pentium.  However, there are other, non-obvious ways in which sometimes
you can dramatically improve Executor's speed.

Use the "-info" switch to see how much DPMI memory you have compared to
how much physical memory you have.  In general, Executor itself will
consume approximately 2 MB of memory even if you could have an applzone,
syszone and stack size of 0 (which you can't).  So on a 4 MB system, you
can only allocate another 2 MB total to applzone, syszone and stack if you
want to avoid paging (paging slows Executor down considerably), and that's
only if you don't have drivers in your config.sys file or autoexec.bat
tying up more of your memory.  If you are low on memory, you should use
DOS's "mem" command and see how much Extended (XMS) memory DOS thinks you
have.  The more you can increase that figure before Executor starts up,
the more DPMI memory Executor will have and the easier it will be for
Executor to avoid paging.

*If* you have plenty of memory, then you can also speed Executor up a
little bit by running a disk cache.  However, you should only run the disk
cache in a write-through mode -- in other words you should enable the disk
cache so that all disk writes are immediately sent to the disk.  Failure
to do so may result in corrupt HFV files after Executor dies.

Executor can access video cards in three different ways.  The slowest is
by using VGA calls.  This is also the least flexible -- you are often
limited only to 16 colors when using VGA calls, since the only VGA mode
that supports 256 colors is too small to use with Executor.  If your card
is VESA compliant, or has a driver that makes it VESA compliant, Executor
can drive the video card more efficiently.  There are two major levels of
VESA compliance -- VESA 1.x and VESA 2.x.  Executor is even more efficient
if it can drive your video card using a VESA 2.0 driver, *if* that driver
supports "linear mapping".  The UniVBE driver allows many popular video
cards to be linear mapped.  If you want Executor to run quickly, you
should probably pick up a copy of UniVBE and test it on your system to see
if it improves things.  You can use "Speedometer" or "Globe" to get a
rough approximation of how much it helps.  On many cards, use of UniVBE
can double Executor's graphics speed.

===============================================================================

Section 3.  Executor/Linux

 Q3.1        I can't get the option key to work. What should I do?
 Q3.2        What kernel do you recommend?
 Q3.3        Why is there no Executor for NetBSD or FreeBSD?
 Q3.4        Can I run Executor on FreeBSD?
 Q3.5        Where are the bitmaps stored on the Linux version of executor?
 Q3.6        Why do other windows get creepy colors when Executor is running?
 Q3.7        How does printing work under Executor/Linux?
 Q3.8        My mouse won't work with the SVGALIB version.  What's the deal?
 Q3.9        Why does Executor complain that it cannot find 'libXt.so.6'?
 Q3.10       How do I get E/L to see my b: drive?
 Q3.11       Which FTP sites have E/L?
 Q3.12       Why does Lemmings's splash screen take so long to be drawn?
 Q3.13       What free projects has ARDI supported?
 Q3.14       Is Executor localized for languages other than English?
 Q3.15       Can I Macintosh format disk drives?
 Q3.16       How can Executor be configured for multiple users?

-------------------------------------------------------------------------------

Question 3.1.  I can't get the option key to work. What should I do?

Check to make sure your XConfig file doesn't have the right-alt function
definition commented out.  They are commented out by default in some
distributions.

-------------------------------------------------------------------------------

Question 3.2.  What kernel do you recommend?

We recommend 1.2.13 or higher.  We have a kernel patch for 1.2.13, but
anything older will have fundamental problems with Executor.

If you want E/L's sound support, you'll need kernel 1.3.45 or higher.

-------------------------------------------------------------------------------

Question 3.3.  Why is there no Executor for NetBSD or FreeBSD?

We don't currently have the manpower to support it.  NOTE: "support" is
different from "port" -- porting it is easy.  Training tech. support and
buying more dedicated equipment is what we can't do quite yet.  The Linux
release is a byproduct of the fact that we use Linux in-house.  After
we've released Executor 2, we'll look into the feasibility of Executor for
NetBSD and FreeBSD.

-------------------------------------------------------------------------------

Question 3.4.  Can I run Executor on FreeBSD?

You can.  Here's what Donald Burr <d_burr@ix.netcom.com> had to say about
it:

Running Executor under FreeBSD submitted by Donald Burr
<d_burr@ix.netcom.com>

It is now possible to run Executor under the FreeBSD operating system,
thanks to its Linux emulation code.  While it is not perfect (many
Linux-specific system calls, sound driver, etc. are not yet supported), it
is more than enough to run many Linux binaries, including DOOM, Netscape,
and, yes, Executor.

Several steps must be taken in order to properly setup the Linux emulator
to run Executor.  They will be detailed here.

Install Executor.

You MUST use the *a.out* version of Linux Executor.  This is because
FreeBSD does not support ELF-format executables at this time.

Follow the directions included with the Executor archive to install it.
Executor will install itself under /usr/local/bin.  You may safely delete
the /usr/local/bin/executor- svga file, since this (the SVGAlib version)
will not run under FreeBSD, and will save you some disk space if you
delete it.

Don't try running Executor yet!

Install and configure the Linux emulation code.

If you have installed FreeBSD 2.1, the Linux emulation code has already
been installed for you.  If, on the other hand, you are installing FreeBSD
2.0.5, the Linux emulation code can be found as part of the *Experimental*
software distribution (xperimnt).

A shell script, /usr/bin/linux, should have been installed.  If it does
not exist, simply create it yourself.  Its contents should read:

#!/bin/sh modload -e linux_init /lkm/linux_mod.o

Be sure to make it executable (chmod ugo+x /usr/bin/linux).

Add the line /usr/bin/linux to your /etc/rc.local file, so that the Linux
emulation code will be loaded automatically at boot time.

Next, you must recompile your kernel with Linux emulation support enabled.
Simply add the line:

options COMPAT_LINUX

(if you are installing under FreeBSD 2.0.5, that should read *options
LINUX_COMPAT*).

to your kernel's configuration file, and recompile.  (If you are unsure of
how to recompile your kernel, please see the FreeBSD FAQ or Handbook.)

Finally, recompile the Linux loadable module, as follows:

cd /usr/src/lkm/linux make all install clean

Finally, reboot your machine.  Your boot message should now include the
line:

Linux emulator installed.

If it doesn't, then go back and re-check the above steps.

Install the bash shell.

Linux uses the GNU Bourne Again Shell BASH as a substitue for /bin/sh.
FreeBSD's /bin/sh is the standard Bourne shell, and thus is not compatible
with a lot of bash's extensions.  Fortunately, the bash shell has already
been ported to FreeBSD, and is available in both the "ports" and
"packages" collection.  Look on your CD-ROM (disk 1) or in the directory
/usr/ports on your system for these.  If they are not available, they can
be downloaded from the FreeBSD FTP server.

The bash port directory is at: 	ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-
current/ports/shells/bash.tar

The bash package is at: 	ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-
current/packages/shells/bash-x.xx.x.tgz

Review your documentation on FreeBSD for the proper procedure for
installing a port or package.  Really, to install a package, all you have
to do is type pkg_add -v <package filename>.  To install a port, simply go
into its directory, and type make all install clean.

bash is installed in /usr/local/bin, but Linux has its bash located in
/bin.  To accomodate this, simply use a symbolic link.

ln -s /usr/local/bin/bash /bin/bash

Install a *wrapper* for the type command.

Unfortunately, since Executor was written with Linux in mind, it expects
to be able to run some bash-specific commands (such as type) through
/bin/sh, since, on Linux, /bin/sh is just a link to bash anyway.
Unfortunately, this won't work under FreeBSD, since /bin/sh is the
standard Bourne shell (which does not understand bash-isms like type,
etc.).

Fortunately, this is a pretty easy problem to work around.  Simply install
the following small *wrapper* program to a file called type.  It can go
anywhere, although, according to UNIX conventions, you should put it in
/usr/local/bin (it is a locally-installed program).

#!/bin/sh exec bash -c "type $*"

Set up your printing system.

Executor uses the standard UNIX lpr print spooling system to handle print
requests.  It generates PostScript output, and thus requires a PostScript
printer to be your output device.  If you do not own such a beast, all
hope is not lost; using special configuration scripts and *magic filter*
type programs, you can create some magic that will use Ghostscript to
convert the PostScript output to something your printer can understand.
This, unfortunately, is beyond the scope of this FAQ; for details, consult
the FreeBSD FAQ or Handbook, ask on the various FreeBSD mailing lists or
newsgroups, and read the documentation for Ghostscript and/or your *magic
filter* package.

Looking for a *magic filter* package?  The author knows of two that work
*out of the box* under FreeBSD.  Use Archie or some other search tool to
look for apsfilter or magicfilter.  magicfilter, a package originally
written for Linux (but works great on FreeBSD) is available at the Linux
ftp sites, such as sunsite.unc.edu.  Look in /pub/Linux/system/Printing.

Here's a neat trick to use if:

* you've installed Ghostscript;
* you don't use programs OTHER THAN Executor which print PostScript or
  other formats; and
* you don't want to bother with installing a print filter

If so, install this shell script into /usr/local/bin/executor_filter:

#!/bin/sh /usr/local/bin/gs  -q -dSAFER -dNOPAUSE -sDEVICE=<device driver
for your printer> <any other flags necessary> -sOutputFile=- - |  lpr

(Optional) Add Executor to your menuing system.

Having Executor sitting in your menuing system makes it convenient and
easy to fire up an Executor session when you need to.  No more fumbling
around command lines, shell windows, or the like.

If you use fvwm as your window manager, simply edit the
/usr/X11R6/lib/X11/fvwm/system.fvwmrc (or your own private .fvwmrc file),
locate the Popup Utilities... section and add a line to fire up Executor:

Popup "Utilities" 	Title "Main Menu" ...  	Exec Executor exec executor
-geometry 800x600 -nosplash & ...  	Popup "Exit Fvwm..."		Quit-Verify
EndPopup

(You can use whatever command line flags you want.)

Or, if you are an olvwm user, edit the file /usr/X11R6/lib/openwin-menu,
and add a line somewhere in the Main Menu block to fire up Executor:

"Main Menu" TITLE PIN ...  Executor exec executor -geometry 800x600
-nosplash ...  "Exit..." EXIT

Caveat Executor: Notes and Gotcha's

Here are several things to watch out for when running Executor.

When you first run Executor, it will be in its 10-minute demo mode.  If
you purchase a license key from ARDI, you will need to enter it.  Be
warned that you must be root in order to do this (either by logging in as
root or by executing a su).  This is because Executor actually modifies
itself when entering the registration key, and unless you have extremely
liberal file permissions on the /usr/local/bin directory and the Executor
executable, the changes that it tries to make wuill not be allowed.  If
you use su, be sure and run Executor from the command line, using your
newly-acquired root shell.  If you run it from a menu, this will not work,
because the permissions given to your window manager (which handles the
menus) are not affected by your su command.

After you upgrade your Executor, you will find a backup copy of your old
(unregistered) Executor, in /usr/local/bin/executor.old.  If the new copy
seems to be working OK, this can safely be removed, and will free up some
disk space.

FreeBSD's Linux emulation is not perfect.  Some Linux-specific system
calls and devices are not emulated well (if at all).  However, these
imperfections do not prevent the bulk of Executor from running well.  Only
the sound support is affected (Executor cannot use FreeBSD's sound driver,
and thus you will not get any sound from your programs).  Even so, Linux
emulation generates a lot of error messages, of the form:

LINUX: 'ioctl' fd=..., typ=0x...(...), num=0x... not implemented
Linux-emul(...): syslog() not supported (BSD sigreturn)

They can be safely ignored.

If you want to easily share programs and/or data between your DOS and
Linux (FreeBSD) Executor environments, this is easy: simply create an HFV
file!  Make it under your DOS Executor, and simply point your Linux
Executor to it.  As root:

cd /usr/local/lib/executor ln -s /dos/executor/myvol.hfv myvol.hfv

Now, when you run Linux Executor, you will see the icon for myvol.hfv
appear in the Drives hot-band.

Be sure you have adequate permissions on your /dos/executor directory and
any *.hfv files you want to access under both environments, or else the
Executor process will not be able to write data properly.

If this FAQ has still not answered your questions, or you are still having
problems setting it up properly, feel free to send me some E-mail.  I will
be happy to assist you.

-------------------------------------------------------------------------------

Question 3.5.  Where are the bitmaps stored on the Linux version of executor?

All versions of Executor maintain an internal bitmap corresponding to the
actual screen.  We accrue a "dirty rect" as the program draws to what it
thinks is the screen via Executor's QuickDraw implementation.  We
periodically update the _real_ screen (e.g., the X window) by transferring
the "dirty rect" across.  So basically our graphics interface to the host
machine consists of nothing more than blitting rectangles to the screen,
which aids our portability.  Under X, we use shared memory extensions for
speed, but we don't do anything fancy like trying to cache Mac fonts on
the X server side.  Spending time trying to do so would be a bad idea for
a number of reasons we won't go into.

"Refresh" mode is useful when the program directly manipulates the frame
buffer itself.  In this mode, we periodically analyze the internal screen
memory to decide what has been changed, and transfer the changed data to
the real screen.

-------------------------------------------------------------------------------

Question 3.6.  Why do other windows get creepy colors when Executor is running?

Executor/Linux can run in two modes on 4 or 8-bit X servers:

"private colormap" mode: In this mode, Executor "takes over" all colors on
your screen when the cursor is in the Executor window.  That means that
the colors for all your other windows will suddenly change radically.
This is the fastest mode, and provides the most accurate colors, but it
can be a real eyesore.  Still, if you're playing Wolfenstein 3D or some
other interactive game, you may want to maximize performance by using this
mode.  You can enable this mode with "-privatecmap".  NOTE: some X Window
managers have problems and "-privatecmap" winds up doing the wrong thing
unless you also specify "-geometry".  We do not think this is an Executor
bug, but if anyone has information to the contrary, we'd be happy to read
it.

"non-private colormap" mode: In this mode (the default), Executor coexists
nicely with other X windows by not mucking about with the colors they use.
This mode loses some accuracy and speed, because Executor cannot set the
entire color table to exactly what it wants and it must convert its
internal graphics representation to one appropriate for the X screen
whenever it updates your display.  We have carefully optimized this
conversion process, so you won't notice the performance penalty most of
the time.

The "-privatecmap" flag is irrelevant to 16, 24, and 32-bit X servers,
since they don't have a color table.

-------------------------------------------------------------------------------

Question 3.7.  How does printing work under Executor/Linux?

Executor expects to print to a PostScript printer, or to send output to a
PostScript compatible filter, like GhostScript.  When an application
prints under Executor, a PostScript stream will be created and sent
through the program "executor_filter" which you can create by hand to "do
the right thing", or "lpr" if there is no "executor_filter" for Executor
to run.

On our systems, "lpr" automatically does the right thing, so other than
occasionally setting our "PRINTER" environment variable, we don't have to
do much to print from Executor.

If you need to write your own filter, you can test it by typing:

executor_filter < myfile.ps
where "myfile.ps" is some PostScript file you have lying around.  The "<"
is VERY important!  Executor does NOT give your filter any command line
arguments; it just "pipes" the PostScript file through it.

CAVEAT: Different apps running under Executor have different levels of
success when printing.  As always, *especially* with the experimental
versions, try first to make sure Executor will do what you want it to.

-------------------------------------------------------------------------------

Question 3.8.  My mouse won't work with the SVGALIB version.  What's the deal?

You need a newer kernel.  1.3.26 or later should be fine.  ARDI also has a
kernel patch on our ftp site which can fix things for kernel 1.2.13 or
later.

-------------------------------------------------------------------------------

Question 3.9.  Why does Executor complain that it cannot find 'libXt.so.6'?

If Executor complains as soon as you start it up, you are running XFree86
2.x instead of XFree86 3.x.  Currently we do not have the time to create
two separate versions of E/L, so use the "current" XFree86
server/libraries.

It has been reported that you can install the XFree86 3.x shared libraries
and still use an XFree86 2.x server.  We have not verified such trickery
here at ARDI -- you're on your own.

-------------------------------------------------------------------------------

Question 3.10.  How do I get E/L to see my b: drive?

Before running Executor, set the MacVolumes environment variable to point
to the entry in "/dev" that represents your B: drive, as:

Using "sh", "bash" or other Bourne Shell like shell:

	$ export MacVolumes="/dev/fd1"

Using "csh", "t-csh" or other C Shell like shell:

	% setenv MacVolumes "/dev/fd1"

This should work as long as you have permission to access the drive in
question ("/dev/fd1" in the above example).  If it doesn't, try using the
-nodrivesearch switch to disable Executor's usual probing for devices.

-------------------------------------------------------------------------------

Question 3.11.  Which FTP sites have E/L?

Other than ftp.ardi.com:/pub/Executor_Linux (too slow) and and the usual
mirrors, you can find Executor/Linux on sunsite.unc.edu in
/pub/Linux/system/Emulators/ .

See also Q1.17 `Where can I pick up the Executor demos?'

-------------------------------------------------------------------------------

Question 3.12.  Why does Lemmings's splash screen take so long to be drawn?

As mentioned in Q3.6 `Why do other windows get creepy colors when Executor
is running?' Executor/Linux by default now tries to cooperate with
X-Windows when assigning colors.  That leaves X in charge of "the
colormap", which means Executor can't quickly change the colors in the
colormap itself.  If you use the "-privatecmap" option when you start
Executor, you'll find that Lemmings splash screen will come up much
quicker, but you'll also experience the "creepy colors" problem in other
windows.

-------------------------------------------------------------------------------

Question 3.13.  What free projects has ARDI supported?

ARDI has sent a copy, with the appropriate legal release, of its HFS
implementation to Paul Hargrove to aid him with his implementation of a
true HFS filesystem under Linux.  When we have more time, if Paul hasn't
finished and would like it, we'll be even more active in helping get a
free implementation of HFS that can be used with Linux, FreeBSD, NetBSD
and GNU.

To build Executor/DOS, ARDI uses DJGPP, a free 32-bit programming
environment for DOS based mostly on GNU tools.  As users of DJGPP, we have
contributed bug fixes and some source code to the project.  For more
information about DJGPP, see http://www.delorie.com.

ARDI has also done a minor rewrite of Checker to make it much faster and
fix many bugs.  This rewrite should be available soon.

ARDI is not in the black, so allocating a portion of its profits (losses)
towards free software is not yet a good idea.

-------------------------------------------------------------------------------

Question 3.14.  Is Executor localized for languages other than English?

Not yet.  We recently added international keyboard support, though, and
romantic language localization should happen soon after Executor 2 is
released.

-------------------------------------------------------------------------------

Question 3.15.  Can I Macintosh format disk drives?

Yes, but if you do not consider yourself a UNIX wizard, you probably
shouldn't do it.  All you have to do is find out the formatted disk
capacity and then run makehfv [See Q1.40 `What is makehfv?'] with
arguments so it writes directly to the disk drive you want formatted.  You
can only do this if you have write permissions on the drive in question.
Obviously all data currently residing on that drive will be lost, and if
you make a typo and inadvertently specify the wrong drive, you'll erase
the data on the wrong drive.

-------------------------------------------------------------------------------

Question 3.16.  How can Executor be configured for multiple users?

Executor has a variety of environment variables that can be altered to
allow individual users to override the default locations Executor expects
to find key files.  Here are the important environment variables and their
default values:

* ConfigurationFolder "+/Configuration"
* SystemFolder "+/ExecutorVolume/System Folder"
* PublicDirectoryMap "+/DirectoryMap"
* PrivateDirectoryMap "~/.Executor/DirectoryMap"
* DefaultFolder "+/ExecutorVolume"
* MacVolumes "+/exsystem.hfv;+"
* PrintFolder "/tmp"
* ScreenDumpFolder "/tmp"

The leading "+/" represents the directory "/usr/local/lib/executor".  So
to allow multiple users to all have their own preferences, you can create
an executor directory for each potential user like this:

~/executor/
    ~/executor/Configuration
    ~/executor/SystemFolder
    ~/executor/ScreenDumps
Then reassign these environment variables:

* ConfigurationFolder "~/executor/Configuration"
* SystemFolder "~/executor/SystemFolder"
* PublicDirectoryMap "~/DirectoryMap"
* DefaultFolder "~/executor"
* ScreenDumpFolder "~/executor/ScreenDumps"

You'll then need to populate the System Folder either with copies of
what's in "/usr/local/lib/executor/ExecutorVolume/System Folder", or with
symbolic links to the actual files.  The Desktop Textures program actually
modifies the System File, so if different users are going to want
different desktops, or if you want to make sure there's no interference
between users, then you should use copies rather than symbolic links.

===============================================================================

Section 4.  Executor/NEXTSTEP

 Q4.1        How much longer will Executor/NEXTSTEP be supported?

-------------------------------------------------------------------------------

Question 4.1.  How much longer will Executor/NEXTSTEP be supported?

Executor 2 is the last major release of Executor/NEXSTEP that we guarantee
we'll release.  The market for shrink-wrapped software in the NEXTSTEP
market has dried up -- in fact, it dried up a long time ago.  We are
releasing Executor 2 for NEXTSTEP to live up to the commitments we made to
our NEXTSTEP customers, but we are not actively looking for new NEXTSTEP
customers and the future looks bleak for Executor/NEXTSTEP.  This is
especially sad because NEXTSTEP is an awesome environment.

===============================================================================

Section 5.  Administrative information and acknowledgements

 Q5.1        Is feedback invited?
 Q5.2        In what formats is this FAQ available?
 Q5.3        Who wrote this FAQ?  Who helped?
 Q5.4        Is this FAQ Disclaimed and Copyrighted?

-------------------------------------------------------------------------------

Question 5.1.  Is feedback invited?

ARDI profits tremendously from feedback.  Bug reports can be sent directly
from Executor/NEXTSTEP or be nicely formatted and sent with send-pr under
Linux, or can be sent by hand to <bugs@ardi.com>.

Comments on this FAQ can be sent to <faq-comments@ardi.com>.  This FAQ is
built with tools that automatically number the questions [see Q5.3 `Who
wrote this FAQ?  Who helped?'], so please recognize that question numbers
themselves do not uniquely identify questions or answers when you send in
FAQ comments.

-------------------------------------------------------------------------------

Question 5.2.  In what formats is this FAQ available?

Thanks to the tools we use [see Q5.3 `Who wrote this FAQ?  Who helped?'],
this FAQ is available as an ASCII file, as an Emacs info document, as a
set of WWW pages and as a PostScript document.

ftp.ardi.com /pub/executor_faq.ascii ftp.ardi.com /pub/executor_faq.info
ftp.ardi.com /pub/executor_faq http://www.ardi.com/executor-faq.html/

-------------------------------------------------------------------------------

Question 5.3.  Who wrote this FAQ?  Who helped?

This FAQ was written and is maintained by ARDI employees.  After learning
about them via the Caldera FAQ (http://www.caldera.com/caldera_faq/), we
rewrote our existing FAQ to use the same tools that the Linux FAQ is built
with.  Those tools were written by Ian Jackson <ijackson@nyx.cs.du.edu>.

We've also had contributions from many Executor Enthusiasts worldwide.

Thanks.

-------------------------------------------------------------------------------

Question 5.4.  Is this FAQ Disclaimed and Copyrighted?

This document is provided as is.  The information in it is *not* warranted
to be correct; you use it at your own risk.

Executor Frequently Asked Questions with Answers is Copyright 1996 by ARDI
<info@ardi.com>.

