/jEdit/tags/jedit-4-2-pre14/doc/users-guide/updating-modes.xml

 1<!-- jEdit buffer-local properties: -->
 2<!-- :indentSize=1:noTabs=true: -->
 3<!-- :xml.root=users-guide.xml: -->
 4
 5<chapter id="updating-modes"><title>Updating Edit Modes for jEdit 4.1/4.2</title>
 6 <para>
 7  In jEdit 4.1, the mode file grammar has been cleaned up somewhat. As a result, some
 8  edit modes written for jEdit 4.0 and earlier need to be updated:
 9 </para>
10 <itemizedlist>
11  <listitem>
12   <para>
13    Defining <literal>&lt;WHITESPACE&gt;</literal> rules is no longer necessary
14    and doing so will print warnings to the activity logs.
15   </para>
16  </listitem>
17  <listitem>
18   <para>
19    The <literal>&lt;KEYWORDS&gt;</literal> tag no longer accepts an
20    <literal>IGNORE_CASE</literal> attribute.
21    Set the <literal>IGNORE_CASE</literal> attribute of the
22    <literal>&lt;RULES&gt;</literal> tag instead.
23   </para>
24  </listitem>
25  <listitem>
26   <para>
27    The <literal>&lt;END&gt;</literal> tag of the <literal>&lt;SPAN&gt;</literal> rule
28    used to be optional, in which case
29    any occurrence of the start string would cause the remainder of the buffer
30    to be highlighted with the span. In jEdit 4.1, the <literal>&lt;END&gt;</literal>
31    tag can no longer be omitted, however
32    a <literal>&lt;SEQ&gt;</literal> tag with a <literal>DELEGATE</literal> attribute
33    can be used to achieve the same effect as endless span.
34   </para>
35  </listitem>
36  <listitem>
37   <para>
38    Defining <literal>&lt;SEQ TYPE="NULL"&gt;</literal> rules for word separators
39    is no longer necessary. Now, any non-alphanumeric character not appearing in
40    a keyword definition or the ruleset's <literal>NO_WORD_SEP</literal> attribute
41    is considered a word separator.
42   </para>
43  </listitem>
44 </itemizedlist>
45</chapter>