From f6a4841dab7e437fc9fe11981ae2f3990fa2fff9 Mon Sep 17 00:00:00 2001
From: Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
Date: Mon, 14 Jun 2021 21:38:45 +0200
Subject: [PATCH] doc: ref the layout, buffer and window sections and commands

Add some references between the Screen layout and Buffers and windows
sections, linking also to the appropriate commands.

This should make it easier to discover the `/layout` command and its
relevance to the windows and buffer management.

(Small contribution to GitHub issue #1641)
---
 doc/en/weechat_user.en.adoc | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc
index b56f72d95..edb7879db 100644
--- a/doc/en/weechat_user.en.adoc
+++ b/doc/en/weechat_user.en.adoc
@@ -771,7 +771,7 @@ Example of terminal with WeeChat:
             ▲ bars "status" and "input"                               bar "nicklist" ▲
 ....
 
-The screen is divided up into the following areas:
+By default, the screen is divided up into the following areas:
 
 * chat area (middle of screen) with chat lines, and for each line:
 ** time
@@ -866,6 +866,13 @@ Other items available (not used in bars by default):
 | window_number                | `2`                      | Current window number.
 |===
 
+Each aspect of the layout can be customized with the appropriate <<command_line,command>>:
+<<command_weechat_bar,`/bar`>> to customize the bars,
+<<command_weechat_buffer,/buffer>> and <<command_weechat_window,`/window`>>
+to customize <<buffers_and_windows,buffers and windows>>,
+and <<command_weechat_layot,/layout>> to name, save and restore the screen layout
+and the association between windows and buffers.
+
 [[command_line]]
 === Command line
 
@@ -1108,11 +1115,18 @@ Examples of buffers:
 * irc private messages
 
 A _window_ is a screen area which displays a buffer. It is possible to split
-your screen into many windows.
+your screen into many windows (examples <<window_split_examples,below>>,
+see the <<command_weechat_window,/window command>> for details).
 
 Each window displays one buffer. A buffer can be hidden (not displayed by a
 window) or displayed by one or more windows.
 
+Screen layouts and the association between windows and buffers can be
+<<command_weechat_layout,saved and restored>>.
+
+[[window_split_examples]]
+==== Examples
+
 Example of horizontal split (`/window splith`):
 
 ....