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

---
 MANIFEST.in |  1 +
 faq.texi    | 29 +++++++++++++++++++++++++++++
 maketxts.sh |  9 +++++++++
 setup.py    |  1 +
 www.texi    |  1 +
 5 files changed, 41 insertions(+)
 create mode 100644 faq.texi

diff --git a/MANIFEST.in b/MANIFEST.in
index a0ed9ce..23378fb 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,5 +1,6 @@
 include AUTHORS
 include COPYING
+include FAQ
 include INSTALL
 include NEWS
 include README
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/maketxts.sh b/maketxts.sh
index b55ce81..4cc132d 100755
--- a/maketxts.sh
+++ b/maketxts.sh
@@ -29,6 +29,15 @@ cat > $texi <<EOF
 EOF
 makeinfo --plaintext -o INSTALL $texi
 
+cat > $texi <<EOF
+\input texinfo
+@documentencoding UTF-8
+@settitle FAQ
+@include faq.texi
+@bye
+EOF
+makeinfo --plaintext -o FAQ $texi
+
 rm -f $texi
 
 git checkout download.texi install.texi
diff --git a/setup.py b/setup.py
index aa255a5..9ad663c 100644
--- a/setup.py
+++ b/setup.py
@@ -30,6 +30,7 @@ setup(
         ('', (
             "AUTHORS",
             "COPYING",
+            "FAQ",
             "INSTALL",
             "NEWS",
             "README",
diff --git a/www.texi b/www.texi
index f1eb2f4..dcf53dc 100644
--- a/www.texi
+++ b/www.texi
@@ -88,6 +88,7 @@ mailing list. Announcements also go to this mailing list.
 
 @insertcopying
 
+@include faq.texi
 @include news.texi
 @include install.texi
 
-- 
2.44.0