openstvoutput24compare; wip

[appendix-a6.git] / README.format

diff --git a/README.format b/README.format
index 5ec79035cb7e09eb84aa04dbc86b76c459c2a7a8..88c3d7beac7eb85f9e09624f54ea3c500069eef1 100644 (file)
--- a/README.format
+++ b/README.format
@@ -38,6 +38,9 @@ cannot contain leading or trailing whitespace).
 
 VOTERNAMEs need not be distinct and may be empty.
 
 
 VOTERNAMEs need not be distinct and may be empty.
 

+Ballots may contain zero or more preferences, each being one or more
+CAND joined by `='s.  Preferences are separated by spaces.
+

 OPTION is OPTNAME[=VALUE] and modifies the preference, ballot, or whole
 election.  VALUE may contain no whitespace.
 
 OPTION is OPTNAME[=VALUE] and modifies the preference, ballot, or whole
 election.  VALUE may contain no whitespace.
 


@@ -57,11 +60,16 @@ Currently defined OPTNAMEs (default values shown)
  Election   seats=1     Number of seats to be filled.
  Election   _nodefault  For Debian A6, no default option
  Election   quorum=NUM  Quorum (default, none)
  Election   seats=1     Number of seats to be filled.
  Election   _nodefault  For Debian A6, no default option
  Election   quorum=NUM  Quorum (default, none)

+ Election   _tie=C,C>D,D  Tie break: in tie of Cs vs Ds,
+                            take Cs to have more votes than Ds.
+                            also available with <, normalised to >
+                            normalised form has Cs and Ds sorted

 
  Candidate  Super=1:1   For Debian A6, RAT:IO, 
  Candidate  default     For Debian A6, Is the default option
 
 
  Candidate  Super=1:1   For Debian A6, RAT:IO, 
  Candidate  default     For Debian A6, Is the default option
 

- Voter      Weight=1.0
+ Ballot     Weight=1.0
+ Ballot     Weight=NUM/DEN

 
 OPTIONs wihin a particular scope may occur in any order.  Whether they
 may be repeated is up to the option.
 
 OPTIONs wihin a particular scope may occur in any order.  Whether they
 may be repeated is up to the option.