From a6188af30efc78ddd0a644272898b0a1c8bccce7 Mon Sep 17 00:00:00 2001
From: Christian Kurz <chrissikurz@gmail.com>
Date: Mon, 6 Aug 2018 11:16:28 +0200
Subject: [PATCH] Document `CMD`-object customization

fix #19286
---
 doc/src/manual/running-external-programs.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/src/manual/running-external-programs.md b/doc/src/manual/running-external-programs.md
index 749d88b75f2cf..6813760097427 100644
--- a/doc/src/manual/running-external-programs.md
+++ b/doc/src/manual/running-external-programs.md
@@ -365,3 +365,13 @@ stages have different latency so they use a different number of parallel workers
 saturated throughput.
 
 We strongly encourage you to try all these examples to see how they work.
+
+## `CMD`-Objects
+Instead of with backticks, [`Cmd`](@ref)-objects can also be generated manually. This has the advantage, that arguments like the working directory and environment-variables can be customized.
+
+A simple example:
+```julia
+Cmd(`pwd`, dir="..")
+```
+
+Also see [`setenv`](@ref), [`withenv`](@ref) for further information.