From 288c5134ddb737e321cf352a9c80bbe595812bce Mon Sep 17 00:00:00 2001
From: Nick Mathewson <nickm@torproject.org>
Date: Sat, 14 Oct 2023 19:22:44 -0400
Subject: Ensure that we have no empty sections.

---
 spec/SUMMARY.md                           | 2 +-
 spec/dir-spec/router-operation-formats.md | 4 ++++
 spec/path-spec/building-circuits.md       | 6 ++++++
 spec/rend-spec/reserved-numbers-empty.md  | 5 -----
 spec/tor-spec/circuit-management.md       | 3 +++
 spec/tor-spec/streams.md                  | 4 ++++
 6 files changed, 18 insertions(+), 6 deletions(-)
 delete mode 100644 spec/rend-spec/reserved-numbers-empty.md

diff --git a/spec/SUMMARY.md b/spec/SUMMARY.md
index fae7259..5ed0292 100644
--- a/spec/SUMMARY.md
+++ b/spec/SUMMARY.md
@@ -111,7 +111,7 @@
   - [Appendix A: Signature scheme with key blinding \[KEYBLIND\]](./rend-spec/keyblinding-scheme.md)
   - [Appendix B: Selecting nodes \[PICKNODES\]](./rend-spec/selecting-nodes-picknodes.md)
   - [Appendix C: Recommendations for searching for vanity .onions \[VANITY\]](./rend-spec/vanity-onions.md)
-  - [Appendix D: Numeric values reserved in this document](./rend-spec/reserved-numbers-empty.md)
+  - [Appendix D: (removed)]()
   - [Appendix E: Reserved numbers](./rend-spec/reserved-numbers.md)
   - [Appendix F: Hidden service directory format \[HIDSERVDIR-FORMAT\]](./rend-spec/fs-contents.md)
   - [Appendix G: Managing authorized client data \[CLIENT-AUTH-MGMT\]](./rend-spec/client-authorization.md)
diff --git a/spec/dir-spec/router-operation-formats.md b/spec/dir-spec/router-operation-formats.md
index cec9a3c..477e92d 100644
--- a/spec/dir-spec/router-operation-formats.md
+++ b/spec/dir-spec/router-operation-formats.md
@@ -1,3 +1,7 @@
 <a id="dir-spec.txt-2"></a>
 
 # Router operation and formats
+
+This section describes how relays must behave when publishing their
+information to the directory authorities, and the formats that they
+use to do so.
diff --git a/spec/path-spec/building-circuits.md b/spec/path-spec/building-circuits.md
index af0b5cc..dfb1332 100644
--- a/spec/path-spec/building-circuits.md
+++ b/spec/path-spec/building-circuits.md
@@ -1,3 +1,9 @@
 <a id="path-spec.txt-2"></a>
 
 # Building circuits
+
+Here we describe a number of rules for building circuits: under what
+circumstances we do so, how we choose the paths for them, when we give
+up on an in-progress circuits, and what we do when circuit
+construction fails.
+
diff --git a/spec/rend-spec/reserved-numbers-empty.md b/spec/rend-spec/reserved-numbers-empty.md
deleted file mode 100644
index 7a2f01f..0000000
--- a/spec/rend-spec/reserved-numbers-empty.md
+++ /dev/null
@@ -1,5 +0,0 @@
-<a id="rend-spec-v3.txt-D"></a>
-
-# Appendix D: Numeric values reserved in this document
-
-\[TODO: collect all the lists of commands and values mentioned above\]
diff --git a/spec/tor-spec/circuit-management.md b/spec/tor-spec/circuit-management.md
index 30e3284..6569b04 100644
--- a/spec/tor-spec/circuit-management.md
+++ b/spec/tor-spec/circuit-management.md
@@ -1,3 +1,6 @@
 <a id="tor-spec.txt-5"></a>
 
 # Circuit management
+
+This section describes how circuits are created, and how they operate
+once they are constructed.
diff --git a/spec/tor-spec/streams.md b/spec/tor-spec/streams.md
index e30ce8b..29fe097 100644
--- a/spec/tor-spec/streams.md
+++ b/spec/tor-spec/streams.md
@@ -1,3 +1,7 @@
 <a id="tor-spec.txt-6"></a>
 
 # Application connections and stream management
+
+This section describes how clients use RELAY cells to communicate with
+exit nodes, and how use this communication channel to send and receive
+application data.
-- 
cgit v1.2.3-54-g00ecf