diff --git a/config/config.sample.php b/config/config.sample.php
index ac15d9f5aebf0..ff494592f4d3f 100644
--- a/config/config.sample.php
+++ b/config/config.sample.php
@@ -120,7 +120,8 @@
  * Your host server name, for example ``localhost``, ``hostname``,
  * ``hostname.example.com``, or the IP address.
  * To specify a port use ``hostname:####``, for IPv6 addresses use the URI notation ``[ip]:port``.
- * To specify a Unix socket use ``/path/to/directory/containing/socket``, e.g. ``/run/postgresql/``.
+ * To specify a Unix socket use ``localhost:/path/to/directory/containing/socket`` or
+ * ``:/path/to/directory/containing/socket``, e.g. ``localhost:/run/postgresql/``.
  */
 'dbhost' => '',