From 1cc9a75b29c0e60c52d7791f36a236efc425f74b Mon Sep 17 00:00:00 2001
From: Connor Olding <cloningdonor@gmail.com>
Date: Sat, 31 Jul 2021 16:15:27 -0700
Subject: [PATCH] add comments and dummy docstrings

---
 sh/baks |  1 +
 sh/days |  2 +-
 sh/ea   | 18 +++++++++---------
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/sh/baks b/sh/baks
index 5eea780..bdd4368 100644
--- a/sh/baks
+++ b/sh/baks
@@ -1,4 +1,5 @@
 #!/usr/bin/env sh
+# backup, timestamped
 # YES_ZSH
 # YES_BASH
 # YES_DASH
diff --git a/sh/days b/sh/days
index 577f07e..e11e3dd 100755
--- a/sh/days
+++ b/sh/days
@@ -4,7 +4,7 @@
 # YES_DASH
 
 days() { ### @-
-    ### compute days since a given date.
+    ### compute the number of days since a given date.
     ###
     ### ```
     ### $ days 'January 1 1970'
diff --git a/sh/ea b/sh/ea
index be94d53..fa2f5d2 100644
--- a/sh/ea
+++ b/sh/ea
@@ -8,36 +8,36 @@ _REMOTE_DOMAIN="https://eaguru.guru"
 _REMOTE_DIR="t"
 _REMOTE_AUTH="auth"
 
-eahead() {
+eahead() { ### @-
     curl -s -I "$_REMOTE_DOMAIN/$_REMOTE_DIR/$1"
 }
 
-eaget() {
+eaget() { ### @-
     curl -R "$_REMOTE_DOMAIN/$_REMOTE_DIR/$1" -o "${2:-$1}"
 }
 
-eaput() {
+eaput() { ### @-
     curl -g -n -T "$1" "$_REMOTE_DOMAIN/$_REMOTE_AUTH/"
 }
 
-eamove() {
+eamove() { ### @-
     local src="$_REMOTE_DOMAIN/$_REMOTE_AUTH/$1"
     local dst="$_REMOTE_DOMAIN/$_REMOTE_DIR/$2"
     curl -n -X MOVE -H "Destination: $dst" "$src"
 }
 
-eacopy() {
+eacopy() { ### @-
     local src="$_REMOTE_DOMAIN/$_REMOTE_AUTH/$1"
     local dst="$_REMOTE_DOMAIN/$_REMOTE_DIR/$2"
     curl -n -X COPY -H "Destination: $dst" "$src"
 }
 
-eadelete() {
+eadelete() { ### @-
     curl -n -X DELETE "$_REMOTE_DOMAIN/$_REMOTE_AUTH/$1"
 }
 
-alias eamv=eamove
-alias eacp=eacopy
-alias earm=eadelete
+alias eamv=eamove ### @-
+alias eacp=eacopy ### @-
+alias earm=eadelete ### @-
 
 # TODO: write "ea" interface with subcommands for each action, invoke it.