Reformat and add comments for description of C sources

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>