diff --git a/doc/git-annex-add.mdwn b/doc/git-annex-add.mdwn
index 253afd8cc4..7a1ad2c24e 100644
--- a/doc/git-annex-add.mdwn
+++ b/doc/git-annex-add.mdwn
@@ -93,7 +93,7 @@ annexed content, and other symlinks.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--batch`
 
diff --git a/doc/git-annex-addurl.mdwn b/doc/git-annex-addurl.mdwn
index c7294cad69..02864cebc6 100644
--- a/doc/git-annex-addurl.mdwn
+++ b/doc/git-annex-addurl.mdwn
@@ -134,7 +134,7 @@ be used to get better filenames.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--backend`
 
diff --git a/doc/git-annex-copy.mdwn b/doc/git-annex-copy.mdwn
index 0ef70a4503..57905b672c 100644
--- a/doc/git-annex-copy.mdwn
+++ b/doc/git-annex-copy.mdwn
@@ -125,7 +125,7 @@ Paths of files or directories to operate on can be specified.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-drop.mdwn b/doc/git-annex-drop.mdwn
index a92f968e05..aa66696958 100644
--- a/doc/git-annex-drop.mdwn
+++ b/doc/git-annex-drop.mdwn
@@ -131,7 +131,7 @@ Paths of files or directories to drop can be specified.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-dropkey.mdwn b/doc/git-annex-dropkey.mdwn
index fa5088590f..1b0ba61ac2 100644
--- a/doc/git-annex-dropkey.mdwn
+++ b/doc/git-annex-dropkey.mdwn
@@ -32,7 +32,7 @@ exist; using it can easily result in data loss.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-examinekey.mdwn b/doc/git-annex-examinekey.mdwn
index a35f341216..4c3e1b304c 100644
--- a/doc/git-annex-examinekey.mdwn
+++ b/doc/git-annex-examinekey.mdwn
@@ -45,7 +45,7 @@ that can be determined purely by looking at the key.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--migrate-to-backend=backend`
 
diff --git a/doc/git-annex-export.mdwn b/doc/git-annex-export.mdwn
index 98184274ad..738e7fbf3c 100644
--- a/doc/git-annex-export.mdwn
+++ b/doc/git-annex-export.mdwn
@@ -111,7 +111,7 @@ so the overwritten modification is not lost.)
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-find.mdwn b/doc/git-annex-find.mdwn
index c16240d4e7..7a667d4672 100644
--- a/doc/git-annex-find.mdwn
+++ b/doc/git-annex-find.mdwn
@@ -63,7 +63,7 @@ finds files in the current directory and its subdirectories.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--batch`
 
diff --git a/doc/git-annex-findkeys.mdwn b/doc/git-annex-findkeys.mdwn
index 819206e77d..ac1b16d067 100644
--- a/doc/git-annex-findkeys.mdwn
+++ b/doc/git-annex-findkeys.mdwn
@@ -58,7 +58,7 @@ Outputs a list of keys known to git-annex.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-fsck.mdwn b/doc/git-annex-fsck.mdwn
index faa58aaa1c..4083ba4bf1 100644
--- a/doc/git-annex-fsck.mdwn
+++ b/doc/git-annex-fsck.mdwn
@@ -108,7 +108,7 @@ better format.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--quiet`
 
diff --git a/doc/git-annex-get.mdwn b/doc/git-annex-get.mdwn
index 8fe1ab6f3e..208188171f 100644
--- a/doc/git-annex-get.mdwn
+++ b/doc/git-annex-get.mdwn
@@ -135,7 +135,7 @@ be specified.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-import.mdwn b/doc/git-annex-import.mdwn
index 6ed9bec319..8d56d82270 100644
--- a/doc/git-annex-import.mdwn
+++ b/doc/git-annex-import.mdwn
@@ -211,7 +211,7 @@ link, and that symbolic link will be followed.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-info.mdwn b/doc/git-annex-info.mdwn
index a33ec1378a..9a2256b491 100644
--- a/doc/git-annex-info.mdwn
+++ b/doc/git-annex-info.mdwn
@@ -29,7 +29,7 @@ for the local repository and all annexed content.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--bytes`
 
diff --git a/doc/git-annex-lock.mdwn b/doc/git-annex-lock.mdwn
index dd5b25a5c5..3e360db41c 100644
--- a/doc/git-annex-lock.mdwn
+++ b/doc/git-annex-lock.mdwn
@@ -31,7 +31,7 @@ can commit.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-metadata.mdwn b/doc/git-annex-metadata.mdwn
index 1f1877d330..9eb6ebf3aa 100644
--- a/doc/git-annex-metadata.mdwn
+++ b/doc/git-annex-metadata.mdwn
@@ -122,7 +122,7 @@ the modified file.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--batch`
 
diff --git a/doc/git-annex-mirror.mdwn b/doc/git-annex-mirror.mdwn
index 688d0c3f08..3dfb9aa938 100644
--- a/doc/git-annex-mirror.mdwn
+++ b/doc/git-annex-mirror.mdwn
@@ -80,7 +80,7 @@ contents. Use [[git-annex-sync]](1) for that.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-move.mdwn b/doc/git-annex-move.mdwn
index b451412eec..b30163c891 100644
--- a/doc/git-annex-move.mdwn
+++ b/doc/git-annex-move.mdwn
@@ -120,7 +120,7 @@ Paths of files or directories to operate on can be specified.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-registerurl.mdwn b/doc/git-annex-registerurl.mdwn
index a309ae7b0b..753d06b704 100644
--- a/doc/git-annex-registerurl.mdwn
+++ b/doc/git-annex-registerurl.mdwn
@@ -56,7 +56,7 @@ special remote that claims it. (Usually the web special remote.)
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-status.mdwn b/doc/git-annex-status.mdwn
index 3d9a87a532..962fda51d4 100644
--- a/doc/git-annex-status.mdwn
+++ b/doc/git-annex-status.mdwn
@@ -29,7 +29,7 @@ modified (M), added but not committed (A), and type changed/unlocked (T).
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-unlock.mdwn b/doc/git-annex-unlock.mdwn
index 7c2fc94d7f..1a2bd32596 100644
--- a/doc/git-annex-unlock.mdwn
+++ b/doc/git-annex-unlock.mdwn
@@ -58,7 +58,7 @@ repository. So, enable annex.thin with care.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-unregisterurl.mdwn b/doc/git-annex-unregisterurl.mdwn
index c44eb06c28..ab535a73f6 100644
--- a/doc/git-annex-unregisterurl.mdwn
+++ b/doc/git-annex-unregisterurl.mdwn
@@ -47,7 +47,7 @@ for it, because the content may still be present on the remote.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * Also the [[git-annex-common-options]](1) can be used.
 
diff --git a/doc/git-annex-whereis.mdwn b/doc/git-annex-whereis.mdwn
index ffa0647918..84678709f0 100644
--- a/doc/git-annex-whereis.mdwn
+++ b/doc/git-annex-whereis.mdwn
@@ -76,7 +76,7 @@ received from remotes.
 * `--json-error-messages`
 
   Messages that would normally be output to standard error are included in
-  the json instead.
+  the JSON instead.
 
 * `--format=value`