From 3d4e3081cb7f413191f0836d3782da8e70854afd Mon Sep 17 00:00:00 2001 From: Eric Hanchrow Date: Mon, 14 Oct 2024 17:12:01 -0700 Subject: [PATCH 1/4] Deprecate backticks --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 535b2bc402..481e7cd377 100644 --- a/README.md +++ b/README.md @@ -2034,6 +2034,8 @@ Use `just --groups --unsorted` to print groups in their justfile order. ### Command Evaluation Using Backticks +Backticks are an older feature that have largely been obsoleted by the `shell` function (see [External Commands](#external-commands).); we recommend that you use `shell` in new justfiles. + Backticks can be used to store the result of commands: ```just From 59032e1e50654471a707c63d48a2c3bba7f891e8 Mon Sep 17 00:00:00 2001 From: Eric Hanchrow Date: Mon, 14 Oct 2024 19:01:25 -0700 Subject: [PATCH 2/4] Don't depracte backticks; just suggest `shell` as an alternative. --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 481e7cd377..b3126c3e37 100644 --- a/README.md +++ b/README.md @@ -2034,8 +2034,6 @@ Use `just --groups --unsorted` to print groups in their justfile order. ### Command Evaluation Using Backticks -Backticks are an older feature that have largely been obsoleted by the `shell` function (see [External Commands](#external-commands).); we recommend that you use `shell` in new justfiles. - Backticks can be used to store the result of commands: ```just @@ -2061,6 +2059,8 @@ See the [Strings](#strings) section for details on unindenting. Backticks may not start with `#!`. This syntax is reserved for a future upgrade. +More flexible and powerful command invocations can be acheived with the `shell` function (see [External Commands](#external-commands)). + ### Conditional Expressions `if`/`else` expressions evaluate different branches depending on if two From 813c2fe132b51c1226d22902af305567c837d9d7 Mon Sep 17 00:00:00 2001 From: Casey Rodarmor Date: Wed, 30 Oct 2024 15:25:57 -0700 Subject: [PATCH 3/4] Adjust --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b3126c3e37..5d5bd4ee65 100644 --- a/README.md +++ b/README.md @@ -2059,7 +2059,9 @@ See the [Strings](#strings) section for details on unindenting. Backticks may not start with `#!`. This syntax is reserved for a future upgrade. -More flexible and powerful command invocations can be acheived with the `shell` function (see [External Commands](#external-commands)). +The [`shell(…)` function](#external-commands) provides a more general mechanism +to invoke external commands, including the ability to execute a variable as a +command, and to pass arguments. ### Conditional Expressions From 36a45c3f1389a2fc778f9310c226548dbdbd3594 Mon Sep 17 00:00:00 2001 From: Casey Rodarmor Date: Wed, 30 Oct 2024 15:27:45 -0700 Subject: [PATCH 4/4] Adapt --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5d5bd4ee65..dbee10c4db 100644 --- a/README.md +++ b/README.md @@ -2060,8 +2060,8 @@ Backticks may not start with `#!`. This syntax is reserved for a future upgrade. The [`shell(…)` function](#external-commands) provides a more general mechanism -to invoke external commands, including the ability to execute a variable as a -command, and to pass arguments. +to invoke external commands, including the ability to execute the contents of a +variable as a command, and to pass arguments to a command. ### Conditional Expressions