
                          U S E R  G U I D E
                        for Mo'Slo version 1.5
                    Copyright (c) David Perrell 2005

     Mo'Slo (contraction of "more slow") is a program that compensates
     for processor speed to allow speed-sensitive programs to run as they
     would on a slower processor. You execute Mo'Slo with the name of the
     program to be slowed as a command parameter. Mo'Slo slows the system
     and executes the program. When you exit the slowed program, Mo'Slo
     exits also, restoring the previous state of the system.

 INSTALLATION

     Default installation copies the Mo'Slo files into the c:\moslo
     directory ('folder' in Windows terminology). Examples in this guide
     assume that c:\moslo is the location of moslo.com. You should not
     install moslo.com in any path with a long name or name with spaces
     if you intend to use it in real-mode MS-DOS, as names in real mode
     DOS cannot exceed 8 characters plus a 3-character extension.

 COMPATIBILITY

     Mo'Slo v.1.5 can be used on systems with Intel-compatible processors
     80386 and later, running MS-DOS 3.0 and later. It can also be used in a
     Windows Virtual DOS Machine and in DOS emulators on other platforms, but
     is typically not as effective in virtual DOS, especially in NT-based
     Windows (Windows NT, 2000 and XP).

     Mo'Slo v.1.5 is for use with MS-DOS-based programs with .COM and .EXE
     file name extensions. It does not slow Windows programs or batch files
     and it does not pass command line parameters to a slowed program.
     (Other Mo'Slo products have these capabilities and more. Details and a
     comparison of capabilities can be found on the Mo'Slo website.)

 THE COMMAND LINE

     Mo'Slo is command driven. Parameters specifying percent-of-normal speed,
     slowdown method, and the filename of the program to be slowed must be
     appended to the command that loads Mo'Slo.

     A typical command to use Mo'Slo looks like this:

             c:\moslo\moslo.com /20 oldprog.exe

     The first part of this command (c:\moslo\moslo.com) tells the
     operating system's command processor to execute moslo.com, which is
     located in the moslo directory on drive C. The next two parts are
     parameters passed to moslo.com. The speed parameter (/20) tells Mo'Slo
     to slow the system to 20% of normal system speed. The last parameter
     is the name of the program Mo'Slo is to execute slowed.

     If you do not specify the filename extension on the name of the
     program to be slowed, Mo'Slo will first look for a file with a .COM
     extension, then an .EXE extension.

     The above example assumes that oldprog.exe is located in the current
     drive and directory (in Windows, the 'working' or 'startup' folder).
     If it is not, you would need to include the drive and path to the file.
     For example, if oldprog.exe is in the games directory on drive D and
     d:\games is not the current drive and directory, you would specify the
     drive:\path\filename for oldprog.exe like this:

             c:\moslo\moslo.com /20 d:\games\oldprog.exe

     When the speed parameter is omitted, Mo'Slo v.1.5 attempts to emulate
     the speed of a 4.77MHz PC-XT. Depending on processor speed, this speed
     may be slower than 1%. (Note: the emulation may be less accurate on
     post-Pentium processors and is ineffective in NT-based Windows.)

     When you execute moslo.com without any parameters, Mo'Slo displays a
     brief bit of instruction for its use.

     Note: the DOS command processor does not distinguish upper- and
     lowercase letters. For the command processor, there is no difference
     between MOSLO.COM and moslo.com. Also note that the DOS command
     processor looks for .COM files first when no extension is given, so
     if you are entering commands at the prompt you can simply type moslo
     rather than moslo.com.

 COMPUTING THE PERCENT-OF-NORMAL-SPEED PARAMETER

     Slowdown is specified as percent-of-normal speed, in 0.01% increments,
     from 0.01% to 99.99%.

     To estimate a target speed for a particular program, divide the MHz
     at which the program runs well by the MHz of the system on which you
     are running it. For example, if your system is 1 GHz (1,000 MHz) and
     the program you want to run is designed for a 66 MHz processor, divide
     66 by 1000, then multiply by 100 to get the % of system speed:

              66/1000 * 100 = 6.6

     The speed argument is /6.6 (do not include the % sign).

     If the speed is too slow, use a larger number. If the speed is still too
     fast, you may need to try both larger and smaller numbers. Too small a
     number can make it appear that you are not slowing enough when you are
     really slowing too much, as virtual speed may increase erratically
     below an ideal percentage.

     The percent-of-normal-speed parameter is optional. If speed is not
     specified, Mo'Slo will attempt to emulate a 4.77 MHz IBM PC

 SPECIFYING THE SLOWDOWN METHOD

     By default, Mo'Slo uses the system timer to allot processing time to a
     slowed program. Mo'Slo v.1.5 now includes an alternate slowdown method
     that uses the realtime clock. You specify use of this alternate method
     by including the /m2 parameter in the command line. Example:

             c:\moslo\moslo.com /0.9 /m2 oldprog.exe

     The advantage of using the alternate method is smoother slowdown,
     especially at very low percentages. One disadvantage is that some
     runtime errors caused by system speed--particularly load-time divide
     errors 200 and R6003 in programs developed in the early 1990s--are not
     overcome when the alternate slowdown method is used. Another is that
     a system reset (hard reboot) may be needed if a program slowed with
     this method crashes the system. This is because a normally-disabled
     function of the real time clock must be enabled to use this method,
     and a soft reboot using Ctrl+Alt+Del may not reset the default state.

 CHANGING THE CURRENT DIRECTORY

     Many old programs need to access files in the directory where the
     program is located. Therefore, it is best to change the current drive
     and directory to that of the program to be slowed prior to executing
     Mo'Slo. At the command prompt, you change the current drive by entering
     the drive letter. You then use the CD (change directory) command to
     change the current directory for that drive.

     If we assume moslo.com is in the moslo directory on drive C and
     oldprog.exe is in the games directory on drive D, the following three
     commands, entered at the command prompt, change the current drive to D,
     change the current directory to games, then execute moslo.com, which
     executes oldprog.exe at a virtual 10% of normal speed:

             d:
             cd \games
             c:\moslo\moslo /10 oldprog.exe

 SLOWING A COMMAND PROMPT

     You can use Mo'Slo to slow a copy of the DOS command processor. Any
     DOS programs you run from the slowed prompt will run slowed, including
     DOS batch files. The slowdown stays in effect until you enter 'exit'
     at the prompt.

     In 'real' MS-DOS there is usually a command processor in the root
     directory of drive C. To slow a prompt to 40% normal speed, enter:

             c:\moslo\moslo /40 c:\command

     In Windows 9x/ME, the command processor is in the Windows directory.
     Click 'Start' 'Run...' and enter this command:

             c:\moslo\moslo.com /40 c:\windows\command

     In Windows NT, 2000, and XP there are two command processors, the
     16-bit command.com and the 32-bit cmd.exe. To slow either, first click
     'Start' 'Run...'. To slow cmd.exe enter:

             c:\moslo\moslo.com /40 %systemroot%\system32\cmd

     To slow command.com enter:

             c:\moslo\moslo.com /40 %systemroot%\system32\command

     Windows will replace %systemroot% with the correct location.

 ADDING SLOWDOWN TO WINDOWS SHORTCUTS

     The easiest way to use Mo'Slo in Windows is to create a Windows
     shortcut for each program you want to run slowed. The easiest shortcut
     to use is a desktop shortcut. To create a desktop shortcut, close all
     program windows, position the cursor on an empty area of the desktop,
     and click the right mouse button. This should pop up a menu. Position
     the cursor over the word 'New'. This should pop up a second menu.
     Position the cursor on the word 'Shortcut' and click the left mouse
     button to start the shortcut wizard.

     In Windows 9x/ME, a text box will be labeled 'Command line:'; in
     Windows NT/2000/XP it will be labeled 'Location:'. In either case,
     you can click the 'Browse...' button to find the program file you
     want to run slowed. When the program name is in the text box, click
     'Next'. Enter a name for the shortcut (this is the name that will
     appear on the desktop), then click 'Next'. Now select an icon and
     click 'Finish'. There should now be a shortcut on the desktop.
     (Note: some DOS programs have an icon file in the same directory
     as the program file. In this case you will not be asked to choose
     an icon when creating a shortcut; the program's icon will be used.)

     Position the cursor over the desktop shortcut and click the right
     mouse button. Left-click on the word 'Properties' to pop up the
     shortcut's properties box. Left-click on the 'Program' tab. In the
     box labeled 'Cmd line:', delete the drive letter and path, leaving
     only the name of the file. Then, to the left of the file name, type
     the complete filename of moslo.com, followed by the speed parameter,
     followed by a space. Leave the 'Working:' box as is. (Note: if there
     is no program tab in the shortcut properties, the file to be slowed
     is almost certainly either a Windows-native program or batch file,
     neither of which can be slowed by Mo'Slo v.1.5.)

     As an example, assume that you are creating a shortcut to slow
     c:\games\old\oldprog.exe to 10% of normal speed. The Cmd line under
     the 'Program' tab would look like this:

             c:\games\old\oldprog.exe

     After deleting everything to the left of oldprog.exe, the Cmd line
     would look like this:

             oldprog.exe

     After typing the complete filename of moslo.com and the speed argument
     followed by a space, the Cmd line would look like this:

             c:\moslo\moslo.com /10 oldprog.exe

     The 'Working:' box should already read:

             c:\games\old

     and should be left unchanged.

     When you have finished editing the Cmd line, check the 'Close on
     exit' box and click 'OK' to close the Properties dialog. Then
     double-click the shortcut on the desktop to test slowdown. Adjust
     the speed parameter in the shortcut properties as necessary.

     Note: If the program to be slowed suffers from load time failure,
     then it is a good idea to leave the 'Close on exit' box unchecked
     until you are certain the speed parameter is optimal. Otherwise you
     will not be able to read any load time error messages before the
     slowed program's window closes.

     There are other settings in the shortcut Properties that can affect
     slowdown. More consistent slowdown can sometimes be achieved by
     setting the 'Idle sensitivity' slider under the 'Misc' tab all the
     way to 'Low'. You may also find that some programs that would
     normally display in a window work better 'Full screen'.

 UNHIDING FILE EXTENSIONS IN WINDOWS EXPLORER

     By default, Windows Explorer hides many filename extensions, including
     .EXE, .COM, and .BAT. To show the file extensions, click 'Start',
     'Run...' and enter "Explorer." Look in the 'View' and 'Tools' menus
     to find 'Folder Options...' (or just 'Options...') and left-click it to
     open the Folder Options menu. Left-click on the 'View' tab. Uncheck the
     box labeled 'Hide file extensions for known file types' (or 'Hide
     MS-DOS file extensions..'), then click 'OK'.

 REAL MS-DOS IS BEST FOR DOS-BASED SLOWDOWN

     Mo'Slo v.1.5 uses the system timer and realtime clock to allot
     processing time to a slowed program, and these timers are most directly
     and exclusively accessible in real mode MS-DOS.

     Unfortunately, you cannot get to real mode directly from 32-bit Windows
     without rebooting. Windows 95 & 98 let you to start real-mode MS-DOS
     at boot time by pressing the F8 key immediately before Windows starts,
     then selecting Command Prompt Only from the menu, and also let you
     reboot to real-mode MS-DOS from a shortcut, with custom config.sys
     and autoexec.bat settings. But running real-mode MS-DOS with other
     32-bit Windows versions typically requires a bootable MS-DOS diskette
     or CD-ROM, or a dual-boot system.

 IF YOU NEED HELP...

     Visit the Mo'Slo website at http://moslo.info. Check out the SUPPORT,
     FAQ and FEEDBACK sections. If you don't find a solution, email the
     support department with the information requested in the SUPPORT
     section. If you are more comfortable using the telephone, you can
     usually reach a support person at +1 (818) 884-7157 between 9am and 5pm
     Pacific Time, Monday through Friday. It is financially unfeasible for
     us to return support calls, so if you get voice mail, please leave
     a message with a brief description of the problem and a time when
     you plan to call again and we'll try to have someone available and
     prepared to help. To ensure you reach a person on the first call,
     pre-arrange a call time via email (support@hpaa.com). Please include
     the product name "Mo'Slo" in the subject of your email.

 MO'SLO EVALUATION LICENSE

     The Mo'Slo version 1.5 software program (the Software) is owned by
     David Perrell (the Author) and is protected by United States copyright
     laws and related international treaty provisions. You are licensed by
     the Author to use and distribute the Software subject to the following
     terms and conditions:

     1. You may use the Software without charge for a period of 15 days to
        evaluate its fitness for your needs. If the Software fulfills your
        needs, or if you wish to continue to use the Software for more than
        15 days, you must purchase an End User License UNLESS your ONLY use
        of the Software is for your personal recreation NOT associated with
        any commercial or government enterprise, in which case you may
        continue to use the Software without charge.

     2. You may freely distribute the Software ONLY in the form of the
        Author-written installer program titled "Mo'Slo Eval Installer,"
        which displays this license prior to installing the Software and
        User Guide. No compensation may be accepted for distribution of the
        Software. The Software may not be sold, traded, bundled with other
        goods or services, or used for promotional purposes without prior
        written permission from the Author.

     3. You may not make or have made any modification to the Software,
        User Guide, or installer program. You may not adapt, translate,
        reverse-engineer, disassemble, or create derivative works based on
        the Software.

     Use of the Software implies agreement to abide by the above terms and
     conditions. If you do not agree to any of these terms or conditions,
     do not use, copy, or distribute the Software. The Author reserves the
     right to revoke the right to distribute the Software at any time.

     ===================== DISCLAIMER OF WARRANTY ========================

     Mo'Slo is provided without warranty of any kind, express or implied,
     and the user assumes the entire risk of using it. The author will not
     be liable for any incidental, consequential, indirect or similar
     damages resulting from the use of this software. In no event will the
     author's liability ever exceed the price paid for the license to use
     the software, regardless of the nature of the claim.

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

 LICENSING MO'SLO VERSION 1.5

     A single-terminal End User License for Mo'Slo 1.5 is only USD 15 ($15),
     less when more than 5 are purchased at one time. An End User License
     eliminates the 'evaluation ended' notice. Visit the Mo'Slo website at
     http://moslo.info for ordering options and multi-license pricing, or
     contact us by other means if Internet access is not available to you.

 MORE CAPABLE MO'SLO PRODUCTS

     Mo'Slo v.1.5 is simple by design--modeled on the original Mo'Slo
     released in 1990. Other Mo'Slo products have added capabilities and
     convenience features, such as slowdown of batch files, run-time speed
     adjustment, passing of parameters to slowed programs, slowdown delay
     and duration, cache disabling, and Windows-based slowdown with an
     easy-to-use graphical interface. To learn more about Mo'Slo products
     and find the one best suited to your needs, please visit the Mo'Slo
     website at http://moslo.info

 CONTACT US

     Dr.David's Super Crispy Software
     division of Hearn/Perrell Art Associates
     23022 Hatteras Street
     Woodland Hills, CA 91367

     Telephone: +1 (818) 884-7151   Support voice/FAX: +1 (818) 884-7157
     Email: moslo@hpaa.com    Website: http://moslo.info
     
     Bus. hrs.: 9am-5pm Pacific time (GMT-0800, GMT-0700 dst)
     _____________________________________________________________________

     IBM PC, XT are trademarks of International Business Machines
     MS-DOS and Windows are trademarks of Microsoft Corporation
     Mo'Slo is a trademark of David Perrell
