From: Ian Jackson Date: Sun, 2 Feb 2014 22:44:06 +0000 (+0000) Subject: docs X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=appendix-a6.git;a=commitdiff_plain;h=ec0d2dafa7c72f2f7d77e77c7859ca9aad7635d9 docs --- diff --git a/compute b/compute index a58e250..c544437 100755 --- a/compute +++ b/compute @@ -4,8 +4,50 @@ # to Debian Constitution A.6. # # usage: .../compute [...] +# (uses stdin if none supplied) # -# +# input files can be in any order and should contain lines like: +# +# :: , (=), , .... +# V: +# = +# = [:] +# = [default] +# nodefault +# quorum = +# +# where +# +# is any non-whitespace characters +# +# and are abbreviations for choices on the ballot. +# They must be ASCII alphanumeric. Numeric preferences are +# not recommended as they are confusing (particularly when +# tally sheets are in use). +# +# It is best to avoid FD, SQ and NOTA except for the default +# option; if no default option is specified, it will default +# to one of these unless a "nodefault" line is found. +# +# In the "::" form, the commas are optional. Either ( ) or = may +# be used to indicate a set of equal preferences. +# +# is a tally sheet preference order: that is, +# a single uppercase base36 digit for each ballot choice, +# (in the order they were specified by "=" lines), giving +# the voter's preference rank for that option. The numbers +# need not be distinct or contiguous. "-" may be used for +# unranked preferences. +# +# : is the majority ratio for the option +# +# is the quorum +# +# and also allowed are +# +# #-comments } all +# blank lines } ignored +# lines starting with whitespace } use strict; use utf8;