Collation Software FAQ

The following are questions asked by study group coordinators.  If you don't see the answer to your question, and reading the installation and configuration instructions doesn't help, send email to Kirk Lougheed.

How do I collate Unicode Greek or Hebrew?

If you are collating Greek or Hebrew text using the Unicode character set, you must add the command unicode to your names.txt file.  Failure to do so will result in a garbled collation.


What files are ignored by the collation software?

Some files are deliberately ignored, such as files whose names end in a tilde or pound sign, or which begin with a period.  Examples of such files include foo~, foo#, and .foo.  They are commonly produced as back-up files by text editors on Unix systems, or are files that are normally hidden from view.

Folders with the names upcoming and lastweek are also ignored by the collation software.  These folders can be used to hold files that you don't want collated.


What is the error “No material found”?

If the collation software can't figure out what to do with a input file, it will complain in the errors.txt file that no material was found.  In the case of a Wheelock style collation, someone has probably severely messed up their formatting.  For a translation group, you are probably missing the initials in the names.txt file.


What is the error “Note: SA 1 in gjc.eml, correcting...”?

It means that in exercise SA 1 in the file gjc.eml, some word was found instead of the expected initials GJC.  In other words, the contributor forgot to add their initials or misspelled them.  The script will try to fix this problem, but will complain.  Editing the offending file will remove the complaint.


What is the error “Duplicate item”?

The contributor has included at least two sentences with the same section and exercise number, for example, two translations starting SA 3 GJC.  Fix this numbering problem by editing the offending file.


What is the error “Conflict for GJC”?

In your names.txt file you have the same initials (GJC in this example) for different people.  Chose a different set of initials for one of the people.


What is the error “Unknown code =F9 found in kl.eml”?

The collation software has found something that looks like a “quoted-printable” encoded character =F9 in the file kl.eml and doesn't know how to turn it into an ASCII character.  This is not a serious error and can be ignored.