FAQ

diff --git a/MANIFEST.in b/MANIFEST.in
index a0ed9cedace9613f6f9597c52b185f0a33e8cf74..23378fba446a770ea333982ae5ffeabcb98ac5a0 100644 (file)
--- 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 (file)
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 b55ce816d73e4a6e1c5e62aef1deabdb95ba0202..4cc132dde386e99bacf5a0b7d0cec64f6caf0c3d 100755 (executable)
--- 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 aa255a53d11047aa1579b593d7062b87dea6f78a..9ad663c2cf3cb47633c7ee8c5e6eb7d35233403e 100644 (file)
--- 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 f1eb2f496a2b7cddacc8e0b4e654108b48e3eb41..dcf53dccc47c76680855811861bcb0821e3a6b31 100644 (file)
--- 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