From 843d628895c31eacd2aa89d44c1a4535dd601215 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc=20Andr=C3=A9=20Tanner?= <mat@brain-dump.org>
Date: Thu, 17 Jul 2014 22:46:58 +0200
Subject: Add some ascii art to illustrate insertion

---
 editor.c | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/editor.c b/editor.c
index c0ac388..4af1e41 100644
--- a/editor.c
+++ b/editor.c
@@ -305,6 +305,34 @@ static Piece* editor_insert_empty(Editor *ed, char *content, size_t len) {
 	return p;
 }
 
+/* When inserting new data there are 2 cases to consider.
+ *
+ *  - in the first the insertion point falls into the middle of an exisiting
+ *    piece which is replaced by three new pieces:
+ *
+ *      /-+ --> +---------------+ --> +-\
+ *      | |     | existing text |     | |
+ *      \-+ <-- +---------------+ <-- +-/
+ *                         ^
+ *                         Insertion point for "demo "
+ *
+ *      /-+ --> +---------+ --> +-----+ --> +-----+ --> +-\
+ *      | |     | existing|     |demo |     |text |     | |
+ *      \-+ <-- +---------+ <-- +-----+ <-- +-----+ <-- +-/
+ *
+ *  - the second case deals with an insertion point at a piece boundry:
+ *
+ *      /-+ --> +---------------+ --> +-\
+ *      | |     | existing text |     | |
+ *      \-+ <-- +---------------+ <-- +-/
+ *            ^
+ *            Insertion point for "short"
+ *
+ *      /-+ --> +-----+ --> +---------------+ --> +-\
+ *      | |     |short|     | existing text |     | |
+ *      \-+ <-- +-----+ <-- +---------------+ <-- +-/
+ */
+
 bool editor_insert(Editor *ed, size_t pos, char *text) {
 	Change *c = change_alloc(ed);
 	if (!c)
-- 
cgit v1.2.3