From b99a66ca366116cd9c41b18ce1de05a21fbef881 Mon Sep 17 00:00:00 2001
From: Egor Tensin <Egor.Tensin@gmail.com>
Date: Tue, 25 Apr 2023 20:41:10 +0200
Subject: ssh: add more comments

---
 %HOME%/.ssh/config | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

(limited to '%HOME%/.ssh/config')

diff --git a/%HOME%/.ssh/config b/%HOME%/.ssh/config
index 892aeb0..238f891 100644
--- a/%HOME%/.ssh/config
+++ b/%HOME%/.ssh/config
@@ -1,34 +1,38 @@
+# Add keys the agent, duh.
 AddKeysToAgent yes
 
-# macOS stuff.
+# macOS stuff, I don't even know.
 IgnoreUnknown UseKeychain
 UseKeychain yes
 
 # Make known_hosts actually readable.
 HashKnownHosts no
+
 # Don't verify localhost, duh.
 NoHostAuthenticationForLocalhost yes
-# Add server keys to known_hosts silently, I never bother to verify them
-# anyway.
+
+# Add server keys to known_hosts silently, I never bother to verify them anyway.
 StrictHostKeyChecking no
-# Actually, scratch that. Don't use known_hosts at all, what is this even for?
-# Kappa implied.
+
+# Actually, scratch that. Don't use known_hosts at all, what is this even for? Kappa implied.
 UserKnownHostsFile /dev/null
 
-# Keep ssh connections alive.
-# Wonder why this isn't default.
+# Keep ssh connections alive. Wonder why this isn't default.
 ServerAliveCountMax 3
 ServerAliveInterval 15
 
-# Exit if port forwarding fails.
-# Again, why is this not a default?
+# Exit if port forwarding fails. Again, why is this not a default?
 ExitOnForwardFailure yes
 
+# Includes must go above Host blocks.
+# Source: https://superuser.com/a/1162392
 Include config_local config_my_hosts
 
+# Defaults for github.com, etc.
 Host github.com bitbucket.org gitlab.com
     User git
 
+# Alternatives for github.com, etc. when port 22 is blocked:
 Host alt-bitbucket
     User git
     Hostname altssh.bitbucket.org
@@ -42,6 +46,7 @@ Host alt-gitlab
     Hostname altssh.gitlab.com
     Port 443
 
+# AUR:
 Host aur.archlinux.org
     User aur
     IdentityFile ~/.ssh/aur
-- 
cgit v1.2.3