File: README

package info (click to toggle)
most 4.8.1-0.1
  • links: PTS
  • area: main
  • in suites: slink
  • size: 444 kB
  • ctags: 380
  • sloc: ansic: 4,982; sh: 171; makefile: 115
file content (89 lines) | stat: -rw-r--r-- 2,961 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
Compiling MOST requires an ansi compatable c compiler.  It compiles fine with
`cc' on Ultrix and VMS, and `gcc' on a sun4.   In addition you MUST
have a copy of the S-Lang library.  This library is available from
ftp://space.mit.edu/pub/davis/slang.  

                          INSTALLATION INSTRUCTIONS
			  
On Unix, you should be able to simply type:

    ./configure; make

at the Unix prompt.  

If using DJGPP, do: 

    cd src
    make -f makefile.djg

For VMS, edit the file `vmsmake.com'.  When finished, either type `@vmsmake'
or `@vmsmake gcc' at the VMS prompt.  Once MOST has been created, it must be
installed as a foreign command.  This means that you must first type:

      $  most :== $device:[dir.containing.most]most.exe


I suggest that you first build MOST then view the doc file using MOST (`most
most.doc').  If you need help, hit the `h' key from within MOST. 

MOST understands the following environment variables:

    MOST_SWITCHES 
    MOST_EDITOR, SLANG_EDITOR, EDITOR
    MOST_INITFILE
    MOST_HELP

  1. MOST_SWITCHES is a list of commonly used switches.  

  2. MOST_EDITOR and SLANG_EDITOR are formatted strings describing what
     editor to use.  The string can contain %s and %d formatting descriptors
     that represent the file name and line number, respectively.  For
     example, if JED is your editor, then set MOST_EDITOR to 'jed %s -g %d'.
     Since MOST is just one of several programs that use the S-Lang library,
     I suggest that you use SLANG_EDITOR instead of MOST_EDITOR.

 3. MOST_INITFILE is a key definition file for MOST.  See `lesskeys.rc' for
    an example of a key definition file that causes MOST to emulate the
    `less' pager.  See also most-fun.txt for a list of functions that can be
    used for key definitions.  The file `default.rc' list the bindings that
    are built-in to the viewer.

 4. If MOST_HELP is defined to point to an existing file, MOST will load a
    file as a help file.  This is useful for describing custom keymaps.
    
Any problems with MOST should be reported to davis@space.mit.edu.

  [Note also that this is really the first non-trivial C program that
  I ever wrote.  Because of this, much of the code appears very
  amateurish.  For example, I tried very hard to avoid C constructs
  that some some authors considered very bad, e.g., goto, continue,
  break.  Of course this made some of the code convoluted, e.g.,
  contrast

      int test = 1;
      while (test)
       {
           function ();

           if (-1 == some_function ())
	     test = 0;
	   
	   if (test)
	     some_other_function ();
       }
       
   with:
       
       while (1)
         {
	    function ();
	    if (-1 == some_function ()) break;
	    some_other_function ();
	 }
	  
   I have since concluded that many text-book authors never actually
   wrote anything non-trivial.  Whenever I work on MOST, I made some
   changes in an effort to clean it up.
  ]

--John Davis