Reformat and add comments for description of C sources

src/plugins/alias/alias-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* alias-config.c: alias configuration options */
+/*
+ * alias-config.c: alias configuration options (file alias.conf)
+ */
 
 
 #include <stdlib.h>

src/plugins/alias/alias-info.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* alias-info.c: info and infolist hooks for alias plugin */
+/*
+ * alias-info.c: info and infolist hooks for alias plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/alias/alias.c

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* alias.c: Alias plugin for WeeChat */
+/*
+ * alias.c: alias plugin for WeeChat: create "alias" commands to run other
+ *          commands
+ */
 
 
 #include <stdlib.h>

src/plugins/aspell/weechat-aspell-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-aspell-config.c: aspell configuration options */
+/*
+ * weechat-aspell-config.c: aspell configuration options (file aspell.conf)
+ */
 
 
 #include <stdlib.h>

src/plugins/aspell/weechat-aspell-speller.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-aspell-speller.c: speller management for aspell plugin */
+/*
+ * weechat-aspell-speller.c: speller management for aspell plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/aspell/weechat-aspell.c

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-aspell.c: aspell plugin for WeeChat */
+/*
+ * weechat-aspell.c: aspell plugin for WeeChat: use color to show mispelled
+ *                   words in input line
+ */
 
 
 #include <stdio.h>

src/plugins/charset/charset.c

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* charset.c: Charset plugin for WeeChat */
+/*
+ * charset.c: charset plugin for WeeChat: encode/decode strings to other
+ *            charset, depending on buffer
+ */
 
 
 #include <stdio.h>

src/plugins/demo/demo.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* demo.c: demo plugin for WeeChat */
+/*
+ * demo.c: demo plugin for WeeChat
+ */
 
 
 #include <stdlib.h>

src/plugins/fifo/fifo-info.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* fifo-info.c: info and infolist hooks for fifo plugin */
+/*
+ * fifo-info.c: info and infolist hooks for fifo plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/fifo/fifo.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* fifo.c: FIFO pipe plugin for WeeChat remote control */
+/*
+ * fifo.c: fifo plugin for WeeChat: remote control with FIFO pipe
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-bar-item.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-bar-item.c: bar items for IRC plugin */
+/*
+ * irc-bar-item.c: bar items for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-buffer.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-buffer.c: buffer functions for IRC plugin */
+/*
+ * irc-buffer.c: buffer functions for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-channel.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-channel.c: manages a chat (channel or private chat) for IRC plugin */
+/*
+ * irc-channel.c: channel and private chat management for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-color.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-color.c: IRC color decoding/encoding in messages */
+/*
+ * irc-color.c: IRC color decoding/encoding in messages
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-command.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-command.c: IRC commands */
+/*
+ * irc-command.c: IRC commands
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-completion.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-completion.c: completion for IRC commands */
+/*
+ * irc-completion.c: completion for IRC commands
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-config.c: IRC configuration options */
+/*
+ * irc-config.c: IRC configuration options (file irc.conf)
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-ctcp.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-ctcp.c: IRC CTCP protocol */
+/*
+ * irc-ctcp.c: IRC CTCP protocol
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-debug.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-debug.c: debug functions for IRC plugin */
+/*
+ * irc-debug.c: debug functions for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-display.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-display.c: display functions for IRC plugin */
+/*
+ * irc-display.c: display functions for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-ignore.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-ignore.c: manages ignore list (nicks/hosts) on IRC servers/channels */
+/*
+ * irc-ignore.c: ignore (nicks/hosts) management for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-info.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-info.c: info and infolist hooks for IRC plugin */
+/*
+ * irc-info.c: info and infolist hooks for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-input.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-input.c: IRC input data (read from user) */
+/*
+ * irc-input.c: input data management for IRC buffers
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-mode.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-mode.c: IRC channel/user modes management */
+/*
+ * irc-mode.c: IRC channel/user modes management
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-msgbuffer.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-msgbuffer.c: target buffer for IRC messages (weechat, current, private) */
+/*
+ * irc-msgbuffer.c: target buffer for IRC messages (weechat, current, private)
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-nick.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-nick.c: manages nick list for channels for IRC plugin */
+/*
+ * irc-nick.c: nick management for IRC plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-protocol.c

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-protocol.c: implementation of IRC protocol, according to RFC 1459, 2810, 2811 2812 */
+/*
+ * irc-protocol.c: implementation of IRC protocol,
+ *                 according to RFC 1459, 2810, 2811 and 2812
+ */
 
 
 #ifndef __USE_XOPEN

src/plugins/irc/irc-raw.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-raw.c: functions for IRC raw data messages */
+/*
+ * irc-raw.c: functions for IRC raw data messages
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-sasl.c

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-sasl.c: SASL authentication with IRC server */
+/*
+ * irc-sasl.c: SASL authentication with IRC server,
+ *             using mechanisms PLAIN or DH-BLOWFISH
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-server.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-server.c: connection and I/O communication with IRC server */
+/*
+ * irc-server.c: I/O communication with IRC servers
+ */
 
 
 #include <stdlib.h>

src/plugins/irc/irc-upgrade.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc-upgrade.c: save/restore IRC plugin data */
+/*
+ * irc-upgrade.c: save/restore IRC plugin data when upgrading WeeChat
+ */
 
 
 #include <stdio.h>

src/plugins/irc/irc.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* irc.c: IRC plugin for WeeChat */
+/*
+ * irc.c: IRC (Internet Relay Chat) plugin for WeeChat
+ */
 
 
 #include <stdlib.h>

src/plugins/logger/logger-buffer.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* logger-buffer.c: manages logger buffer list */
+/*
+ * logger-buffer.c: logger buffer list management
+ */
 
 
 #ifdef HAVE_CONFIG_H

src/plugins/logger/logger-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* logger-config.c: logger configuration options */
+/*
+ * logger-config.c: logger configuration options (file logger.conf)
+ */
 
 
 #include <stdlib.h>

src/plugins/logger/logger-info.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* logger-info.c: info and infolist hooks for logger plugin */
+/*
+ * logger-info.c: info and infolist hooks for logger plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/logger/logger-tail.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* logger-tail.c: return last lines of a file */
+/*
+ * logger-tail.c: return last lines of a file
+ */
 
 
 #ifdef HAVE_CONFIG_H

src/plugins/logger/logger.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* logger.c: Logger plugin for WeeChat */
+/*
+ * logger.c: logger plugin for WeeChat: save buffer lines to disk files
+ */
 
 
 #ifndef _GNU_SOURCE

src/plugins/plugin-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* plugin-api.c: WeeChat <--> plugin API (extra functions) */
+/*
+ * plugin-api.c: extra functions for plugin API
+ */
 
 
 #ifdef HAVE_CONFIG_H

src/plugins/plugin-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* plugin-config.c: plugin configuration */
+/*
+ * plugin-config.c: plugin configuration options (file plugins.conf)
+ */
 
 
 #ifdef HAVE_CONFIG_H

src/plugins/plugin.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* plugin.c: manages WeeChat plugins (dynamic C libraries) */
+/*
+ * plugin.c: WeeChat plugins management (load/unload dynamic C libraries)
+ */
 
 
 #ifdef HAVE_CONFIG_H

src/plugins/relay/relay-buffer.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-buffer.c: display clients list on relay buffer */
+/*
+ * relay-buffer.c: display clients list on relay buffer
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-client.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-client.c: client functions for relay plugin */
+/*
+ * relay-client.c: client functions for relay plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-command.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-command.c: relay command */
+/*
+ * relay-command.c: relay command
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-completion.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-completion.c: completion for relay command */
+/*
+ * relay-completion.c: completion for relay command
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-config.c: relay configuration options */
+/*
+ * relay-config.c: relay configuration options (file relay.conf)
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-info.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-info.c: info and infolist hooks for relay plugin */
+/*
+ * relay-info.c: info and infolist hooks for relay plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-protocol-irc.c

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-protocol-irc.c: IRC protocol for client (relay acting as an IRC proxy/bouncer) */
+/*
+ * relay-protocol-irc.c: IRC protocol for relay to client
+ *                       (relay acting as an IRC proxy/bouncer)
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-protocol-weechat.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-protocol-weechat.c: WeeChat protocol for client */
+/*
+ * relay-protocol-weechat.c: WeeChat protocol for relay to client
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-server.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-server.c: server functions for relay plugin */
+/*
+ * relay-server.c: server functions for relay plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay-upgrade.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay-upgrade.c: save/restore relay plugin data */
+/*
+ * relay-upgrade.c: save/restore relay plugin data when upgrading WeeChat
+ */
 
 
 #include <stdlib.h>

src/plugins/relay/relay.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* relay.c: network communication between WeeChat and remote application */
+/*
+ * relay.c: network communication between WeeChat and remote client
+ */
 
 
 #include <stdlib.h>

src/plugins/scripts/lua/weechat-lua-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-lua-api.c: Lua API functions */
+/*
+ * weechat-lua-api.c: lua API functions
+ */
 
 
 #undef _

src/plugins/scripts/lua/weechat-lua.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-lua.c: Lua plugin for WeeChat */
+/*
+ * weechat-lua.c: lua plugin for WeeChat
+ */
 
 
 #undef _

src/plugins/scripts/perl/weechat-perl-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-perl-api.c: Perl API functions */
+/*
+ * weechat-perl-api.c: perl API functions
+ */
 
 
 #undef _

src/plugins/scripts/perl/weechat-perl.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-perl.c: Perl plugin for WeeChat */
+/*
+ * weechat-perl.c: perl plugin for WeeChat
+ */
 
 
 #undef _

src/plugins/scripts/python/weechat-python-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-python-api.c: Python API functions */
+/*
+ * weechat-python-api.c: python API functions
+ */
 
 
 #undef _

src/plugins/scripts/python/weechat-python.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-python.c: Python plugin for WeeChat */
+/*
+ * weechat-python.c: python plugin for WeeChat
+ */
 
 
 #undef _

src/plugins/scripts/ruby/weechat-ruby-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-ruby-api.c: Ruby API functions */
+/*
+ * weechat-ruby-api.c: ruby API functions
+ */
 
 
 #undef _

src/plugins/scripts/ruby/weechat-ruby.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-ruby.c: Ruby plugin for WeeChat */
+/*
+ * weechat-ruby.c: ruby plugin for WeeChat
+ */
 
 
 #undef _

src/plugins/scripts/script-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* script-api.c: script API */
+/*
+ * script-api.c: script API functions, used by script plugins (perl/python/..)
+ */
 
 
 #include <stdlib.h>

src/plugins/scripts/script-callback.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* script-callback.c: script callbacks */
+/*
+ * script-callback.c: script callbacks management
+ */
 
 
 #include <stdlib.h>

src/plugins/scripts/script.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* script.c: script interface for WeeChat plugins */
+/*
+ * script.c: common functions used by script plugins (perl/python/..)
+ */
 
 
 #include <stdlib.h>

src/plugins/scripts/tcl/weechat-tcl-api.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-tcl-api.c: Tcl API functions */
+/*
+ * weechat-tcl-api.c: tcl API functions
+ */
 
 
 #undef _

src/plugins/scripts/tcl/weechat-tcl.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* weechat-tcl.c: Tcl plugin for WeeChat */
+/*
+ * weechat-tcl.c: tcl plugin for WeeChat
+ */
 
 
 #undef _

src/plugins/xfer/xfer-buffer.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-buffer.c: display xfer list on xfer buffer */
+/*
+ * xfer-buffer.c: display xfer list on xfer buffer
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-chat.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-chat.c: chat with direct connection to remote host */
+/*
+ * xfer-chat.c: chat with direct connection to remote host
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-command.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-command.c: xfer command */
+/*
+ * xfer-command.c: xfer command
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-completion.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-completion.c: nick completion for xfer chats */
+/*
+ * xfer-completion.c: nick completion for xfer chats
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-config.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-config.c: xfer configuration options */
+/*
+ * xfer-config.c: xfer configuration options (file xfer.conf)
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-dcc.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-dcc.c: file transfer via DCC protocol */
+/*
+ * xfer-dcc.c: file transfer via DCC protocol
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-file.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-file.c: file functions for xfer plugin */
+/*
+ * xfer-file.c: file functions for xfer plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-info.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-info.c: info and infolist hooks for xfer plugin */
+/*
+ * xfer-info.c: info and infolist hooks for xfer plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-network.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-network.c: network functions for xfer plugin */
+/*
+ * xfer-network.c: network functions for xfer plugin
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer-upgrade.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer-upgrade.c: save/restore xfer plugin data */
+/*
+ * xfer-upgrade.c: save/restore xfer plugin data when upgrading WeeChat
+ */
 
 
 #include <stdlib.h>

src/plugins/xfer/xfer.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/* xfer.c: file transfer and direct chat plugin for WeeChat */
+/*
+ * xfer.c: file transfer and direct chat plugin for WeeChat
+ */
 
 
 #include <stdlib.h>