1GMTDEFAULTS(1)                        GMT                       GMTDEFAULTS(1)
2
3
4

NAME

6       gmtdefaults - List current GMT default parameters
7

SYNOPSIS

9       gmtdefaults [  -D[u|s] ]
10
11       Note:  No  space  is allowed between the option flag and the associated
12       arguments.
13

DESCRIPTION

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

REQUIRED ARGUMENTS

29       None.
30

OPTIONAL ARGUMENTS

32       -D     Print  the  system GMT defaults to standard output. Append u for
33              US defaults or s for SI defaults. [-D alone  gives  the  version
34              selected at compile time; If -D is omitted, the user's currently
35              active defaults are printed.]
36
37       -^ or just -
38              Print a short message about the  syntax  of  the  command,  then
39              exits (NOTE: on Windows just use -).
40
41       -+ or just +
42              Print  an extensive usage (help) message, including the explana‐
43              tion of any module-specific  option  (but  not  the  GMT  common
44              options), then exits.
45
46       -? or no arguments
47              Print a complete usage (help) message, including the explanation
48              of all options, then exits.
49
50       Your currently active defaults come from the gmt.conf file in the  cur‐
51       rent working directory, if present; else from the gmt.conf file in your
52       home directory, if present;  else  from  the  file  ~/.gmt/gmt.conf  if
53       present;  else  from  the  system defaults set at the time GMT was com‐
54       piled.
55

GMT PARAMETERS

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

EXAMPLES

61       To get a copy of the GMT parameter defaults in your home directory, run
62
63              gmt defaults -D > ~/gmt.conf
64
65       You  may now change the settings by editing this file using a text edi‐
66       tor of your choice, or use gmtset to change specified parameters on the
67       command line.
68

BUGS

70       If  you  have  typographical errors in your gmt.conf file(s), a warning
71       message will be issued, and the GMT defaults for the  affected  parame‐
72       ters will be used.
73

SEE ALSO

75       gmt, gmt.conf, gmtcolors, gmtget, gmtset
76

78       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
79
80
81
82
835.4.5                            Feb 24, 2019                   GMTDEFAULTS(1)
Impressum