home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / reviewed / volume01 / cextract / part01 / INSTALL.VMS < prev    next >
Text File  |  1991-07-08  |  3KB  |  79 lines
  1. Okay, so, I have to assume that you somehow got the unix shar files
  2. unpacked.  If you got some warnings about "wc" not being found, then
  3. you can ignore them, since that is a unix program which was just trying
  4. to do checksums.  [hopefully everything unpacked okay :-)]
  5.  
  6. Now, the way to build the programs is simple:
  7.  
  8.  - first take a look at the xtract.h file and determine if any of the
  9.    settings need adjusting.  Pay careful attention to the following
  10.    definitions:
  11.  
  12.         CEXTDOC_NAME      - name of the documentation extraction program
  13.         CONFIG_FILE       - name of the configuration file
  14.         SYS_CONFIG        - location of the global system configuration file
  15.  
  16.    It should be possible to change them on the command line, using the
  17.    newbuild.com file, instead of build.com, but I have not been able
  18.    to test it.
  19.  
  20.  - @build (or @newbuild) or just compile and then link the main.c and
  21.    parse.c files.
  22.  
  23. Note that on VMS systems that I have heard about the C compilers do
  24. not have support for retaining the comments after preprocessing. So,
  25. the cextdoc program and the cextract comment functions are pretty
  26. useless on VMS systems.  [Perhaps the GNU C compiler supports it?]
  27.  
  28. I have provided a VMS help file to give a documentation method for
  29. normal VMS users.  It is the file:
  30.  
  31.   cextract.hlp
  32.  
  33. You might also want to look at the text files:
  34.  
  35.   cextract.doc cextrc.doc
  36.  
  37. since even though they are the documentation for a normal Unix system,
  38. they do document the VMS version as well.  The ".hlp" file should be
  39. more than enough, though.
  40.  
  41. Anyway, you can now place the binary wherever you want.  You can also
  42. copy it into "cextdoc" (or whatever you set CEXTDOC_NAME to) and
  43. thereby obtain a program with the documentation extractor as the
  44. default mode.  [It checks the name as it is called]
  45.  
  46. In order to simplify access to the program(s), you will need to define
  47. a foreign command using:
  48.  
  49.       cextract == "$the_disc:[the_directory]cextract"
  50.  
  51. Where "the_disc" and "the_directory" have the values for where you
  52. placed the binary.  I suppose that line can be added to your LOGIN.COM
  53. file.
  54.  
  55. You might consider building a system configuration file, which would
  56. contain any default options you might wish to have, as well as any
  57. "replace" commands which your system might need.
  58.  
  59. To determine what kind of things might need replacing, you can look at
  60. the standard header files on your system, searching for things which
  61. you had considered a "typedef" but which were really "#define"
  62. sequences.  The one noticable one on my Sun is:
  63.  
  64. #define FILE struct _iobuf
  65.  
  66. Since I found that FILE was defined like this on most systems, I made
  67. sure to automatically build the replacement into cextract.  The
  68. varargs system also uses a similiar mechanism, so I made sure to
  69. handle that as well.
  70.  
  71. If you get any error messages or warnings, please let me know.  If you
  72. have any problems at all, or even just a friendly suggestion, feel
  73. free to send me mail about it.
  74.  
  75. Adam Bryant
  76. adb@bu.edu
  77.  
  78.  
  79.