Register
Login
Resources
Docs Blog Datasets Glossary Case Studies Tutorials & Webinars
Product
Data Engine LLMs Platform Enterprise
Pricing Explore
Connect to our Discord channel

preface.rst 3.2 KB

You have to be logged in to leave a comment. Sign In
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
  1. Preface
  2. =======
  3. While GMT has served the map-making and data processing needs of
  4. scientists since 1988 [1]_, the current global use was heralded by the
  5. first official release in *EOS Trans. AGU* in the fall of 1991. Since
  6. then, GMT has grown to become a standard tool for many users,
  7. particularly in the Earth and Ocean Sciences but the global collective
  8. of GMT users is incredibly diverse. Development has at times been
  9. rapid, and numerous releases have seen the light of day since the early
  10. versions. For a detailed history of the changes from release to release,
  11. see :doc:`/changes`. For a nightly snapshot of ongoing
  12. activity, see the `GMT repository on GitHub <https://github.com/GenericMappingTools/gmt>`__.
  13. For a historical perspective of the origins and development of GMT,
  14. see the video podcast `"20 Years with GMT – The Generic Mapping Tools" <https://doi.org/10.5446/19869>`__
  15. produced following a seminar given by Paul Wessel on the 20th anniversary of GMT.
  16. The success of GMT is to a large degree due to the input of the user
  17. community. In fact, most of the capabilities and options in the
  18. GMT modules originated as user requests. We would like to hear from
  19. you should you have any suggestions for future enhancements and
  20. modification. Please submit a bug report or a feature request
  21. on GitHub (`<https://github.com/GenericMappingTools/gmt/issues>`_).
  22. .. _command-line-completion:
  23. Command-line completion
  24. -----------------------
  25. GMT provides basic command-line completion (tab completion) for bash.
  26. The easiest way to use the feature is to install the
  27. `bash-completion <https://github.com/scop/bash-completion/>`_ package
  28. which is available in many operating system distributions.
  29. Depending on the distribution, you may still need to source it from
  30. ``~/.bashrc``, e.g.:
  31. .. code-block:: bash
  32. # Use bash-completion, if available
  33. if [ -r /usr/share/bash-completion/bash_completion ]; then
  34. . /usr/share/bash-completion/bash_completion
  35. fi
  36. When you install GMT from a distribution package, the completion rules
  37. are installed in ``/etc/bash_completion.d/gmt`` and loaded automatically.
  38. Custom GMT builds provide ``<prefix>/share/tools/gmt_completion.bash``
  39. which needs to be manually sourced from either ``~/.bash_completion`` or
  40. ``~/.bashrc``.
  41. Mac users should note that bash-completion >=2.0 requires bash >=4.1.
  42. However, OS X won't ship anything that's licensed under GPL version 3.
  43. The last version of bash available under the GPLv2 is 3.2 from 2006.
  44. It is recommended that *bash-completion* is installed together with
  45. *bash* via `MacPorts <http://www.macports.org/>`_,
  46. `Fink <http://finkproject.org/>`_, or `Homebrew <http://brew.sh/>`_.
  47. You then need to change the shell used by your terminal application.
  48. The `bash-completion HOWTO from MacPorts
  49. <https://trac.macports.org/wiki/howto/bash-completion>`_
  50. explains how to change the preferences of Terminal.app and iTerm.app.
  51. Another way is to change the default shell by editing of the user
  52. database:
  53. .. code-block:: bash
  54. Add /opt/local/bin/bash to /etc/shells
  55. chsh -s /opt/local/bin/bash
  56. Modify the path to bash, ``/opt/local/bin/bash``, in the example above
  57. accordingly.
  58. Footnote
  59. --------
  60. .. [1]
  61. Version 1.0 was then informally released at the Lamont-Doherty Earth Observatory.
Tip!

Press p or to see the previous file or, n or to see the next file

Comments

Loading...