diff --git a/srcpkgs/uim/files/README.voidlinux b/srcpkgs/uim/files/README.voidlinux
new file mode 100644
index 00000000000..69f9beaf055
--- /dev/null
+++ b/srcpkgs/uim/files/README.voidlinux
@@ -0,0 +1,11 @@
+With the switch of Anthy's upstream to Debian, Anthy switched to
+utf-8 backend. However, it still supports EUC-JP encoding.
+Anthy-utf8 backend needs to be used, though.
+
+Quote from: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=953616
+
+> If you have customized enabled-im-list on "stretch" system (in
+> ~/.uim.d/customs/custom-global.scm) with uim-pref-gtk or other tools,
+> uim sticks to use anthy instead of anthy-utf8 and fails kanji-conversion.
+
+If you have said customization, please remove them.
diff --git a/srcpkgs/uim/template b/srcpkgs/uim/template
index 12df0eddb06..1a782b680f7 100644
--- a/srcpkgs/uim/template
+++ b/srcpkgs/uim/template
@@ -1,7 +1,7 @@
 # Template file for 'uim'
 pkgname=uim
 version=1.8.8
-revision=4
+revision=5
 build_style=gnu-configure
 build_helper=qmake
 configure_args="--enable-pref --enable-fep --with-gtk2 --with-gtk3
@@ -65,6 +65,7 @@ uim-anthy_package() {
 		vmove "usr/lib/uim/plugin/libuim-anthy*.so"
 		vmove "usr/share/uim/anthy*.scm"
 		vmove "usr/share/uim/pixmaps/anthy*.png"
+		vdoc "${FILESDIR}/README.voidlinux"
 	}
 }