allout revision

[Ken Manheimer]

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  <address@hidden>

        * 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
address@hidden
http://myriadicity.net

allout-patch.txt
Description: Text document

ChangeLog-entry.txt
Description: Text document

allout-NEWS.txt
Description: Text document