From 2750e249c453b674ed86b86e667318d69890b644 Mon Sep 17 00:00:00 2001
From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Tue, 18 Jul 2023 15:16:50 +0400
Subject: [PATCH] Add simplistic docs on sections

---
 include/sections.html | 29 +++++++++++++++++++++++++++++
 master-doc.txt        |  8 ++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 include/sections.html

diff --git a/include/sections.html b/include/sections.html
new file mode 100644
index 0000000..9880c0f
--- /dev/null
+++ b/include/sections.html
@@ -0,0 +1,29 @@
+
+<p>
+	Sections represent significant self-contained parts of the timeline.
+	Common examples of a section are a verse, a chorus, or a bridge in a song.
+</p>
+
+<p>
+	Currently, sections are only exposed as editor actions that are available
+	when a range is selected on the timeline:
+</p>
+
+<ul>
+	<li>
+		Cut/Paste Range Section to Edit Point
+	</li>
+	<li>
+		Cut/Paste Range Section to Edit Point
+	</li>
+	<li>
+		Delete Range Section
+	</li>
+</ul>
+
+<p>
+	When Ardour treats a range as a section, it cuts or copies audio and MIDI
+	data and their automation across all tracks. When pasting the cut or copied
+	data, it ripples all tracks at the edit point.
+</p>
+
diff --git a/master-doc.txt b/master-doc.txt
index 9311991..c9a3bf1 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1296,6 +1296,14 @@ link: region-properties
 part: subchapter
 ---
 
+---
+title: Sections
+include: sections.html
+link: sections
+uri: editing-and-arranging/sections
+part: chapter
+---
+
 ---
 title: Fades and Crossfades
 include: create-region-fades-and-crossfades.html