Return to README CVS log

Up to [Research Unix] / researchv10no / cmd / ideal

Annotation of researchv10no/cmd/ideal/README, revision 1.1.1.1

1.1       root        1: This is file /usr/cvw/ideal/README.
                      2: 
                      3: The makefile in this directory assumes that all necessary
                      4: C programs reside in the directory along with it.
                      5: 
                      6: You'll need to change LIBDIR in the makefile to reflect where ideal's
                      7: library will live.
                      8: 
                      9: The only explicit call to the memory allocator is
                     10: in a macro tryalloc() defined in malloc.c.
                     11: The only explicit call to the memory free routine
                     12: is in a macro tryfree() defined in ideal.h.
                     13: You may need to use a garbage-collecting
                     14: allocator if your machine is small.
                     15: You'll notice that macro tryalloc also includes a loop
                     16: to clear the allocated node--if you want, get rid of the
                     17: loop, and call calloc;
                     18: be sure, though, to call calloc with TWO arguments,
                     19: the first being the number of nodes wanted (1).
                     20: 
                     21: Because of uucp difficulties,
                     22: there is a large file--subdirs.cpio--
                     23: created with the command cpio -o <subdirectories >subdirs.cpio
                     24: You can get them out with cpio -ir <subdirs.cpio
                     25: 
                     26: The lib subdirectory of this directory should contain
                     27: the library files you'll need--arcs, circles, etc.
                     28: 
                     29: The tests subdirectory should contain some tests that
                     30: exercise the code quite thoroughly.
                     31: The exercise is: cd tests; regress; clean
                     32: 
                     33: The idfilt subdirectory includes filters for raw
                     34: ideal output to troff, plot, and tektronix terminals.
                     35: You'll need to get into that subdirectory to make the
                     36: filters (4filt for 4014s, pfilt for general plot,
                     37: tfilt for Brian Kernighan's troff to drive the Linotron 202).
                     38: 
                     39: The shell command that invokes the ideal processor
                     40: with the correct postprocessor according to the
                     41: flags described in manpage is in ideal.cmd.
                     42: 
                     43: The following ideal documentation exists:
                     44:        my dissertation
                     45:        my sigplan conference paper
                     46:        my TOG paper
                     47:        a user manual

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.