[thirdparty/gcc.git] / gcc / fortran / doc / gfortran / gnu-fortran-command-options / options-for-directory-search.rst

..
  Copyright 1988-2022 Free Software Foundation, Inc.
  This is part of the GCC manual.
  For copying conditions, see the copyright.rst file.

.. index:: directory, options, options, directory search, search path, INCLUDE directive, directive, INCLUDE

.. _directory-options:

Options for directory search
****************************

These options affect how GNU Fortran searches
for files specified by the ``INCLUDE`` directive and where it searches
for previously compiled modules.

It also affects the search paths used by :command:`cpp` when used to preprocess
Fortran source.

.. index:: Idir, directory, search paths for inclusion, inclusion, directory search paths for, search paths, for included files, paths, search, module search path

.. option:: -Idir

  These affect interpretation of the ``INCLUDE`` directive
  (as well as of the ``#include`` directive of the :command:`cpp`
  preprocessor).

  Also note that the general behavior of :option:`-I` and
  ``INCLUDE`` is pretty much the same as of :option:`-I` with
  ``#include`` in the :command:`cpp` preprocessor, with regard to
  looking for :samp:`header.gcc` files and other such things.

  This path is also used to search for :samp:`.mod` files when previously
  compiled modules are required by a ``USE`` statement.

  See :ref:`gcc:directory-options`, for information on the
  :option:`-I` option.

.. index:: Jdir, Mdir, paths, search, module search path

.. option:: -Jdir

  This option specifies where to put :samp:`.mod` files for compiled modules.
  It is also added to the list of directories to searched by an ``USE``
  statement.

  The default is the current directory.

.. index:: fintrinsic-modules-pathdir, paths, search, module search path

.. option:: -fintrinsic-modules-path {dir}

  This option specifies the location of pre-compiled intrinsic modules, if
  they are not in the default location expected by the compiler.
Commit	Line	Data
c63539ff ML	1	..
	2	Copyright 1988-2022 Free Software Foundation, Inc.
	3	This is part of the GCC manual.
	4	For copying conditions, see the copyright.rst file.
	5
	6	.. index:: directory, options, options, directory search, search path, INCLUDE directive, directive, INCLUDE
	7
	8	.. _directory-options:
	9
	10	Options for directory search
	11	****************************
	12
	13	These options affect how GNU Fortran searches
	14	for files specified by the ``INCLUDE`` directive and where it searches
	15	for previously compiled modules.
	16
	17	It also affects the search paths used by :command:`cpp` when used to preprocess
	18	Fortran source.
	19
	20	.. index:: Idir, directory, search paths for inclusion, inclusion, directory search paths for, search paths, for included files, paths, search, module search path
	21
	22	.. option:: -Idir
	23
	24	These affect interpretation of the ``INCLUDE`` directive
	25	(as well as of the ``#include`` directive of the :command:`cpp`
	26	preprocessor).
	27
	28	Also note that the general behavior of :option:`-I` and
	29	``INCLUDE`` is pretty much the same as of :option:`-I` with
	30	``#include`` in the :command:`cpp` preprocessor, with regard to
	31	looking for :samp:`header.gcc` files and other such things.
	32
	33	This path is also used to search for :samp:`.mod` files when previously
	34	compiled modules are required by a ``USE`` statement.
	35
	36	See :ref:`gcc:directory-options`, for information on the
	37	:option:`-I` option.
	38
	39	.. index:: Jdir, Mdir, paths, search, module search path
	40
	41	.. option:: -Jdir
	42
	43	This option specifies where to put :samp:`.mod` files for compiled modules.
	44	It is also added to the list of directories to searched by an ``USE``
	45	statement.
	46
	47	The default is the current directory.
	48
	49	.. index:: fintrinsic-modules-pathdir, paths, search, module search path
	50
	51	.. option:: -fintrinsic-modules-path {dir}
	52
	53	This option specifies the location of pre-compiled intrinsic modules, if
3ed1b4ce	54	they are not in the default location expected by the compiler.