From f48671403c4ac00bcf4fd54cc763ec64761c075d Mon Sep 17 00:00:00 2001
From: 0x1eef <0x1eef@protonmail.com>
Date: Sat, 14 Sep 2024 07:02:25 -0300
Subject: [PATCH] Revisit CHANGELOG

---
 share/portzap/CHANGELOG | 80 ++++++++++++++++++++++-------------------
 1 file changed, 44 insertions(+), 36 deletions(-)

diff --git a/share/portzap/CHANGELOG b/share/portzap/CHANGELOG
index 8ab4d48..c0ebbe4 100644
--- a/share/portzap/CHANGELOG
+++ b/share/portzap/CHANGELOG
@@ -1,45 +1,40 @@
 # -*- mode: org -*-
 
-* vNEXT
+** vNEXT
 
 **** Log when ~portzap rm~ completes successfully
 Similar to other commands, log when the ~portzap rm~ command
 completes successfully
 
 **** Format log messages with program name
-This change formats log messages written to standard output
+Formats log messages written to standard output
 and standard error with the pattern ~portzap: <message>~
 
 **** Fix typo in ~commands/portzap-setup~
-This change fixes a typo that would throw an error when
-running the ~portzap setup~ command
+Fix a typo that would throw an error when running the
+~portzap setup~ command
 
 **** Replace chmod with -M switch
-This change replaces chmod with the -M switch. The -M switch
-is given to the ~pw useradd~ command in the ~setup-user~
-script
+Replace chmod with the -M switch. The -M switch is given to
+the ~pw useradd~ command in the ~setup-user~ script
 
-* v1.2.0
+**** Format log messages with program name
+Format log messages written to standard output and standard error
+with the pattern ~portzap: <message>~
 
-**** Change default clone url
-After this change, the default clone URL points at
-the GitHub mirror: https://github.com/hardenedbsd/ports
+**** Replace chmod with -M switch
+Replace chmod with the -M switch. The -M switch is given to the
+~pw useradd~ command in the ~setup-user~ script
 
-This change was made because clone and pull operations
-from ~git.hardenedbsd.org~ are not always stable, especially
-with big repositories like the ports collection
-
-The default can be changed through the environment variable
-~$PORTZAP_CLONEURL~, or by modifying the ~origin~ remote
-after a successful clone
+** v1.2.0
 
 **** Fix ~libexec/portzap/scripts/setup-doas~ bug
-This change fixes a bug in ~setup-doas~ that could hang
-the ~portzap setup~ command
+Fix a bug in ~setup-doas~ that could hang the ~portzap setup~
+command
 
 **** Collapse ~libexec/portzap/scripts~
-This change does not try to organize script directories that
-go beyond ~libexec/portzap/scripts~
+Stop trying to organize script directories that go beyond
+~libexec/portzap/scripts~
 
 **** Add ~libexec/portzap/scripts/setup~
 This new directory replaces what was formerly known
@@ -49,41 +44,54 @@ as ~libexec/portzap/setup~
 This new directory replaces what was formerly known
 as ~libexec/portzap/utils~
 
-* v1.1.0
+** v1.1.0
 
-**** Add ~libexec/portzap/utils/get-umask~
+**** Add 'libexec/portzap/utils/get-umask'
 Add a single source of truth for the mask given to umask
 by git and portzap-install
 
 **** Break up ~portzap-install~ into multiple files
-~libexec/portzap/utils/install/~ contains files that cover both
-a fresh install and applying an update
+A new directory (~libexec/portzap/utils/install/~) contains
+files that cover both a fresh install and applying an update
 
 **** Add ~setup/setup-doas~ improvements
 More likely to do what's expected, but blind spots still exist
 
 **** Add ~portzap setup~, ~portzap teardown~
-Replaces and enhances 'setup-portzap'
+Replace and enhance ~setup-portzap~
 
 **** Add ~libexec/portzap/commands/portzap-sh~
-Runs ~/bin/sh~ within ~/home/_portzap/ports~ as the ~_portzap~ user
+A new command that can run ~/bin/sh~ within ~/home/_portzap/src/~
+as the ~_portzap~ user
 
-* v1.0.0
+** v1.0.0
 
-**** Add ~libexec/portzap/setup/setup-user~
-~setup-user~ sets up the ~portzap~ user and environment
+**** Add libexec/portzap/setup/setup-user
+~setup-user~ sets up the portzap user environment
+
+**** Recover from ~git checkout~ failure
+Recover gracefully from failure in portzap-clone
+
+** v0.2.1
+
+**** Fix Makefile
+The mandoc directory wasn't created properly. It only
+became obvious when building the port into a temporary
+staging directory
+
+** v0.2.0
 
 **** Remove git-diff limit
 Remove file rename limit from git-diff
 
-**** Replace ~utils/gitexec~ with ~utils/git/run~
-Communicate with git via ~utils/git/run~
+**** Replace utils/gitexec with utils/git/run
+Communicate with git via utils/git/run
 
-**** Add ~utils/git~
+**** Add utils/git
 A dedicated directory for git-related scripts
 
-**** Remove ~set -x~
+**** Remove "set -x"
 Emit less output
 
 **** Remove scripts
-Remove ~utils/printok~, ~utils/printerr~, ~utils/git-rev~
+Remove utils/printok, utils/printerr, utils/git-rev