NAME

       gmtdefaults - List current GMT default parameters

SYNOPSIS

       gmtdefaults [ [u|s] ]

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

DESCRIPTION

       gmtdefaults  lists  the  GMT  parameter defaults if the option -D is used. There are three
       ways to change some of the settings: (1) Use the command gmtset, (2) use any  text  editor
       to  edit  the  file gmt.conf in your home, ~/.gmt or current directory (if you do not have
       this file, run gmtset -D to get one with the system default settings), or (3) override any
       parameter  by  specifying  one or more --PARAMETER=VALUE statements on the command line of
       any GMT command (PARAMETER and VALUE are any combination  listed  below).  The  first  two
       options  are  permanent  changes  until  explicitly changed back, while the last option is
       ephemeral and only applies to the single GMT command that received the override.  GMT  can
       provide default values in US or SI units. This choice is determined at compile time.

REQUIRED ARGUMENTS

       None.

OPTIONAL ARGUMENTS

       -D     Print the system GMT defaults to standard output. Append u for US defaults or s for
              SI defaults. [-D alone gives the  version  selected  at  compile  time;  If  -D  is
              omitted, the user's currently active defaults are printed.]

       -^ 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.

       Your currently active defaults  come  from  the  gmt.conf  file  in  the  current  working
       directory,  if  present;  else  from the gmt.conf file in your home directory, if present;
       else from the file ~/.gmt/gmt.conf if present; else from the system defaults  set  at  the
       time GMT was compiled.

GMT PARAMETERS

       Read  the  gmt.conf  man page for a full list of the parameters that are user-definable in
       GMT.

EXAMPLES

       To get a copy of the GMT parameter defaults in your home directory, run

              gmt defaults -D > ~/gmt.conf

       You may now change the settings by editing this file using a text editor of  your  choice,
       or use gmtset to change specified parameters on the command line.

BUGS

       If  you  have  typographical  errors  in  your gmt.conf file(s), a warning message will be
       issued, and the GMT defaults for the affected parameters will be used.

SEE ALSO

       gmt, gmt.conf, gmtcolors, gmtget, gmtset

COPYRIGHT

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