From: Eric S. Raymond <esr@thyrsus.com>
Date: Thu, 14 Sep 2006 23:02:52 +0000 (+0000)
Subject: Document the problems with xio.c.
X-Git-Tag: 2.0~264
X-Git-Url: https://jxself.org/git/?p=super-star-trek.git;a=commitdiff_plain;h=7a96c3323abd4aabe6e4258b9b457c909d1ec2a2;ds=sidebyside

Document the problems with xio.c.
---

diff --git a/src/xio.c b/src/xio.c
index 6d60490..1ac0e23 100644
--- a/src/xio.c
+++ b/src/xio.c
@@ -1,3 +1,20 @@
+/*
+ * Problems with this code:
+ *   1. The text window behaves like it's only a few lines high, 
+ *      scrolling in response to Return when the insertion point 
+ *      is nowhere near the last line.
+ *   2. The attempt to insert text with XawTextReplace() core dumps.
+ *   3. I haven't found a way to write a callback that triggers on Return 
+ *      and yields the line before the return.  The explanation at
+ *      http://www.linuxjunkies.org/programming/GUI/xwindow/x11/text.html
+ *      hints that this may be difficult.
+ *
+ * The functional goal is this:
+ *    1. Button pushes should be able to insert commands at the buffer's
+ *       current insertion point.
+ *    2. When a user finishes a command with Return, a callback should
+ *       receive the line of input types.
+ */
 #include <stdlib.h>
 #include <X11/Intrinsic.h>
 #include <X11/StringDefs.h>