* release directory

 * README

git-svn-id: https://svn.emkael.info/an9k@15 05ec0d5d-773b-4d93-9e23-c81a7ac79feb

6 files changed, 433 insertions, 0 deletions

diff --git a/Analizator9000/Analizator9000/README.pl.txt b/Analizator9000/Analizator9000/README.pl.txt
new file mode 100644
index 0000000..81a996b
--- /dev/null
+++ b/Analizator9000/Analizator9000/README.pl.txt
@@ -0,0 +1,221 @@
+Analizator9000 - README

+

+0. SPIS ZAWARTOŚCI

+==================

+

+    1. Wprowadzenie

+    2. Wymagania systemowe

+    3. Instalacja

+    4. Podręcznik użycia

+    5. Kod źródłowy

+    6. Autorzy

+    7. Wsparcie i informacje kontaktowe

+    8. Historia zmian

+    9. Licencja

+

+1. WPROWADZENIE

+===============

+

+Analizator9000 jest aplikacją oferującą graficzny interfejs użytkownika dla

+analizy statystycznej liczby lew w rozdaniach brydżowych wygenerowanych na

+podstawie określonych warunków.

+

+Program stanowi interfejs dla programu Dealer oraz dla biblioteki libbcalcDDS,

+będącej częścią projektu BCalc. Aby dowiedzieć się więcej o tych programach,

+skieruj się do sekcji "AUTORZY".

+

+2. WYMAGANIA SYSTEMOWE

+======================

+

+Analizator9000 działa w środowisku .NET 3.5 Client Profile i jako taki wymaga

+platformy kompatybilnej ze środowiskiem .NET 3.5.

+

+Wymagania sprzętowe platformy .NET 3.5:

+

+    * system operacyjny Windows XP/Vista/Server 2003/Server 2008/7/8 lub nowszy

+     (systemy Windows 7, Windows Server 2008 R2 oraz Windows 8 i nowsze

+      dostarczają .NET 3.5 wraz z podstawową instalacją systemu)

+    * procesor: równoważny Pentium 400MHz (minimalny); Pentium 1GHz (zalecany)

+    * pamięć RAM: 96MB (minimalna); 256MB (zalecana)

+

+Wymagania specyficzne dla aplikacji:

+

+    * ekran: minimalna rozdzielczość 1024x600px; kolory 16-bit

+    * wolne miejsce na dysku: minimum 500MB (.NET 3.5) + 5MB (Analizator9000)

+    * dodatkowe miejsce na dysku: 1MB na pełną analizę każdego tysiąca rozdań

+

+UWAGA!

+    Aplikacja może potrzebować bardzo dużej ilości zasobów systemowych w

+zależności od rozmiaru wykonywanego zadania. Nieodpowiedzialny dobór parametrów

+generowania rozdań/analizy może doprowadzić do znacząco długiego czasu

+wykonywania programu, zawieszenia jego działania bądź, w przypadkach skrajnych,

+do ograniczenia jakości korzystania z systemu użytkownika. Autor zaleca

+ostrożny dobór parametrów uruchomienia w celu rozpoznania wydajności aplikacji

+i systemu użytkownika.

+

+3. INSTALACJA

+=============

+

+Program jest gotowy do użycia po rozpakowaniu go do dowolnego katalogu na

+lokalnym dysku twardym.

+

+Aktualną wersję programu można pobrać ze strony domowej projektu:

+    http://emkael.info/brydz/an9k/

+

+Program po rozpakowaniu niezbędnie wymaga obecności dwóch katalogów

+(dostarczonych w archiwum):

+

+    * katalogu bin/ - zawierającego programy zewnętrzne używane przez analizator

+      (plik lbcalcdds.dll należący do projektu BCalc, plik wykonywalny

+       dealer.exe, należący do projektu Dealer oraz bibliotekę cygwin1.dll,

+       wymaganą do uruchomienia programu Dealer)

+    * pustego katalogu files/ - do którego zapisywane są wyniki działania

+      programu

+

+4. PODRĘCZNIK UŻYCIA

+====================

+

+Opis użycia programu wraz ze zrzutami ekranu oraz przykładowymi wynikami

+dostępny jest na stronie domowej programu:

+    http://emkael.info/brydz/an9k/manual/

+

+5. KOD ŹRÓDŁOWY

+===============

+

+P: W jakim języku programowania napisany jest Analizator9000?

+O: C#.

+

+P: Czy mogę zobaczyć kod źródłowy programu?

+O: Oczywiście!

+

+P: Skąd mogę go pobrać?

+O: Z repozytorium Subversion dostępnego pod adresem:

+    https://emkael.info/svn/an9k/

+

+P: Dlaczego przy próbie pobrania kodu źródłowego otrzymuję komunikat błędu o

+   nieprawidłowym certyfikacie HTTPS?

+O: Bo jestem skąpym i leniwym bydlakiem, któremu nie chce się wykupić

+   porządnego certyfikatu SSL. Odcisk palca serwera:

+    7c:48:1d:9a:73:d0:e6:2d:36:10:4d:d0:dc:f6:da:96:fb:3a:33:c7

+

+P: Ale czy to nie znaczy, że ktoś może podszyć się pod serwer, na którym

+   znajduje się kod źródłowy, podmienić odcisk palca serwera na własny, a potem

+   podstawić mi złośliwy kod źródłowy, który skompiluję, uruchomię, a mój

+   komputer ukradnie mi dane moich wszystkich kart kredytowych, nakupi mnóstwo

+   śmieci na Allegro, a potem wybuchnie, kiedy będę potrzebować pilnie

+   wydrukować zeznanie podatkowe?

+O: Dokładnie tak. Co więcej, ninejszy dokument dystrybuowany jest za

+   pośrednictwem nieuwietrzytelnionego połączenie HTTP, więc nic nie stoi na

+   przeszkodzie, że już się stało, a to pytanie jest tu tylko dla niepoznaki.

+

+P: W jakim środowisku powstał program?

+O: Microsoft Visual Studio/Visual C# 2010.

+

+P: Czy mogę prosić o dopisanie kodu dla funkcjonalności X?

+O: Proście, a będzie Wam dane.

+

+P: Dopisałem do kodu funkcjonalność X. Czy możesz dołączyć ją do swojej edycji

+   programu?

+O: Jeśli jest sensowna i będę w stanie zrozumieć jej kod źródłowy bez

+   konieczności uciekania się do napojów alkoholowych powyżej 8% zawartości,

+   oczywiście.

+

+6. AUTORZY

+==========

+

+Analizator9000:

+    Michał Klichowicz (mkl/emkael)

+    WWW: http://emkael.info

+    e-mail: emkael@tlen.pl

+

+Dealer:

+    Obecny zarządca kodu: Henk Uijterwaal

+    WWW: http://henku.home.xs4all.nl/html/dealer/authors.html

+

+Bridge Calculator (bcalc):

+    Piotr Beling

+    WWW: http://bcalc.w8.pl/

+

+Ikona programu:

+    Tonev

+    WWW: http://www.iconarchive.com/show/windows-7-icons-by-tonev.html

+

+7. WSPARCIE I INFORMACJE KONTAKTOWE

+===================================

+

+Zgłoszenia błędów, sugestie usprawnień oraz wszelkie komentarze natury ogólnej

+należy kierować bezpośrednio do autora, drogą elektroniczną.

+Najłatwiej skontaktować się z autorem poprzez pocztę elektroniczną:

+    emkael@tlen.pl

+Można również odwiedzić ForumBridge.pl i podrzucić prywatną wiadomość

+użytkownikowi mkl:

+    http://www.forumbridge.pl/private.php?do=newpm&u=360

+bądź odnaleźć na Forum odpowiedni wątek i dodać w nim wiadomość.

+

+Zgłaszane błędy będą badane oraz poprawiane w miarę możliwości autora, przy

+czym oczekuje się, że wraz ze zgłoszeniem błędu użytkownik będzie w stanie

+dostarczyć podstawowych informacji służących do odtworzenia błędu bądź będzie

+dysponować wystarczającymi umiejętnościami z zakresu ogólnej obsługi komputera,

+by te informacje zebrać na prośbę autora.

+

+Autor zastrzega sobie prawo do traktowania propozycji ulepszeń oraz zmian

+funkcjonalnych z dowolnie dobraną dozą sceptycyzmu.

+

+Jeśli znajdujesz mój program użytecznym, i chciałbyś mi za niego podziękować,

+możesz napisać do mnie maila i dać mi znać, że Ci się spodobał.

+Jeśli chciałbyś go przerobić, użyć jako część większego projektu lub

+zaproponować jakiekolwiek inne jego zastosowanie poza hobbystycznymi analizami,

+również napisz do mnie maila, zobaczymy, co się da zrobić.

+Jeśli za pomocą mojego programu odkryłeś jakieś ciekawe wyniki bądź doszedłeś

+do zaskakujących wniosków, tym bardziej napisz maila.

+Jeśli nie jesteś pewien, czy napisać do mnie w jakiejś sprawie związanej z

+programem, napisz maila. Lubię czytać maile.

+

+Jeśli znajdujesz mój program na tyle użytecznym, żeby chcieć podziękować mi za

+niego materialnie, masz pecha. Nie przyjmuję dotacji pieniężnych, a program

+jest w pełni darmowy i niekomercyjny. Lubię za to również interesujące książki

+i dobre piwo.

+

+8. HISTORIA ZMIAN

+=================

+

+2012.11 - 0.9

+    * pierwotna wersja programu

+

+9. LICENCJA

+===========

+

+Licencja BSD (dwuklauzulowa)

+

+Copyright (c) 2012, Michał Klichowicz

+Wszystkie prawa zastrzeżone

+

+Redystrybucja i używanie, czy to w formie kodu źródłowego, czy w formie kodu

+wykonywalnego, jest dozwolone pod warunkiem spełnienia poniższych warunków:

+

+    * Redystrybucja kodu źródłowego musi zawierać powyższą notę o prawach

+    autorskich, niniejszą listę warunków oraz poniższe oświadczenie o wyłączeniu

+    odpowiedzialności.

+

+    * Redystrybucja kodu wykonywalnego musi zawierać powyższą notę o prawach

+    autorskich, niniejszą listę warunków oraz poniższe oświadczenie o wyłączeniu

+    odpowiedzialności w dokumentacji i/lub w innych materiałach dostarczanych

+    wraz z kopią oprogramowania.

+

+TO OPROGRAMOWANIE JEST DOSTARCZONE PRZEZ MICHAŁA KLICHOWICZA "TAKIM, JAKIE

+JEST". KAŻDA DOROZUMIANA LUB BEZPOŚREDNIO WYRAŻONA GWARANCJA, NIE WYŁĄCZAJĄC

+DOROZUMIANEJ GWARANCJI PRZYDATNOŚCI HANDLOWEJ I PRZYDATNOŚCI DO OKREŚLONEGO

+ZASTOSOWANIA, JEST WYŁĄCZONA. W ŻADNYM WYPADKU POSIADACZE PRAW AUTORSKICH NIE

+MOGĄ BYĆ ODPOWIEDZIALNI ZA JAKIEKOLWIEK BEZPOŚREDNIE, POŚREDNIE, PRZYPADKOWE,

+SPECJALNE, UBOCZNE I WTÓRNE SZKODY (NIE WYŁĄCZAJĄC OBOWIĄZKU DOSTARCZENIA

+PRODUKTU ZASTĘPCZEGO LUB SERWISU, ODPOWIEDZIALNOŚCI Z TYTUŁU UTRATY

+UŻYTECZNOŚCI, UTRATY DANYCH LUB KORZYŚCI, A TAKŻE PRZERW W PRACY

+PRZEDSIĘBIORSTWA), SPOWODOWANE W JAKIKOLWIEK SPOSÓB, I W JAKIMKOLWIEK MODELU

+ODPOWIEDZIALNOŚCI, KONTRAKTOWEJ, CAŁKOWITEJ LUB DELIKTOWEJ (WYNIKŁEJ ZARÓWNO Z

+NIEDBALSTWA JAK INNYCH POSTACI WINY), POWSTAŁE W JAKIKOLWIEK SPOSÓB W WYNIKU

+UŻYWANIA LUB MAJĄCE ZWIĄZEK Z UŻYWANIEM OPROGRAMOWANIA, NAWET JEŚLI O MOŻLIWOŚCI

+POWSTANIA TAKICH SZKÓD OSTRZEŻONO.

+

+===

+

+Who needs patience anymore, when all our pleasure's virtual?
\ No newline at end of file
diff --git a/Analizator9000/Analizator9000/README.txt b/Analizator9000/Analizator9000/README.txt
new file mode 100644
index 0000000..a198432
--- /dev/null
+++ b/Analizator9000/Analizator9000/README.txt
@@ -0,0 +1,212 @@
+Analizator9000 - README

+

+0. TABLE OF CONTENTS

+====================

+

+    1. Introduction

+    2. System requirements

+    3. Installation

+    4. User manual

+    5. Source code

+    6. Authors

+    7. Support and contact information

+    8. Changes history

+    9. License

+

+1. INTRODUCTION

+===============

+

+Analizator9000 is an application which offers a graphical user interface for

+statistical analysis of the number of tricks to be taken in a bridge deal

+generated upon certain conditions.

+

+The software constitutes an interface for Dealer software and part of BCalc

+project: libbcalcDDS library. To find out more on these projects, please refer

+to the "AUTHORS" section.

+

+2. SYSTEM REQUIREMENTS

+======================

+

+Analizator9000 works within the .NET 3.5 Client Profile environment and as that

+it requires a platfrom compatible with the .NET 3.5 framework.

+

+.NET 3.5 system requirements:

+

+    * operating system: Windows XP/Vista/Server 2003/Server 2008/7/8 or newer

+     (Windows 7, Windows Server 2008 R2 and Windows 8 or newer

+      already provide .NET 3.5 with basic system installation)

+    * CPU: equivalence of Pentium 400MHz (minimum); Pentium 1GHz (recommended)

+    * memory: 96MB (minimmum); 256MB (recommended)

+

+Application-specific reqirements:

+

+    * disaply: minumum resolution of 1024x600px; 16-bit colour

+    * free disk space: a minimum of 500MB (.NET 3.5) + 5MB (Analizator9000)

+    * additional free space: 1MB for full analysis per every thousand deals

+

+WARNING!

+    Using this application may require a substantial amount of resources

+depending on the size of the commissioned task. Irresponsible runtime parameter

+choice for deal generating/analysis may lead to recognizably long execution

+time, to the limitation of application responding time or even to the limitation

+of user's operating system usage experience. The author recommends a careful

+choice of runtime parameters to ensure the recognition of application and system

+performance capabilities.

+

+3. INSTALATION

+==============

+

+The application is ready to use after unpacking it into a user's disk directory

+of choice.

+

+The current version of the application is available from the project's homepage:

+    http://emkael.info/brydz/an9k/

+

+After extraction, the software requires the existence of two directorys within

+its working directory (provided within the archive):

+

+    * bin/ directory - containing external software used by the analyzer

+      (lbcalcdds.dll file from the BCalc project, dealer.exe executable file

+       from project Dealer and cygwin1.dll library, required by Dealer)

+    * empty files/ directory - necessary for collecting application's output

+      files

+

+4. USER MANUAL

+==============

+

+The description of usage, along with screenshots and examples, is available from

+the project's homepage:

+    http://emkael.info/brydz/an9k/manual/

+

+5. SOURCE CODE

+==============

+

+Q: In which programming language is Analizator9000 written?

+A: C#.

+

+Q: Can I see the source code?

+A: Surely!

+

+Q: Where can I acquire it?

+A: From the Subversion repository available at:

+    https://emkael.info/svn/an9k/

+

+Q: Why do I keep getting the HTTPS certificate error while trying to retreive

+   the code?

+A: Because I'm a cheap and lazy bastard and don't want to buy a proper SSL

+   certificate. Here's the server's fingerprint:

+    7c:48:1d:9a:73:d0:e6:2d:36:10:4d:d0:dc:f6:da:96:fb:3a:33:c7

+

+Q: But doesn't that mean that someone is able to spoof the source code server,

+   alter the fingerprint you've just provided with his own, and then substitute

+   the source code with his malicious one, which I'll later compile, run and my

+   computer will steal all my credit card's data, buys a lot of garbage on eBay

+   and explode in the exact moment I'll need it the most to print out my tax

+   form?

+A: It does. What's more, this document is distributed through an unauthenticated

+   HTTP connection, so there's nothing stopping it from having already happened

+   and this question is just a decoy.

+

+Q: What's the environment you've used to create this software?

+A: Microsoft Visual Studio/Visual C# 2010.

+

+Q: Can I ask you to write feature X into your software?

+A: And I tell you, ask, and it will be given to you.

+

+P: I've written feature X into your source code. Can you add it to the your

+   release.

+O: If it's sensible and I can comprehend its entire codebase without resorting

+   to alcoholic beverages stronger than 16-proof (US), I can't see why not.

+

+6. AUTHORS

+==========

+

+Analizator9000:

+    Michał Klichowicz (mkl/emkael)

+    WWW: http://emkael.info

+    e-mail: emkael@tlen.pl

+

+Dealer:

+    Current code maintainer: Henk Uijterwaal

+    WWW: http://henku.home.xs4all.nl/html/dealer/authors.html

+

+Bridge Calculator (bcalc):

+    Piotr Beling

+    WWW: http://bcalc.w8.pl/

+

+Application icon:

+    Tonev

+    WWW: http://www.iconarchive.com/show/windows-7-icons-by-tonev.html

+

+7. SUPPORT AND CONTACT INFORMATION

+==================================

+

+Bug reports, feature suggestions and all other general comments should be

+addressed directly to the author, via electrionic means.

+The easiest way to communicate with the author is his e-mail inbox:

+    emkael@tlen.pl

+You can also visit ForumBridge.pl and drop a private message to the user mkl:

+    http://www.forumbridge.pl/private.php?do=newpm&u=360

+or find an appropriate thread and leave an entry in it.

+

+All reported bugs will be investigated and attempted to fix if only the author

+will find some capabilities to do so. It's expected from the user to be able to

+provide basic information on how to reproduce the error with a bug report or to

+have a sufficient overall computer skills to be able to collect those at the

+author's prompt and with his guidance.

+

+The author reserves the right to approach feature requests with any amount of

+scepticism the author finds appropriate.

+

+If you find my software useful and would like to thank me for it, write me an

+e-mail and let me know you've liked it.

+If you'd like to alter it, incorporate into a bigger project or propose a use

+for it any other than purely recreational analysis, feel from to do so, just let

+me know.

+If you need my help with that, let me know, we'll see what we can do.

+If you achieved some interesting results or curious conclusions with my

+software, feel free to let me know about them.

+If you're unsure whether you should write to me in a matter even slightly

+related to my software, write me an e-mail. I like e-mails.

+

+If you find my software useful enough to want to thank me in a material way,

+you're in a bad luck. I don't take donations, and this software is fully free

+and non-commercial. I do like a decent book and a good beer, though.

+

+8. CHANGES HISTORY

+==================

+

+2012.11 - 0.9

+    * initial version

+

+9. LICENSE

+==========

+

+The 2-clause BSD License

+

+Copyright (c) 2012, Michał Klichowicz

+All right reserved

+

+Redistribution and use in source and binary forms, with or without modification,

+are permitted provided that the following conditions are met:

+

+    * Redistributions of source code must retain the above copyright notice,

+      this list of conditions and the following disclaimer.

+    * Redistributions in binary form must reproduce the above copyright notice,

+      this list of conditions and the following disclaimer in the documentation

+      and/or other materials provided with the distribution.

+

+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR

+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+

+===

+

+Who needs patience anymore, when all our pleasure's virtual?
\ No newline at end of file
diff --git a/Analizator9000/Analizator9000/bin/Release/Analizator9000.exe b/Analizator9000/Analizator9000/bin/Release/Analizator9000.exe
new file mode 100644
index 0000000..ccbef28
--- /dev/null
+++ b/Analizator9000/Analizator9000/bin/Release/Analizator9000.exe
diff --git a/Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll b/Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll
new file mode 100644
index 0000000..71cde86
--- /dev/null
+++ b/Analizator9000/Analizator9000/bin/Release/bin/cygwin1.dll
diff --git a/Analizator9000/Analizator9000/bin/Release/bin/dealer.exe b/Analizator9000/Analizator9000/bin/Release/bin/dealer.exe
new file mode 100644
index 0000000..cb50b88
--- /dev/null
+++ b/Analizator9000/Analizator9000/bin/Release/bin/dealer.exe
diff --git a/Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll b/Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll
new file mode 100644
index 0000000..977fdde
--- /dev/null
+++ b/Analizator9000/Analizator9000/bin/Release/bin/libbcalcdds.dll