xenial (1) gmtwhich.1gmt.gz

Provided by: gmt-common_5.2.1+dfsg-3build1_all bug

NAME
       gmtwhich - Find full path to specified files


SYNOPSIS
       gmtwhich files [  ] [  ] [  ] [ [level] ]

       Note: No space is allowed between the option flag and the associated arguments.


DESCRIPTION
       gmtwhich  reports  the full paths to the files given on the command line. We look for the file in (1) the
       current directory, (2) in $GMT_USERDIR (if defined), (3) in $GMT_DATADIR (if defined). If found we  print
       the full path name to the file, just the directory (see -D), or a confirmation (see -C). The $GMT_USERDIR
       and $GMT_DATADIR environment variables  can  be  colon-separated  list  of  directories,  and  we  search
       recursively  down  any  directory  that  ends  with  /  (i.e., /export/data is a single directory whereas
       /export/data/ will be searched recursively.)


REQUIRED ARGUMENTS
       files  One or more file names of any data type (grids, tables, etc.).


OPTIONAL ARGUMENTS
       -A     Only consider files that the user has permission to read [Default consider all files found].

       -C     Instead of reporting the paths, print the confirmation Y if the file is found and N if it is not.

       -D     Instead of reporting the paths, print the directories that contains the files.

       -V[level] (more ...)
              Select verbosity level [c].

       -^ or just -
              Print a short message about the syntax of the command, then exits (NOTE: on Windows use just -).

       -+ or just +
              Print an extensive usage (help) message, including the explanation of any  module-specific  option
              (but not the GMT common options), then exits.

       -? or no arguments
              Print a complete usage (help) message, including the explanation of options, then exits.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.


SEE ALSO
       gmt


       2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe