home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / Utilities / most / README < prev   
Text File  |  1999-05-17  |  3KB  |  94 lines
  1. Compiling MOST requires an ANSI C compiler.  In addition you MUST have
  2. a copy of the S-Lang library.  This library is available from
  3. ftp://space.mit.edu/pub/davis/slang.
  4.  
  5.                           INSTALLATION INSTRUCTIONS
  6.               
  7. On Unix, you should be able to simply type:
  8.  
  9.     ./configure; make
  10.  
  11. at the Unix prompt.  
  12.  
  13. If using DJGPP or MINGW32, do:
  14.    
  15.     <edit src/makefile.w32, setting ARCH to either dgj or gw32>
  16.     cd src
  17.     make -f makefile.w32
  18.  
  19. For VMS, edit the file `vmsmake.com'.  When finished, either type `@vmsmake'
  20. or `@vmsmake gcc' at the VMS prompt.  Once MOST has been created, it must be
  21. installed as a foreign command.  This means that you must first type:
  22.  
  23.       $  most :== $device:[dir.containing.most]most.exe
  24.  
  25.  
  26. I suggest that you first build MOST then view the doc file using MOST (`most
  27. most.doc').  If you need help, hit the `h' key from within MOST. 
  28.  
  29. MOST understands the following environment variables:
  30.  
  31.     MOST_SWITCHES 
  32.     MOST_EDITOR, SLANG_EDITOR, EDITOR
  33.     MOST_INITFILE
  34.     MOST_HELP
  35.  
  36.   1. MOST_SWITCHES is a list of commonly used switches.  
  37.  
  38.   2. MOST_EDITOR and SLANG_EDITOR are formatted strings describing what
  39.      editor to use.  The string can contain %s and %d formatting descriptors
  40.      that represent the file name and line number, respectively.  For
  41.      example, if JED is your editor, then set MOST_EDITOR to 'jed %s -g %d'.
  42.      Since MOST is just one of several programs that use the S-Lang library,
  43.      I suggest that you use SLANG_EDITOR instead of MOST_EDITOR.
  44.  
  45.  3. MOST_INITFILE specifies a configuration file for MOST.  One can specifiy
  46.     keymaps, colors, etc. via this file.  In the absence of
  47.     MOST_INITFILE, the program will look for a file call .mostrc in
  48.     the home directory (most.rc on non-Unix systems).
  49.  
  50.     See `lesskeys.rc' for an example of a key definition file that
  51.     causes MOST to emulate the `less' pager.  See also most-fun.txt
  52.     for a list of functions that can be used for key definitions.  The
  53.     file `default.rc' list the bindings that are built-in to the
  54.     viewer.
  55.  
  56.  4. If MOST_HELP is defined to point to an existing file, MOST will load a
  57.     file as a help file.  This is useful for describing custom keymaps.
  58.     
  59. Any problems with MOST should be reported to davis@space.mit.edu.
  60.  
  61.   [Note also that this is really the first non-trivial C program that
  62.   I ever wrote.  Because of this, much of the code appears very
  63.   amateurish.  For example, I tried very hard to avoid C constructs
  64.   that some some authors considered very bad, e.g., goto, continue,
  65.   break.  Of course this made some of the code convoluted, e.g.,
  66.   contrast
  67.  
  68.       int test = 1;
  69.       while (test)
  70.        {
  71.            function ();
  72.  
  73.            if (-1 == some_function ())
  74.          test = 0;
  75.        
  76.        if (test)
  77.          some_other_function ();
  78.        }
  79.        
  80.    with:
  81.        
  82.        while (1)
  83.          {
  84.         function ();
  85.         if (-1 == some_function ()) break;
  86.         some_other_function ();
  87.      }
  88.  
  89.    I have since concluded that many text-book authors never actually
  90.    wrote anything non-trivial.  Whenever I work on MOST, I try to make
  91.    some changes in an effort to clean it up. ]
  92.  
  93. --John Davis
  94.