Merge branch 'release/v8.26.0'v8.26.0

* release/v8.26.0:
  Update PGP key
  Update dotfiles(7) manual page
  Reformat paragraphs in README.md
  Remove outdated description of GnuPG config gen
  Update documentation of personal mail paths
  Add comment to installation dry run command
  Suggest creation of recommended path in docs
  Update recommended path in documentation
  Remove trailing slashes from default XDG basedir
  Use a dash rather than a three-period ellipsis

1 files changed, 17 insertions, 23 deletions

diff --git a/man/man7/dotfiles.7df b/man/man7/dotfiles.7df
index 3e70c142..dd4c2286 100644
--- a/man/man7/dotfiles.7df
+++ b/man/man7/dotfiles.7df
@@ -15,12 +15,13 @@ have been added, making it into a personal suite of custom Unix tools.
 .IP
 .nf
 \f[C]
-$\ git\ clone\ https://sanctum.geek.nz/code/dotfiles.git\ ~/.dotfiles
-$\ cd\ ~/.dotfiles
+$\ mkdir\ \-p\ ~/.local/share
+$\ git\ clone\ https://sanctum.geek.nz/code/dotfiles.git\ ~/.local/share/dotfiles
+$\ cd\ ~/.local/share/dotfiles
 $\ git\ submodule\ init
 $\ git\ submodule\ update
 $\ make
-$\ make\ \-n\ install
+$\ make\ \-n\ install\ \ #\ Check\ output\ carefully
 $\ make\ install
 \f[]
 .fi
@@ -78,18 +79,18 @@ directory to see a list.
 .PP
 To save a set of \f[C]make\f[] targets useful for a specific user or
 host, you can save them in a newline\-separated file
-\f[C]~/.dotfiles.conf\f[], and install using that with the special
-\f[C]install\-conf\f[] target.
+\f[C]~/.local/share/dotfiles.conf\f[], and install using that with the
+special \f[C]install\-conf\f[] target.
 This can include variable settings, too:
 .IP
 .nf
 \f[C]
 $\ cd
-$\ cat\ .dotfiles.conf
+$\ cat\ .local/share/dotfiles.conf
 install\-bash
 install\-bin
 EMAIL=you\@example.com
-$\ make\ \-C\ .dotfiles\ install\-conf
+$\ make\ \-C\ .local/share/dotfiles\ install\-conf
 \f[]
 .fi
 .SS Tools
@@ -174,7 +175,7 @@ Vim (https://www.vim.org/) \[en] Vi IMproved, a text editor
 X11 (https://www.x.org/wiki/) \[en] Windowing system with network
 transparency for Unix
 .PP
-The configurations for shells, GnuPG, Mutt, tmux, and Vim are the most
+The configurations for shells, Mutt, tmux, and Vim are the most
 expansive, and most likely to be of interest.
 The i3 configuration is mostly changed to make window switching behave
 like Vim windows and tmux panes do, and there's a fair few resources
@@ -230,16 +231,16 @@ A terminal session with my prompt looks something like this:
 .nf
 \f[C]
 ~$\ ssh\ remote
-remote:~$\ cd\ .dotfiles
-remote:~/.dotfiles(master+!)$\ git\ status
+remote:~$\ cd\ .local/share/dotfiles
+remote:~/.local/share/dotfiles(master+!)$\ git\ status
 \ M\ README.md
 M\ \ bash/bashrc.d/prompt.bash
 A\ \ init
-remote:~/.dotfiles(master+!)$\ foobar
+remote:~/.local/share/dotfiles(master+!)$\ foobar
 foobar:\ command\ not\ found
-remote:~/.dotfiles(master+!)<127>$\ sleep\ 5\ &
+remote:~/.local/share/dotfiles(master+!)<127>$\ sleep\ 5\ &
 [1]\ 28937
-remote:~/.dotfiles(master+!){1}$
+remote:~/.local/share/dotfiles(master+!){1}$
 \f[]
 .fi
 .PP
@@ -431,18 +432,11 @@ All shells in this family default to a yellow prompt if detected.
 These are experimental; I do not like Z shell much at the moment.
 The files started as a joke (\f[C]exec\ bash\f[]).
 \f[C]zsh\f[] shells default to having a prompt colored cyan.
-.SS GnuPG
-.PP
-The configuration for GnuPG is intended to follow RiseUp's OpenPGP best
-practices (https://riseup.net/en/security/message-security/openpgp/best-practices).
-The configuration file is rebuilt using \f[C]mi5(1df)\f[] and
-\f[C]make(1)\f[] because it requires hard\-coding a path to the SKS
-keyserver certificate authority, and neither tilde nor \f[C]$HOME\f[]
-expansion works for this.
 .SS Mutt
 .PP
-My mail is kept in individual Maildirs under \f[C]~/Mail\f[], with
-\f[C]inbox\f[] being where most unfiltered mail is sent.
+My mail is kept in individual Maildirs under \f[C]~/mail\f[], with the
+system mail spool in e.g.
+\f[C]/var/mail/tejr\f[] being where most unfiltered mail is sent.
 I use Getmail (http://pyropus.ca/software/getmail/),
 maildrop (https://www.courier-mta.org/maildrop/), and
 msmtp (https://marlam.de/msmtp/); the configurations for these are not