here's another allout.el update.  this fixes some navigation and
encryption passphrase errors, runs the mode activation hook at a more
suitable time, adds a mode deactivation hook, and provides a set of
outline structure-edit hooks analogous to (a refined)
allout-exposure-change-hook.

the contingent of hooks will enable people to build allout
enhancements that cooperate with the existing code, rather than
needing to change it.  (i happen to be building such an enhancement,
and it's working out very well.  once you find your way, emacs is a
quite nice platform, and it's getting nicer - i love v22.)

the change log is below and attached.  i also attached a new copy of
the NEWS file including the new significant facts, as well as the
patch.

2006-07-18  Ken Manheimer  <ken.manheimer@gmail.com>

	* allout.el (allout-prior-bindings, allout-added-bindings):
	Remove, after long deprecation.
	(allout-add-resumptions): Add optional qualifier for extending or
	appending to existing values, rather than replacing them.
	(allout-view-change-hook): Clarify docstring.
	(allout-exposure-change-hook): Take explicit arguments, via
	run-hook-with-args.
	(allout-structure-added-hook)
	(allout-structure-deleted-hook)
	(allout-structure-shifted-hook): New hooks analogous to
	allout-exposure-change-hook for other kinds of structural outline
	edits.
	(allout-encryption-plaintext-sanitization-regexps): New encryption
	customization variable, by which cooperating modes can provde
	massage of the plaintext without actually being passed it.
	(allout-encryption-ciphertext-rejection-regexps)
	(allout-encryption-ciphertext-rejection-ceiling): New encryption
	customization variables, by which cooperating modes can prohibit
	rare but possible ciphertext patterns from fouling their
	operation, with actually being passed the ciphertext.
	(allout-mode): Run activation and deactivation hooks after the
	minor-mode variable has been toggled, to clarify the mode
	disposition.  The new encryption ciphertext rejection variable is
	used to ensure that the ciphertext does not contain text that
	would be recognized as outline structural elements by allout.
	(allout-chart-subtree): Implement new mode, charting only the
	visible items in the subtree, when new 'visible' parameter is
	non-nil.
	(allout-end-of-subtree): Properly handle the last item in the
	buffer.
	(allout-pre-command-business, allout-command-counter): Increment
	an advertised counter so that cooperating enhancements can track
	revisions of items.
	(allout-open-topic): Run allout-structure-added-hook with suitable
	arguments.
	(allout-shift-in): Run allout-structure-shifted-hook with suitable
	arguments.
	(allout-shift-out): Fix doubling for negative args and ensure call
	of allout-structure-shifted-hook by solely using allout-shift-in.
	(allout-kill-line, allout-kill-topic): Run
	allout-structure-deleted-hook with suitable arguments.
	(allout-flag-region): Run allout-exposure-change-hook with
	suitable arguments, instead of making the callee infer the
	arguments.
	(allout-encrypt-string): Support
	allout-encryption-plaintext-sanitization-regexps,
	allout-encryption-ciphertext-rejection-regexps, and
	allout-encryption-ciphertext-rejection-ceiling.  Indicate correct
	en/de cryption mode in symmetric encryption failure message.
	(allout-obtain-passphrase): Use copy-sequence to get a distinct
	copy of the passphrase, and don't zero it or we'll corrupt the
	stashed copy.
	(allout-create-encryption-passphrase-verifier)
	(allout-verify-passphrase): Respect the new signature for
	allout-encrypt-string.
	(allout-get-configvar-values): Convenience for getting a
	configuration variable value and handling its absence gracefully.


-- 
ken
ken.manheimer@gmail.com
http://myriadicity.net