home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume8 / gnuplot1.10A / part01 / README.3B1 < prev    next >
Encoding:
Text File  |  1989-09-09  |  6.4 KB  |  139 lines
  1.  
  2.                    GNUPLOT
  3.             Additional notes for users of
  4.                AT&T Unix PC 7300/3b1
  5.                      by
  6.                 Augustine Cano
  7.  
  8.  
  9.     INTRODUCTION
  10.  
  11.     The following notes address peculiarities, problems, possible
  12.     improvements and instructions specific the the Unix PC version
  13.     of GNUPLOT.  The port to the Unix PC was done by John Campbell
  14.     (CAMPBELL@NAUVAX.bitnet), who also integrated the help system,
  15.     added polar coordinates and fixed miscellaneous bugs.  I 
  16.     (Augustine Cano, canoaf@dept.csci.unt.edu) made the makefiles
  17.     easier to use and was a beta tester.
  18.  
  19.     The "README" file in this directory contains important information
  20.     about the different makefiles and how to rename them to "make"
  21.     GNUPLOT on the various systems supported.  Reading that file
  22.     and at least the following INSTALLATION section will make it
  23.     much easier to configure and install GNUPLOT.
  24.  
  25.  
  26.     INSTALLATION
  27.  
  28.     The much friendlier makefile.3b1 makes it very easy to install
  29.     this package.  All that is needed is to "make all" and "make
  30.     install".  As usual, look over the makefile to make sure that
  31.     the default destinations do not conflict with anything on your
  32.     system.
  33.  
  34.     The distribution consists essentially of three parts: gnuplot
  35.     itself, the help program and the documentation (which is used to
  36.     build the help tree used by the help program).  If you want to 
  37.     look over the details of the sub-systems, look at the makefiles 
  38.     in ./help and ./docs respectively; otherwise, the top-level 
  39.     makefile will take care of compiling and installing everything.  
  40.     It is important that the directory /usr/local/help exist,
  41.     otherwise the creation of the help tree will fail.
  42.     The default destinations are as follows:
  43.  
  44.         gnuplot        - /usr/local/bin
  45.         manual page    - /usr/man/man1
  46.         help system    - /usr/local/help
  47.         help tree root    - /usr/local/help/gnuplot
  48.  
  49.     Note that this is only relevant to "make install".  If you want to
  50.     test the system in your current directory, before final installation,
  51.     you can "make all" and then go to ./docs and create the help tree
  52.     there.  You will then have to define the following environment
  53.     variables so that gnuplot knows about the non-standard locations:
  54.  
  55.         GNUHELP='./help/help gnuplot'
  56.         HELPDIR='./docs'
  57.  
  58.     An easy way of testing GNUPLOT is to "load" the .dem files.
  59.     Typing help at the "gnuplot>" prompt will enter the help system.
  60.     Step by step instructions are given there.  <RETURN> goes to the
  61.     previous level and <CTRL D> returns you to GNUPLOT from any level.
  62.     Two consecutive <RETURN>s at the top level of the help tree will
  63.     also return to the "gnuplot>" prompt.
  64.  
  65.     Given that the help system does not have its own Unix-PC specific
  66.     makefile, if you want to compile it with the shared library, you will
  67.     have to uncomment the appropriate 'ld' line in help system Makefile.
  68.  
  69.  
  70.     PROBLEMS, UNIX PC PECULIARITIES, IMPROVEMENTS
  71.  
  72.     In an attempt to get the program out as soon as possible, it was
  73.     decided that certain minor problems, incompatibilities with other
  74.     programs and improvements would be dealt with later.  If you have
  75.     suggestions, fixes or improvements, send them to John Campbell
  76.     (jdc@naucse.uucp).
  77.  
  78.     The primary area of conflict is the larger than 24 lines display
  79.     of the Unix PC.  Ideally, as much of it should be used in a way
  80.     that would not make this version radically different from that of
  81.     other machines.
  82.  
  83.     One problem was caused by contention between GNUPLOT and sysinfo,
  84.     the program written by Lenny Tropiano (lenny@icus.islp.ny.us).  This
  85.     program updates the two bottom lines of the screen (the same ones
  86.     used by the UA to display the soft key labels) every 15 seconds with
  87.     miscellaneous system information.  GNUPLOT uses these two lines
  88.     to display range information, and it would be invariably overwritten
  89.     in less than 15 seconds.  John created a patch for sysinfo available 
  90.     for FTP access from dept.csci.unt.edu (IP number 129.120.1.2).  The 
  91.     file is called sysinfo.patch.  It prevents sysinfo from updating the 
  92.     two bottom lines if they are being used by another program  (this works
  93.     with the UA too.)
  94.  
  95.     In order to have the largest graphics window possible, GNUPLOT uses
  96.     the uppermost status line, where the date, time, and various icons
  97.     reside.  When switching to another window, the date, time and icons
  98.     are not restored and they should be.
  99.  
  100.     The "gnuplot>" prompt appears inside the graphics window.  Any input
  101.     makes this window scroll upwards.  It would be much more elegant to
  102.     to use the line immediately below the graphics screen for input.
  103.     One possible solution, that would solve this and also free the two
  104.     bottom lines for sysinfo and the UA, would configure the 4 bottom
  105.     lines of the screen like this:
  106.  
  107. |                     bottom of the graphics screen                           |
  108. _______________________________________________________________________________
  109. gnuplot > < this area for input        > < first line of range info > |working|
  110. < this area for error messages         > < second line of range info> | icon  |
  111. <              this line used by sysinfo and for soft key labeling            >
  112. <              this line used by sysinfo and for soft key labeling            >
  113. _______________________________________________________________________________
  114.  
  115.     One problem is that the input area is not very big.  A solution
  116.     (other than overwriting the first line of the range info) would be
  117.     to use the scheme that ksh uses to edit the command line (if you
  118.     get to column 80, a '<' appears there and your command gets shifted
  119.     to the left.) This way, you could use vi for command line editing.
  120.     Neat, but it could be more trouble than it's worth, and you would
  121.     not see long formulas all at once.  Alternatively, the range info
  122.     could be left where it is and the input area and error messages
  123.     line extended up to the "working" icon, or the "working" icon
  124.     suppressed until the line is no longer needed (is this possible
  125.     without hacking the kernel?)
  126.  
  127.     Yet another option would be to have a text window pop up when input
  128.     is required or help text needs to be output.  The range information
  129.     would stay where it currently is.  This solution would, of course,
  130.     use real tam windows and thus allow switching from one window to 
  131.     another if gnuplot were in "text" mode.
  132.  
  133.     Ideally, when gnuplot exits, it should leave the two bottom lines
  134.     alone (not clearing them) if what is in them was not written by it.
  135.  
  136.     Finally, and this is a matter of preference, some people might want
  137.     gnuplot to clear the screen (the graphics window) or restore the
  138.     previous contents when exiting.
  139.