From 213ac0087784f4776461daf24e8f92032bced162 Mon Sep 17 00:00:00 2001 From: Kevin Day Date: Tue, 17 Jan 2023 21:59:00 -0600 Subject: [PATCH] Update: Add locale environment variable support, install, and help support in fakefiles. Pass along the common locale-specific environment variables along when using a fakefile. Add an "install" operation that is essentially a wrapper to the "install.sh" script. Add a "help" operation to provide some documentation. These are provided as a convenience and as a functional proof of concept. --- level_3/byte_dump/data/build/fakefile | 18 +++++++- level_3/control/data/build/fakefile | 18 +++++++- level_3/controller/data/build/fakefile | 18 +++++++- level_3/fake/data/build/fakefile | 18 +++++++- level_3/firewall/data/build/fakefile | 18 +++++++- level_3/fss_basic_list_read/data/build/fakefile | 18 +++++++- level_3/fss_basic_read/data/build/fakefile | 18 +++++++- level_3/fss_embedded_list_read/data/build/fakefile | 18 +++++++- level_3/fss_extended_list_read/data/build/fakefile | 18 +++++++- level_3/fss_extended_read/data/build/fakefile | 18 +++++++- level_3/fss_identify/data/build/fakefile | 18 +++++++- level_3/fss_payload_read/data/build/fakefile | 18 +++++++- level_3/fss_write/data/build/fakefile | 49 ++++++++++------------ level_3/iki_read/data/build/fakefile | 18 +++++++- level_3/iki_write/data/build/fakefile | 18 +++++++- level_3/status_code/data/build/fakefile | 31 +++++++------- level_3/utf8/data/build/fakefile | 18 +++++++- 17 files changed, 294 insertions(+), 56 deletions(-) diff --git a/level_3/byte_dump/data/build/fakefile b/level_3/byte_dump/data/build/fakefile index 5328059..5086c11 100644 --- a/level_3/byte_dump/data/build/fakefile +++ b/level_3/byte_dump/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for Byte Dump Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/control/data/build/fakefile b/level_3/control/data/build/fakefile index 5328059..97815ec 100644 --- a/level_3/control/data/build/fakefile +++ b/level_3/control/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for Control Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/controller/data/build/fakefile b/level_3/controller/data/build/fakefile index 5328059..943b151 100644 --- a/level_3/controller/data/build/fakefile +++ b/level_3/controller/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for Controller Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fake/data/build/fakefile b/level_3/fake/data/build/fakefile index 5328059..7507b7c 100644 --- a/level_3/fake/data/build/fakefile +++ b/level_3/fake/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for Featureless Make Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/firewall/data/build/fakefile b/level_3/firewall/data/build/fakefile index 5328059..97e4950 100644 --- a/level_3/firewall/data/build/fakefile +++ b/level_3/firewall/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for Firewall Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_basic_list_read/data/build/fakefile b/level_3/fss_basic_list_read/data/build/fakefile index 5328059..ce59a0a 100644 --- a/level_3/fss_basic_list_read/data/build/fakefile +++ b/level_3/fss_basic_list_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FS Basic List Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_basic_read/data/build/fakefile b/level_3/fss_basic_read/data/build/fakefile index 5328059..3bd3c08 100644 --- a/level_3/fss_basic_read/data/build/fakefile +++ b/level_3/fss_basic_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FSS Basic Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_embedded_list_read/data/build/fakefile b/level_3/fss_embedded_list_read/data/build/fakefile index 5328059..4ad0b79 100644 --- a/level_3/fss_embedded_list_read/data/build/fakefile +++ b/level_3/fss_embedded_list_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FSS Embedded List Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_extended_list_read/data/build/fakefile b/level_3/fss_extended_list_read/data/build/fakefile index 5328059..0e40535 100644 --- a/level_3/fss_extended_list_read/data/build/fakefile +++ b/level_3/fss_extended_list_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FSS Extended List Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_extended_read/data/build/fakefile b/level_3/fss_extended_read/data/build/fakefile index 5328059..b1829a9 100644 --- a/level_3/fss_extended_read/data/build/fakefile +++ b/level_3/fss_extended_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FSS Extended Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_identify/data/build/fakefile b/level_3/fss_identify/data/build/fakefile index 5328059..85f6370 100644 --- a/level_3/fss_identify/data/build/fakefile +++ b/level_3/fss_identify/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FSS Identify Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_payload_read/data/build/fakefile b/level_3/fss_payload_read/data/build/fakefile index 5328059..35890c5 100644 --- a/level_3/fss_payload_read/data/build/fakefile +++ b/level_3/fss_payload_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for FSS Payload Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/fss_write/data/build/fakefile b/level_3/fss_write/data/build/fakefile index d6988d4..a8f730f 100644 --- a/level_3/fss_write/data/build/fakefile +++ b/level_3/fss_write/data/build/fakefile @@ -2,23 +2,15 @@ # # Builds the fss_write library and all programs. # -# An optional "install" is provided as a convience and a sort of documentation. -# This "install" only provides a very basic setup and it is strongly recommended to install manually or through some other means. -# settings: fail exit modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - if parameter mode - operate using_mode - else - operate using_default - -using_default: build settings build settings.main build settings.basic @@ -28,22 +20,25 @@ using_default: build settings.embedded_list build settings.payload -using_mode: - build settings parameter:'mode:value' - build settings.main parameter:'mode:value' - build settings.basic parameter:'mode:value' - build settings.basic_list parameter:'mode:value' - build settings.extended parameter:'mode:value' - build settings.extended_list parameter:'mode:value' - build settings.embedded_list parameter:'mode:value' - build settings.payload parameter:'mode:value' - install: - shell ./install.sh parameter:'work' - shell ./install.sh parameter:'work' -s data/build/settings.main - shell ./install.sh parameter:'work' -s data/build/settings.basic - shell ./install.sh parameter:'work' -s data/build/settings.basic_list - shell ./install.sh parameter:'work' -s data/build/settings.extended - shell ./install.sh parameter:'work' -s data/build/settings.extended_list - shell ./install.sh parameter:'work' -s data/build/settings.embedded_list - shell ./install.sh parameter:'work' -s data/build/settings.payload + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.main + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.basic + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.basic_list + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.extended + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.extended_list + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.embedded_list + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.payload + +help: + print + print context:'title'Fakefile Options for FSS Write Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/iki_read/data/build/fakefile b/level_3/iki_read/data/build/fakefile index 5328059..52ae617 100644 --- a/level_3/iki_read/data/build/fakefile +++ b/level_3/iki_read/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for IKI Read Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/iki_write/data/build/fakefile b/level_3/iki_write/data/build/fakefile index 5328059..2741529 100644 --- a/level_3/iki_write/data/build/fakefile +++ b/level_3/iki_write/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for IKI Write Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/status_code/data/build/fakefile b/level_3/status_code/data/build/fakefile index 72b7d6a..6d1ef0b 100644 --- a/level_3/status_code/data/build/fakefile +++ b/level_3/status_code/data/build/fakefile @@ -5,24 +5,27 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - if parameter mode - operate using_mode - else - operate using_default - -using_default: build settings build settings.main build settings.fss -using_mode: - build settings parameter:'mode:value' - build settings.main parameter:'mode:value' - build settings.fss parameter:'mode:value' - install: - shell ./install.sh parameter:'work' - shell ./install.sh parameter:'work' -s data/build/settings.main - shell ./install.sh parameter:'work' -s data/build/settings.fss + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.main + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' -s data/build/settings.fss + +help: + print + print context:'title'Fakefile Options for Status Code Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. diff --git a/level_3/utf8/data/build/fakefile b/level_3/utf8/data/build/fakefile index 5328059..18e9b58 100644 --- a/level_3/utf8/data/build/fakefile +++ b/level_3/utf8/data/build/fakefile @@ -5,7 +5,23 @@ settings: modes individual level monolithic clang test environment PATH LD_LIBRARY_PATH + environment LANG LC_ALL LC_COLLATE LC_CTYPE LC_FASTMSG LC_MESSAGES LC_MONETARY LC_NUMERIC LC_TIME LOCPATH NLSPATH main: - build + +install: + shell ./install.sh parameter:'work' parameter:'verbosity' parameter:'color' + +help: + print + print context:'title'Fakefile Options for UTF8 Software.context:'reset' + + print + print The following operations are available\: + print " - context:'notable'help:context:'reset' Perform the help operation, printing this message." + print " - context:'notable'install:context:'reset' A helper operation that simply calls the ./install.sh script with default settings." + print " - context:'notable'main:context:'reset' The default compilation using the build settings mode." + + print + print The context:'notable'install context:'reset'operation supports the context:'notable'work,context:'reset' context:'notable'verbosity,context:'reset' and context:'notable'color context:'reset'parameters. -- 1.8.3.1