
   !GCC
   ~~~~
   Purpose:  GNU C Compiler.

   Input:    Text File Containing C source code.

   Output:   Executable Absolute ARM code file. (Depending on options).

   Setup:

      Icon                       Action/Meaning                       Default
      ----                       --------------                       -------
      Source                     Name of file to be compiled            nil
                                 (typed or dragged).
      Include                    Additional include paths               C:
                                 (typed or dragged).

      Version                    Version Number of GCC.                 off

      Verbose                    Output messages during compilation.    off

      Description                GCC command line description           off

     Options:

      Compile only               Do not invoke the linker.              off

      Preprocess only            Only check for syntax errors.          off

      Use CLib                   Use the shared C Library.              on

      Throwback                  Report errors and warnings to the      on
                                 editor.

      Acorn Type C               Make strings writable and chars        on
                                 unsigned.

      Cancel                     Cancel operation and return to         off
                                 previous set of options.

      Run                        Run !GCC with chosen options.          off

   Menu:

      Entry                      Action/Meaning                       Default
      -----                      --------------                       -------
      Default Path      =>       Replace the default #include           off
                                 path with <directory>.
      Keep Comments              Prevent the preprocessor from          off
                                 removing comments.
      Define            =>       Define <symbol(s)> on entry to the     nil
                                 compiler.
      Undefine          =>       Undefine <symbol(s)> on entry to the   nil
                                 compiler.
      Debug options     =>       Generate code that may be used         off
                                 with the debugger.
      Profile                    generate profiling code.               off
      Assembler                  Output ARM assembly code instead       off
                                 of object code.
      Module code                Generate code for relocatable module.  off
      Library 1-5       =>       Specify up to 5 full file names for    off
                                 libraries to be linked with      
                                 as well the standard library.
      Library Path 1-2  =>       Specify up to 2 full file paths for    off
                                 searching for libraries to be linked with      
                                 as well the standard library.
      Features          =>       Enable a selection of compiler         off
                                 defined features.
      Suppress warnings =>       Suppress all warnings.                 off
      Suppress errors   =>       Suppress errors, treat as warnings.    off
      UNIX pcc                   Compile UNIX PCC style C source code.  off
      Others            =>       Other command-line options not         nil
                                 covered above (to be typed by hand
                                 eg. -zcp1).

