= Version 5.21 =

 * Extensive reworking of content update architecture (not finished!)
 * Retooling of edit facility
 * Creation of smart edit locking mechanism
 * "Smart" draw after edits (not yet complete)
 * Location preservation afer edits (not yet complete)
 * Changed {{{Save pane as text...}}} to {{{Save pane as text (UTF-8)...}}}
 * Keyboard shortcut for tenth termlist fixed
 * New editing/multiple view framework
 * Tree expansion (not just highlight) state preserved when tree redrawn
 * {{{Save modified files...}}} warns if nothing needs to be saved
 * Modifications in docspecs for XTF2 format and for Proto-Elamite
 * Word tagger now emits punctuation tokens
 * Default heap size increased
 * Bug fixes
  * Keyboard shortcut for tenth termlist now works
  * Fixed recognition of non-standard containers for searching
  * Exception no longer thrown when editing empty translation in termlist
  * Orthographic normalization allows search for "Africa" in Italian to find "d'Africa"
  * Numerous small warning fixed in javadoc presentation
  * Fixed bug that prevented committing edits in a pseudo-container
  * Added exception handling to !AsyncStyledEditorKit 

 = Version 5.16 =

 * Bug fixes
  * File dialog gets default name when saving morphlogy
  * Fixed bugs relating to interaction between commit edits/save
  * Improved handling of !ConentUpdateEvens
  * Added script for setting version number (globally) 


{{{
#!html

<h3>Version 5.14</h3>
<ul>
<li>Bug fixes
<ul>
<li>Fixed bug that caused Drag-and-drop onto term editor to fail on
some JREs
<li>Fixed problem with Italian orthographic normalization

<li>Ensured that term instance not cleared after <span
class="menu">Add term...</span>
</ul>
</ul>

<h3>Version 5.12</h3>
<ul>
<li>Frames displaying search results show the number of matching
containers in the title bar
<li>Bug fix
<ul>
<li>Filter is no longer automatically cleared after selecting a term
instance in the term editor
</ul>
</ul>

<h3>Version 5.0</h3>

<ul>
<li>New terminology functions:
<ul>
<li><span class="menu">Copy term instances</span> in context menu.

<li>Typing in term list jumps to first term beginning with letter.

<li><span class="menu">Show in other texts</span> button added to term
editor.

<li>Term list may be filtered by strings in term name or translation.

<li><span class="menu">Copy term</span> function allows copying or
moving terms (and all instances) from one list to another.

<li>When term instances are dragged onto a term, Arboreal now asks
user whether instances with parts previously assigned to another term
should be reassigned.
</ul>

<li>Dictionary browser now allows opening entry in an external
browser.

<li>Enabled autoscrolling when dragging into content pane.

<li>Improved Windows installation now uses <a
href="http://launch4j.sourceforge.net/">launch4j</a>.

<li>Added emacs-like C-t support in text widgets.

<li>Bug fixes
<ul>
<li>Many bug fixes and speedup improvements to terminology functions.

<li>Fixed annoying problem with enabled autoscrolling with context
menu visible.

<li>Problems with auto-completion in <span class="menu">Add
analysis...</span> (morphology) repaired.

<li>Display updated after drag-and-drop of links.

<li>Undo functionality made more robust.

<li>Tree state is preserved after <span class="menu">Open links</span>.


<li><span class="menu">Select XPath...</span> now supports XML
namespaces properly.

<li>Tree selection state is preserved when possible.

<li>Reasonable rendering of Arabic script now supported on OS X.

<li>Support for bidirectional text improved.

<li><span class="menu">Cancel/Done</span> now more sensibly labeled
<span class="menu">Reset</span> in term editor.

<li>Fixed spurious stripping of tabs at beginning of document.

<li>Support for cuneiform languages improved.

<li>Support for Chinese improved.

<li>Dictionary display now supports encodings other than ISO-8859-1.

<li>Arboreal no longer fails when docspec rules request interpolation
of attribute values containing slashes.


<li>Dictionary browser now has reasonable error handling for bad
links.

<li>Font size setting is no longer trashed when text reloaded.
</ul>

</ul>

<h3>Version 4.98</h3>
<ul>
<li>Undo is now supported for links dragged into the content pane.

<li>Inline rendering of graphemes specified by a <tt>&lt;char&gt;</tt>
tag is now supported.

<li>Terms and term instances are automatically assigned unique IDs.

<li>Bug fixes
<ul>

<li>Reloading a text no longer trashes modifications without
presenting a confirm dialog.

<li>Spurious linebreaks corresponding to subcontainer boundaries are
no longer rendered in slave texts.
</ul>
</ul>

<h3>Version 4.95</h3>

<ul>
<li>New support for Java method calls in XSLT.

<li>Delimiters for Chinese improved (again).
</ul>

<h3>Version 4.93</h3>

<ul>

<li>Improved language support
<ul>
<li>Added support for French orthographic normalization.

<li>Delimiters for Chinese improved.

<li>Better display of Greek (improved selection of allographs for
sigma).
</ul>
</ul>

<h3>Version 4.9</h3>

<ul>
<li>Files and URLs can be dragged into text widgets (e.g., the <span
class="menu">Load XML document</span> chooser).

<li>The <span class="menu">Edit</span> menu now has the standard <span
class="menu">Cut</span>, <span class="menu">Copy</span>, and <span
class="menu">Paste</span> items.


<li>An <span class="menu">Install scripts</span> item under the <span
class="menu">Transform</span> menu allows XSL transformations to be
downloaded from a remote server and automatically added to the <span
class="menu">Transform</span> menu.

<li>There's now a splash screen!

<li>A <span class="menu">Show info</span> option has been added to the
context menu.

<li>The command <span class="menu">Save modified files</span> has been
added to the <span class="menu">File</span> menu.


<li>On OS X, the <span class="menu">Preferences</span> menu item now
appears in its standard location.

<li>Bug fixes
<ul>
<li>Fixed bug that required caret movement or mouse click before paste
worked.

<li>Fixed bug that caused duplicate display of nodes in find results.

<li>File overwrite confirmation dialogs are now consistently presented.

<li>Problems with the <span class="menu">Quit</span> menu item on OS X
have been fixed.

<li>A bug that resulted in menu items on OS X being disabled has been
fixed.

<li>The web-browser launch function now should work properly on
Windows XP.
</ul>
</ul>

<h3>Version 4.8</h3>

<ul>
<li>New <span class="menu">Transform</span> menu
<ul>
<li><span class="menu">Transform</span> function from <span
class="menu">File</span> menu has been moved to the <span
class="menu">Transform</span> menu and renamed <span class="menu">XSL
transform</span>.


<li><span class="menu">Tag words</span> function from <span
class="menu">File</span> menu has been moved to the <span
class="menu">Transform</span> menu and renamed <span
class="menu">Extract words</span>.

<li>A new function <span class="menu">Tag words</span> creates a
result document with explicit word token tagging. Language-specific
word tokenization behaviors are specified in the langspec document.

<li>Transformations may be added to the <span
class="menu">Transform</span> menu. Simply add an XSLT document to the

<tt>scripts</tt> directory located beneath the Arboreal preferences
(<tt>arboreal</tt>) directory. The document should contain a
processing directive that provides a menu item name for Arboreal, e.g.
<tt>&lt;?arboreal menu-item-name=&quot;Sample
transformation&quot;?&gt;</tt>
</ul>

<li>Links can be dragged into the content pane (experimental feature,
still in development).

<li>An option <span class="menu">Invert selection</span> has been
added under the <span class="menu">Edit</span> menu.


<li>Accented characters from the basic Greek block of Unicode are
corrrectly normalized.

<li>The Arabic Romanization filter now transliterates roots sensibly.

<li>Pressing <kbd>Shift</kbd> in the content pane now causes the
context menu to be dismissed.

<li>Larger font sizes are supported in the content pane.

<li>Bug fixes
<ul>
<li>Drag-and-drop now works on 1.4.x VMs on Max OS (modifier key is
<kbd>Option/Alt</kbd>).

<li>Logic error fixed in DOMTreeModel.

<li>Fixed pipeline problem in filters in dictionary viewer.

<li>Better exception handling in filter implemention.

<li>The dictionary viewer now respects the charset specified in the HTTP header.

<li>The caret is now always made invisible after a commit in the content pane.


<li>Fixed exception thrown when PluggableFilter scanner buffer length == 0.

<li>Highlighted word information is cleared after any navigation in
document tree (fixes problems where this information was wrongly
during DnD when it shouldn't have been).
</ul>
</ul>

<h3>Version 4.74</h3>
<ul>
<li>In the term editor, terms may be sorted either by dictionary order
or by their frequency (in all texts, or in the particular text that
has been selected).

<li>A new navigation command, <span class="menu">Edit &gt; Select
parent(s)</span> is available.

<li>Parameters may be interactively entered for XSL scripts that are
run within Arboreal.

<li>Improvements to morphology


<ul>
<li>Log information from Donatus can now be viewed (<span
class="menu">Morphology/View Donaus log...</span>).

<li>If any new morphological data have been added, Donatus
automatically queries the user about submitting them to Donaus (at the
end of the session).

<li>The <span class="menu">Add analysis...</span> option now has
&quot;smart&quot; autocompletion for both the basic form (a/k/a lemma,
headword) and the analysis label.

<li>Donatus now supports caching, thus improving the performance and
stability of the system.
</ul>

<li>Improvements to editing
<ul>

<li>Term highlights are preserved during editing.

<li>Expanded (but not selected) paths in the tree remain expanded
after a committed edit (before, they were lost).
</ul>

<li>Bug fixes
<ul>
<li>Bug that sometimes caused hang during quit (on OS X) has been fixed.

<li>Error reporting during XSL transformations is now improved.

<li>URL chooser now moves most recently selected document to the top
of the queue.

<li>xlinks with space characters in the href are now handled
correctly.

<li>Very long messages in dialog boxes are now wrapped.

<li>Some corrections and improvements to Greek orthographic
normalization.
</ul>
</ul>

<h3>Version 4.66</h3>

<ul>
<li>If the <span class="menu">Save
<acronym title="Extensible Markup Language">XML</acronym>
document...</span> option in the context menu is highlighted red, then
changes to the working document must be saved.

<li>A new property instructs Arboreal to ignore tabs and line
terminators within containers (under <span
class="menu">Preferences</span>, <span class="menu">Misc.</span> tab).

<li>The dictionary tool now allows direct lookup of a headword typed
by the user.

<li>The speed performance of the dictionary tool has been considerably
improved.

<li>The morphological system now has support for contextual
morphological identifications and for discontinuously realized lexical
items.


<li>Style nesting in text rendering now behaves correctly; styles
(e.g., bold, italics) are additive.

<li>Strikethrough is now a supported style in the docspecs system.

<li>The langspec system correctly handles language aliasing (e.g.,
<code>el</code> = <code>gre</code> = <code>ell</code>).
<ul>
<li>ISO 639-2 aliases have been added to the default langspecs.
</ul>

<li>The URL chooser no longer remembers duplicate entries.

<li>Bug fixes

<ul>
<li>Arboreal no longer ignores user-supplied docspecs.

<li>Choosing both <span class="menu">Orthographic normalization</span>
and <span class="menu">Regular expression</span> in the search dialog
no longer leads to erratic behavior.

<li>WTag documents (<span class="menu">File &gt; Tag words</span>) can
now be saved.

<li>Stack overflow during XSLT processing is now handled gracefully.

<li>A bug that sometimes caused <span class="menu">Arboreal &gt;

Quit</span> (<kbd>Command</kbd> + <kbd>Q</kbd>) to fail on the Mac has
been remedied.
</ul>
</ul>

<h3>Version 4.5</h3>
<ul>
<li>Editing of text (<acronym title="character data">CDATA</acronym>)
is possible (select <span class="menu">Edit</span> from context menu).
Both master and slave texts may be edited; undo is supported.


<li>Slave texts may be associated with a master text and matching
document in catalog files. Arboreal allows simple loading of slave
texts from a menu, if they are listed in this way.
</ul>

<h3>Version 4.33</h3>
<ul>
<li>Bug fixes
<ul>
<li>Orthographic normalization won't clobber regex searches anymore.

<li>Serialization now respects (preserves) whitespace within
containers (as defined in the docspecs).

<li>Catalog files are loaded additively, as they should have been all
along. Loaded catalog entries may be cleared with <span class="menu">File &gt; Clear
catalog</span>.

<li>Improvements/fixes to Arabic Romanization.
</ul>

<li><span class="menu">Start from root</span> is now selected by
default in the <span class="menu">Find</span> dialog.

<li>The look-and-feel may be customized manually in
<tt>properties.xml</tt> (e.g., to use the new <acronym title="GIMP toolkit">GTK</acronym> <acronym title="look-and-feel">LAF</acronym>
[available in Java 1.4.2+) on Linux or Solaris, add a key
<tt>&lt;laf&gt;com.sun.java.swing.plaf.gtk.GTKLookAndFeel&lt;/laf&gt;</tt>).


<li>The shell script for launching Arboreal on Un*x platforms has been
substantially improved.
</ul>

<h3>Version 4.29</h3>
<ul>
<li>Fixed bug involving removal of necessary whitespace during
normalization (e.g., with
<code>&lt;/expan&gt;&nbsp;&nbsp;&lt;expan&gt;</code>). (This bug had
been reintroduced in 4.2).

<li>Rudimentary support for Archimedes tables has been added to the
default docspecs.

<li>A new option allows for serialization with tabs (on the <span
class="menu">Saving</span> tab under <span
class="menu">Preferences...</span>).


<li>The <span class="menu">Find</span> dialog does not forget language
and text settings.

<li>Recent <acronym title="Uniform Resource Locator">URL</acronym>s in
<acronym title="Uniform Resource Locator">URL</acronym> picker are
preserved between sessions.

<li>Arboreal can load figure thumbnails directly from a Digilib
server.
</ul>

<h3>Version 4.25</h3>
<ul>
<li>Improvements allow for better display of left-to-right text
embedded in right-to-left text (or vice versa).


<li>Bug fixes
<ul>
<li>The content pane is cleared after a text is reloaded.

<li>The user has a chance to save changes to the morphology before a
text is reloaded.

<li>Fixed bug where user was prompted about sending new forms to
Donatus, even when none had been entered.

<li>Passwords are cached on a per-realm basis for
<acronym title="Hypertext Transfer Protocol">HTTP</acronym> authentication,
even on Mac OS.

<li>Default attributes are handled better in documents resulting from
an <acronym title="Extensible Stylesheet Language">XSL</acronym>
transformation.

<li>Better error handling is done during entity management.

<li>Fixed bug that prevented Arboreal from querying user about more
than one changed termlist.

<li>Corrections and improvements for Italian orthographic normalization.
</ul>

</ul>

<h3>Version 4.2</h3>
<ul>
<li>Internal entity management:
<ul>
<li>Arboreal keeps track of all internal entities defined for a
particular document type.

<li>Documents can be serialized with entity references intact.

<li>Entity references can be inherited by a document that results from
an <acronym title="Extensible Stylesheet Language">XSL</acronym>
transformation, provided that the stylesheet specifies that the
output have the same system or public identifier as the source.

<li>New <span class="menu">Saving</span> preferences allow the user to set
serialization properties (including entitization and indentation).

</ul>

<li>Autoscrolling allows the user to select an image rectangle larger
than the current window.
</ul>

<h3>Version 4.11</h3>
<ul>
<li><acronym title="Hypertext Transfer Protocol">HTTP</acronym>
authentication allows for retrieving password-protected content.

<li>Bug fixes
<ul>
<li>Arboreal no longer fails on documents containing comments or
processing instructions.
</ul>
</ul>

<h3>Version 4.0</h3>
<ul>
<li>Lemmatized searching is possible.

<li>New pluggable language architecture:
<ul>
<li>Language-specific settings may be configured via a
<code>langspecs.xml</code> file. These settings include: character
classes and regular expressions for word tokenization, directionality,
and classes to be used for different text views (display filters).

<li>Display filters are loaded dynamically via reflection.
Installation of new filters doesn't require recompilation of Arboreal.

<li>Component orientation is set in accord with main language
directionality (e.g., for Arabic, scroll bars appear on the left side).
</ul>

<li>Improved language support:
<ul>
<li>A <a
href="http://www.loc.gov/catdir/pinyin/romcover.html">Pinyin</a>

Romanization filter has been added for Chinese.

<li>A transliteration filter has been added for Greek.

<li>Substantial improvements have been made to the Arabic filters.
</ul>

<li><a href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Docspecs">Docspecs version 1.1</a> implemented.
<ul>
<li>Rendering of nodes in the tree can be controlled using docspecs
rules.
</ul>

<li>Integration with <a href="http://archimedes.fas.harvard.edu/cgi-bin/donatus">Donatus</a> and
extension of morphological technology:
<ul>

<li>New morphological analyses can be uploaded to Donatus.

<li>Morphological analysis for a document can be loaded dynamically
from Donatus (via an
<acronym title="Extensible Markup Language">XML</acronym>-<acronym title="Remote Procedure Call">RPC</acronym> interface). The user also has the option of
loading a termlist that contains unparsed forms.
</ul>

<li>New <span class="menu">File &gt; Transform...</span> command
allows an arbitrary <acronym title="Extensible Stylesheet Language">XSL</acronym>

transformation to be applied to the current text.

<li>A secondary document where words are explicitly tagged and sorted
by language and container can be produced automatically and opened
from within Arboreal (<span class="menu">File &gt; Tag words</span>).

<li>Bug fixes
<ul>
<li>Drag-and-drop works with
<acronym title="Unicode Transformation Format">UTF</acronym>-8 encoding.

<li><span class="menu">Save as...</span> on termlist renames list in
menu as expected.

<li>A more intelligent heuristic is used for identifying streams of
<acronym title="Multimedia Internet Mail Extensions">MIME</acronym>

type text/xml.
</ul>
</ul>

<h3>Version 3.66</h3>
<ul>
<li>If a pane with highlighted portions that aren't valid words is
dragged onto a term in the term editor, the first invalid portion is
specially marked. This feature is intended to simplify
trouble-shooting of regular expression searches for single and
multiple-part terms.

<li>Links to images may be accompanied by a <tt>&lt;coords&gt;</tt> tag
that specifies a rectangular portion of the image. Arboreal will then
highlight the indicated rectangle; if the user marks a new rectangle,
the attributes of <tt>&lt;coords&gt;</tt> will be updated.
</ul>

<h3>Version 3.56</h3>
<ul>
<li>Fontification works correctly with right-to-left writing
systems.

<li>Horizontal scrollbar behavior is correct for right-to-left
texts.

<li>The <acronym title="Uniform Resource Locator">URL</acronym>
chooser dialog has been improved and now offers a drop-down history
list.

<li>The modifier key for dragging links is now platform-dependent:
<kbd>Shift</kbd> on the Macintosh, <kbd>Ctrl</kbd> elsewhere.

<li>Major improvements to the

<acronym title="Cuneiform Digital Library Initiative">CDLI</acronym>
 docspecs.

<li>Searching works correctly with compound graphemes in
<acronym title="Cuneiform Digital Library Initiative">CDLI</acronym>
docs.
</ul>

<h3>Version 3.42</h3>
<ul>
<li>Results for text searches (and term instances) are displayed in a
tagless format.

<li>Morphology can be edited and saved (see <span
class="menu">Morphology</span> in the context menu).


<li>Orthographic normalization has been added for cuneiform languages.

<li>Arabic Romanization features:
<ul>
<li>Romanized Arabic now uses glyphs from the <a
href="http://www.unicode.org/charts/PDF/U1E00.pdf">Latin Extended
Additional</a> block of Unicode.

<li>The <a href="http://archimedes.fas.harvard.edu/docs/Arabic/keyboards.html">Romanized Arabic
keyboard</a> has been simplified.
</ul>

<li>The modifier key for dragging links has been changed from
<kbd>Ctrl</kbd> to <kbd>Shift</kbd> (<kbd>Ctrl</kbd> caused problems
in the Mac version).

</ul>

<h3>Version 3.3</h3>
<ul>
<li>Numerous improvements have been implemented to the Arabic language
support.
<ul>
<li>Some Arabic features only work properly with Java 1.4.
</ul>

<li>There is now a single
<acronym title="Extensible Markup Language">XML</acronym> morphology
file for all the languages in a text. The old <tt>.forms</tt> files
are no longer supported.


<li>The basic meaning (<em>Grundbedeutung</em>) of a lemma is
displayed in the morphology window. (Donatus currently supports this
feature for Latin, Greek, and German.)

<li>In order to drag links from the content pane, it is now necessary
to hold down the <kbd>Ctrl</kbd> key. This change was motivated by
interference between the popup menu and the drag operation.

<li>The split between the tree and content panes can be switched
between horizontal and vertical orientations.

<li><span class="menu">Tile horizontally</span> and <span
class="menu">Tile vertically</span> commands have been added to the
<span class="menu">Window</span> menu.


<li>It is possible to browse page images with <span class="menu">View
&gt; Show previous</span> and <span class="menu">View &gt; Show
next</span>.

<li>A <span class="menu">Print</span> option is available from the
context menu in the content pane.

<li>Word highlights are preserved when changing views (e.g.,
<span class="menu">Toggle tags</span>).


<li>The <span class="menu">Toggle tags</span> menu item now works
properly on OS X.
</ul>

<h3>Version 3.1</h3>
<ul>
<li>The dictionary window allows the user to change dictionaries, if
more than one is available for the selected language.
</ul>

<h3>Version 3.06</h3>
<ul>
<li>If a bundle contains a file called <code>catalog.xml</code> in the
top directory, it will be loaded automatically as a catalog when a
text in the bundle is loaded.


<li>Regular expressions used in searching are now saved to a file
called <code>regex-log</code> in the user's <code>arboreal</code>
directory.

<li>Arboreal is now supported on <a
href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Installation#Windows">Microsoft Windows</a>.
<li>Bug fixes
<ul>
<li>The option to load large page images will work when catalog is
used.
</ul>
</ul>

<h3>Version 3.01</h3>

<ul>
<li>The mapping file format has been changed (<code>v3</code>) in
order to clarify its proper interpretation (see <a
href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/attachment/wiki/Release%20notes/mapping-skel.txt">skeleton</a>).

<li>Drag-and-drop has been implemented for words that are selected as
the result of a search operation:
<ul>

<li>The highlighting of search words can be controlled by using
parenthesized groups in the regular expression for the search.

<li><acronym title="XML Linking Language">XLink</acronym>s corresponding to
highlighted search words can be dragged from the content pane in which
they appear.

<li>Dragging highlighted words into the term editor can be used for
batch adding of terms.

<li>Batch deletion and reassignment of terms is availabled via
multiple selection in the instances list in the term editor.
</ul>

<li>Arboreal is knowledgeable about default file locations in bundles.


<li>Arboreal keeps better track of what morphology files have already
been loaded.

<li>A portion of the tree may be selected with an 
<acronym title="XML Path Language">XPath</acronym> expression
(<span class="menu">View &gt; Select
<acronym title="XML Path Language">XPath</acronym></span>).
<li><kbd>Ctrl</kbd> + <kbd>.</kbd> (<kbd>Command</kbd> + <kbd>.</kbd> on
the Macintosh) attempts to abort rendering.


<li><acronym title="XML Path Language">XPath</acronym> queries are now
processed more efficiently.

<li>Standard <code>emacs</code> key-bindings work in text input
fields.

<li>Extensions to docspecs system:
<ul>
<li>Text beneath a node can be filtered using Perl substitute syntax
(<code>s/foo/bar/</code>).

<li>The parent of a node can be tested in rendering and filtering rules.

<li>A tag may be specified that serves as a grapheme separator
(implemented for cuneiform texts).
</ul>
</ul>

<h3>Version 2.99h</h3>
<ul>
<li><span class="menu">Jump to mapped node(s)</span> and <span
class="menu">View mapped nodes in tree</span> options appear in
context menu for slave texts.

<li>Improvements to morphology tool (including better support for
alphabetization in various languages).
</ul>

<h3>Version 2.99</h3>
<ul>
<li>When displaying a page image, a menu option <span
class="menu">View &gt; View large image</span> is available.


<li>A <span class="menu">Find</span> operation displays in the status
bar the number of containers in which there is at least one hit.

<li><span class="menu">File &gt; Reload text</span> can be used to
refresh the current document, if it has been changed (e.g., with an
external editor).

<li><acronym title="XML Linking Language">XLink</acronym>s for
selected nodes can be dragged from any content pane to any application
that supports drag-and-drop.

<li>File dialogs contain an <span class="menu">Add to
catalog...</span> button.
<ul>

<li>Metadata from
<acronym title="Extensible Markup Language">XML</acronym> texts is
extracted automatically. Rules for what is considered metadata for
various <acronym title="Extensible Markup Language">XML</acronym>
document types are specified with the docspecs system.

<li>If a file does not contain metadata (or does not contain metadata
in a form that Arboreal recognizes), the user is prompted to enter the
data manually.

<li>After catalog entries are accumulated, they can be written out
with <span class="menu">File &gt; Write new catalog.</span> If no
catalog information has been accumulated, this option will write an
empty &quot;skeleton&quot; catalog.

</ul>

<li>Catalog files may contain relative paths. At the time that they
are loaded, relative paths are converted internally to absolute paths
(relative to the base of the
<acronym title="Uniform Resource Locator">URL</acronym> from which
the catalog file was loaded).

<li>A <span class="menu">Window</span> menu contains the titles of all
text windows open in Arboreal.

<li>The term editor has been redesigned to be more ergnonomic and to
offer increased functionality, in accord with the Berlin workshop of
20 June:
<ul>
<li>A list on the right displays all marked instances of the selected
term (in the current text).
<ul>
<li>Selecting an instance in this list allows the user to edit that
term instance.

<li>Double-clicking on an instance opens a new content frame
displaying the container in which the instance is located.
</ul>

<li>A small content pane near the bottom of the term editor displays
the container in which the instance that is being added or edited is
located. This pane is resizeable, and all normal context-menu
functions are available from within it.

<li>At the top of the term editor the current text and language are
indicated. If the user is not currently editing a term instance, s/he
may choose new settings for these options.

<li>Buttons in the term editor have been relabeled and moved to be
more ergonomic.

<li>Red color coding indicates that the instance that has been added
or selected, or that is being edited, belongs to the selected term.

<li>Contextual messages guide the user through the term instance
addition/editing operations.

<li>Term instance parts may be &quot;dragged off&quot; the saturation
bar. With the addition of this operation, Arboreal allows the full
editing of term instances.

<li>The number of instances, both for the current text, and total, is
displayed after the term (e.g., <tt>[5/10]</tt>).

<li>When displaying all term instances, distinct highlighting
differentiates instances of the selected term from instances of other
terms in the same termlist.

<li>When adding multiple term instance parts, all parts remain
highlighted in the content pane from which they were selected.
</ul>

<li>The format of the mapping file has been revised to allow for fully
reversible <i>n</i>-to-<i>n</i> mappings.

<li>The current directory of file dialogs is preserved between
sessions.

<li>Thumbnail images in a content pane are clickable links to view the
full-size image. Link text no longer appears beside the thumbnail.

<li>Arboreal now displays an <span class="menu">Open text</span>
dialog immediately upon loading.

<li>Notable bugfixes
<ul>
<li>Change of display mode for Greek and Arabic now works reliably.

<li>Ports now work in
<acronym title="Uniform Resource Identifier">URI</acronym>s (e.g.,

<tt>http://archimedes.mpiwg-berlin.mpg.de:8080/</tt>).

<li>Many memory leaks have been closed.
</ul>

<li>Technical improvements
<ul>
<li>Arboreal now uses <a
href="http://xml.apache.org/xalan-j/index.html">Xalan 2.4.D1</a> for
<acronym title="XML Path Language">XPath</acronym> processing.
<li>Arboreal now uses Jakarta ORO for regular expression support. See
the <a href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Regular%20expression%20support">regular expression summary</a>.


<li>Arboreal has been fixed to work with Java 1.4, which is presently
available on Solaris,
<acronym title="GNU's Not Unix">GNU</acronym>/Linux, and Windows. (For
Apple's plans regarding the release of 1.4, see the <a
href="http://developer.apple.com/java/faq/">Java on Max OS X <acronym
title="Frequently Asked Questions">FAQ</acronym></a>.) Cf. <a
href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Java%201.4">Arboreal on Java 1.4 notes</a>.

<li>Layout in content panes is done asynchronously, meaning that there
is no longer a long wait when displaying long texts.
</ul>
</ul>

<h3>Version 2.8</h3>
<ul>
<li><span class="menu">View &gt; Open link(s)</span> displays in the
appropriate tree views the targets of all selected

<acronym title="XML Linking Language">XLink</acronym>. If the target texts are not
already open in a tree, Arboreal opens them as new master texts.

<li>Terminology should now be usable for Chinese.

<li>Notable bugfixes
<ul>
<li>Occasional hangs experienced when displaying new content frames
have been eliminated.
</ul>
</ul>

<h3>Version 2.6</h3>
<ul>
<li><span class="menu">Show page image</span> now appears in the
context menu. Selecting it displays the page image corresponding to
the nearest <tt>&lt;pb&gt;</tt>, starting from the top of the
document. For this to work, there must be an image specified as an

<code>xlink:href</code> on that <tt>&lt;pb&gt;</tt>.

<li><span class="menu">Jump to node</span> in the context menu makes
the relevant node visible in the tree.
<li><span class="menu">View &gt; Select subtree(s)</span> now operates
on <b>all</b> the selected paths, not just the lead path.

<li><span class="menu">View all in tree</span> has a cascading menu
with the choices <span class="menu">Add</span> and <span
class="menu">Replace</span>. The old behavior is <span
class="menu">Replace</span>. The new (<span class="menu">Add</span>)
behavior preserves all currently selected nodes in the tree. <li>Major
speedup to the code that resolves <acronym title="XML Path Language">XPath</acronym>/<acronym title="XML Pointer">XPointer</acronym> queries.


<li>ID-based <acronym title="XML Pointer">XPointer</acronym> queries
will now work even if a
<acronym title="Document Type Definition">DTD</acronym> is absent.

<li>A statusbar allows Arboreal to display informative messages. The
messages are coded by priorty levels (WARN, INFO, DEBUG), and a future
release will allow you to filter out those messages you don't want to
see.
</ul>

<h3>Version 2.5</h3>
<ul>
<li>Arboreal is generalized to work with arbitrary <acronym
title="Document Type Definition">DTD</acronym>s through use of
docspecs. See the <a href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Docspecs">relevant
documentation</a>.


<li><span class="menu">Edit &gt; Copy links</span> copies <acronym
title="XML Linking Language">XLink</acronym> for selected nodes in tree to the
clipboard.

<li>Term editor frame is raised after an illegal operation in term
edit mode, so as to allow operation to be canceled conveniently.

<li>Pressing <kbd>Enter</kbd> functions as a shortcut for <span
class="menu">OK</span> in the find dialog.
</ul>

<h3>Version 2.33</h3>
<ul>
<li>Regular expressions may be used in attribute value searches.

<li>New integrity checking for termlists:
<ul>
<li>Term &quot;name&quot; may not be null.

<li>Some automatic repair of non-conformant termlist files.
</ul>

<li>Major performance improvements to <span class="menu">View in
tree</span>.

</ul>

<h3>Version 2.3</h3>
<ul>
<li>There is now an option to search for attributes. Select the <span
class="menu">Attribute</span> radio button beside <span
class="menu">Search in</span>. You may then type one attribute/value
pair (e.g., &quot;<code>type=head</code>&quot;). [protocol D5]

<li><span class="menu">Cancel</span> now works as expected when
fontifying new text (i.e., bails out).

<li>Application no longer closes unexpectedly when original window is
closed. Arboreal quits only when <em>all</em> main windows have been
closed.


<li>Bug fixes
<ul>
<li>By selecting <span class="menu">View in tree</span> in no-tags
mode, it was possible to get tags in one panel and no tags in another.
<span class="menu">Show tags</span> then merely flipped the states.
FIXED.

<li>A bug prevented preferences from being preserved across sessions
if the directory <code>~/arboreal</code> didn't exist. FIXED.
</ul>
</ul>

<h3>Version 2.28</h3>

<ul>
<li>Termlists have their own colors: these show up in the boxes drawn
around terms as well as in menus. [protocol B2]

<li>Colors can be set through the new configuration facility.

<li>A new configuration facility (with a user-interface within
Arboreal and a new
<acronym title="Extensible Markup Language">XML</acronym> file format
for storing settings) is available. Read its <a
href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Configuration">documentation</a>.

<li>Searching has been changed a little. You now have the options of
<table border="1">
<tr><td>searching whole document:</td><td><tt><b>[+]</b>From root</tt></td><td><tt><b>[+]</b>Recursive</tt></td></tr>

<tr><td>searching just the selected nodes:</td><td><tt><b>[-]</b>From root</tt></td><td><tt><b>[-]</b>Recursive</tt></td></tr>
<tr><td>searching the subtrees of the selected nodes:</td><td><tt><b>[-]</b>From root</tt></td><td><tt><b>[+]</b>Recursive</tt></td></tr>
</table>

<li>A combo box allows you to choose the text you want to search.

<li>Searching is possible in slave texts. At the moment, the search
must start from the root, and the results must be displayed in a
separate frame; Arboreal will not allow you to change these options.
More flexible searching will come with the next release. [protocol B3]

<li>All morphological features work in slave texts. [protocol B3]

</ul>

<h3>Version 2.1</h3>
<ul>
<li>Thumbnails can be displayed inline in the content pane (in
tags-off mode). Arboreal looks for thumbnails in the subdirectory
<code>thumbs</code> of the directory that contains images. E.g., for
<code>figures/1.jpg</code>, the thumbnail will be
<code>figures/thumbs/1.jpg</code>.
</ul>

<h3>Version 2.02</h3>

<ul>
<li>Terminology highlighting takes the form of a box drawn around
terms; other sorts of highlighting are indicated by shading. Both
types of information are now visible simultaneously. [protocol B2]
</ul>

<h3>Version 2.00b</h3>
<ul>
<li>Current selection in tree is preserved when changing tree levels
(<span class="menu">View &gt; Show tree levels</span>). [protocol A4]

<li>Selecting <span class="menu">View in tree</span> in the popup
context menu takes all nodes visible in the current pane and selects
them in the tree view. [protocol A4]

<li>A new property, <code>defaultlang</code>, can be set in

<code>.arboreal.properties</code>. Any document for which no language
is specified is assumed to be in this language. [<font
color="red"><code>.arboreal.properties</code> is obsolete as of 2.23;
see now <a
href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Configuration">Configuring
Arboreal</a></font>]

<li>The link pane (<span class="menu">File &gt; Open links</span>) can
now be closed with "Remove pane" in the popup context menu.

<li>Catalog and canonical name translation services are available.
<ul>

<li>Use <span class="menu">File &gt; Load catalog</span> to load a
catalog file (see <a href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/attachment/wiki/Release%20notes/catalog-skel.txt">skeleton</a>). <li>A
default catalog file can be set with the <code>catalog</code> property
in <code>.arboreal.properties</code> [<font
color="red"><code>.arboreal.properties</code> is obsolete as of 2.23;
see now <a
href="https://itgroup.mpiwg-berlin.mpg.de:8080/tracs/Arboreal/wiki/Configuration">Configuring
Arboreal</a></font>]

</ul>

<li>No longer are there separate online/offline modes.

<li>Terminology functions have been moved under a <span
class="menu">Terms</span> menu.
<ul>
<li>Separate functions are available for loading terms from a file and
for loading terms from the server (database).

<li><span class="menu">Save</span> and <span class="menu">Save
as...</span> functions are now separate. [protocol D1]

<li>Create an empty term list with <span class="menu">New
terms</span>. [protocol D6]


<li>A <span class="menu">Seed terms</span> function allows one to seed
the list of candidate terms with terms from other files. [protocol A5]

<li>A <span class="menu">Close</span> function is also available.

<li>Attempting to close termlists that have been modified results in a
warning. [protocol D1]
</ul>

<li>Multiple termlists can now be open. [protocol A5]
<ul>
<li>Separate termlists are accessed through a cascading ("pull-right")
menu.
</ul>

<li>A combo box in the Term Editor supports viewing of terms in
different languages. [protocol A5]


<li>Arboreal now supports a larger subset of the <a
href="http://ibiblio.org/xml/books/bible2/chapters/ch20.html"><acronym
title="XML Pointer">XPointer</acronym></a> syntax. Arboreal can
process all <acronym title="XML Pointer">XPointer</acronym>
expressions that are valid
<acronym title="XML Path Language">XPath</acronym> expressions;
Arboreal also understands the short form <code>xyz</code> for
<code>id(&quot;xyz&quot;)</code>.

<ul>
<li>When Arboreal generates an
<acronym title="XML Pointer">XPointer</acronym> expression for a
container node in the DOM tree, it references the container's
<code>id</code>, if that is available. If no <code>id</code> is
available, Arboreal generates an
<acronym title="XML Pointer">XPointer</acronym> that references the
node by its relative position in the tree.

<li>Arboreal can only make use of <code>id</code>
<acronym title="XML Pointer">XPointer</acronym>s if the document has a

<acronym title="Document Type Definition">
DTD</acronym> that defines an identifier <code>id</code> of type
<code>ID</code>. Arboreal must be able to see the <acronym
title="Document Type Definition">DTD</acronym> if it is to evaluate
such expressions. [<font color="red">This limitation has been removed
as of 2.6.</font>]
</ul>

<li>Fixed bug involving removal of necessary whitespace during
normalization (e.g., with

<code>&lt;expan&gt;&nbsp;&nbsp;&lt;expan&gt;</code>). [protocol D9]

<li><span class="menu">Open text</span> opens additional master texts
in new frames; these texts share all open terminology lists. [protocol
B1]

<li><acronym title="Extensible Markup Language">XML</acronym> files
pointed to by <acronym title="XML Linking Language">XLink</acronym> can be opened
as new master texts.
</ul>

<h3>Version 1.85</h3>
<ul>

<li>Support for opening links. Links are opened by selecting <span
class="menu">Open link</span> in the popup context menu. A link is any
element with an <code>xlink:href</code> attribute. [protocol A2]
<ul>
<li>The "xlink" namespace should be imported in the <acronym
title="Document Type Definition">DTD</acronym>.
</ul>

<li>Image files pointed to by links can be opened natively in
Arboreal. The following heuristic is used to identify image files: the
<acronym title="Uniform Resource Identifier">URI</acronym> ends in one
of the extensions <code>gif</code>, <code>jpg</code>,

<code>jpeg</code>, <code>png</code>. These extensions represent the
image file formats for which Java currently provides support. Support
for <acronym title="Tagged Image File Format">TIFF</acronym> will be
added to <acronym title="Java Development Kit">JDK </acronym>1.4 and
will be available for Arboreal then. [protocol A1/A2]

<li><acronym title="Uniform Resource Identifier">URI</acronym>s with
<acronym title="XML Pointer">XPointer</acronym>s can be opened in
Arboreal. Currently, only a small subset of the
<acronym title="XML Pointer">XPointer</acronym> syntax is supported.
More will come. [protocol A2]

<li>Arboreal will spawn an external browser (such as Netscape or
Internet Explorer) to display all other links. [protocol A2]


<li>Mapping files use new
<acronym title="Document Type Definition">DTD</acronym> [<font
color="red">link removed: obsolete as of 2.99</font>].

<li>Ability to edit and to remove terms. [protocol A3]
<ul>
<li>Term removal is disabled in online mode.
</ul>
</ul>


}}}