summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorBerke Viktor <bviktor@hexchat.org>2012-10-28 01:06:09 +0200
committerBerke Viktor <bviktor@hexchat.org>2012-10-28 01:06:09 +0200
commite39a4db30975b2219c2bdf1201192c089f42498d (patch)
tree3b0e91e8d41eba5961f79f506ce2afbacbc12bfc
parent9550862cb0bc8e8d0800dc92f702295dd46d9e0a (diff)
Add notes about managing text events
-rw-r--r--src/common/make-te.c21
1 files changed, 18 insertions, 3 deletions
diff --git a/src/common/make-te.c b/src/common/make-te.c
index aece6fbe..117d41ab 100644
--- a/src/common/make-te.c
+++ b/src/common/make-te.c
@@ -1,7 +1,22 @@
-/* process textevents.in with make-te < textevents.in > textevents.h 2> textenums.h
+/* Process textevents.in with make-te < textevents.in > textevents.h 2> textenums.h
+ *
  * textevents.in notes:
- *  - the n prefix means the event text does not have to be translated thus
- *    the N_() encapsulation will be omitted
+ *
+ *  - The number in the ending lines indicates the total number of arguments
+ *    a text event supports. So don't touch them unless you actually modify the
+ *    EMIT_SIGNAL commands, too.
+ *
+ *  - The "n" prefix means the event text does not have to be translated thus
+ *    the N_() gettext encapsulation will be omitted.
+ *
+ *  - EMIT_SIGNAL is just a macro for text_emit() which can take a total amount
+ *    of 4 event arguments, so events have a hard limit of 4 arguments.
+ *
+ *  - $t means the xtext tab, i.e. the vertical separator line for indented nicks.
+ *    That means $t forces a new line for that event.
+ *
+ *  - Text events are emitted in ctcp.c, dcc.c, hexchat.c, ignore.c, inbound.c,
+ *    modes.c, notify.c, outbound.c, proto-irc.c, server.c and text.c.
  */
 
 #include <stdio.h>