.TH "SALLIERE" "1" 
.SH "NAME" 
salliere \(em Duplicate Bridge Scorer 
.SH "SYNOPSIS" 
.PP 
\fBsalliere\fR [\fBoptions\fP] \-\- 
[\fBcommands\fP]  [boards.csv]  [names.csv]  
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBsalliere\fR command. 
.PP 
\fBsalliere\fR scores, matchpoints and nicely formats 
the boards for a duplicate pairs evening. The command line is a list of 
commands followed by two comma-separated files on which to operate.  
 
.PP 
The boards file must contain lines with at least board number, NS pair 
number, EW pair number, Contract, Declarer and either tricks or the 
contract must include whether it made (=) went down (\-tricks) or made 
over tricks (+tricks). The names file must list at least pair number 
followed by two comma separated names.  
 
.PP 
The commands will add tricks, scores and matchpoint columns to the boards 
file and total matchpoints, percentages and local/orange points to the 
names file as appropriate. 
 
.PP 
By default the commands which print results will do so as ascii to stdout. 
This can be changed with the \-\-output=format:file option. Formats are 
either pdf, html or txt and file is the path to a file or \- for stdout. 
 
.PP 
The commands which format the output require the extra fields to be added 
either by hand or with the appropriate commands so they can be printed. 
 
.SH "COMMANDS" 
.PP 
Here are a list of the available commands and what they do: 
 
.IP "verify" 10 
Checks all the boards look sane; can be used with 
the \-\-setsize option to check the movement 
.IP "score" 10 
Calculates tricks and score for each contract 
.IP "matchpoint" 10 
Calculates match points for each hand 
.IP "ximp" 10 
Calculates cross-imps for each hand 
.IP "parimp" 10 
Calculates imps vs par for each hand 
.IP "total" 10 
Calculates the total match points for each pair 
.IP "handicap" 10 
Calculates the result after applying handicaps for each player 
.IP "localpoint" 10 
Calculates local or orange points for each pair 
.IP "results" 10 
Prints all the pairs in order with their total match points, percentages and local/orange points as appropriate 
.IP "matrix" 10 
Prints a matrix of match points gained on each board by each pair 
.IP "boards" 10 
Prints out each board with pairs, contract, results and match points 
.IP "ecats-upload" 10 
Upload results to ecats bridge website 
.IP "scoreteams" 10 
Prints out the results of the boards as a team of 4 or team of 8 match 
.SH "OPTIONS" 
.PP 
Here are a list of the available options and what they do: 
 
.IP "\-\-help" 10 
Prints the help text 
.IP "\-\-setsize=N" 10 
Check the movement based on sets of size N. Also used when printing the matrix to batch the results 
.IP "\-\-orange" 10 
Prints "OP" rather than "LP" 
.IP "\-\-ximp" 10 
Adjusts output for IMPs rather than matchpoints 
.IP "\-\-title=title" 10 
Changes the title on the output 
.IP "\-\-output=format:file" 10 
Changes the output format and file. Possible formats are pdf, html, htmlfrag, csv or txt.  
A file of '\-' corresponds to stdout. 
.IP "\-\-with-par" 10 
Prints the par result along with the boards 
.IP "\-\-trickdata=file" 10 
The tricks which can be made on each board for calculating par 
.IP "\-\-handcapdata" 10 
Current handicaps for individuals 
.IP "\-\-with-handicaps" 10 
Prints the handicaps with each pair 
.IP "\-\-handcap-normalizer" 10 
When handicapping, center around this number as par 
.IP "\-\-teamsize=N" 10 
Number of players in a team (4 or 8) for overall team scoring 
.IP "\-\-teamprefix=prefix" 10 
The prefix on each pair number to identify which team they are on (eg CU if the pairs are named CU1, CU2, ...) 
.IP "\-\-ecats-options=key:value,key2:value2,..." 10 
Options used to send scores to ecats. 
.SH "ECATS OPTIONS" 
.PP 
Here are a list of the available options to ecats and what they do. 
 
.IP "clubName" 10 
name of club (required) 
.IP "session" 10 
ECATS session number (required) 
.IP "phone" 10 
contact phone number (required) 
.IP "country" 10 
club country (required) 
.IP "name" 10 
contact name 
.IP "fax" 10 
contact fax number 
.IP "email" 10 
contact email 
.IP "town" 10 
club town 
.IP "county" 10 
club county 
.IP "date" 10 
event date 
.IP "event" 10 
event name 
.SH "AUTHOR" 
.PP 
This manual page was written by Matthew Johnson <debian@matthew.ath.cx>. Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public License, Version 2 as 
published by the Free Software Foundation. 
 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
 
.\" created by instant / docbook-to-man, Sun 24 Jan 2010, 23:29