Difference between revisions of "SCI Programming Language/Compiling SCI"
From SCI Wiki
Jump to navigationJump to search| (13 intermediate revisions by the same user not shown) | |||
| Line 19: | Line 19: | ||
</div><br /> | </div><br /> | ||
| − | <div align="center"><span style="font-size: 22pt"> | + | <div align="center"><span style="font-size: 22pt">Compiling SCI Code</span><br /> |
''Author: [[Jeff Stephenson]]''</div> | ''Author: [[Jeff Stephenson]]''</div> | ||
| | ||
| + | |||
| + | ==<br /> Compiling SCI Code == | ||
| + | |||
| + | The SCI compiler is invoked with the command: | ||
| + | |||
| + | <blockquote><code>sc filel [file2] [file3] [options]</code></blockquote> | ||
| + | |||
| + | Any number of file specifications may be entered on the command line, and a file specification may include wild-card names. | ||
| + | |||
| + | ===<br /> Options === | ||
| + | |||
| + | {| | ||
| + | |- | ||
| + | | align="right" valign="top"|-a||width="50"| ||Abort compile if the file is already locked.<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-d|| ||Include debugging information so that the debugger can display source code.<br /> | ||
| + | |- | ||
| + | |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).<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-g<num>|| ||Define maximum number of global or local variables. The default is 750.<br /> | ||
| + | |- | ||
| + | |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.<br /> | ||
| + | |- | ||
| + | |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.<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-O|| ||Use offset.txt to generate 994.voc.<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-oout-dir|| ||Set the directory for the output files to out-dir.<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-s|| ||Display a message when a forward referenced selector is used.<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-v|| ||Do not lock the class database.<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-w|| ||Output words high-byte first (for the Macintosh).<br /> | ||
| + | |- | ||
| + | |align="right" valign="top"|-z|| ||Turn off optimization. Not a particularly useful option except for those of us who must maintain the compiler.<br /> | ||
| + | |} | ||
| + | |||
| + | ;Notes | ||
| + | <references /> | ||
| + | |||
| + | [[SCI Programming Language | Table of Contents]] | ||
| + | |||
| + | <span style="float: left">[[SCI Programming Language/Files| < Previous: Files]]</span> | ||
| + | <span style="float: right">[[SCI Programming Language/Index| Next: Index >]]</span> | ||
| + | |||
| + | | ||
| + | |||
| + | [[Category:SCI Documentation]] | ||
| + | [[Category:SCI32]] | ||
| + | [[Category:Scripting]] | ||
Latest revision as of 23:59, 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 >
