Annotations to a LP tree to accommodate weaving.

§1. We won't do any work in this section, only set up some additional fields in LP source trees to enable weaving.

typedef struct ls_web_weaving_details {
    struct ebook *as_ebook;  when being woven to an ebook
    struct pathname *redirect_weaves_to;  ditto
    CLASS_DEFINITION
} ls_web_weaving_details;

typedef struct ls_chapter_weaving_details {
    struct weave_order *ch_weave;  NULL unless this chapter produces a weave of its own
    CLASS_DEFINITION
} ls_chapter_weaving_details;

typedef struct ls_section_weaving_details {
    struct weave_order *sect_weave;  NULL unless this section produces a weave of its own
    struct filename *sect_weave_to;  NULL unless some special choice has been made
    int printed_number;  temporary again: sometimes used in weaving
    CLASS_DEFINITION
} ls_section_weaving_details;

• The structure ls_web_weaving_details is private to this section.
• The structure ls_chapter_weaving_details is private to this section.
• The structure ls_section_weaving_details is private to this section.

§2.

void WeavingDetails::initialise(ls_web *W, pathname *redirection) {
    Give the web weaving details2.1;
    ls_chapter *C;
    LOOP_OVER_LINKED_LIST(C, ls_chapter, W->chapters) {
        Give the chapter weaving details2.2;
        ls_section *S;
        LOOP_OVER_LINKED_LIST(S, ls_section, C->sections)
            Give the section weaving details2.3;
    }
}

§2.1. Give the web weaving details2.1 =

    ls_web_weaving_details *weave_details = CREATE(ls_web_weaving_details);
    W->weaving_ref = (void *) weave_details;
    weave_details->as_ebook = NULL;
    weave_details->redirect_weaves_to = redirection;

• This code is used in §2.

§2.2. Give the chapter weaving details2.2 =

    ls_chapter_weaving_details *weave_details = CREATE(ls_chapter_weaving_details);
    C->weaving_ref = (void *) weave_details;
    weave_details->ch_weave = NULL;

• This code is used in §2.

§2.3. Give the section weaving details2.3 =

    ls_section_weaving_details *weave_details = CREATE(ls_section_weaving_details);
    S->weaving_ref = (void *) weave_details;
    weave_details->printed_number = -1;
    weave_details->sect_weave = NULL;
    weave_details->sect_weave_to = NULL;

• This code is used in §2.

§3. Here are the semantics for a web:

ebook *WeavingDetails::get_as_ebook?Usage of WeavingDetails::get_as_ebook:
The Swarm - §11
Assets, Plugins and Colour Schemes - §12.3
HTML Formats - §4, §5.2, §11(ls_web *W) {
    return ((ls_web_weaving_details *) (W->weaving_ref))->as_ebook;
}

void WeavingDetails::set_as_ebook?Usage of WeavingDetails::set_as_ebook:
HTML Formats - §11(ls_web *W, ebook *val) {
    ((ls_web_weaving_details *) (W->weaving_ref))->as_ebook = val;
}

pathname *WeavingDetails::get_redirect_weaves_to?Usage of WeavingDetails::get_redirect_weaves_to:
The Swarm - §8.1, §11
Assets, Plugins and Colour Schemes - §12.3
HTML Formats - §11(ls_web *W) {
    return ((ls_web_weaving_details *) (W->weaving_ref))->redirect_weaves_to;
}

void WeavingDetails::set_redirect_weaves_to?Usage of WeavingDetails::set_redirect_weaves_to:
HTML Formats - §11(ls_web *W, pathname *val) {
    ((ls_web_weaving_details *) (W->weaving_ref))->redirect_weaves_to = val;
}

§4. And for a chapter:

weave_order *WeavingDetails::get_ch_weave?Usage of WeavingDetails::get_ch_weave:
The Collater - §5.1.9.7.1(ls_chapter *C) {
    return ((ls_chapter_weaving_details *) (C->weaving_ref))->ch_weave;
}

void WeavingDetails::set_ch_weave?Usage of WeavingDetails::set_ch_weave:
The Swarm - §7(ls_chapter *C, weave_order *O) {
    ((ls_chapter_weaving_details *) (C->weaving_ref))->ch_weave = O;
}

§5. And lastly for a section.

weave_order *WeavingDetails::get_sect_weave?Usage of WeavingDetails::get_sect_weave:
The Collater - §5.1.9.8.1(ls_section *S) {
    return ((ls_section_weaving_details *) (S->weaving_ref))->sect_weave;
}

void WeavingDetails::set_sect_weave?Usage of WeavingDetails::set_sect_weave:
The Swarm - §7(ls_section *S, weave_order *val) {
    ((ls_section_weaving_details *) (S->weaving_ref))->sect_weave = val;
}

int WeavingDetails::get_section_number?Usage of WeavingDetails::get_section_number:
TeX Format - §4.3(ls_section *S) {
    return ((ls_section_weaving_details *) (S->weaving_ref))->printed_number;
}

void WeavingDetails::set_section_number(ls_section *S, int val) {
    ((ls_section_weaving_details *) (S->weaving_ref))->printed_number = val;
}

filename *WeavingDetails::get_section_weave_to?Usage of WeavingDetails::get_section_weave_to:
Colonies - §11(ls_section *S) {
    if (S->weaving_ref == NULL) return NULL;
    return ((ls_section_weaving_details *) (S->weaving_ref))->sect_weave_to;
}

void WeavingDetails::set_section_weave_to?Usage of WeavingDetails::set_section_weave_to:
The Swarm - §8.1(ls_section *S, filename *val) {
    ((ls_section_weaving_details *) (S->weaving_ref))->sect_weave_to = val;
}