From 345aca4eddd25ecc3f064cff7617530f6060b7d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20=C4=8Ciha=C5=99?= <michal@cihar.com>
Date: Fri, 7 Jun 2013 09:24:19 +0200
Subject: [PATCH 1/3] Fix comment

---
 scripts/advisor2po | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scripts/advisor2po b/scripts/advisor2po
index b7f73b394d..a4e078af33 100644
--- a/scripts/advisor2po
+++ b/scripts/advisor2po
@@ -1,8 +1,8 @@
 <?php
 /* vim: set expandtab sw=4 ts=4 sts=4 ft=php: */
 /**
- * Script to parse advisor rules and output them as PHP code which can be used 
- * by gettext for generating po(t) files.
+ * Script to parse advisor rules and output them as Gettext POT formatted
+ * strings for translation.
  */
 
 function format_string($str) {

From 685f504094e316fbf1b98245a125ceab2d27e444 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20=C4=8Ciha=C5=99?= <michal@cihar.com>
Date: Fri, 7 Jun 2013 09:24:44 +0200
Subject: [PATCH 2/3] Remove not used function

---
 scripts/advisor2po | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/scripts/advisor2po b/scripts/advisor2po
index a4e078af33..56e8d12e03 100644
--- a/scripts/advisor2po
+++ b/scripts/advisor2po
@@ -5,10 +5,6 @@
  * strings for translation.
  */
 
-function format_string($str) {
-    return addcslashes(Advisor::escapePercent($str), '"\\');
-}
-
 $messages = array();
 $locations = array();
 

From d8f09813e1c41b9cff4d2b59209f3b9581ec2da2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20=C4=8Ciha=C5=99?= <michal@cihar.com>
Date: Fri, 7 Jun 2013 09:26:04 +0200
Subject: [PATCH 3/3] Document functions

---
 scripts/advisor2po | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/scripts/advisor2po b/scripts/advisor2po
index 56e8d12e03..7c0e1805e0 100644
--- a/scripts/advisor2po
+++ b/scripts/advisor2po
@@ -8,6 +8,9 @@
 $messages = array();
 $locations = array();
 
+/**
+ * Processes single advisor message and stores data in global array.
+ */
 function add_message($rules, $idx, $type) {
     global $messages, $locations;
     // Get message text
@@ -28,6 +31,9 @@ function add_message($rules, $idx, $type) {
     }
 }
 
+/**
+ * Prints message at given location as Gettext string for translation.
+ */
 function print_message($idx) {
     global $messages, $locations;
     echo "\n";