WordPress 4.3
[autoinstalls/wordpress.git] / wp-includes / pomo / po.php
index 6e549a2a12bab75b5830efde7b265f79a28f9cb7..381977c5cfd7525c88f3f36505d635881dca72a3 100644 (file)
@@ -189,8 +189,8 @@ class PO extends Gettext_Translations {
         * Builds a string from the entry for inclusion in PO file
         *
         * @static
         * Builds a string from the entry for inclusion in PO file
         *
         * @static
-        * @param object &$entry the entry to convert to po string
-        * @return string|bool PO-style formatted string for the entry or
+        * @param Translation_Entry &$entry the entry to convert to po string
+        * @return false|string PO-style formatted string for the entry or
         *      false if the entry is empty
         */
        function export_entry(&$entry) {
         *      false if the entry is empty
         */
        function export_entry(&$entry) {
@@ -215,6 +215,10 @@ class PO extends Gettext_Translations {
                return implode("\n", $po);
        }
 
                return implode("\n", $po);
        }
 
+       /**
+        * @param string $filename
+        * @return boolean
+        */
        function import_from_file($filename) {
                $f = fopen($filename, 'r');
                if (!$f) return false;
        function import_from_file($filename) {
                $f = fopen($filename, 'r');
                if (!$f) return false;
@@ -238,6 +242,11 @@ class PO extends Gettext_Translations {
                return true;
        }
 
                return true;
        }
 
+       /**
+        * @param resource $f
+        * @param int      $lineno
+        * @return null|false|array
+        */
        function read_entry($f, $lineno = 0) {
                $entry = new Translation_Entry();
                // where were we in the last step
        function read_entry($f, $lineno = 0) {
                $entry = new Translation_Entry();
                // where were we in the last step
@@ -343,6 +352,14 @@ class PO extends Gettext_Translations {
                return array('entry' => $entry, 'lineno' => $lineno);
        }
 
                return array('entry' => $entry, 'lineno' => $lineno);
        }
 
+       /**
+        * @staticvar string   $last_line
+        * @staticvar boolean  $use_last_line
+        * 
+        * @param     resource $f
+        * @param     string   $action
+        * @return boolean
+        */
        function read_line($f, $action = 'read') {
                static $last_line = '';
                static $use_last_line = false;
        function read_line($f, $action = 'read') {
                static $last_line = '';
                static $use_last_line = false;
@@ -361,6 +378,10 @@ class PO extends Gettext_Translations {
                return $line;
        }
 
                return $line;
        }
 
+       /**
+        * @param Translation_Entry $entry
+        * @param string            $po_comment_line
+        */
        function add_comment_to_entry(&$entry, $po_comment_line) {
                $first_two = substr($po_comment_line, 0, 2);
                $comment = trim(substr($po_comment_line, 2));
        function add_comment_to_entry(&$entry, $po_comment_line) {
                $first_two = substr($po_comment_line, 0, 2);
                $comment = trim(substr($po_comment_line, 2));
@@ -375,6 +396,10 @@ class PO extends Gettext_Translations {
                }
        }
 
                }
        }
 
+       /**
+        * @param string $s
+        * @return sring
+        */
        function trim_quotes($s) {
                if ( substr($s, 0, 1) == '"') $s = substr($s, 1);
                if ( substr($s, -1, 1) == '"') $s = substr($s, 0, -1);
        function trim_quotes($s) {
                if ( substr($s, 0, 1) == '"') $s = substr($s, 1);
                if ( substr($s, -1, 1) == '"') $s = substr($s, 0, -1);