docs: Split GMT cookbook into chapters

doc/rst/source/cookbook.rst

@@ -8,8 +8,54 @@ The GMT Cookbook
    Since classic mode commands haven't changed since GMT 5, please visit
    the `GMT 5 cookbook <https://docs.generic-mapping-tools.org/5.4/GMT_Docs.html>`_ instead.
 
+**Pål (Paul) Wessel**:sup:`1`,
+**Walter H. F. Smith**:sup:`2`,
+**Remko Scharroo**:sup:`3`,
+**Joaquim F. Luis**:sup:`4`, \
+**Leonardo Uieda**:sup:`5`,
+**Florian Wobbe**:sup:`6`,
+**Dongdong Tian**:sup:`7`
+
+#. SOEST, University of Hawai'i at Manoa
+#. Laboratory for Satellite Altimetry, NOAA/NESDIS/STAR
+#. EUMETSAT, Darmstadt, Germany
+#. Universidade do Algarve, Faro, Portugal
+#. University of Liverpool, UK
+#. Sea and Sun Technology, Germany
+#. Michigan State University
+
+.. figure:: /_images/GMT6_Summit_2019.jpg
+   :width: 1200 px
+   :align: center
+
+   Dongdong Tian, David Sandwell (Steering Committee Chair), Walter H.F. Smith, Paul Wessel,
+   Joaquim Luis, Leo Uieda, and Dave Caress (Steering Committee Member)
+   at the GMT Developer Summit in La Jolla, California, during July 29–August 2, 2019.
+
 .. toctree::
    :maxdepth: 1
    :numbered:
 
-   GMT_Docs
+   cookbook/acknowledgments
+   cookbook/citation
+   cookbook/copyright
+   cookbook/preface
+   cookbook/introduction
+   cookbook/overview
+   cookbook/features
+   cookbook/coordinate_transformations
+   cookbook/map_projections
+   cookbook/supplemental_packages
+   cookbook/file_formats
+   cookbook/include_figures
+   cookbook/predefined_patterns
+   cookbook/octal_codes
+   cookbook/postscript_fonts
+   cookbook/colorspace
+   cookbook/data_filtering
+   cookbook/coastline
+   cookbook/non_unix_platforms
+   cookbook/colorbars
+   cookbook/custom_symbols
+   cookbook/contour_annotations
+   cookbook/ogrgmt_format.rst

doc/rst/source/cookbook/acknowledgments.rst

@@ -0,0 +1,40 @@
+Acknowledgments
+---------------
+
+The Generic Mapping Tools (GMT) could not have been designed without
+the generous support of several people. The Founders (Wessel and Smith)
+gratefully acknowledge A. B.
+Watts and the late W. F. Haxby for supporting their efforts on the
+original version 1.0 while they were their graduate students at
+Lamont-Doherty Earth Observatory. Doug Shearer and Roger Davis patiently
+answered many questions over e-mail. The subroutine ``gauss`` was
+written and supplied by Bill Menke. Further development of versions
+2.0–2.1 at SOEST would not have been possible without the support from
+the HIGP/SOEST Post-Doctoral Fellowship program to Paul Wessel. Walter
+H. F. Smith gratefully acknowledges the generous support of the C. H.
+and I. M. Green Foundation for Earth Sciences at the Institute of
+Geophysics and Planetary Physics, Scripps Institution of Oceanography,
+University of California at San Diego. GMT series 3.x, 4.x, and 5.x
+owe their existence to grants EAR-93-02272, OCE-95-29431, OCE-00-82552,
+OCE-04-52126, and OCE-1029874 from the National Science Foundation,
+which we gratefully acknowledge.
+
+We would also like to acknowledge feedback, suggestions and bug reports
+from Michael Barck, Manfred Brands, Allen Cogbill, Stephan Eickschen,
+Ben Horner-Johnson, John Kuhn, Angel Li, Andrew Macrae, Alex Madon, Ken
+McLean, Greg Neumann, Ameet Raval, Georg Schwarz, Richard Signell, Peter
+Schmidt, Dirk Stoecker, Eduardo Suárez, Mikhail Tchernychev, Malte
+Thoma, David Townsend, Garry Vaughan, William Weibel, and many others,
+including their advice on how to make GMT portable to a wide range of
+platforms. John Lillibridge and Stephan Eickschen provided the original
+Examples :ref:`(11) <example_11>` and :ref:`(32) <example_32>`,
+respectively; Hanno von Lom helped resolve early
+problems with DLL libraries for Win32; Lloyd Parkes enabled indexed
+color images in PostScript; Kurt Schwehr maintains the packages; Wayne
+Wilson implemented the full general perspective projection; and William
+Yip helped translate GMT to POSIX ANSI C and incorporate netCDF 3. The
+SOEST RCF staff (Ross Ishida, Pat Townsend, and Sharon Stahl) provided
+valuable help on Linux and web server support.
+
+Honolulu, HI; College Park, MD; Faro, Portugal; Darmstadt and
+Trappenkamp, Germany; Liverpool, UK; Lansing, MI; September 2019

doc/rst/source/cookbook/citation.rst

@@ -0,0 +1,77 @@
+A Reminder
+==========
+
+If you feel it is appropriate, you may consider paying us back by citing
+our articles on GMT and technical papers on algorithms when you
+publish papers containing results or illustrations obtained using GMT.
+The articles on GMT are
+
+-  Wessel, P., Luis, J., Uieda, L., Scharroo, R., Wobbe, F., Smith, W. H. F., & Tian, D. (2019).
+   The Generic Mapping Tools Version 6. Geochemistry, Geophysics, Geosystems, 20.
+   https://doi.org/10.1029/2019GC008515
+
+-  Wessel, P., W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe,
+   Generic Mapping Tools: Improved Version Released, *EOS Trans. AGU*, 94(45),
+   p. 409–410, 2013. `doi:10.1002/2013EO450001 <http://dx.doi.org/10.1002/2013EO450001>`_.
+
+-  Wessel, P., and W. H. F. Smith, New, improved version of Generic
+   Mapping Tools released, *EOS Trans. AGU*, 79(47),
+   p. 579, 1998. `doi:10.1029/98EO00426 <http://dx.doi.org/10.1029/98EO00426>`_.
+
+-  Wessel, P., and W. H. F. Smith, New version of the Generic Mapping
+   Tools released, *EOS Trans. AGU*, 76(33), 329, 1995. `doi:10.1029/95EO00198 <http://dx.doi.org/10.1029/95EO00198>`_.
+
+-  Wessel, P., and W. H. F. Smith, Free software helps map and display
+   data, *EOS Trans. AGU*, 72(41), 445–446, 1991. `doi:10.1029/90EO00319 <http://dx.doi.org/10.1029/90EO00319>`_.
+
+
+Some GMT modules are based on algorithms we have developed and
+published separately, such as
+
+-  Kim, S.-S., and P. Wessel, Directional median filtering for
+   regional-residual separation of bathymetry, *Geochem. Geophys.
+   Geosyst.*, 9, Q03005, 2008. `doi:10.1029/2007GC001850 <http://dx.doi.org/10.1029/2007GC001850>`_.
+   [:doc:`/dimfilter`]
+
+-  Luis, J. F. and J. M. Miranda, Reevaluation of magnetic chrons in the
+   North Atlantic between 35ºN and 47ºN: Implications for the formation of the
+   Azores Triple Junction and associated plateau,
+   *J. Geophys. Res.*, 113, B10105, 2008. `doi:10.1029/2007JB005573 <http://dx.doi.org/10.1029/2007JB005573>`_.
+   [:doc:`grdredpol </supplements/potential/grdredpol>`, **potential** supplement]
+
+-  Smith, W. H. F., and P. Wessel, Gridding with continuous curvature
+   splines in tension, *Geophysics*, 55(3), 293–305, 1990. `doi:10.1190/1.1442837 <http://dx.doi.org/10.1190/1.1442837>`_.
+   [:doc:`/surface`]
+
+-  Wessel, P., Tools for analyzing intersecting tracks: The x2sys
+   package, *Computers & Geosciences*, 36, 348–354, 2010. `doi:10.1016/j.cageo.2009.05.009 <http://dx.doi.org/10.1016/j.cageo.2009.05.009>`_.
+   [:doc:`x2sys </supplements/x2sys/x2sys_init>` supplement]
+
+-  Wessel, P., A General-purpose Green's function-based interpolator,
+   *Computers & Geosciences*, 35, 1247–1254, 2009. `doi:10.1016/j.cageo.2008.08.012 <http://dx.doi.org/10.1016/j.cageo.2008.08.012>`_.
+   [:doc:`/greenspline`]
+
+-  Wessel, P. and J. M. Becker, Interpolation using a generalized
+   Green's function for a spherical surface spline in tension, *Geophys.
+   J. Int.*, 174, 21–28, 2008. `doi:10.1111/j.1365-246X.2008.03829.x <http://dx.doi.org/10.1111/j.1365-246X.2008.03829.x>`_.
+   [:doc:`/greenspline`]
+
+Finally, GMT includes some code supplied by others, in particular the
+Triangle code used for Delaunay triangulation. Its author, `Jonathan
+Shewchuk <http://www.cs.berkeley.edu/~jrs/>`_, says
+
+    "If you use Triangle, and especially if you use it to accomplish
+    real work, I would like very much to hear from you. A short letter
+    or email describing how you use Triangle will
+    mean a lot to me. The more people I know are using this program, the
+    more easily I can justify spending time on improvements and on the
+    three-dimensional successor to Triangle, which in turn will benefit
+    you."
+
+A few GMT users take the time to write us letters, telling us of the
+difference GMT is making in their work. We appreciate receiving these
+letters. On days when we wonder why we ever released GMT we pull these
+letters out and read them. Seriously, as financial support for
+GMT depends on how well we can "sell" the idea to funding agencies and
+our superiors, letter-writing is one area where GMT users can affect
+such decisions by supporting the GMT project.