home *** CD-ROM | disk | FTP | other *** search
/ Executor 2.0 / executorv2.0.iso / pc / linux / extra / docs / ErnstOud < prev    next >
Encoding:
Text File  |  1996-07-25  |  30.2 KB  |  647 lines

  1. NOTE: This file was written by an Executor user to help other Executor
  2. users solve common problems.  ARDI has edited it slightly, but left it
  3. essentially unchanged.  Enjoy!
  4.  
  5. Version 2.
  6. Updated December 20th, 1995
  7. Executor/DOS experimental (pre-beta) version 1.99p8
  8.  
  9. GETTING STARTED WITH EXECUTOR
  10. -----------------------------
  11.  
  12. "A bug is an undocumented feature. 
  13. A bug becomes a feature by documenting it."
  14.  
  15. The author of this document had no previous knowledge about Macintosh
  16. software and architecture before buying Executor. PC experience in
  17. abundance but totally blank about the Mac world. Executor was bought
  18. to fill this hole and fully lived up to its expectations.
  19.  
  20. Although Executor can be used without any previous Macintosh knowledge
  21. (proof that this unique selling point for a Mac still holds true)
  22. there are some facts that would have helped the author. Some of these
  23. are described below; perhaps they will help you.
  24.  
  25. The original Macintosh was introduced in 1984 with the now famous 1984
  26. Big Brother advertisements. It was followed by an enormous range of
  27. machines. The original Motorola 68000 processor (comparable to an
  28. 8086) was followed by the 68020 (eq. 80286), 68030 (386DX) and 68040
  29. (486SX/DX).  Last year Apple shifted its machines to RISC architecture
  30. and now uses a Motorola/IBM developed PowerPC processor. Apple has
  31. implemented an emulator within its operating system so that all 680x0
  32. applications still can be run on a PowerPC. 
  33. Executor emulates a 68LC040, which is a 68040 without a floating point 
  34. processor (the "LC" stands for "low cost"). 
  35.  
  36. (An interesting sidenote: ARDI's 68LC040 emulator for the PC is faster 
  37. than Apple's 68LC040 emulator for PowerPC's. Mat Hostetter, part of ARDI's 
  38. team, wrote the emulator and really should bring it to the market as a 
  39. separate product.)
  40.  
  41. Most of the Mac's success was not caused by its hardware but by its
  42. software. The Mac was one of the very first systems using a Graphical
  43. User Interface. It is this GUI that Executor emulates.
  44.  
  45. The Macintosh operating system comes with the strange name of
  46. 'System'. It has had a number of releases comparable to MS-DOS; it is
  47. now in its 7th life and like a cat, it was its last; future versions
  48. are called MacOS.  Although System 7 added a lot of new features,
  49. Executor fully emulates a Mac running System 6.0.7. In the current
  50. experimental versions (1.99x) of Executor, some emulation of System 7
  51. functionality is included. It is ARDI's intention to make it possible some
  52. day that you will be able to use Apple's System 7.5 on top of Executor.
  53.  
  54. Like Windows, System supports applications by giving them an
  55. environment to run in. Interaction between the user and System is done
  56. with a program called Finder; comparable to Program Manager within
  57. Windows.  It is Finder that generates the metaphors of folders,
  58. desktop, trash can and others. It is Finder that starts
  59. applications. With Finder the user can rename, copy and delete files
  60. and folders.
  61.  
  62. The original Finder enabled the user to run one application at the
  63. time, MultiFinder, introduced with System 6, made it possible to start
  64. several applications. Executor is a single-program-at-a-time type of
  65. emulator.
  66.  
  67. Apple is known for its furious legal attempts to protect the look-and-feel
  68. of its products (and lost most cases). Therefore ARDI has developed its own 
  69. Finder substitute, called Browser (ARDI once suggested 'Loser') which is
  70. integrated with Executor. In previous versions of Executor, the HFS_XFer 
  71. program, was used to copy, delete and rename files and folders.
  72.  
  73. System needs a harddisk with a number of pre-defined folders, one of
  74. which is the System Folder. In it you will find a file called 'System'
  75. which contains most of the Mac's operating System. On a real Mac also
  76. the file 'Finder' will be found in this folder. The System Folder is
  77. present on Executor's file system and there you will find Browser.
  78. Executor by default loads Browser when you start Executor; if you don't 
  79. want that start Executor with the -nobrowser option.
  80.  
  81. ARDI's System file is not compatible with Apple's.  If you try to use
  82. a Macintosh and replace Apple's System file with ARDI's, your
  83. Macintosh will crash.  If you try to run Executor using Apple's System
  84. file instead of ARDI's, Executor will crash.
  85.  
  86. This implies that although Executor emulates a Mac very well the first
  87. impression is that it looks different because it lacks the important
  88. Finder interface. Instead Executor either pops up a dialogue box that you 
  89. can use to tell it which program to start (-nobrowser), or it presents
  90. the Finder substitute Browser. There are a number of ways to disable Finder
  91. on a real Mac too, which saves a little memory.
  92.  
  93. Browser has a band under the menu bar with icons of commonly used 
  94. applications and directories and other objects.  This band is known as 
  95. the "hot band".  You can drag objects into and out of this band.  When you 
  96. double click on a directory or volume, a window with icons for all the files
  97. in the directory will appear.  You can drag files from one window to another
  98. to move or copy them.  To delete a file, you must select it and choose 
  99. delete; there is no trash can.
  100.  
  101. Double clicking runs an application. The band has six buttons on it
  102. which allow you to choose which kind of objects are displayed in the
  103. hot band (applications, documents, volumes, directories, fonts, or
  104. desk accesories). Also the capability to format disks is included.
  105. Executor cannot format a totally unformatted disk, but it can imprint
  106. a blank Macintosh filesystem on a high-density disk which already
  107. contains a low-level Mac or PC format.
  108.  
  109. In a separate chapter below, you will find a more detailed description 
  110. of Browser.
  111.  
  112. Since the Mac is meant to be used for graphical applications it uses a
  113. number of scalable fonts. These are stored in the 'System' file using
  114. a tool called FONT/DA Mover when using System 6. Under System 7 one
  115. can just copy a font in the System Folder and it will be recognised.
  116. FONT/DA Mover is Apple copyrighted software.  With Browser one can
  117. simply drag a font to the font "hot band", restart Executor and it will 
  118. appear within applications. (The necessity to restart of Executor will
  119. be gone in future versions.)
  120.  
  121. On a Mac, files are arranged in folders, the equivalent of MS-DOS
  122. directories. Folders can be nested and contain icons for programs
  123. and/or data files. A remarkable feature of Finder is the alias. An
  124. alias is a copy of an application's icon that can be used to create
  125. groups of objects. It is Apple's first effort towards object
  126. orientation. Changing the properties of an icon also changes them of
  127. the alias, contrary to within Windows (even within Windows 95!).
  128.  
  129. Since Executor comes without Finder, and doesn't recognize aliases, it
  130. might occur that you open a folder on a floppy or CD-ROM finding
  131. nothing in it. On a Mac there might have been aliases in those
  132. folders.
  133.  
  134. A difference that a Windows user notices is that on a Mac the menu is
  135. always on the topline of the display where in Windows the active menu
  136. is always within the current window. A Windows desktop with a number
  137. of applications running shows a lot of menus which can lead to
  138. confusion. Windows indicates the current menu by giving it a different
  139. colour. On a Mac selecting a window automatically makes its associated
  140. menu appear on the topline.  Since Executor can only run one
  141. application at a time this should not be much of a problem.
  142.  
  143. RUNNING SOFTWARE WITH EXECUTOR
  144. ------------------------------
  145.  
  146. Now that you have installed Executor on your system and you have
  147. verified that it runs, you are ready to start some of the demo
  148. software that comes with Executor. These are freeware, shareware or
  149. fully working demos of commercial packages. The files are located in
  150. the EXDEMOS.HFV DOS volume and appear after installation in an
  151. Executor volume in the 'demos' and 'games' folders. Also Executor
  152. comes with some useful utilities included in the EXSYSTEM.HFV DOS
  153. volume that appear in the 'utils' folder on your System drive.
  154.  
  155. After you have started some of these programs you probably want to do
  156. something useful with Executor. This means getting hold of the
  157. software that you need and properly installing it.
  158.  
  159. Before you start installing software there are a couple of issues that
  160. have to be understood. First you need to have set aside a volume that
  161. can hold the files you need. Such a volume can be created with MAKEHFV
  162. as stated in the appropriate section of this manual. Remember that
  163. unless you to tell Executor otherwise, your newly created volume has
  164. to have a filename ending with ".hfv" and has to be placed in the same
  165. directory as the other ".hfv" files are (the default is
  166. \EXECUTOR. 
  167.  
  168. The program that creates the new volume is called "makehfv" (make
  169. hfv).  It takes three arguments, the name of the DOS file that the
  170. volume will reside in, the name of the volume as it will be seen by
  171. any program running under Executor and the size in bytes that the
  172. volume will take up.  The suffixes "k" and "m" can be used to specify
  173. the size in kilobytes (1024 byte chunks) or megabytes (1024 * 1024 =
  174. 1048576 byte chunks).
  175.  
  176. For example, to create a 10 megabyte volume, in the DOS file
  177. newvol.hfv, with the internal name NewVolume, you would execute this
  178. command:
  179.  
  180.     C:\EXECUTOR> makehfv newvol.hfv NewVolume 10m
  181.  
  182. When you next start Executor and cycle through your available drives
  183. by clicking the 'DRIVE' button you will have an empty volume called
  184. NewVolume ready to take your files.
  185.  
  186. Also remember that Executor is a complex piece of software. ARDI has
  187. beta-tested this product thoroughly but the enormous diversity of PC
  188. hardware coupled with the complexity of emulating a totally different
  189. system on top of this hardware means that crashes are possible.  When
  190. Executor or your PC dies, unpredictable things might happen.  It is
  191. recommended that so-called write-behind-cacheing be disabled when you
  192. use Executor. Most systems nowadays use Microsoft's SMARTDRV which has
  193. write-behind-cacheing turned off by default only when you use MS-DOS
  194. 6.2 If you have another MS-DOS version or when you have turned it on
  195. please change the line that starts SMARTDRV to :
  196.  
  197.    SMARTDRV C
  198.  
  199. instead of
  200.  
  201.    SMARTDRV C+  
  202.  
  203. As always, it is best to back up your data frequently.
  204.  
  205.  
  206. GETTING HOLD OF SOFTWARE
  207. ------------------------
  208.  
  209. Apple's Macintosh is the second most widespread architecture in the
  210. world.  Software for the Mac is as freely available as for the PC
  211. platform.  There are however a few distinctions. Commercial software
  212. tends to be more expensive and sometimes updated versions arrive later
  213. than their MS-Windows counterparts. It used to be the other way around
  214. but this is the way it is.
  215.  
  216. An important issue to note here is that Executor, due to constraints
  217. in PC hardware, can only read Macintosh HD (SuperDrive) floppy-disks
  218. and Macintosh formatted CD-ROMs (more on CD-ROMs later on). SuperDrive
  219. floppy disks are physically identical to PC HD diskettes (all of them
  220. have a second hole on the other side of the write-protect notch). As
  221. on the PC they have a capacity of 1.4 Mb.
  222.  
  223. These disks share the same "low-level" format, but have a different
  224. "filesystem format" than they do on a PC. i.e. the physical format is
  225. the same as on a PC; it is just the logical format that differs.
  226.  
  227. Macintosh commercial software is available from most shops. If you
  228. have no possibility to use a 'real' Macintosh then be sure that the
  229. disks you get are HD ones. Otherwise let the dealer convert them.
  230.  
  231. Since not all software will run under Executor it is advisable to
  232. arrange with your dealer to test the software first.
  233.  
  234. Especially look for explicit statements whether the software needs
  235. System 7.  If an application *requires* System 7, then it is unlikely
  236. to work under the current implementation (1.99x) of Executor. At this 
  237. moment most of the work of System 7 emulation has been done but the
  238. bottle-neck are Apple extensions like QuickTime and Apple Events.
  239.  
  240. Good software for the Macintosh can be found with most magazines
  241. (again verify that they come with HD disks), on all commercial
  242. networks and on the Internet.
  243.  
  244. When you want to use software on a Macintosh CD-ROM, your CD-ROM drive
  245. will appear automatically within Executor if your CD-ROM controlling
  246. software conforms to Microsoft's MSCDEX or Adaptec's ASPI standard.
  247.  
  248. When you insert a Macintosh formatted HD floppy or CD-ROM these will
  249. be automatically recognised when you start Executor. If you insert
  250. them when Executor has already started, you must press
  251. Shift-left-Alt-2 before they will be seen. 
  252.  
  253. Due to size constraints on a floppy, most of the time the software on
  254. it will be in a compressed format. This is comparable to the way it is
  255. done on the PC where ZIP, ARC, ARJ and LZH are some of the used
  256. extensions to denote a compressed file. Amazingly the number of
  257. different compression systems used on Macs is as large as on the PC
  258. and all of them are different between the two platforms. Yes, there is
  259. a ZIP utility for the Mac but no available software seems to be
  260. compressed with it.
  261.  
  262. Although the naming convention for Mac files is much less constraining
  263. than the one we are familiar with on the PC (name of 8 characters and
  264. an extension of 3), most of the time the name of a compressed file
  265. ends with a decimal point followed by a three character extension.
  266.  
  267. Mind that the name of a Mac file when found on a system that has a
  268. more constraining naming convention (like MS-DOS) might not be able to
  269. tell you what sort of format it is in. However, when you transform it
  270. to Mac format (more on this later) its name will explain more. For
  271. instance you might find a file called ACMECALC.BIN on CompuServe
  272. which, when it ends up on your Executor volume, suddenly gets called
  273. 'Acme Super Calculator.sea'.
  274.  
  275. The most used compression systems and their extensions are:
  276.  
  277. .pit    ; PackIt compressed file
  278. .sit    ; Stuffit compressed file
  279. .cpt    ; Compact Pro compressed file
  280. .dde    ; DiskDoubler compressed file
  281. .sea    ; One of the above but self-extracting
  282.  
  283. For the first four files you will need the mentioned shareware
  284. programs to extract (decompress) them. The full Stuffit package can
  285. also handle the other formats. Compact Pro is found in the 'utils'
  286. folder on your System disk. Stuffit is excellent shareware and there
  287. is a freeware Stuffit Expander program that as its name suggests can
  288. only expand a compressed file (expanding again being another word for
  289. decompress, foo). DiskDoubler is less used than the others, mainly
  290. because it is commercial software.  There is a free expander though.
  291.  
  292. A .sea file basically consists of a compressed file with an integrated
  293. expander. When you start an .sea file it will expand itself
  294. automatically.
  295.  
  296. Of the mentioned decompressors there are a number of different
  297. versions to be found; not all of these work with Executor. Also some
  298. self-extracting compressed files tend to kill Executor. When this
  299. happens there is a simple but effective trick. Try to get hold of a
  300. utility called 'DeSEA'. It does what its name implies; it turns a .sea
  301. file in a .sit,.pit or .cpt file that then can be decompressed using
  302. one of the mentioned tools.
  303.  
  304. Excellent information on the various compression schemes, .hqx and
  305. BinHex formats can be found in a FAQ (Frequently Asked Questions)
  306. document on datacommunication, available via anonymous ftp on the
  307. Internet from:
  308.  
  309. site :    sumex-aim.stanford.edu
  310. file : /info-mac/comm/info/comp-sys-mac-comm-faq.txt
  311.  
  312. When the file is decompressed, you are ready to roll. Mind that a lot
  313. of software that comes on CDs take the capacity of a CD to the maximum
  314. by using audio and video clips (called QuickTime). These cannot be
  315. used in Executor. A program with such a restriction will probably
  316. complain that you need System 7; the version of the Mac's operating
  317. system that supports video.
  318.  
  319.  
  320. GETTING SOFTWARE USING YOUR PC
  321. ------------------------------
  322.  
  323. The above is all well but you might be tempted to get software for
  324. Executor by downloading files from bulletin boards and/or networks
  325. like CompuServe, America Online or the Internet. This is possible
  326. though a bit more complicated since the PC is not a Mac (you might
  327. have noticed this; ARDI lives because of it).
  328.  
  329. In the PC world every file on your harddisk comes as one logical
  330. collection of bytes, with a start, a middle and an end.  On the Mac
  331. every file has two components (honest!), these are called the
  332. data-fork and the resource-fork. The data-fork contains the data that
  333. is unformatted, or at least not formatted in a way that the actual
  334. Macintosh OS itself understands. The resource-fork contains data that
  335. is formatted in a way that the Macintosh OS understands and hence can
  336. be used to specify parameters for various Macintosh OS routines, for
  337. instance icons. Every file has both a data-fork and a resource-fork
  338. although either, (or even both) can be empty.
  339.  
  340. To enable distribution of Macintosh files on a non-Macintosh medium
  341. like most bulletin-boards, a number of people, Apple amongst them,
  342. found a way to combine the two forks in one file. Two of these systems
  343. are known as BinHex.  BinHex 4 is often known as "HQX" and it combines
  344. both forks into a single ASCII file.  BinHex 5 is often known as
  345. "MacBinary" and it combines both forks into a single BINARY file.
  346.  
  347. Since Executor at this moment does not support serial I/O all
  348. downloading of Mac files has to be done using your favourite PC
  349. communication program and your PC modem. Downloaded files will thus
  350. appear on your PC's harddisk.
  351.  
  352. If the file's description from where you downloaded it or its name on
  353. your PC's harddisk indicates that is in HQX format (for instance
  354. because its name contains the .hqx extension) there is an extra step
  355. to take.
  356.  
  357. A file with the .hqx extension has been constructed using version 4.0
  358. of BinHex. This program enables binary files to be transported on
  359. networks that otherwise would have problems with them by translating
  360. them in 7-bit ASCII text. You can try this by using your favourite DOS
  361. editor on such a file; it will contain seemingly endless lists of
  362. numbers; the human-readable equivalent of machine-code.
  363.  
  364. The supplied BinHex 5.0 program converts a.hqx file automatically to
  365. its original format. There is also an excellent shareware program
  366. called DeHQX that also gives a lot of information in the process.
  367.  
  368. To get a file converted so that it appears on an Executor Mac volume,
  369. start the program BinHex in the 'utils' folder on your System disk. In
  370. its file menu you will find a Download -> Application choice. It will
  371. pop-up a dialogue box where you can specify the file on your PC volume
  372. after which it will ask you where to store the result. When all goes
  373. well you will find some form of Mac file on the destination
  374. disk. 
  375.  
  376. If a file is not HQX'ed, BinHex effectively only copies the file and creates
  377. the two forks from the one file. To find out whether BinHex needs to take
  378. the extra step it looks for the phrase :
  379.  
  380.    (This file must be converted with BinHex 4.0)
  381.  
  382. at the beginning of the file.
  383.  
  384. CompuServe has its own Macintosh File Finder that enables you to find
  385. your favourite Mac file amongst the odd 20,000 it stores. On the
  386. Internet a lot of Mac software can be found. Look for the SimTel ftp
  387. archives.  Another good archive is the HENSA archive of Lancaster
  388. University, UK.
  389.  
  390. To summarise; when you have downloaded a Mac file it will appear to be
  391. a normal PC file on your PC. Run BinHex to write it to an Executor
  392. volume.  BinHex will automatically de-HQX the file. If required run a
  393. de-compression program.
  394.  
  395. If Executor 'touches' a file on a PC volume it immediately creates a
  396. pseudo resource fork for that file which is a separate file with a
  397. percent-sign as its first character. This can confuse BinHex and other
  398. programs, and a 'touched' file might not be shown anymore, unless you
  399. turn off the "TEXT filter" within the 'File' menu of BinHex 5.0, so 
  400. that all files are displayed instead of just "TEXT" ones. 
  401. In such a case simply delete the resource-fork file.
  402.  
  403. This problem is actually a result of a bug in Executor and hopefully
  404. the bug will be fixed soon.
  405.  
  406. A special word on text files. When you download a text file that was
  407. produced on a Mac you will experience that a number of DOS editors
  408. have problems with the fact that the Mac only uses a LF character at
  409. the end of every line, where the PC uses a CR, LF pair. Luckily the
  410. MS-DOS EDIT command can read both formats. When you open a Mac style
  411. text document, change one character and then write it back, EDIT will
  412. convert it to PC text format. There exists a shareware/freeware MS-DOS
  413. program called MAC2PC80.EXE that does this all automatically.
  414.  
  415. If you do not want to store a compressed text file on an Executor
  416. volume but want to read it using a PC editor then there are shareware
  417. PC programs, like UNSTUFF.EXE (free!) that can decompress such a file
  418. on the PC. Aladdin Systems (makers of StuffIt) have now released a very 
  419. nice Windows version of Stuffit Expander that handles almost every
  420. Macintosh file format.
  421.  
  422. Apart from files being BinHex'ed and/or compressed, more complex
  423. programs come in the form of an 'Installer'; a program that installs
  424. the software so that it is automatically copied to the proper
  425. folders. An installer most of the time also decompresses its
  426. components and scatters them around in for instance your System
  427. Folder.
  428.  
  429. The problem here is that most of the time installers are complex
  430. programs that might confuse Executor. Many installers were written by
  431. Apple and have special information about the insides of Macintoshes
  432. that the authors of Executor did not have (Executor was written using
  433. "clean room" techniques -- no Apple ROMs or System files were
  434. disassembled).  In such a case you will have to install the program on
  435. a real Mac and then transfer the installed program to an Executor
  436. volume. Afterward, if it is not publicly redistributable, delete the
  437. program from the Mac.  It is illegal not to.
  438.  
  439. On the issue of files in your System Folder; this folder acts as the
  440. notorious WIN.INI file under Windows, i.e. it is regarded as every
  441. application's liberty to litter it. A separate folder 'Preferences'
  442. most of the time holds files that store items like your highest score
  443. in your favourite game. Since Executor's System drive is limited in
  444. size it pays to occasionally delete unwanted files from the System
  445. Folder.  Be careful with the file 'Printer' though. This file is
  446. required for printing in Executor.
  447.  
  448. Note: The size of Executor's System drive is not really limited in size.
  449.       If you run out of space you have to create a second, larger System
  450.       volume with MAKEHFV. Do not call the DOS volume EXSYSTEM.HFV but 
  451.       choose a different name like EXSYS1.HFV making sure that its 
  452.       logical volume name remains System. 
  453.       The proper MAKEHFV command line would be :
  454.  
  455.          MAKEHFV EXSYS1.HFV System 2M
  456.  
  457.       to create a 2 Mb. System drive.  Copy all files from the first
  458.       drive to the second drive using Browser. Be careful; both
  459.       drives are called System - the empty one should be the
  460.       destination. When everything has been copied delete EXSYSTEM.HFV
  461.       and rename EXSYS1.HFV to EXSYSTEM.HFV. 
  462.  
  463. Transferring a file from a Mac to Executor larger than can be fitted
  464. on one floppy is not so easy. Try compressing it first. If it still
  465. doesn't fit you can use a serial cable and transfer it using two
  466. terminal programs, or try to get your hands on a program that cuts
  467. archives in parts. (StuffIt Lite 3.x can do this.)
  468.  
  469.  
  470. FILE CREATORS AND FILE TYPES
  471. ----------------------------
  472.  
  473. On a PC an application most of the time uses the 3-character extension
  474. of files to denote that it created them. For instance an application
  475. named ACMECALC might create files with an .ACM extension.  Also the
  476. extension might indicate the type of file like .TXT denoting a text
  477. file.  This way of doing things has lead to a lot of confusion since
  478. nobody is regulating the list of used extensions, and three letters
  479. doesn't lend itself to enough logical combinations.
  480.  
  481. On the Mac the above is regulated. The Mac uses a system where every
  482. file has a 4-character 'creator' and a 4-character 'type'. These are
  483. distributed by Apple - a list can be obtained of valid ones. (This
  484. does not mean that everybody follows the rules of course.) The creator
  485. field is used twofold. Firstly it tells a Mac's Finder what
  486. application to load when the user double-clicks the icon of a
  487. data-file. Secondly it enables an application to only show files in
  488. dialogue boxes that it can handle.
  489.  
  490. Normally you do not have to worry about the above, but sometimes a
  491. file that you think belongs to a certain application cannot be opened
  492. by it.  The adventurous can then change the type and or creator using
  493. a tool like File Kit or from within Browser. From the number of available 
  494. programs that can change types and creators we might conclude that the 
  495. confusion on the Mac platform as to which file belongs to who is as 
  496. confusing as it is on PCs.
  497.  
  498.  
  499. USEFUL PROGRAMS
  500. ---------------
  501.  
  502. Apart from the already mentioned utilities there are a couple more
  503. that you probably might want to look for. Get a simple text processor
  504. like UpWord to edit an occasional file or use the supplied Tex-Edit
  505. program. To view the contents of most word-processor documents get Quill.
  506.  
  507. To make sure that the files you download are not virus-ridden get
  508. Disinfectant. There are only an odd twenty viruses around but still
  509. you might be unlucky. Because Executor has slightly different
  510. "internals" than a Macintosh does, it is slightly less susceptible to
  511. virus infection than a real Mac but better not take chances.
  512.  
  513. Easy Errors tells you what an error number generated by an application
  514. actually means. (Who ever said a Mac was userfriendly?)
  515.  
  516. Get File Kit to have a look at file attributes like creation date and
  517. length.
  518.  
  519. Shareware and/or freeware programming languages are not that freely
  520. available as on the PC. There are a number of freeware 'C' compilers,
  521. ChipMunk Basic 3.21 is a simple Basic interpreter.
  522.  
  523. HyperCard from Claris runs fairly well, but some stacks will not work
  524. under HyperCard under Executor.  Supercard created stacks also usually
  525. work, although some aspects of Supercard's use of color can confuse
  526. the experimental versions of Executor that support color.
  527.  
  528. If you want to learn how to program a Mac be prepared for a shock. To
  529. fully understand how the Mac works you need to master a large and very
  530. expensive series of books from Apple, called Inside Macintosh. Apple
  531. has released a CD version of these books though.
  532.  
  533. Just like the Windows environment just knowing a programming language
  534. is not enough to write a nice looking application. On a Mac one needs
  535. to master the equivalent of the Windows API, called the Toolbox.
  536.  
  537.  
  538. LIMITATIONS ON WHAT WILL RUN UNDER EXECUTOR
  539. -------------------------------------------
  540.  
  541. On a real Mac there is a large number of ways to interact with the
  542. machine. Apart from starting normal programs, there are
  543.  
  544. - Desk Accessories; these are handy programs that can be found
  545.                     in the Apple Menu.
  546.  
  547. - Extensions;       these extend the Mac's Operating System, for
  548.                     instance for video.
  549.  
  550. - Control Panels;   enable a Mac user to control various settings
  551.                     of his/her system.
  552.  
  553. - Inits;            small programs that a Mac loads for special
  554.                     devices and/or functionality.
  555.  
  556. Apart from some Desk Accessories, Executor at this moment cannot run any 
  557. of the above.
  558.  
  559.  
  560. TRANSFERRING DATA BETWEEN MAC APPLICATIONS AND DOS COUNTERPARTS
  561. ---------------------------------------------------------------
  562.  
  563. You can manipulate data within applications on both platforms if they
  564. can read the applicable format, i.e. a Word for Windows 5.x document
  565. can be edited using Word 5 with Executor.
  566.  
  567. If you let an application produce print output then Executor puts it
  568. in a file EXECOUTx.PS within the directory where you started Executor.
  569. The 'x' is a number from 0-9.  This output is a proper PostScript file that
  570. can be printed on a printer that supports PostScript. Otherwise you can use
  571. the freeware package GhostScript to view or print them under MS-DOS.
  572.  
  573.  
  574. Browser
  575. -------
  576.  
  577. Recent 1.99x experimental pre-beta versions come with ARDI's Finder
  578. substitute, called Browser. When you normally start Executor (i.e.
  579. without the -nobrowser) option, Executor will automatically load Browser
  580. and will return to Browser when you exit an application.
  581.  
  582. Browser presents the following:
  583.  
  584. - a normal Macintosh style menu
  585. - 6 pictograms
  586. - 2 buttons
  587. - a 'hot-band' containing icons
  588.  
  589. From the menu you can for instance create folders, print files or
  590. eject a disk. CLicking on the pictograms selects the appropriate
  591. 'hot-band'. There are 'hot-bands' for drives, applications, fonts,
  592. DAs, folders and text files. The button 'Sort', sorts the current
  593. 'hot-band' and 'Help' gives a short explanation of the various
  594. 'hot-bands'.
  595.  
  596. A word about disk drives here. Executor will try to figure out what drives 
  597. are available when it loads. In a standard setup, the drives 'hot-band' will
  598. show the System: drive, your .HFV volumes and your c:/ drive. If you have
  599. a CD-ROM player available it will show up as a d:/ if MSCDEX is running.
  600.  
  601. On a Macintosh the sense hardware detects that a removable drive is
  602. inserted and its icon will show up automatically. This is different from the
  603. PC architecture. This means that Executor does not detect automatically when
  604. you insert a Mac CD-ROM or diskette. To have Executor detect such a medium
  605. select 'Check for disk' from the 'File' menu within Browser, or press
  606. Alt-Shift-2. If the medium is recognized it will show up on the drives
  607. 'hot-band'. Also you have to manually eject a drive from the 'File' menu.
  608.  
  609. Be careful not to phyiscally eject a floppy when Executor is not finished
  610. with it; buffers might not be flushed. Always use 'Eject' or Alt-Shift-2.
  611.  
  612. It is possible to drag DAs to the DA 'hot-band' and have Executor put them
  613. in the Apple menu. Not all DAs work however. Be careful to have a copy of
  614. your EXSYSTEM.HFV file. Some DAs crash Executor and weird things 
  615. might happen.
  616.  
  617. Browser can format Macintosh 1.44 Mb. diskettes. For this to work properly
  618. first check that 'Direct Disk Access' is selected. (Press Alt-Shift-5 to
  619. select the Preferences Panel.)
  620.  
  621. Bibliography
  622. ------------
  623.  
  624. Suggested further reading if you want to know more.
  625.  
  626. Title                Author            Content
  627. ---------------------------------------------------------------------------
  628. Insanely Great            Steven Levy        History of the Mac
  629.  
  630. Technical Introduction        Apple            THE Source
  631. to the Macintosh Family
  632.  
  633. comp.sys.mac.comm FAQ        D.L. Oppenheimer    Everything on
  634.                             datacommunication,
  635.                             compression and
  636.                             file formats.
  637.  
  638. Executor's FAQ            ARDI            When all else fails
  639.  
  640. All company names and products mentioned are copyrighted and trademarks
  641. of their respective owners.
  642.  
  643.  
  644. Feel free to contact me :       Ernst J. Oud
  645.                                 Compuserve : 100265,3601
  646.                                 Internet   : ernstoud@euronet.nl
  647.