readme.mac

早期freebsd实现

To make MacJove from the sources, you need a hard disk based Macintosh, at
least 1 mb of ram, and the LightspeedC compiler, version 2.13 or later.
Earlier versions may work but have not been used recently. Allow for the
MacJove files to take up to 1.5 mb of your hard disk. You will need a copy
of the "BinHex" utility, also.

Since LightspeedC does not work with a Makefile, none is supplied. In
general, the compiler itself will figure out dependencies for you, within a
"project". Since there are three separate projects to MacJove, you will
still have to keep track of some changes, particularly for the setmaps
project. Also, since LightspeedC only knows of .c and .h dependencies,
you will have to keep track of setmaps.txt and menumaps.txt yourself.

Preliminary Steps

0) CREATE A FOLDER (DIRECTORY) FOR JOVE. If I have to tell you how to do
that, don't go any further! Copy the source files - a few aren't needed
by MacJove, but copy them anyway, so you'll have them in one place. You
do not need anything in the "doc" subdirectory to create MacJove (but
you will eventually need cmds.doc, the help file, if you want the
"describe-command" command to work).

1) CREATE THE RESOURCE FILE: There is only one eight-bit file supplied,
"mjove.rsrc". This is a small file which contains the program icon and a
dialog template. This file must have the same name as the MacJove project,
plus extension ".rsrc". The MacJove project (below), has name "mjove", so
this file is "mjove.rsrc".  IF YOU RENAME THE PROJECT YOU MUST RENAME THIS
FILE, ALSO. Using "BinHex", unload the file "mjovers.Hqx" --> "mjove.rsrc".

2) CREATE THE "MJOVELIB" PROJECT: MacJove does not use many of the library
functions. Despite what the LightspeedC manual states, projects are loaded
as a whole: since we need only a few functions, we will build a "library" of
them in the form of a project. Run LightspeedC and create a new project,
and name it "mjovelib". Add the following files, from the Library Sources,
to the project. They all go in the same segment:

     onexit.c
     qsort.c
     stddata_ctype.c
     unixexit.c
     unixid.c
     unixmem.c
     unixtime.c

3) EXAMINE THE FILE UNIXTIME.C and make the following correction, if
necessary. The LightspeedC library function "unixtime.c" returns a string
containing the time for what is supposed to be Greenwich Mean Time, instead
of local time. Using the LightspeedC editor, and with the project open,
examine the file, comment out the definition of "GMTzonedif", and add:

     #define GMTzonedif 0

4) MAKE THE "MJOVELIB" PROJECT. Keeping the edited "unixtime.c" open,
run "make" on the project - everything will be compiled, with the altered
version of "unixtime.c". You do not have to permanently save the change
to unixtime.c, but if you do not, the next time you run "make" on the
project, it will tell you that it needs recompiling - simply ignore it.
After the mjovelib project is made, close it. You do not have to convert it
to a library - it is okay to leave it as a project.

6) CREATE THE "MSETMAPS" PROJECT. Create a new project, name it "msetmaps",
and add the following files to it:

     setmaps.c
     stdio
     strings           (segment 1)
     unix
     unix main.c
     --------
     MacTraps          (segment 2)


You should not change anything else at this point - unless you want to
reduce memory requirements (see "Running MacJove", above). If it is
necessary to reduce the memory requirements, then reduce the number of cache
buffers, NBUF, which is defined near the end of the file (each buffer takes
up 1K of space while MacJove is running).

#ifdef MAC
# undef F_COMPLETION
# define F_COMPLETION 1
# define rindex strrchr
# define bzero(s,n) setmem(s,n,0)
# define swritef sprintf
# define LINT_ARGS 1
# define NBUF 64 <---- here
# define BUFSIZ 1024
# undef LISP
# define LISP 1
# define ANSICODES 0
# undef ABBREV
# define ABBREV 1
# undef CMT_FMT
# define CMT_FMT 1
#endif

7) MAKE THE "MSETMAPS" PROJECT. Then choose "Build Application",and name it
"setmaps". 

8) RUN "SETMAPS" ON THE KEYMAPS.TXT FILE. You can either run "setmaps" from
LightspeedC, before closing the project, or as the standalone application.
When prompted for the "Unix command line", enter:

     < keys.txt > keys.c

You will get a few messages from setmaps that it can't find certain
commands. You can ignore these.

9) RUN "SETMAPS" ON THE MENUMAPS.TXT FILE. Just as before, run "setmaps"
and enter the following command line:

     < menumaps.txt > menumaps.c

You should not get any messages from setmaps. If the "msetmaps" project is
still open, close it.

10) CREATE THE "MJOVE" PROJECT. Create a new project, name it "MJOVE" and
set the Creator (signature) to 'JV01'. Add the following files in the
following segments:

     abbrev.c
     argcount.c
     ask.c
     buf.c
     c.c
     case.c        (segment 1)
     ctype.c
     delete.c
     disp.c
     extend.c
     keys.c
     --------
     fmt.c
     fp.c
     funcdefs.c    (segment 2)
     insert.c
     io.c
     jove.c
     keymaps.c
     list.c
     --------
     mac.c
     macros.c
     marks.c
     menumaps.c    (segment 3)
     misc.c
     move.c
     paragraph.c
     --------
     re.c
     re1.c
     rec.c
     screen.c
     term.c       (segment 4)
     util.c
     vars.c
     version.c
     wind.c
     --------
     MacTraps
     mjovelib
     setjmp.Lib    (segment 5)
     storage
     strings

11) MAKE THE MJOVE PROJECT. If you experience any errors, it will most
likely be from #include files not being in the default path - see the
LightspeedC manual on setting up your directories. When you are done,
run the program from the compiler to verify that it is okay, then save it as
"MacJove" using the "Build Application" command.

12) (Optional) CREATE THE HELP FILE, "CMDS.DOC". If you do not have a copy
of "cmds.doc", it must be created using nroff. Assuming you have the Jove
sources on a Unix machine, run "Make doc/cmds.doc" to create this file in
the "doc" subdirectory, then move the file to the Mac. If you obtained the
sources from a non-Unix source, this file may already be supplied. Place the
file in the same directory that MacJove will be in.

                      COMMENTS AND QUESTIONS, BUGS

Although Jove appears to work well on the Mac, I know there are some
problems. Since Jove cannot effectively use the TextEdit routines, it
does not comply with some aspects of the Macintosh User Interface
Guidelines. As has recently been brought to my attention, Jove accesses
files by pathname only, so that if you have two disks in your machine
with the same volume (disk) name, it will become confused. This has not
been fixed. Support for variant keyboards is not good at present.

I try to reply to all inquiries about MacJove, but my schedule is busy,
and it may be several days before you hear from me on the net. Please
reply via email to me, or through usenet if possible: the chances that
I will respond quickly to a written question or suggestion are very
small, and I am difficult to reach by phone. Please do NOT send disks
unless I ask you to.

    Ken Mitchum
    Decision Systems Laboratory
    University of Pittsburgh
    1360 Scaife Hall
    Pittsburgh, Pa. 15261

    ([e-mail])