From c7364e070503d0e28bff862e95c2741b538dd7ef Mon Sep 17 00:00:00 2001
From: Bastien Dejean <nihilhill@gmail.com>
Date: Sat, 2 Jan 2016 11:13:30 +0100
Subject: [PATCH] Document the optional tilde character

---
 doc/bspwm.1          | 20 ++++++++++++++------
 doc/bspwm.1.asciidoc |  6 +++---
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/doc/bspwm.1 b/doc/bspwm.1
index fa287ec..a3a762e 100644
--- a/doc/bspwm.1
+++ b/doc/bspwm.1
@@ -2,12 +2,12 @@
 .\"     Title: bspwm
 .\"    Author: [see the "Author" section]
 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\"      Date: 12/30/2015
+.\"      Date: 01/02/2016
 .\"    Manual: Bspwm Manual
-.\"    Source: Bspwm 0.9-114-g1fe2b41
+.\"    Source: Bspwm 0.9-118-gdcc13f7
 .\"  Language: English
 .\"
-.TH "BSPWM" "1" "12/30/2015" "Bspwm 0\&.9\-114\-g1fe2b41" "Bspwm Manual"
+.TH "BSPWM" "1" "01/02/2016" "Bspwm 0\&.9\-118\-gdcc13f7" "Bspwm Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -519,9 +519,15 @@ Transplant the selected node to the given node\&.
 Swap the selected node with the given node\&.
 .RE
 .PP
-\fB\-p\fR, \fB\-\-presel\-dir\fR \fIDIR\fR|cancel
+\fB\-p\fR, \fB\-\-presel\-dir\fR [~]\fIDIR\fR|cancel
 .RS 4
-Preselect the splitting area of the selected node (or cancel the preselection)\&.
+Preselect the splitting area of the selected node (or cancel the preselection)\&. If
+\fB~\fR
+is prepended to
+\fIDIR\fR
+and the current preselection direction matches
+\fIDIR\fR, then the argument is interpreted as
+\fBcancel\fR\&.
 .RE
 .PP
 \fB\-o\fR, \fB\-\-presel\-ratio\fR \fIRATIO\fR
@@ -563,7 +569,9 @@ Circulate the windows of the tree rooted at the selected node\&.
 .PP
 \fB\-t\fR, \fB\-\-state\fR [~](tiled|pseudo_tiled|floating|fullscreen)
 .RS 4
-Set the state of the selected window\&.
+Set the state of the selected window\&. If
+\fB~\fR
+is present and the current state matches the given state, then the argument is interpreted as the last state\&.
 .RE
 .PP
 \fB\-g\fR, \fB\-\-flag\fR locked|sticky|private[=on|off]
diff --git a/doc/bspwm.1.asciidoc b/doc/bspwm.1.asciidoc
index 9bb44df..e723806 100644
--- a/doc/bspwm.1.asciidoc
+++ b/doc/bspwm.1.asciidoc
@@ -322,8 +322,8 @@ Commands
 *-s*, *--swap* 'NODE_SEL'::
 	Swap the selected node with the given node.
 
-*-p*, *--presel-dir* [~]'DIR'|cancel::
-	Preselect the splitting area of the selected node (or cancel the preselection).
+*-p*, *--presel-dir* \[~]'DIR'|cancel::
+	Preselect the splitting area of the selected node (or cancel the preselection). If *~* is prepended to 'DIR' and the current preselection direction matches 'DIR', then the argument is interpreted as *cancel*.
 
 *-o*, *--presel-ratio* 'RATIO'::
 	Set the splitting ratio of the preselection area.
@@ -347,7 +347,7 @@ Commands
 	Circulate the windows of the tree rooted at the selected node.
 
 *-t*, *--state* [~](tiled|pseudo_tiled|floating|fullscreen)::
-	Set the state of the selected window.
+	Set the state of the selected window. If *~* is present and the current state matches the given state, then the argument is interpreted as the last state.
 
 *-g*, *--flag* locked|sticky|private[=on|off]::
 	Set or toggle the given flag for the selected node.