#
# gt4f90io Installation Guide in RD (Ruby Document) format
#
#   For instruction of installing gt4f90io, see "INSTALL.htm.en"
#   (written in English) or  "INSTALL.htm" (written in Japanese)
#   included in "gt4f90io" TGZ package available from
#   <http://www.gfd-dennou.org/library/gtool4>.
#   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

= gt4f90io 󥹥ȡ륬

# *   (morikawa), ˭ ѻ (toyoda),   (odakker)
#   * $Id: INSTALL,v 1.21 2007/04/17 16:13:00 morikawa Exp $

=end JA
=begin EN

= Gt4f90io Installation Guide

# * Yasuhiro MORIKAWA (morikawa), Eizi TOYODA (toyoda), Masatsugu ODAKA (odakker)
#   * $Id: INSTALL,v 1.21 2007/04/17 16:13:00 morikawa Exp $

=end EN

=begin JA
== ưĶ

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

=end JA

=begin EN
== Operation Environment

Gt4f90io library is operated by following environments.

=end EN

=begin

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

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

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

=end

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

=begin
  * Windows XP + Intel Visual Fortran 9.1
  * Windows XP + Compaq Visual Fortran 6.6
  * HITACHI SR11000 + IBM XL Fortran Enterprise Edition for AIX5L
  * HITACHI SR11000 + Optimizing FORTRAN90 Compiler
  * NEC SX-6 + FORTRAN90/SX
  * FUJITSU VPP-5000 + VPP Fortran
=end


=begin JA
== ϥե

gt4f90io ϰʲΥե򥵥ݡȤޤ.

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

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

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

=end JA

=begin EN
== Input Output Data Format

gt4f90io support following data format.

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

=end EN

=begin JA
== 󥹥ȡή

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

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

=== 󥹥ȡ

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


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

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

=== Windows 桼Τߤʤޤ

((< ľͤ|URL:http://www.se.fukuoka-u.ac.jp/~otobe/>))
 Intel Visual Fortran 9.x Ѥ Windows Хʥ
Ƥޤ.
((<gt4f90io Windows Хʥ|URL:http://www.se.fukuoka-u.ac.jp/~otobe/gt4f90io.html>))
򻲾ȤƤ.


=end JA

=begin EN
== General outline

Install gt4f90io 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 gt4frt>)).

=== Install example

There are examples of installation in "Tutorial" on
((<gtool4 Project|URL:http://www.gfd-dennou.org/library/gtool4/>)).
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/gtool4/debian.htm.en>))
can be used.

=== For Windows users

((<Naohito OTOBE (in JAPANESE)|URL:http://www.se.fukuoka-u.ac.jp/~otobe/>))
creates Windows binaries for Intel Visual Fortran 9.x.
See ((<Gt4f90io Windows binaries (in JAPANESE)|URL:http://www.se.fukuoka-u.ac.jp/~otobe/gt4f90io.html>)).

=end EN

=begin JA
== ɬפʥեȥ

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

: netCDF (С 3.6.0, 3.6.1)
  Debian GNU/Linux ѤƤ, netCDF ХʥѥåѤ

  * debian ѥå
    [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ffc5_3.6.0-2_i386.deb>)) |
    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ifc8.1_3.6.0-p1-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.1  TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.1.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>))]
  

ɥȤ뤿ˤϰʲΥեȥ
˥󥹥ȡ뤷Ƥɬפޤ. ,
((<gt4f90io  TGZ ѥå|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io_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 gt4f90io.

: netCDF (version 3.6.0 or 3.6.1)

  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.0-2_i386.deb>)) |
    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/cc-env/Linux/debian-dennou/netcdf/sarge/netcdf-ifc8.1_3.6.0-p1-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.1 TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.1.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
((<gt4f90io TGZ package|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io_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 ѥåŸ

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

	$ tar xvzf gt4f90io-current.tgz

ޤ

	$ zcat gt4f90io-current.tar.gz | tar -xvf -

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

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

	$ tar xvzf gt4f90io-current.tgz

or

	$ zcat gt4f90io-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 })) ե뤬ޤ.

	$ ./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 饤֥ꤷޤ. ɬŪ˻ꤹɬפޤ.

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

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

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

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

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

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

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

:(({--with-gt4suffix=}))((|ARG|))
  ((|ARG|)) ˤϥ󥹥ȡǥ쥯ȥ, 饤֥̾,
  ¹ԥեˤĤꤷޤ.
  㤨, ¾ƥǥեȤ (({ ffc5 })) Ȼꤹ,
  󥹥ȡΥǥ쥯ȥΥץեå
  (({ /usr/local/gt4f90io-ffc5 })), 饤֥̾
  (({ libgt4f90io-ffc5.a })), 󥹥ȡ뤹¹ԥե̾
  (({ gt4frt.ffc5 })), (({ gt4config.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.

A configure file `Config.mk' created at the current working directory.

	$ ./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 in ((<Libraries needed for compile>)) to ((|ARG|)).
  You must specify explicitly.

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

:(({--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/gt4f90io/lib })).

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

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

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

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

:(({--with-gt4suffix=}))((|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/gt4f90io-ffc5 })),
  library name becomes (({ libgt4f90io-ffc5.a })),
  executable files become (({ gt4frt.ffc5 })), (({ gt4config.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    : gt4f90io 饤֥ꥤ󥹥ȡǥ쥯ȥ

   DEST_INC    : gt4f90io ⥸塼륤󥹥ȡǥ쥯ȥ

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

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



   MODS        : ⥸塼եĥ

   MAKE        : GNU make ޥ

   AR          : ֥ޥ

   ARFLAGS     : ֻɬפʥե饰

   RANLIB      : ֤Υǥå륳ޥ

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

Edit `(({Config.mk}))' manually, if you want to change.

   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
=== ɥȤ

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

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

To generate documentations, execute the following command
in current directory. If you get from
((<gt4f90io TGZ package|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io_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
== gt4frt ؤΥѥ

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

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

* sh, bash

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

* csh, tcsh

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

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

	$ gt4frt test.f90

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

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

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

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

* sh, bash

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

* csh, tcsh

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

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

	$ gt4frt test.f90

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


=end EN


=begin HTML
<hr />
<small>
  $Id: INSTALL,v 1.21 2007/04/17 16:13:00 morikawa Exp $
</small>
=end HTML

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