How exactly do we handle the NEWS entries for packages? In the old,
pre-package times, I would have liked to announce changes in
`htmlize' between 21.4 and (the hypothetical) 21.5 like this:
* htmlize 1.16 contains many improvements over the version 0.69
shipped with XEmacs 21.4, including:
** A stable API that Lisp code can use to invoke features of htmlize.
(This is what prompted the major version increase. I plan not to
change the API incompatibly without also bumping the major version.)
** Better I18N support under Mule. htmlize can now convert non-ASCII
characters to HTML (Unicode) entities. Alternatively, it allows you
to specify the charset that the resulting HTML will declare using the
META tag.
** Better support for operation under TTY's and better
color-robustness in general -- if a color cannot be resolved to RGB,
it is copied to the resulting HTML intact. (0.69 would throw a
cryptic error.)
** Invisible regions of buffer are ignored during conversion.
** Overlapping faces are merged. This applies both to face lists in
the `face' text property and to multiple faces specified by all
extents overlapping a region. (0.69 completely ignored multiple
faces.)
<!-- [This wouldn't go in XEmacs]
** Some of the GNU Emacs 21 face attributes are now supported.
E.g. strike-through and overline are recognized.
** Emacs 20+ property lists instead of faces are supported as well.
E.g. (put-text-property START END '(:foreground "red")) will be
recognized by `htmlize' when generating the HTML.
-->
* The buffer is untabified before conversion to HTML.
How does this kind of announcement fit into the world of packages?