EMHACKS

File Release Notes and Changelog

Release Name: 2.0

Notes:
tree-widget version 2.0

tree-widget is a widget library to display data structures organized
in a hierarchical order (trees).

You can see some nice screen shots of tree-widget 2.0 in action <a href="http://emhacks.sourceforge.net/tw-shots.html">here</a>

Since previous version 1.2, tree-widget 2.0 introduced:

- A new tree layout based on exclusive use of child widgets.  This
  way, the standard widget library (wid-edit) totally draws the tree.
  Previously tree-widget drew itself parts of the tree with strings.

- Image support(*) via the :tag-glyph feature of standard widgets, to
  draw nice-looking trees (see the screen shots).

- Image themes, to easily change trees' look and feel.  For now two
  themes are provided: a `default' general purpose theme, and a
  file-system-oriented `folder' theme (see the screen shots).

(*) Unfortunately, image support works only with GNU Emacs 21.
tree-widget include the necessary code for XEmacs but I didn't managed
to make it work correctly (using XEmacs 21.4.13 on Windows NT4).
It seems that nested XEmacs' widgets fail to display adjacent images
:-(

tree-widget 2.0 should be backward-compatible with code written to use
version 1.x.  It should work on recent versions of [X]Emacs.  I tested
it with:
 
- GNU Emacs 20.7, 21.3.1, 21.3.50.1, and XEmacs 21.4.13 on Windows NT4
- GNU Emacs 21.3.50.1 on GNU/Linux RH 7.1 (Lesstif)
- GNU Emacs 21.3.1 on Sparc Solaris 8 (Motif)

To install tree-widget unpack the distribution tarball
(tree-widget-VERSION.tar.gz) in a directory on your load-path.

To run the provided examples:

M-x load-library RET dir-tree RET
M-x dir-tree RET

M-x load-library RET tree-widget-examples RET
M-x tree-widget-example-1 RET
C-u M-x tree-widget-example-1 RET
M-x tree-widget-example-11 RET
M-x tree-widget-example-2 RET

Enjoy!
David


Changes:
2003-10-01 18:56  ponced

	* tree-widget.el (1.12):

	Improve the "Commentary:" section.

2003-09-30 14:01  ponced

	* dir-tree.el (1.4):

	(dir-tree-expand-dir): Make more robust.

2003-09-30 12:16  ponced

	* tree-widget.el (1.11):

	(tree-widget--image-cache): Move.  Make buffer local.
	(tree-widget--clear-images-and-set): Remove.  All callers updated.

2003-09-30 08:44  ponced

	* dir-tree.el (1.3):

	(dir-tree): Use the "folder" theme.

2003-09-29 23:30  ponced

	* tree-widget.el (1.10):

	Byte-compile cleanly.
	(tree-widget-use-image-p) [Emacs]: Use `display-images-p'.
	(tree-widget-image-type-available-p): Use in-line definition
	instead of defalias.

2003-09-29 15:41  ponced

	* tree-widget-examples.el (1.4):

	(tree-widget-example-1): Can prompt for an alternate image theme
	to use.

2003-09-29 15:40  ponced

	* tree-widget.el (1.9):

	(tree-widget--theme): New internal buffer local variable.
	(tree-widget-set-theme): New function.
	(tree-widget-find-image): Use local theme.

2003-09-29 12:27  ponced

	* tree-widget.el (1.8):

	Major version that introduces new tree layout based on widgets
	only, and image support on GNU Emacs 21.

	Code and whitespace cleanup.
	(tree-widget-version): Update to 2.0.
	(tree-widget-node-handle-widget): Remove.
	(tree-widget--image-cache): New variable.
	(tree-widget--clear-images-and-set): New function.
	(tree-widget-image-enable)
	(tree-widget-themes-directory, tree-widget-theme)
	(tree-widget-image-properties-emacs)
	(tree-widget-image-properties-xemacs): New options.
	(tree-widget-use-image-p)
	(tree-widget-image-type-available-p)
	(tree-widget-create-image)
	(tree-widget-image-conversion)
	(tree-widget-find-image): New functions.
	(tree-widget-node-handle): Remove.
	(tree-widget-control, tree-widget-open-control)
	(tree-widget-empty-control, tree-widget-close-control)
	(tree-widget-leaf-control, tree-widget-guide)
	(tree-widget-end-guide, tree-widget-no-guide)
	(tree-widget-handle, tree-widget-no-handle): New widgets.
	(tree-widget): Remove tree element strings.
	(tree-widget-p, tree-widget-get-super): Doc fix.
	(tree-widget-keep): Use dolist.
	(tree-widget-super-format-handler): New function.
	(tree-widget-format-handler): Use it.  Mark as obsolete.
	(tree-widget-node): Cleanup.
	(tree-widget-open-control, tree-widget-close-control)
	(tree-widget-empty-control, tree-widget-leaf-control)
	(tree-widget-guide, tree-widget-end-guide)
	(tree-widget-no-guide, tree-widget-handle)
	(tree-widget-no-handle): New functions.
	(tree-widget-children-value-save): Cleanup.
	(tree-widget-toggle-folding): Remove.
	(tree-widget-close-node, tree-widget-open-node): New functions.
	(tree-widget-value-delete): Cleanup.
	(tree-widget-value-create): New implementation to use only
	widgets and handle images.
	(tree-widget-map): Cleanup.

2003-09-29 12:26  ponced

	* tree-widget-examples.el (1.3):

	Code and whitespace cleanup.
	(tree-widget-examples-version): Update to 1.2.
	(tree-widget-example-1): Add leaf nodes.  Better node names.
	(tree-widget-example-2-dynargs): Likewise.
	(tree-widget-example-2): Likewise.

2003-09-29 12:25  ponced

	* dir-tree.el (1.2):

	Code and whitespace cleanup.
	(dir-tree-file-widget): Remove obsolete use of :format-handler.
	(dir-tree): Move point at beginning of buffer.