more explanations ...

This commit is contained in:
gdr 1997-03-11 08:08:06 +00:00
parent 1ada2c4a0e
commit e5b9329e55
2 changed files with 135 additions and 0 deletions

104
NOTES/README.beta Normal file
View File

@ -0,0 +1,104 @@
$Id: README.beta,v 1.1 1997/03/11 08:08:06 gdr Exp $
This is the README file for release beta 970304. It probably needs more
detail. Mail to gno-beta@myrias.com with questions, comments, bitches,
queries, complaints.
I suggest you don't mix these files up with those from other versions of
GNO, if you can help it. It will keep things cleaner for later.
Manifest:
orcacdefs This directory contains only the defaults.h file used
in Orca/C v2.1.x. If you already have a defaults.h
file, the contents of this one should be added to
the one you already have.
You will have to change the file type of this
file. Try 'chtyp -lcc *.h'.
include This is the majority of the new header files.
They may either be placed in 13/orcacdefs, or
they may be placed in another directory (such
as /usr/include). If the latter, ensure you
have Orca/C set up to search /usr/include (or
whatever) before searching 13/orcacdefs. This
may be done with the -L occ(1) flag or the
path pragma of Orca/C.
You will have to change the file type of these
files. Try 'chtyp -lcc *.h'.
HFSinclude These are files that belong in the same hierarchy
as those in the 'include' directory, but have
non-ProDOS file names. It is possible through the
use of the path pragma to have this directory on
an HFS volume and the include directory on a
ProDOS volume.
You will have to change the file type of these
files. Try 'chtyp -lcc *.h'.
usr.man Manual pages, mostly for libc and libutil. A
work in progress. ATTENTION: See the file
NOTES/notes.* for comments on nroff; these
pages will not currently display properly on the
IIgs.
Don't worry about .so link files for now; there
is a util coming that will create them from the
mkso.data file.
Remember: The newest man binary understands the
MANPATH environment variable, so you can use more
than just /usr/man to hold your man pages.
lib/libc.v203 These are versions of libc. One of these should
lib/libc.v210 be selected based on which version of ORCALib you
lib/libc.v211b2 are using. Sorry, the earliest version of libc
that I can build is for Orca/C v2.0.3. When Orcalib
is modified, it is likely that I will only be able
to build libc for v2.1.x.
The only one of these I have tested is for Orca/C
v2.1.1b2. The selected library should be placed
in your 13/ directory, which is presumably /lib.
Currently, the libraries are built for the small
memory model, and with no optimization.
lib/libutil.203 Again, pick one to match your compiler. The second
lib/libutil.210 one can be used for generic Orca/C v2.1.x. The
routines in this library are rarely used, so the
library should go somewhere other than your 13/
directory. I suggest /usr/lib.
NOTES/README.beta
This file.
NOTES/status This lists which routines have been completed and
their test status. If you test routines that
have not been marked with a 'T' as yet, please
let me know the results via the gno-beta mailing
list -- I would like to keep the list up-to-date.
NOTES/deviations
A list of deviations from various standards or
conventions.
NOTES/notes.* Miscellaneous notes, mainly intended for Derek or
NOTES/TO.DO myself. You may find something of interest.
NOTES/headers
NOTES/Contributers
If you are using a version of Orca/C earlier than v2.1.0, you should
ensure the macros
__appleiigs__
__GNO__
are defined for your programs. This can be done by the -D occ(1) flag
or using #define in your program.
If you are using Orca/C v2.1.0 or later, you do not have to explicitly
define the above two macros as they are in the enclosed defaults.h file.
You _do_, however have to edit the __ORCAC_VERSION macro in the defaults.h
file to match your version of Orcalib. Failure to do so may cause programs
using stdio to crash.

31
NOTES/README.src Normal file
View File

@ -0,0 +1,31 @@
$Id: README.src,v 1.1 1997/03/11 08:08:06 gdr Exp $
Have a look in the NOTES directory, especially the files "status"
and "notes.*". There are notes in there on changed header files --
I have tried to minimize the impact on your work due to changed header
files, but there are a few to note. Here are two other comments
from the "notes.*" file that I would like to bring to your attention:
Currently there is a problem with the nroff package,
and many of the man pages will not look right on the
IIgs. I'm working on an update of nroff. Putting it under
Insight has shown a significant number of memory trashing
bugs (which are now gone).
I'm not done mkso yet (mkso is the program that creates
the .so links required for the various manual pages). I
still have to make it check for the legality of file names
on the current file system. I also plan to make it such
that one can place those .so links that require HFS on
another partition, and still have them find the sourced
files.
I've also included built versions of libc and libutil. IT IS CRITICAL
THAT THESE LIBRARIES ONLY BE USED WITH THE VERSION OF ORCALIB FOR WHICH
THEY WERE COMPILED, since struct FILE has changed. See the comments in
the NOTES/README.beta and orcacdefs/defaults.h files.
Also as a reminder, the gno-beta mailing list has been set up. To
join it, send email to <majordomo@myrias.com> with the following text
and nothing else in the body of the message:
subscribe gno-beta