home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 1 / 1438 / README
Encoding:
Text File  |  1990-12-28  |  2.6 KB  |  60 lines
  1. Subject: ILIB Unix Toolkit in C
  2.  
  3. This is the first posting of the ILIB Toolkit, in nine parts.
  4. ILIB is a library of C functions, complementing the collection of
  5. routines in the standard C library.  The toolkit is comprised
  6. of the C source code for ILIB, and thirtyfive standalone C programs
  7. (the tools) that rely on ILIB for parts of their functioning.
  8. The toolkit also contains a set of "man pages" in TeX that
  9. describe what each ILIB function does, and how/why the tools
  10. use the ILIB functions.
  11.  
  12. The source resides in three parallel directories:
  13.    i    contains the C source and the makefile to create ilib.a,
  14.    iex  contains the standalone C programs (tools) linking with ilib,
  15.    iman contains the "man pages" describing ilib and the tools.
  16.  
  17. The target environment of the package is SysV or BSD Unix.
  18. To make ilib, go to the "i" directory;
  19. under SysV type
  20.    make -DREALUNIX
  21. under BSD type
  22.    make
  23. The target archive ilib.a will be left in the "i" directory; this is
  24. where the tools of the "iex" directory will look for it.
  25.  
  26. To create the tools, go to the "iex" directory.  As you compile
  27. the various .c files, they all expect to #include "../i/ilib.h" and
  28. link with "../i/ilib.a", so the relative position of this directory
  29. to the "i" directory is important.  Under BSD type
  30.    ./iexmake
  31. This C shell script will compile the individual source files, and
  32. put the separate tools in your $BIN directory.
  33. Under SysV, edit "mung.c" first, adding "-DREALUNIX" in its second
  34. line.  Then execute "mung.c", to cause its own compilation, putting
  35. the "mung" tool in your $BIN directory. Use "mung" to add the
  36. "-DREALUNIX" definition to each of the other tool source files,
  37. then execute all these .c files in a loop.
  38.  
  39. To process the manual, go to the "iman" directory, and type
  40.    tex driver
  41. This creates a "device independent" output file "driver.dvi",
  42. encoding roughly 150 pages of text.  Alternately, you can edit
  43. "single.tex", selecting a single chapter or a list of chapters
  44. to process; each chapter is listed under a separate file name
  45. beginning with "i" and ending with ".tex".  Then type
  46.    tex single
  47. to process the partial man pages.  The manual expects direct
  48. access to the tool sources in the "../iex" directory, reading
  49. the "live text" of the tools' C code.
  50.  
  51. The man.tex macro sets the text size on a printed page to 7.6x5.2
  52. inches.  To center this on a laser printer, the author had
  53. good results with
  54.    iptex -X 5 -Y 7
  55.  
  56. All C sources that compile into ilib.a are in the Public Domain,
  57. clearly noted as such within each source text file.  The entire
  58. text of the man pages, and the C code of all tools in "iex" is
  59. Copyright 1990, Istvan Mohos.
  60.