Advanced Compo Manager

Advanced Compo Manager is a new compo manager coded by mukunda. It features advanced features such as auto-guessing who made which track and reading votes of all kinds of formats off the clipboard. It's great, really.

---

                 Automatic Compo Manager - User's Manual (v1.1)

-------------------------------------------------------------------------

What is Automatic Compo Manager?

--------------------------------

Automatic Compo Manager (ACM) is a program that eases the difficulty of 

hosting a competition with many participants.

ACM is designed to handle most of the tedious work of hosting a compo 

to allow you to spend more time with the participants, or your children.

Basic Usage Guide

-----------------

To start a compo session, open a command prompt and navigate to the 

compo directory.

Start ACM with all of the entries (files) supplied as arguments.

C:\compo>acm song1.xm test.xm tens.xm

ACM will start and attempt to load information from the entries, such 

as their titles. When it's done, you will see the command prompt "$".

To add a member, or a voter, use the 'add' command.

$ add thisman

There are two ways to use the add command, if you supply only the name

of the member, then the vote text will be read from the Windows clipboard.

Another way to add votes is to simply type them in after the name.

$ add thisman song3 test tens

This is for rare circumstances when a voter gives retarded input to you.

The input in this method is more strict, each term mentioned should

represent a song. To save on typing, you can also abbreviate entries,

the program will complain if there are ambiguous terms.

$ add thisman s t ten

This will do the same as the command above.

$ add thisman s t te

This will generate an error because not enough information is present

to resolve t and te (which may both represent test and tens)

After the votes are added, ACM will print a summary, it may be a good

to briefly compare the summary with the user's votetext (if using the

automatic method), since humans can do a much better job at parsing 

information.

After you have added all the necessary voters, you can use the 'print'

command to view the results. You can also use 'print <file>' to print

a detailed report to the given text file (for the internets).

Extra Voters, and Non-Voters

----------------------------

Sometimes some other people want to join in the fun of voting. To add

their 'extra' votes, use the 'extra' command, rather than the 'add'

command.

$ extra thisman

The 'extra' command works the same way as the 'add' command, except it

creates an 'extra' member, so it does not become associated with an

entry.

Now, sometimes a participant has IRL things to attend to and can't vote.

Normally, all of the entries are resolved based on each participants

vote text. But in this case, the entry that the particpant made needs 

to be 'resolved' manually.

$ resolve thisman tens.xm

(or...you can abbreviate it)

$ resolve thisman ten

This creates a member without vote text and assigns an entry to him. You

will get an error if you attempt to print the votes without fully

resolved entries.

Now, when calculating the results, each member will get a 'voting bonus'

if they have voted. If they haven't voted, they will miss out on this

bonus and their entry will be penalized. A way to avoid this penalty on

the poor participant is to have an extra voter vote in his place. This

is done with the 'merge' command. 'merge' can only be used when one

of the member's is an 'extra' member that has voted, and the other is

a 'resolved' member that is assigned and entry, but hasn't voted.

$ merge extraman thisman

This will delete 'extraman' from the member list and assign his votes

(removing thisman's entry from them) to thisman.'

Status and Swapping

-------------------

You can view the status of the compo with the 'list' and 'view' commands.

The 'list' command prints out a summary of all the member's in the compo.

$ list

[X] dude1, Entry: song1.xm

[ ] dude2, Entry: test.xm

[X] dude3, Entry: tens.xm

[X] dude4, Extra Voter

The [X] box tells you if they have voted or not. As you can see, dude2

hasn't voted and will not receive a voting bonus! There is an extra

voter though, the 'donate' command can be used to save dude2 from

certain pain.

$ donate dude4 dude2

Okay.

$ list

[X] dude1, Entry: song1.xm

[X] dude2, Entry: test.xm

[X] dude3, Entry: tens.xm

Now dude4 has been merged with dude2. You can view the votes of any

member with the 'list <member>' command.

$ list dude2

dude2 has voted:

<1>song1.xm

<2>tens.xm

If for some reason someone's votes got messed up, you can rearrange them

manually with the 'swap' command.

$ swap dude2 song1 ten

Okay.

$ list dude2

dude2 has voted:

<1>tens.xm

<2>song1.xm

Finally, another status view you can use is the entry list. To show this,

use the 'view' command.

$ view

 - song1.xm (untitled), Author: dude1

 - test.xm (untitled), Author: dude2

 - tens.xm (untitled), Author: dude3

Other Commands

--------------

One other command is the 'toggle' command. Usually, the extension of the

filenames are ignored when searching for terms in the vote text. The

'toggle' command will toggle whether or not '.' is a delimiter character.

This is for the rare case when one entry's filename is the same as

another, but with a different extension.

Handicap

--------

If someone always wins and you want other people to win for a change, you

can use the 'handicap' command to make it more fair:

$ handicap reduz 999

Ending the session

------------------

To end your ACM session, use the 'quit' command. It will prompt you to

make sure this is desirable. Make sure you don't forget to print a report

for the internets!

EXTRA BONUS

-----------

FOR GIEV BONUS USE 'BONUS' COMMAND:

$ BONUS thisman 8000

GIVE +8000 PONITS!