#shell_main The Mark Williams Shell (MWS) provides an integrated environment for editing, compiling, debugging and executing your programs. To select one of these functions, use the arrow keys to position the cursor bar over the desired choice, then press return. To leave the MWS, press the key. Short descriptions of each command follow. EDIT: Create a new file or edit an existing one. Edit invokes the MicroEMACS editor. COMPILE: Compile an existing C program. In the Compile menu, you may choose whatever compiler options you need, or simply execute a prior command line. RUN: Use RUN to execute a compiled program. DEBUG: Invoke the C Source Debugger (csd) to begin a debugging session. The entire dialogue in csd will reference your C source code. MAKE: Create a script for complex compilation sequences. Speeds compile time by eliminating unnecessary compilation. BUFFERS: Tailor the in-RAM compilation/accelerator to your needs. Allocate more memory, or add expanded memory, for even faster compilation. QUICK DOS: Accepts one DOS command and returns to MWS. !DOS ESCAPE: Exit to DOS for unlimited DOS commands. In-RAM compilations and accelerator are still active. Type 'exit' to return to MWS. NEW DIRECTORY: Changes the current working directory. #shell_main_edit Edit invokes the MicroEMACS editor. EXECUTE: Invokes the editor for the file named in the menu box. FILES: Lists files in current directory available for editing. Follow with the execute command to invoke the editor. NEW FILE: Lets you name a new file to edit. Follow with the Execute command to invoke the editor. #shell_main_edit_file Name a new file to edit. Follow with the Execute command to to invoke the editor. #shell_main_edit_files Select file(s) for editing. Then, use the Execute command to begin edit. #shell_main_compile EXECUTE: Invoke compiler and linker based on command line in command box. OPTIONS: Choose options for the compile command line. End list with END key. Backspace key deletes an option from the command line. FILES: List files in current directory with '.C' or '.OBJ' suffix. Use to add appropriate file(s) to command line. Follow with Execute command to compile. #shell_main_compile_files List files in current directory with '.C' or '.OBJ' suffix. Use to add appropriate file(s) to command line. Follow with Execute command to compile. #shell_main_compile_options Choose an option by moving the highlight bar to the option and pressing return. Press the key once all desired options are selected. Delete an option by moving the highlight bar to the desired option and pressing backspace. For detailed information on each option, see the Lexicon entry for 'cc' or the introduction to the manual. #shell_main_run EXECUTE: Run a compiled program listed in the command box. ARGUMENTS: After file is selected, use Arguments to enter the desired run time arguments in the command box. FILES: Lists '.EXE' files(s) in current directory. Choose one, then select Execute to run. #shell_main_run_arguments ARGUMENTS: After file is selected, use Arguments to enter the desired runtime arguments in the command box. #shell_main_quickDOS Accepts and executes one DOS command, then returns to MWS. #shell_main_directory Enter desired directory pathname, followed by return. #shell_main_debug Debug your programs with the csd C Source-Level Debugger. EXECUTE: Invokes the debugger for the file and options displayed in the command box. OPTIONS: Choose options for command line. End list with key. Backspace key deletes an option from the command line. ARGUMENTS: After selecting file to debug, use Arguments to enter command line parameters. FILES: Lists '.exe' files in current directory. Note: files must have been compiled using the '-vcsd' option for csd to debug your program. #shell_main_debug_options Choose an option by moving the highlight bar to the option and pressing backspace. For detailed information on each option, see the Commands Reference section in the csd C Source Debugger manual. #shell_main_debug_arguments Select file to debug, then use Arguments to enter the target program's command line parameters. #shell_main_debug_files Choose the .EXE file to debug. In order to use csd on a .EXE file, the program must have been compiled using the -VCSD option. #shell_main_make MAKE provides a systematic and efficient procedure for compiling a program comprised of several source files. EXECUTE: Invoke the makefile in the current directory based on the information in the command box. OPTIONS: Choose options for the make command. End list with key. Backspace key deletes an option from command line. MACROS: Create macros used to eliminate repetitive typing or allow special option at run time. TARGETS: Enter name(s) of target file(s) to be made. #shell_main_make_options Choose an option by moving the highlight bar to the option and pressing return. Press the key once all desired options are selected. Delete an option by moving the highlight bar to the option and pressing backspace. For detailed information on each option, see the Lexicon entry for Make or the tutorial for Make in the manual. #shell_main_make_macros Macros should be of the form 'a=b'. Macros can increase the flexibility of your makefiles. #shell_main_make_targets Enter name(s) of file(s) to be made. #shell_main_make_Alternate makefile Enter the name of the makefile if its name is not 'makefile' #shell_main_buffers Tailor the in-RAM compilation accelerator to your needs. Allocate memory or add expanded memory for faster compilation. LOAD/UNLOAD: Tell MWS to load or unload the accelerator. DISK DRIVES: Select disk drives to accelerate. The default is '*', or all drives accelerated. BUFFER SIZE: Change the size of the buffer reserved for the accelerator. Default size is 128K. WRITE OPTIONS: Choose how data will be saved to disk: memory, timed save or disk. For details on write options, see the Let's C manual. SAVE DATA: Write to disk all data stored in the accelerator's buffer. CHANGE DISK: Write to disk all data in the buffer, then clear the buffer for a new disk. EXPANDED MEMORY: Tell MWS to create buffers in the expanded memory rather than in main memory. #shell_main_buffers_load/unload Load or unload the accelerator. #shell_main_buffers_drive Select the disk drives you want to accelerate. The default is '*', or all drives accelerated. #shell_main_buffers_size Change the size of the buffer reserved for the accelerator. Default size is 128K. #shell_main_buffers_write Choose how data will be written to disk: Memory, Timed Save, or disk. For complete information on the write options, see the Let's C manual. #shell_main_buffers_save Write to disk all data stored in the accelerator's buffer. #shell_main_buffers_change Write to disk all data stored in the accelerator's buffer, then clear the buffer for a new disk. #shell_main_buffers_expanded Creates buffers in the expanded memory rather that in main memory.