From: Richard Russon Date: Sat, 17 Mar 2018 01:14:33 +0000 (+0000) Subject: doxygen: drop/tidy simple comments X-Git-Tag: neomutt-20180323~5 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=709845754b01b34278089d8b3190b7b678a91bc4;p=neomutt doxygen: drop/tidy simple comments --- diff --git a/conn/conn_globals.c b/conn/conn_globals.c index 22de6a3d9..525fb2d2c 100644 --- a/conn/conn_globals.c +++ b/conn/conn_globals.c @@ -24,37 +24,25 @@ * @page conn_globals Connection Global Variables * * These global variables are private to the connection library. - * - * | Global Variable | NeoMutt Config - * | :--------------------- | :------------------------ - * | #CertificateFile | $certificate_file - * | #ConnectTimeout | $connect_timeout - * | #EntropyFile | $entropy_file - * | #Preconnect | $preconnect - * | #SslCaCertificatesFile | $ssl_ca_certificates_file - * | #SslCiphers | $ssl_ciphers - * | #SslClientCert | $ssl_client_cert - * | #SslMinDhPrimeBits | $ssl_min_dh_prime_bits - * | #Tunnel | $tunnel */ #include "config.h" #include -short ConnectTimeout = 0; /**< Config: $connect_timeout */ +short ConnectTimeout = 0; /**< Config: Timeout for a network connection (for IMAP, POP or SMTP) */ #ifdef USE_SSL -const char *CertificateFile = NULL; /**< Config: $certificate_file */ -const char *EntropyFile = NULL; /**< Config: $entropy_file */ -const char *SslCiphers = NULL; /**< Config: $ssl_ciphers */ -const char *SslClientCert = NULL; /**< Config: $ssl_client_cert */ +const char *CertificateFile = NULL; /**< Config: File containing trusted certificates */ +const char *EntropyFile = NULL; /**< Config: File containing random data to initialise SSL */ +const char *SslCiphers = NULL; /**< Config: Ciphers to use when using SSL */ +const char *SslClientCert = NULL; /**< Config: File containing client certificates */ #ifdef USE_SSL_GNUTLS -const char *SslCaCertificatesFile = NULL; /**< Config: $ssl_ca_certificates_file */ -short SslMinDhPrimeBits = 0; /**< Config: $ssl_min_dh_prime_bits */ +const char *SslCaCertificatesFile = NULL; /**< Config: File containing trusted CA certificates */ +short SslMinDhPrimeBits = 0; /**< Config: Minimum keysize for Diffie-Hellman key exchange */ #endif #endif #ifdef USE_SOCKET -const char *Preconnect = NULL; /**< Config: $preconnect */ -const char *Tunnel = NULL; /**< Config: $tunnel */ +const char *Preconnect = NULL; /**< Config: Shell command to run before making a connection */ +const char *Tunnel = NULL; /**< Config: Shell command to establish a tunnel */ #endif diff --git a/conn/getdomain.c b/conn/getdomain.c index ddde39ec1..c4729033d 100644 --- a/conn/getdomain.c +++ b/conn/getdomain.c @@ -24,10 +24,6 @@ * @page conn_getdomain DNS lookups * * DNS lookups - * - * | Function | Description - * | :----------------- | :----------------------------------- - * | getdnsdomainname() | Lookup the host's name using DNS */ #include "config.h" diff --git a/conn/sasl.c b/conn/sasl.c index 214167aa8..368f2e610 100644 --- a/conn/sasl.c +++ b/conn/sasl.c @@ -35,13 +35,6 @@ * write. Thinking about it, the abstraction problem is that there is more in * Connection than there needs to be. Ideally it would have only (void*)data * and methods. - * - * | Function | Description - * | :--------------------- | :----------------------------------- - * | mutt_sasl_client_new() | wrapper for sasl_client_new - * | mutt_sasl_done() | Invoke when processing is complete. - * | mutt_sasl_interact() | Perform an SASL interaction with the user - * | mutt_sasl_setup_conn() | Set up an SASL connection */ #include "config.h" diff --git a/conn/sasl_plain.c b/conn/sasl_plain.c index e349eb4cf..ea7a578d0 100644 --- a/conn/sasl_plain.c +++ b/conn/sasl_plain.c @@ -24,10 +24,6 @@ * @page conn_sasl_plain SASL plain authentication support * * SASL plain authentication support - * - * | Function | Description - * | :-------------------- | :----------------------------------- - * | mutt_sasl_plain_msg() | Create an SASL command */ #include "config.h" diff --git a/conn/socket.c b/conn/socket.c index 19e2e3502..00f0a5a03 100644 --- a/conn/socket.c +++ b/conn/socket.c @@ -26,21 +26,6 @@ * @page conn_socket Low-level socket handling * * Low-level socket handling - * - * | Function | Description - * | :--------------------- | :----------------------------------- - * | mutt_socket_close() | Close a socket - * | mutt_socket_open() | Simple wrapper - * | mutt_socket_poll() | Checks whether reads would block - * | mutt_socket_readchar() | simple read buffering to speed things up - * | mutt_socket_readln_d() | Read a line from a socket - * | mutt_socket_write_d() | Write data to a socket - * | raw_socket_close() | Close a socket - * | raw_socket_open() | Open a socket - * | raw_socket_poll() | Checks whether reads would block - * | raw_socket_read() | Read data from a socket - * | raw_socket_write() | Write data to a socket - * | socket_new_conn() | allocate and initialise a new connection */ #include "config.h" diff --git a/conn/ssl.c b/conn/ssl.c index ee749ac12..a74ea41ad 100644 --- a/conn/ssl.c +++ b/conn/ssl.c @@ -24,11 +24,6 @@ * @page conn_ssl Handling of OpenSSL encryption * * Handling of OpenSSL encryption - * - * | Function | Description - * | :---------------------- | :----------------------------------- - * | mutt_ssl_socket_setup() | Set up the socket multiplexor - * | mutt_ssl_starttls() | Negotiate TLS over an already opened connection */ #include "config.h" diff --git a/conn/ssl_gnutls.c b/conn/ssl_gnutls.c index 5698bc5ea..be1df16d2 100644 --- a/conn/ssl_gnutls.c +++ b/conn/ssl_gnutls.c @@ -25,11 +25,6 @@ * @page conn_ssl_gnutls Handling of GnuTLS encryption * * Handling of GnuTLS encryption - * - * | Function | Description - * | :---------------------- | :----------------------------------- - * | mutt_ssl_socket_setup() | Set up SSL socket mulitplexor - * | mutt_ssl_starttls() | Set up TLS multiplexor */ #include "config.h" diff --git a/conn/tunnel.c b/conn/tunnel.c index 174108bd8..640a79e94 100644 --- a/conn/tunnel.c +++ b/conn/tunnel.c @@ -25,10 +25,6 @@ * @page conn_tunnel Support for network tunnelling * * Support for network tunnelling - * - * | Function | Description - * | :------------------------- | :----------------------------------- - * | mutt_tunnel_socket_setup() | setups tunnel connection functions. */ #include "config.h" diff --git a/doxygen/doxygen.conf b/doxygen/doxygen.conf index a0b0324f5..c5b49b933 100644 --- a/doxygen/doxygen.conf +++ b/doxygen/doxygen.conf @@ -1547,7 +1547,7 @@ HIDE_UNDOC_RELATIONS = YES # set to NO # The default value is: NO. -HAVE_DOT = YES +HAVE_DOT = NO # The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed # to run in parallel. When set to 0 doxygen will base this on the number of diff --git a/envelope.c b/envelope.c index 264d83196..eb490403f 100644 --- a/envelope.c +++ b/envelope.c @@ -24,15 +24,6 @@ * @page envelope Representation of an email header (envelope) * * Representation of an email header (envelope) - * - * | Function | Description - * | :-------------------- | :--------------------------------- - * | mutt_env_cmp_strict() | Strictly compare two Envelopes - * | mutt_env_free() | Free an Envelope - * | mutt_env_merge() | Merge the headers of two Envelopes - * | mutt_env_new() | Create a new Envelope - * | mutt_env_to_intl() | Convert an Envelope's Address fields to Punycode format - * | mutt_env_to_local() | Convert an Envelope's Address fields to local format */ #include "config.h" diff --git a/history.c b/history.c index 483ce9a40..0c275f0be 100644 --- a/history.c +++ b/history.c @@ -25,24 +25,6 @@ * * Read/write command history from/to a file. * - * | Data | Description - * | :----------------- | :-------------------------------------------------- - * | #History | Number of history entries stored in memory - * | #HistoryFile | File in which to store all the histories - * | #HistoryRemoveDups | Remove duplicate history entries - * | #SaveHistory | Number of history entries, per category, stored on disk - * - * | Function | Description - * | :----------------------- | :--------------------------------------------------------- - * | mutt_hist_add() | Add a string to a history - * | mutt_hist_at_scratch() | Is the current History position at the 'scratch' place? - * | mutt_hist_init() | Create a set of empty History ring buffers - * | mutt_hist_next() | Get the next string in a History - * | mutt_hist_prev() | Get the previous string in a History - * | mutt_hist_read_file() | Read the History from a file - * | mutt_hist_reset_state() | Move the 'current' position to the end of the History - * | mutt_hist_save_scratch() | Save a temporary string to the History - * * This history ring grows from 0..History, with last marking the * where new entries go: * ``` diff --git a/imap/auth.c b/imap/auth.c index e4f8771f1..b4ab2fe4e 100644 --- a/imap/auth.c +++ b/imap/auth.c @@ -26,10 +26,6 @@ * @page imap_auth IMAP authenticator multiplexor * * IMAP authenticator multiplexor - * - * | Function | Description - * | :------------------ | :------------------------------------------------- - * | imap_authenticate() | Authenticate to an IMAP server */ #include "config.h" diff --git a/imap/auth_anon.c b/imap/auth_anon.c index 0adb57922..d37019061 100644 --- a/imap/auth_anon.c +++ b/imap/auth_anon.c @@ -24,10 +24,6 @@ * @page imap_auth_anon IMAP anonymous authentication method * * IMAP anonymous authentication method - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_auth_anon() | Authenticate anonymously */ #include "config.h" diff --git a/imap/auth_cram.c b/imap/auth_cram.c index 7cc20ba5f..23c134e95 100644 --- a/imap/auth_cram.c +++ b/imap/auth_cram.c @@ -24,10 +24,6 @@ * @page imap_auth_cram IMAP CRAM-MD5 authentication method * * IMAP CRAM-MD5 authentication method - * - * | Function | Description - * | :------------------- | :------------------------------------------------- - * | imap_auth_cram_md5() | Authenticate using CRAM-MD5 */ #include "config.h" diff --git a/imap/auth_gss.c b/imap/auth_gss.c index 0c4c1ae6e..45dac2990 100644 --- a/imap/auth_gss.c +++ b/imap/auth_gss.c @@ -24,10 +24,6 @@ * @page imap_auth_gss IMAP GSS authentication method * * IMAP GSS authentication method - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_auth_gss() | GSS Authentication support */ #include "config.h" diff --git a/imap/auth_login.c b/imap/auth_login.c index 6f3f89d00..f6de06612 100644 --- a/imap/auth_login.c +++ b/imap/auth_login.c @@ -24,10 +24,6 @@ * @page imap_auth_login IMAP login authentication method * * IMAP login authentication method - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_auth_login() | Plain LOGIN support */ #include "config.h" diff --git a/imap/auth_plain.c b/imap/auth_plain.c index 2243c362e..4b0d6695f 100644 --- a/imap/auth_plain.c +++ b/imap/auth_plain.c @@ -25,10 +25,6 @@ * @page imap_auth_plain IMAP plain authentication method * * IMAP plain authentication method - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_auth_plain() | SASL PLAIN support */ #include "config.h" diff --git a/imap/auth_sasl.c b/imap/auth_sasl.c index b802aa2d3..0b18d0f27 100644 --- a/imap/auth_sasl.c +++ b/imap/auth_sasl.c @@ -24,10 +24,6 @@ * @page imap_auth_sasl IMAP SASL authentication method * * IMAP SASL authentication method - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_auth_sasl() | Default authenticator if available */ #include "config.h" diff --git a/imap/browse.c b/imap/browse.c index 97842bf60..2f1de74f0 100644 --- a/imap/browse.c +++ b/imap/browse.c @@ -25,12 +25,6 @@ * @page imap_browse Mailbox browser * * GUI select an IMAP mailbox from a list - * - * | Function | Description - * | :-------------------- | :------------------------------------------------- - * | imap_browse() | IMAP hook into the folder browser - * | imap_mailbox_create() | Create a new IMAP mailbox - * | imap_mailbox_rename() | Rename a mailbox */ #include "config.h" diff --git a/imap/command.c b/imap/command.c index f8fea70d9..3778ec0b2 100644 --- a/imap/command.c +++ b/imap/command.c @@ -26,16 +26,6 @@ * @page imap_command Send/receive commands to/from an IMAP server * * Send/receive commands to/from an IMAP server - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_cmd_finish() | Attempt to perform cleanup - * | imap_cmd_idle() | Enter the IDLE state - * | imap_cmd_start() | Given an IMAP command, send it to the server - * | imap_cmd_step() | Reads server responses from an IMAP command - * | imap_cmd_trailer() | Extra information after tagged command response if any - * | imap_code() | Was the command successful - * | imap_exec() | Execute a command and wait for the response from the server */ #include "config.h" diff --git a/imap/imap.c b/imap/imap.c index 980b7edbc..e2d48a1d9 100644 --- a/imap/imap.c +++ b/imap/imap.c @@ -27,47 +27,9 @@ * * Support for IMAP4rev1, with the occasional nod to IMAP 4. * - * | Function | Description - * | :--------------------------- | :------------------------------------------------- - * | imap_access() | Check permissions on an IMAP mailbox - * | imap_buffy_check() | Check for new mail in subscribed folders - * | imap_check() | Check for new mail - * | imap_check_mailbox() | use the NOOP or IDLE command to poll for new mail - * | imap_close_connection() | Close an IMAP connection - * | imap_complete() | Try to complete an IMAP folder path - * | imap_conn_find() | Find an open IMAP connection - * | imap_create_mailbox() | Create a new mailbox - * | imap_delete_mailbox() | Delete a mailbox - * | imap_exec_msgset() | Prepare commands for all messages matching conditions - * | imap_expunge_mailbox() | Purge messages from the server - * | imap_fast_trash() | Use server COPY command to copy deleted messages to trash - * | imap_has_flag() | Does the flag exist in the list - * | imap_logout() | Gracefully log out of server - * | imap_logout_all() | close all open connections - * | imap_mboxcache_free() | Free the cached ImapStatus - * | imap_mboxcache_get() | Open an hcache for a mailbox - * | imap_open_connection() | Open an IMAP connection - * | imap_read_literal() | Read bytes bytes from server into file - * | imap_rename_mailbox() | Rename a mailbox - * | imap_search() | Find a matching mailbox - * | imap_status() | Get the status of a mailbox - * | imap_subscribe() | Subscribe to a mailbox - * | imap_sync_message_for_copy() | Update server to reflect the flags of a single message - * - * | Data | Description - * | :----------------- | :-------------------------------------------------- - * | #mx_comp_ops | Mailbox callback functions - * - * | Function | Description - * | :-------------------------- | :------------------------------------------------- - * | imap_check_mailbox_reopen() | Check for new mail (reopen mailbox if necessary) - * | imap_close_mailbox() | Clean up IMAP data in Context - * | imap_commit_message_tags() | Add/Change/Remove flags from headers - * | imap_edit_message_tags() | Prompt and validate new messages tags - * | imap_open_mailbox() | Open an IMAP mailbox - * | imap_open_mailbox_append() | Open an IMAP mailbox to append - * | imap_open_new_message() | Open an IMAP message - * | imap_sync_mailbox() | Sync all the changes to the server + * | Data | Description + * | :----------- | :------------------------- + * | #mx_imap_ops | Mailbox callback functions */ #include "config.h" @@ -2778,7 +2740,7 @@ static int imap_commit_message_tags(struct Context *ctx, struct Header *h, char } /** - * mx_comp_ops - Mailbox callback functions + * mx_imap_ops - Mailbox callback functions */ struct MxOps mx_imap_ops = { .open = imap_open_mailbox, diff --git a/imap/message.c b/imap/message.c index d7d2d1113..f9fa1653b 100644 --- a/imap/message.c +++ b/imap/message.c @@ -25,19 +25,6 @@ * @page imap_message Manage IMAP messages * * Manage IMAP messages - * - * | Function | Description - * | :---------------------- | :------------------------------------------------- - * | imap_append_message() | Write an email back to the server - * | imap_cache_clean() | Delete all the entries in the message cache - * | imap_cache_del() | Delete an email from the body cache - * | imap_close_message() | Close an email - * | imap_commit_message() | Save changes to an email - * | imap_copy_messages() | Server COPY messages to another folder - * | imap_fetch_message() | Fetch an email from an IMAP server - * | imap_free_header_data() | free ImapHeader structure - * | imap_read_headers() | Read headers from the server - * | imap_set_flags() | fill the message header according to the server flags */ #include "config.h" diff --git a/imap/utf7.c b/imap/utf7.c index c5c5e1ee7..a58675878 100644 --- a/imap/utf7.c +++ b/imap/utf7.c @@ -24,11 +24,6 @@ * @page imap_utf7 UTF-7 Manipulation * * Convert strings to/from utf7/utf8 - * - * | Function | Description - * | :----------------- | :------------------------------------------------- - * | imap_utf_decode() | Decode email from UTF-8 to local charset - * | imap_utf_encode() | Encode email from local charset to UTF-8 */ #include "config.h" diff --git a/imap/util.c b/imap/util.c index 9e39e84c4..1cec26850 100644 --- a/imap/util.c +++ b/imap/util.c @@ -26,41 +26,6 @@ * @page imap_util IMAP helper functions * * IMAP helper functions - * - * | Function | Description - * | :----------------------- | :------------------------------------------------- - * | imap_account_match() | Compare two Accounts - * | imap_allow_reopen() | Allow re-opening a folder upon expunge - * | imap_cachepath() | Generate a cache path for a mailbox - * | imap_clean_path() | Cleans an IMAP path using imap_fix_path - * | imap_continue() | display a message and ask the user if they want to go on - * | imap_disallow_reopen() | Disallow re-opening a folder upon expunge - * | imap_error() | show an error and abort - * | imap_expand_path() | Canonicalise an IMAP path - * | imap_fix_path() | Fix up the imap path - * | imap_free_idata() | Release and clear storage in an ImapData structure - * | imap_get_literal_count() | write number of bytes in an IMAP literal into bytes - * | imap_get_parent() | Get an IMAP folder's parent - * | imap_get_parent_path() | Get the path of the parent folder - * | imap_get_qualifier() | Get the qualifier from a tagged response - * | imap_hcache_close() | Close the header cache - * | imap_hcache_del() | Delete an item from the header cache - * | imap_hcache_get() | Get a header cache entry by its UID - * | imap_hcache_namer() | Generate a filename for the header cache - * | imap_hcache_open() | Open a header cache - * | imap_hcache_put() | Add an entry to the header cache - * | imap_keepalive() | poll the current folder to keep the connection alive - * | imap_munge_mbox_name() | Quote awkward characters in a mailbox name - * | imap_mxcmp() | Compare mailbox names, giving priority to INBOX - * | imap_new_idata() | Allocate and initialise a new ImapData structure - * | imap_next_word() | Find where the next IMAP word begins - * | imap_parse_path() | Parse an IMAP mailbox name into name,host,port - * | imap_pretty_mailbox() | Prettify an IMAP mailbox name - * | imap_qualify_path() | Make an absolute IMAP folder target - * | imap_quote_string() | quote string according to IMAP rules - * | imap_unmunge_mbox_name() | Remove quoting from a mailbox name - * | imap_unquote_string() | equally stupid unquoting routine - * | imap_wait_keepalive() | Wait for a process to change state */ #include "config.h" diff --git a/mh.c b/mh.c index 2614df88f..42c53b59c 100644 --- a/mh.c +++ b/mh.c @@ -22,11 +22,6 @@ * this program. If not, see . */ -/* - * This file contains routines specific to MH and ``maildir'' style - * mailboxes. - */ - #include "config.h" #include #include diff --git a/mutt/memory.c b/mutt/memory.c index f2333fcf3..e82a59f58 100644 --- a/mutt/memory.c +++ b/mutt/memory.c @@ -45,7 +45,7 @@ * @retval ptr Memory on the heap * * @note This function will never return NULL. - * It will print and error and exit the program. + * It will print an error and exit the program. * * The caller should call mutt_mem_free() to release the memory */ @@ -93,7 +93,7 @@ void mutt_mem_free(void *ptr) * @retval ptr Memory on the heap * * @note This function will never return NULL. - * It will print and error and exit the program. + * It will print an error and exit the program. * * The caller should call mutt_mem_free() to release the memory */ @@ -118,7 +118,7 @@ void *mutt_mem_malloc(size_t size) * @param size New size * * @note This function will never return NULL. - * It will print and error and exit the program. + * It will print an error and exit the program. * * If the new size is zero, the block will be freed. */ diff --git a/mutt_menu.h b/mutt_menu.h index 363aebd9f..95d7b6085 100644 --- a/mutt_menu.h +++ b/mutt_menu.h @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - * This file is named mutt_menu.h so it doesn't collide with ncurses menu.h - */ - #ifndef _MUTT_MENU_H #define _MUTT_MENU_H diff --git a/mx.h b/mx.h index 0a27f41a0..90f9cef38 100644 --- a/mx.h +++ b/mx.h @@ -21,11 +21,6 @@ * this program. If not, see . */ -/* - * This header file contains prototypes for internal functions used by the - * generic mailbox api. None of these functions should be called directly. - */ - #ifndef _MUTT_MX_H #define _MUTT_MX_H diff --git a/ncrypt/crypt_mod_pgp_classic.c b/ncrypt/crypt_mod_pgp_classic.c index 595908b98..24a3d8859 100644 --- a/ncrypt/crypt_mod_pgp_classic.c +++ b/ncrypt/crypt_mod_pgp_classic.c @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - This is a crytpo module wrapping the classic pgp code. - */ - #include "config.h" #include #include "crypt_mod.h" diff --git a/ncrypt/crypt_mod_pgp_gpgme.c b/ncrypt/crypt_mod_pgp_gpgme.c index e1f827cb5..7999accc9 100644 --- a/ncrypt/crypt_mod_pgp_gpgme.c +++ b/ncrypt/crypt_mod_pgp_gpgme.c @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - This is a crypto module wrapping the gpgme based pgp code. - */ - #include "config.h" #include #include "crypt_gpgme.h" diff --git a/ncrypt/crypt_mod_smime_classic.c b/ncrypt/crypt_mod_smime_classic.c index 5ac34c329..04da2097c 100644 --- a/ncrypt/crypt_mod_smime_classic.c +++ b/ncrypt/crypt_mod_smime_classic.c @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - This is a crytpo module wrapping the classic smime code. - */ - #include "config.h" #include #include "crypt_mod.h" diff --git a/ncrypt/crypt_mod_smime_gpgme.c b/ncrypt/crypt_mod_smime_gpgme.c index b445decb2..e3e887eaf 100644 --- a/ncrypt/crypt_mod_smime_gpgme.c +++ b/ncrypt/crypt_mod_smime_gpgme.c @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - This is a crypto module wrapping the gpgme based smime code. - */ - #include "config.h" #include #include "crypt_gpgme.h" diff --git a/ncrypt/cryptglue.c b/ncrypt/cryptglue.c index 8644cc3ef..3351f41a7 100644 --- a/ncrypt/cryptglue.c +++ b/ncrypt/cryptglue.c @@ -21,16 +21,15 @@ * this program. If not, see . */ -/* - This file dispatches the generic crypto functions to the - implemented backend or provides dummy stubs. Note, that some - generic functions are handled in crypt.c. -*/ +/* This file dispatches the generic crypto functions to the implemented backend + * or provides dummy stubs. Note, that some generic functions are handled in + * crypt.c. + */ -/* Note: This file has been changed to make use of the new module - system. Consequently there's a 1:1 mapping between the functions - contained in this file and the functions implemented by the crypto - modules. */ +/* Note: This file has been changed to make use of the new module system. + * Consequently there's a 1:1 mapping between the functions contained in this + * file and the functions implemented by the crypto modules. + */ #include "config.h" #include diff --git a/ncrypt/gnupgparse.c b/ncrypt/gnupgparse.c index a3bc89233..88e208870 100644 --- a/ncrypt/gnupgparse.c +++ b/ncrypt/gnupgparse.c @@ -21,10 +21,7 @@ * this program. If not, see . */ -/* - * NOTE - * - * This code used to be the parser for GnuPG's output. +/* NOTE: This code used to be the parser for GnuPG's output. * * Nowadays, we are using an external pubring lister with PGP which mimics * gpg's output format. diff --git a/ncrypt/ncrypt.h b/ncrypt/ncrypt.h index d30a90445..a22158a5b 100644 --- a/ncrypt/ncrypt.h +++ b/ncrypt/ncrypt.h @@ -21,11 +21,6 @@ * this program. If not, see . */ -/* - Common definitions and prototypes for the crypt functions. They are - all defined in crypt.c and cryptglue.c -*/ - #ifndef _NCRYPT_NCRYPT_H #define _NCRYPT_NCRYPT_H diff --git a/ncrypt/pgp.c b/ncrypt/pgp.c index 965320ca1..7caddcf35 100644 --- a/ncrypt/pgp.c +++ b/ncrypt/pgp.c @@ -22,12 +22,10 @@ * this program. If not, see . */ -/* - * This file contains all of the PGP routines necessary to sign, encrypt, - * verify and decrypt PGP messages in either the new PGP/MIME format, or - * in the older Application/Pgp format. It also contains some code to - * cache the user's passphrase for repeat use when decrypting or signing - * a message. +/* This file contains all of the PGP routines necessary to sign, encrypt, + * verify and decrypt PGP messages in either the new PGP/MIME format, or in the + * older Application/Pgp format. It also contains some code to cache the + * user's passphrase for repeat use when decrypting or signing a message. */ #include "config.h" diff --git a/ncrypt/pgppacket.h b/ncrypt/pgppacket.h index 34686bf19..603d9757d 100644 --- a/ncrypt/pgppacket.h +++ b/ncrypt/pgppacket.h @@ -20,9 +20,8 @@ * this program. If not, see . */ -/* - * Definitions for a rudimentary PGP packet parser which is shared - * by neomutt proper and the PGP public key ring lister. +/* Definitions for a rudimentary PGP packet parser which is shared by neomutt + * proper and the PGP public key ring lister. */ #ifndef _NCRYPT_PGPPACKET_H diff --git a/remailer.c b/remailer.c index 45220b8c1..252e44632 100644 --- a/remailer.c +++ b/remailer.c @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - * Mixmaster support for NeoMutt - */ - #include "config.h" #include #include diff --git a/remailer.h b/remailer.h index fbf93bb30..fb49a2829 100644 --- a/remailer.h +++ b/remailer.h @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - * Mixmaster support for NeoMutt - */ - #ifndef _MUTT_REMAILER_H #define _MUTT_REMAILER_H diff --git a/rfc1524.c b/rfc1524.c index 53023baa0..63bc679e0 100644 --- a/rfc1524.c +++ b/rfc1524.c @@ -20,14 +20,13 @@ * this program. If not, see . */ -/* - * rfc1524 defines a format for the Multimedia Mail Configuration, which - * is the standard mailcap file format under Unix which specifies what - * external programs should be used to view/compose/edit multimedia files - * based on content type. +/* RFC1524 defines a format for the Multimedia Mail Configuration, which is the + * standard mailcap file format under Unix which specifies what external + * programs should be used to view/compose/edit multimedia files based on + * content type. * * This file contains various functions for implementing a fair subset of - * rfc1524. + * RFC1524. */ #include "config.h" diff --git a/rfc2231.c b/rfc2231.c index 3609ea2ba..8c774a486 100644 --- a/rfc2231.c +++ b/rfc2231.c @@ -20,13 +20,11 @@ * this program. If not, see . */ -/* - * Yet another MIME encoding for header data. This time, it's - * parameters, specified in RFC2231, and modeled after the - * encoding used in URLs. +/* Yet another MIME encoding for header data. This time, it's parameters, + * specified in RFC2231, and modeled after the encoding used in URLs. * - * Additionally, continuations and encoding are mixed in an, errrm, - * interesting manner. + * Additionally, continuations and encoding are mixed in an, errrm, interesting + * manner. */ #include "config.h" diff --git a/url.c b/url.c index 262ec9130..2ac66cf04 100644 --- a/url.c +++ b/url.c @@ -20,10 +20,6 @@ * this program. If not, see . */ -/* - * A simple URL parser. - */ - #include "config.h" #include #include