Merge branch 'master' into symlink-missing

doc/bugs/move_violates_numcopies___40__regression__41__/comment_3_b8b263650c3580763101c741978c81a4._comment

@@ -0,0 +1,8 @@
+[[!comment format=mdwn
+ username="wting"
+ avatar="http://cdn.libravatar.org/avatar/ff65dc4f3eb58490220b89a7984c4d02"
+ subject="comment 3"
+ date="2020-11-13T23:08:26Z"
+ content="""
+Thanks everyone for the quick response and turnaround on this!
+"""]]

doc/git-annex-examinekey.mdwn

@@ -28,7 +28,8 @@ that can be determined purely by looking at the key.
 
   These variables are also available for use in formats: ${key}, ${backend},
   ${bytesize}, ${humansize}, ${keyname}, ${hashdirlower}, ${hashdirmixed},
-  ${mtime} (for the mtime field of a WORM key).
+  ${mtime} (for the mtime field of a WORM key), ${file} (when a filename is
+  provided to examinekey).
 
   Also, '\\n' is a newline, '\\000' is a NULL, etc.
 

doc/news/version_8.20200810.mdwn

@@ -1,25 +0,0 @@
-git-annex 8.20200810 released with [[!toggle text="these changes"]]
-[[!toggleable text="""
-   * Added support for external backend programs. So if you want a hash
-     that git-annex doesn't support, or something stranger, you can write a
-     small program to implement it.
-   * Fix a bug in find --branch in the previous version.
-   * importfeed: Fix reversion that caused some '.' in filenames to be
-     replaced with '\_'
-   * Fix a lock file descriptor leak that could occur when running commands
-     like git-annex add with -J. Bug was introduced as part of a different FD
-     leak fix in version 6.20160318.
-   * Fix a hang when using git-annex with an old openssh 7.2p2, which had
-     some weird inheriting of ssh FDs by sshd. Bug was introduced in
-     git-annex version 7.20200202.7.
-   * move, copy --to: Sped up seeking files by 2x.
-   * drop: Sped up seeking files to drop by 2x, and also some performance
-     improvements to checking numcopies.
-   * Deal with unusual IFS settings in the shell scripts for linux
-     standalone and OSX app.
-     Thanks, Yaroslav Halchenko
-   * Avoid complaining that a file with "is beyond a symbolic link"
-     when the filepath is absolute and the symlink in question is not
-     actually inside the git repository.
-   * Slightly sped up the linux standalone bundle.
-   * Support building with dlist-1.0"""]]

doc/news/version_8.20201116.mdwn

@@ -0,0 +1,15 @@
+git-annex 8.20201116 released with [[!toggle text="these changes"]]
+[[!toggleable text="""
+git-annex (8.20201116) upstream; urgency=medium
+.
+  * move: Fix a regression in the last release that made move --to not
+    honor numcopies settings.
+  * sync --content: Fix a bug where a file that was not preferred content
+    could be transferred to a remote. This happened when the file got deleted
+    after the sync started running.
+  * Warn when adding a annex symlink or pointer file that uses a key that
+    is not known to the repository, to prevent confusion if the user has
+    copied it from some other repository.
+  * examinekey: Added two new format variables: objectpath and objectpointer
+  * examinekey: Added --migrate-to-backend
+"""]]

doc/todo/calckey___91__--path__93___given_a_checksum_and_filename__63__/comment_5_ec644589ec44a442dc2f3bd2244c9800._comment

@@ -0,0 +1,43 @@
+[[!comment format=mdwn
+ username="yarikoptic"
+ avatar="http://cdn.libravatar.org/avatar/f11e9c84cb18d26a1748c33b48c924b4"
+ subject="comment 5"
+ date="2020-11-14T02:00:13Z"
+ content="""
+Woohoo -- thank you Joey!
+
+Here is my complete example which seems to work quite neatly.  One aspect which you might (or not -- shouldn't matter to me but bash people might appreciate): could \"${filename}\" (if provided to examinekey) be passed into `format` as well? that would allow for easy looping like in this example, but on more than one key at a time.
+
+Unrelated, just curious -- what is the best way to \"chain\" multiple batch processes in bash, like here `examinekey` and `registerurl`?
+
+
+```bash
+$> cat ./addurl-uberfast.sh
+#!/bin/bash
+
+export PS4='> '
+set -x
+set -eu
+cd \"$(mktemp -d ${TMPDIR:-/tmp}/dl-XXXXXXX)\"
+
+md5=f92bbc617f8c8714a251f1f208af37a0
+size=6605
+filename=GLwDrawA.h
+url=http://www.onerussian.com/tmp/$filename
+
+git init
+git annex init
+
+echo MD5-s$size--$md5 $filename | \
+ git-annex examinekey --batch --format='${key} ${objectpath}\n' --migrate-to-backend=MD5E | \
+ while read key objectpath; do
+    git-annex registerurl \"$key\" \"$url\"
+    # examinekey does not know ${filename} in its format so such looping isn't exactly
+    # possible easily in bash ATM
+    ln -s \"$objectpath\" \"$filename\"
+    git add \"$filename\"
+    git annex get \"$filename\"
+    git annex drop \"$filename\"
+ done
+```
+"""]]

doc/todo/calckey___91__--path__93___given_a_checksum_and_filename__63__/comment_6_aa8c191593789900e966a37f9117dd97._comment

@@ -0,0 +1,7 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 6"""
+ date="2020-11-16T13:52:12Z"
+ content="""
+Good idea, I added ${file}
+"""]]