#
# gtool5 Installation Guide in RD (Ruby Document) format
#
#   For instruction of installing gtool5, see "INSTALL.htm.en"
#   (written in English) or  "INSTALL.htm" (written in Japanese)
#   included in "gtool5" TGZ package available from
#   <http://www.gfd-dennou.org/library/gtool>.
#   Otherwise, see this file directly, or generate
#   above mentioned html files with "make guide" 
#   in current directory after installing  rdtool
#   <http://raa.ruby-lang.org/project/rdtool/>.

=begin JA

= gtool5 󥹥ȡ륬

# *   (morikawa), ˭ ѻ (toyoda),   (odakker)
#   * $Id: INSTALL,v 1.3 2008-10-05 19:51:36 morikawa Exp $

=end JA
=begin EN

= Gtool5 Installation Guide

# * Yasuhiro MORIKAWA (morikawa), Eizi TOYODA (toyoda), Masatsugu ODAKA (odakker)
#   * $Id: INSTALL,v 1.3 2008-10-05 19:51:36 morikawa Exp $

=end EN

=begin JA
== ưĶ

gtool5 饤֥ϰʲδĶǤưǧƤޤ.

=end JA

=begin EN
== Operation Environment

Gtool5 library is operated by following environments.

=end EN

=begin

  * ((<"Debian GNU/Linux 4.0"|URL:http://www.debian.org/>)) +
    ((<G95 Fortran 0.91      |URL:http://www.g95.org/>))

  * ((<"Debian GNU/Linux 4.0 "|URL:http://www.debian.org/>)) +
    ((<Fujitsu Fortran Version 5.0 (in JAPANESE)|URL:http://www.fqs.fujitsu.com/fort-c/>))

  * ((<"Debian GNU/Linux 4.0"|URL:http://www.debian.org/>)) +
    ((<Intel Fortran 10.0    |URL:http://www.intel.com/software/products/compilers/flin/>))

=end

=begin JA
ˤϰʲδĶǤưȤǧƤޤ.
ǧϤƤޤ, ߤΥСǤ⤪餯ưȴԤޤ.
=end JA
=begin EN
Gtool5 library was operated by following environments in the past.
Latest version may be operated (unconfirmed).
=end EN

=begin
  * Linux + PGI Fortran
  * Debian GNU/Linux 4.0 + gfortran 4.4.0
  * NEC SX-6 + FORTRAN90/SX
  * Windows Vista + Intel Visual Fortran 9.1.032

# gt4f90io ưǧ줿
#  * Debian GNU/Linux 4.0 + gfortran 4.4.0
#  * Cray XT4 + PGI Fortran
#  * NEC SX-6 + FORTRAN90/SX
#  * Debian GNU/Linux 3.1 + G95 Fortran 0.9
#  * Debian GNU/Linux 3.1 + Fujitsu Fortran Version 5.0
#  * Debian GNU/Linux 3.1 + Intel Fortran 9.0
#  * Windows Vista + G95 Fortran
#  * Windows Vista + Intel Visual Fortran 9.1.032
#  * Windows Vista + Compaq Visual Fortran 6.6
#  * HITACHI SR11000 + IBM XL Fortran Enterprise Edition for AIX5L
#  * HITACHI SR11000 + Optimizing FORTRAN90 Compiler
#  * FUJITSU VPP-5000 + VPP Fortran
=end


=begin JA
== ϥե

gtool5 ϰʲΥե򥵥ݡȤޤ.

  * ((<gtool4 netCDF |URL:doc/xref.htm#label-6>))
    ˽ netCDF ե

ޤ, ʲΥեݡȤȤʤȹͤƤޤ.

  * GrADS ʻǡ
  * GRIB
  * ¾̤Τ٤񤭷ϥǡ

=end JA

=begin EN
== Input Output Data Format

gtool5 support following data format.

  * NetCDF file conformed with
    ((<gtool4 netCDF Conventions|URL:doc/xref.htm.en#label-6>))

=end EN

=begin JA
== 󥹥ȡή

gtool5 Υ󥹥ȡϰʲΤ褦˹Ԥޤ.
ܤϳƹܤ򻲾ȤƤ.

  (1) ((<ɬפʥեȥ>)) 򥤥󥹥ȡ뤷ޤ.
  (2) ((<ӥɤμ>)) ˽, 饤֥ӥɤޤ.
  (3) ((<󥹥ȡμ>)) ˽, 饤֥򥤥󥹥ȡ뤷ޤ.
  (4) ((<ƥȥץ¹Ԥμ>)) ˽, 󥹥ȡ뤵줿
      饤֥꤬˵ǽ뤫ɤǧƤ.
  (5) ((<gt5frt ؤΥѥ>)) ԤäƤ.

=== 󥹥ȡ

((<gtool ץ|URL:http://www.gfd-dennou.org/library/gtool/>))
Ρ֥塼ȥꥢפǤ, 󥹥ȡμҲ𤵤Ƥޤ.
󥹥ȡ뤬ޤʤϻȤƤ.


=== Debian GNU/Linux 桼Τߤʤޤ

Debian GNU/Linux ѤƤ,
((<URL:http://www.gfd-dennou.org/library/gtool/debian.htm>))
ˤۤƤХʥѥåѤǤޤ.

#=== Windows 桼Τߤʤޤ
#
# gtool5 ǤХʥ경ޤǤϥȥ. 
#
#((< ľͤ|URL:http://www.se.fukuoka-u.ac.jp/otobe/>))
#((<gtool5 Windows Хʥ|URL:http://www.se.fukuoka-u.ac.jp/otobe/gtool5.html>)) ˤ
#((<Intel Visual Fortran|URL:http://www.xlsoft.com/jp/products/intel/compilers/fcw/index.html>)) Ѥ
#((<G95 Fortran|URL:http://g95.org/>)) Ѥ Windows Хʥ
#Ƥޤ.

=end JA

=begin EN
== General outline

Install gtool5 as follows. Refer each items for details.

  (1) Satisfy ((<Software Requirements>)).
  (2) Build the library following ((<How to build>)).
  (3) Install the library following ((<How to install>)).
  (4) Check whether the installed library functions normally
      following ((<Execute test programs>)).
  (5) ((<Set PATH to gt5frt>)).

=== Install example

There are examples of installation in "Tutorial" on
((<Gtool Project|URL:http://www.gfd-dennou.org/library/gtool/>)).
Refer them if the installation is not successful.

=== For Debian GNU/Linux users

When you are using Debian GNU/Linux, binary packages distributed with
((<URL:http://www.gfd-dennou.org/library/gtool/debian.htm.en>))
can be used.

#=== For Windows users
#
# These are commented out until gtool5 is build
#
#((<Naohito OTOBE (in JAPANESE)|URL:http://www.se.fukuoka-u.ac.jp/otobe/>))
#creates and releases
#((<gtool5 Windows binaries (in JAPANESE)|URL:http://www.se.fukuoka-u.ac.jp/otobe/gtool5.html>)) for 
#((<Intel Visual Fortran|URL:http://www.xlsoft.com/en/products/intel/compilers/reseller_productpage_fortran_compilers_windows.html>)) and
#((<G95 Fortran|URL:http://g95.org/>)).

=end EN

=begin JA
== ɬפʥեȥ

gtool5 Ѥ뤿ˤ, ʲΥեȥ
˥󥹥ȡ뤷Ƥɬפޤ.

: ((<netCDF|URL:http://www.gfd-dennou.org/library/netcdf>)) (С 3.6)
  Debian GNU/Linux ѤƤ, ХʥѥåѤ

  * debian ѥå
    [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ffc5_3.6.2-1_i386.deb>)) |
    ((<Intel ver9.0|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ifc9_3.6.2-1_i386.deb>)) |
    ((<G95|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf-g95/sarge/>))]

    嵭 deb ѥå¾ netCDF  Development kit
    (((*netcdf-bin*)) ѥå) ⥤󥹥ȡ뤹ɬפޤ.

  ӥɤ
  * ((<3.6.2  TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.2.tar.gz>))

    [((<Unidata ܲ NetCDFå󥹥ȡ륬 (Ѹ) |URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/Quick-Instructions-for-Installing-NetCDF-on-Unix.html#Quick-Instructions-for-Installing-NetCDF-on-Unix>))
    |
    ((<(ܸ)|URL:INSTALL_netcdf.htm>)) ]

    [((<Unidata ܲȤΥ󥹥ȡ륬ɤܼ|URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/index.html>))]
  

ɥȤ뤿ˤϰʲΥեȥ
˥󥹥ȡ뤷Ƥɬפޤ. ,
((<gtool5  TGZ ѥå|URL:http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current.tgz>))
ꤹˤϴѤߤǤ.

* ((<ruby|URL:http://www.ruby-lang.org/>))
* ((<rdtool|URL:http://raa.ruby-lang.org/project/rdtool/>))
* ((<"RDoc Fortran90/95 ɲϵǽ"|URL:http://www.gfd-dennou.org/library/dcmodel/rdoc-f95>))
#* ((<rd2latex-lib|URL:http://shugo.net/archive/rd2latex/>))

=end JA
=begin EN

== Software Requirements

The following software needs to use gtool5.

: ((<netCDF|URL:http://my.unidata.ucar.edu/content/software/netcdf/index.html>)) (version 3.6)

  Debian GNU/Linux (use binary packages)

  * debian packages
    [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ffc5_3.6.2-1_i386.deb>)) |
    ((<Intel ver9.0|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ifc9_3.6.2-1_i386.deb>)) |
    ((<G95|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf-g95/sarge/>))]

    If you use above Debian package to install netCDF, you need
    ((* "netcdf-bin" *)) package too. (Parhaps you can get by "apt-get").

  Build from source codes

  * ((<Version 3.6.2 TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.2.tar.gz>)),

    [((<Quick Instructions for Installing (Unidata)|URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/Quick-Instructions-for-Installing-NetCDF-on-Unix.html#Quick-Instructions-for-Installing-NetCDF-on-Unix>))]
    * [((<NetCDF Installation and Porting Guide (Unidata)|URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/index.html>))]


Following softwares should be installed for generating documentations.
But, if you get from
((<gtool5 TGZ package|URL:http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current.tgz>)),
documentations are already generated.

* ((<ruby|URL:http://www.ruby-lang.org/>))
* ((<rdtool|URL:http://raa.ruby-lang.org/project/rdtool/>))
* ((<"Enhanced version of RDoc Fortran90/95 parser"|URL:http://www.gfd-dennou.org/library/dcmodel/rdoc-f95>))
#* ((<rd2latex-lib|URL:http://shugo.net/archive/rd2latex/>))

=end EN


=begin JA
== ӥɤμ
=end JA
=begin EN
== How to build
=end EN

=begin JA
=== TGZ ѥåŸ

Ŭʺȥǥ쥯ȥǥ֤Ÿޤ.
 gtool5-((|С|)) Ȥǥ쥯ȥŸޤ.

	$ tar xvzf gtool5_current.tgz

ޤ

	$ zcat gtool5_current.tar.gz | tar -xvf -

=end JA
=begin EN
=== Extract TGZ Package

Make an empty directory, and extract archive.
A directory `gtool5-((|version|))'
created at the current working directory.

	$ tar xvzf gtool5_current.tgz

or

	$ zcat gtool5_current.tar.gz | tar -xvf -

=end EN


=begin JA
=== Fortran ѥλ

Ķѿ ((* FC *)) ˻Ѥ Fortran ѥꤷƤ.
ʲ, Ѥ륳ѥ餬 frt ξǤ.

* sh, bash ξ

	$ FC=frt ; export FC

* csh, tcsh ξ

	$ setenv FC frt

ŬǥХåΤΥץϴĶѿ ((* FFLAGS *))
ꤷƤ. ʲ frt ι®
󲽤ΤΥץǤ.

* sh, bash ξ

	$ FFLAGS="-Kfast,parallel" ; export FFLAGS

* csh, tcsh ξ

	$ setenv FFLAGS "-Kfast,parallel"

=end JA
=begin EN
=== Specify Fortran Compiler

Specify Fortran compiler to environment variable ((* FC *)).
For example, if you use "frt",

* sh, bash

	$ FC=frt ; export FC

* csh, tcsh

	$ setenv FC frt

Specify Fortran compiler options for optimization and debug to
environment variable ((* FFLAGS *)).
For example, if you set options for automatic optimization and
automatic parallelization to "frt",

* sh, bash

	$ FFLAGS="-Kfast,parallel" ; export FFLAGS

* csh, tcsh

	$ setenv FFLAGS "-Kfast,parallel"

=end EN


=begin JA
=== Config.mk κ

Ÿ줿ǥ쥯ȥ˰ư, (({ ./configure }))¹Ԥޤ.
(({ --with-netcdf= })) ˤ netCDF 饤֥Υѥꤷޤ.
(ʲ /usr/local/netcdf/lib/libnetcdf.a ˥饤֥꤬
ΤΤǤ).
Υޥɤˤä (({ Config.mk })) ե뤬ޤ.
netCDF 饤֥꤬ͭ饤֥Ǥ,
(({ --with-netcdff= })) ꤹɬפ뤫⤷ޤ.
ܤϲΥץξܺ٤򻲾ȤƤ.

	$ ./configure --with-netcdf=/usr/local/netcdf/lib/libnetcdf.a

ӥɤˤ GNU make ɬפȤʤ뤿, configure  PATH ⤫
ư GNU make õ褦Ȥޤ, ⤷Ĥʤ,
顼֤ޤ. ξˤϴĶѿ ((* MAKE *)) 
GNU make ޥɤꤷƺ configure ¹ԤƤ.

󥹥ȡʤɤѹ, ʲΤ褦 (({ --help })) 
Ĥ뤳Ȥ, ǽʥץꥹȤɽޤ.

	$ ./configure --help

ʥץ˴ؤƤǤ.

:(({--with-netcdf=}))((|ARG|))
  ((|ARG|))  ((<ӥɤɬפ netCDF 饤֥>)) 
  ꤷޤ. ɬŪ˻ꤹɬפޤ.

:(({--with-netcdff=}))((|ARG|))
  netCDF 饤֥꤬ͭ饤֥Ǥ, C ѥ饤֥
  Fortran ѥ饤֥ȤʬƥӥɤƤ礬ޤ.
  κݤ, 嵭ץ C ѥ饤֥ꤷ, ܥץ
  ((|ARG|))  ((<Fortran ѥ饤֥>)) 
  ꤷޤ.

:(({--prefix=}))((|ARG|))
  ((|ARG|)) ˥饤֥⥸塼, ¹ԥեΥ󥹥ȡ
  ǥ쥯ȥΥץեåꤷޤ.
  ǥեȤ (({ /usr/local/gtool5 })) Ǥ.

:(({--host=}))((|ARG|))
  ѥԤˤ, ѥå¹Ԥ륷ƥॿ̾
   ((|ARG|)) ˻ꤷޤ.

:(({--libdir=}))((|ARG|))
  ((|ARG|)) ˥饤֥Υ󥹥ȡΥǥ쥯ȥꤷޤ.
  ǥեȤ (({ /usr/local/gtool5/lib })) Ǥ.

:(({--includedir=}))((|ARG|))
  ((|ARG|)) ˥⥸塼եΥ󥹥ȡΥǥ쥯ȥ
  ꤷޤ. ǥեȤ (({ /usr/local/gtool5/include })) Ǥ.

:(({--bindir=}))((|ARG|))
  ((|ARG|)) ˼¹ԥեΥ󥹥ȡΥǥ쥯ȥꤷޤ.
  ǥեȤ (({ /usr/local/gtool5/bin })) Ǥ.

:(({--with-docdir=}))((|ARG|))
  ((|ARG|)) ˥ɥȥեΥ󥹥ȡꤷޤ.
  ǥեȤ (({ /usr/local/gtool5/doc })) Ǥ.

:(({--with-gt5libname=}))((|ARG|))
  ((|ARG|))  gtool5 Υ饤֥̾ꤷޤ.
  饤֥̾ (({lib}))((|<ARG>|))(({.a})) Ȥʤޤ.
  ǥեȤ (({ gtool5 })) Ǥ, κݤΥ饤֥̾
  (({ libgtool5.a })) Ȥʤޤ.

:(({--with-gt5suffix=}))((|ARG|))
  ((|ARG|)) ˤϥ󥹥ȡǥ쥯ȥ, 饤֥̾,
  ¹ԥեˤĤꤷޤ.
  㤨, ¾ƥǥեȤ (({ ffc5 })) Ȼꤹ,
  󥹥ȡΥǥ쥯ȥΥץեå
  (({ /usr/local/gtool5-ffc5 })), 饤֥̾
  (({ libgtool5-ffc5.a })), 󥹥ȡ뤹¹ԥե̾
  (({ gt5frt.ffc5 })), (({ gt5config.ffc5 })) Τ褦
  ʤޤ.

:(({--with-lang_conform_check=}))((|ARG|))
  ((|ARG|)) ˸쵬ʤꤹ뤳Ȥ, ѥ˸쵬ʤ
  åԤ褦, ץɲäޤ.  "(({95}))"
  Τ߻ǽǤ. ѥˤäƤϻǤޤ.

:(({--enable-debug}))
  Υץꤹ뤳Ȥ, ѥ¹Ի˥ǥХåå
  Ϥ륪ץɲäޤ.
  ξ, ץμ¹®٤㲼뤿, ǥХåΤ
  Ѥޤ. ѥˤäƤ̵Ǥ.

:(({--with-abort=}))((|ARG|))
  ((|ARG|))  (({abort, errtra-setrcd, exit, setrcd, stop})) Τ줫
  ꤹ뤳Ȥ, λѤ Fortran ؿѹ뤳Ȥ
  ǽǤ. ǥեȤ (({ abort })) Ǥ.

  : abort
    Fortran ֥롼 abort ǽλޤ.

  : errtra-setrcd
    Fujitsu Fortran  ERRTRA ӥ֥롼ƤӽФ,
    ߼¹Υץñ̤ޤǤΥȥ졼ХåޥåפϤ,
    λޤ. Fujitsu Fortran  SETRCD ӥ֥롼ˤ,
     13 ꤷ, λɤȤ 3 ꤷޤ.

  : exit
    Fortran ֥롼 exit ǽλޤ.

  : setrcd
    Fujitsu Fortran  SETRCD ӥ֥롼ƤӽФ,
    Fortran ɤȤ 3 ꤷƽλޤ.

  : stop
    Fortran ؿ stop ǽλޤ.

:(({--config-cache})) ޤ (({-C}))

  (({ Config.mk })) ե뤬Ʊ, (({config.cache}))
  ե뤬, (({ ./configure })) ΰ˻ꤵ줿 netCDF
  饤֥ΰ֤ʤɤξݻޤ.

   (({ ./configure })) ¹Ԥݤˤ⤳Υץꤹ뤳Ȥ,
  (({config.cache})) ɤ߹ޤ, ꤷץѤޤ.
  ¸ߤ (({config.cache})) ̵뤹ϤΥץ
  ꤻ (({ ./configure })) ¹ԤƤ.

  㤨вΤ褦 (({ ./configure })) ¹ԤȤޤ.

      $ ./configure -C --with-netcdf=/usr/local/netcdf/lib/libnetcdf.a --enable-debug

  ȼʹ, Τ褦 (({ ./configure })) ¹Ԥ뤳Ȥ
  netCDF 饤֥ΰ֤, ǥХåץղä
  Ѥޤ.

      $ ./configure -C

  Debian GNU/Linux  Fujitsu Fortran ѤƤˤ,
  Config.cache.debian-ffc*  (({config.cache})) ˰ư
  (({ ./configure })) ޥɤ¹ԤǼưŪ
  饤֥ΰ֤ꤵޤ.

      $ cp Config.cache.debian-ffc5 config.cache
      $ ./configure -C


=end JA
=begin EN

=== Create `Config.mk'

Move created directroy, and excute `(({ ./configure }))'.

If your path of netCDF library is `/usr/local/netcdf/lib/libnetcdf.a',
you should set options as follow.
Then a configure file `Config.mk' will be created at
the current working directory.
If the netCDF library is a shared library, (({ --with-netcdff= }))
option may be needed.
See details of options as follows.

	$ ./configure --with-netcdf=/usr/local/netcdf/lib/libnetcdf.a

GNU make is needed to build, so configure automatically inquires
into GNU make in PATH. However, it returns error when GNU make is
not found. In that case, please set the GNU make command for
environment variable ((* MAKE *)). And rerun execute `(({ ./configure }))'.

If you want to change directory to which the library and the module, etc.
are installed, please set (({ --help })) option as follow. Available
options are showed.

	$ ./configure --help

Descriptions about principal options are listed below.

:(({--with-netcdf=}))((|ARG|))
  Specify ((<netCDF library needed for build>)) to ((|ARG|)).
  You must specify explicitly.

:(({--with-netcdff=}))((|ARG|))
  If the netCDF library is a shared library, the library may be divided
  C library from Fortran library. In the case, specify the C library
  to above option, and specify 
  ((<the Fortran library>)) to ((|ARG|)) in this option.

:(({--prefix=}))((|ARG|))
  Specify prefix to ((|ARG|)).
  Default value is (({ /usr/local/gtool5 })).

:(({--host=}))((|ARG|))
  When cross-compiling, specify
  the type of system on which the package will run to
  ((|ARG|)).

:(({--libdir=}))((|ARG|))
  Specify directory to which the library is installed to ((|ARG|)).
  Default value is (({ /usr/local/gtool5/lib })).

:(({--includedir=}))((|ARG|))
  Specify directory to which the module is installed to ((|ARG|)).
  Default value is (({ /usr/local/gtool5/include })).

:(({--bindir=}))((|ARG|))
  Specify directory to which the executable file is installed to ((|ARG|)).
  Default value is (({ /usr/local/gtool5/bin })).

:(({--with-docdir=}))((|ARG|))
  Specify directory to which the documentation file is installed to ((|ARG|)).
  Default value is (({ /usr/local/gtool5/doc })).

:(({--with-gt5libname=}))((|ARG|))
  Specify gtool5 library name to ((|ARG|)).
  Library name becomes (({lib}))((|<ARG>|))(({.a})) .
  Default value is (({ gtool5 })), so library name becomes
  (({ libgtool5.a })) .

:(({--with-gt5suffix=}))((|ARG|))
  Specify suffix of installdir, library name, executable files to((|ARG|)).
  For example, you specify (({ ffc5 })) when others are default,
  prefix of installdir becomes (({ /usr/local/gtool5-ffc5 })),
  library name becomes (({ libgtool5-ffc5.a })),
  executable files become (({ gt5frt.ffc5 })), (({ gt5config.ffc5 })).

:(({--with-lang_conform_check=}))((|ARG|))
  Specify language standard to ((|ARG|)).
  And when you compile source code, check the language standard conformance.
  Now, "(({95}))" is valid.
  The compiler that can be used is limited.

:(({--enable-debug}))
  When you compile source code and execute binary file, output debug
  messages. This will slow down your program.
  This option is valid at some compilers (ex. g95, frt, ifort).

:(({--with-abort=}))((|ARG|))
  Specify one of (({abort, errtra-setrcd, exit, setrcd, stop})) to
  ((|ARG|)).
  Default value is (({ abort })).

  : abort
    Stop by intrinsic subroutine "abort".

  : errtra-setrcd
    Stop by Fujitsu Fortran service subroutine "ERRTRA".
    And outputs error trace back map.

  : exit
    Stop by intrinsic subroutine "exit".

  : setrcd
    Stop by Fujitsu Fortran service subroutine "SETRCD".
    And outputs error trace back map.

  : stop
    Stop by intrinsic subroutine "stop".

:(({--config-cache or -C}))
  (({ config.cache })) is created at the same time as (({ Config.mk }))'s
  being generated.
  (({ config.cache })) stores information investigated with
  (({ ./configure })).

  If you set this option, when you execute (({ ./configure })) again,
  (({config.cache})) is loaded.
  If you want to ignore (({config.cache})), don't set this option

  For example, execute (({ ./configure })) as follows.

      $ ./configure -C --with-netcdf=/usr/local/netcdf/lib/libnetcdf.a --enable-debug

  Then, information such as the locations of the netCDF library is
  succeeded by executing (({ ./configure })) as follows after next time.

      $ ./configure -C

  If you use Fujitsu Fortran compiler in Debian GNU/Linux,
  copy "Config.cache.debian-ffc*" to (({config.cache})) and
  execute (({ ./configure })). So, locations of libraries are
  specified automatically.

      $ cp Config.cache.debian-ffc5 config.cache
      $ ./configure



=end EN


=begin JA
=== Config.mk Խ

Ķ˹碌 (({ Config.mk })) ưԽƤ. 
ˤĤƤ褯ʬʤˤϤȤꤢ
((<ɤΥѥ>)) ؿʤǤ. 

   FC          : Fortran ѥ

   SYSFFLAGS   : ѥ󥯻ɬפʥե饰
                 (Fortran ѥ¹Իɬפʥץ)

   SYSLDFLAGS  : 󥯻ɬפʥե饰

   SYSLDLIBS   : 󥯻ɬפʥ饤֥

   F90MODTYPE  : ⥸塼Ϥ

   DEST_LIB    : gtool5 饤֥ꥤ󥹥ȡǥ쥯ȥ

   DEST_INC    : gtool5 ⥸塼륤󥹥ȡǥ쥯ȥ

   DEST_BIN    : gtool5 ¹ԥե륤󥹥ȡǥ쥯ȥ

   DEST_DOC    : gtool5 ɥȥե륤󥹥ȡǥ쥯ȥ



   MODS        : ⥸塼եĥ

   MAKE        : GNU make ޥ

   AR          : ֥ޥ

   ARFLAGS     : ֻɬפʥե饰

   RANLIB      : ֤Υǥå륳ޥ

=end JA
=begin EN
=== Edit `Config.mk'

Edit `(({Config.mk}))' manually, if you want to change. 
If you do not understand following settings, 
go forward to ((<Compile source code>)) tentatively. 

   FC          : Fortran Compiler

   SYSFFLAGS   : Flags needed when compiled and linked

   SYSLDFLAGS  : Flags needed when linked

   SYSLDLIBS   : Libraries needed when linked

   F90MODTYPE  : Information of Modules
                 (std.mod, HP.mod, fqs.mod, intel.d, hitachi.f90)

   DEST_LIB    : Directory to which the library file is installed

   DEST_INC    : directory to which the module files are installed

   DEST_BIN    : directory to which the executable files are installed

   DEST_DOC    : directory to which the documantation files are installed


   MODS        : Extensions of Module Files used when "make clean"

   MAKE        : GNU make command

   AR          : Archive command

   ARFLAGS     : Flags of AR

   RANLIB      : Generate index to archive


=end EN

=begin JA
=== ɤΥѥ

ӥɤˤɬ GNU make ѤƤ. ¾ "make" ץ
Ѥ, ӥɤԤޤ.
ʹ GNU make Υޥ̾ "make" ɽޤ,
ϥƥ GNU make ޥɤ֤̾Ƥ.

./configure ¹Ԥ, ʲΤ褦 GNU make Υޥ̾
ɽޤ. Υå˽ä GNU make ¹ԤƤ.

  Execute GNU make in the current directory, as follows.

    /usr/bin/make

=end JA
=begin EN
=== Compile source code

You must use GNU make to build. No other "make" program is acceptable.
"make" tentatively means GNU make at the following.
Replace them with GNU make of your system.

When ./configure is executed, the command name of GNU make is
displayed as follows. Execute GNU make according to this
message.

  Execute GNU make in the current directory, as follows.

    /usr/bin/make

=end EN

=begin JA
=== ɥȤ

ޥ˥奢ȥɥե󥹤Υѥϥȥǥ쥯ȥ
ˤ, ʲΥޥɤ¹ԤƤ.
((<gtool5  TGZ ѥå|URL:http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current.tgz>))
ꤹˤϴѤߤǤ.

	$ make doc
=end JA
=begin EN
=== Generate documentations

To generate documentations, execute the following command
in current directory. If you get from
((<gtool5 TGZ package|URL:http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current.tgz>)),
documentations are already generated.

	$ make doc
=end EN

=begin JA
== 󥹥ȡμ

ȥǥ쥯ȥǰʲΥޥɤ¹ԤƤ.
ƥΰ˥󥹥ȡ뤹ˤϴԸ¤
ɬפǤ. (ǥեȤξϥƥΰ˥󥹥ȡ뤷ޤ).

	# make install

ɥȤ򥤥󥹥ȡ뤹ˤϰʲΥޥɤ¹Ԥޤ.

	# make install-doc

=end JA
=begin EN
== How to install

In current directory, execute following command.
If you install to system, you need to be administrator.
(By default, you install to system).

	# make install

If you want to install documentation files, execute following command.

	# make install-doc

=end EN



=begin JA
== ƥȥץ¹Ԥμ

ȥǥ쥯ȥˤ, ʲΥޥɤ¹ԤƤ.
顼
"(({ *** Compilation and installation are succeeded !! *** }))"
ȤåɽХ󥹥ȡϴλǤ.

	$ make test-installed

=== ѥԤä

饤֥򥯥ѥ뤷, Τ褦ʥå
ɽޤ.

   Cross compile mode will be used.
   First, change directory to ./test .
   Secondly, submit ...
          dc_string_test ... histtest ...,

   Thirdly, change directory to ./ .
   Last "make test-installed-c"

Υå˽, ʲΤ褦˥ƥȤԤäƤ.

  (1) test ǥ쥯ȥ˰ưޤ.
  (2) ꥹȤ¹ԥե¹Ԥޤ.
      ¹ˡϤ줾δĶ˰¸Τ, Ĵ٤Ƥ.
  (3) Υǥ쥯ȥޤ.
  (4) make test-installed-c ¹Ԥޤ.

顼
"(({ *** Compilation and installation are succeeded !! *** }))"
ȤåɽХ󥹥ȡϴλǤ.

=end JA
=begin EN
== Execute test programs

In current directry, execute following command.
If message "(({ *** Compilation and installation are succeeded !! *** }))"
are showed without error, installation is completed.

	$ make test-installed

=== When cross-compiling ...

If you are cross-compiling, following messages will be displayed.

   Cross compile mode will be used.
   First, change directory to ./test .
   Secondly, submit ...
          dc_string_test ... histtest ...,

   Thirdly, change directory to ./ .
   Last "make test-installed-c"

According to above message, test as follows.

  (1) Change directory to test .
  (2) Run listed executable files.
      The way of run depends on each environment.
      Therefore, you should examine the way by yourself.
  (3) Change former directory.
  (4) Do "make test-installed-c".

If message "(({ *** Compilation and installation are succeeded !! *** }))"
are showed without error, installation is completed.

=end EN


=begin JA
== gt5frt ؤΥѥ

嵭Τ褦󥹥ȡ뤬Ԥ줿,
((*gt5frt*)) Ȥ륹ץȤ (({--prefix=}))((|ARG|))
ǻꤵ줿ǥ쥯ȥʲ bin ǥ쥯ȥ ((|ARG|))/bin
˺ƤϤǤ.
( (({--prefix=})) ꤷʤä
(({ /usr/local/gtool5/bin/ })) ʲ).

Υǥ쥯ȥؤΥѥ̤Ƥ.
ʲ (({ /usr/local/gtool5/bin/ })) ʲ ((*gt5frt*))
󥹥ȡ뤵줿Ǥ.

* sh, bash

	$ PATH=$PATH:/usr/local/gtool5/bin ; export PATH

* csh, tcsh

	$ setenv PATH $PATH:/usr/local/gtool5/bin

((*gt5frt*))  gtool5 饤֥Ѥ Fortran ץ
ñ˥ѥ, 󥯤뤿Υ륹ץȤǤ.
ޤѤƤ Fortran ѥΥޥɤ
gt5frt Ѥ뤳Ȥ, ưŪ gtool5 饤֥ؤ
, ⥸塼뷲ؤΥǥ쥯ȥԤäƤޤ.

	$ gt5frt test.f90

	/usr/bin/g95 -I/usr/local/gtool5/include -O test.f90 \
	    -L/usr/local/gtool5/lib -lgtool5 -L/usr/local/lib -lnetcdf

=end JA
=begin EN
== Set PATH to gt5frt

If the installation is correctly done as stated above,
shell script ((*gt5frt*)) is made under the directory
(({--prefix=}))((|ARG|))/bin
(By default, (({ /usr/local/gtool5/bin/ })) ).

Please specify PATH to this directory.
It is an example as follows when ((*gt5frt*)) is installed in
(({/usr/local/gtool5/bin/})) .

* sh, bash

	$ PATH=$PATH:/usr/local/gtool5/bin ; export PATH

* csh, tcsh

	$ setenv PATH $PATH:/usr/local/gtool5/bin

((*gt5frt*)) is a shell script in order to easily compile and link
Fortran programs which utilizes the gtool5 library.
Link to the gtool5 library and directory appointment to the modules
are done automatically by using gt5frt in place of command of the
Fortran compiler.

	$ gt5frt test.f90

	/usr/bin/g95 -I/usr/local/gtool5/include -O test.f90 \
	    -L/usr/local/gtool5/lib -lgtool5 -L/usr/local/lib -lnetcdf


=end EN


=begin HTML
<hr />
<small>
  $Id: INSTALL,v 1.3 2008-10-05 19:51:36 morikawa Exp $
</small>
=end HTML

#== Mode setting for Emacs
#Local Variables:
#mode: rd
#End:
#
