From d712454b3c7646f21a55662d80e8b095177d70c9 Mon Sep 17 00:00:00 2001
From: Tim Allen <screwtape@froup.com>
Date: Thu, 24 Jan 2019 08:52:01 +1100
Subject: [PATCH] doc/kak.1: split the synopsis for each mutually exclusive
 mode of operation.

Previously, the manpage listed every flag and parameter as optional, implying
that they could be used in any combination, which isn't true. As a trivial
example, to use Kakoune in "list sessions" mode, you *must* specify -l, and you
*must not* specify any other options. To use Kakoune in any other mode, you
*must not* specify -l.
---
 doc/kak.1 | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/doc/kak.1 b/doc/kak.1
index e13d112e..2e887a83 100644
--- a/doc/kak.1
+++ b/doc/kak.1
@@ -6,8 +6,44 @@ kak \- a vim inspired, selection oriented code editor
 
 .SH SYNOPSIS
 
+.PP
+.B kak \-help
+
+.PP
+.B kak \-version
+
+.PP
+.B kak \-l
+
+.PP
+.B kak \-clear
+
+.PP
+.B kak \-f
+.I keys
+[\fB\-q\fR] [\fB\-i\fR]
+.IR file ...
+
+.PP
+.B kak \-p
+.I session_id
+
+.PP
+.B kak \-s
+.I session_id
+.B \-d
+[\fB\-n\fR] [\fB\-ro\fR]
+[\fB\-E\fR \fIcommand\fR]
+[\fB+line\fR[\fB:column\fR]|\fB+:\fR]
+.IR file ...
+
+.PP
 .B kak
-[\fB\-help\fR] [\fB\-version\fR] [\fB\-q\fR] [\fB\-n\fR] [\fB\-l\fR] [\fB\-ro\fR] [\fB\-clear\fR] [\fB\-ui\fR \fIui_type\fR] [\fB\-e\fR \fIcommand\fR] [\fB\-E\fR \fIcommand\fR] [\fB\-f\fR \fIkeys\fR] [\fB\-p\fR \fIsession_id\fR] [\fB\-c\fR \fIsession_id\fR|[[\fB\-d\fR] \fB\-s\fR \fIsession_id\fR] [\fB+line\fR[\fB:column\fR]|\fB+:\fR]
+[\fB\-c\fR \fIsession_id\fR|\fB\-s\fR \fIsession_id\fR]
+[\fB\-n\fR] [\fB\-ro\fR]
+[\fB\-ui\fR \fIui_type\fR] [\fB\-e\fR \fIcommand\fR]
+[\fB\-E\fR \fIcommand\fR]
+[\fB+line\fR[\fB:column\fR]|\fB+:\fR]
 .IR file ...
 
 .SH DESCRIPTION