2019-03-17 14:40:57 +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 > Main< / 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" >
2019-03-17 14:40:57 +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
2019-03-17 14:40:57 +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 >
2020-04-14 19:56:54 +03:00
< li > < a href = "index.html" > < span class = "selectedlink" > inter< / span > < / a > < / li >
< / ul > < h2 > Inbuild Modules< / h2 > < ul >
< li > < a href = "../supervisor-module/index.html" > supervisor< / 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 >
2020-08-27 17:50:24 +03:00
< li > < a href = "../assertions-module/index.html" > assertions< / a > < / li >
< li > < a href = "../values-module/index.html" > values< / a > < / li >
< li > < a href = "../knowledge-module/index.html" > knowledge< / a > < / li >
< li > < a href = "../imperative-module/index.html" > imperative< / a > < / li >
< li > < a href = "../runtime-module/index.html" > runtime< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../if-module/index.html" > if< / a > < / li >
< li > < a href = "../multimedia-module/index.html" > multimedia< / a > < / li >
< 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 >
2021-08-10 13:01:03 +03:00
< li > < a href = "../pipeline-module/index.html" > pipeline< / a > < / li >
< li > < a href = "../final-module/index.html" > final< / a > < / li >
2020-05-20 02:02:28 +03:00
< / ul > < h2 > Services< / h2 > < ul >
2020-04-14 19:56:54 +03:00
< li > < a href = "../arch-module/index.html" > arch< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../calculus-module/index.html" > calculus< / a > < / li >
2020-04-14 19:56:54 +03:00
< li > < a href = "../html-module/index.html" > html< / a > < / li >
2020-05-20 02:02:28 +03:00
< li > < a href = "../inflections-module/index.html" > inflections< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../kinds-module/index.html" > kinds< / a > < / li >
2020-05-20 02:02:28 +03:00
< li > < a href = "../linguistics-module/index.html" > linguistics< / a > < / li >
< li > < a href = "../problems-module/index.html" > problems< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../syntax-module/index.html" > syntax< / a > < / li >
< li > < a href = "../words-module/index.html" > words< / 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 'Main' generated by Inweb -->
< div class = "breadcrumbs" >
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../compiler.html" > Compiler Tools< / a > < / li > < li > < a href = "index.html" > inter< / a > < / li > < li > < a href = "index.html#1" > Chapter 1: Outside of inform7< / a > < / li > < li > < b > Main< / b > < / li > < / ul > < / div >
< p class = "purpose" > A command-line interface for Inter functions which are not part of the normal operation of the Inform compiler.< / p >
2019-03-17 14:40:57 +02:00
2020-04-16 01:49:59 +03:00
< ul class = "toc" > < li > < a href = "1-mn.html#SP1" > § 1. Settings variables< / a > < / li > < li > < a href = "1-mn.html#SP2" > § 2. Main routine< / a > < / li > < li > < a href = "1-mn.html#SP2_7" > § 2.7. Command line< / a > < / li > < / ul > < hr class = "tocbar" >
2019-03-17 14:40:57 +02:00
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP1" class = "paragraph-anchor" > < / a > < b > § 1. Settings variables. < / b > The following will be set at the command line.
2020-03-29 02:22:31 +02:00
< / p >
2019-03-17 14:40:57 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > path_to_inter< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kit_to_assimilate< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > domain_path< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > inter_file_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > of < / span > < span class = "extract" > < span class = "extract-syntax" > filename< / span > < / span >
< span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > output_textually< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > output_binarily< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-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 = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pipeline_as_file< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pipeline_as_text< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2021-05-31 19:45:44 +03:00
< span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > internal_path< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Main::add_pipeline_variable< / 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" > Main::add_pipeline_variable< / span > < / span > :< br / > < a href = "1-mn.html#SP2_3" > § 2.3< / a > , < a href = "1-mn.html#SP3_1" > § 3.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > value< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/4-sm.html#SP17" class = "function-link" > < span class = "function-syntax" > Str::copy< / span > < / a > < span class = "plain-syntax" > (< / span > < a href = "../../../inweb/docs/foundation-module/2-dct.html#SP9" class = "function-link" > < span class = "function-syntax" > Dictionaries::create_text< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pipeline_vars< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > value< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Main::add_pipeline_variable_from_filename< / 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" > Main::add_pipeline_variable_from_filename< / span > < / span > :< br / > < a href = "1-mn.html#SP2_3" > § 2.3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > ) {< / span >
2020-06-28 01:18:54 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fullname< / span > < span class = "plain-syntax" > )< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fullname< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%f"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "1-mn.html#SP1" class = "function-link" > < span class = "function-syntax" > Main::add_pipeline_variable< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > fullname< / span > < span class = "plain-syntax" > );< / span >
2020-06-28 01:18:54 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fullname< / span > < span class = "plain-syntax" > )< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2020-03-28 21:42:53 +02:00
< / pre >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2" class = "paragraph-anchor" > < / a > < b > § 2. Main routine. < / b > When Inter is called at the command line, it begins at < span class = "extract" > < span class = "extract-syntax" > main< / span > < / span > , like all C
2020-03-29 02:22:31 +02:00
programs.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > Inter can do three different things: assimilate a kit, run a pipeline of
2020-03-29 02:22:31 +02:00
code generation stages, and verify/transcode files of Inter code. In fact,
though, that's really only two different things, because assimilation is
also done with a pipeline.
2020-03-28 21:42:53 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > main< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > argc< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > char< / span > < span class = "plain-syntax" > **< / span > < span class = "identifier-syntax" > argv< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Start up the modules< / span > < span class = "named-paragraph-number" > 2.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Begin with an empty file list and variables dictionary< / span > < span class = "named-paragraph-number" > 2.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_7" class = "named-paragraph-link" > < span class = "named-paragraph" > Read the command line< / span > < span class = "named-paragraph-number" > 2.7< / 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" > kit_to_assimilate< / span > < span class = "plain-syntax" > ) < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_3" class = "named-paragraph-link" > < span class = "named-paragraph" > Set up a pipeline for assimilation< / span > < span class = "named-paragraph-number" > 2.3< / 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" > pipeline_as_file< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > pipeline_as_text< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_4" class = "named-paragraph-link" > < span class = "named-paragraph" > Run the pipeline< / span > < span class = "named-paragraph-number" > 2.4< / span > < / a > < / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_5" class = "named-paragraph-link" > < span class = "named-paragraph" > Read the list of inter files, and perhaps transcode them< / span > < span class = "named-paragraph-number" > 2.5< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "1-mn.html#SP2_6" class = "named-paragraph-link" > < span class = "named-paragraph" > Shut down the modules< / span > < span class = "named-paragraph-number" > 2.6< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP1" class = "function-link" > < span class = "function-syntax" > Errors::have_occurred< / span > < / a > < span class = "plain-syntax" > ()) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > 1< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2020-03-28 21:42:53 +02:00
< / pre >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_1" class = "paragraph-anchor" > < / a > < b > § 2.1. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Start up the modules< / span > < span class = "named-paragraph-number" > 2.1< / span > < / span > < span class = "comment-syntax" > =< / span >
2020-05-03 03:01:21 +03:00
< / p >
2020-03-28 21:42:53 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2020-07-05 17:33:25 +03:00
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/1-fm.html#SP8" class = "function-link" > < span class = "function-syntax" > Foundation::start< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > argc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > argv< / span > < span class = "plain-syntax" > ); < / span > < span class = "comment-syntax" > must be started first< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "../arch-module/1-am.html#SP3" class = "function-link" > < span class = "function-syntax" > ArchModule::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "../bytecode-module/1-bm.html#SP3" class = "function-link" > < span class = "function-syntax" > BytecodeModule::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "../building-module/1-bm2.html#SP4" class = "function-link" > < span class = "function-syntax" > BuildingModule::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
2021-08-10 13:01:03 +03:00
< span class = "plain-syntax" > < / span > < a href = "../pipeline-module/1-pm.html#SP3" class = "function-link" > < span class = "function-syntax" > PipelineModule::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "../final-module/1-fm2.html#SP3" class = "function-link" > < span class = "function-syntax" > FinalModule::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
2021-06-27 18:04:28 +03:00
< span class = "plain-syntax" > < / span > < a href = "../index-module/1-im.html#SP2" class = "function-link" > < span class = "function-syntax" > IndexModule::start< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-03-29 02:22:31 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_2" class = "paragraph-anchor" > < / a > < b > § 2.2. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Begin with an empty file list and variables dictionary< / span > < span class = "named-paragraph-number" > 2.2< / span > < / span > < span class = "comment-syntax" > =< / span >
2020-05-03 03:01:21 +03:00
< / p >
2020-03-29 02:22:31 +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" > inter_file_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > );< / span >
2021-11-15 01:40:33 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pipeline_vars< / span > < span class = "plain-syntax" > = < / span > < a href = "../pipeline-module/2-pp.html#SP10" class = "function-link" > < span class = "function-syntax" > ParsingPipelines::basic_dictionary< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "output.i6"< / span > < span class = "plain-syntax" > );< / span >
2021-05-31 19:45:44 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > internal_path< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP5" class = "function-link" > < span class = "function-syntax" > Pathnames::from_text< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "inform7/Internal"< / span > < span class = "plain-syntax" > );< / span >
2020-03-29 02:22:31 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_3" class = "paragraph-anchor" > < / a > < b > § 2.3. < / b > This pipeline is supplied built in to the installation of < span class = "extract" > < span class = "extract-syntax" > inter< / span > < / span > . In fact,
2020-05-03 03:01:21 +03:00
it only ever writes the binary form of the code it produces, so only < span class = "extract" > < span class = "extract-syntax" > *out< / span > < / span >
2020-03-29 02:22:31 +02:00
is used. But at times in the past it has been useful to debug with the text
2020-05-03 03:01:21 +03:00
form, which would be written to < span class = "extract" > < span class = "extract-syntax" > *outt< / span > < / span > .
2020-03-28 21:42:53 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Set up a pipeline for assimilation< / span > < span class = "named-paragraph-number" > 2.3< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-03-28 21:42:53 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-11-15 01:40:33 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inter_architecture< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > A< / span > < span class = "plain-syntax" > = < / span > < a href = "../pipeline-module/1-pm.html#SP4" class = "function-link" > < span class = "function-syntax" > PipelineModule::get_architecture< / 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" > A< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "no -architecture given"< / span > < span class = "plain-syntax" > );< / span >
2020-03-29 02:22:31 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > path_to_pipelines< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP4" class = "function-link" > < span class = "function-syntax" > Pathnames::down< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > path_to_inter< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "Pipelines"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pipeline_as_file< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-fln.html#SP2" class = "function-link" > < span class = "function-syntax" > Filenames::in< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > path_to_pipelines< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "assimilate.interpipeline"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > pipeline_as_text< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-03-29 02:22:31 +02:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-mn.html#SP1" class = "function-link" > < span class = "function-syntax" > Main::add_pipeline_variable< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "*kit"< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP7" class = "function-link" > < span class = "function-syntax" > Pathnames::directory_name< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_to_assimilate< / span > < span class = "plain-syntax" > ));< / span >
< span class = "plain-syntax" > < / span > < a href = "1-mn.html#SP1" class = "function-link" > < span class = "function-syntax" > Main::add_pipeline_variable_from_filename< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "*out"< / span > < span class = "plain-syntax" > ,< / span >
2020-05-20 02:02:28 +03:00
< span class = "plain-syntax" > < / span > < a href = "../arch-module/2-arc.html#SP4" class = "function-link" > < span class = "function-syntax" > Architectures::canonical_binary< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_to_assimilate< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > A< / span > < span class = "plain-syntax" > ));< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "1-mn.html#SP1" class = "function-link" > < span class = "function-syntax" > Main::add_pipeline_variable_from_filename< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "*outt"< / span > < span class = "plain-syntax" > ,< / span >
2020-05-20 02:02:28 +03:00
< span class = "plain-syntax" > < / span > < a href = "../arch-module/2-arc.html#SP4" class = "function-link" > < span class = "function-syntax" > Architectures::canonical_textual< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_to_assimilate< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > A< / span > < span class = "plain-syntax" > ));< / span >
2020-03-28 21:42:53 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_4" class = "paragraph-anchor" > < / a > < b > § 2.4. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Run the pipeline< / span > < span class = "named-paragraph-number" > 2.4< / span > < / span > < span class = "comment-syntax" > =< / span >
2020-05-03 03:01:21 +03:00
< / p >
2020-03-28 21:42:53 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-04-16 00:42:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "../../../inweb/docs/foundation-module/2-llas.html#SP7" class = "function-link" > < span class = "function-syntax" > LinkedLists::len< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_file_list< / span > < span class = "plain-syntax" > ) > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > )< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "-pipeline-text and -pipeline-file cannot be combined with inter files"< / 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" > pipeline_as_file< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > pipeline_as_text< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "-pipeline-text and -pipeline-file are mutually exclusive"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > inter_paths< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > pathname< / 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" > kit_to_assimilate< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > kit_to_assimilate< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_paths< / span > < span class = "plain-syntax" > );< / span >
2021-11-13 15:29:56 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inter_pipeline< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > SS< / 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" > pipeline_as_file< / span > < span class = "plain-syntax" > )< / span >
2021-11-15 01:40:33 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > SS< / span > < span class = "plain-syntax" > = < / span > < a href = "../pipeline-module/2-pp.html#SP5" class = "function-link" > < span class = "function-syntax" > ParsingPipelines::from_file< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pipeline_as_file< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > pipeline_vars< / 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 >
2021-11-15 01:40:33 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > SS< / span > < span class = "plain-syntax" > = < / span > < a href = "../pipeline-module/2-pp.html#SP5" class = "function-link" > < span class = "function-syntax" > ParsingPipelines::from_text< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pipeline_as_text< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > pipeline_vars< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > requirements_list< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_library< / span > < span class = "plain-syntax" > );< / span >
2021-11-13 15:29:56 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > SS< / span > < span class = "plain-syntax" > ) < / span > < a href = "../pipeline-module/2-rp.html#SP3" class = "function-link" > < span class = "function-syntax" > RunningPipelines::run< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > domain_path< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > SS< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_paths< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > requirements_list< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / 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 > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "pipeline could not be parsed"< / span > < span class = "plain-syntax" > );< / span >
2020-03-28 21:42:53 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_5" class = "paragraph-anchor" > < / a > < b > § 2.5. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Read the list of inter files, and perhaps transcode them< / span > < span class = "named-paragraph-number" > 2.5< / span > < / span > < span class = "comment-syntax" > =< / span >
2020-05-03 03:01:21 +03:00
< / p >
2020-03-28 21:42:53 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-04-16 00:42:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > inter_tree< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > = < / span > < a href = "../bytecode-module/2-it.html#SP2" class = "function-link" > < span class = "function-syntax" > InterTree::new< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > F< / 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" > F< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_file_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 = "../bytecode-module/3-iibf.html#SP4" class = "function-link" > < span class = "function-syntax" > Inter::Binary::test_file< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < a href = "../bytecode-module/3-iibf.html#SP1" class = "function-link" > < span class = "function-syntax" > Inter::Binary::read< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span >
< span class = "plain-syntax" > < / span > < a href = "../bytecode-module/3-iitf.html#SP1" class = "function-link" > < span class = "function-syntax" > Inter::Textual::read< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > F< / 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" > output_textually< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > C_struct< / span > < span class = "plain-syntax" > ; < / span > < span class = "reserved-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > = & < / span > < span class = "identifier-syntax" > C_struct< / 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" > STREAM_OPEN_TO_FILE< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > output_textually< / span > < span class = "plain-syntax" > , < / span > < span class = "constant-syntax" > UTF8_ENC< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal_with_file< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "unable to open textual inter file for output: %f"< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > output_textually< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../bytecode-module/3-iitf.html#SP2" class = "function-link" > < span class = "function-syntax" > Inter::Textual::write< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / 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 = "constant-syntax" > 1< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > STREAM_CLOSE< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / 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" > output_binarily< / span > < span class = "plain-syntax" > ) < / span > < a href = "../bytecode-module/3-iibf.html#SP1_1" class = "function-link" > < span class = "function-syntax" > Inter::Binary::write< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > output_binarily< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > );< / span >
2020-03-29 02:22:31 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_6" class = "paragraph-anchor" > < / a > < b > § 2.6. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Shut down the modules< / span > < span class = "named-paragraph-number" > 2.6< / span > < / span > < span class = "comment-syntax" > =< / span >
2020-05-03 03:01:21 +03:00
< / p >
2020-03-29 02:22:31 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < a href = "../bytecode-module/1-bm.html#SP3" class = "function-link" > < span class = "function-syntax" > BytecodeModule::end< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "../building-module/1-bm2.html#SP5" class = "function-link" > < span class = "function-syntax" > BuildingModule::end< / span > < / a > < span class = "plain-syntax" > ();< / span >
2021-08-10 13:01:03 +03:00
< span class = "plain-syntax" > < / span > < a href = "../pipeline-module/1-pm.html#SP3" class = "function-link" > < span class = "function-syntax" > PipelineModule::end< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < a href = "../final-module/1-fm2.html#SP3" class = "function-link" > < span class = "function-syntax" > FinalModule::end< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "../arch-module/1-am.html#SP3" class = "function-link" > < span class = "function-syntax" > ArchModule::end< / span > < / a > < span class = "plain-syntax" > ();< / span >
2021-06-27 18:04:28 +03:00
< span class = "plain-syntax" > < / span > < a href = "../index-module/1-im.html#SP2" class = "function-link" > < span class = "function-syntax" > IndexModule::end< / span > < / a > < span class = "plain-syntax" > ();< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/1-fm.html#SP9" class = "function-link" > < span class = "function-syntax" > Foundation::end< / span > < / a > < span class = "plain-syntax" > (); < / span > < span class = "comment-syntax" > must be ended last< / span >
2020-03-29 02:22:31 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_7" class = "paragraph-anchor" > < / a > < b > § 2.7. Command line. < / b > < / p >
2020-05-03 03:01:21 +03:00
< pre class = "definitions code-font" > < span class = "definition-keyword" > define< / span > < span class = "constant-syntax" > PROGRAM_NAME< / span > < span class = "plain-syntax" > < / span > < span class = "string-syntax" > "inter"< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > TEXTUAL_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > BINARY_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 >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > DOMAIN_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > ARCHITECTURE_CLSW< / span >
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > ASSIMILATE_CLSW< / span >
2021-05-31 19:45:44 +03:00
< span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > INTERNAL_CLSW< / span >
2019-03-17 14:40:57 +02:00
< / pre >
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 command line< / span > < span class = "named-paragraph-number" > 2.7< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2019-03-17 14:40:57 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP14" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_heading< / span > < / a > < span class = "plain-syntax" > (< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "[[Purpose]]\n\n"< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "usage: inter file1 file2 ... [options]\n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > TEXTUAL_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "textual"< / 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" > "write to file X in textual format"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > BINARY_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "binary"< / 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" > "write to file X in binary format"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < 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-text"< / 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 pipeline textually, with X being a comma-separated list of stages"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < 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 pipeline as file X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < 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 > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > DOMAIN_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "domain"< / 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 folder to read/write inter files from/to"< / span > < span class = "plain-syntax" > );< / span >
2021-05-31 19:45:44 +03:00
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < 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" > "specify folder of internal Inform resources"< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > ARCHITECTURE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "architecture"< / 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" > "generate Inter with architecture X"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP5" class = "function-link" > < span class = "function-syntax" > CommandLine::declare_switch< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "constant-syntax" > ASSIMILATE_CLSW< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > L< / span > < span class = "string-syntax" > "assimilate"< / 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" > "assimilate (i.e., build) Inter kit X for the current architecture"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-cla.html#SP8" class = "function-link" > < span class = "function-syntax" > CommandLine::read< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > argc< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > argv< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , & < / span > < a href = "1-mn.html#SP3" class = "function-link" > < span class = "function-syntax" > Main::respond< / span > < / a > < span class = "plain-syntax" > , & < / span > < a href = "1-mn.html#SP4" class = "function-link" > < span class = "function-syntax" > Main::add_file< / span > < / a > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > path_to_inter< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP3" class = "function-link" > < span class = "function-syntax" > Pathnames::installation_path< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "INTER_PATH"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "inter"< / 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-mn.html#SP2" > § 2< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP3" class = "paragraph-anchor" > < / a > < b > § 3. < / b > < / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Main::respond< / 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" > Main::respond< / span > < / span > :< br / > < a href = "1-mn.html#SP2_7" > § 2.7< / a > < / span > < / button > < 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 = "reserved-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 >
< 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" > TEXTUAL_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > output_textually< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-fln.html#SP3" class = "function-link" > < span class = "function-syntax" > Filenames::from_text< / 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 >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > BINARY_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > output_binarily< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-fln.html#SP3" class = "function-link" > < span class = "function-syntax" > Filenames::from_text< / 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 >
< 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" > pipeline_as_text< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/4-sm.html#SP3" class = "function-link" > < span class = "function-syntax" > Str::duplicate< / 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 >
< 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" > pipeline_as_file< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-fln.html#SP3" class = "function-link" > < span class = "function-syntax" > Filenames::from_text< / 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 >
< 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-mn.html#SP3_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Add a pipeline variable to the dictionary< / span > < span class = "named-paragraph-number" > 3.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" > DOMAIN_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > domain_path< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP5" class = "function-link" > < span class = "function-syntax" > Pathnames::from_text< / 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 >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ASSIMILATE_CLSW:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kit_to_assimilate< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP5" class = "function-link" > < span class = "function-syntax" > Pathnames::from_text< / 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 >
2021-05-31 19:45:44 +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 > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > internal_path< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-pth.html#SP5" class = "function-link" > < span class = "function-syntax" > Pathnames::from_text< / 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" > ARCHITECTURE_CLSW:< / span >
2021-11-15 01:40:33 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "../pipeline-module/1-pm.html#SP4" class = "function-link" > < span class = "function-syntax" > PipelineModule::set_architecture< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > FALSE< / span > < span class = "plain-syntax" > )< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "no such -architecture"< / 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 = "plain-syntax" > }< / span >
2019-03-17 14:40:57 +02:00
< / pre >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP3_1" class = "paragraph-anchor" > < / a > < b > § 3.1. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Add a pipeline variable to the dictionary< / span > < span class = "named-paragraph-number" > 3.1< / span > < / span > < span class = "comment-syntax" > =< / span >
2020-05-03 03:01:21 +03:00
< / p >
2019-03-17 14:40:57 +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" > match_results< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/4-pm.html#SP9" class = "function-link" > < span class = "function-syntax" > Regexp::create_mr< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < a href = "../../../inweb/docs/foundation-module/4-pm.html#SP10" class = "function-link" > < span class = "function-syntax" > Regexp::match< / span > < / a > < 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 > < a href = "../../../inweb/docs/foundation-module/4-sm.html#SP13" class = "function-link" > < span class = "function-syntax" > Str::get_first_char< / span > < / a > < 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 > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < 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 > < a href = "1-mn.html#SP1" class = "function-link" > < span class = "function-syntax" > Main::add_pipeline_variable< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > exp< / span > < span class = "plain-syntax" > [0], < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > exp< / span > < span class = "plain-syntax" > [1]);< / 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 > < a href = "../../../inweb/docs/foundation-module/3-em.html#SP2" class = "function-link" > < span class = "function-syntax" > Errors::fatal< / span > < / a > < 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 > < a href = "../../../inweb/docs/foundation-module/4-pm.html#SP9" class = "function-link" > < span class = "function-syntax" > Regexp::dispose_of< / span > < / a > < span class = "plain-syntax" > (& < / span > < span class = "identifier-syntax" > mr< / span > < span class = "plain-syntax" > );< / span >
2020-03-29 02:22:31 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "1-mn.html#SP3" > § 3< / a > .< / li > < / ul >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP4" class = "paragraph-anchor" > < / a > < b > § 4. < / b > < / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > Main::add_file< / 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" > Main::add_file< / span > < / span > :< br / > < a href = "1-mn.html#SP2_7" > § 2.7< / a > < / span > < / button > < 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" > 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 >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > = < / span > < a href = "../../../inweb/docs/foundation-module/3-fln.html#SP3" class = "function-link" > < span class = "function-syntax" > Filenames::from_text< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > arg< / 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" > F< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > filename< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_file_list< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2019-03-17 14:40:57 +02:00
< / pre >
2020-08-27 17:50:24 +03:00
< p class = "commentary firstcommentary" > < a id = "SP5" class = "paragraph-anchor" > < / a > < b > § 5. < / b > The modules included in < span class = "extract" > < span class = "extract-syntax" > inter< / span > < / span > make use of the Inform 7 module < span class = "extract" > < span class = "extract-syntax" > kinds< / span > < / span > ,
2020-05-03 03:01:21 +03:00
but when we are using < span class = "extract" > < span class = "extract-syntax" > inter< / span > < / span > on its own, kinds have no meaning for us.
We are required to create a < span class = "extract" > < span class = "extract-syntax" > kind< / span > < / span > type, in order for < span class = "extract" > < span class = "extract-syntax" > kinds< / span > < / span > to compile;
but no instances of this kind will ever in fact exist. < span class = "extract" > < span class = "extract-syntax" > K_value< / span > < / span > is a
2020-03-29 02:22:31 +02:00
global constant meaning "any kind at all", and that also must exist.
< / p >
2019-03-17 14:40:57 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > typedef< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > ;< / span >
< span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > K_value< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2019-03-17 14:40:57 +02:00
< / pre >
2021-05-31 19:45:44 +03:00
< p class = "commentary firstcommentary" > < a id = "SP6" class = "paragraph-anchor" > < / a > < b > § 6. < / b > This is where the < a href = "../html-module/index.html" class = "internal" > html< / a > module can find CSS files and similar resources:
< / p >
< pre class = "definitions code-font" > < span class = "definition-keyword" > define< / span > < span class = "constant-syntax" > INSTALLED_FILES_HTML_CALLBACK< / span > < span class = "plain-syntax" > < / span > < a href = "1-mn.html#SP6" class = "function-link" > < span class = "function-syntax" > Main::internal_path< / span > < / a >
< / pre >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > Main::internal_path< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / 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" > internal_path< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
2020-05-03 03:01:21 +03:00
< nav role = "progress" > < div class = "progresscontainer" >
< ul class = "progressbar" > < li class = "progressprev" > < a href = "M-rc.html" > ❮ < / a > < / li > < li class = "progresschapter" > < a href = "M-ui.html" > M< / a > < / li > < li class = "progresscurrentchapter" > 1< / li > < li class = "progresscurrent" > mn< / li > < li class = "progressnextoff" > ❯ < / li > < / ul > < / div >
< / nav > <!-- End of weave -->
2019-03-17 14:40:57 +02:00
2020-03-19 02:11:25 +02:00
< / main >
2019-03-17 14:40:57 +02:00
< / body >
< / html >