From 389c67805d00564226e78b3b489529ef9ba4ca97 Mon Sep 17 00:00:00 2001
From: AJ ONeal <aj@therootcompany.com>
Date: Tue, 24 Oct 2023 05:35:06 +0000
Subject: [PATCH] doc(py*): consistent Files & Install, add libzma-dev

---
 pyenv/README.md   | 21 +++++++++++++++++++--
 python/README.md  | 34 +++++++++++++++++++---------------
 python2/README.md | 33 +++++++++++++++++++--------------
 python3/README.md |  2 +-
 4 files changed, 58 insertions(+), 32 deletions(-)

diff --git a/pyenv/README.md b/pyenv/README.md
index 26dc4f8..36b2c0a 100644
--- a/pyenv/README.md
+++ b/pyenv/README.md
@@ -7,9 +7,25 @@ tagline: |
 
 To update run `pyenv update`.
 
+### Files
+
+These are the files / directories that are created and/or modified with this
+install:
+
+```sh
+~/.config/envman/PATH.env
+~/.pyenv/bin/
+~/.pyenv/shims/
+
+# pyenv also loads shell hooks via
+~/.bashrc
+~/.config/fish/config.fish
+~/.zshrc
+```
+
 ### How to Install pyenv on macOS
 
-Make sure that you already have Xcode tools installed:
+Install Xcode tools first:
 
 ```sh
 xcode-select --install
@@ -25,7 +41,8 @@ sudo apt update
 sudo apt install -y build-essential zlib1g-dev libssl-dev
 
 # recommended
-sudo apt install -y libreadline-dev libbz2-dev libsqlite3-dev libffi-dev
+sudo apt install -y libreadline-dev libsqlite3-dev \
+                    libffi-dev libbz2-dev liblzma-dev
 ```
 
 ## Cheat Sheet
diff --git a/python/README.md b/python/README.md
index cb7cd24..cd775bd 100644
--- a/python/README.md
+++ b/python/README.md
@@ -7,16 +7,30 @@ tagline: |
 
 To update or switch versions, run `pyenv install -v 3` (or `3.10`, etc).
 
+### Files
+
+These are the files / directories that are created and/or modified with this
+install:
+
+```sh
+~/.config/envman/PATH.env
+~/.pyenv/bin/
+~/.pyenv/shims/
+
+# pyenv also loads shell hooks via
+~/.bashrc
+~/.config/fish/config.fish
+~/.zshrc
+```
+
 ### How to Install python3 on macOS
 
-Make sure that you already have Xcode tools installed:
+Install Xcode tools first:
 
 ```sh
 xcode-select --install
 ```
 
-You may also need to install Xcode proper from the App Store.
-
 ### How to Install python3 on Linux
 
 Make sure that you already have the necessary build tools installed:
@@ -27,18 +41,8 @@ sudo apt update
 sudo apt install -y build-essential zlib1g-dev libssl-dev
 
 # recommended
-sudo apt install -y libreadline-dev libbz2-dev libsqlite3-dev
-```
-
-### Files
-
-These are the files / directories that are created and/or modified with this
-install:
-
-```text
-~/.bashrc (or your shell's equivalent)
-~/.config/envman/PATH.env
-~/.pyenv
+sudo apt install -y libreadline-dev libsqlite3-dev \
+                    libffi-dev libbz2-dev liblzma-dev
 ```
 
 ## Cheat Sheet
diff --git a/python2/README.md b/python2/README.md
index 3991396..ab7551e 100644
--- a/python2/README.md
+++ b/python2/README.md
@@ -7,16 +7,30 @@ tagline: |
 
 To update or switch versions, run `pyenv install -v 2` (or `2.6`, etc).
 
+### Files
+
+These are the files / directories that are created and/or modified with this
+install:
+
+```sh
+~/.config/envman/PATH.env
+~/.pyenv/bin/
+~/.pyenv/shims/
+
+# pyenv also loads shell hooks via
+~/.bashrc
+~/.config/fish/config.fish
+~/.zshrc
+```
+
 ### How to Install python2 on macOS
 
-Make sure that you already have Xcode tools installed:
+Install Xcode tools first:
 
 ```sh
 xcode-select --install
 ```
 
-You may also need to install Xcode proper from the App Store.
-
 ### How to Install python2 on Linux
 
 Make sure that you already have the necessary build tools installed:
@@ -27,19 +41,10 @@ sudo apt update
 sudo apt install -y build-essential zlib1g-dev libssl-dev
 
 # recommended
-sudo apt install -y libreadline-dev libbz2-dev libsqlite3-dev
+sudo apt install -y libreadline-dev libsqlite3-dev \
+                    libffi-dev libbz2-dev liblzma-dev
 ```
 
-### Files
-
-These are the files / directories that are created and/or modified with this
-install:
-
-```text
-~/.bashrc (or your shell's equivalent)
-~/.config/envman/PATH.env
-~/.pyenv
-```
 
 ## Cheat Sheet
 
diff --git a/python3/README.md b/python3/README.md
index 3edafe4..470be4e 100644
--- a/python3/README.md
+++ b/python3/README.md
@@ -8,4 +8,4 @@ description: |
   See https://webinstall.dev/python
 ---
 
-Alias for https://webinstall.dev/python
+Alias for [python](../python/).