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(-)
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.
-
+
Value transformations
-
+
A value can go through
@@ -175,9 +176,9 @@ substituted. It can be crunched,
split.
-
+
Substitution of split values
-
+
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 1.4.1