Difference between revisions of "SCI Programming Language/Compiling SCI"

From SCI Wiki
Jump to navigationJump to search
 
(2 intermediate revisions by the same user not shown)
Line 33: Line 33:
  
 
===<br /> Options ===
 
===<br /> Options ===
<!-- width="135" -->
+
 
 
{|
 
{|
 
|-
 
|-
| align="right" valign="top"|-a||&nbsp;&nbsp;||Abort compile if the file is already locked.
+
| align="right" valign="top"|-a||width="50"|&nbsp;||Abort compile if the file is already locked.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-d||&nbsp;&nbsp;||Include debugging information so that the debugger can display source code.
+
|align="right" valign="top"|-d||&nbsp;||Include debugging information so that the debugger can display source code.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-D<str>||&nbsp;&nbsp;||Create a command line define which has the same result as using the define statement in a source file (except that spaces and some other |characters are not permitted).
+
|align="right" valign="top"|-D<str>||&nbsp;||Create a command line define which has the same result as using the define statement in a source file (except that spaces and some other |characters are not permitted).<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-g<num>||&nbsp;&nbsp;||Define maximum number of global or local variables. The default is 750.
+
|align="right" valign="top"|-g<num>||&nbsp;||Define maximum number of global or local variables. The default is 750.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-l||&nbsp;&nbsp;||Generate an assembly language code listing for the file with the original source interspersed. This is useful when using the built-in debugger |of SCI. When compiling filename.sc, the list file is named filename.sl.
+
|align="right" valign="top"|-l||&nbsp;||Generate an assembly language code listing for the file with the original source interspersed. This is useful when using the built-in debugger |of SCI. When compiling filename.sc, the list file is named filename.sl.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-n||&nbsp;&nbsp;||Turns off "auto-naming" of objects. As described in the appendix on object-oriented programming, each object has a name property which is used to represent the object textually. Unless the property is explicitly set, the compiler will generate the value for this property automatically, using the object's symbol string for the name. The object names, however, take up space. While they are useful (almost vital) for debugging, if you're running out of memory in a room, it might help to compile with the -n option to leave the names out.
+
|align="right" valign="top"|-n||&nbsp;||Turns off "auto-naming" of objects. As described in the appendix on object-oriented programming, each object has a name property which is used to represent the object textually. Unless the property is explicitly set, the compiler will generate the value for this property automatically, using the object's symbol string for the name. The object names, however, take up space. While they are useful (almost vital) for debugging, if you're running out of memory in a room, it might help to compile with the -n option to leave the names out.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-O||&nbsp;&nbsp;||Use offset.txt to generate 994.voc.
+
|align="right" valign="top"|-O||&nbsp;||Use offset.txt to generate 994.voc.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-oout-dir||&nbsp;&nbsp;||Set the directory for the output files to out-dir.
+
|align="right" valign="top"|-oout-dir||&nbsp;||Set the directory for the output files to out-dir.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-s||&nbsp;&nbsp;||Display a message when a forward referenced selector is used.
+
|align="right" valign="top"|-s||&nbsp;||Display a message when a forward referenced selector is used.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-v||&nbsp;&nbsp;||Do not lock the class database.
+
|align="right" valign="top"|-v||&nbsp;||Do not lock the class database.<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-w||&nbsp;&nbsp;||Output words high-byte first (for the Macintosh).
+
|align="right" valign="top"|-w||&nbsp;||Output words high-byte first (for the Macintosh).<br />&nbsp;
 
|-
 
|-
|align="right" valign="top"|-z||&nbsp;&nbsp;||Turn off optimization. Not a particularly useful option except for those of us who must maintain the compiler.
+
|align="right" valign="top"|-z||&nbsp;||Turn off optimization. Not a particularly useful option except for those of us who must maintain the compiler.<br />&nbsp;
 
|}
 
|}
  

Latest revision as of 23:59, 25 May 2016

Official SCI Documentation

Chapter: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | Index


Compiling SCI Code
Author: Jeff Stephenson

 


Compiling SCI Code

The SCI compiler is invoked with the command:

sc filel [file2] [file3] [options]

Any number of file specifications may be entered on the command line, and a file specification may include wild-card names.


Options

-a   Abort compile if the file is already locked.
 
-d   Include debugging information so that the debugger can display source code.
 
-D<str>   characters are not permitted).
 
-g<num>   Define maximum number of global or local variables. The default is 750.
 
-l   of SCI. When compiling filename.sc, the list file is named filename.sl.
 
-n   Turns off "auto-naming" of objects. As described in the appendix on object-oriented programming, each object has a name property which is used to represent the object textually. Unless the property is explicitly set, the compiler will generate the value for this property automatically, using the object's symbol string for the name. The object names, however, take up space. While they are useful (almost vital) for debugging, if you're running out of memory in a room, it might help to compile with the -n option to leave the names out.
 
-O   Use offset.txt to generate 994.voc.
 
-oout-dir   Set the directory for the output files to out-dir.
 
-s   Display a message when a forward referenced selector is used.
 
-v   Do not lock the class database.
 
-w   Output words high-byte first (for the Macintosh).
 
-z   Turn off optimization. Not a particularly useful option except for those of us who must maintain the compiler.
 
Notes


Table of Contents

< Previous: Files Next: Index >