Update libenvpp to 1.4.1, use deprecation feature, complete env var d…

…ocumentation in README

CHANGELOG.md

@@ -21,6 +21,12 @@ See our [platform support guide](docs/platform-support.md) for a complete list o
 - Add support for SimSYCL as a SYCL implementation (#238)
 - Extend compiler support to GCC (optionally with sanitizers) and C++20 code bases (#238)
 
+### Changed
+
+- Updated the internal [libenvpp](https://github.com/ph3at/libenvpp) dependency to 1.4.1 and use its new features. (#271)
+
+*Note:* We recommend performing a clean build when updating Celerity so that updated submodule dependencies are properly propagated.
+
 ## [0.5.0] - 2023-12-21
 
 We recommend using the following SYCL versions with this release:

README.md

@@ -122,3 +122,6 @@ Celerity's runtime behavior:
   at the end of execution (requires log level `info` or higher).
 - `CELERITY_DRY_RUN_NODES` takes a number and simulates a run with that many nodes
   without actually executing the commands.
+- `CELERITY_HORIZON_STEP` and `CELERITY_HORIZON_MAX_PARALLELISM` determine the
+  maximum number of sequential and parallel tasks, respectively, before a new
+  [horizon task](https://doi.org/10.1007/s42979-024-02749-w) is introduced.

src/config.cc

@@ -50,12 +50,6 @@ struct default_parser<celerity::detail::log_level> {
 
 namespace {
 
-size_t parse_validate_graph_print_max_verts(const std::string_view str) {
-	throw env::validation_error{"Support for CELERITY_GRAPH_PRINT_MAX_VERTS has been removed with Celerity 0.5.0.\n"
-	                            "Opt into graph printing by setting CELERITY_PRINT_GRAPHS=1."};
-	return 0;
-}
-
 bool parse_validate_profile_kernel(const std::string_view str) {
 	const auto pk = env::default_parser<bool>{}(str);
 	CELERITY_DEBUG("CELERITY_PROFILE_KERNEL={}.", pk ? "on" : "off");
@@ -71,22 +65,6 @@ size_t parse_validate_dry_run_nodes(const std::string_view str) {
 	return drn;
 }
 
-std::vector<size_t> parse_validate_devices(const std::string_view str, const celerity::detail::host_config host_cfg) {
-	throw env::validation_error{
-	    "Support for CELERITY_DEVICES has been removed with Celerity 0.6.0. Please use SYCL or vendor specific means to limit device visibility."};
-	return {};
-}
-
-bool parse_validate_force_wg(const std::string_view str) {
-	throw env::validation_error{"Support for CELERITY_FORCE_WG has been removed with Celerity 0.3.0."};
-	return false;
-}
-
-bool parse_validate_profile_ocl(const std::string_view str) {
-	throw env::validation_error{"CELERITY_PROFILE_OCL has been renamed to CELERITY_PROFILE_KERNEL with Celerity 0.3.0."};
-	return false;
-}
-
 } // namespace
 
 namespace celerity {
@@ -122,19 +100,19 @@ namespace detail {
 		auto pref = env::prefix("CELERITY");
 		const auto env_log_level = pref.register_option<log_level>(
 		    "LOG_LEVEL", {log_level::trace, log_level::debug, log_level::info, log_level::warn, log_level::err, log_level::critical, log_level::off});
-		[[maybe_unused]] const auto env_devs =
-		    pref.register_variable<std::vector<size_t>>("DEVICES", [this](const std::string_view str) { return parse_validate_devices(str, m_host_cfg); });
 		const auto env_profile_kernel = pref.register_variable<bool>("PROFILE_KERNEL", parse_validate_profile_kernel);
-		const auto env_dry_run_nodes = pref.register_variable<size_t>("DRY_RUN_NODES", parse_validate_dry_run_nodes);
 		const auto env_print_graphs = pref.register_variable<bool>("PRINT_GRAPHS");
+		const auto env_dry_run_nodes = pref.register_variable<size_t>("DRY_RUN_NODES", parse_validate_dry_run_nodes);
 		constexpr int horizon_max = 1024 * 64;
 		const auto env_horizon_step = pref.register_range<int>("HORIZON_STEP", 1, horizon_max);
 		const auto env_horizon_max_para = pref.register_range<int>("HORIZON_MAX_PARALLELISM", 1, horizon_max);
-		[[maybe_unused]] const auto env_gpmv = pref.register_variable<size_t>("GRAPH_PRINT_MAX_VERTS", parse_validate_graph_print_max_verts);
-		[[maybe_unused]] const auto env_force_wg =
-		    pref.register_variable<bool>("FORCE_WG", [](const std::string_view str) { return parse_validate_force_wg(str); });
-		[[maybe_unused]] const auto env_profile_ocl =
-		    pref.register_variable<bool>("PROFILE_OCL", [](const std::string_view str) { return parse_validate_profile_ocl(str); });
+
+		pref.register_deprecated("FORCE_WG", "Support for CELERITY_FORCE_WG has been removed with Celerity 0.3.0.");
+		pref.register_deprecated("PROFILE_OCL", "CELERITY_PROFILE_OCL has been renamed to CELERITY_PROFILE_KERNEL with Celerity 0.3.0.");
+		pref.register_deprecated("GRAPH_PRINT_MAX_VERTS", "Support for CELERITY_GRAPH_PRINT_MAX_VERTS has been removed with Celerity 0.5.0.\n"
+		                                                  "Opt into graph printing by setting CELERITY_PRINT_GRAPHS=1.");
+		pref.register_deprecated("DEVICES", "Support for CELERITY_DEVICES has been removed with Celerity 0.6.0.\n"
+		                                    "Please use SYCL or vendor specific means to limit device visibility.");
 
 		const auto parsed_and_validated_envs = pref.parse_and_validate();
 		if(parsed_and_validated_envs.ok()) {