2020-02-27 13:18:25 +02:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
2020-04-14 19:56:54 +03:00
< title > Inbuild Control< / title >
2020-05-03 03:20:55 +03:00
< link href = "../docs-assets/Breadcrumbs.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-03-19 02:11:25 +02:00
< meta name = "viewport" content = "width=device-width initial-scale=1" >
2020-02-27 13:18:25 +02:00
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
2020-05-03 03:01:21 +03:00
2020-05-03 03:20:55 +03:00
< link href = "../docs-assets/Contents.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Progress.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Navigation.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Fonts.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Base.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-05-03 03:01:21 +03:00
< script >
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
< / script >
2020-05-03 03:20:55 +03:00
< link href = "../docs-assets/Popups.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Colours.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-04-14 19:56:54 +03:00
2020-02-27 13:18:25 +02:00
< / head >
2020-05-03 03:01:21 +03:00
< body class = "commentary-font" >
2020-03-19 02:11:25 +02:00
< nav role = "navigation" >
2020-04-14 19:56:54 +03:00
< h1 > < a href = "../index.html" >
2020-05-03 18:34:53 +03:00
< img src = "../docs-assets/Inform.png" height = 72" >
2020-04-14 19:56:54 +03:00
< / a > < / h1 >
< ul > < li > < a href = "../compiler.html" > compiler tools< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../other.html" > other tools< / a > < / li >
< li > < a href = "../extensions.html" > extensions and kits< / a > < / li >
< li > < a href = "../units.html" > unit test tools< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Compiler Webs< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../inbuild/index.html" > inbuild< / a > < / li >
< li > < a href = "../inform7/index.html" > inform7< / a > < / li >
< li > < a href = "../inter/index.html" > inter< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Inbuild Modules< / h2 > < ul >
< li > < a href = "index.html" > < span class = "selectedlink" > supervisor< / span > < / a > < / li >
< / ul > < h2 > Inform7 Modules< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../core-module/index.html" > core< / a > < / li >
< li > < a href = "../inflections-module/index.html" > inflections< / a > < / li >
< li > < a href = "../linguistics-module/index.html" > linguistics< / a > < / li >
< li > < a href = "../kinds-module/index.html" > kinds< / a > < / li >
< li > < a href = "../if-module/index.html" > if< / a > < / li >
< li > < a href = "../multimedia-module/index.html" > multimedia< / a > < / li >
2020-04-14 19:56:54 +03:00
< li > < a href = "../problems-module/index.html" > problems< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../index-module/index.html" > index< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Inter Modules< / h2 > < ul >
< li > < a href = "../bytecode-module/index.html" > bytecode< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../building-module/index.html" > building< / a > < / li >
< li > < a href = "../codegen-module/index.html" > codegen< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Shared Modules< / h2 > < ul >
< li > < a href = "../arch-module/index.html" > arch< / a > < / li >
< li > < a href = "../syntax-module/index.html" > syntax< / a > < / li >
< li > < a href = "../words-module/index.html" > words< / a > < / li >
< li > < a href = "../html-module/index.html" > html< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../../../inweb/docs/foundation-module/index.html" > foundation< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul >
2020-03-19 02:11:25 +02:00
< / nav >
< main role = "main" >
2020-05-03 03:01:21 +03:00
<!-- Weave of 'Inbuild Control' generated by Inweb -->
< div class = "breadcrumbs" >
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../compiler.html" > Inbuild Modules< / a > < / li > < li > < a href = "index.html" > supervisor< / a > < / li > < li > < a href = "index.html#1" > Chapter 1: Setting Up< / a > < / li > < li > < b > Inbuild Control< / b > < / li > < / ul > < / div >
< p class = "purpose" > The top-level controller through which client tools use this module.< / p >
2020-02-27 13:18:25 +02:00
2020-04-16 01:49:59 +03:00
< ul class = "toc" > < li > < a href = "1-ic.html#SP1" > § 1. Phases< / a > < / li > < li > < a href = "1-ic.html#SP3" > § 3. Startup phase< / a > < / li > < li > < a href = "1-ic.html#SP4" > § 4. Configuration phase< / a > < / li > < li > < a href = "1-ic.html#SP9" > § 9. The Pretinkering, Tinkering, Nested and Projected phases< / a > < / li > < li > < a href = "1-ic.html#SP11" > § 11. The Graph Construction and Operational phases< / a > < / li > < li > < a href = "1-ic.html#SP12" > § 12. The nest list< / a > < / li > < li > < a href = "1-ic.html#SP17" > § 17. The shared project< / a > < / li > < li > < a href = "1-ic.html#SP22" > § 22. Kit requests< / a > < / li > < li > < a href = "1-ic.html#SP23" > § 23. Access to unmanaged Inform resources< / a > < / li > < / ul > < hr class = "tocbar" >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP1" > < / a > < b > § 1. Phases. < / b > The < span class = "extract" > < span class = "extract-syntax" > supervisor< / span > < / span > module provides services to whichever program is using it:
recall that the module is included both in < span class = "extract" > < span class = "extract-syntax" > inform7< / span > < / span > and in < span class = "extract" > < span class = "extract-syntax" > inbuild< / span > < / span > (the
2020-03-28 15:00:08 +02:00
command line tool), so either of those might be what we call "the client".
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > This section defines how the client communicates with us to get everything
2020-03-28 15:00:08 +02:00
set up correctly. Although nothing at all clever happens in this code, it
requires careful sequencing to avoid invisible errors coming in because
function X assumes that function Y has already been called, or perhaos that
2020-05-03 03:01:21 +03:00
it never will be again. The < span class = "extract" > < span class = "extract-syntax" > supervisor< / span > < / span > module therefore runs through a
2020-03-28 15:00:08 +02:00
number of named "phases" on its way to reaching fully-operational status,
at which time the client can freely use its facilities.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "definitions code-font" > < span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > STARTUP_INBUILD_PHASE< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > 1< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > PRETINKERING_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > TINKERING_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > PROJECTED_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > TARGETED_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > GRAPH_CONSTRUCTION_INBUILD_PHASE< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > OPERATIONAL_INBUILD_PHASE< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2" > < / a > < b > § 2. < / b > We're going to use the following assertions to make sure we don't slip up.
2020-03-28 15:00:08 +02:00
Some functions run only in some phases. Phases can be skipped, but not taken
out of turn.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "definitions code-font" > < span class = "definition-keyword" > define< / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "too soon"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > > < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "too late"< / span > < span class = "plain-syntax" > );< / span >
< span class = "definition-keyword" > define< / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "too soon"< / span > < span class = "plain-syntax" > );< / span >
< span class = "definition-keyword" > define< / span > < span class = "identifier-syntax" > RUN_ONLY_BEFORE_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > > = < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "too late"< / span > < span class = "plain-syntax" > );< / span >
< / pre >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > STARTUP_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::enter_phase< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > < = < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "phases out of sequence"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP3" > < / a > < b > § 3. Startup phase. < / b > The following is called when the < span class = "extract" > < span class = "extract-syntax" > supervisor< / span > < / span > module starts up.
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > extension_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kit_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > language_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pipeline_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > project_bundle_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > project_file_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_genre< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > template_genre< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::start< / span > < button class = "popup" onclick = "togglePopup('usagePopup1')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup1" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::start< / span > < / span > :< br / > Supervisor Module - < a href = "1-sm.html#SP3" > § 3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "4-em.html#SP2" class = "function-link" > < span class = "function-syntax" > ExtensionManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "4-km.html#SP1" class = "function-link" > < span class = "function-syntax" > KitManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "4-lm.html#SP1" class = "function-link" > < span class = "function-syntax" > LanguageManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "4-pm.html#SP1" class = "function-link" > < span class = "function-syntax" > PipelineManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "4-pbm.html#SP1" class = "function-link" > < span class = "function-syntax" > ProjectBundleManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "4-pfm.html#SP1" class = "function-link" > < span class = "function-syntax" > ProjectFileManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "4-tm.html#SP1" class = "function-link" > < span class = "function-syntax" > TemplateManager::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "3-is.html#SP1" class = "function-link" > < span class = "function-syntax" > InterSkill::create< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "3-is2.html#SP1" class = "function-link" > < span class = "function-syntax" > Inform7Skill::create< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "3-is3.html#SP1" class = "function-link" > < span class = "function-syntax" > Inform6Skill::create< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "3-is4.html#SP1" class = "function-link" > < span class = "function-syntax" > InblorbSkill::create< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "6-cs.html#SP3" class = "function-link" > < span class = "function-syntax" > ControlStructures::create_standard< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP5" class = "function-link" > < span class = "function-syntax" > Supervisor::set_defaults< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP4" > < / a > < b > § 4. Configuration phase. < / b > Initially, then, we are in the configuration phase. When the client defines
2020-05-03 18:34:53 +03:00
its command-line options, we expect it to call < span class = "extract" > < span class = "extract-syntax" > Supervisor::declare_options< / span > < / span >
2020-03-28 15:00:08 +02:00
so that we can define further options — this provides the large set of
2020-05-03 03:01:21 +03:00
common options found in both < span class = "extract" > < span class = "extract-syntax" > inform7< / span > < / span > and < span class = "extract" > < span class = "extract-syntax" > inbuild< / span > < / span > , our two possible clients.
2020-03-28 15:00:08 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::declare_options< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP4_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Declare Inform-related options< / span > < span class = "named-paragraph-number" > 4.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP4_4" class = "named-paragraph-link" > < span class = "named-paragraph" > Declare resource-related options< / span > < span class = "named-paragraph-number" > 4.4< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP4_6" class = "named-paragraph-link" > < span class = "named-paragraph" > Declare Inter-related options< / span > < span class = "named-paragraph-number" > 4.6< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP4_1" > < / a > < b > § 4.1. < / b > These options all predate the 2015-20 reworking of the compiler, and their
names are a series of historical accidents. < span class = "extract" > < span class = "extract-syntax" > -format< / span > < / span > in particular works in
2020-03-28 15:00:08 +02:00
a clunky sort of way and should perhaps be deprecated in favour of some
better way to choose a virtual machine to compile to.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "definitions code-font" > < span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INBUILD_INFORM_CLSG< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > PROJECT_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > DEBUG_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > RELEASE_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > FORMAT_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > SOURCE_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > CENSUS_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > RNG_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > CASE_CLSW< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP4_2" > < / a > < b > § 4.2. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Declare Inform-related options< / span > < span class = "named-paragraph-number" > 4.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::begin_group< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > INBUILD_INFORM_CLSG< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "for translating Inform source text to Inter"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PROJECT_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "project"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "work within the Inform project X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_boolean_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > DEBUG_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "debug"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 1< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "compile with debugging features even on a Release"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_boolean_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > RELEASE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "release"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 1< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "compile a version suitable for a Release build"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_textual_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > FORMAT_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "format"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 1< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "compile I6 code suitable for the virtual machine X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > SOURCE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "source"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "use file X as the Inform source text"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_boolean_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CENSUS_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "census"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 1< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "perform an extensions census"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_boolean_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > RNG_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "rng"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 1< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "fix the random number generator of the story file (for testing)"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CASE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "case"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "make any source links refer to the source in extension example X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::end_group< / span > < span class = "plain-syntax" > ();< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP4" > § 4< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP4_3" > < / a > < b > § 4.3. < / b > Again, except for < span class = "extract" > < span class = "extract-syntax" > -nest< / span > < / span > , these go back to the mid-2010s.
< / p >
< pre class = "definitions code-font" > < span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INBUILD_RESOURCES_CLSG< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > NEST_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INTERNAL_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > EXTERNAL_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > TRANSIENT_CLSW< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP4_4" > < / a > < b > § 4.4. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Declare resource-related options< / span > < span class = "named-paragraph-number" > 4.4< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::begin_group< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > INBUILD_RESOURCES_CLSG< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "for locating resources in the file system"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NEST_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "nest"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "add the nest at pathname X to the search list"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > INTERNAL_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "internal"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "use X as the location of built-in material such as the Standard Rules"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > EXTERNAL_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "external"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "use X as the user's home for installed material such as extensions"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TRANSIENT_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "transient"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "use X for transient data such as the extensions census"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::end_group< / span > < span class = "plain-syntax" > ();< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP4" > § 4< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP4_5" > < / a > < b > § 4.5. < / b > These are all new in 2020. They are not formally shared with the < span class = "extract" > < span class = "extract-syntax" > inter< / span > < / span > tool,
but < span class = "extract" > < span class = "extract-syntax" > -pipeline-file< / span > < / span > and < span class = "extract" > < span class = "extract-syntax" > -variable< / span > < / span > have the same effect as they would there.
< / p >
< pre class = "definitions code-font" > < span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INBUILD_INTER_CLSG< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > KIT_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > PIPELINE_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > PIPELINE_FILE_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > PIPELINE_VARIABLE_CLSW< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP4_6" > < / a > < b > § 4.6. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Declare Inter-related options< / span > < span class = "named-paragraph-number" > 4.6< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::begin_group< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > INBUILD_INTER_CLSG< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "for tweaking code generation from Inter"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > KIT_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "kit"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "include Inter code from the kit called X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PIPELINE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "pipeline"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "specify code-generation pipeline by name (default is \"compile\")"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PIPELINE_FILE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "pipeline-file"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "specify code-generation pipeline as file X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::declare_switch< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PIPELINE_VARIABLE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "variable"< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > 2< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "set pipeline variable X (in form name=value)"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::end_group< / span > < span class = "plain-syntax" > ();< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP4" > § 4< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP5" > < / a > < b > § 5. < / b > Use of the above options will cause the following global variables to be
2020-03-28 15:00:08 +02:00
set appropriately.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > inter_pipeline_file< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "identifier-syntax" > dictionary< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pipeline_vars< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > shared_transient_resources< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > this_is_a_debug_compile< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > Destined to be compiled with debug features< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > this_is_a_release_compile< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > Omit sections of source text marked not for release< / span >
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > story_filename_extension< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > What story file we will eventually have< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > census_mode< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > Running only to update extension documentation< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > rng_seed_at_start_of_play< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > The seed value, or 0 if not seeded< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::set_defaults< / span > < button class = "popup" onclick = "togglePopup('usagePopup2')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup2" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::set_defaults< / span > < / span > :< br / > < a href = "1-ic.html#SP3" > § 3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > ifdef< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CODEGEN_MODULE< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pipeline_vars< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > CodeGen::Pipeline::basic_dictionary< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "output.ulx"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > endif< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP6" class = "function-link" > < span class = "function-syntax" > Supervisor::set_inter_pipeline< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "compile"< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP6" > < / a > < b > § 6. < / b > The pipeline name can be set not only here but also by < span class = "extract" > < span class = "extract-syntax" > inform7< / span > < / span > much
2020-03-28 15:00:08 +02:00
later on (way past the configuration stage), if it reads a sentence like:
< / p >
< blockquote >
< p > Use inter pipeline "special".< / p >
< / blockquote >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > inter_pipeline_name< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-03-28 15:00:08 +02:00
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::set_inter_pipeline< / span > < button class = "popup" onclick = "togglePopup('usagePopup3')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup3" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::set_inter_pipeline< / span > < / span > :< br / > < a href = "1-ic.html#SP5" > § 5< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_pipeline_name< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > inter_pipeline_name< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::new< / span > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Str::clear< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_pipeline_name< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_pipeline_name< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%S"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP7" > < / a > < b > § 7. < / b > < span class = "extract" > < span class = "extract-syntax" > inform7< / span > < / span > needs to know this:
2020-03-28 15:00:08 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::currently_releasing< / span > < button class = "popup" onclick = "togglePopup('usagePopup4')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup4" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::currently_releasing< / span > < / span > :< br / > Headings - < a href = "6-hdn.html#SP18" > § 18< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > this_is_a_release_compile< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP8" > < / a > < b > § 8. < / b > The < span class = "extract" > < span class = "extract-syntax" > supervisor< / span > < / span > module itself doesn't parse command-line options: that's for
2020-03-28 15:00:08 +02:00
the client to do, using code from Foundation. When the client finds an option
it doesn't know about, that will be one of ourse, so it should call the following:
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::option< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > state< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > switch< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DEBUG_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > this_is_a_debug_compile< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > ; < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > FORMAT_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > story_filename_extension< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::duplicate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RELEASE_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > this_is_a_release_compile< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > ; < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NEST_CLSW:< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP13" class = "function-link" > < span class = "function-syntax" > Supervisor::add_nest< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ), < / span > < span class = "constant-syntax" > GENERIC_NEST_TAG< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > INTERNAL_CLSW:< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP13" class = "function-link" > < span class = "function-syntax" > Supervisor::add_nest< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ), < / span > < span class = "constant-syntax" > INTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > EXTERNAL_CLSW:< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP13" class = "function-link" > < span class = "function-syntax" > Supervisor::add_nest< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ), < / span > < span class = "constant-syntax" > EXTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TRANSIENT_CLSW:< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_transient_resources< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > KIT_CLSW:< / span > < span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP22" class = "function-link" > < span class = "function-syntax" > Supervisor::request_kit< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > PROJECT_CLSW:< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "1-ic.html#SP18" class = "function-link" > < span class = "function-syntax" > Supervisor::set_I7_bundle< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > )< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Errors::fatal_with_text< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "can't specify the project twice: '%S'"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > SOURCE_CLSW:< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "1-ic.html#SP17" class = "function-link" > < span class = "function-syntax" > Supervisor::set_I7_source< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > )< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Errors::fatal_with_text< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "can't specify the source file twice: '%S'"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CENSUS_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > census_mode< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > ; < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > PIPELINE_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_pipeline_name< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::duplicate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > PIPELINE_FILE_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_pipeline_file< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Filenames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > PIPELINE_VARIABLE_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP8_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Set a pipeline variable< / span > < span class = "named-paragraph-number" > 8.1< / span > < / a > < / span > < span class = "plain-syntax" > ; < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RNG_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP8_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Seed the random number generator< / span > < span class = "named-paragraph-number" > 8.2< / span > < / a > < / span > < span class = "plain-syntax" > ; < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CASE_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTMLFiles::set_source_link_case< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP8_1" > < / a > < b > § 8.1. < / b > Note that the following has no effect unless the < span class = "extract" > < span class = "extract-syntax" > codegen< / span > < / span > module is part
of the client. In practice, that will be true for < span class = "extract" > < span class = "extract-syntax" > inform7< / span > < / span > but not < span class = "extract" > < span class = "extract-syntax" > inbuild< / span > < / span > .
< / p >
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Set a pipeline variable< / span > < span class = "named-paragraph-number" > 8.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > match_results< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Regexp::create_mr< / span > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Regexp::match< / span > < span class = "plain-syntax" > (& < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "(%c+)=(%c+)"< / span > < span class = "plain-syntax" > )) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::get_first_char< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ) != < / span > < span class = "character-syntax" > '*'< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Errors::fatal< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "-variable names must begin with '*'"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > {< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > ifdef< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CODEGEN_MODULE< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Str::copy< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Dictionaries::create_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pipeline_vars< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > .< / span > < span class = "identifier-syntax" > exp< / span > < span class = "plain-syntax" > [0]), < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > .< / span > < span class = "identifier-syntax" > exp< / span > < span class = "plain-syntax" > [1]);< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > endif< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Errors::fatal< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "-variable should take the form 'name=value'"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Regexp::dispose_of< / span > < span class = "plain-syntax" > (& < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > );< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP8" > § 8< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP8_2" > < / a > < b > § 8.2. < / b > 16339 is a well-known prime number for use in 16-bit random number algorithms,
2020-03-28 15:00:08 +02:00
such as the one used in the Z-machine VM. It works fine in 32-bit cases too.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Seed the random number generator< / span > < span class = "named-paragraph-number" > 8.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > val< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > rng_seed_at_start_of_play< / span > < span class = "plain-syntax" > = -16339;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > rng_seed_at_start_of_play< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ;< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP8" > § 8< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP9" > < / a > < b > § 9. The Pretinkering, Tinkering, Nested and Projected phases. < / b > Once the tool has finished with the command line, it should call this
2020-02-27 13:18:25 +02:00
function. Inbuild rapidly runs through the next few phases as it does so.
From the "nested" phase, the final list of nests in the search path for
finding kits, extensions and so on exists; from the "projected" phase,
2020-03-28 15:00:08 +02:00
the main Inform project (if there is one) exists.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > Recall that Inbuild does not need to be dealing with an Inform 7 project
2020-03-28 15:00:08 +02:00
as a target, but that if it is, then it is the only such. We call this
the "shared project". There will be lots of other copies known to Inbuild —
all the kits and extensions needed to build the shared project — but only
one project.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > The client should set < span class = "extract" > < span class = "extract-syntax" > compile_only< / span > < / span > if it just wants to make a basic,
non-incremental compilation of the project. In practice, < span class = "extract" > < span class = "extract-syntax" > inform7< / span > < / span > wants
that but < span class = "extract" > < span class = "extract-syntax" > inbuild< / span > < / span > does not.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > When this call returns to the client, < span class = "extract" > < span class = "extract-syntax" > inbuild< / span > < / span > is in the Targeted phase,
2020-05-03 18:34:53 +03:00
which continues until the client calls < span class = "extract" > < span class = "extract-syntax" > Supervisor::go_operational< / span > < / span > (see below).
2020-03-11 02:21:09 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > inbuild_copy< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::optioneering_complete< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > inbuild_copy< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > compile_only< / span > < span class = "plain-syntax" > ,< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > (*< / span > < span class = "identifier-syntax" > preform_callback< / span > < span class = "plain-syntax" > )(< / span > < span class = "reserved-syntax" > inform_language< / span > < span class = "plain-syntax" > *)) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > PRETINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP9_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Find the virtual machine< / span > < span class = "named-paragraph-number" > 9.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inform_project< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP19" class = "function-link" > < span class = "function-syntax" > Supervisor::create_shared_project< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > );< / span >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP14" class = "function-link" > < span class = "function-syntax" > Supervisor::sort_nest_list< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP9_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Read the definition of the natural language of syntax< / span > < span class = "named-paragraph-number" > 9.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP22" class = "function-link" > < span class = "function-syntax" > Supervisor::pass_kit_requests< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "2-cps.html#SP7" class = "function-link" > < span class = "function-syntax" > Copies::get_source_text< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > as_copy< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > PROJECTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > )< / span >
2020-05-05 01:34:55 +03:00
< span class = "plain-syntax" > < / span > < a href = "5-ps2.html#SP12" class = "function-link" > < span class = "function-syntax" > Projects::construct_build_target< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > ,< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP10" class = "function-link" > < span class = "function-syntax" > Supervisor::current_vm< / span > < / a > < span class = "plain-syntax" > (), < / span > < span class = "identifier-syntax" > this_is_a_release_compile< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > compile_only< / span > < span class = "plain-syntax" > );< / span >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > TARGETED_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > as_copy< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP9_1" > < / a > < b > § 9.1. < / b > The VM to be used depends on the settings of all three of < span class = "extract" > < span class = "extract-syntax" > -format< / span > < / span > ,
< span class = "extract" > < span class = "extract-syntax" > -release< / span > < / span > and < span class = "extract" > < span class = "extract-syntax" > -debug< / span > < / span > , and those can be given in any order at the command
2020-03-28 15:00:08 +02:00
line, which is why we couldn't work this out earlier:
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Find the virtual machine< / span > < span class = "named-paragraph-number" > 9.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-03-28 15:00:08 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > ext< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > story_filename_extension< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ext< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > ext< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "ulx"< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > with_debugging< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > this_is_a_release_compile< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > this_is_a_debug_compile< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > with_debugging< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP10" class = "function-link" > < span class = "function-syntax" > Supervisor::set_current_vm< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > TargetVMs::find< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ext< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > with_debugging< / span > < span class = "plain-syntax" > ));< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP9" > § 9< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP9_2" > < / a > < b > § 9.2. < / b > The "language of syntax" of a project is the natural language, by default
2020-03-28 15:00:08 +02:00
English, in which its source text is written.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > We scan the available natural languages first. To do that it's sufficient to
2020-03-28 15:00:08 +02:00
generate a list of search results for all possible languages: each as it
comes to light will have been recorded as a possibility. We can then simply
ignore the search results. Note that this can only be done in the Nested
phase or after, because we need the nests in order to perform a search.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > Once that's done, we ask the client to load the Preform grammar for the
2020-03-28 15:00:08 +02:00
language of the project. For now that's always English, but here is where
we would attempt to detect the language of syntax if we could.
< / p >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Read the definition of the natural language of syntax< / span > < span class = "named-paragraph-number" > 9.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inbuild_requirement< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > = < / span > < a href = "2-rqr.html#SP2" class = "function-link" > < span class = "function-syntax" > Requirements::anything_of_genre< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > language_genre< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > L< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > inbuild_search_result< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < a href = "2-nst.html#SP7" class = "function-link" > < span class = "function-syntax" > Nests::search_for< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > , < / span > < a href = "1-ic.html#SP15" class = "function-link" > < span class = "function-syntax" > Supervisor::nest_list< / span > < / a > < span class = "plain-syntax" > (), < / span > < span class = "identifier-syntax" > L< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-05 01:34:55 +03:00
< span class = "plain-syntax" > < / span > < a href = "5-ps2.html#SP3" class = "function-link" > < span class = "function-syntax" > Projects::set_to_English< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > (*< / span > < span class = "identifier-syntax" > preform_callback< / span > < span class = "plain-syntax" > )(< / span > < a href = "5-ps2.html#SP6" class = "function-link" > < span class = "function-syntax" > Projects::get_language_of_syntax< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project< / span > < span class = "plain-syntax" > ));< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > {< / span >
2020-05-04 23:48:54 +03:00
< span class = "plain-syntax" > (*< / span > < span class = "identifier-syntax" > preform_callback< / span > < span class = "plain-syntax" > )(< / span > < a href = "5-ls.html#SP9" class = "function-link" > < span class = "function-syntax" > Languages::internal_English< / span > < / a > < span class = "plain-syntax" > ());< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP9" > § 9< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP10" > < / a > < b > § 10. < / b > < / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > target_vm< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > current_target_VM< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "identifier-syntax" > target_vm< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::current_vm< / span > < button class = "popup" onclick = "togglePopup('usagePopup5')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup5" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::current_vm< / span > < / span > :< br / > < a href = "1-ic.html#SP9" > § 9< / a > < br / > Headings - < a href = "6-hdn.html#SP14" > § 14< / a > < br / > Inclusions - < a href = "6-inc.html#SP6_1" > § 6.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > current_target_VM< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::set_current_vm< / span > < button class = "popup" onclick = "togglePopup('usagePopup6')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup6" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::set_current_vm< / span > < / span > :< br / > < a href = "1-ic.html#SP9_1" > § 9.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > target_vm< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PRETINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > current_target_VM< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP11" > < / a > < b > § 11. The Graph Construction and Operational phases. < / b > < span class = "extract" > < span class = "extract-syntax" > inbuild< / span > < / span > is now in the Targeted phase, then, meaning that the client has
2020-05-03 18:34:53 +03:00
called < span class = "extract" > < span class = "extract-syntax" > Supervisor::optioneering_complete< / span > < / span > and has been making further
2020-03-28 15:00:08 +02:00
preparations of its own. (For example, it could attach further kit
dependencies to the shared project.) The client has one further duty to
2020-05-03 18:34:53 +03:00
perform: to call < span class = "extract" > < span class = "extract-syntax" > Supervisor::go_operational< / span > < / span > . After that, everything is ready
2020-03-28 15:00:08 +02:00
for use.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > The brief "graph construction" phase is used to build out dependency graphs.
2020-03-31 02:17:21 +03:00
We do that copy by copy. The shared project, if there is one, goes first;
then everything else known to us.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > inform_project< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::go_operational< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TARGETED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > GRAPH_CONSTRUCTION_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inform_project< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP20" class = "function-link" > < span class = "function-syntax" > Supervisor::project< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > ) < / span > < a href = "2-cps.html#SP8" class = "function-link" > < span class = "function-syntax" > Copies::construct_graph< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > as_copy< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inbuild_copy< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_copy< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > != < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > as_copy< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < a href = "2-cps.html#SP8" class = "function-link" > < span class = "function-syntax" > Copies::construct_graph< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inbuild_phase< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > OPERATIONAL_INBUILD_PHASE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > census_mode< / span > < span class = "plain-syntax" > ) < / span > < a href = "7-ec.html#SP11" class = "function-link" > < span class = "function-syntax" > Extensions::Census::handle_census_mode< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < a href = "1-ic.html#SP20" class = "function-link" > < span class = "function-syntax" > Supervisor::project< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP12" > < / a > < b > § 12. The nest list. < / b > Nests are directories which hold resources to be used by the Intools, and
2020-02-27 13:18:25 +02:00
one of Inbuild's main roles is to search and manage nests. All nests can
hold extensions, kits, language definitions, and so on.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > But among nests three are special, and can hold other things as well.
2020-02-27 13:18:25 +02:00
< / p >
< ul class = "items" > < li > (a) The "internal" nest is part of the installation of Inform as software.
It contains, for example, the build-in extensions. But it also contains
miscellaneous other files needed by Infomr (see below).
2020-05-03 03:01:21 +03:00
< / li > < li > (b) The "external" nest is the one to which the user installs her own
2020-02-27 13:18:25 +02:00
selection of extensions, and so on. On most platforms, the external nest
is also the default home of "transient" storage, for more ephemeral content,
such as the mechanically generated extension documentation. Some mobile
operating systems are aggressive about wanting to delete ephemeral files
2020-05-03 03:01:21 +03:00
used by applications, so < span class = "extract" > < span class = "extract-syntax" > -transient< / span > < / span > can be used to divert these.
< / li > < li > (c) Every project has its own private nest, in the form of its associated
Materials folder. For example, in < span class = "extract" > < span class = "extract-syntax" > Jane Eyre.inform< / span > < / span > is a project, then
alongside it is < span class = "extract" > < span class = "extract-syntax" > Jane Eyre.materials< / span > < / span > and this is a nest.
2020-02-27 13:18:25 +02:00
< / li > < / ul >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP13" > < / a > < b > § 13. < / b > Inform customarily has exactly one < span class = "extract" > < span class = "extract-syntax" > -internal< / span > < / span > and one < span class = "extract" > < span class = "extract-syntax" > -external< / span > < / span > nest,
2020-02-27 13:18:25 +02:00
but in fact any number of each are allowed, including none. However, the
first to be declared are used by the compiler as "the" internal and external
nests, respectively.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > The following hold the nests in declaration order.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > shared_internal_nest< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-02-27 13:18:25 +02:00
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::add_nest< / span > < button class = "popup" onclick = "togglePopup('usagePopup7')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup7" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::add_nest< / span > < / span > :< br / > < a href = "1-ic.html#SP8" > § 8< / a > , < a href = "1-ic.html#SP19_1" > § 19.1< / a > , < a href = "1-ic.html#SP19_2" > § 19.2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > tag< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_BEFORE_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > = < / span > < a href = "2-nst.html#SP1" class = "function-link" > < span class = "function-syntax" > Nests::new< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-nst.html#SP2" class = "function-link" > < span class = "function-syntax" > Nests::set_tag< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > tag< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > tag< / span > < span class = "plain-syntax" > == < / span > < span class = "constant-syntax" > EXTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > tag< / span > < span class = "plain-syntax" > == < / span > < span class = "constant-syntax" > INTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > shared_internal_nest< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_internal_nest< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > tag< / span > < span class = "plain-syntax" > == < / span > < span class = "constant-syntax" > INTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > ) < / span > < a href = "2-nst.html#SP3" class = "function-link" > < span class = "function-syntax" > Nests::protect< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP14" > < / a > < b > § 14. < / b > It is then sorted in tag order. This is so that if we look for, say, an
2020-02-27 13:18:25 +02:00
extension with a given name, then results in a project's materials folder
are given precedence over those in the external folder, and so on.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::sort_nest_list< / span > < button class = "popup" onclick = "togglePopup('usagePopup8')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup8" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::sort_nest_list< / span > < / span > :< br / > < a href = "1-ic.html#SP9" > § 9< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "2-nst.html#SP2" class = "function-link" > < span class = "function-syntax" > Nests::get_tag< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > MATERIALS_NEST_TAG< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "2-nst.html#SP2" class = "function-link" > < span class = "function-syntax" > Nests::get_tag< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > EXTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "2-nst.html#SP2" class = "function-link" > < span class = "function-syntax" > Nests::get_tag< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > GENERIC_NEST_TAG< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > unsorted_nest_list< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "2-nst.html#SP2" class = "function-link" > < span class = "function-syntax" > Nests::get_tag< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > INTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > N< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP15" > < / a > < b > § 15. < / b > And the rest of Inform or Inbuild can now use:
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-05 01:34:55 +03:00
< span class = "identifier-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::nest_list< / span > < button class = "popup" onclick = "togglePopup('usagePopup9')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup9" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::nest_list< / span > < / span > :< br / > < a href = "1-ic.html#SP9_2" > § 9.2< / a > < br / > Inter Skill - < a href = "3-is.html#SP3" > § 3< / a > , < a href = "3-is.html#SP4" > § 4< / a > < br / > Kit Services - < a href = "5-ks.html#SP12" > § 12< / a > , < a href = "5-ks.html#SP13_1" > § 13.1< / a > < br / > Project Services - < a href = "5-ps2.html#SP9" > § 9< / a > , < a href = "5-ps2.html#SP12" > § 12< / a > < br / > Inclusions - < a href = "6-inc.html#SP6_1" > § 6.1< / a > , < a href = "6-inc.html#SP6_1_2" > § 6.1.2< / a > < br / > Extension Documentation - < a href = "7-ed2.html#SP4" > § 4< / a > < br / > Extension Census - < a href = "7-ec.html#SP1" > § 1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "nest list never sorted"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_nest_list< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-05-04 23:48:54 +03:00
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::internal< / span > < button class = "popup" onclick = "togglePopup('usagePopup10')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup10" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::internal< / span > < / span > :< br / > < a href = "1-ic.html#SP23" > § 23< / a > < br / > Language Services - < a href = "5-ls.html#SP9" > § 9< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_internal_nest< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-05-05 01:34:55 +03:00
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::external< / span > < button class = "popup" onclick = "togglePopup('usagePopup11')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup11" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::external< / span > < / span > :< br / > Project Services - < a href = "5-ps2.html#SP13" > § 13< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-05-03 18:34:53 +03:00
< span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::materials< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::materials_nest< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP16" > < / a > < b > § 16. < / b > As noted above, the transient area is used for ephemera such as dynamically
written documentation and telemetry files. < span class = "extract" > < span class = "extract-syntax" > -transient< / span > < / span > sets it, but otherwise
2020-02-27 13:18:25 +02:00
the external nest is used.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-05 01:34:55 +03:00
< span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::transient< / span > < button class = "popup" onclick = "togglePopup('usagePopup12')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup12" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::transient< / span > < / span > :< br / > Project Services - < a href = "5-ps2.html#SP9" > § 9< / a > < br / > Extension Dictionary - < a href = "7-ed.html#SP11" > § 11< / a > < br / > Extension Documentation - < a href = "7-ed2.html#SP3" > § 3< / a > < br / > Extension Census - < a href = "7-ec.html#SP15" > § 15< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PROJECTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_transient_resources< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_transient_resources< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP17" > < / a > < b > § 17. The shared project. < / b > In any single run, each of the Inform tools concerns itself with a single
2020-02-27 13:18:25 +02:00
Inform 7 program. This can be presented to it either in a project bundle
(a directory which contains source, settings, space for an index and for
temporary build files), or as a single file (just a text file containing
source text).
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > It is also possible o set a folder to be the project bundle, and nevertheless
2020-02-27 13:18:25 +02:00
specify a file somewhere else to be the source text. What you can't do is
specify the bundle twice, or specify the file twice.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > project_bundle_request< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > project_file_request< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-02-27 13:18:25 +02:00
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::set_I7_source< / span > < button class = "popup" onclick = "togglePopup('usagePopup13')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup13" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::set_I7_source< / span > < / span > :< br / > < a href = "1-ic.html#SP8" > § 8< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > loc< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_file_request< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > project_file_request< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::duplicate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > loc< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-03-28 15:00:08 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP18" > < / a > < b > § 18. < / b > If we are given a < span class = "extract" > < span class = "extract-syntax" > -project< / span > < / span > on the command line, we can then work out
2020-03-28 15:00:08 +02:00
where its Materials folder is, and therefore where any expert settings files
would be. Note that the name of the expert settings file depends on the name
2020-05-03 03:01:21 +03:00
of the client, i.e., it will be < span class = "extract" > < span class = "extract-syntax" > inform7-settings.txt< / span > < / span > or < span class = "extract" > < span class = "extract-syntax" > inbuild-settings.txt< / span > < / span >
2020-03-28 15:00:08 +02:00
depending on who's asking.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::set_I7_bundle< / span > < button class = "popup" onclick = "togglePopup('usagePopup14')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup14" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::set_I7_bundle< / span > < / span > :< br / > < a href = "1-ic.html#SP8" > § 8< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > loc< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_bundle_request< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > project_bundle_request< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::duplicate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > loc< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_bundle_request< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP21" class = "function-link" > < span class = "function-syntax" > Supervisor::pathname_of_materials< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%s-settings.txt"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > PROGRAM_NAME< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > expert_settings< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > TextFiles::exists< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > expert_settings< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CommandLine::also_read_file< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > expert_settings< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP19" > < / a > < b > § 19. < / b > If a bundle is found, then by default the source text within it is called
< span class = "extract" > < span class = "extract-syntax" > story.ni< / span > < / span > . The < span class = "extract" > < span class = "extract-syntax" > .ni< / span > < / span > is an anachronism now, but at one time stood for
2020-02-27 13:18:25 +02:00
"natural Inform", the working title for Inform 7 in the early 2000s.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > inform_project< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > inform_project< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::create_shared_project< / span > < button class = "popup" onclick = "togglePopup('usagePopup15')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup15" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::create_shared_project< / span > < / span > :< br / > < a href = "1-ic.html#SP9" > § 9< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > inbuild_copy< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > PRETINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_bundle_request< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_bundle_request< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_file_request< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Filenames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_file_request< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location_if_path< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location_if_file< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > =< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Source"< / span > < span class = "plain-syntax" > ),< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "story.ni"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > = < / span > < a href = "4-pbm.html#SP3" class = "function-link" > < span class = "function-syntax" > ProjectBundleManager::claim_folder_as_copy< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > = < / span > < a href = "4-pbm.html#SP2" class = "function-link" > < span class = "function-syntax" > ProjectBundleManager::from_copy< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > = < / span > < a href = "4-pfm.html#SP3" class = "function-link" > < span class = "function-syntax" > ProjectFileManager::claim_file_as_copy< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > = < / span > < a href = "4-pfm.html#SP2" class = "function-link" > < span class = "function-syntax" > ProjectFileManager::from_copy< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP19_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Create the default externals nest< / span > < span class = "named-paragraph-number" > 19.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-ic.html#SP19_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Create the materials nest< / span > < span class = "named-paragraph-number" > 19.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = (< / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > )?(< / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location< / span > < span class = "plain-syntax" > ):< / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Source"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > project_file_request< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-05 01:34:55 +03:00
< span class = "plain-syntax" > < / span > < a href = "5-ps2.html#SP9" class = "function-link" > < span class = "function-syntax" > Projects::set_source_filename< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > rng_seed_at_start_of_play< / span > < span class = "plain-syntax" > != < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > )< / span >
2020-05-05 01:34:55 +03:00
< span class = "plain-syntax" > < / span > < a href = "5-ps2.html#SP7" class = "function-link" > < span class = "function-syntax" > Projects::fix_rng< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > rng_seed_at_start_of_play< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP19_1" > < / a > < b > § 19.1. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Create the default externals nest< / span > < span class = "named-paragraph-number" > 19.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > E< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > shared_external_nest< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > E< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > home_path< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > char< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > subfolder_within< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > INFORM_FOLDER_RELATIVE_TO_HOME< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > subfolder_within< / span > < span class = "plain-syntax" > [0]) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > SF< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > SF< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%s"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > subfolder_within< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > home_path< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > SF< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > SF< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Inform"< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > E< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP13" class = "function-link" > < span class = "function-syntax" > Supervisor::add_nest< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > EXTERNAL_NEST_TAG< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP19" > § 19< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP19_2" > < / a > < b > § 19.2. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Create the materials nest< / span > < span class = "named-paragraph-number" > 19.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP21" class = "function-link" > < span class = "function-syntax" > Supervisor::pathname_of_materials< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Pathnames::create_in_file_system< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > filename_of_i7_source< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::from_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "inform.materials"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 18:34:53 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_materials_nest< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP13" class = "function-link" > < span class = "function-syntax" > Supervisor::add_nest< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > MATERIALS_NEST_TAG< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-ic.html#SP19" > § 19< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP20" > < / a > < b > § 20. < / b > And the rest of Inform or Inbuild can now use:
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > inform_project< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::project< / span > < button class = "popup" onclick = "togglePopup('usagePopup16')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup16" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::project< / span > < / span > :< br / > < a href = "1-ic.html#SP11" > § 11< / a > < br / > Inter Skill - < a href = "3-is.html#SP4" > § 4< / a > < br / > Extension Services - < a href = "5-es.html#SP3_2" > § 3.2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_FROM_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TINKERING_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP21" > < / a > < b > § 21. < / b > The materials folder sits alongside the project folder and has the same name,
but ending < span class = "extract" > < span class = "extract-syntax" > .materials< / span > < / span > instead of < span class = "extract" > < span class = "extract-syntax" > .inform< / span > < / span > .
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::pathname_of_materials< / span > < button class = "popup" onclick = "togglePopup('usagePopup17')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup17" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::pathname_of_materials< / span > < / span > :< br / > < a href = "1-ic.html#SP18" > § 18< / a > , < a href = "1-ic.html#SP19_2" > § 19.2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%S"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Pathnames::directory_name< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > ));< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > )-1;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > while< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > > 0) & & (< / span > < span class = "identifier-syntax" > Str::get_at< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ) != < / span > < span class = "character-syntax" > '.'< / span > < span class = "plain-syntax" > )) < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > --;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > > 0) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Str::truncate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > ".materials"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Pathnames::up< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pathname_of_bundle< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mf< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > materials< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP22" > < / a > < b > § 22. Kit requests. < / b > These are triggered by, for example, < span class = "extract" > < span class = "extract-syntax" > -kit MyFancyKit< / span > < / span > at the command line.
2020-02-27 13:18:25 +02:00
For timing reasons, we store those up in the configuration phase and then
add them as dependencies only when a project exists.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::request_kit< / span > < button class = "popup" onclick = "togglePopup('usagePopup18')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup18" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::request_kit< / span > < / span > :< br / > < a href = "1-ic.html#SP8" > § 8< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > CONFIGURATION_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kit_name< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::eq< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::duplicate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-05-03 18:34:53 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Supervisor::pass_kit_requests< / span > < button class = "popup" onclick = "togglePopup('usagePopup19')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup19" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::pass_kit_requests< / span > < / span > :< br / > < a href = "1-ic.html#SP9" > § 9< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > RUN_ONLY_IN_PHASE< / span > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > NESTED_INBUILD_PHASE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > )) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kit_name< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kits_requested_at_command_line< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-05 01:34:55 +03:00
< span class = "plain-syntax" > < / span > < a href = "5-ps2.html#SP9" class = "function-link" > < span class = "function-syntax" > Projects::add_kit_dependency< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kit_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "5-ps2.html#SP8" class = "function-link" > < span class = "function-syntax" > Projects::not_necessarily_parser_IF< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > shared_project< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP23" > < / a > < b > § 23. Access to unmanaged Inform resources. < / b > Inform needs a whole pile of files to have been installed on the host computer
2020-02-27 13:18:25 +02:00
before it can run: everything from the Standard Rules to a PDF file explaining
what interactive fiction is. They're never written to, only read. They are
2020-05-03 03:01:21 +03:00
stored in subdirectories called < span class = "extract" > < span class = "extract-syntax" > Miscellany< / span > < / span > or < span class = "extract" > < span class = "extract-syntax" > HTML< / span > < / span > of the internal nest;
2020-03-28 15:00:08 +02:00
but they're just plain old files, and are not managed by Inbuild as "copies".
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > Our client can access these files using the following function:
< / p >
< pre class = "definitions code-font" > < span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > CBLORB_REPORT_MODEL_IRES< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > 1< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > DOCUMENTATION_SNIPPETS_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INTRO_BOOKLET_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INTRO_POSTCARD_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > LARGE_DEFAULT_COVER_ART_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > SMALL_DEFAULT_COVER_ART_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > DOCUMENTATION_XREFS_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > JAVASCRIPT_FOR_STANDARD_PAGES_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > JAVASCRIPT_FOR_EXTENSIONS_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > JAVASCRIPT_FOR_ONE_EXTENSION_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > CSS_FOR_STANDARD_PAGES_IRES< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > EXTENSION_DOCUMENTATION_MODEL_IRES< / span >
< / pre >
< pre class = "displayed-code all-displayed-code code-font" >
2020-05-03 18:34:53 +03:00
< span class = "identifier-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Supervisor::file_from_installation< / span > < button class = "popup" onclick = "togglePopup('usagePopup20')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup20" > Usage of < span class = "code-font" > < span class = "function-syntax" > Supervisor::file_from_installation< / span > < / span > :< br / > Extension Documentation - < a href = "7-ed2.html#SP3_2" > § 3.2< / a > < br / > Extension Census - < a href = "7-ec.html#SP15" > § 15< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ires< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inbuild_nest< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > = < / span > < a href = "1-ic.html#SP15" class = "function-link" > < span class = "function-syntax" > Supervisor::internal< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > Errors::fatal< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "Did not set -internal when calling"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > misc< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Miscellany"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Pathnames::down< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > location< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "HTML"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > switch< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ires< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DOCUMENTATION_SNIPPETS_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > misc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "definitions.html"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > INTRO_BOOKLET_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > misc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "IntroductionToIF.pdf"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > INTRO_POSTCARD_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > misc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Postcard.pdf"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LARGE_DEFAULT_COVER_ART_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > misc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Cover.jpg"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > SMALL_DEFAULT_COVER_ART_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > misc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Small Cover.jpg"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CBLORB_REPORT_MODEL_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "CblorbModel.html"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DOCUMENTATION_XREFS_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "xrefs.txt"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > JAVASCRIPT_FOR_STANDARD_PAGES_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "main.js"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > JAVASCRIPT_FOR_EXTENSIONS_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "extensions.js"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > JAVASCRIPT_FOR_ONE_EXTENSION_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "extensionfile.js"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CSS_FOR_STANDARD_PAGES_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "main.css"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > EXTENSION_DOCUMENTATION_MODEL_IRES:< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > models< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "extensionfile.html"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "unknown installation resource file"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< nav role = "progress" > < div class = "progresscontainer" >
2020-05-03 18:34:53 +03:00
< ul class = "progressbar" > < li class = "progressprev" > < a href = "1-sm.html" > ❮ < / a > < / li > < li class = "progresschapter" > < a href = "P-wtmd.html" > P< / a > < / li > < li class = "progresscurrentchapter" > 1< / li > < li class = "progresssection" > < a href = "1-sm.html" > sm< / a > < / li > < li class = "progresscurrent" > ic< / li > < li class = "progresschapter" > < a href = "2-gnr.html" > 2< / a > < / li > < li class = "progresschapter" > < a href = "3-bg.html" > 3< / a > < / li > < li class = "progresschapter" > < a href = "4-em.html" > 4< / a > < / li > < li class = "progresschapter" > < a href = "5-es.html" > 5< / a > < / li > < li class = "progresschapter" > < a href = "6-st.html" > 6< / a > < / li > < li class = "progresschapter" > < a href = "7-ed.html" > 7< / a > < / li > < li class = "progressnext" > < a href = "2-gnr.html" > ❯ < / a > < / li > < / ul > < / div >
2020-05-03 03:01:21 +03:00
< / nav > <!-- End of weave -->
2020-02-27 13:18:25 +02:00
2020-03-19 02:11:25 +02:00
< / main >
2020-02-27 13:18:25 +02:00
< / body >
< / html >
