inweb-bootstrap/Chapter 1/Basics.w

[Basics::] Basics.

Some fundamental definitions, mostly declaring object types to the Foundation
module.

@ Every program using //foundation// must define this:

@d PROGRAM_NAME "inweb"

@ We need to itemise the structures we'll want to allocate. For explanations,
see //foundation: A Brief Guide to Foundation//.

@e breadcrumb_request_MT
@e chapter_MT
@e colony_MT
@e colony_member_MT
@e colouring_language_block_MT
@e colouring_rule_MT
@e enumeration_set_MT
@e hash_table_entry_MT
@e hash_table_entry_usage_MT
@e language_function_MT
@e language_type_MT
@e macro_MT
@e macro_tokens_MT
@e macro_usage_MT
@e nonterminal_variable_MT
@e para_macro_MT
@e paragraph_MT
@e paragraph_tagging_MT
@e preform_nonterminal_MT
@e programming_language_MT
@e reserved_word_MT
@e section_MT
@e source_line_array_MT
@e structure_element_MT
@e tangle_target_MT
@e tex_results_MT
@e text_literal_MT
@e theme_tag_MT
@e weave_format_MT
@e weave_pattern_MT
@e weave_plugin_MT
@e weave_order_MT
@e web_MT
@e writeme_asset_MT

@ And then expand the following macros, all defined in //Memory//.

=
ALLOCATE_IN_ARRAYS(source_line, 1000)
ALLOCATE_INDIVIDUALLY(breadcrumb_request)
ALLOCATE_INDIVIDUALLY(chapter)
ALLOCATE_INDIVIDUALLY(colony)
ALLOCATE_INDIVIDUALLY(colony_member)
ALLOCATE_INDIVIDUALLY(colouring_language_block)
ALLOCATE_INDIVIDUALLY(colouring_rule)
ALLOCATE_INDIVIDUALLY(enumeration_set)
ALLOCATE_INDIVIDUALLY(hash_table_entry_usage)
ALLOCATE_INDIVIDUALLY(hash_table_entry)
ALLOCATE_INDIVIDUALLY(language_function)
ALLOCATE_INDIVIDUALLY(language_type)
ALLOCATE_INDIVIDUALLY(macro_tokens)
ALLOCATE_INDIVIDUALLY(macro_usage)
ALLOCATE_INDIVIDUALLY(macro)
ALLOCATE_INDIVIDUALLY(nonterminal_variable)
ALLOCATE_INDIVIDUALLY(para_macro)
ALLOCATE_INDIVIDUALLY(paragraph_tagging)
ALLOCATE_INDIVIDUALLY(paragraph)
ALLOCATE_INDIVIDUALLY(preform_nonterminal)
ALLOCATE_INDIVIDUALLY(programming_language)
ALLOCATE_INDIVIDUALLY(reserved_word)
ALLOCATE_INDIVIDUALLY(section)
ALLOCATE_INDIVIDUALLY(structure_element)
ALLOCATE_INDIVIDUALLY(tangle_target)
ALLOCATE_INDIVIDUALLY(tex_results)
ALLOCATE_INDIVIDUALLY(text_literal)
ALLOCATE_INDIVIDUALLY(theme_tag)
ALLOCATE_INDIVIDUALLY(weave_format)
ALLOCATE_INDIVIDUALLY(weave_pattern)
ALLOCATE_INDIVIDUALLY(weave_plugin)
ALLOCATE_INDIVIDUALLY(weave_order)
ALLOCATE_INDIVIDUALLY(web)
ALLOCATE_INDIVIDUALLY(writeme_asset)
Initial commit 2019-02-04 22:26:45 +00:00			`[Basics::] Basics.`

Drafted How This Program Works 2020-04-16 22:51:03 +00:00			`Some fundamental definitions, mostly declaring object types to the Foundation`
			`module.`
Initial commit 2019-02-04 22:26:45 +00:00
Drafted How This Program Works 2020-04-16 22:51:03 +00:00			`@ Every program using //foundation// must define this:`
Initial commit 2019-02-04 22:26:45 +00:00
Documented Foundation 2020-04-15 22:45:08 +00:00			`@d PROGRAM_NAME "inweb"`
Initial commit 2019-02-04 22:26:45 +00:00
Drafted How This Program Works 2020-04-16 22:51:03 +00:00			`@ We need to itemise the structures we'll want to allocate. For explanations,`
			`see //foundation: A Brief Guide to Foundation//.`
Initial commit 2019-02-04 22:26:45 +00:00
Better navigation for woven sets of pages 2020-03-19 00:03:04 +00:00			`@e breadcrumb_request_MT`
Initial commit 2019-02-04 22:26:45 +00:00			`@e chapter_MT`
Rudimentary colonies 2020-04-12 16:24:23 +00:00			`@e colony_MT`
			`@e colony_member_MT`
Cross-references to types and functions 2020-04-11 22:43:27 +00:00			`@e colouring_language_block_MT`
Experimental ACME support 2020-04-04 06:51:07 +00:00			`@e colouring_rule_MT`
Initial commit 2019-02-04 22:26:45 +00:00			`@e enumeration_set_MT`
			`@e hash_table_entry_MT`
			`@e hash_table_entry_usage_MT`
Cross-references to types and functions 2020-04-11 22:43:27 +00:00			`@e language_function_MT`
			`@e language_type_MT`
Conform to new README system 2020-03-23 21:39:27 +00:00			`@e macro_MT`
			`@e macro_tokens_MT`
Initial commit 2019-02-04 22:26:45 +00:00			`@e macro_usage_MT`
			`@e nonterminal_variable_MT`
Conform to new README system 2020-03-23 21:39:27 +00:00			`@e para_macro_MT`
Initial commit 2019-02-04 22:26:45 +00:00			`@e paragraph_MT`
			`@e paragraph_tagging_MT`
			`@e preform_nonterminal_MT`
			`@e programming_language_MT`
Tidying up of programming languages 2020-04-04 19:46:43 +00:00			`@e reserved_word_MT`
Initial commit 2019-02-04 22:26:45 +00:00			`@e section_MT`
			`@e source_line_array_MT`
			`@e structure_element_MT`
			`@e tangle_target_MT`
			`@e tex_results_MT`
			`@e text_literal_MT`
			`@e theme_tag_MT`
			`@e weave_format_MT`
			`@e weave_pattern_MT`
And equations 2020-04-10 20:29:28 +00:00			`@e weave_plugin_MT`
Drafted How This Program Works 2020-04-16 22:51:03 +00:00			`@e weave_order_MT`
Initial commit 2019-02-04 22:26:45 +00:00			`@e web_MT`
Conform to new README system 2020-03-23 21:39:27 +00:00			`@e writeme_asset_MT`
Initial commit 2019-02-04 22:26:45 +00:00
Drafted How This Program Works 2020-04-16 22:51:03 +00:00			`@ And then expand the following macros, all defined in //Memory//.`
Initial commit 2019-02-04 22:26:45 +00:00
			`=`
			`ALLOCATE_IN_ARRAYS(source_line, 1000)`
Better navigation for woven sets of pages 2020-03-19 00:03:04 +00:00			`ALLOCATE_INDIVIDUALLY(breadcrumb_request)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(chapter)`
Rudimentary colonies 2020-04-12 16:24:23 +00:00			`ALLOCATE_INDIVIDUALLY(colony)`
			`ALLOCATE_INDIVIDUALLY(colony_member)`
Cross-references to types and functions 2020-04-11 22:43:27 +00:00			`ALLOCATE_INDIVIDUALLY(colouring_language_block)`
Experimental ACME support 2020-04-04 06:51:07 +00:00			`ALLOCATE_INDIVIDUALLY(colouring_rule)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(enumeration_set)`
			`ALLOCATE_INDIVIDUALLY(hash_table_entry_usage)`
			`ALLOCATE_INDIVIDUALLY(hash_table_entry)`
Cross-references to types and functions 2020-04-11 22:43:27 +00:00			`ALLOCATE_INDIVIDUALLY(language_function)`
			`ALLOCATE_INDIVIDUALLY(language_type)`
Conform to new README system 2020-03-23 21:39:27 +00:00			`ALLOCATE_INDIVIDUALLY(macro_tokens)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(macro_usage)`
Conform to new README system 2020-03-23 21:39:27 +00:00			`ALLOCATE_INDIVIDUALLY(macro)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(nonterminal_variable)`
Conform to new README system 2020-03-23 21:39:27 +00:00			`ALLOCATE_INDIVIDUALLY(para_macro)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(paragraph_tagging)`
			`ALLOCATE_INDIVIDUALLY(paragraph)`
			`ALLOCATE_INDIVIDUALLY(preform_nonterminal)`
			`ALLOCATE_INDIVIDUALLY(programming_language)`
Tidying up of programming languages 2020-04-04 19:46:43 +00:00			`ALLOCATE_INDIVIDUALLY(reserved_word)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(section)`
			`ALLOCATE_INDIVIDUALLY(structure_element)`
			`ALLOCATE_INDIVIDUALLY(tangle_target)`
Conform to new README system 2020-03-23 21:39:27 +00:00			`ALLOCATE_INDIVIDUALLY(tex_results)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(text_literal)`
			`ALLOCATE_INDIVIDUALLY(theme_tag)`
			`ALLOCATE_INDIVIDUALLY(weave_format)`
			`ALLOCATE_INDIVIDUALLY(weave_pattern)`
And equations 2020-04-10 20:29:28 +00:00			`ALLOCATE_INDIVIDUALLY(weave_plugin)`
Drafted How This Program Works 2020-04-16 22:51:03 +00:00			`ALLOCATE_INDIVIDUALLY(weave_order)`
Initial commit 2019-02-04 22:26:45 +00:00			`ALLOCATE_INDIVIDUALLY(web)`
Conform to new README system 2020-03-23 21:39:27 +00:00			`ALLOCATE_INDIVIDUALLY(writeme_asset)`