* COPYRIGHT

Copyright (C) 2001-2025 Free Software Foundation, Inc.
See the end of the file for license conditions.

* Changes in MH-E 8.6

Version 8.6 fixes composition errors in nmh 1.6.

** Bug Fixes in MH-E 8.6

*** Add support for nmh 1.5

A components file is now generated that works with nmh 1.5 (partially
closes SF #468).

*** Error if mh-x-face-file is nil

Ensure that `mh-x-face-file' is a string before trying to use it
(closes SF #474).

*** MH-Folder buffer includes "scan: bad message list unseen"

Fix this error (closes SF #471).



* Changes in MH-E 8.5

Version 8.5 fixes bugs when incorporating or forwarding mail.

** Bug Fixes in MH-E 8.5

*** mh-rmail doesn't switch to +inbox

The function `mh-rmail' now switches to `+inbox' as expected (closes
SF #271).

*** Problem forwarding a message

Forwarding messages resulted in the error: `(wrong-type-argument
number-or-marker-p nil).' This has been fixed by setting the mail
separator (closes SF #270).



* Changes in MH-E 8.4

Version 8.4 postpones junk processing and merges in your components
file when re-editing a draft. A few bugs were also fixed.

** New Features in MH-E 8.4

*** Postpone junk processing

The `J w' (`mh-junk-whitelist') and `J b' (`mh-junk-blacklist')
commands now mark the message. Like with other marks, this mark can be
removed with `u' (`mh-undo') and processed with `x'
(`mh-execute-commands'). Thanks to Ted Phelps (closes SF #2945712).

** New Variables in MH-E 8.4

*** mh-blacklist-msg-hook

Hook run by `J b' (`mh-junk-blacklist') after marking each message for blacklisting.

*** mh-whitelist-msg-hook

Hook run by `J w' (`mh-junk-whitelist') after marking each message for whitelisting.

*** mh-whitelist-preserves-sequences-flag

Non-nil means that sequences are preserved when messages are
whitelisted.

** New Faces in MH-E 8.4

*** mh-folder-blacklisted

Blacklisted message face.

*** mh-folder-whitelisted

Whitelisted message face.

** Bug Fixes in MH-E 8.4

*** mh-edit-again should add Fcc

More generally, `mh-edit-again' now merges the components file into
the draft (closes SF #1708292).

*** Loses changes when message column goes from 1 to 2 digits

Call `mh-process-or-undo-commands' before running inc to insure we do
not lose any pending changes (closes SF #2321115).

*** mh-yank-cur-msg fails in emacs 23

Replace usage of `set-buffer' with `with-current-buffer' (closes SF
#2830504).

*** Folder pack action (Fp) missing in show mode

Add missing key binding for `mh-show-pack-folder' (closes SF #3466086).



* Changes in MH-E 8.3.1

This version of MH-E fixes typos in the documentation and is packaged
with GNU Emacs 24.1

* Changes in MH-E 8.3

In 2010, the version control system (VCS) of Emacs was upgraded from
CVS to Bazaar. In 2011, the MH-E team followed suit and upgraded the
MH-E repository at SourceForge from CVS to Bazaar as well. The result
is version 8.3 of MH-E, which includes needed changes to the build
scripts.

Otherwise, this is a small release that includes mostly internal
changes from the Emacs team. One of these changes manifests itself in
the user interface--you can now complete folders with abbreviations,
meaning that `+f/b/b TAB' can complete to `+foo/bar/baz'.

Also, RFC 2047-encoded Subject header fields in replies are now
decoded.

It also fixes compilation warnings in XEmacs 21.5.31, as
well as an error when running XEmacs 21.5.31 in a terminal.

Another implication of the VCS change is that users who download MH-E
from SourceForge and explicitly load MH-E will have to be change their
`load-path' to "/path/to/mh-e/emacs/trunk/lisp/mh-e" instead. Note the
addition of "trunk."

** Bug Fixes in MH-E 8.3

*** Make mh-showing a legitimate minor mode

The `mh-showing-mode' variable is now defined with `define-minor-mode'
(closes SF #482666).

*** Desktop fails to restore MH-Folder buffers

When restoring MH folders from ".emacs.desktop", Emacs now opens them in
the expected `mh-folder' mode instead of `dired-mode' (closes SF #1510145)

*** *MH-E Log* buffer can point to removed directory
This was caused by using `set-buffer' instead of
`with-current-buffer.' This has been fixed thanks to Stefan Monnier
(closes SF #1903293).



* Changes in MH-E 8.2

Version 8.2 of MH-E appeared in GNU Emacs 23.1.  This is a small
release that includes internal changes from the Emacs team. A new
hook, `mh-pack-folder-hook', has been added.

There is a known bug where you can't attach attachments in Emacs 21.
This will be fixed in 8.2.1.

** New Variables in MH-E 8.2

*** mh-pack-folder-hook

The `mh-pack-folder-hook' is run by `F p' (`mh-pack-folder') after
renumbering the messages. Hook functions can access the current folder
name with `mh-current-folder'.

** Bug Fixes in MH-E 8.2

*** New version of mh-mm-save-part

Several functions have been updated with code from Gnus 5.11 (closes
SF #2235022).



* Changes in MH-E 8.1

Version 8.1 fixes some issues with forwarding messages, respects the
MH environment variable, adds the abilities to use aliases with GPG
and show HTML even though it is discouraged. A new hook,
`mh-annotate-msg-hook', has been added.

** New Features in MH-E 8.1

*** Showing HTML When Text Is the Preferred Alternative

The `:' (`mh-show-preferred-alternative') function displays the
message with the default preferred alternative. This is as if
`mm-discouraged-alternatives' was set to nil (closes SF #1777321).

** New Variables in MH-E 8.1

*** mh-annotate-msg-hook

The `mh-annotate-msg-hook' hook is run whenever a message is sent and
after the scan lines and message are annotated. Hook functions can
access the current folder name with `mh-current-folder' and obtain the
message numbers of the annotated messages with `mh-annotate-list'
(closes SF #2032269).

** Bug Fixes in MH-E 8.1

*** Can't Use Aliases with GPG

GPG requires e-mail addresses, not aliases. So resolve aliases before
passing addresses to GPG/PGP (closes SF #649226).

*** mh-mml-forward-message: Disposition Should Be Inline

The `f' (`mh-forward') function now forwards messages as inline
attachments (closes SF #1378993).

*** Illegal Filename Characters on Windows Filesystems

The X-Image-URL cache created filenames with invalid characters on
Windows. This has been fixed with assistance from Darel Henman (closes
SF #1396499).

*** Make Many Header Fields Invisible

A vast landscape of header fields are now invisible. You may wish to
browse `mh-invisible-header-fields-default' and clean up your
`mh-invisible-header-fields' option. A permanent bug (SF #1916032) has
been created where you can submit header fields that should be
rendered invisible (closes SF #1701231).

*** mh-forward Includes Messages in Reverse Order

The `f' (`mh-forward') function now includes messages in ascending
order (closes SF #1730393).

*** Compile Fails on XEmacs 21.5 beta 28

This has been fixed with help from Henrique Martins (closes SF
#1749774).

*** Rename Variant mu-mh to gnu-mh

The GNU mailutils MH variant was named inconsistently. The variant has
been renamed to gnu-mh throughout. Thanks to Darel Henman (closes SF
#1768928).

*** Respect MH environment Variable

Even if the MH environment variable was set, an error was generated if
"~/.mh_profile" was missing. This has been fixed thanks to Xavier
Maillard (closes SF #1946861).

*** Enhance mh-mairix-regexp-builder

Additional items have been added to the Mairix search string in order
to support org-mode. Thanks to Nick Dokos (closes SF #1965704).

*** mh-mh-to-mime and mh-mh-to-mime-undo Reset Modes

The functions `mh-mh-to-mime' and `mh-mh-to-mime-undo' would reset the
buffer to fundamental mode. This has been fixed thanks to Sergey
Poznyakoff (closes SF #1966722).



* Changes in MH-E 8.0.3

Version 8.0.3 fixes errors in sending messages and in running spam
filter commands in certain circumstances.

** Bug Fixes in MH-E 8.0.3

*** mh-send-args Cannot Be nil

If `mh-send-uses-spost-flag' was set, an error would prevent the
sending of messages. This has been fixed (closes SF #1564742).

*** Missing Quotes in sa-learn Command Line

This has been fixed (closes SF #1565460).

*** Errors Associated with mh-junk-background

The SpamAssassin filter commands were used inconsistently and
incorrectly; if `mh-junk-background' were nil, not all of the updating
would happen correctly. In the other back-ends such as bogofilter and
SpamProbe, a value of t for `mh-junk-background' would cause the
commands associated with these filters to fail. These problems have
been fixed (closes SF #1594802).



* Changes in MH-E 8.0.2

Version 8.0.2 fixes the tool bar and `F n' on XEmacs, and `K a' on GNU
mailutils.

** Bug Fixes in MH-E 8.0.2

*** Tool Bar Not Displayed in XEmacs

The MH-E tool bar didn't show up in XEmacs; now it does. Thanks to Ted
Phelps <phelps@gnusto.com> (closes SF #1506846).

*** mh-mime-save-parts Assumes -store Default

It was assumed that -store was the default for both mhn and mhstore.
This has been fixed by using -store except when using nmh. Thanks to
Sergey Poznyakoff <gray@Mirddin.farlep.net> (closes SF #1513140).

*** F-n Doesn't Work

The fix for SF #1499712 broke `F n' (`mh-index-new-messages') on
XEmacs since a regular expression that XEmacs could not handle was
added. This regexp has been fixed (closes SF #1514424).



* Changes in MH-E 8.0.1

Version 8.0.1 works around a couple of bugs in GNU mailutils, spost,
and Windows. MH-E now requires the use of version 1.0 of mailutils due
to a bug in the folder command.

** Bug Fixes in MH-E 8.0.1

*** Infinite Loop When Searching (mailutils)

The GNU mailutils folder command displays output when a folder doesn't
exist. MH-E didn't expect this and responded with an infinite loop
during searches. While this bug has since been fixed in mailutils,
MH-E has been modified to work anyway (closes SF #1499712).

*** spost Doesn't Have -msgid or -mime Flags

The post replacement spost does not support the -msgid or -mime flags.
A new variable `mh-send-uses-spost-flag' was added to control the use
of these flags (closes SF #1486726).

*** <2> in Search Folders Illegal in Windows

The <2> suffix to the search folder names contain illegal filename
characters in Windows. These cause searches to fail on Windows. This
has been fixed by changing the suffix to -2 (closes SF #1507002).



* Changes in MH-E 8.0

Version 8.0 supports GNU mailutils, S/MIME, picons, which-func-mode,
sports an improved interface for hiding header fields, improves upon
the MH variant detection, improves folder completion, makes the pick
search equivalent to the other types of searches, spruces up the tool
bar, creates the correct MIME type when including OpenOffice
documents, works on a Mac, adds colors to buttons for signed or
encrypted messages, incorporates new features introduced in
Emacs 22.1, fixes a bunch of bugs, and best of all, comes with an
updated manual!

Internally, MH-E now sports a new software organization which will
help future maintainability. As a side-effect, the number of XEmacs
compilation warnings has plummeted from hundreds to just three. CVS
users will notice that MH-E has been migrated from the CVS repository
from SourceForge to Savannah (but only for those files that were
already part of Emacs). As a result, the location of MH-E in the
load-path has changed, and mh-e-autoloads.el was renamed to
mh-autoloads.el. See section INSTALL in the README for details. While
this migration will benefit maintainers, it will also benefit users:
CVS Emacs users will not have to check out MH-E separately and welcome
faster MH-E updates, and CVS MH-E users will welcome faster MH-E
updates from Emacs developers. Read section CVS MH-E INSTALL in the
README for details.

While not related to this release, the MH-E mailing lists are now
gatewayed at gmane.org (closes SF #979308).

If you want to see the release notes for the alpha and beta releases
leading up this release, please see:

  https://cvs.savannah.gnu.org/viewvc/emacs/emacs/etc/MH-E-NEWS?revision=1.25&view=markup



** New Features in MH-E 8.0

*** GNU mailutils Support

MH-E now supports GNU mailutils 0.4 and higher versions.

*** S/MIME Support

MH-E now supports S/MIME using Gnus 5.10.6 or higher.

*** Picon Support

In addition to the other methods of displaying an icon for the sender
of a message, MH-E can now display images from a picon directory. The
directory search path is found in the `mh-picon-directory-list'
variable. More documentation is found in the "facedb" sections in the
xfaces man page.

*** Catchup Command

There is a new `F c' (`mh-catchup') command that marks all unread
messages in the current folder as read.

*** Use which-func-mode to Display Folder in Index Mode

Turning on `which-func-mode' displays the folder name of the message
under the cursor in index folders (closes SF #855520).

*** Quick Key Help

The `?' (`mh-help') function now displays the help in its own buffer
called *MH-E Help* (closes SF #493740 and SF #656631).

*** Search Unification

The old `F s' behavior of adding messages to the search sequence has
been removed. The `F i' keybinding was deprecated and the new `F s'
(`mh-search') command is used to initiate either indexed or pick
searches. Within the MH-Search buffer (renamed from MH-Pick), the
command `C-c C-p' (`mh-pick-do-search') now runs pick on the given
folder recursively and displays the results in a search folder like
the other search methods (closes SF #829207).

*** Entry Points Have Moved

Emacs 21 users must now add `(require 'mh-autoloads)' because the
entry points (such as `mh-rmail' and `mh-smail') have moved to
different files which have made the autoloads that come with Emacs
inaccurate. This change was necessary because the code was reorganized
to remove circular dependencies, to make the code more stable and
maintainable, and to reduce the time to load MH-E.

*** MH-Folder Keymap Changes

There is now a keymap for the printing functions whose prefix is `P'.
The command `l' (`mh-print-msg') has been replaced with `P l' although
we suggest you use the new `P p' instead.

Key          7.4.4                         8.0

;            -                             mh-toggle-mh-decode-mime-flag
l            mh-print-msg                  -
/ f          mh-narrow-to-from             -
/ r          mh-narrow-to-range            -
/ g          -                             mh-narrow-to-range
/ m          -                             mh-narrow-to-from
F c          -                             mh-catchup
F i          mh-index-search               -
F s          mh-search-folder              mh-search
K e          -                             mh-display-with-external-viewer
K t          -                             mh-toggle-mime-buttons
P ?          -                             mh-prefix-help
P C          -                             mh-ps-print-toggle-color
P F          -                             mh-ps-print-toggle-faces
P f          -                             mh-ps-print-msg-file
P l          -                             mh-print-msg
P p          -                             mh-ps-print-msg

*** MH-Letter Keymap Changes

The change where `mh-letter-mode' derives from `mail-mode' adds a few
keybindings. Some are interesting: experiment! Only the keybinding
changes for MH-E functions are listed here.

Most of the changes have to do with the renaming of the functions with
"mhn" in them to "mh" because nmh doesn't use `mhn'. The names were
also made consistent with the family of "mml" functions.

The type of signing or encryption has been generalized so the method
is now an option rather than a part of the function's name. The option
is `mh-mml-method-default' and choices include PGP (MIME), PGP,
S/MIME, or none.

Key          7.4.4                         8.0

C-c C-e      mh-edit-mhn                   mh-mh-to-mime
C-c RET C-e  mh-mml-secure-message-encrypt-pgpmime
                                           mh-mml-secure-message-encrypt
C-c RET C-g  -                             mh-mh-compose-anon-ftp
C-c RET C-n  -                             mh-mml-unsecure-message
C-c RET C-s  mh-mml-secure-message-sign-pgpmime
                                           mh-mml-secure-message-sign
C-c RET C-t  -                             mh-mh-compose-external-compressed-tar
C-c RET C-u  mh-revert-mhn-edit            mh-mh-to-mime-undo
C-c RET C-x  -                             mh-mh-compose-external-type
C-c RET e    mh-mml-secure-message-encrypt-pgpmime
                                           Prefix Command
C-c RET e e  -                             mh-mml-secure-message-encrypt
C-c RET e s  -                             mh-mml-secure-message-signencrypt
C-c RET g    -                             mh-mh-compose-anon-ftp
C-c RET n    -                             mh-mml-unsecure-message
C-c RET s    -                             Prefix Command
C-c RET s e  -                             mh-mml-secure-message-signencrypt
C-c RET s s  -                             mh-mml-secure-message-sign
C-c RET t    -                             mh-mh-compose-external-compressed-tar
C-c RET u    mh-revert-mhn-edit            mh-mh-to-mime-undo
C-c RET x    -                             mh-mh-compose-external-type

C-c C-f C-a  -                             mh-to-field
C-c C-f C-l  -                             mh-to-field
C-c C-f RET  -                             mh-to-field
C-c C-f a    -                             mh-to-field
C-c C-f l    -                             mh-to-field
C-c C-f m    -                             mh-to-field

*** MH-Search Keymap Changes

These are the changes associated with the new search mode. The command
`C-c C-c' (`mh-index-do-search') now performs the standard indexed
search, while `C-c C-p' (`mh-pick-do-search') runs pick as before,
only better!

The `mh-to-field' keybindings were adjusted to be consistent with
those in the MH-Letter mode.

Key          7.4.4                         8.0

C-c C-c      mh-do-search                  mh-index-do-search
C-c C-f C-d  mh-to-field                   -
C-c C-f C-f  mh-to-field                   -
C-c C-f C-r  mh-to-field                   -
C-c C-f RET  -                             mh-to-field
C-c C-f d    mh-to-field                   -
C-c C-f f    mh-to-field                   -
C-c C-f m    -                             mh-to-field
C-c C-f r    mh-to-field                   -
C-c TAB      mh-index-do-search            -

*** Updates to X-Image-URL

Now support the use of `curl' and `fetch' as alternatives to `wget' to
obtain the image. The display of images are controlled with the
`mh-show-use-xface-flag' option while the `mh-fetch-x-image-url'
option controls how the images are fetched.

The default of `mh-fetch-x-image-url' has been changed to "Never
Fetch." Those of you who like the value of "Ask Before Fetching" will
have to customize this option (closes SF #831278).

WARNING: There are security concerns with this feature. Please read
the documentation for these options carefully before changing the
default.

*** Updates to mh-identity-list

Note that the field names found in `mh-identity-list' that refer to
the fields in `mh-identity-handlers' have changed in an incompatible
way from 7.4.4. In general, the symbolic names now have a ":" prefix
to avoid collisions with header fields. Before starting Emacs, edit
your .emacs and insert ":" before "signature" if you have defined it.

You can change your attribution in replies with the new "Attribution
Verb" field, and you can set your default GPG user ID with the "GPG
key ID" field.

Signatures can now be read from the `mh-signature-file-name' variable,
or come from a function, in addition to a named file. If you write
your own function, variables that you can use include
`mh-signature-separator-regexp', `mh-signature-separator',
and `mh-signature-separator-p'.

The handling of these fields has been moved into a new
`mh-identity-handlers' option, an alist of fields (strings) and
handlers (functions). Strings are lowercase. Use ":signature" for
Signature and ":pgg-default-user-id" for GPG Key ID. The function
associated with the string "default" is used if no other functions are
appropriate. For this reason, don't name a header field "Default".

If you point your signature at a vCard file with a vcf suffix, then it
will be incorporated as a vCard body part (closes SF #802723).

*** Updates to Speedbar

The speedbar now renders the folders with unseen messages in boldface
which makes them easier to identify (closes SF #623369).

*** Updates to mh-msg-is-in-seq

Can now specify an alternate message number to `S s'
(`mh-msg-is-in-seq') with a prefix argument.

*** Updates to mh-to-field-choices

In MH-Letter mode, you can use the `C-c C-f' (`mh-to-field') prefix to
go to and insert fields. The fields `Reply-To:', `Mail-Reply-To:',
`Mail-Followup-To:' can now be created via the `C-r', `C-a' (for
author), and `C-l' keys respectively. The key for the `From:' field
has been renamed from `C-r' to `C-m' for consistency with `mail-mode'
(closes SF #1400139).

*** Change Content-Type Renderer on the Fly in MH-Show Buffer

This has been implemented by adding the key binding `K e'
(`mh-display-with-external-viewer'). For inline text/html parts,
buttons aren't displayed by default. In that case use `K t'
(`mh-toggle-mime-buttons') to display the button before viewing it
with an external browser (closes SF #839318).

*** MH-E No Longer Calls install-mh

The new variant detection code makes use of `mhparam' which assumes
that your MH environment has already been set up. The code to call
`install-mh', which could no longer be run anyway, was removed.

*** Add :package-version Keyword to Options

This `defcustom', `defgroup', and `defface' keyword was introduced in
Emacs 22.1. MH-E has been extended to take advantage of it. With this
keyword, you can now use `M-x customize-changed-options' to see what
options in MH-E have changed between versions of Emacs. In a future
version of Emacs, you'll be able to see changes between MH-E versions
as well (closes SF #1452724).

*** Render Signature and vCard in Italics

This has been implemented.  Use `mh-show-signature-face' to customize
the face used (closes SF #802722).

*** Derive mh-letter-mode from mail-mode

MH-Letter mode is now derived from `mail-mode'. We were able to delete
a lot of code. In return, there are a few `mail-mode' commands that
are available that may or may not be useful and the `mail-mode-hook'
is run (closes SF #1385571).

*** Remove Emacs 20 Support

As it turns out, we had already added some code that didn't work on
Emacs 20. However, now we've formalized it and removed code that was
present solely for Emacs 20 support (closes SF #1359240).

*** Glimpse Support Removed

Since glimpse isn't free, we cannot mention it. Glimpse has been
removed from the option `mh-indexer-choices' (closes SF #831276).

*** Use run-hook-with-args

We use normal hooks whenever possible and do not use
`run-hook-with-args' (with one documented exception) (closes SF
#643702).



** New Variables in MH-E 8.0

*** mh-after-commands-processed-hook

Hook run by `x' (`mh-execute-commands') after performing outstanding
refile and delete requests.

*** mh-alias-reloaded-hook

Invoked by `mh-alias-reload' after reloading aliases.

*** mh-auto-fields-prompt-flag

On means to prompt before sending if fields in `mh-auto-fields-list'
are inserted.

*** mh-before-commands-processed-hook

Renamed from `mh-folder-updated-hook'. It wasn't clear whether
`mh-folder-updated-hook' was run before or after the commands were
executed. We now provide both with clear names.

*** mh-compose-forward-as-mime-flag

On means that messages are forwarded as attachments (closes SF
#827203).

*** mh-default-folder-for-message-function

Function to select a default folder for refiling or `Fcc:'.

*** mh-forward-hook

Invoked on the forwarded letter by `f' (`mh-forward').

*** mh-highlight-citation-style

Renamed from `mh-highlight-citation-p' since it wasn't a boolean. The
new name is also more descriptive.

*** mh-identity-handlers

Handler functions for fields in `mh-identity-list'.

*** mh-insert-signature-hook

Renamed from `mh-letter-insert-signature-hook' since most of the other
hooks do not carry the mode in the prefix and because the new name is
equally clear.

*** mh-invisible-header-fields-default

List of hidden header fields. The header fields listed in this option
are hidden, although you can check off any field that you would like
to see. Header fields that you would like to hide that aren't listed
can be added to the `mh-invisible-header-fields' option (closes SF
#752045).

The option `mh-visible-header-fields' has been deleted.

*** mh-junk-background

If on, spam programs are run in background. This used to be the
default behavior but this could overwhelm a system if many messages
were black- or whitelisted at once. The spam programs are now run in
the foreground, but this option can be used to put them back in the
background.

*** mh-junk-disposition

Renamed from `mh-junk-mail-folder' since this variable can accept
values other than folder names.

*** mh-kill-folder-suppress-prompt-hooks

Renamed from `mh-kill-folder-suppress-prompt-hook'. By convention,
abnormal hooks, which this is, either have a -function or -hooks
suffix.

*** mh-mhl-format-file

Renamed from `mhl-formfile' to put it in the MH-E namespace and to be
consistent with other similar options.

*** mh-mh-to-mime-hook

Renamed from `mh-edit-mhn-hook'. We have a family of `mh-mml-to-mime'
functions and variables; the older mhn functions and variables were
renamed to have a consistent `mh-mh-to-mime' prefix.

*** mh-mml-method-default

Default method to use in security tags.

*** mh-new-messages-folders

Renamed from `mh-index-new-messages-folders' for clarity.

*** mh-path

Additional list of directories to search for MH.

*** mh-redist-full-contents-flag

On means the `dist' command needs entire letter for redistribution.
This was previously a variable. It's now an option.

*** mh-search-mode-hook

Renamed from `mh-pick-mode-hook' as part of the
`mh-index.el'/`mh-pick.el' merge into `mh-search.el'.

*** mh-search-program

Renamed from `mh-index-program' as part of the
`mh-index.el'/`mh-pick.el' merge into `mh-search.el'.

*** mh-signature-separator-flag

On means a signature separator should be inserted. It is not
recommended that you change this option since various mail user
agents, including MH-E, use the separator to present the signature
differently, and to suppress the signature when replying or yanking a
letter into a draft.

*** mh-sortm-args

Additional arguments for `sortm'. This was previously an internal
variable. It's now an user-customizable option.

*** mh-speed-update-interval

Renamed from `mh-speed-flists-interval' for clarity.

*** mh-ticked-messages-folders

Renamed from `mh-index-ticked-messages-folders' for clarity.

*** mh-variant

Specifies the variant used by MH-E. The default setting of this option
is `Auto-detect' which means that MH-E will automatically choose the
first of nmh, MH, or GNU mailutils that it finds in the directories
listed in `mh-path', `mh-sys-path', and `exec-path'. If, for example,
you have both nmh and mailutils installed and `mh-variant-in-use' was
initialized to nmh but you want to use mailutils, then you can set
this option to `mailutils'.

When this variable is changed, MH-E resets `mh-progs', `mh-lib',
`mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
accordingly.

If you've set these variables in your .emacs, it is strongly suggested
that you comment them out. The MH detection code has been completely
rewritten and it is very likely that you no longer to set them and
their setting may confuse other MH-E settings.

*** mh-xemacs-tool-bar-position

Renamed from `mh-xemacs-toolbar-position' per GNU Emacs naming conventions.

*** mh-xemacs-use-tool-bar-flag

Renamed from `mh-xemacs-use-toolbar-flag' per GNU Emacs naming conventions.

*** mh-yank-behavior

Renamed from `mh-yank-from-start-of-msg' for clarity.



** Variables Deleted in MH-E 8.0

*** mh-alias-system-aliases

System definitions should not be a user option.

*** mh-edit-mhn-hook

Renamed to `mh-mh-to-mime-hook'.

*** mh-folder-updated-hook

Renamed to `mh-before-commands-processed-hook'.

*** mh-highlight-citation-p

Renamed to `mh-highlight-citation-style'.

*** mh-index-new-messages-folders

Renamed to `mh-new-messages-folders'.

*** mh-index-program

Renamed to `mh-search-program'.

*** mh-index-ticked-messages-folders

Renamed to `mh-ticked-messages-folders'.

*** mh-junk-mail-folder

Since this variable can accept values other than folder names, it was
renamed to `mh-junk-disposition' to more accurately reflect the content.

*** mh-kill-folder-suppress-prompt-hook

Renamed to `mh-kill-folder-suppress-prompt-hooks'.

*** mh-letter-insert-signature-hook

Renamed to `mh-insert-signature-hook'.

*** mh-pick-mode-hook

Renamed to `mh-search-mode-hook'.

*** mh-show-use-goto-addr-flag

This flag was redundant with and inconsistent with
`goto-address-highlight-p' at the same time, so we removed it. Please
customize `goto-address-highlight-p' if you wish to turn off email
address and URL highlighting.

*** mh-speed-flists-interval

Renamed to `mh-speed-update-interval'.

*** mh-speed-run-flists-flag

Deleted since setting `mh-speed-flists-interval' to 0 accomplishes the
same thing.

*** mh-visible-header-fields

Deleted since it would hide new header fields you might want to see.

*** mh-xemacs-toolbar-position

Renamed to `mh-xemacs-tool-bar-position'.

*** mh-xemacs-use-toolbar-flag

Renamed to `mh-xemacs-use-tool-bar-flag'.

*** mh-yank-from-start-of-msg

Renamed to `mh-yank-behavior'.

*** mhl-formfile

Renamed to `mh-mhl-format-file'.



** New Faces in MH-E 8.0

*** mh-folder-address

Renamed from `mh-folder-address-face' per new Emacs conventions.

*** mh-folder-body

Renamed from `mh-folder-body-face' per new Emacs conventions.

*** mh-folder-cur-msg-number

Renamed from `mh-folder-cur-msg-number-face' per new Emacs conventions.

*** mh-folder-date

Renamed from `mh-folder-date-face' per new Emacs conventions.

*** mh-folder-deleted

Renamed from `mh-folder-deleted-face' per new Emacs conventions.

*** mh-folder-followup

Renamed from `mh-folder-followup-face' per new Emacs conventions.

*** mh-folder-msg-number

Renamed from `mh-folder-msg-number-face' per new Emacs conventions.

*** mh-folder-refiled

Renamed from `mh-folder-refiled-face' per new Emacs conventions.

*** mh-folder-sent-to-me-hint

Fontification hint face in messages sent directly to us.

*** mh-folder-sent-to-me-sender

Sender face in messages sent directly to us.

*** mh-folder-subject

Renamed from `mh-folder-subject-face' per new Emacs conventions.

*** mh-folder-tick

Renamed from `mh-folder-tick-face' per new Emacs conventions.

*** mh-folder-to

Renamed from `mh-folder-to-face' per new Emacs conventions.

*** mh-letter-header-field

Renamed from `mh-letter-header-field-face' per new Emacs conventions.

*** mh-search-folder

Renamed from `mh-index-folder-face'.

*** mh-show-cc

Renamed from `mh-show-cc-face' per new Emacs conventions.

*** mh-show-date

Renamed from `mh-show--face' per new Emacs conventions.

*** mh-show-from

Renamed from `mh-show-from-face' per new Emacs conventions.

*** mh-show-header

Renamed from `mh-show-header-face' per new Emacs conventions.

*** mh-show-pgg-bad

Face used to highlight a bad PGG signature.

*** mh-show-pgg-good

Face used to highlight a good PGG signature.

*** mh-show-pgg-unknown

Face used to highlight a PGG signature whose status is unknown. This
face is also used for a signature when the signer is untrusted.

*** mh-show-signature

Face used to highlight the signature.

*** mh-show-subject

Renamed from `mh-show-subject-face' per new Emacs conventions.

*** mh-show-to

Renamed from `mh-show-to-face' per new Emacs conventions.

*** mh-show-xface

Renamed from `mh-show-xface-face' per new Emacs conventions.

*** mh-speedbar-folder

Renamed from `mh-speedbar-folder-face' per new Emacs conventions.

*** mh-speedbar-folder-with-unseen-messages

Renamed from `mh-speedbar-folder-with-unseen-messages-face' per new
Emacs conventions.

*** mh-speedbar-selected-folder

Renamed from `mh-speedbar-selected-folder-face' per new Emacs conventions.

*** mh-speedbar-selected-folder-with-unseen-messages

Renamed from `mh-speedbar-selected-folder-with-unseen-messages-face'
per new Emacs conventions.



** Faces Deleted in MH-E 8.0

*** mh-folder-address-face

Renamed to `mh-folder-address' per new Emacs conventions.

*** mh-folder-body-face

Renamed to `mh-folder-body' per new Emacs conventions.

*** mh-folder-cur-msg-face

Deleted. Not used.

*** mh-folder-cur-msg-number-face

Renamed to `mh-folder-cur-msg-number' per new Emacs conventions.

*** mh-folder-date-face

Renamed to `mh-folder-date' per new Emacs conventions.

*** mh-folder-deleted-face

Renamed to `mh-folder-deleted' per new Emacs conventions.

*** mh-folder-followup-face

Renamed to `mh-folder-followup' per new Emacs conventions.

*** mh-folder-msg-number-face

Renamed to `mh-folder-msg-number' per new Emacs conventions.

*** mh-folder-refiled-face

Renamed to `mh-folder-refiled' per new Emacs conventions.

*** mh-folder-subject-face

Renamed to `mh-folder-subject' per new Emacs conventions.

*** mh-folder-tick-face

Renamed to `mh-folder-tick' per new Emacs conventions.

*** mh-folder-to-face

Renamed to `mh-folder-to' per new Emacs conventions.

*** mh-index-folder-face

Renamed to `mh-search-folder'.

*** mh-letter-header-field-face

Renamed to `mh-letter-header-field' per new Emacs conventions.

*** mh-show-cc-face

Renamed to `mh-show-cc' per new Emacs conventions.

*** mh-show-date-face

Renamed to `mh-show-date' per new Emacs conventions.

*** mh-show-from-face

Renamed to `mh-show-from' per new Emacs conventions.

*** mh-show-header-face

Renamed to `mh-show-header' per new Emacs conventions.

*** mh-show-subject-face

Renamed to `mh-show-subject' per new Emacs conventions.

*** mh-show-to-face

Renamed to `mh-show-to' per new Emacs conventions.

*** mh-show-xface-face

Renamed to `mh-show-xface' per new Emacs conventions.

*** mh-speedbar-folder-face

Renamed to `mh-speedbar-folder' per new Emacs conventions.

*** mh-speedbar-folder-with-unseen-messages-face

Renamed to `mh-speedbar-folder-with-unseen-messages' per new Emacs conventions.

*** mh-speedbar-selected-folder-face

Renamed to `mh-speedbar-selected-folder' per new Emacs conventions.

*** mh-speedbar-selected-folder-with-unseen-messages-face

Renamed to `mh-speedbar-selected-folder-with-unseen-messages' per new
Emacs conventions.



** Bug Fixes in MH-E 8.0

*** Face Variable Names Now Follow Current Conventions

The -face suffix has been dropped from all face names.

*** Swish Fixes

Items in swish indexes that aren't mail messages are now handled more
gracefully.

*** SpamAssassin Fixes

If you use SpamAssassin, there was an error when you tried to junk
mail if the option `mh-junk-background' was set. This has been fixed.

*** Mairix Support

Indexing now compatible with Mairix version 0.12 and later.

*** mh-extract-rejected-mail Can't Do MIME (and Other Formats)

Now handles qmail and exim bounces (addresses SF #404965).

*** mh-rmail Hangs in XEmacs

We've determined that MH-E is incompatible with some versions of
XEmacs (21.5.9-21.5.16). More recent versions work fine. If you think
our list is too broad, please let us know which version of XEmacs you
are using (closes SF #644321).

*** Completions Offered by mh-refile-message Are Not Sorted

This behavior is no longer observed (closes SF #698734).

*** Add Message-ID to Outgoing Messages

If you replied to a message in your `+outbox', an `In-Reply-To:'
header field was created that broke threading at the recipient's end.
We now add a `Message-ID:' to outgoing messages which fixes this
(closes SF #725425).

*** Inconsistent Prompts

Emacs changed their defaults in prompts from "Prompt: [value]" to
"Prompt (default value): ". All MH-E prompts have been updated to
comply with the new standard and are therefore now consistent
throughout the application (closes SF #730470, SF #1275933).

*** Empty Shell Comments Confuse mh-mhn-directive-present-p

If you had a string that matched the regexp "^# $" in your draft, it
would cause an error. This has been fixed (closes SF #762458).

*** Quote Hashes When mhbuild Directives Used

A related bug, if you had empty shell comments but inserted your own
directives, you'd get another error from mhbuild. This has been fixed
by quoting the hash ("^# $") like this "##" before submitting to
mhbuild (closes SF #762464).

*** Inconsistent Usage in Scan Formatting Variables

The variables:

    mh-note-cur
    mh-note-deleted
    mh-note-dist
    mh-note-forw
    mh-note-refiled
    mh-note-repl
    mh-note-seq

used to contain strings. Although only the first character was read,
the entire string would be inserted which may have caused problems.
These variables have been converted to character constants so that
only a single character can be inserted into the scan line (closes SF
#770772).

*** Bad Handling of Aliases That Conflict With Local User Names

If a user name existed both locally and in the aliases file, the local
user would be flashed, but the alias would be used when sending. This
has been fixed so that the user name that is flashed is the same as
the name that is sent (closes SF #772595).

*** Initialization Fails If ~/Mail Exists

MH-E no longer calls `install-mh' so this issue has gone away (closes
SF #835192).

*** Not Re-prompted to Sign After Pass Phrase Typo

If there were errors when sending a signed message (like getting the
pass phrase wrong), the MML markup remained in the draft buffer. The
draft buffer is now restored if there is an error (closes SF #839303).

*** Font-lock Gets Confused in MH-Letter Buffer

If a user manually moved the cursor to the end of the header field
separator line (by mouse click or keyboard navigation) and hit Enter
to start typing their message, any line in the body with a colon would
be fontified with a gray background. This has been fixed (closes SF
#855479).

*** RETURN Causes Infinite Loop in mh-letter

This behavior is no longer observed (closes SF #887346).

*** mh-refile-msg Fails to Suggest Folder for Empty Message

If you received a message with an empty body from someone who is
listed in your aliases file, `o' (`mh-refile-msg') failed to suggest
the correct folder. This has been fixed (closes SF #917096).

*** Missing Headers When Replying to All

User needed to edit `replgroupcomps' (closes SF #918194).

*** Error Visiting Folder With no Unseen Messages

If you visited a folder without unseen messages and the option "flist:
-noshowzero" is present in your `~/.mh_profile', you'd get an error.
This has been fixed (closes SF #933954).

*** Error Message When Trying to Send Using MH-E

This behavior is no longer observed (closes SF #1002103).

*** mh-find-path Doesn't Use mhparam

MH-E no longer peeks into the MH profile `~/.mh_profile' directly. It
uses `mhparam' instead (closes SF #1016027).

*** rmmproc Refile Complains No Such Message

MH-E would get confused about which folder to delete messages from if
you were refiling and deleting messages at the same time. This has
been fixed (closes SF #1023959).

*** auto-mode-alist Updated

MH-E originally updated auto-mode-alist to set the major mode of
drafts. Now that we explicitly set the mode, there is no reason to do
this, and this behavior caused problems for people who didn't use MH-E
who were editing files that looked like MH message files (closes SF
#1032353).

*** ! Doesn't Do Regions

Now it does (closes SF #1046330).

*** mh-show-unquote-From Fails (read-only buffer)

MH-E quotes the `From ' header field that is inserted by MTAs.
However, it was trying to do this in a read-only buffer. This has been
fixed (closes SF #1089870).

*** Whitespace in pick Expressions

The `C-u / s RET' command now works. In addition, you can now add
whitespace to any of the limiting (/) commands (closes SF #1122655).

*** mh-index-previous-folder Does Not Work Correctly

If your cursor was on an item below a folder heading and you used
`M-TAB' (`mh-index-previous-folder'), you would move to the previous
folder heading. This has been fixed (closes SF #1126188).

*** Default Identity Prevents Insertion of Auto Fields

Auto insertion of an identity now occurs even when the default
identity is used (closes SF #1204506).

*** mh-compose-forward and Default Message Number

`mh-compose-forward' will now default to the sent message in the sent
folder and the `cur' message in other folders. It also takes ranges of
messages and can include multiple messages at a time (closes SF
#1205890).

*** Better Handling of Empty cur Sequence

If you refiled a message into a folder and then used `F r'
(`mh-rescan-folder') in that folder, your cursor would be taken to the
first message. The cursor now stays where it was (closes SF #1207247).

*** mh-customize Uses Group mh, Not mh-e

The `mh' customization group alias has been deleted to avoid some
problems that were found (closes SF #1213716).

*** "Args out of range" Error in Displaying Message

This behavior is no longer observed (closes SF #1227504).

*** Front-and-back Truncation in mailto: Rendering

This behavior is no longer observed (closes SF #1227510).

*** Name of the Draft File in mh-comp.el

MH is documented to use the draft file. If you use a draft file for
something else (like Sylpheed), then use draft folders (closes SF
#1231483).

*** font-lock Error in mh-letter-mode

An error in MH-E was introduced as a result of a change in CVS Emacs.
This has been fixed (closes SF #1241017).

*** Msg Display Broken After Displaying Msg with Inline Image

Messages with inline images no longer trim certain message header
fields (closes SF #1306141).

*** mh-visit-folder Munges font-lock-keywords

MH-E broke highlighting in Gnus buffers. This was actually a problem
in CVS Emacs 22 and has been fixed there (closes SF #1393879).

*** Illegal Filename Chars for W32 Filesystems

Windows users who view `X-Image-URL:' images could not cache the
images since the cached image file names had illegal characters. This
has been fixed (closes SF #1396499).

*** mh-send Doesn't Handle mml Insertions Via mail-user-agent

Can now forward messages in Gnus if MH-E is your `mail-user-agent'
(closes SF #1399307).

*** Can't Narrow to Subject with Regexp Chars

The command `/ s' could not limit subjects that had special pick
characters (such as [, *, $, .). This has been fixed (closes SF
#1432548).

*** `/ s' Can Miss the Original Mail

The command `/ s' failed to include the message with the "Re:" in the
Subject. This has been fixed (closes SF #1438369).

*** mhparam -components Fails on mailutils

This error prevented MH-E from loading when using GNU mailutils. GNU
mailutils drops the `s' in this argument, so we did too since
-component still works in nmh and MH (closes SF #1446985).

*** `/ s' Still Has Problems With []'d Mail

On XEmacs, subjects that had special characters would prevent `/ s'
from narrowing to the given subject. These characters are now quoted
correctly in XEmacs (closes SF #1447598).

*** Variable mh-send-args Is a String, Not a List

This was causing errors when sending under GNU mailutils. The internal
variable `mh-send-args' is now a list which fixes the problem (closes
SF #1448604).

*** Update Icons

Most of the tool bar icons have been replaced by GTK or GNOME 2 icons
(closes SF #1452715).

*** Strip Build Number From emacs-version in X-Mailer

This has been done (closes SF #1466481).

*** Rename Function and Variable Definers

If you had ever shown help for an MH-E symbol that was both a function
or variable, you might have found that the hyperlink to the file
brought you to the wrong definition. This has been fixed by renaming
the macros `mh-defgroup', `mh-defcustom', `mh-defface',
`mh-defun-compat', and `mh-defmacro-compat' to `defgroup-mh',
`defcustom-mh', `defface-mh', `defun-mh', `defmacro-mh' respectively
(closes SF #1472029).

*** mh-insert-letter Uses Wrong Default

If you had used `C-c TAB' (`mh-insert-letter') to insert a letter into
your draft, specified a different folder, and chose the default
message number, you got the wrong message. This has been fixed (closes
SF #1473729).



* Changes in MH-E 7.4.4

Version 7.4.4 addresses programmatic issues from the FSF and prepares
MH-E for inclusion into an impending GNU Emacs release (22.1). There
are no user-visible changes (unless you are using XEmacs on DOS or
don't have the cl package installed). Filenames are now unique in
their first 8 characters (DOS 8.3 requirement). The runtime dependency
on the cl package has been removed. Desktop saving and restoration
code moved here from desktop.el.

* Changes in MH-E 7.4.3

Version 7.4.3 fixes the problem where `mh-identity-list' was not getting
set from .emacs.

* Changes in MH-E 7.4.2

Version 7.4.2 fixes the accidental dependence on nmh (closes SF
#791021).

* Changes in MH-E 7.4.1

Version 7.4.1 fixes the Makefile so it no longer tries to compile
mh-unit.el.

* Changes in MH-E 7.4

Version 7.4 contains many new useful features including arbitrary MH
range handling, new draft features such as draft form editing, as well
as sequence propagation and manipulation. We've also fixed bugs and
added a handful of new variables.

** New Features in MH-E 7.4

*** Add Arbitrary Ranges to MH-E UI

MH-E now handles any legal MH range (such as last:5 or 4 8 10-12)
wherever you're prompted for a message number or sequence (closes SF
#728638).

*** Remove Prompting in mh-send

Brian Reid's original mhe didn't do prompting anywhere but used forms
instead. While we won't go that far, we eliminated prompting where a
form is already involved, such as in composing a message.

The new customization variable `mh-compose-prompt-flag' can be set to
t to get the original behavior (closes SF #745622).

*** Use TAB to Switch Fields in Header

When composing a message, TAB and SHIFT-TAB can be used to move
quickly between header fields. The new customization variable,
`mh-compose-skipped-header-fields', contains a list of header fields
that are skipped and truncated if they are too long (closes SF
#745627).

*** Alias Completion in Composition Buffer

Aliases can be completed in the draft with "M-TAB
(mh-letter-complete)". Or, if the customization variable
`mh-compose-space-does-completion-flag' is set to t, then a "SPC
(mh-letter-complete-or-space)" with do the same thing. If
`mh-alias-flash-on-comma' is non-nil, ", (mh-letter-confirm-address)"
will show the alias expansion in the minibuffer (closes SF #745634).

*** Auto Fields Should be Inserted During Send

Fields that were inserted by the multiple personality code when the
draft was sent now insert the header fields when the draft is composed
to give you a chance to edit them (closes SF #747890).

*** mh-index-tick-messages

The command "F ' (mh-index-ticked-messages)" creates a buffer with all
messages ticked with "' (mh-toggle-tick)" in the folders listed in the
new customization variable `mh-index-ticked-messages-folders'. Chances
are that if you set `mh-index-new-messages-folders', you'll want to
set `mh-index-ticked-messages-folders' accordingly.

In addition, a general function, "F q (mh-index-sequenced-messages)"
has been provided                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    