diff --git a/src/commands.cc b/src/commands.cc
index 1f5dcf7e..bb253a61 100644
--- a/src/commands.cc
+++ b/src/commands.cc
@@ -2379,15 +2379,16 @@ static String face_doc_helper(const Context& context, CommandParameters params)
 const CommandDesc set_face_cmd = {
     "set-face",
     "face",
-    "set-face <scope> <name> <facespec>: set face <name> to refer to <facespec> in <scope>\n"
+    "set-face <scope> <name> <facespec>: set face <name> to <facespec> in <scope>\n"
     "\n"
-    "facespec format is <fg color>[,<bg color>][+<attributes>][@<base>]\n"
+    "facespec format is:\n"
+    "    <fg color>[,<bg color>[,<underline color>]][+<attributes>][@<base>]\n"
     "colors are either a color name, rgb:######, or rgba:######## values.\n"
     "attributes is a combination of:\n"
     "    u: underline, c: curly underline, i: italic, b: bold,\n"
-    "    r: reverse, s: strikethrough, B: blink, d: dim,\n"
-    "    f: final foreground, g: final background,\n"
-    "    a: final attributes, F: same as +fga\n"
+    "    r: reverse,   s: strikethrough,   B: blink,  d: dim,\n"
+    "    f: final foreground,              g: final background,\n"
+    "    a: final attributes,              F: same as +fga\n"
     "facespec can as well just be the name of another face.\n"
     "if a base face is specified, colors and attributes are applied on top of it",
     ParameterDesc{{}, ParameterDesc::Flags::None, 3, 3},