Define the term *receptacle*

Fixes #768.

diff --git a/doc/bspwm.1 b/doc/bspwm.1
index 208ae802a2ba2900954d5c91b6d62944491d17b0..9d2d3a5966f749db33b8c3cc62a5f09f58e1144c 100644 (file)
--- a/doc/bspwm.1
+++ b/doc/bspwm.1
@@ -2,12 +2,12 @@
 .\"     Title: bspwm
 .\"    Author: [see the "Author" section]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/14/2018
+.\"      Date: 02/04/2018
 .\"    Manual: Bspwm Manual
-.\"    Source: Bspwm 0.9.3-42-g0ba0ca3
+.\"    Source: Bspwm 0.9.3-47-ga5acc9a
 .\"  Language: English
 .\"
-.TH "BSPWM" "1" "01/14/2018" "Bspwm 0\&.9\&.3\-42\-g0ba0ca3" "Bspwm Manual"
+.TH "BSPWM" "1" "02/04/2018" "Bspwm 0\&.9\&.3\-47\-ga5acc9a" "Bspwm Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -536,6 +536,9 @@ Has its urgency hint set\&. This flag is set externally\&.
 There\(cqs three stacking layers: BELOW, NORMAL and ABOVE\&.
 .sp
 In each layer, the window are orderered as follow: tiled & pseudo\-tiled < fullscreen < floating\&.
+.SH "RECEPTACLES"
+.sp
+A leaf node that doesn\(cqt hold any window is called a receptacle\&. When a node is inserted on a receptacle in automatic mode, it will replace the receptacle\&. A receptacle can be inserted on a node and preselected\&. Receptacles can therefore be used to build a tree whose leaves are receptacles\&. Using the appropriate rules, one can then send windows on the leaves of this tree\&. This feature is used in \fIexamples/receptacles\fR to store and recreate layouts\&.
 .SH "DOMAINS"
 .SS "Node"
 .sp

diff --git a/doc/bspwm.1.asciidoc b/doc/bspwm.1.asciidoc
index cc7defd2b0f05c7b4180914db1d0af0850627dc6..329348ee6a7c29f0a468fedf97a638b3821ed3d3 100644 (file)
--- a/doc/bspwm.1.asciidoc
+++ b/doc/bspwm.1.asciidoc
@@ -336,6 +336,11 @@ There's three stacking layers: BELOW, NORMAL and ABOVE.
 
 In each layer, the window are orderered as follow: tiled & pseudo-tiled < fullscreen < floating.
 
+Receptacles
+-----------
+
+A leaf node that doesn't hold any window is called a receptacle. When a node is inserted on a receptacle in automatic mode, it will replace the receptacle. A receptacle can be inserted on a node and preselected. Receptacles can therefore be used to build a tree whose leaves are receptacles. Using the appropriate rules, one can then send windows on the leaves of this tree. This feature is used in 'examples/receptacles' to store and recreate layouts.
+
 
 Domains
 -------