Setting up the use of this module.

§1. This section simply sets up the module in ways expected by foundation, and contains no code of interest. The following constant exists only in tools which use this module:

define LINGUISTICS_MODULE TRUE

§2. This module defines the following classes:

enum adjective_CLASS
enum article_CLASS
enum article_usage_CLASS
enum quantifier_CLASS
enum determiner_CLASS
enum grammatical_category_CLASS
enum linguistic_stock_item_CLASS
enum grammatical_usage_CLASS
enum verb_CLASS
enum verb_form_CLASS
enum verb_meaning_CLASS
enum verb_sense_CLASS
enum verb_usage_CLASS
enum verb_usage_tier_CLASS
enum preposition_CLASS
enum noun_CLASS
enum noun_usage_CLASS
enum pronoun_CLASS
enum pronoun_usage_CLASS
enum small_word_set_CLASS
enum special_meaning_holder_CLASS
enum time_period_CLASS

DECLARE_CLASS(adjective)
DECLARE_CLASS(article)
DECLARE_CLASS(article_usage)
DECLARE_CLASS(quantifier)
DECLARE_CLASS(determiner)
DECLARE_CLASS(grammatical_category)
DECLARE_CLASS(linguistic_stock_item)
DECLARE_CLASS(grammatical_usage)
DECLARE_CLASS(verb)
DECLARE_CLASS(verb_form)
DECLARE_CLASS_ALLOCATED_IN_ARRAYS(verb_meaning, 100)
DECLARE_CLASS(verb_sense)
DECLARE_CLASS(verb_usage)
DECLARE_CLASS(verb_usage_tier)
DECLARE_CLASS(preposition)
DECLARE_CLASS(time_period)
DECLARE_CLASS(noun)
DECLARE_CLASS(noun_usage)
DECLARE_CLASS(pronoun)
DECLARE_CLASS(pronoun_usage)
DECLARE_CLASS(special_meaning_holder)
DECLARE_CLASS(small_word_set)

§3. Like all modules, this one must define a start and end function:

enum LINGUISTIC_STOCK_DA
enum TIME_PERIODS_DA
enum VERB_USAGES_DA
enum VERB_FORMS_DA

COMPILE_WRITER(noun *, Nouns::log)

void LinguisticsModule::start(void) {
    Register this module's debugging log aspects3.1;
    Register this module's debugging log writers3.2;
    Declare new memory allocation reasons3.4;
    Stock::create_categories();
    Cardinals::enable_in_word_form();
    Articles::mark_for_preform();
    Prepositions::mark_for_preform();
    Diagrams::declare_annotations();
}
void LinguisticsModule::end(void) {
}

§3.1. Register this module's debugging log aspects3.1 =

    Log::declare_aspect(LINGUISTIC_STOCK_DA, U"linguistic stock", FALSE, FALSE);
    Log::declare_aspect(TIME_PERIODS_DA, U"time periods", FALSE, FALSE);
    Log::declare_aspect(VERB_USAGES_DA, U"verb usages", FALSE, TRUE);
    Log::declare_aspect(VERB_FORMS_DA, U"verb forms", FALSE, TRUE);

• This code is used in §3.

§3.2. Register this module's debugging log writers3.2 =

    Writers::register_logger('t', Occurrence::log);
    Writers::register_logger('p', Prepositions::log);
    Writers::register_logger('w', Verbs::log_verb);
    Writers::register_logger('y', VerbMeanings::log);
    REGISTER_WRITER('z', Nouns::log);

• This code is used in §3.

§3.3. Not all of our memory will be claimed in the form of structures: now and then we need to use the equivalent of traditional malloc and calloc routines.

enum STOCK_MREASON
enum SWS_MREASON

§3.4. Declare new memory allocation reasons3.4 =

    Memory::reason_name(STOCK_MREASON, "linguistic stock array");
    Memory::reason_name(SWS_MREASON, "small word set array");

• This code is used in §3.

§4. This module requires words, which contains the Preform parser. When that initialises, it calls the following routine to improve its performance.

define PREFORM_OPTIMISER_WORDS_CALLBACK LinguisticsModule::preform_optimiser

int first_round_of_nt_optimisation_made = FALSE;
void LinguisticsModule::preform_optimiser(void) {
    Cardinals::preform_optimiser();
    VerbUsages::preform_optimiser();
    Prepositions::preform_optimiser();
    if (first_round_of_nt_optimisation_made == FALSE) {
        first_round_of_nt_optimisation_made = TRUE;
        Quantifiers::make_built_in();
    }
}