diff --git a/examples/projections/azim/azim_equidistant.py b/examples/projections/azim/azim-equidistant.py
similarity index 100%
rename from examples/projections/azim/azim_equidistant.py
rename to examples/projections/azim/azim-equidistant.py
diff --git a/examples/projections/azim/azim_general_perspective.py b/examples/projections/azim/azim-general-perspective.py
similarity index 100%
rename from examples/projections/azim/azim_general_perspective.py
rename to examples/projections/azim/azim-general-perspective.py
diff --git a/examples/projections/azim/azim_general_stereographic.py b/examples/projections/azim/azim-general-stereographic.py
similarity index 100%
rename from examples/projections/azim/azim_general_stereographic.py
rename to examples/projections/azim/azim-general-stereographic.py
diff --git a/examples/projections/azim/azim_gnomonic.py b/examples/projections/azim/azim-gnomonic.py
similarity index 100%
rename from examples/projections/azim/azim_gnomonic.py
rename to examples/projections/azim/azim-gnomonic.py
diff --git a/examples/projections/azim/azim_lambert.py b/examples/projections/azim/azim-lambert.py
similarity index 100%
rename from examples/projections/azim/azim_lambert.py
rename to examples/projections/azim/azim-lambert.py
diff --git a/examples/projections/azim/azim_orthographic.py b/examples/projections/azim/azim-orthographic.py
similarity index 100%
rename from examples/projections/azim/azim_orthographic.py
rename to examples/projections/azim/azim-orthographic.py
diff --git a/examples/projections/conic/conic_albers.py b/examples/projections/conic/conic-albers.py
similarity index 100%
rename from examples/projections/conic/conic_albers.py
rename to examples/projections/conic/conic-albers.py
diff --git a/examples/projections/conic/conic_equidistant.py b/examples/projections/conic/conic-equidistant.py
similarity index 100%
rename from examples/projections/conic/conic_equidistant.py
rename to examples/projections/conic/conic-equidistant.py
diff --git a/examples/projections/conic/conic_lambert.py b/examples/projections/conic/conic-lambert.py
similarity index 100%
rename from examples/projections/conic/conic_lambert.py
rename to examples/projections/conic/conic-lambert.py
diff --git a/examples/projections/cyl/cyl_cassini.py b/examples/projections/cyl/cyl-cassini.py
similarity index 100%
rename from examples/projections/cyl/cyl_cassini.py
rename to examples/projections/cyl/cyl-cassini.py
diff --git a/examples/projections/cyl/cyl_equal_area.py b/examples/projections/cyl/cyl-equal-area.py
similarity index 100%
rename from examples/projections/cyl/cyl_equal_area.py
rename to examples/projections/cyl/cyl-equal-area.py
diff --git a/examples/projections/cyl/cyl_equidistant.py b/examples/projections/cyl/cyl-equidistant.py
similarity index 100%
rename from examples/projections/cyl/cyl_equidistant.py
rename to examples/projections/cyl/cyl-equidistant.py
diff --git a/examples/projections/cyl/cyl_mercator.py b/examples/projections/cyl/cyl-mercator.py
similarity index 100%
rename from examples/projections/cyl/cyl_mercator.py
rename to examples/projections/cyl/cyl-mercator.py
diff --git a/examples/projections/cyl/cyl_miller.py b/examples/projections/cyl/cyl-miller.py
similarity index 100%
rename from examples/projections/cyl/cyl_miller.py
rename to examples/projections/cyl/cyl-miller.py
diff --git a/examples/projections/cyl/cyl_stereographic.py b/examples/projections/cyl/cyl-stereographic.py
similarity index 100%
rename from examples/projections/cyl/cyl_stereographic.py
rename to examples/projections/cyl/cyl-stereographic.py
diff --git a/examples/projections/cyl/cyl_transverse_mercator.py b/examples/projections/cyl/cyl-transverse-mercator.py
similarity index 100%
rename from examples/projections/cyl/cyl_transverse_mercator.py
rename to examples/projections/cyl/cyl-transverse-mercator.py
diff --git a/examples/projections/cyl/cyl_universal_transverse_mercator.py b/examples/projections/cyl/cyl-universal-transverse-mercator.py
similarity index 100%
rename from examples/projections/cyl/cyl_universal_transverse_mercator.py
rename to examples/projections/cyl/cyl-universal-transverse-mercator.py
diff --git a/examples/projections/misc/misc_eckertIV.py b/examples/projections/misc/misc-eckertIV.py
similarity index 100%
rename from examples/projections/misc/misc_eckertIV.py
rename to examples/projections/misc/misc-eckertIV.py
diff --git a/examples/projections/misc/misc_eckertVI.py b/examples/projections/misc/misc-eckertVI.py
similarity index 100%
rename from examples/projections/misc/misc_eckertVI.py
rename to examples/projections/misc/misc-eckertVI.py
diff --git a/examples/projections/misc/misc_hammer.py b/examples/projections/misc/misc-hammer.py
similarity index 100%
rename from examples/projections/misc/misc_hammer.py
rename to examples/projections/misc/misc-hammer.py
diff --git a/examples/projections/misc/misc_mollweide.py b/examples/projections/misc/misc-mollweide.py
similarity index 100%
rename from examples/projections/misc/misc_mollweide.py
rename to examples/projections/misc/misc-mollweide.py
diff --git a/examples/projections/misc/misc_robinson.py b/examples/projections/misc/misc-robinson.py
similarity index 100%
rename from examples/projections/misc/misc_robinson.py
rename to examples/projections/misc/misc-robinson.py
diff --git a/examples/projections/misc/misc_sinusoidal.py b/examples/projections/misc/misc-sinusoidal.py
similarity index 100%
rename from examples/projections/misc/misc_sinusoidal.py
rename to examples/projections/misc/misc-sinusoidal.py
diff --git a/examples/projections/misc/misc_van_der_grinten.py b/examples/projections/misc/misc-van-der-grinten.py
similarity index 100%
rename from examples/projections/misc/misc_van_der_grinten.py
rename to examples/projections/misc/misc-van-der-grinten.py
diff --git a/examples/projections/misc/misc_winkel_tripel.py b/examples/projections/misc/misc-winkel-tripel.py
similarity index 100%
rename from examples/projections/misc/misc_winkel_tripel.py
rename to examples/projections/misc/misc-winkel-tripel.py
diff --git a/examples/projections/nongeo/cartesian_linear.py b/examples/projections/nongeo/cartesian-linear.py
similarity index 100%
rename from examples/projections/nongeo/cartesian_linear.py
rename to examples/projections/nongeo/cartesian-linear.py
diff --git a/examples/projections/nongeo/cartesian_logarithmic.py b/examples/projections/nongeo/cartesian-logarithmic.py
similarity index 100%
rename from examples/projections/nongeo/cartesian_logarithmic.py
rename to examples/projections/nongeo/cartesian-logarithmic.py
diff --git a/examples/projections/nongeo/cartesian_power.py b/examples/projections/nongeo/cartesian-power.py
similarity index 100%
rename from examples/projections/nongeo/cartesian_power.py
rename to examples/projections/nongeo/cartesian-power.py
diff --git a/examples/projections/table/README.txt b/examples/projections/table/README.txt
index e0a821ed9cc..87a51db72f8 100644
--- a/examples/projections/table/README.txt
+++ b/examples/projections/table/README.txt
@@ -19,39 +19,39 @@ The below table shows the projection codes for the 31 GMT projections.
    * - PyGMT Projection Argument
      - Projection Name
    * - **A**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width*
-     - :doc:`Lambert azimuthal equal area </projections/azim/azim_lambert>`
+     - :doc:`Lambert azimuthal equal area </projections/azim/azim-lambert>`
    * - **B**\ |lon0|/|lat0|/|lat1|/|lat2|/\ *width*
-     - :doc:`Albers conic equal area </projections/conic/conic_albers>`
+     - :doc:`Albers conic equal area </projections/conic/conic-albers>`
    * - **C**\ |lon0|/|lat0|/\ *width*
-     - :doc:`Cassini cylindrical </projections/cyl/cyl_cassini>`
+     - :doc:`Cassini cylindrical </projections/cyl/cyl-cassini>`
    * - **Cyl_stere/**\ [|lon0|\ [/|lat0|/]]\ *width*
-     - :doc:`Cylindrical stereographic </projections/cyl/cyl_stereographic>`
+     - :doc:`Cylindrical stereographic </projections/cyl/cyl-stereographic>`
    * - **D**\ |lon0|/|lat0|/|lat1|/|lat2|/\ *width*
-     - :doc:`Equidistant conic </projections/conic/conic_equidistant>`
+     - :doc:`Equidistant conic </projections/conic/conic-equidistant>`
    * - **E**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width*
-     - :doc:`Azimuthal equidistant </projections/azim/azim_equidistant>`
+     - :doc:`Azimuthal equidistant </projections/azim/azim-equidistant>`
    * - **F**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width*
-     - :doc:`Azimuthal gnomonic </projections/azim/azim_gnomonic>`
+     - :doc:`Azimuthal gnomonic </projections/azim/azim-gnomonic>`
    * - **G**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width*
-     - :doc:`Azimuthal orthographic </projections/azim/azim_orthographic>`
+     - :doc:`Azimuthal orthographic </projections/azim/azim-orthographic>`
    * - **G**\ |lon0|/|lat0|/\ *alt*/*azim*/*tilt*/*twist*/*W*/*H*/*width*
-     - :doc:`General perspective </projections/azim/azim_general_perspective>`
+     - :doc:`General perspective </projections/azim/azim-general-perspective>`
    * - **H**\ [|lon0|/]\ *width*
-     - :doc:`Hammer equal area </projections/misc/misc_hammer>`
+     - :doc:`Hammer equal area </projections/misc/misc-hammer>`
    * - **I**\ [|lon0|/]\ *width*
-     - :doc:`Sinusoidal equal area </projections/misc/misc_sinusoidal>`
+     - :doc:`Sinusoidal equal area </projections/misc/misc-sinusoidal>`
    * - **J**\ [|lon0|/]\ *width*
-     - :doc:`Miller cylindrical </projections/cyl/cyl_miller>`
+     - :doc:`Miller cylindrical </projections/cyl/cyl-miller>`
    * - **Kf**\ [|lon0|/]\ *width*
-     - :doc:`Eckert IV equal area </projections/misc/misc_eckertIV>`
+     - :doc:`Eckert IV equal area </projections/misc/misc-eckertIV>`
    * - **Ks**\ [|lon0|/]\ *width*
-     - :doc:`Eckert VI equal area </projections/misc/misc_eckertVI>`
+     - :doc:`Eckert VI equal area </projections/misc/misc-eckertVI>`
    * - **L**\ |lon0|/|lat0|/|lat1|/|lat2|/\ *width*
-     - :doc:`Lambert conic conformal </projections/conic/conic_lambert>`
+     - :doc:`Lambert conic conformal </projections/conic/conic-lambert>`
    * - **M**\ [|lon0|\ [/|lat0|]/]\ *width*
-     - :doc:`Mercator cylindrical </projections/cyl/cyl_mercator>`
+     - :doc:`Mercator cylindrical </projections/cyl/cyl-mercator>`
    * - **N**\ [|lon0|/]\ *width*
-     - :doc:`Robinson </projections/misc/misc_robinson>`
+     - :doc:`Robinson </projections/misc/misc-robinson>`
    * - **Oa**\ |lon0|/|lat0|/\ *azim*/*width*\ [**+v**]
      - Oblique Mercator, 1: origin and azim
    * - **Ob**\ |lon0|/|lat0|/|lon1|/|lat1|/\ *width*\ [**+v**]
@@ -65,25 +65,25 @@ The below table shows the projection codes for the 31 GMT projections.
    * - **Poly**\ [|lon0|\ [/|lat0|]/]\ *width*
      - :doc:`Polyconic </projections/conic/polyconic>`
    * - **Q**\ [|lon0|\ [/|lat0|/]]\ *width*
-     - :doc:`Equidistant cylindrical </projections/cyl/cyl_equidistant>`
+     - :doc:`Equidistant cylindrical </projections/cyl/cyl-equidistant>`
    * - **R**\ [|lon0|/]\ *width*
-     - :doc:`Winkel Tripel </projections/misc/misc_winkel_tripel>`
+     - :doc:`Winkel Tripel </projections/misc/misc-winkel-tripel>`
    * - **S**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width*
      - :doc:`General stereographic
-       </projections/azim/azim_general_stereographic>`
+       </projections/azim/azim-general-stereographic>`
    * - **T**\ [|lon0|\ [/|lat0|]/]\ *width*
-     - :doc:`Transverse Mercator </projections/cyl/cyl_transverse_mercator>`
+     - :doc:`Transverse Mercator </projections/cyl/cyl-transverse-mercator>`
    * - **U**\ *zone*/*width*
      - :doc:`Universal Transverse Mercator (UTM)
-       </projections/cyl/cyl_universal_transverse_mercator>`
+       </projections/cyl/cyl-universal-transverse-mercator>`
    * - **V**\ [|lon0|/]\ *width*
-     - :doc:`Van der Grinten </projections/misc/misc_van_der_grinten>`
+     - :doc:`Van der Grinten </projections/misc/misc-van-der-grinten>`
    * - **W**\ [|lon0|/]\ *width*
-     - :doc:`Mollweide </projections/misc/misc_mollweide>`
+     - :doc:`Mollweide </projections/misc/misc-mollweide>`
    * - **X**\ *width*\ [**l**\|\ **p**\ *exp*\|\ **T**\|\ **t**][/\ *height*\
        [**l**\|\ **p**\ *exp*\|\ **T**\|\ **t**]][**d**]
-     - :doc:`Linear </projections/nongeo/cartesian_linear>`,
-       :doc:`logarithmic </projections/nongeo/cartesian_logarithmic>`,
-       :doc:`power </projections/nongeo/cartesian_power>`, and time
+     - :doc:`Linear </projections/nongeo/cartesian-linear>`,
+       :doc:`logarithmic </projections/nongeo/cartesian-logarithmic>`,
+       :doc:`power </projections/nongeo/cartesian-power>`, and time
    * - **Y**\ |lon0|/|lat0|/\ *width*
-     - :doc:`Cylindrical equal area </projections/cyl/cyl_equal_area>`
+     - :doc:`Cylindrical equal area </projections/cyl/cyl-equal-area>`