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

15 files changed, 30 insertions, 61 deletions

diff --git a/src/plugins/relay/irc/relay-irc.c b/src/plugins/relay/irc/relay-irc.c
index e163069dc..e94724ebd 100644
--- a/src/plugins/relay/irc/relay-irc.c
+++ b/src/plugins/relay/irc/relay-irc.c
@@ -1,4 +1,6 @@
 /*
+ * relay-irc.c - IRC protocol for relay to client: IRC proxy/bouncer
+ *
  * 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/>.
  */
 
-/*
- * relay-irc.c: IRC protocol for relay to client
- *              (relay acting as an IRC proxy/bouncer)
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/relay/relay-buffer.c b/src/plugins/relay/relay-buffer.c
index fbd412a8f..5012b7325 100644
--- a/src/plugins/relay/relay-buffer.c
+++ b/src/plugins/relay/relay-buffer.c
@@ -1,4 +1,6 @@
 /*
+ * relay-buffer.c - display clients list on relay buffer
+ *
  * 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/>.
  */
 
-/*
- * relay-buffer.c: display clients list on relay buffer
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/relay/relay-client.c b/src/plugins/relay/relay-client.c
index ac5ee65e3..0d326b637 100644
--- a/src/plugins/relay/relay-client.c
+++ b/src/plugins/relay/relay-client.c
@@ -1,4 +1,6 @@
 /*
+ * relay-client.c - client functions for relay 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/>.
  */
 
-/*
- * relay-client.c: client functions for relay plugin
- */
-
 #include <stdlib.h>
 #include <unistd.h>
 #include <stdio.h>
diff --git a/src/plugins/relay/relay-command.c b/src/plugins/relay/relay-command.c
index a530ad32a..9b5b9325c 100644
--- a/src/plugins/relay/relay-command.c
+++ b/src/plugins/relay/relay-command.c
@@ -1,4 +1,6 @@
 /*
+ * relay-command.c - relay command
+ *
  * 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/>.
  */
 
-/*
- * relay-command.c: relay command
- */
-
 #include <stdlib.h>
 #include <string.h>
 #include <time.h>
diff --git a/src/plugins/relay/relay-completion.c b/src/plugins/relay/relay-completion.c
index fa1bdb9aa..ca33a89aa 100644
--- a/src/plugins/relay/relay-completion.c
+++ b/src/plugins/relay/relay-completion.c
@@ -1,4 +1,6 @@
 /*
+ * relay-completion.c - completion for relay command
+ *
  * 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/>.
  */
 
-/*
- * relay-completion.c: completion for relay command
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/relay/relay-config.c b/src/plugins/relay/relay-config.c
index 12db7d0f6..2f66e23b8 100644
--- a/src/plugins/relay/relay-config.c
+++ b/src/plugins/relay/relay-config.c
@@ -1,4 +1,6 @@
 /*
+ * relay-config.c - relay configuration options (file relay.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/>.
  */
 
-/*
- * relay-config.c: relay configuration options (file relay.conf)
- */
-
 #include <stdlib.h>
 #include <limits.h>
 #include <regex.h>
diff --git a/src/plugins/relay/relay-info.c b/src/plugins/relay/relay-info.c
index fdd05fa65..4514a23f7 100644
--- a/src/plugins/relay/relay-info.c
+++ b/src/plugins/relay/relay-info.c
@@ -1,4 +1,6 @@
 /*
+ * relay-info.c - info and infolist hooks for relay 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/>.
  */
 
-/*
- * relay-info.c: info and infolist hooks for relay plugin
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 
diff --git a/src/plugins/relay/relay-network.c b/src/plugins/relay/relay-network.c
index 48606f0eb..470ff49a9 100644
--- a/src/plugins/relay/relay-network.c
+++ b/src/plugins/relay/relay-network.c
@@ -1,4 +1,6 @@
 /*
+ * relay-network.c - network functions for relay 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/>.
  */
 
-/*
- * relay-network.c: network functions for relay plugin
- */
-
 #include <stdlib.h>
 
 #ifdef HAVE_GNUTLS
diff --git a/src/plugins/relay/relay-raw.c b/src/plugins/relay/relay-raw.c
index b689d7c31..3e3c2fbcc 100644
--- a/src/plugins/relay/relay-raw.c
+++ b/src/plugins/relay/relay-raw.c
@@ -1,4 +1,6 @@
 /*
+ * relay-raw.c - functions for Relay 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/>.
  */
 
-/*
- * relay-raw.c: functions for Relay raw data messages
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <stdarg.h>
diff --git a/src/plugins/relay/relay-server.c b/src/plugins/relay/relay-server.c
index e7cc36dbe..00d8f23cd 100644
--- a/src/plugins/relay/relay-server.c
+++ b/src/plugins/relay/relay-server.c
@@ -1,4 +1,6 @@
 /*
+ * relay-server.c - server functions for relay 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/>.
  */
 
-/*
- * relay-server.c: server functions for relay plugin
- */
-
 #include <stdlib.h>
 #include <unistd.h>
 #include <stdio.h>
diff --git a/src/plugins/relay/relay-upgrade.c b/src/plugins/relay/relay-upgrade.c
index f18a18a90..dadbfc5ac 100644
--- a/src/plugins/relay/relay-upgrade.c
+++ b/src/plugins/relay/relay-upgrade.c
@@ -1,4 +1,6 @@
 /*
+ * relay-upgrade.c - save/restore relay 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/>.
  */
 
-/*
- * relay-upgrade.c: save/restore relay plugin data when upgrading WeeChat
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/relay/relay.c b/src/plugins/relay/relay.c
index 2d73ddc5a..b5c3c4c16 100644
--- a/src/plugins/relay/relay.c
+++ b/src/plugins/relay/relay.c
@@ -1,4 +1,6 @@
 /*
+ * relay.c - network communication between WeeChat and remote client
+ *
  * 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/>.
  */
 
-/*
- * relay.c: network communication between WeeChat and remote client
- */
-
 #include <stdlib.h>
 #include <string.h>
 
diff --git a/src/plugins/relay/weechat/relay-weechat-msg.c b/src/plugins/relay/weechat/relay-weechat-msg.c
index f550074da..741059473 100644
--- a/src/plugins/relay/weechat/relay-weechat-msg.c
+++ b/src/plugins/relay/weechat/relay-weechat-msg.c
@@ -1,4 +1,6 @@
 /*
+ * relay-weechat-msg.c - build binary messages for WeeChat 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/>.
  */
 
-/*
- * relay-weechat-msg.c: build binary messages for WeeChat protocol
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/relay/weechat/relay-weechat-protocol.c b/src/plugins/relay/weechat/relay-weechat-protocol.c
index b3f79b257..a25cfa967 100644
--- a/src/plugins/relay/weechat/relay-weechat-protocol.c
+++ b/src/plugins/relay/weechat/relay-weechat-protocol.c
@@ -1,4 +1,6 @@
 /*
+ * relay-weechat-protocol.c - WeeChat protocol for relay to client
+ *
  * 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/>.
  */
 
-/*
- * relay-weechat-protocol.c: WeeChat protocol for relay to client
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/src/plugins/relay/weechat/relay-weechat.c b/src/plugins/relay/weechat/relay-weechat.c
index 6453697f2..4a9042de8 100644
--- a/src/plugins/relay/weechat/relay-weechat.c
+++ b/src/plugins/relay/weechat/relay-weechat.c
@@ -1,4 +1,6 @@
 /*
+ * relay-weechat.c - WeeChat protocol for relay to client
+ *
  * 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/>.
  */
 
-/*
- * relay-weechat.c: WeeChat protocol for relay to client
- */
-
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>