home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / mail / mh.6.7.README < prev    next >
Encoding:
Text File  |  1991-12-30  |  2.7 KB  |  96 lines
  1.  
  2.     MH 6.7 for the NeXT. Feel free to send me any bug fixes you might
  3.     have. I'll try to incorporate them and pass them along with new
  4.     releases. 
  5.  
  6.               Karl Sierka
  7. ---
  8. Karl Sierka     email - karl.sierka@labyrinth.com     phone - (303) 441-8288
  9. Labyrinth Computer Services, PO Box 4626, Boulder Colorado 80306-4626
  10. (-: NeXT Mail Welcome :-)
  11.  
  12.  
  13.     To install,
  14.  
  15.     0. Be prepared to enter a new religion. :-)
  16.  
  17.     1. untar it in a nice unixy place, like /usr/local/src/mh. 
  18.  
  19.     2. cd into /usr/local/src/mh/conf, and type make. This will build
  20.     a configuration script that you will run in the next step.
  21.  
  22.     3. type mhconfig MH while still in /usr/local/src/mh/conf. This
  23.     will take some time to run, so you might as well put it in the
  24.     background and redirect output to a file, like this.
  25.  
  26.         % mhconfig MH >& myconfig-log &
  27.  
  28.     4. Once that has run, 
  29.     
  30.         % cd /usr/local/src/mh
  31.         % make clean >& make-clean &
  32.  
  33.     Since this will be a virgin build for you at this time, this is
  34.     just to get you comfortable with the idea of cleaning up, since
  35.     not doing this step after making a change to a config file will waste
  36.     hours of your time in tracking down why it did not do what you wanted.
  37.  
  38.     5. Now, go ahead and build all the binaries, man pages and docs.
  39.  
  40.         % cd /usr/local/src/mh
  41.         % make >& make-log &
  42.  
  43.     This could take like 20 minutes. You should do a 
  44.  
  45.         % tail -f make-log
  46.  
  47.     while this is running (the first time or so) to see what it is doing.
  48.  
  49.     6. If all went well, install the system. The default config file
  50.     MH will place some programs and format files in /usr/local/mh/lib,
  51.     all other binaries in /usr/local/mh/bin, and the man pages in
  52.     /usr/local/man/manl, so make sure those directories exist before
  53.     doing the final step.
  54.  
  55.         % cd /usr/local/src/mh
  56.         % su
  57.         # make install >& make-install &
  58.  
  59.     eg, 
  60.  
  61.         % cd /usr/local/src/mh
  62.         % su
  63.         # mkdirs /usr/local/mh/{bin,lib} /usr/local/man/manl
  64.         # make install >& make-install &
  65.         # tail -f make-install
  66.         .
  67.         .
  68.         .
  69.  
  70.     7. make sure you have added /usr/local/mh/bin and
  71.     /usr/local/mh/lib to your shell PATH variable, and add
  72.     /usr/local/man/manl to your shell MANPATH variable.
  73.  
  74.     eg, in .cshrc
  75.  
  76.     set path = ( otherstuff /usr/local/mh/bin /usr/local/mh/lib
  77.     otherstuff )
  78.  
  79.     setenv MANPATH /usr/man:/usr/local/man
  80.  
  81.     8. If all went well, and the binaries and man pages were
  82.     installed, do a make clean again, to remove all the build step .o
  83.     files. 
  84.  
  85.     9. Read the docs that come with mh.
  86.  
  87.     A usage note: if you are going to do a sortm on a large message
  88.     folder, say 400+ messages, make sure you have your csh stack size
  89.     limit increased, by doing something like 
  90.  
  91.         limit stacksize 10000
  92.  
  93.     in your .cshrc file, or you will be unpleasantly surprised by a
  94.     core dump from sortm, and a partially sorted folder. (might even
  95.     lose messages)
  96.