From 401326471e2d2832727447be15a58197946cf371 Mon Sep 17 00:00:00 2001
From: "John W. O'Brien" <john@saltant.com>
Date: Sat, 8 Jun 2019 18:04:54 -0400
Subject: [PATCH] Modernize docs for FreeBSD installation

---
 docs/installation/index.rst | 19 +++++++++++++++++++
 docs/installation/ios.rst   |  8 --------
 docs/installation/iosxr.rst |  8 --------
 docs/installation/junos.rst |  7 -------
 4 files changed, 19 insertions(+), 23 deletions(-)

diff --git a/docs/installation/index.rst b/docs/installation/index.rst
index e58ae48c3..d1f8f032a 100644
--- a/docs/installation/index.rst
+++ b/docs/installation/index.rst
@@ -14,6 +14,25 @@ You can install napalm with pip:
 That will install all the drivers currently available.
 
 
+OS Package Managers
+-------------------
+
+Some execution environments offer napalm through a system-level package manager. Installing with pip outside of a user profile or virtualenv/venv is inadvisable in these cases.
+
+FreeBSD
+~~~~~~~
+
+.. code-block:: bash
+
+    pkg install net-mgmt/py-napalm
+
+This will install napalm and all drivers and dependencies for the default version(s) of python. To install for a specific version, python X.Y, if supported:
+
+.. code-block:: bash
+
+    pkg install pyXY-napalm
+
+
 Dependencies
 ------------
 
diff --git a/docs/installation/ios.rst b/docs/installation/ios.rst
index 3e5f2ed55..3138bc695 100644
--- a/docs/installation/ios.rst
+++ b/docs/installation/ios.rst
@@ -15,11 +15,3 @@ RedHat and CentOS
 .. code-block:: bash
 
     sudo yum install -y python-pip gcc openssl openssl-devel libffi-devel python-devel
-
-
-FreeBSD
--------
-
-.. code-block:: bash
-
-    sudo pkg_add -r py27-pip
diff --git a/docs/installation/iosxr.rst b/docs/installation/iosxr.rst
index f2fa5b039..fba72c464 100644
--- a/docs/installation/iosxr.rst
+++ b/docs/installation/iosxr.rst
@@ -15,11 +15,3 @@ RedHat and CentOS
 .. code-block:: bash
 
     sudo yum install -y python-pip gcc openssl openssl-devel libffi-devel python-devel
-
-
-FreeBSD
--------
-
-.. code-block:: bash
-
-    sudo pkg_add -r py27-pip
diff --git a/docs/installation/junos.rst b/docs/installation/junos.rst
index 66151bf14..64278380b 100644
--- a/docs/installation/junos.rst
+++ b/docs/installation/junos.rst
@@ -15,10 +15,3 @@ RedHat and CentOS
 .. code-block:: bash
 
     sudo yum install -y python-pip python-devel libxml2-devel libxslt-devel gcc openssl openssl-devel libffi-devel
-
-FreeBSD
--------
-
-.. code-block:: bash
-
-    sudo pkg_add -r py27-pip libxml2 libxslt