core: move comments with description of C file to top of files

25 files changed, 50 insertions, 102 deletions

diff --git a/src/plugins/irc/irc-bar-item.c b/src/plugins/irc/irc-bar-item.c
index 8ca00a302..29a4e6b3d 100644
--- a/src/plugins/irc/irc-bar-item.c
+++ b/src/plugins/irc/irc-bar-item.c
@@ -1,4 +1,6 @@
 /*
+ * irc-bar-item.c - bar items for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-bar-item.c: bar items for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-buffer.c b/src/plugins/irc/irc-buffer.c
index c87a784ea..e9d79021b 100644
--- a/src/plugins/irc/irc-buffer.c
+++ b/src/plugins/irc/irc-buffer.c
@@ -1,4 +1,6 @@
 /*
+ * irc-buffer.c - buffer functions for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-buffer.c: buffer functions for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-channel.c b/src/plugins/irc/irc-channel.c
index 67e971817..018eed426 100644
--- a/src/plugins/irc/irc-channel.c
+++ b/src/plugins/irc/irc-channel.c
@@ -1,4 +1,6 @@
 /*
+ * irc-channel.c - channel and private chat management for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-channel.c: channel and private chat management for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stddef.h>
 #include <unistd.h>
diff --git a/src/plugins/irc/irc-color.c b/src/plugins/irc/irc-color.c
index a3ffb19c1..b15fd5249 100644
--- a/src/plugins/irc/irc-color.c
+++ b/src/plugins/irc/irc-color.c
@@ -1,4 +1,6 @@
 /*
+ * irc-color.c - IRC color decoding/encoding in messages
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-color.c: IRC color decoding/encoding in messages
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-command.c b/src/plugins/irc/irc-command.c
index 2a8327e85..64a196c1a 100644
--- a/src/plugins/irc/irc-command.c
+++ b/src/plugins/irc/irc-command.c
@@ -1,4 +1,6 @@
 /*
+ * irc-command.c - IRC commands
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  * Copyright (C) 2006 Emmanuel Bouthenot <kolter@openics.org>
  *
@@ -18,10 +20,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-command.c: IRC commands
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-completion.c b/src/plugins/irc/irc-completion.c
index c98e4f083..882f7c34d 100644
--- a/src/plugins/irc/irc-completion.c
+++ b/src/plugins/irc/irc-completion.c
@@ -1,4 +1,6 @@
 /*
+ * irc-completion.c - completion for IRC commands
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-completion.c: completion for IRC commands
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-config.c b/src/plugins/irc/irc-config.c
index d94c4ff96..97b448d8c 100644
--- a/src/plugins/irc/irc-config.c
+++ b/src/plugins/irc/irc-config.c
@@ -1,4 +1,6 @@
 /*
+ * irc-config.c - IRC configuration options (file irc.conf)
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-config.c: IRC configuration options (file irc.conf)
- */
-
 #include <stdlib.h>
 #include <unistd.h>
 #include <stdio.h>
diff --git a/src/plugins/irc/irc-ctcp.c b/src/plugins/irc/irc-ctcp.c
index bf9d2b7c3..c73f7da87 100644
--- a/src/plugins/irc/irc-ctcp.c
+++ b/src/plugins/irc/irc-ctcp.c
@@ -1,4 +1,6 @@
 /*
+ * irc-ctcp.c - IRC CTCP protocol
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-ctcp.c: IRC CTCP protocol
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-debug.c b/src/plugins/irc/irc-debug.c
index 248a4ff31..9da282dcf 100644
--- a/src/plugins/irc/irc-debug.c
+++ b/src/plugins/irc/irc-debug.c
@@ -1,4 +1,6 @@
 /*
+ * irc-debug.c - debug functions for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-debug.c: debug functions for IRC plugin
- */
-
 #include <stdlib.h>
 #include <string.h>
 
diff --git a/src/plugins/irc/irc-display.c b/src/plugins/irc/irc-display.c
index acb7dd1bb..d428d0a9d 100644
--- a/src/plugins/irc/irc-display.c
+++ b/src/plugins/irc/irc-display.c
@@ -1,4 +1,6 @@
 /*
+ * irc-display.c - display functions for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-display.c: display functions for IRC plugin
- */
-
 #include <stdlib.h>
 #include <unistd.h>
 #include <stdio.h>
diff --git a/src/plugins/irc/irc-ignore.c b/src/plugins/irc/irc-ignore.c
index 37c43ab85..7d9a1a9c7 100644
--- a/src/plugins/irc/irc-ignore.c
+++ b/src/plugins/irc/irc-ignore.c
@@ -1,4 +1,6 @@
 /*
+ * irc-ignore.c - ignore (nicks/hosts) management for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-ignore.c: ignore (nicks/hosts) management for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stddef.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-info.c b/src/plugins/irc/irc-info.c
index fc9be774b..0702558b2 100644
--- a/src/plugins/irc/irc-info.c
+++ b/src/plugins/irc/irc-info.c
@@ -1,4 +1,6 @@
 /*
+ * irc-info.c - info, infolist and hdata hooks for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-info.c: info, infolist and hdata hooks for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-input.c b/src/plugins/irc/irc-input.c
index 063fae8d2..c2f87db32 100644
--- a/src/plugins/irc/irc-input.c
+++ b/src/plugins/irc/irc-input.c
@@ -1,4 +1,6 @@
 /*
+ * irc-input.c - input data management for IRC buffers
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-input.c: input data management for IRC buffers
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-message.c b/src/plugins/irc/irc-message.c
index 2d6870649..c1cd85382 100644
--- a/src/plugins/irc/irc-message.c
+++ b/src/plugins/irc/irc-message.c
@@ -1,4 +1,6 @@
 /*
+ * irc-message.c - functions for IRC messages
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-message.c: functions for IRC messages
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-mode.c b/src/plugins/irc/irc-mode.c
index dd496ce13..1ea11679b 100644
--- a/src/plugins/irc/irc-mode.c
+++ b/src/plugins/irc/irc-mode.c
@@ -1,4 +1,6 @@
 /*
+ * irc-mode.c - IRC channel/user modes management
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-mode.c: IRC channel/user modes management
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-msgbuffer.c b/src/plugins/irc/irc-msgbuffer.c
index a65b5b6de..554883ac0 100644
--- a/src/plugins/irc/irc-msgbuffer.c
+++ b/src/plugins/irc/irc-msgbuffer.c
@@ -1,4 +1,6 @@
 /*
+ * irc-msgbuffer.c - target buffer for IRC messages
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-msgbuffer.c: target buffer for IRC messages (weechat, current, private)
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-nick.c b/src/plugins/irc/irc-nick.c
index 0e2b21485..642532e84 100644
--- a/src/plugins/irc/irc-nick.c
+++ b/src/plugins/irc/irc-nick.c
@@ -1,4 +1,6 @@
 /*
+ * irc-nick.c - nick management for IRC plugin
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-nick.c: nick management for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stddef.h>
 #include <stdio.h>
diff --git a/src/plugins/irc/irc-notify.c b/src/plugins/irc/irc-notify.c
index 2af2b2e65..6c68a604a 100644
--- a/src/plugins/irc/irc-notify.c
+++ b/src/plugins/irc/irc-notify.c
@@ -1,4 +1,6 @@
 /*
+ * irc-notify.c - notify lists for IRC plugin
+ *
  * Copyright (C) 2010-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-notify.c: notify lists for IRC plugin
- */
-
 #include <stdlib.h>
 #include <stddef.h>
 #include <stdio.h>
diff --git a/src/plugins/irc/irc-protocol.c b/src/plugins/irc/irc-protocol.c
index 9eb236005..07aebcc4f 100644
--- a/src/plugins/irc/irc-protocol.c
+++ b/src/plugins/irc/irc-protocol.c
@@ -1,4 +1,6 @@
 /*
+ * irc-protocol.c - implementation of IRC protocol (RFC 1459/2810/2811/2812)
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  * Copyright (C) 2006 Emmanuel Bouthenot <kolter@openics.org>
  *
@@ -18,11 +20,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-protocol.c: implementation of IRC protocol,
- *                 according to RFC 1459, 2810, 2811 and 2812
- */
-
 /* this define is needed for strptime() (not on OpenBSD) */
 #if !defined(__OpenBSD__)
 #define _XOPEN_SOURCE 700
diff --git a/src/plugins/irc/irc-raw.c b/src/plugins/irc/irc-raw.c
index 095d0db3e..041039bb1 100644
--- a/src/plugins/irc/irc-raw.c
+++ b/src/plugins/irc/irc-raw.c
@@ -1,4 +1,6 @@
 /*
+ * irc-raw.c - functions for IRC raw data messages
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-raw.c: functions for IRC raw data messages
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-redirect.c b/src/plugins/irc/irc-redirect.c
index d77861f25..6c26562be 100644
--- a/src/plugins/irc/irc-redirect.c
+++ b/src/plugins/irc/irc-redirect.c
@@ -1,4 +1,6 @@
 /*
+ * irc-redirect.c - redirection of IRC command output
+ *
  * Copyright (C) 2010-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-redirect.c: redirection of IRC command output
- */
-
 #include <stdlib.h>
 #include <stddef.h>
 #include <stdio.h>
diff --git a/src/plugins/irc/irc-sasl.c b/src/plugins/irc/irc-sasl.c
index fe38e16ab..c3d87b0b4 100644
--- a/src/plugins/irc/irc-sasl.c
+++ b/src/plugins/irc/irc-sasl.c
@@ -1,4 +1,6 @@
 /*
+ * irc-sasl.c - SASL authentication with IRC server
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,11 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-sasl.c: SASL authentication with IRC server,
- *             using mechanisms PLAIN or DH-BLOWFISH
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc-server.c b/src/plugins/irc/irc-server.c
index 426615ceb..b38b9a9a9 100644
--- a/src/plugins/irc/irc-server.c
+++ b/src/plugins/irc/irc-server.c
@@ -1,4 +1,6 @@
 /*
+ * irc-server.c - I/O communication with IRC servers
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  * Copyright (C) 2005-2010 Emmanuel Bouthenot <kolter@openics.org>
  * Copyright (C) 2012 Simon Arlott
@@ -19,10 +21,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-server.c: I/O communication with IRC servers
- */
-
 #include <stdlib.h>
 #include <stddef.h>
 #include <unistd.h>
diff --git a/src/plugins/irc/irc-upgrade.c b/src/plugins/irc/irc-upgrade.c
index 94ff03340..e2ba4e184 100644
--- a/src/plugins/irc/irc-upgrade.c
+++ b/src/plugins/irc/irc-upgrade.c
@@ -1,4 +1,6 @@
 /*
+ * irc-upgrade.c - save/restore IRC plugin data when upgrading WeeChat
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc-upgrade.c: save/restore IRC plugin data when upgrading WeeChat
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/irc/irc.c b/src/plugins/irc/irc.c
index be16b6828..2efdaf381 100644
--- a/src/plugins/irc/irc.c
+++ b/src/plugins/irc/irc.c
@@ -1,4 +1,6 @@
 /*
+ * irc.c - IRC (Internet Relay Chat) plugin for WeeChat
+ *
  * Copyright (C) 2003-2012 Sebastien Helleu <flashcode@flashtux.org>
  *
  * This file is part of WeeChat, the extensible chat client.
@@ -17,10 +19,6 @@
  * along with WeeChat.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * irc.c: IRC (Internet Relay Chat) plugin for WeeChat
- */
-
 #include <stdlib.h>
 #include <string.h>
 #include <time.h>