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

5.2.1                                           January 28, 2016                               GMTDEFAULTS(1gmt)