.\" Man page generated from reStructuredText.
.
.TH "GMTSET" "1gmt" "October 29, 2016" "5.3.1" "GMT"
.SH NAME
gmtset \- Change individual 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
\fBgmtset\fP [  \fB\-C\fP |  \fB\-D\fP[\fBs\fP|\fBu\fP] |
 \fB\-G\fP\fIdefaultsfile\fP ] [ \fB\-\fP[\fBBJRXxYycp\fP]\fIvalue\fP ]
PARAMETER1 [=] \fIvalue1\fP PARAMETER2 [=] \fIvalue2\fP PARAMETER3 [=] \fIvalue3\fP
...
.sp
\fBNote:\fP No space is allowed between the option flag and the associated arguments.
.SH DESCRIPTION
.sp
\fBgmtset\fP will adjust individual GMT defaults settings in the
current directory\(aqs \fBgmt.conf\fP file. If no such file exists one will
be created. The main purpose of \fBgmtset\fP is temporarily to change
certain parameters inside a shell script, e.g., set the dots\-per\-inch to
72, run the script, and reset to 1200 dpi. Optionally, you can specify
one or more temporary changes directly on any GMT command line with
the syntax \fB\-\fP\fB\-PARAMETER\fP=\fIVALUE\fP; such changes are only in effect
for that command and do not permanently change the default settings on
disk.
.SH REQUIRED ARGUMENTS
.INDENT 0.0
.TP
.B PARAMETER \fIvalue\fP
Provide one or several pairs of parameter/value combinations that
you want to modify. For a complete listing of available parameters
and their meaning, see the \fBgmt.conf\fP man page.
.UNINDENT
.SH OPTIONAL ARGUMENTS
.INDENT 0.0
.TP
.B \fB\-C\fP
Convert a .gmtdefaults4 file created by GMT4 to a \fBgmt.conf\fP file
used by GMT5. The original file is retained.
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-D\fP[\fBs\fP|\fBu\fP]
Modify the GMT defaults based on the system settings. Append
\fBu\fP for US defaults or \fBs\fP for SI defaults. [\fB\-D\fP alone gives
the version selected at compile time]
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-G\fP\fIdefaultsfile\fP
Name of specific \fBgmt.conf\fP file to read and modify [Default looks
first in current directory, then in your home directory, then in
~/.gmt and finally in the system defaults].
.TP
.B \fB\-\fP[\fBBJRXxYycp\fP]\fIvalue\fP
Set the expansion of any of these shorthand options.
.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
.SH EXAMPLES
.sp
To change annotation font to 12\-point Helvetica, select grid\-crosses of
size 0.1 inch, and set annotation offset to 0.2 cm:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt set FONT_ANNOT_PRIMARY 12p,Helvetica \e
        MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_ANNOT_OFFSET_PRIMARY 0.2c
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBgmt\fP, \fBgmt.conf\fP,
\fBgmtdefaults\fP, \fBgmtget\fP
.SH COPYRIGHT
2016, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
.\" Generated by docutils manpage writer.
.