From 622e0127eaaf579e8ffa2b222555dd97d2069bc6 Mon Sep 17 00:00:00 2001
From: decentral1se <lukewm@riseup.net>
Date: Wed, 28 Jul 2021 11:29:59 +0200
Subject: [PATCH] docs: fill out app listing CLI docs

---
 cli/app.go | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/cli/app.go b/cli/app.go
index 116bec79..8f2a6d0a 100644
--- a/cli/app.go
+++ b/cli/app.go
@@ -50,7 +50,16 @@ var appRestoreCommand = &cli.Command{
 	ArgsUsage: "<service> [<backup file>]",
 }
 var appListCommand = &cli.Command{
-	Name:    "list",
+	Name:  "list",
+	Usage: "List all managed apps",
+	Description: `
+This command looks at your local file system listing of apps and servers (e.g.
+in ~/.abra/) to generate a report of all your apps.
+
+By passing the "--status/-S" flag, you can query all your servers for the
+actual live deployment status. Depending on how many servers you manage, this
+can take some time.
+	`,
 	Aliases: []string{"ls"},
 	Flags:   []cli.Flag{StatusFlag, ServerFlag, TypeFlag},
 	Action: func(c *cli.Context) error {