From f63c5a66aca6bd1a5120d4b5f33f82ea6d01c62a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Ekl=C3=B6f?= <daniel@ekloef.se>
Date: Sun, 3 Nov 2019 13:47:03 +0100
Subject: [PATCH] man: foot.1: add a DESCRIPTION

---
 doc/foot.1.scd | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/foot.1.scd b/doc/foot.1.scd
index e9b80dfc..7f65a491 100644
--- a/doc/foot.1.scd
+++ b/doc/foot.1.scd
@@ -58,6 +58,17 @@ execute (instead of the shell).
 *-v*,*--version*
 	Show the version number and quit
 
+# DESCRIPTION
+
+*foot* is a Wayland terminal emulator. Running it without arguments
+will start a new terminal window with your default shell.
+
+You can override the default shell by appending a custom command to
+the foot command line. To ensure foot does not touch the shell
+arguments, use *--*:
+
+	foot -- sh -c "echo hello world && sleep 5"
+
 # KEYBOARD SHORTCUTS
 
 The following keyboard shortcuts are available. Note that they cannot