From a32916ffcfa64957ebe7f9b59eeefc2a8f554a1f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?P=C5=99emysl=20Eric=20Janouch?= <p@janouch.name>
Date: Thu, 25 Aug 2022 12:28:17 +0200
Subject: [PATCH] xC: label code sections better

Introduce tildes as a new sublevel of markers.
---
 xC.c | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/xC.c b/xC.c
index 7b61fb9..f978628 100644
--- a/xC.c
+++ b/xC.c
@@ -259,7 +259,7 @@ struct input_vtable
 	XX (get_line) XX (clear_line) XX (insert)                                  \
 	XX (on_tty_resized) XX (on_tty_readable)
 
-// --- GNU Readline ------------------------------------------------------------
+// ~~~ GNU Readline ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #ifdef HAVE_READLINE
 
@@ -728,7 +728,7 @@ input_rl_new (void)
 #define input_new input_rl_new
 #endif // HAVE_READLINE
 
-// --- BSD Editline ------------------------------------------------------------
+// ~~~ BSD Editline ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #ifdef HAVE_EDITLINE
 
@@ -1160,7 +1160,7 @@ input_el_new (void)
 //
 // The only exception is IRC identifiers.
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Scripting support ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 // We need a few reference countable objects with support for both strong
 // and weak references (mainly used for scripted plugins).
@@ -1272,7 +1272,7 @@ struct ispect_field
 	{ #field, offsetof (struct object, field), ISPECT_STR_MAP,                 \
 	  ISPECT_REF, g_##ref_type##_ispect, is_list },
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Chat ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 struct user_channel
 {
@@ -1431,7 +1431,7 @@ channel_destroy (struct channel *self)
 
 REF_COUNTABLE_METHODS (channel)
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Buffers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 enum formatter_item_type
 {
@@ -1627,7 +1627,7 @@ buffer_destroy (struct buffer *self)
 REF_COUNTABLE_METHODS (buffer)
 #define buffer_ref do_not_use_dangerous
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Server ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 // The only real purpose of this is to abstract away TLS
 struct transport
@@ -1903,7 +1903,7 @@ server_destroy (struct server *self)
 REF_COUNTABLE_METHODS (server)
 #define server_ref do_not_use_dangerous
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Scripting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 struct plugin
 {
@@ -2022,7 +2022,7 @@ struct completion_hook
 		struct completion *data, const char *word, struct strv *output);
 };
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Main context ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 struct app_context
 {
@@ -2785,7 +2785,7 @@ init_colors (struct app_context *ctx)
 		(config_item_get (ctx->config.root, "attributes", NULL));
 }
 
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+// ~~~ Attribute printer ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 // A little tool that tries to make the most of the terminal's capabilities
 // to set up text attributes.  It mostly targets just terminal emulators as that