From 05111f648ef3afc8f53b2326318f20f1e85fb31f Mon Sep 17 00:00:00 2001
From: Ralph Amissah <ralph.amissah@gmail.com>
Date: Tue, 7 May 2024 10:36:50 -0400
Subject: dub (dlang) prefer dub run to dub build

---
 README.md | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 9d4afc4..6b4ecd3 100644
--- a/README.md
+++ b/README.md
@@ -44,9 +44,7 @@ D projects tend to use dub as project manager
 
 The default build tools used are dub with ldc2 (dub is also tested)
 
-## make a directory and clone the sisudoc-spine project-heading
-
-# make a directory and clone the sisudoc-spine project
+## make a directory and clone the sisudoc-spine project
 
   mkdir ~/git.sisudoc
   cd ~/git.sisudoc
@@ -57,19 +55,32 @@ The default build tools used are dub with ldc2 (dub is also tested)
 
 such a relative directory layout will be assumed in the examples that provided
 
+all work in this installation of and use of sisudoc-spine will take place in the
+directory: sisudoc-spine
+
 ## build sisudoc-spine
 
+NOTE all actions to build sisudoc-spine are taken within the directory
+sisudoc-spine
+
+cd sisudoc-spine
+
 ## directly with dub
 ### ldc2
+  # on nix (get dependencies by setting your development environment):
+  nix develop ".#dsh-nixpkgs-ldc-dub" --print-build-logs -c zsh
 
+  dub run --compiler=ldmd2 --config=ldmd2 --combined --skip-registry=all
   dub --compiler=ldmd2 --config=ldmd2
-  dub --verbose --compiler=ldmd2 -color --config=ldmd2
 
+  dub run --compiler=ldc2 --config=ldc2 --combined --skip-registry=all
   dub --compiler=ldc2 --config=ldc2
-  dub --verbose --compiler=ldc2 -color --config=ldc2
 
 ### dmd
+  # on nix (get dependencies by setting your development environment):
+  nix develop ".#dsh-nixpkgs-dmd-dub" --print-build-logs -c zsh
 
+  dub run --compiler=dmd --config=dmd --combined --skip-registry=all
   dub --compiler=dmd --config=dmd
 
 ## with make
@@ -86,12 +97,10 @@ such a relative directory layout will be assumed in the examples that provided
 
 ### ldc2
 
-  nix develop ".#dsh-nixpkgs-ldc-dub" --print-build-logs -c zsh
   nix build ".#spine-nixpkgs-ldc" --print-build-logs
 
 ### dmd
 
-  nix develop ".#dsh-nixpkgs-dmd-dub" --print-build-logs -c zsh
   nix build ".#spine-nixpkgs-dmd" --print-build-logs
 
 ## the Meson build system was used briefly
-- 
cgit v1.2.3