Difference between revisions of "SCI Programming Language/Compiling SCI"
From SCI Wiki
Jump to navigationJump to search| Line 36: | Line 36: | ||
{| | {| | ||
|- | |- | ||
| − | |align=right" valign="top"|-a||Abort compile if the file is already locked. | + | |align="right" valign="top"|-a||Abort compile if the file is already locked. |
|- | |- | ||
| − | |align=right" valign="top"|-d||Include debugging information so that the debugger can display source code. | + | |align="right" valign="top"|-d||Include debugging information so that the debugger can display source code. |
|- | |- | ||
| − | |align=right" valign="top"|-D<str>||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>||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"|-g<num>||Define maximum number of global or local variables. The default is 750. | + | |align="right" valign="top"|-g<num>||Define maximum number of global or local variables. The default is 750. |
|- | |- | ||
| − | |align=right" valign="top"|-l||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||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"|-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. | + | |align="right" valign="top"|-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. |
|- | |- | ||
| − | |align=right" valign="top"|-O||Use offset.txt to generate 994.voc. | + | |align="right" valign="top"|-O||Use offset.txt to generate 994.voc. |
|- | |- | ||
| − | |align=right" valign="top"|-oout-dir||Set the directory for the output files to out-dir. | + | |align="right" valign="top"|-oout-dir||Set the directory for the output files to out-dir. |
|- | |- | ||
| − | |align=right" valign="top"|-s||Display a message when a forward referenced selector is used. | + | |align="right" valign="top"|-s||Display a message when a forward referenced selector is used. |
|- | |- | ||
| − | |align=right" valign="top"|-v||Do not lock the class database. | + | |align="right" valign="top"|-v||Do not lock the class database. |
|- | |- | ||
| − | |align=right" valign="top"|-w||Output words high-byte first (for the Macintosh). | + | |align="right" valign="top"|-w||Output words high-byte first (for the Macintosh). |
|- | |- | ||
| − | |align=right" valign="top"|-z||Turn off optimization. Not a particularly useful option except for those of us who must maintain the compiler. | + | |align="right" valign="top"|-z||Turn off optimization. Not a particularly useful option except for those of us who must maintain the compiler. |
|} | |} | ||
Revision as of 23:51, 25 May 2016
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
< Previous: Files Next: Index >
