.\" Man page generated from reStructuredText.
.
.TH "GMTDEFAULTS" "1gmt" "October 29, 2016" "5.3.1" "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 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 \fBgmtset\fP, (2) use any text editor to edit the file
\fBgmt.conf\fP in your home, ~/.gmt or current directory (if you do not
have this file, run \fBgmtset\fP \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
.B \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
.B \fB\-^\fP or just \fB\-\fP
Print a short message about the syntax of the command, then exits (NOTE: on Windows use just \fB\-\fP).
.TP
.B \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
.B \fB\-?\fP or no arguments
Print a complete usage (help) message, including the explanation of options, then exits.
.UNINDENT
.sp
Your currently active defaults come from the \fBgmt.conf\fP file in
the current working directory, if present; else from the
\fBgmt.conf\fP 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 \fBgmt.conf\fP 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 \fBgmtset\fP to change specified parameters on the
command line.
.SH BUGS
.sp
If you have typographical errors in your \fBgmt.conf\fP file(s), a warning
message will be issued, and the GMT defaults for the affected
parameters will be used.
.SH SEE ALSO
.sp
\fBgmt\fP, \fBgmt.conf\fP,
\fBgmtcolors\fP, \fBgmtget\fP,
\fBgmtset\fP
.SH COPYRIGHT
2016, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
.\" Generated by docutils manpage writer.
.