From 534f20143a668b556a6d328ea8227ee7e7e7c59e Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <14363975+scottshambaugh@users.noreply.github.com>
Date: Wed, 10 Aug 2022 11:36:20 -0600
Subject: [PATCH] view_init docstring for primary view angles

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index e47029539352..5db0dade2d71 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -738,6 +738,21 @@ def view_init(self, elev=None, azim=None, roll=None, vertical_axis="z"):
 
         This can be used to rotate the axes programmatically.
 
+        To look normal to the primary planes, the following elevation and
+        azimuth angles can be used. A roll angle of 0, 90, 180, or 270 deg
+        will rotate these views while keeping the axes at right angles.
+
+        ==========   ====  ====
+        view plane   elev  azim
+        ==========   ====  ====
+        XY           90    -90
+        XZ           0     -90
+        YZ           0     0
+        -XY          -90   90
+        -XZ          0     90
+        -YZ          0     180
+        ==========   ====  ====
+
         Parameters
         ----------
         elev : float, default: None