gmtdefaults(1) GMT gmtdefaults(1)
NAME
gmtdefaults - List current GMT default parameters
SYNOPSIS
gmtdefaults [ -D[u|s] ]
Note: No space is allowed between the option flag and the associated
arguments.
DESCRIPTION
gmtdefaults lists all 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 useras currently
active defaults are printed.]
-^ or just -
Print a short message about the syntax of the command, then
exits (NOTE: on Windows just use -).
-+ or just +
Print an extensive usage (help) message, including the explana-
tion 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 all options, then exits.
Your currently active defaults come from the gmt.conf file in the cur-
rent 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 com-
piled.
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 edi-
tor 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 parame-
ters will be used.
SEE ALSO
gmt(1), gmt.conf(5), gmtcolors(5), gmtget(1), gmtset(1)
COPYRIGHT
2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
5.4.2 Jun 24, 2017 gmtdefaults(1)
gmt5 5.4.2 - Generated Wed Jun 28 16:25:07 CDT 2017