From 2f3be6973c2c4bd7f4920f55c5e1ebea4cd79193 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Sun, 25 Jun 2023 16:59:47 +0000 Subject: Doc formatting fixes Signed-off-by: Laurent Bercot --- doc/el_pushenv.html | 12 ++++-------- doc/el_substitute.html | 17 ++++++++++------- 2 files changed, 14 insertions(+), 15 deletions(-) (limited to 'doc') diff --git a/doc/el_pushenv.html b/doc/el_pushenv.html index d22ce9d..5f3ac98 100644 --- a/doc/el_pushenv.html +++ b/doc/el_pushenv.html @@ -35,10 +35,8 @@ commands in the execline language via the runblock command was impossible.

- -

- To solve that issue, execline now implements a kind of environment +

To solve that issue
, execline now implements a kind of environment stack. When execlineb reads the arguments, it does not overwrite the positional parameters, but pushes them on a stack: @@ -62,10 +60,8 @@ frame of positional parameters, without paying attention to the deeper levels.

-
-

- When you are done with the arguments, it is advisable to drop +

When you are done with the arguments
, it is advisable to drop the current frame, and pop the environment stack to get it back to its previous state:

@@ -116,9 +112,9 @@ which will run prog with the same environment as the script's caller.

-
- +

Substituting positional parameters without touching the environment

+

Most of the time, you just need to substitute the positional parameters diff --git a/doc/el_substitute.html b/doc/el_substitute.html index 6e6decb..ae3481e 100644 --- a/doc/el_substitute.html +++ b/doc/el_substitute.html @@ -78,8 +78,9 @@ then execute the echo command. So that script will print blah on stdout.

-
+

Quoting

+

execline allows you to write literal ${foo} constructs @@ -163,9 +164,9 @@ $B \$B \\$B \\\$B \\\\$B \\\\\$B Phew.

-
+

A value can go through @@ -175,9 +176,9 @@ substituted. It can be crunched, split.

- +

A split value for FOO means that @@ -215,8 +216,9 @@ words beginning with the right amount of spaces, thus substituted values cannot prematurely terminate a block.)

- +

Recursive substitutions

+

A direct consequence of that rule is that substitutions will be performed @@ -280,8 +282,9 @@ ax1 bx1 cx1 dx1 ax2 bx2 cx2 dx2 ax3 bx3 cx3 dx3 in that order.

-
+

Not for the faint of heart

+

If you think you have mastered the art of execline substitution, then -- cgit v1.2.3