From ed5c62dca4e81b385b3490e5f373658d432a1bf5 Mon Sep 17 00:00:00 2001
From: Sergey Matveev <stargrave@stargrave.org>
Date: Fri, 27 Dec 2019 16:17:40 +0300
Subject: [PATCH] FAQ

---
 faq.texi    | 29 +++++++++++++++++++++++++++++
 makedist.sh |  9 +++++++++
 www.texi    |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 faq.texi

diff --git a/faq.texi b/faq.texi
new file mode 100644
index 0000000..a0a9fd2
--- /dev/null
+++ b/faq.texi
@@ -0,0 +1,29 @@
+@node FAQ
+@unnumbered Frequently asked questions
+
+@set ItIsGOSTBaby It is GOST: do you expect serialization unification?
+
+@table @asis
+
+@item My signature is not validated by other implementations. What is wrong?
+
+Try to reverse it (@code{sign[::-1]}).
+Try to swap its halves (@code{sign[len(sign)/2:] + sign[:len(sign)/2]}).
+Try to reverse its swapped halves too.
+
+@value{ItIsGOSTBaby}!
+
+@item My signature is @strong{still} not validated by other implementations!
+
+Try to reverse digest you are signing/verifying (@code{dgst[::-1]}).
+
+@value{ItIsGOSTBaby}!
+
+@item Everything above did not help me. Does PyGOST sucks?
+
+No way! You still have not tried to reverse your binary private key,
+public key and swap its halves.
+
+@value{ItIsGOSTBaby}!
+
+@end table
diff --git a/makedist.sh b/makedist.sh
index 01c100f..ecf32d9 100755
--- a/makedist.sh
+++ b/makedist.sh
@@ -55,6 +55,15 @@ cat > $texi <<EOF
 EOF
 makeinfo --plaintext -o NEWS $texi
 
+cat > $texi <<EOF
+\input texinfo
+@documentencoding UTF-8
+@settitle FAQ
+@include faq.texi
+@bye
+EOF
+makeinfo --plaintext -o NEWS $texi
+
 find . -name .git -type d | xargs rm -fr
 rm -f *.texi www.mk style.css makedist.sh TODO
 
diff --git a/www.texi b/www.texi
index b68b9d2..322ea70 100644
--- a/www.texi
+++ b/www.texi
@@ -62,6 +62,7 @@ mailing list. Announcements also go to this mailing list.
 
 @insertcopying
 
+@include faq.texi
 @include news.texi
 @include install.texi
 
-- 
2.44.0