     --------------------------------------------------------
            README for SmartBridge Version 1.1
		     8th February 1998           
     --------------------------------------------------------
	       
SMARTBRIDGE - A new bridge program for Win95/3.1.

This document contains only a brief description of the product and its features, along with instructions for its installation. Quite detailed documentation is included in the archive, and can be read after installation.


--------
CONTENTS
--------

INTRODUCTION
INSTALLATION
HARDWARE/SOFTWARE REQUIREMENTS
SHAREWARE vs. REGISTERED VERSION
LIST OF SMARTBRIDGE NEEDED FILES
WHAT'S NEW
SOME TIPS
REGISTRATION and PAYMENT TERMS

----------


INTRODUCTION
============

SmartBridge is a new bridge program for Windows95 and Windows 3.1.
I tried to make a tool to learn bridge easily and with fun. I'm not a bridge expert, therefore I was the first pupil of myself. Actually I couldn't memorize all the conventions and playing strategies (even though I was able to program them, with help from books). Now, playing (and debugging !) I learnt something. I hope that program users will learn as well. Program gives hints, warns when bid is not the recommended one, and plays automatically, when requested.

SmartBridge allows to play complete bridge rubbers, and tournments (duplicate). Duplicate is very instructive, since you bid and play, then the computer does the same, compares the results and gives you a score.
 
Bid is based on natural system (openings, overcalls, pre-empt bids, takeout doubles and penalty doubles, conventions among the most useful ones).

The Play of the hand allows the computer to play a good defense, and to reach most of the contracts.

The random hand dealer is probably the most amusing tool. It is very flexible: you can force the deal of balanced, unbalanced hands, hands with either singleton or void, fit and misfit, many or few high card points and so on. You can play hundreds of slams!
 
It is also possible to create own hands, both by Editor, and by modification of randomly generated hands. It is possible to use the File System to save/recall noteworthy hands. Hands can be printed with standard diagrams.

If you are a bridge expert, and want to analyze difficult deals, I developed an interface between SmartBridge and GIB, which is quite a good playing program. It can be run trasparently.




INSTALLATION
============

The program is packaged as a SMARTBRI.ZIP archive, containing:
- README.TXT (this file)
- FILE_ID.DIZ (short description)
- EXTRACT.EX_ (compressed self-extracting archive)
- SETUP.EXE (setup program)

Run SETUP.EXE. You will be asked to enter a folder to install from (e.g. A:\ if you install from floppy disk, otherwise the folder where you unzipped the downloaded archive), and a folder to install to (default is C:\SMBRIDGE).

Please note that:

1. All the needed programs are expanded in the SmartBridge directory, nothing is written outside ! (I don't want to risk crippling other applications)

2. So, you don't need an unistall function: simply delete the directory when tired of the program (sniff !)

3. If you want to save 200 KB disk space (but is it really so precious ?) you can delete (but first try to rename only !) the Visual Basic files you already have in \Windows\System (PICCLIP.VBX, CMDIALOG.VBX, MCI.VBX, THREED.VBX, COMMDLG.DLL)

4. You NEED   VBRUN300.DLL.   I don't distribute it. It is normally present in the Windows directory. If not, you can download it from the Web. For instance: <http://www.winsite.com/info/pc/win3/util/vbrun330.zip>
<http://babeard.simplenet.com/vbrun300.zip>

5. If you want to use GIB, you have to download it from the Web, <http://www.cirl.uoregon.edu/gib/>, and copy it to the SmartBridge directory.  


Should the setup program fail (I hope not), you can install manually:

- make a directory (e.g. C:\SMBRIDGE)
- copy all the unzipped files in that directory
- rename EXTRACT.EX_ to EXTRACT.EXE
- execute EXTRACT.EXE
- the program EXTRACT.EXE will autoexpand (see below for the list)
- close the DOS application "extract" (when finished !)
- now you can run SMBRIDGE.EXE and/or read SMART.HLP
- if all is OK, delete EXTRACT.EXE
- if you want, you can create shortcuts etc.

And now, I hope you enjoy the program.


HARDWARE/SOFTWARE REQUIREMENTS
==============================

The program needs at least a 486/33 MHz processor with 8 MB RAM.

The required disk space is around 5 MB.

The program was developed and tested on Windows'95, but should run on Windows 3.1.



SHAREWARE vs. REGISTERED VERSION
================================

If you are using the unregistered version of SmartBridge, I have granted you a limited license to try out the software to determine its appropriateness for your needs. This evaluation (or demo) version includes all features of the program, and is not crippled in any way.

There is practically only one major limit: evaluation version allows for 50 different random hands and 3 conditioned hands only (for each type of bias).

Registered version will allow you to generate different hands as you like (or as random number generator likes: I tried some hundreds, I expect some thousands; will you recognize one hand after 1000 ?) (Should someone detect a cycle, please tell me)

Other minor differences:
- no more displaying that you are evalauting the software
- registered version shows the registered user name in the opening screen
- GIB thinking time is limited to 10 seconds
- demo version allows only one Edit for run
- demo version allows only one Change for run
(otherwise you could manually create as many hands as needed !)

Once registered, you will receive a personalized code, to be stored in the file code.dat, that will remove the shareware messages and unlock the program.  The code will make all future 1.xx versions fully functional. 

After registration, all you have to do is download the latest version from the Web.

Please note that the above list is the comprehensive set of limitations associated with the shareware version of the product. I have not included bugs or poor performance in the shareware version as an incentive for you to register. I will do my best to improve the
product with further releases that will hopefully overcome these limitations. 




LIST OF SMARTBRIDGE NEEDED FILES
================================

SmartBridge directory must contain the following 55 files:

README   TXT      08/02/98
SMBRIDGE EXE      08/02/98
SMART    HLP      01/02/98
FILE_ID  DIZ      01/02/98
SMART    INI      01/02/98
REGISTER EXE      01/02/98
HAND     HND      30/12/97
SB       MID      05/12/97
CODE     DAT      28/09/97
COMMDLG  DLL      15/02/97
REGISTER HLP      16/01/97
PICCLIP  VBX      28/04/93
CMDIALOG VBX      28/04/93
MCI      VBX      28/04/93
THREED   VBX      16/07/93
PASSO    WAV      28/01/98
DEALER   WAV      28/01/98
ILCONTR  WAV      28/01/98
MORTO    WAV      28/01/98
DECLARER WAV      28/01/98
DECLARES WAV      28/01/98
LEADER   WAV      28/01/98
NORD     WAV      03/01/98
SUD      WAV      03/01/98
EST      WAV      03/01/98
OVEST    WAV      03/01/98
1        WAV      03/01/98
2        WAV      03/01/98
3        WAV      03/01/98
4        WAV      03/01/98
5        WAV      03/01/98
6        WAV      03/01/98
7        WAV      03/01/98
S1       WAV      03/01/98
S2       WAV      03/01/98
S3       WAV      03/01/98
S4       WAV      03/01/98
S0       WAV      03/01/98
SS1      WAV      03/01/98
SS2      WAV      03/01/98
SS3      WAV      03/01/98
SS4      WAV      03/01/98
WELCOME  WAV      03/01/98
TOPSCORE WAV      03/01/98
DOUBLED  WAV      03/01/98
REDOUBLD WAV      03/01/98
PASSED   WAV      03/01/98
REACHED  WAV      03/01/98
SOTTO    WAV      03/01/98
DEVIRISP WAV      03/01/98
GRAZIE   WAV      03/01/98
SIGIOCA  WAV      03/01/98
GIOCAVA  WAV      03/01/98
DOUBLE   WAV      03/01/98
REDOUBLE WAV      03/01/98

+ 50 FILES *.HND (test hands)


WHAT'S NEW
==========

1.0
First released BETA version.

1.01
Bidding errors corrected.
Play of the hand errors corrected.
Modified help.

1.02
Bidding errors corrected.
Modified Summary message.
Atout suit now is on the left.

1.03
Display errors corrected.
Scoring errors corrected: scores were always computed as vulnerable.
  (reported by francesco_zek@rocketmail.com)
Bid errors corrected: it was possible to redouble partner; it was not always possible to double opponents.
  (reported by francesco_zek@rocketmail.com)
Cue-bids have been introduced.
Rubber summary window improved.
Play summary window introduced.
Estimate window introduced.
If only one card remains in a suit, it is played automatically
  (hint by mario.cucci@iol.it)

1.04
New graphic functions (several decks, desktop colors).
Takeback during play.
New .mid file

1.1
First market released version. 
Automatic Setup program.
Uncompressed program information (readme.txt, file_id.diz).
Option window splits into 3 windows, and provides help.
It's possible to define up to 3 convention systems.
It's possible to associate convention systems and play styles to any line (2 lines for rubber, 4 lines for duplicate).
Much stronger card play with GIB (Goren-in-the-box) (see TIPS).
Floating windows.
New .wav files (different voice, six more files).



TIPS
====

The program needs at least a 486 processor with 8 MB RAM. With slow processors/less RAM, starting requires to be patient (windows loading). Some graphics (card redrawing) can also be slow.

Best results with Pentium, 16 MB RAM, 64K colors and at least 800 x 600 resolution. With less resolution large cards should be used (Options - Large cards).

Several windows are opened and are floating on top of the main window. They are automatically positioned, but they can be moved not to hide cards. With higher resolution, windows can be arranged in a way to be all visible.

About audio, make sure that .wav and .mid channels are active, and at the correct volume. .wav files must be necessarily present. .mid files are optional. The program plays in sequence .mid files found in the directory.

A printer must be connected to have print-outs (you command it by Options - Print).

Current hand is always stored in hand.hnd file. In case of errors, please save the charged hand in a file (e.g.: copy hand.hnd bug1.hnd), in order to be able to reproduce the bad condition later, and send me
the error report together with the hand.

GIB is a program developed by Matthew L. Ginsberg and uses techniques from artificial intelligence to build the world's first expert-level computer bridge player. GIB has successfully solved more deals than other competitors, providing evidence that its card play is at a level far superior to that of any other program. 

SmartBridge uses GIB.exe, version 1.2.10, released 3/27/97;  it is approximately 40% as fast as the production version. To play reasonably well, GIB requires a 100 MHz Pentium and at least 16MB of memory. In this configuration, GIB plays very well given at least 30 seconds per play. Since GIB takes time, you may want to stop it: if you press Claim, GIB ends its move (you must wait), then the hand is quickly completed (moves made by SmartBridge); if you press Deal or ReDeal, the hand is interrupted, and restarted with new or old deal (you must bid again).

GIB COPYRIGHT: Copyright in the GIB programs is by Just Write, Inc. Just Write retains all rights to the programs themselves. Permission is granted for use BUT NOT REDISTRIBUTION. Therefore SmartBridge only provides the interface. You must download the program from the Web (~121KB, http://www.cirl.uoregon.edu/gib/), and put it into the SmartBridge directory. Documentation is available also. A product is expected to be released in October '98. If the program is not present, SmartBridge plays according to own algorithms.



REGISTRATION AND PAYMENT TERMS
==============================

SmartBridge is not a free program, but rather is distributed as Shareware for purposes of evaluation. This gives you the opportunity to evaluate SmartBridge as long as you need; if you like the product, want to use the full functions, and encourage further development, you should register it. 

Registration is $25.

Registration can be done in the following ways:

I accept postal money orders, personal checks, bank checks, cash directly in the mail, for the following currencies and prices: (but such payments are at the sender's risk, I don't guarantee in case of loss):				
                                program	diskettes
ITL,italian lire		45.000  10.000
USD,US dollars			25	5
GBP,british pounds		15	5
FRF,french francs		160	40
DEM,deutch marks		50	10
(prices have been rounded to banknote values; for other currencies please refer to official exchange rates, e.g.: <http://www.trustnet.co.uk/xrates/rates0.html>, and round to the banknote higher value).
Print out the order form, fill it with all the required data, include it with your check or cash wrapped in paper to make it less obvious and send it to me.

If you have no time to go to bank, post office etc., or you don't live in Italy, the best way is to use Kagi Shareware Payment Processing Service.

This service handles the processing of the shareware fee. It accepts many different payment methods such as: US Check, Money Order, Cash (in many different currencies: Australian AUD, Austrian ATS, Belgian BEF, Canadian CAD, Danish DKK, French FRF, German DEM, Greek GRD, HongKong HKD, Irish IEP, Italian ITL, Japanese JPY, Dutch NLG, Norwegian NOK, Singaporean SGD, Spanish ESP, Swedish SEK, Swiss CHF, British GBP and American USD), credit cards (Visa, Mastercard, American Express, Diner's Club, Discover), First Virtual payments, and Invoice. Sensitive information, like credit card numbers, is encoded for better security.  

Please use the REGISTER program packaged with the product, and follow the instructions in register.hlp. REGISTER program can also be run from SmartBridge starting window.  For more information go to <http://www.kagi.com/> on the WEB, or send email to <support@kagi.com>.  

In all the cases, I send the registration code after the transaction has been successfully completed (by e-mail this can require less than 3 days).

If you want floppy disks, I can ship them by mail, with additional 6$ fee for expenses. 

If you have an e-mail address and you provide it with your order, then I will automatically send you notification on the availability of major new releases of SmartBridge, as they become available. If it is a version 1.xx upgrade, then your current registration will be accepted by the new software.

In any case, please fill in the following informations:

First name:
Last name:
Street:
Street number:
City:
[State:]
[Postal code:]
Country:
[Phone:]
[Fax:]
[e-mail:]
[x] standard price $25
[ ] additional charge for floppy disks $6

My address:

Francesco Barcio
Viale Abruzzo 154
66013 Chieti (CH)
Italy

My e-mail:

pes136k1@pe.nettuno.it
francesco@kagi.com

Another program from the author:
SmartPBNViewer, a powerful program to read ".pbn" (Portable Bridge Notation) files.
(see <http://www.IAEhv.nl/users/veugent> for details about the format)

No warranty is offered with the software.

This software and documentation are provided for evaluation only, on an "as is" basis. The author disclaims all warranties relating to this software, whether expressed or implied, including but not limited to any implied warranties of merchantabilitiy or fitness for a particular purpose. The author shall have no liabilty for any indirect, consequential, or incidental damage resulting from the use of the software.

