From 28e45dc8a24b9a0fa3d050e8b12654c39d796a63 Mon Sep 17 00:00:00 2001
From: Juerd Waalboer <juerd@tnx.nl>
Date: Sun, 12 May 2019 22:41:11 +0200
Subject: [PATCH] Document console font requirement for QR code

---
 README.md               |  2 ++
 plugins/deposit_iban_qr | 17 +++++++++++++++++
 revbank                 |  2 ++
 3 files changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 4880cd5..08ea8f5 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,8 @@ line (space separated), but that's an unintended feature...
 
 Refer to [RevBank::Plugins](https://metacpan.org/pod/RevBank::Plugins) for documentation about writing plugins.
 
+Plugins themselves may have some documentation in the respective plugin files.
+
 # AUTHOR
 
 Juerd Waalboer <#####@juerd.nl>
diff --git a/plugins/deposit_iban_qr b/plugins/deposit_iban_qr
index 884b9ec..71f1e79 100644
--- a/plugins/deposit_iban_qr
+++ b/plugins/deposit_iban_qr
@@ -1,5 +1,22 @@
 #!perl
 
+# Note for Linux console users: this thing assumes UTF-8 support (so make sure
+# you're running under a UTF-8 locale!), but you will also need a font that
+# actually has all of the characters. Most console fonts do not support the
+# half blocks, and will result in a diamond instead.
+#
+# At least on Debian, this one works:
+#
+#   setfont /usr/share/consolefonts/Uni2-VGA14.psf.gz
+#
+# To make this the default, run "dpkg-reconfigure console-setup", and pick:
+# - "UTF-8"
+# - "Combined - Latin; Slavic Cyrillic; Greek"
+# - "VGA"
+# - "8x14"
+# and then reboot
+
+
 use IPC::Open2 qw(open2);
 use List::Util qw(sum);
 
diff --git a/revbank b/revbank
index 7f74de0..134fc65 100755
--- a/revbank
+++ b/revbank
@@ -230,6 +230,8 @@ line (space separated), but that's an unintended feature...
 
 Refer to L<RevBank::Plugins> for documentation about writing plugins.
 
+Plugins themselves may have some documentation in the respective plugin files.
+
 =head1 AUTHOR
 
 Juerd Waalboer <#####@juerd.nl>