Update translator documentation.

i18n/L10n updates.
Whitespace updates.

plugins/UserFlag/User_flag_profile.php

@@ -157,7 +157,8 @@ class User_flag_profile extends Memcached_DataObject
 
         if (!$ufp->insert()) {
             // TRANS: Server exception.
-            $msg = sprintf(_m('Couldn\'t flag profile "%d" for review.'),
+            // TRANS: %d is a profile ID (number).
+            $msg = sprintf(_m('Could not flag profile "%d" for review.'),
                            $profile_id);
             throw new ServerException($msg);
         }

plugins/UserFlag/adminprofileflag.php

@@ -86,6 +86,7 @@ class AdminprofileflagAction extends Action
         // User must have the right to review flags
 
         if (!$user->hasRight(UserFlagPlugin::REVIEWFLAGS)) {
+            // TRANS: Error message displayed when trying to review profile flags while not authorised.
             $this->clientError(_m('You cannot review profile flags.'));
             return false;
         }
@@ -385,7 +386,7 @@ class FlaggedProfileListItem extends ProfileListItem
                 $flagging_users = implode(', ', $lnks);
                 // TRANS: Message displayed on a profile if it has been flagged.
                 // TRANS: %1$s is a comma separated list of at most 5 user nicknames that flagged.
-                // TRANS: %2$d is a positive integer of additional flagging users. Also used for the plural.
+                // TRANS: %2$d is a positive integer of additional flagging users. Also used for plural.
                 $text .= sprintf(_m('Flagged by %1$s and %2$d other', 'Flagged by %1$s and %2$d others', $others), $flagging_users, $others);
             } else {
                 // TRANS: Message displayed on a profile if it has been flagged.

plugins/UserFlag/clearflag.php

@@ -49,7 +49,6 @@ class ClearflagAction extends ProfileFormAction
      *
      * @return boolean success flag
      */
-
     function prepare($args)
     {
         if (!parent::prepare($args)) {
@@ -102,7 +101,8 @@ class ClearflagAction extends ProfileFormAction
 
         if ($result == false) {
             // TRANS: Server exception given when flags could not be cleared.
-            $msg = sprintf(_m('Couldn\'t clear flags for profile "%s".'),
+            // TRANS: %s is a profile nickname.
+            $msg = sprintf(_m('Could not clear flags for profile "%s".'),
                            $this->profile->nickname);
             throw new ServerException($msg);
         }

plugins/UserFlag/clearflagform.php

@@ -84,7 +84,7 @@ class ClearFlagForm extends ProfileActionForm
 
     function description()
     {
-        // Form description for clearing flags from a profile.
+        // TRANS: Form description for clearing flags from a profile.
         return _m('Clear all flags');
     }
 }