plplot_octave FGA (frequently given anwsers):

1-There is a small problem in the patch file included in
plplot_octave-0.3.tar.gz (plplot-961023-980401.patch):

edit it end delete line 12, the one that says
        \ No newline at end of file 

after that, the patch file must look like this:

      Tcl_PkgProvide(interp, "Matrix", "0.1");
      return TCL_OK;
! }
--- 8,17 ----
      Tcl_CreateCommand(interp, "matrix",   Tcl_MatrixCmd,
              (ClientData) NULL, (void (*)(ClientData)) NULL);


2-Make shure that you have octave-2.0.11, tcl7.6, tk4.2 and perl.
Make shure that you have a correctly installed octave, configured with
--enable-shared and --enable-dl. The command

ldd /usr/local/bin/octave-2.0.11

should report octave dynamic libs, liboctave.so, libcruft.so and
liboctinterp.so
somewhere in /usr/local/lib/octave-2.0.11/

3-if your perl is not in /usr/local/lib, yyou sould edit `pltclgen'
from the plplot distribution and change the first line accordingly.

4-If you system don't have poll(), search for its ocurrence in x17c.c of
the plplot distribution and comment them (2 occurrences)

5-If you have problems, please try first to see if you can sucessefully
compile and run the oregonator.cc and hello.cc files in the examples
directory of the octave distribution. If they dont run, fix first
octave (configure with above options and reinstall).

6-If you have a problem with the Tk demos in the plplot distribution, 
probably your Xserver is not secure. Use `xauth' or rebuild tk without
security. But you don't need Tk (although usefull); the default is to
use the Xwindows driver.

7-The demos in the plplot_octave distribution should be run in the
extracted directory from plplot_octave-0.3.tar.gz, i.e., `plplot', as
there are needed script files in directories misc, demos and PLplot. To
run the plplot_octave demos, you must provide a LOADPATH that start at
`plplot'; being there, I find LOADPATH =[".//:" LOADPATH] a simple way
of doing it after invoquing Octave.

8-I have tested plplot_octave in SCO-3.2v5.0.4 with egcs-1.0.2 and in
Debian Linux with gcc-2.7.2.3

9-In the plplot_octave INSTALL file I suggest using

	--x-includes=/usr/include --x-libraries=/usr/lib

as options to configure in the plplot distribution. Of course these are
system dependent, and probably you should not specify them. `configure'
can find yours x include and libraries,  and you should only specify
yours own if you don't agree with `configure' guessed ones.

10-If you have a True Color Xserver (> 256 colors) than you need to edit
`pldef.m' and comment the references to `plscol0' there, as well as 
#plSetOpt("bg",.... At demo p7.m you my also have problems; here,
comment plcolormap(). In both cases you will see the error:

  X Error of failed request:  BadAccess (attempt to access private resource denied)
  Major opcode of failed request:  89 (X_StoreColors)
  Serial number of failed request:  47
  Current serial number in output stream:  62

This script is for customizing the apearance of the plot
window. Change it at your will.

11-There are problems with `semilogy, semilogx and loglog', as negative
values are allowed but (very) incorrectly draw.

12- there are no such thing as `replot'. The equivalent, `plreplot', does
not do waht you want. Also, `title', `xlabel' and `ylabel' must be given
*before* the plot command.

13-In hold mode, the first plot defines the viewport, so further plots
dont rescale te axis.

14-check that plplot_octave.oct find its shared libs, in case you have
build plplot with shared libs. Try `ldd plplot_octave.oct' and you will
see either a list of needed and founded shared libs, or an error. In
this case, you can specify where to find them using LD_LIBRARY_PATH or
LD_RUN_PATH, or still recompiling plplot_octave.oct with the `-r' flag
to gcc (this might vary with the OS).

15-The xwin driver does not respond to deiconify/resize events. This is
a well know misfeature of plplot.

Please keep reporting problems and how you solve them,

Thanks,

Joao Cardoso <jcardoso@inescn.pt>
