6.2: How do I set up ORCA/C so that I can use it with GNO?
Description
This article is from the Apple II GNO FAQ, by Devin Reade with numerous contributions by others.
6.2: How do I set up ORCA/C so that I can use it with GNO?
A#6.2: === See the CAVEAT in Q#6.1 ===
There are a few aspects to this, so it has been split into various
questions in this section of the FAQ. You should read each of
those questions when so directed, below. The following instructions
assume that you have already installed your ORCA languages; various
files and directories will be moved from their original locations.
If you haven't already done so, change the auxtype of
(original_orca_directory)/shell/Editor to hex DC00 (see Q#14.1).
Next, create the directory /lang/orca. This will be the new
location of your ORCA distribution. You should move all the
files and directories from you original ORCA location to /lang/orca.
You will therefore have directories like /lang/orca/shell,
/lang/orca/languages, and so forth.
The next step is to set up the appropriate GS/OS prefix numbers.
This procedure is documented in Q#6.3 (don't forget to update
both your 15/login and ~/gshrc files).
Next, set up your defaults.h file as described in Q#6.5. As per
the caveat in Q#6.1, this file will be parsed regardless of which
version of ORCA/C you're using.
Now, if you're running GNO v2.0.4, you have to modify some header
files. See Q#6.6.
Next you have to set up your libraries. This information is specific
to your GNO-ORCA/C version combination. See questions Q#6.7, Q#6.8,
Q#6.9, or Q#6.10 as appropriate. Note that the library /lib/libgno
is obsolete in both GNO v2.0.4 and v2.0.6. If your /lib directory
resides on an HFS partition, you will need to rename some of your
libraries (see also Q#11.4).
If you're using an older version of ORCA/C, you should prototype
your headers (this is already done for newer versions of ORCA/C).
Using prototyped headers and #pragma lint -1 can catch a lot of
bugs, both in user code and in the compiler. Be very careful that
you use the correct prototypes.
For programs in your 17 directory that don't work with GNO (such
as prizm), I recommend putting something like the following in
your ~/gshrc:
alias prizm echo "prizm not available under GNO"
Remember to put 17 in your PATH environment variable. See the
Gsh Reference Manual if you don't know how to do this.
Finally, if you're using ORCA/C v2.0.x, ensure you have occ v1.14
installed (other versions -- earlier or later -- will not suffice).
Also edit both 15/login and ~/gshrc to define the CCOLD environment
variable. Do NOT define the CCOLD environment variable if you are
using ORCA/C v2.1.x; you will slow down your compilations.
Continue to:
My Books
