grdpaste: Improve the documentation (#8897)

Author: seisman

doc/rst/source/grdpaste.rst

@@ -12,8 +12,8 @@ Synopsis
 
 .. include:: common_SYN_OPTs.rst_
 
-**gmt grdpaste** *file_a.nc file_b.nc*
-|-G|\ *outfile.nc*
+**gmt grdpaste** *grid_a grid_b*
+|-G|\ *outgrid*
 [ |-S| ]
 [ |SYN_OPT-V| ]
 [ |SYN_OPT-f| ]
@@ -24,9 +24,9 @@ Synopsis
 Description
 -----------
 
-**grdpaste** will combine *file_a.nc* and *file_b.nc* into
-*outfile.nc* by pasting them together along their common edge. Files
-*file_a.nc* and *file_b.nc* must have the same grid spacings and registration, and must have one
+**grdpaste** will combine *grid_a* and *grid_b* into
+*outgrid* by pasting them together along their common edge. Files
+*grid_a* and *grid_b* must have the same grid spacings and registration, and must have one
 edge in common. If in doubt, check with :doc:`grdinfo` and use :doc:`grdcut`
 and/or :doc:`grdsample` if necessary to prepare the edge joint. **Note**: For
 geographical grids, you may have to use **-f** to handle periodic longitudes
@@ -36,14 +36,14 @@ For stitching multiple grids, see :doc:`grdblend` instead.
 Required Arguments
 ------------------
 
-*file_a.nc*
+*grid_a*
     One of two files to be pasted together.
-*file_b.nc*
+*grid_b*
     The other of two files to be pasted together.
 
 .. _-G:
 
-**-G**\ *outfile.nc*
+**-G**\ *outgrid*
     The name for the combined output. (See :ref:`Grid File Formats <grd_inout_full>`).
 
 Optional Arguments
@@ -54,7 +54,7 @@ Optional Arguments
 **-S**
     Just prints a code number and a description of the sides at which the grids are pasted.
     No pasting actually happens. -G is ignored. This option is useful for externals that want to
-    reimplement the grdpaste utility since it doesn't work form them (*e.g.* Julia and GMTMEX).
+    reimplement the grdpaste utility since it doesn't work for them (*e.g.* Julia and GMTMEX).
 
 .. |Add_-V| replace:: |Add_-V_links|
 .. include:: explain_-V.rst_
@@ -71,13 +71,13 @@ Examples
 
 .. include:: explain_example.rst_
 
-Suppose file_a.nc is 150E - 180E and 0 - 30N, and file_b.nc is 150E -
-180E, -30S - 0, then you can make outfile.nc which will be 150 - 180 and
+Suppose grid_a.nc is 150E - 180E and 0 - 30N, and grid_b.nc is 150E -
+180E, -30S - 0, then you can make outgrid.nc which will be 150 - 180 and
 -30S - 30N by:
 
 ::
 
-  gmt grdpaste file_a.nc file_b.nc -Goutfile.nc -V -fg
+  gmt grdpaste grid_a.nc grid_b.nc -Goutgrid.nc -V -fg
 
 See Also
 --------