doxygen: tidy comments

@return x, y -> multiple @retval
@return -> @retval
more /* */ comments to /**< */
merge .h and .c function descriptions
Prefix defines with #

bind editor <delete> to delete-char

Look for ncurses headers in more dedicated locations first (#679)

This solves a problem on FreeBSD, where the base system is shipped with
ncurses 5.9 (/usr/include/ncurses.h). When building against 3rd party
ncurses 6.0 from ports (/usr/local/include/ncurses/ncurses.h), the
configure script picks up the 5.9 headers and the 6.0 library. This
might cause problems, since 6.0 is not ABI compatible with 5.0.

No need to strdup the result of tigetstr (#682)

doxygen: doc some more functions

Fix the printing of ncurses version in -v output

Fix the configure check for S-Lang (#676)

Issue: #667

docs: document some functions

merge: rename functions/constants for consistency

 * rename ESC_char
 * rename mutt_format_string and mutt_FormatString
 * rename SHA1_*
 * remove build constant SHA1HANDSOFF
 * #define constants in upper case

#define constants in upper case

remove build constant SHA1HANDSOFF

rename SHA1_*

rename mutt_format_string and mutt_FormatString

`mutt_format_string` and `mutt_FormatString` were much to similarly
named to be useful.  The first only does formatting.  The second uses
expandos to allow custom expansion.

To avoid future confusion, I've created new names that are distinct:
    mutt_format_string mutt_simple_format
    mutt_FormatString  mutt_expando_format

rename ESC_char

merge: improve doxygen comments

 * name all enum types
 * fix all comments
 * fix colours and links
 * add file templates
 * add struct/enum/union templates
 * convert existing comments

doxygen: convert existing comments

Lots of functions were already commented.
This commit re-formats the comments to be doxygen-compatible.

Despite the size of the commit, no code has changed.

doxygen: add struct/enum/union templates

doxygen: add file templates

doxygen: fix colours and links

doxygen: fix all comments

name all enum types

only match real mailboxes when looking for new mail

nntp: sync to upstream

NeoMutt 2017-07-14 (1.8.3)

merge: sync to mutt/default

update translations

Update German translation

clang-format

docs: update ChangeLog

version: 2017-07-14

coverity: fix two minor defects

differentiate hcaches

fix hcachever.sh script

This script stopped working when all the structs were renamed
(and lots of the moved out of mutt.h)

compile-time output: use two lists

When asking NeoMutt for a list of compile-time features, the current
implementation assumes a mixture of options which can be enabled through
./configure, and some which default to on, without compile-time
exclusion.

Instead, separate this output in NeoMutt.

configure: remove MUTTLIBS

It's not clear to anyone why this variable existed in the first place,
so it was decided that it should be removed.

Most of the time, AC_CHECK_LIB and AC_SEARCH_LIBS will already alter
LIBS to prepend to it the found library, so there is no real reason to
duplicate this mechanism.

Some manual assignments have been kept because either the
action-if-found was set to no-op, or because new found libraries were
appended to MUTTLIBS, so this keeps the diff minimal with the same
"behaviour".

See issue #552

docs: fix pattern typo

Thanks to cybrNaut

merge: upstream fixes (mutt/default)

 * fix signed/unsigned comparison in longest_common_prefix
 * Fix crash when $postponed is on another server.
 * bcache: cast to avoid implicit signed/unsigned comparison in bcache_path
 * drop unused flags argument from imap_access

drop unused flags argument from imap_access

We are not using an actual interface so it is pointless.

bcache: cast to avoid implicit signed/unsigned comparison in bcache_path

Fix crash when $postponed is on another server.

imap_mxcmp() translates NULL to "INBOX".  When $postponed points to a
URL with an empty or "INBOX" path, this will end up matching against a
NULL idata->mailbox in imap_status().  This resulted in a crash
because idata->ctx is also NULL.

Thanks to Olaf Hering for the detailed bug report and suggested fix.

fix signed/unsigned comparison in longest_common_prefix

drop unused flags argument from imap_access

We are not using an actual interface so it is pointless.

doxygen: add config file

doxygen: tidy existing comments

name unnamed enums

rename some structs/enums/unions/constants

struct/enum/union
    Capability_Aliases CapabilityAliases
    Capability_Alias   CapabilityAlias
    CryptKeyinfo       CryptKeyInfo
    div_type           DivType
    DnArrayS           DnArray
    FgetConvS          FgetConv
    format_flag        FormatFlag
    group_state_t      GroupState
    hash_key           HashKey
    hcache_ops_t       HcacheOps
    history_class_t    HistoryClass
    imap_auth_res_t    ImapAuthRes
    IMAP_COMMAND_TYPE  ImapCommandType
    key_cap_t          KeyCap
    mdb_txn_mode       MdbTxnMode
    NmCtxdata          NmCtxData
    NmHdrdata          NmHdrData
    NmHdrtag           NmHdrTag
    packet_tags        PacketTags
    pattern_exec_flag  PatternExecFlag
    pgp_ring_t         PgpRing
    pop_auth_res_t     PopAuthRes
    sb_src             SidebarSrc
    Sysexits           SysExits
    url_scheme         UrlScheme
    url_scheme_t       UrlScheme
    validate           Validate
    XDGType            XdgType

Constants
    kXDGConfigDirs     XDG_CONFIG_DIRS
    kXDGConfigHome     XDG_CONFIG_HOME
    ADDR               GS_ADDR
    NONE               GS_NONE
    RX                 GS_RX
    txn_read           TXN_READ
    txn_uninitialized  TXN_UNINITIALIZED
    txn_write          TXN_WRITE

Variables
    firstMessage       first_message
    hideQuoted         hide_quoted
    lastCached         last_cached
    lastLine           last_line
    lastLoaded         last_loaded
    lastMessage        last_message
    lineInfo           line_info
    maxLine            max_line
    newMailCount       new_mail_count
    QuoteList          quote_list
    SearchBack         search_back
    SearchCompiled     search_compiled
    searchDir          search_dir
    SearchFlag         search_flag
    SearchRE           search_re
    WrapMargin         wrap_margin

bcache: cast to avoid implicit signed/unsigned comparison in bcache_path

merge stable

Fix crash when $postponed is on another server.

imap_mxcmp() translates NULL to "INBOX".  When $postponed points to a
URL with an empty or "INBOX" path, this will end up matching against a
NULL idata->mailbox in imap_status().  This resulted in a crash
because idata->ctx is also NULL.

Thanks to Olaf Hering for the detailed bug report and suggested fix.

fix signed/unsigned comparison in longest_common_prefix

fix: stop allowing duplicate mailboxes

update ChangeLog.md

NeoMutt 2017-07-07 (1.8.3)

merge: sync to mutt/default

update translations

tidy whitespace

clang-format

update mailmap

docs: update credits

version: 2017-07-07

merge: translations

 * Update Chinese (Simplified) translation
 * Updated Danish translation.
 * Updated Japanese translation.

Updated Japanese translation.

Updated Danish translation.

Update Chinese (Simplified) translation

merge: upstream fixes (mutt/default)

 * Add more description for the %S and %Z $index_format characters.
 * Add L10N comments to the GNUTLS certificate prompt.
 * Add ~<() and ~>() immediate parent/children patterns. (closes #3144)

Add ~<() and ~>() immediate parent/children patterns. (closes #3144)

Thanks to Jeremie Le Hen for the original patch, and for his
persistence in getting this feature merged.

Add L10N comments to the GNUTLS certificate prompt.

The prompts are shared with OpenSSL, and so the prompts end up being
separate from the action key strings.

Add more description for the %S and %Z $index_format characters.

flags: update the hdr message last

this allow the color of the message of a colapsed thread to reflect
changes that occured in the subthread, and commited by this depth
first search.

Revert "don't close the pager after a timeout"

This reverts commit 5acd76ee270428302ec5e623a0cf743c17c4c05b.

Support Gmail's X-GM-RAW server-side search

Let Gmail search filters be used from mutt with =/

Closes #644

fix gpgme S/MIME non-detached signature handling

- gpgsm ends the session after the decrypt error, so restart gpgsm when
  retrying with "maybe_signed".
- evolution sends encrypted + signed S/MIME mails with non-detached
  signatures

merge: minor build improvements

 * move smime_keys into contrib
 * drop instdoc script
 * remove unnecessary steps
 * tidy makefile

Add ~<() and ~>() immediate parent/children patterns. (closes #3144)

Thanks to Jeremie Le Hen for the original patch, and for his
persistence in getting this feature merged.

build: tidy makefile

This commit makes no changes to the build.
It simply tidies up the whitespace and some lists.

build: remove unnecessary steps

Three man pages were processed with sed, but it didn't alter the files.

build: drop instdoc script

This script performed some string substitutions in the files it was
installing.  This was already done by the Makefile.

build: move smime_keys into contrib

menu: fix the thread tree color

The background tree color is really meaningless as it mixes with the
background color of indexes subject in unpleasant ways. We prefer to
create a new color based on the tree foreground color only.

Remove stale certificate prompt translations.

With the OpenSSL changes, unmaintained translation prompts will not function properly.

Clear out the translation strings for those using different action keys.

This changeset does not touch the translation files that are actively
maintained.  They will be properly updated before the 1.9.0 release.

Update po files.

Add L10N comments to the GNUTLS certificate prompt.

The prompts are shared with OpenSSL, and so the prompts end up being
separate from the action key strings.

Add more description for the %S and %Z $index_format characters.

browser tweak

See issue #609

Uses CurrentFolder to populate LastDir with IMAP

 * Needs to rollback to !folder instead of !*LastDir
 * Closes issue #640

fix perms

don't close the pager after a timeout

Setting a timeout hook could cause the pager to automatically close
itself when viewing help or an attachment.

    timeout-hook 'exec sync mailbox'

The timeout was causing a fake keypress event which cause the pager to
quit.

Fixes #591

colour emails with a '+' in them

The default highlighting for email addresses didn't recognise '+'
characters as being valid.

Fixes #496

sidebar: stabilise sort order

When sorting by a numeric type, fallback to the path if the numbers are
the same.

Fixes #486

doc: limitations of new-mail %f expando

docs: escape <>'s in nested conditions

Add config vars for forwarded message attribution intro/trailer.

Add $forward_attribution_intro and $forward_attribution_trailer to
allow the default strings to be overridden.

Fixes #522

dupe-string, don't destroy original

fix the padding expando '%>'

Debian BTS 866366

The non-greedy '%>' has been broken since the introduction of the
nested-if patch.

The second command should create a line of dots ending in a ']'

    set index_format="%?M?collapsed%|.]&expanded?
    set index_format="%?M?collapsed%>.]&expanded?

merge: add some colour schemes

 * added neonwolf colorscheme
 * added black 256 solarized colorscheme
 * added zenburn colorscheme
 * added vombatidae colorscheme
 * removed note to use slang for neonwolf colorscheme
 * build: add colour schemes

build: add colour schemes

Closes #340

removed note to use slang for neonwolf colorscheme

Thanks to @h3xx for the hint.

added vombatidae colorscheme

Thanks to @octol

added zenburn colorscheme

Thanks to Renato Cunha

Source:
https://bitbucket.org/trovao/configs/src/c3413bafa5ba70da2329225a9009078b078ccee1/mutt-zenburn/dotmuttrc

added black 256 solarized colorscheme

Thanks to @altercation