Categories; or, what should an entry contain?

There are five categories this year. These are quite conservative.

1. Turing-equivalent language

In this category, all entries should be languages that have descriptive power equivalent to a Turing machine, or at least, intend to have.

The submission should contain a short introduction to the language (gebooie-1.0/README), possibly with examples, a specification (gebooie-1.0/gebooie-spec.txt) with enough detail to implement the language and with a passage on why you think the language is TEq, some trivial and preferably non-trivial example programs (gebooie-1.0/examples/) and preferably an implementation. If you want to play nice, include also a makefile and/or installation instructions (gebooie-1.0/INSTALL).

2. Under-Turing-equivalent gimmick

Languages, facilities and libraries not falling into the previous category. HQ9+ and a library/filter to interpret character streams into GUI interactions are examples of proper entries to this category.

The submission should contain a short introduction to the facility (gebooie-1.0/README), possibly with examples, a specification (gebooie-1.0/gebooie-spec.txt) with enough detail to implement the facility, some trivial and preferably non-trivial use cases (gebooie-1.0/examples/) and preferably an implementation. If you want to play nice, include also a makefile and/or installation instructions (gebooie-1.0/INSTALL).

3. A program in an esoteric programming language

An interesting program that is written in some esoteric language (by your definition of esoteric, which might or might not include e.g. C++), possibly obfuscated if not complicated enough otherwise.

The submission should contain a short introduction to the program (gebooie-1.0/README), possibly with usage examples, a description of what the program does, in detail (gebooie-1.0/gebooie.txt), a description of why the program does that (i.e. how it works and what kind of states / data structures / logic it has), unless writing one would be boring/trivial (gebooie-1.0/gebooie-explanation.txt), and the program itself.

4. A new implementation of an old esoteric programming language

An implementation for an esoteric language previously published and preferably invented by someone else than the contestant.

The submission should contain the implementation, proper documentation (gebooie-1.0/README and gebooie-1.0/gebooie-spec.txt, possibly also a manual page), and good facilities for building and installing the software (makefile and/or INSTALL and/or some custom installation system, like a wizard).

5. Anything goes category

In this category, anything can be submitted.

Note that only categories 1, 2, and 4 are mutually exclusive. An entry can be submitted in multiple categories. All submissions should come with a license (gebooie-1.0/LICENSE); it might contain something as simple as gebooie-1.0 is in the public domain.