                                ┌┬──────────┬┐                                
                                ││  Record  ││                                
                                └┴──────────┴┘                                
                                                                              
    Function key usage                                       Mouse            
                                                                              
   F1      - Display this help information.                  [Help]           
   F2      - Clear recording.                                [Clear]          
   F3      - Exit program.                                   [Exit]           
   F4      - Write recording to disk.                        [Write]          
   F7      - Start/Stop recording.                           [Record/Stop]    
   F9      - Decrement cell value.                           <left button>    
   F10     - Increment cell value.                           <right button>   
   Alt-F2  - Toggle MIDI thru mode off/on (default is on).   [Thru]           
   Alt-F3  - Push to DOS.                                    [Push]           
   Alt-F10 - Toggle IBM Music Feature music mode.                             
                                                                              
 ┌─────────┐                                                                  
 │ Editing │                                                                  
 └─────────┘                                                                  
                                                                              
 Use the arrow keys to move the large block cursor around the screen to       
 select the available data fields or "cells".  On a color monitor, the data   
 in cells which can be changed will appear yellow.  Note the input area near  
 the bottom of the screen, indicated by ">" and the small blinking cursor.    
 To enter or change a selected cell, type into the input area and press       
 return.  The value entered will then appear in the cell (if the input was    
 valid).  A description of the valid input for the current cell will always   
 appear on the line above the input area.                                     
                                                                              
 Use the following keys for editing:                                          
                                                                              
  Return    - Retrieves the current contents of a cell and places it in the   
               input area for modification (if the input area is empty).      
  Insert    - Toggles between character insert and overwrite modes.           
  Delete    - Deletes the character at the cursor.                            
  BackSpace - Deletes the character before the cursor.                        
  End       - Moves to the end of the character string.                       
  Home      - Moves to the beginning of the character string.                 
  Escape    - Erases the input area.                                          
                                                                              
 ┌───────────┐                                                                
 │ Operation │                                                                
 └───────────┘                                                                
                                                                              
 When RECORD is run without specifying a file name on the command line, it    
 executes interactively.  Several options can be specified by filling in the  
 data cells on the screen prior to recording.  To begin recording, press F7   
 (or click the [Record/Stop] block at the bottom of the screen).  Recording   
 begins with the first MIDI event received, and continues until F7 is pressed 
 again.  Recording may be stopped and resumed any number of times.  To begin  
 a new recording, press F2 to clear.  Don't forget to use F4 (Write) first if 
 you want to save the recording.                                              
                                                                              
 Data cells:                                                                  
                                                                              
 - File:  The name of the MIDI output file.  The default name is "out.mff".   
   Recording can be initiated repeatedly and the output file will be replaced 
   each time F4 is pressed unless the name is changed.                        
                                                                              
 - Title:  A short descriptive note to be included in the file for use by a   
   MIDI file-capable sequencer or other reader.                               
                                                                              
 - Tempo:  The base tempo assigned to the sequence.  The default is 120       
   quarter note beats per minute.                                             
                                                                              
 - Format:  One of 2 supported MIDI file formats: 0 or 1.  Format 0 is the    
   most portable.                                                             
                                                                              
 - Delay:  Allows a pause to be inserted at the beginning of the sequence.    
   Normally, the first MIDI event will be recorded at time 0, but if this     
   value is non-zero, the first event will start at the specified time (in    
   tenths of a second).                                                       
                                                                              
                                                                              
 ┌─────────────┐                                                              
 │ Mouse usage │                                                              
 └─────────────┘                                                              
                                                                              
 When a Microsoft-compatible mouse is available and the mouse driver software 
 properly loaded, operations using the mouse will be enabled.  The mouse may  
 be used to select an input cell on the screen by positioning the small mouse 
 cursor on the cell and single clicking either button.  The cell will be      
 highlighted, just as if the cell had been selected using the arrow keys.     
                                                                              
 Any cell which can be changed using the F10/F9 keys to increment/decrement,  
 may be changed in a similar manner using the mouse.  Once a cell is selected 
 by clicking on it, subsequent clicking of the left button will decrement the 
 cell value, and clicking of the right button will increment it.              
                                                                              
 In mouse mode, the function key designations normally displayed at the       
 bottom of the screen are changed to selector blocks for each available       
 function.  Clicking on a block will perform the indicated function.  All     
 functions may still be invoked via the normal keyboard equivalents.          
                                                                              
 If mouse operations are not desired, add the -k option on the command line   
 when the program is run to force keyboard mode.                              
                                                                              
 ┌────────────────────┐                                                       
 │ Command line usage │                                                       
 └────────────────────┘                                                       
                                                                              
 RECORD <filename> <options>                                                  
                                                                              
 If <filename> is specified, RECORD is run non-interactively (i.e., recording 
 is begun and the given file is used for the MIDI file output).  Recording    
 begins when the first MIDI event is received, and continues until a key is   
 pressed (on the computer keyboard).  Interactive mode is selected simply by  
 leaving off the file name.                                                   
                                                                              
 <options> may be any of the following:                                       
                                                                              
                                                                              
 -d  Selects the MIDI interface to use if more than one is present in the     
     system:                                                                  
                                                                              
              -dmfc      selects IBM Music Feature                            
              -dmpu      selects MPU-401 compatible                           
              -dmidiator selects MIDIator                                     
              -dserial   selects generic 38400 baud serial                    
              -dsbmidi   selects Sound Blaster MIDI                           
                                                                              
              (The first 3 letters of the device name are sufficient.)        
                                                                              
     Optional IRQ and I/O port address information can be added following     
     the device id if necessary:                                              
                                                                              
              -dxxx:<irq>:<ioaddr>                                            
                                                                              
     For example, to define an MPU-compatible interface using IRQ 5 and I/O   
     address 332 (hex), use:                                                  
                                                                              
              -dMPU:5:332                                                     
                                                                              
     If only the I/O address is required but the default IRQ is alright,      
     use -dMPU::332.                                                          
                                                                              
 -i  Try to determine the IRQ in use automatically (MPU and MFC only).        
                                                                              
 -v  List the type of interface actually selected before starting.            
                                                                              
 -k  forces keyboard mode if a mouse is present.                              
                                                                              
 -m  forces monochrome mode (mono mode is automatically detected).            
                                                                              
  Separate all options with at least one space.                               
                                                                              
                                                                              
 Examples:                                                                    
                                                                              
   record                   (Runs the program interactively)                  
                                                                              
   record test.mff          (Begins recording to file test.mff)               
                                                                              
   record -dmpu::336        (Runs interactively; forces MPU I/O address 336)  
                                                                              
   record test.mff -dmfc    (Records to file, forcing MFC mode)               
                                                                              
 ---------------------------------------------------------------------------  
