"Fossies" - the Fresh Open Source Software Archive

Member "vfplot-1.0.15/docbook/INSTALL.xml" (7 Nov 2019, 2843 Bytes) of package /linux/privat/vfplot-1.0.15.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) XML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "INSTALL.xml": 1.0.14_vs_1.0.15.

    1 <?xml version='1.0' encoding="UTF-8"?>
    2 <article xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
    3 
    4 <title>vfplot source installation</title>
    5 
    6 <section>
    7 <title>Executive summary</title>
    8 
    9 <para>
   10   Building vfplot is quite standard: the usual
   11 </para>
   12 
   13 <para>
   14 <programlisting>
   15 ./configure
   16 make
   17 su
   18 make install
   19 </programlisting>
   20 </para>
   21 
   22 <para>
   23   Use the <userinput>--prefix</userinput> option to
   24   <userinput>./configure</userinput> if you want to install
   25   elsewhere than <filename>/usr/local</filename>.
   26 </para>
   27 
   28 <para>
   29   See <userinput>./configure --help</userinput> for a full
   30   list of configuration options.
   31 </para>
   32 
   33 </section>
   34 
   35 <section>
   36 <title>Optional features</title>
   37 
   38 <para>
   39   If the
   40   <ulink url="http://www.unidata.ucar.edu/software/netcdf/">NetCDF</ulink>
   41   library is found then vfplot will be able to read GMT grd files.
   42 </para>
   43 
   44 <para>
   45   If the
   46   <ulink url="http://matio.sourceforge.net/">matio</ulink>
   47   library is found then vfplot will be able to read mat
   48   (Matlab binary) files.
   49 </para>
   50 
   51 <para>
   52   If you want support for
   53   <ulink url="http://gfs.sourceforge.net/">Gerris</ulink>
   54   flow solver files use the <userinput>--enable-gerris</userinput>
   55   option in configuration. You will need to have a recent
   56   version of the Gerris software.
   57 </para>
   58 
   59 <para>
   60   If the pthread (POSIX thread) library is found then
   61   vfplot will support multithreaded force calculations
   62   giving a substantial speedup on multiprocessor
   63   hardware.
   64 </para>
   65 
   66 <para>
   67   If the
   68   <ulink url="http://www.zlib.net/">zlib</ulink>
   69   library is found then the graphics state files
   70   will be compressed with gzip (see the
   71   <userinput>--graphic-state</userinput> option).
   72 </para>
   73 
   74 </section>
   75 
   76 <section>
   77 <title>Platform specific notes</title>
   78 
   79 <para>
   80 The program should compile on any modern POSIX operating
   81 system with a C99 compiler. It is developed on Linux
   82 on the x86, AMD64 and Sparc architectures with the GNU
   83 C compiler.
   84 </para>
   85 
   86 
   87 <section> <title>Windows XP with Cygwin</title>
   88 
   89 <para>
   90 The program is tested on Windows XP with the
   91 <ulink url="http://www.cygwin.com/">Cygwin</ulink>
   92 POSIX compatibility layer.
   93 </para>
   94 
   95 <para>
   96 To build, first use the Cygwin startup.exe program to install the gcc, make
   97 and zlib pacakges. Then obtain, compile and install the netcdf and libmatio
   98 libraries listed above. Finally, configure with
   99 <userinput>--disable-pthread</userinput> then make and install as usual.
  100 </para>
  101 
  102 </section>
  103 
  104 <section>
  105   <title>OS X</title>
  106 
  107   <para>
  108     The POSIX thread (pthread) library supplied with the OS does not
  109     include some functionality on which vfplot relies (in particular,
  110     <emphasis>barriers</emphasis>).  That functionality can be provided
  111     by a built-in implementation with the
  112     <userinput>--enable-pthread-extra</userinput>
  113     configuration option.
  114   </para>
  115 </section>
  116 
  117 </section>
  118 
  119 </article>