From 90bb66e1f1cee7d63ac0d011e06662920431c718 Mon Sep 17 00:00:00 2001
From: John Ankarstrom <john@ankarstrom.se>
Date: Tue, 6 Jul 2021 22:30:38 +0200
Subject: Execute commands in the same shell process

---
 build.1 | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

(limited to 'build.1')

diff --git a/build.1 b/build.1
index a722d1c..1543177 100644
--- a/build.1
+++ b/build.1
@@ -44,6 +44,16 @@ Build information is encoded in two ways:
 .Pp
 There can be multiple command lines,
 but only one dependency line.
+.Pp
+Unlike
+.Xr make 1 ,
+.Nm
+executes all command lines,
+joined by newlines,
+in the same shell process.
+This means that you can keep state across multiple commands.
+Note that all commands are executed
+regardless of the exit status of previous commands.
 .
 .Sh EXAMPLES
 .Pp
@@ -52,8 +62,8 @@ Assuming that the file
 starts with the following text,
 .Bd -literal -offset indent
 \&.\\" This document is built with the following shell commands:
-\&.\\"   $ refer -p refs doc.t | troff -ms | dpost > doc.ps
-\&.\\"   $ ps2pdf doc.ps > doc.pdf
+\&.\\"   $ refer -p refs doc.t | troff -ms | dpost > doc.ps &&
+\&.\\"   $ ps2pdf doc.ps > doc.pdf &&
 \&.\\"   $ rm doc.ps
 \&.
 \&.\\" It depends on the following files:
-- 
cgit v1.2.3