Changeset 30663

Timestamp:

11/30/2014 09:40:53 PM (10 years ago)

Author:

wonderboymusic

Message:

Add missing @params to src/wp-includes/pomo files.

See #30224.

Location:

trunk/src/wp-includes/pomo

Files:

• mo.php (modified) (1 diff)
• po.php (modified) (6 diffs)
• streams.php (modified) (7 diffs)
• translations.php (modified) (13 diffs)

trunk/src/wp-includes/pomo/mo.php

@@ -140 +140 @@
     }
 
+
+
+
     function import_from_reader($reader) {
         $endian_string = MO::get_byteorder($reader->readint32());

trunk/src/wp-includes/pomo/po.php

@@ -190 +190 @@
      *
      * @static
-     * @param object &$entry the entry to convert to po string
-     * @return string|bool PO-style formatted string for the entry or
+     * @param  &$entry the entry to convert to po string
+     * @return  PO-style formatted string for the entry or
      *  false if the entry is empty
      */
@@ -216 +216 @@
     }
 
+
+
+
+
     function import_from_file($filename) {
         $f = fopen($filename, 'r');
@@ -239 +243 @@
     }
 
+
+
+
+
+
     function read_entry($f, $lineno = 0) {
         $entry = new Translation_Entry();
@@ -344 +353 @@
     }
 
+
+
+
+
+
+
+
     function read_line($f, $action = 'read') {
         static $last_line = '';
@@ -362 +378 @@
     }
 
+
+
+
+
     function add_comment_to_entry(&$entry, $po_comment_line) {
         $first_two = substr($po_comment_line, 0, 2);
@@ -376 +396 @@
     }
 
+
+
+
+
     function trim_quotes($s) {
         if ( substr($s, 0, 1) == '"') $s = substr($s, 1);

trunk/src/wp-includes/pomo/streams.php

@@ -59 +59 @@
     }
 
-
+    /**
+     * @param string $string
+     * @param int    $start
+     * @param int    $length
+     * @return string
+     */
     function substr($string, $start, $length) {
         if ($this->is_overloaded) {
@@ -68 +73 @@
     }
 
+
+
+
+
     function strlen($string) {
         if ($this->is_overloaded) {
@@ -76 +85 @@
     }
 
+
+
+
+
+
     function str_split($string, $chunk_size) {
         if (!function_exists('str_split')) {
@@ -105 +119 @@
 if ( !class_exists( 'POMO_FileReader' ) ):
 class POMO_FileReader extends POMO_Reader {
+
+
+
+
     function POMO_FileReader($filename) {
         parent::POMO_Reader();
@@ -110 +128 @@
     }
 
+
+
+
     function read($bytes) {
         return fread($this->_f, $bytes);
     }
 
+
+
+
+
     function seekto($pos) {
         if ( -1 == fseek($this->_f, $pos, SEEK_SET)) {
@@ -158 +183 @@
     }
 
-
+    /**
+     * @param string $bytes
+     * @return string
+     */
     function read($bytes) {
         $data = $this->substr($this->_str, $this->_pos, $bytes);
@@ -166 +194 @@
     }
 
+
+
+
+
     function seekto($pos) {
         $this->_pos = $pos;

trunk/src/wp-includes/pomo/translations.php

@@ -18 +18 @@
      * Add entry to the PO structure
      *
-     * @param object &$entry
+     * @param  &$entry
      * @return bool true on success, false if the entry doesn't have a key
      */
@@ -31 +31 @@
     }
 
+
+
+
+
     function add_entry_or_merge($entry) {
         if (is_array($entry)) {
@@ -58 +62 @@
     }
 
+
+
+
     function set_headers($headers) {
         foreach($headers as $header => $value) {
@@ -64 +71 @@
     }
 
+
+
+
     function get_header($header) {
         return isset($this->headers[$header])? $this->headers[$header] : false;
     }
 
+
+
+
     function translate_entry(&$entry) {
         $key = $entry->key();
@@ -73 +86 @@
     }
 
+
+
+
+
+
     function translate($singular, $context=null) {
         $entry = new Translation_Entry(array('singular' => $singular, 'context' => $context));
@@ -98 +116 @@
     }
 
+
+
+
+
+
+
     function translate_plural($singular, $plural, $count, $context = null) {
         $entry = new Translation_Entry(array('singular' => $singular, 'plural' => $plural, 'context' => $context));
@@ -140 +164 @@
      * they can't share it effectively.
      *
+
      */
     function gettext_select_plural_form($count) {
@@ -150 +175 @@
     }
 
+
+
+
+
     function nplurals_and_expression_from_header($header) {
         if (preg_match('/^\s*nplurals\s*=\s*(\d+)\s*;\s+plural\s*=\s*(.+)$/', $header, $matches)) {
@@ -163 +192 @@
      * Makes a function, which will return the right translation index, according to the
      * plural forms header
+
+
      */
     function make_plural_form_function($nplurals, $expression) {
@@ -204 +235 @@
     }
 
+
+
+
+
     function make_headers($translation) {
         $headers = array();
@@ -217 +252 @@
     }
 
+
+
+
+
     function set_header($header, $value) {
         parent::set_header($header, $value);
@@ -254 +293 @@
     }
 
+
+
+
+
     function translate($singular, $context=null) {
         return $singular;
@@ -266 +309 @@
     }
 
+
+
+
+
+
+
     function translate_plural($singular, $plural, $count, $context = null) {
             return 1 == $count? $singular : $plural;