.\" Man page generated from reStructuredText.
.
.TH "GMTDEFAULTS" "1gmt" "May 21, 2019" "5.4.5" "GMT"
.SH NAME
gmtdefaults \- List current GMT default parameters
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBgmtdefaults\fP [  \fB\-D\fP[\fBu\fP|\fBs\fP] ]
.sp
\fBNote:\fP No space is allowed between the option flag and the associated arguments.
.SH DESCRIPTION
.sp
\fBgmtdefaults\fP lists all the GMT parameter defaults if the option
\fB\-D\fP 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 \fB\-D\fP to get one with the system default
settings), or (3) override any parameter by specifying one
or more \fB\-\fP\fB\-PARAMETER\fP=\fIVALUE\fP statements on the command line of any
GMT command (\fBPARAMETER\fP and \fIVALUE\fP 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.
.SH REQUIRED ARGUMENTS
.sp
None.
.SH OPTIONAL ARGUMENTS
.INDENT 0.0
.TP
\fB\-D\fP
Print the system GMT defaults to standard output. Append \fBu\fP
for US defaults or \fBs\fP for SI defaults. [\fB\-D\fP alone gives the
version selected at compile time; If \fB\-D\fP is omitted, the user\(aqs
currently active defaults are printed.]
.UNINDENT
.INDENT 0.0
.TP
\fB\-^\fP or just \fB\-\fP
Print a short message about the syntax of the command, then exits (NOTE: on Windows just use \fB\-\fP).
.TP
\fB\-+\fP or just \fB+\fP
Print an extensive usage (help) message, including the explanation of
any module\-specific option (but not the GMT common options), then exits.
.TP
\fB\-?\fP or no arguments
Print a complete usage (help) message, including the explanation of all options, then exits.
.UNINDENT
.sp
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 \fB~/.gmt/gmt.conf\fP if present; else from the system defaults
set at the time GMT was compiled.
.SH GMT PARAMETERS
.sp
Read the gmt.conf man page for a full list of the parameters that
are user\-definable in GMT.
.SH EXAMPLES
.sp
To get a copy of the GMT parameter defaults in your home directory, run
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt defaults \-D > ~/gmt.conf
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
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.
.SH BUGS
.sp
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.
.SH SEE ALSO
.sp
gmt, gmt.conf,
gmtcolors, gmtget,
gmtset
.SH COPYRIGHT
2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
.\" Generated by docutils manpage writer.
.