From a8d0e6701fc55285805998f3caff109d8d4a0990 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20Kohlschu=CC=88tter?=
 <christian@kohlschutter.com>
Date: Fri, 14 Oct 2022 13:01:58 +0200
Subject: [PATCH] site: dependency: Add warning about escaping factory class
 names

---
 src/site/markdown/dependency.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/site/markdown/dependency.md b/src/site/markdown/dependency.md
index 9b914de1f..cf431a2a5 100644
--- a/src/site/markdown/dependency.md
+++ b/src/site/markdown/dependency.md
@@ -210,6 +210,11 @@ have).
 There are currently three distinct ways (socket factories) how to configure the connection to your
 database:
 
+> *NOTE* When specifying these class names from the command line, you may need to put them in single
+quotes (or escape the `$` sign), otherwise your shell may erroneously interpret `$FactoryArg` etc.
+as a variable and fail with `java.lang.ClassNotFoundException:
+org.newsclub.net.unix.AFUNIXSocketFactory`
+
  1. **org.newsclub.net.unix.AFUNIXSocketFactory$FactoryArg**
  
     You provide the socket path via the `socketFactoryArg` JDBC property.