A copy error is attached to a copy when scanning it reveals some malformation.

§1. Copies can sometimes exist in a damaged form: for example, they are purportedly extension files but have a mangled identification line. Each copy structure therefore has a list attached of errors which occurred in reading it.

Each copy error has one of the following categories, and some are divided into subcategories too. Otherwise an error has no real contents: only a ragbag of contextual data — exactly what word it is that is too long, where the sentence is which is mis-punctuated, and such. In every case most of these fields are blank.

enum OPEN_FAILED_CE from 1
enum METADATA_MALFORMED_CE
enum MALFORMED_LICENCE_CE
enum EXT_MISWORDED_CE
enum EXT_BAD_DIRNAME_CE
enum EXT_BAD_FILENAME_CE
enum EXT_TITLE_TOO_LONG_CE
enum EXT_AUTHOR_TOO_LONG_CE
enum EXT_RANEOUS_CE
enum PROJECT_EXTRANEOUS_CE
enum LANGUAGE_UNAVAILABLE_CE
enum LANGUAGE_DEFICIENT_CE
enum LEXER_CE  an error generated by the words module
enum SYNTAX_CE  an error generated by the syntax module, or by our reading of the tree

typedef struct copy_error {
    struct inbuild_copy *copy;

    int error_category;
    int error_subcategory;

    struct text_stream *details;
    struct filename *details_file;
    int details_N;
    struct wording details_W;
    struct parse_node *details_node;
    struct parse_node *details_node2;
    struct inbuild_work *details_work;
    struct inbuild_work *details_work2;
    inchar32_t *details_word;

    CLASS_DEFINITION
} copy_error;

• The structure copy_error is accessed in 2/nst, 3/is, 5/es, 5/ks, 5/ls, 6/inc, 7/tm, 7/eip, 7/ti, 7/il and here.

§2. And now some creators.

copy_error *CopyErrors::new?Usage of CopyErrors::new:
Project Services - §38.1.2.2
Source Text - §15
Headings - §11.1, §12.1, §12.2, §14.3, §22.1, §23.2, §22.3
Inclusions - §3.1, §6.1.2, §7.1, §9.1, §11(int cat, int subcat) {
    copy_error *CE = CREATE(copy_error);
    CE->copy = NULL;
    CE->error_category = cat;
    CE->error_subcategory = subcat;
    CE->details = NULL;
    CE->details_file = NULL;
    CE->details_N = -1;
    CE->details_W = EMPTY_WORDING;
    CE->details_node = NULL;
    CE->details_node2 = NULL;
    CE->details_work = NULL;
    CE->details_work2 = NULL;
    CE->details_word = NULL;
    return CE;
}

copy_error *CopyErrors::new_T?Usage of CopyErrors::new_T:
JSON Metadata - §1.1, §1.2, §1.3.1, §1.3.2, §1.3.3, §1.3.4, §1.3.5, §1.4, §1.5, §1.6
Licences - §3
Extension Bundle Manager - §3, §5, §5.1, §5.1.1, §5.1.2, §5.1.3
Project Bundle Manager - §3.1, §3.1.1, §3.1.2, §3.1.3, §3.1.3.1
Extension Services - §2.2, §2.2.1, §2.2.1.1, §2.2.1.3, §2.2.1.3.2, §2.3, §2.4, §2.4.3, §2.4.3.1.1, §2.4.3.2.1, §2.5, §2.7.4, §9, §13.1
Kit Services - §5.3, §5.3.1, §5.3.1.1, §5.3.2, §12
Language Services - §2
Project Services - §2.3, §5, §18, §23.1, §23.5, §25, §36, §37
Headings - §22.2
Inclusions - §2.2, §2.2.1, §6.1.1, §6.1.2(int cat, int subcat, text_stream *NB) {
    copy_error *CE = CopyErrors::new(cat, subcat);
    CE->details = Str::duplicate(NB);
    return CE;
}

copy_error *CopyErrors::new_N?Usage of CopyErrors::new_N:
Extension Services - §2.3
Source Text - §6(int cat, int subcat, int N) {
    copy_error *CE = CopyErrors::new(cat, subcat);
    CE->details_N = N;
    return CE;
}

copy_error *CopyErrors::new_F?Usage of CopyErrors::new_F:
Extension Services - §2.2
Source Text - §3(int cat, int subcat, filename *F) {
    copy_error *CE = CopyErrors::new(cat, subcat);
    CE->details_file = F;
    return CE;
}

copy_error *CopyErrors::new_WT?Usage of CopyErrors::new_WT:
Source Text - §2(int cat, int subcat, inchar32_t *details_word, text_stream *NB) {
    copy_error *CE = CopyErrors::new(cat, subcat);
    CE->details_word = details_word;
    CE->details = Str::duplicate(NB);
    return CE;
}

§3. It becomes tiresome to make creators for every conceivable possibility, so we also offer these functions to tack extra details on:

void CopyErrors::supply_wording?Usage of CopyErrors::supply_wording:
Source Text - §6
Headings - §22.2
Inclusions - §11(copy_error *CE, wording details_W) {
    CE->details_W = details_W;
}

void CopyErrors::supply_work?Usage of CopyErrors::supply_work:
Headings - §22.1, §22.2(copy_error *CE, inbuild_work *w) {
    CE->details_work = w;
}

void CopyErrors::supply_works?Usage of CopyErrors::supply_works:
Headings - §23.2(copy_error *CE, inbuild_work *w1, inbuild_work *w2) {
    CE->details_work = w1;
    CE->details_work2 = w2;
}

void CopyErrors::supply_node?Usage of CopyErrors::supply_node:
Project Services - §36
Source Text - §15
Headings - §11.1, §12.1, §12.2, §14.3, §22.1, §22.2, §22.3
Inclusions - §2.2, §2.2.1, §3.1, §6.1.1, §6.1.2, §7.1, §9.1, §11(copy_error *CE, parse_node *n) {
    CE->details_node = n;
}

void CopyErrors::supply_nodes?Usage of CopyErrors::supply_nodes:
Headings - §23.2(copy_error *CE, parse_node *n1, parse_node *n2) {
    CE->details_node = n1;
    CE->details_node2 = n2;
}

§4. The following should only be called from Copies.

void CopyErrors::supply_attached_copy?Usage of CopyErrors::supply_attached_copy:
Copies - §5(copy_error *CE, inbuild_copy *C) {
    CE->copy = C;
}

§5. This produces a textual summary of the issue described. It wouldn't do for a proper Inform problem message, but it's fine for the Inbuild command line output.

void CopyErrors::write?Usage of CopyErrors::write:
Copies - §5
Extensions Index Page - §1.2.2.2(OUTPUT_STREAM, copy_error *CE) {
    switch (CE->error_category) {
        case OPEN_FAILED_CE: WRITE("unable to open file %f", CE->details_file); break;
        case EXT_MISWORDED_CE: WRITE("extension misworded: %S", CE->details); break;
        case EXT_BAD_DIRNAME_CE: WRITE("extension directory name wrong: %S", CE->details); break;
        case EXT_BAD_FILENAME_CE: WRITE("extension filename wrong: %S", CE->details); break;
        case EXT_RANEOUS_CE: WRITE("extraneous content: %S", CE->details); break;
        case PROJECT_EXTRANEOUS_CE: WRITE("project has extraneous content: %S", CE->details); break;
        case METADATA_MALFORMED_CE: WRITE("%S has incorrect metadata: %S",
            CE->copy->edition->work->genre->genre_name, CE->details); break;
        case MALFORMED_LICENCE_CE: WRITE("%S has incorrect 'legal-metadata': %S",
            CE->copy->edition->work->genre->genre_name, CE->details); break;
        case EXT_TITLE_TOO_LONG_CE: WRITE("title too long: %d characters (max is %d)",
            CE->details_N, MAX_EXTENSION_TITLE_LENGTH); break;
        case EXT_AUTHOR_TOO_LONG_CE: WRITE("author name too long: %d characters (max is %d)",
            CE->details_N, MAX_EXTENSION_AUTHOR_LENGTH); break;
        case LANGUAGE_UNAVAILABLE_CE: WRITE("%S refers to an unavailable language: %S",
            CE->copy->edition->work->genre->genre_name, CE->details); break;
        case LANGUAGE_DEFICIENT_CE: WRITE("%S: %S",
            CE->copy->edition->work->genre->genre_name, CE->details); break;
        case LEXER_CE: Write a lexer error5.1; break;
        case SYNTAX_CE: Write a syntax error5.2; break;
        default: internal_error("an unknown error occurred");
    }
}

§5.1. Write a lexer error5.1 =

    switch (CE->error_subcategory) {
        case STRING_TOO_LONG_LEXERERROR:
            WRITE("Too much text in quotation marks: %w", CE->details_word); break;
        case WORD_TOO_LONG_LEXERERROR:
            WRITE("Word too long: %w", CE->details_word); break;
        case I6_TOO_LONG_LEXERERROR:
            WRITE("I6 inclusion too long: %w", CE->details_word); break;
        case STRING_NEVER_ENDS_LEXERERROR:
            WRITE("Quoted text never ends: %S", CE->details); break;
        case COMMENT_NEVER_ENDS_LEXERERROR:
            WRITE("Square-bracketed text never ends: %S", CE->details); break;
        case I6_NEVER_ENDS_LEXERERROR:
            WRITE("I6 inclusion text never ends: %S", CE->details); break;
        default:
            WRITE("lexer error"); break;
    }

• This code is used in §5.

§5.2. Write a syntax error5.2 =

    switch (CE->error_subcategory) {
        case UnexpectedSemicolon_SYNERROR:
            WRITE("unexpected semicolon in sentence"); break;
        case ParaEndsInColon_SYNERROR:
            WRITE("paragraph ends with a colon"); break;
        case SentenceEndsInColon_SYNERROR:
            WRITE("paragraph ends with a colon and full stop"); break;
        case SentenceEndsInSemicolon_SYNERROR:
            WRITE("paragraph ends with a semicolon and full stop"); break;
        case SemicolonAfterColon_SYNERROR:
            WRITE("paragraph ends with a colon and semicolon"); break;
        case SemicolonAfterStop_SYNERROR:
            WRITE("paragraph ends with a full stop and semicolon"); break;
        case HeadingOverLine_SYNERROR:
            WRITE("heading contains a line break"); break;
        case HeadingStopsBeforeEndOfLine_SYNERROR:
            WRITE("heading stops before end of line"); break;
        case ExtNoBeginsHere_SYNERROR:
            WRITE("extension has no beginning"); break;
        case ExtNoEndsHere_SYNERROR:
            WRITE("extension has no end"); break;
        case ExtSpuriouslyContinues_SYNERROR:
            WRITE("extension continues after end"); break;
        case ExtMultipleBeginsHere_SYNERROR:
            WRITE("extension has multiple 'begins here' sentences"); break;
        case ExtBeginsAfterEndsHere_SYNERROR:
            WRITE("extension has a 'begins here' after its 'ends here'"); break;
        case ExtEndsWithoutBegins_SYNERROR:
            WRITE("extension has an 'ends here' but no 'begins here'"); break;
        case ExtMultipleEndsHere_SYNERROR:
            WRITE("extension has multiple 'ends here' sentences"); break;
        case BadTitleSentence_SYNERROR:
            WRITE("bibliographic sentence at the start is malformed"); break;
        case UnknownLanguageElement_SYNERROR:
            WRITE("unrecognised stipulation about Inform language elements"); break;
        case UnknownVirtualMachine_SYNERROR:
            WRITE("unrecognised stipulation about virtual machine"); break;
        case UseElementWithdrawn_SYNERROR:
            WRITE("use language element is no longer supported"); break;
        case IncludeExtQuoted_SYNERROR:
            WRITE("extension name should not be double-quoted"); break;
        case BogusExtension_SYNERROR:
            WRITE("can't find this extension"); break;
        case ExtVersionTooLow_SYNERROR:
            WRITE("extension version too low"); break;
        case ExtVersionMalformed_SYNERROR:
            WRITE("extension version is malformed"); break;
        case ExtInadequateVM_SYNERROR:
            WRITE("extension is not compatible with the target virtual machine"); break;
        case ExtMisidentifiedEnds_SYNERROR:
            WRITE("extension has an 'ends here' which doesn't match the 'begins here'"); break;
        case HeadingInPlaceOfUnincluded_SYNERROR:
            WRITE("heading is in place of an extension not included"); break;
        case UnequalHeadingInPlaceOf_SYNERROR:
            WRITE("heading is in place of another heading but of a different level"); break;
        case HeadingInPlaceOfSubordinate_SYNERROR:
            WRITE("heading is in place of another heading subordinate to itself"); break;
        case HeadingInPlaceOfUnknown_SYNERROR:
            WRITE("heading is in place of another heading which doesn't exist"); break;
        case UnavailableLOS_SYNERROR:
            WRITE("this language bundle does not provide Preform syntax"); break;
        case DialogueOnSectionsOnly_SYNERROR:
            WRITE("only 'Section' headings can be marked as '(dialogue)'"); break;
        case UnexpectedDialogue_SYNERROR:
            WRITE("something other than a cue or a line under a dialogue heading"); break;
        case UnquotedDialogue_SYNERROR:
            WRITE("speech in dialogue which is not just a single double-quoted text"); break;
        case EmptyDialogueClause_SYNERROR:
            WRITE("empty clause in brackets in dialogue"); break;
        case MisbracketedDialogueClause_SYNERROR:
            WRITE("brackets '(' and ')' used in an unmatched way in dialogue"); break;
        case MissingSourceFile_SYNERROR:
            WRITE("cannot find source file: '%S'", CE->details); break;
        case HeadingWithFileNonempty_SYNERROR:
            WRITE("heading should refer only to source file '%S' but also contains material",
                CE->details); break;
        case MisheadedSourceFile_SYNERROR:
            WRITE("source file '%S' does not begin with a heading matching 'see ...' line",
                CE->details); break;
        case HeadingTooGreat_SYNERROR:
            WRITE("source file contains a heading of too high a level"); break;
        default:
            WRITE("syntax error"); break;
    }

• This code is used in §5.