summaryrefslogtreecommitdiff
path: root/doc/special_remotes
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2013-12-27 02:56:34 -0400
committerGravatar Joey Hess <joey@kitenet.net>2013-12-27 02:56:52 -0400
commit690c690e97ecc3808755e95acd0d45bfe03ed366 (patch)
treefa68dc564767894834caa7c221062522be66269f /doc/special_remotes
parent8ad91f287cf87b3a5a849d997de35210a0e9f2b7 (diff)
improve comments
Diffstat (limited to 'doc/special_remotes')
-rwxr-xr-xdoc/special_remotes/external/example.sh9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/special_remotes/external/example.sh b/doc/special_remotes/external/example.sh
index c9412c506..c74279e3f 100755
--- a/doc/special_remotes/external/example.sh
+++ b/doc/special_remotes/external/example.sh
@@ -52,9 +52,14 @@ while read line; do
INITREMOTE)
# Do anything necessary to create resources
# used by the remote. Try to be idempotent.
+ #
# Use GETCONFIG to get any needed configuration
# settings, and SETCONFIG to set any persistent
# configuration settings.
+ #
+ # (Note that this is not run every time, only when
+ # git annex initremote or git annex enableremote is
+ # run.)
getconfig directory
mydirectory="$RET"
if [ -z "$mydirectory" ]; then
@@ -91,7 +96,7 @@ while read line; do
RETRIEVE)
# Retrieve from a location based on
# the key, outputting to the file.
- # XXX when easy, send PROGRESS
+ # XXX when easy to do, send PROGRESS
calclocation "$key"
if runcmd cp -v "$LOC" "$file"; then
echo TRANSFER-SUCCESS RETRIEVE "$key"
@@ -110,7 +115,7 @@ while read line; do
if [ -d "$mydirectory" ]; then
echo CHECKPRESENT-FAILURE "$key"
else
- # If the directory does not exist,
+ # When the directory does not exist,
# the remote is not available.
# (A network remote would similarly
# fail with CHECKPRESENT-UNKNOWN