]> git.mxchange.org Git - quix0rs-gnu-social.git/commitdiff
Upadte translator documentation.
authorSiebrand Mazeland <s.mazeland@xs4all.nl>
Sun, 3 Apr 2011 12:24:55 +0000 (14:24 +0200)
committerSiebrand Mazeland <s.mazeland@xs4all.nl>
Sun, 3 Apr 2011 12:24:55 +0000 (14:24 +0200)
Add FIXME for missing class documentation.
i18n/L10n tweaks.
Superfluous whitespace removed.

16 files changed:
lib/noticeplaceholderform.php
lib/nudgeform.php
lib/oauthstore.php
lib/pluginlist.php
lib/redirectingaction.php
lib/repeatform.php
lib/revokeroleform.php
lib/sandboxform.php
lib/section.php
lib/silenceform.php
lib/subscribeform.php
lib/subscriberspeopleselftagcloudsection.php
lib/subscriberspeopletagcloudsection.php
lib/subscriptionlist.php
lib/subscriptionspeopleselftagcloudsection.php
lib/subscriptionspeopletagcloudsection.php

index 788a2021d93fdd370a3ee46542355bf369fbdcc3..87e64fb8d0f34742925d4faea5db0f32370197b9 100644 (file)
@@ -51,6 +51,7 @@ class NoticePlaceholderForm extends Widget
     function show()
     {
         // Similar to that for inline replies, but not quite!
+        // TRANS: Field label for notice text.
         $placeholder = _('Update your status...');
         $this->out->elementStart('div', 'form_notice_placeholder');
         $this->out->element('input', array('class' => 'placeholder',
index 18a008122d9d54d3c468afe9f747e6ab6872e8db..9a86576a892f9782b5c4e971f81adcab6264b959 100644 (file)
@@ -46,13 +46,11 @@ require_once INSTALLDIR.'/lib/form.php';
  *
  * @see      DisfavorForm
  */
-
 class NudgeForm extends Form
 {
     /**
      * Profile of user to nudge
      */
-
     var $profile = null;
 
     /**
@@ -61,7 +59,6 @@ class NudgeForm extends Form
      * @param HTMLOutputter $out     output channel
      * @param Profile       $profile profile of user to nudge
      */
-
     function __construct($out=null, $profile=null)
     {
         parent::__construct($out);
@@ -74,7 +71,6 @@ class NudgeForm extends Form
      *
      * @return int ID of the form
      */
-
     function id()
     {
         return 'form_user_nudge';
@@ -86,7 +82,6 @@ class NudgeForm extends Form
      *
      * @return string of the form class
      */
-
     function formClass()
     {
         return 'form_user_nudge ajax';
@@ -98,7 +93,6 @@ class NudgeForm extends Form
      *
      * @return string URL of the action
      */
-
     function action()
     {
         return common_local_url('nudge',
@@ -113,6 +107,7 @@ class NudgeForm extends Form
      */
     function formLegend()
     {
+        // TRANS: Form legend of form to nudge/ping another user.
         $this->out->element('legend', null, _('Nudge this user'));
     }
 
@@ -122,9 +117,14 @@ class NudgeForm extends Form
      *
      * @return void
      */
-
     function formActions()
     {
-        $this->out->submit('submit', _('Nudge'), 'submit', null, _('Send a nudge to this user'));
+        $this->out->submit('submit',
+                           // TRANS: Button text to nudge/ping another user.
+                           _m('BUTTON','Nudge'),
+                           'submit',
+                           null,
+                           // TRANS: Button title to nudge/ping another user.
+                           _('Send a nudge to this user.'));
     }
 }
index a52f6cee33968af8bf745703d5a19d6c43938249..570343b82dc7f87207d184eb815678783e2dda89 100644 (file)
@@ -21,9 +21,9 @@ if (!defined('STATUSNET') && !defined('LACONICA')) { exit(1); }
 
 require_once 'libomb/datastore.php';
 
+// @todo FIXME: Class documentation missing.
 class StatusNetOAuthDataStore extends OAuthDataStore
 {
-
     // We keep a record of who's contacted us
     function lookup_consumer($consumer_key)
     {
@@ -69,9 +69,7 @@ class StatusNetOAuthDataStore extends OAuthDataStore
     // http://oauth.net/core/1.0/#nonce
     // "The Consumer SHALL then generate a Nonce value that is unique for
     // all requests with that timestamp."
-
     // XXX: It's not clear why the token is here
-
     function lookup_nonce($consumer, $token, $nonce, $timestamp)
     {
         $n = new Nonce();
@@ -104,7 +102,6 @@ class StatusNetOAuthDataStore extends OAuthDataStore
     }
 
     // defined in OAuthDataStore, but not implemented anywhere
-
     function fetch_request_token($consumer)
     {
         return $this->new_request_token($consumer);
@@ -161,7 +158,6 @@ class StatusNetOAuthDataStore extends OAuthDataStore
     }
 
     // defined in OAuthDataStore, but not implemented anywhere
-
     function fetch_access_token($consumer)
     {
         return $this->new_access_token($consumer);
@@ -232,7 +228,7 @@ class StatusNetOAuthDataStore extends OAuthDataStore
      **/
     public function getProfile($identifier_uri) {
         /* getProfile is only used for remote profiles by libomb.
-           TODO: Make it work with local ones anyway. */
+           @TODO: Make it work with local ones anyway. */
         $remote = Remote_profile::staticGet('uri', $identifier_uri);
         if (!$remote) throw new Exception('No such remote profile');
         $profile = Profile::staticGet('id', $remote->id);
@@ -291,6 +287,7 @@ class StatusNetOAuthDataStore extends OAuthDataStore
                 $profile->created = DB_DataObject_Cast::dateTime(); # current time
                 $id = $profile->insert();
                 if (!$id) {
+                    // TRANS: Exception thrown when creating a new profile fails in OAuth store.
                     throw new Exception(_('Error inserting new profile.'));
                 }
                 $remote->id = $id;
@@ -299,6 +296,7 @@ class StatusNetOAuthDataStore extends OAuthDataStore
             $avatar_url = $omb_profile->getAvatarURL();
             if ($avatar_url) {
                 if (!$this->add_avatar($profile, $avatar_url)) {
+                    // TRANS: Exception thrown when creating a new avatar fails in OAuth store.
                     throw new Exception(_('Error inserting avatar.'));
                 }
             } else {
@@ -314,11 +312,13 @@ class StatusNetOAuthDataStore extends OAuthDataStore
 
             if ($exists) {
                 if (!$remote->update($orig_remote)) {
+                    // TRANS: Exception thrown when updating a remote profile fails in OAuth store.
                     throw new Exception(_('Error updating remote profile.'));
                 }
             } else {
                 $remote->created = DB_DataObject_Cast::dateTime(); # current time
                 if (!$remote->insert()) {
+                    // TRANS: Exception thrown when creating a remote profile fails in OAuth store.
                     throw new Exception(_('Error inserting remote profile.'));
                 }
             }
@@ -479,6 +479,7 @@ class StatusNetOAuthDataStore extends OAuthDataStore
 
         if (!$subscriber->hasRight(Right::SUBSCRIBE)) {
             common_log(LOG_INFO, __METHOD__ . ": remote subscriber banned ($subscriber_uri subbing to $subscribed_user_uri)");
+            // TRANS: Error message displayed to a banned user when they try to subscribe.
             return _('You have been banned from subscribing.');
         }
 
@@ -504,7 +505,8 @@ class StatusNetOAuthDataStore extends OAuthDataStore
 
         if (!$result) {
             common_log_db_error($sub, ($sub_exists) ? 'UPDATE' : 'INSERT', __FILE__);
-            throw new Exception(_('Couldn\'t insert new subscription.'));
+            // TRANS: Exception thrown when creating a new subscription fails in OAuth store.
+            throw new Exception(_('Could not insert new subscription.'));
             return;
         }
 
@@ -516,4 +518,3 @@ class StatusNetOAuthDataStore extends OAuthDataStore
         }
     }
 }
-?>
index 07a17ba397ba30a72e885cfc985eda08f706f33b..0bd1a153551a6d67c46ced461f769d7903590d42 100644 (file)
@@ -43,7 +43,6 @@ require INSTALLDIR . "/lib/plugindisableform.php";
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class PluginList extends Widget
 {
     var $plugins = array();
@@ -116,7 +115,7 @@ class PluginListItem extends Widget
             $this->out->elementEnd('a');
         }
         $this->out->elementEnd('div');
-        
+
         $form = $this->getControlForm();
         $form->show();
 
@@ -192,6 +191,7 @@ class PluginListItem extends Widget
             return $found;
         } else {
             return array('name' => $this->plugin,
+                         // TRANS: Plugin description for a disabled plugin.
                          'rawdescription' => _m('plugin-description',
                                                 '(Plugin descriptions unavailable when disabled.)'));
         }
index 3a358f891c6c0c83f4ec8d21af4dc086dd72c930..0827f11a0a097ff84e887f47768af3da36c83a21 100644 (file)
@@ -42,21 +42,18 @@ if (!defined('STATUSNET') && !defined('LACONICA')) {
  * @license  http://www.fsf.org/licensing/licenses/agpl.html AGPLv3
  * @link     http://status.net/
  */
-
-
 class RedirectingAction extends Action
 {
-
     /**
      * Redirect browser to the page our hidden parameters requested,
      * or if none given, to the url given by $this->defaultReturnTo().
-     * 
+     *
      * To be called only after successful processing.
-     * 
+     *
      * Note: this was named returnToArgs() up through 0.9.2, which
      * caused problems because there's an Action::returnToArgs()
      * already which does something different.
-     * 
+     *
      * @return void
      */
     function returnToPrevious()
@@ -87,11 +84,12 @@ class RedirectingAction extends Action
      * If we reached this form without returnto arguments, where should
      * we go? May be overridden by subclasses to a reasonable destination
      * for that action; default implementation throws an exception.
-     * 
+     *
      * @return string URL
      */
     function defaultReturnTo()
     {
-        $this->clientError(_("No return-to arguments."));
+        // TRANS: Client error displayed when return-to was defined without a target.
+        $this->clientError(_('No return-to arguments.'));
     }
 }
index 4f1c8aa3201d7cc44453f56c1aa2f79e541ed18e..67fc47b8de59ddb1f22d72454943483d4c92b2c3 100644 (file)
@@ -40,13 +40,11 @@ if (!defined('STATUSNET')) {
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class RepeatForm extends Form
 {
     /**
      * Notice to repeat
      */
-
     var $notice = null;
 
     /**
@@ -55,7 +53,6 @@ class RepeatForm extends Form
      * @param HTMLOutputter $out    output channel
      * @param Notice        $notice notice to repeat
      */
-
     function __construct($out=null, $notice=null)
     {
         parent::__construct($out);
@@ -68,7 +65,6 @@ class RepeatForm extends Form
      *
      * @return int ID of the form
      */
-
     function id()
     {
         return 'repeat-' . $this->notice->id;
@@ -79,7 +75,6 @@ class RepeatForm extends Form
      *
      * @return string URL of the action
      */
-
     function action()
     {
         return common_local_url('repeat');
@@ -90,7 +85,6 @@ class RepeatForm extends Form
      *
      * @return void
      */
-
     function sessionToken()
     {
         $this->out->hidden('token-' . $this->notice->id,
@@ -104,6 +98,7 @@ class RepeatForm extends Form
      */
     function formLegend()
     {
+        // TRANS: For legend for notice repeat form.
         $this->out->element('legend', null, _('Repeat this notice?'));
     }
 
@@ -112,7 +107,6 @@ class RepeatForm extends Form
      *
      * @return void
      */
-
     function formData()
     {
         $this->out->hidden('notice-n'.$this->notice->id,
@@ -125,11 +119,13 @@ class RepeatForm extends Form
      *
      * @return void
      */
-
     function formActions()
     {
         $this->out->submit('repeat-submit-' . $this->notice->id,
-                           _('Yes'), 'submit', null, _('Repeat this notice'));
+                           // TRANS: Button text to repeat a notice on notice repeat form.
+                           _m('BUTTON','Yes'), 'submit', null,
+                           // TRANS: Button title to repeat a notice on notice repeat form.
+                           _('Repeat this notice.'));
     }
 
     /**
@@ -137,7 +133,6 @@ class RepeatForm extends Form
      *
      * @return string the form's class
      */
-
     function formClass()
     {
         return 'form_repeat';
index ec24b991011d48e84a1e1c9403e91347e8e39a79..f33951bb40e54e76ea5d14c7c3c1bc1aebcaa5e7 100644 (file)
@@ -42,7 +42,6 @@ if (!defined('STATUSNET')) {
  *
  * @see      UnSandboxForm
  */
-
 class RevokeRoleForm extends ProfileActionForm
 {
     function __construct($role, $label, $writer, $profile, $r2args)
@@ -57,7 +56,6 @@ class RevokeRoleForm extends ProfileActionForm
      *
      * @return string Name of the action, lowercased.
      */
-
     function target()
     {
         return 'revokerole';
@@ -68,7 +66,6 @@ class RevokeRoleForm extends ProfileActionForm
      *
      * @return string Title of the form, internationalized
      */
-
     function title()
     {
         return $this->label;
@@ -85,9 +82,9 @@ class RevokeRoleForm extends ProfileActionForm
      *
      * @return string description of the form, internationalized
      */
-
     function description()
     {
+        // TRANS: Description of role revoke form. %s is the role to be revoked.
         return sprintf(_('Revoke the "%s" role from this user'), $this->label);
     }
 }
index 7a98e0a5f9e19580f4b40b9c03f4811304be8133..d1e4fea96357839cc9d75b8a579af6f015cbaa33 100644 (file)
@@ -42,7 +42,6 @@ if (!defined('STATUSNET')) {
  *
  * @see      UnSandboxForm
  */
-
 class SandboxForm extends ProfileActionForm
 {
     /**
@@ -50,7 +49,6 @@ class SandboxForm extends ProfileActionForm
      *
      * @return string Name of the action, lowercased.
      */
-
     function target()
     {
         return 'sandbox';
@@ -61,10 +59,10 @@ class SandboxForm extends ProfileActionForm
      *
      * @return string Title of the form, internationalized
      */
-
     function title()
     {
-        return _('Sandbox');
+        // TRANS: Title of form to sandbox a user.
+        return _m('TITLE','Sandbox');
     }
 
     /**
@@ -72,9 +70,9 @@ class SandboxForm extends ProfileActionForm
      *
      * @return string description of the form, internationalized
      */
-
     function description()
     {
+        // TRANS: Description of form to sandbox a user.
         return _('Sandbox this user');
     }
 }
index 53a3a70fa723fd9af5ab50d91a491aff0138bde2..753a37efa424dc52c4f7da187aff869f464aade0 100644 (file)
@@ -45,7 +45,6 @@ require_once INSTALLDIR.'/lib/widget.php';
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class Section extends Widget
 {
     /**
@@ -56,7 +55,6 @@ class Section extends Widget
      * @return void
      * @see Widget::show()
      */
-
     function show()
     {
         $this->out->elementStart('div',
@@ -86,12 +84,14 @@ class Section extends Widget
 
     function title()
     {
+        // TRANS: Default title for section/sidebar widget.
         return _('Untitled section');
     }
 
     function showContent()
     {
         $this->out->element('p', null,
+                            // TRANS: Default content for section/sidebar widget.
                             _('(None)'));
         return false;
     }
@@ -103,6 +103,7 @@ class Section extends Widget
 
     function moreTitle()
     {
+        // TRANS: Default "More..." title for section/sidebar widget.
         return _('More...');
     }
 }
index 9673fa120896e6224fba6b4a15513805d1bcea21..9d05f5d09f37c1d4e7f8793598500c088103b6d3 100644 (file)
@@ -42,7 +42,6 @@ if (!defined('STATUSNET')) {
  *
  * @see      UnSilenceForm
  */
-
 class SilenceForm extends ProfileActionForm
 {
     /**
@@ -50,7 +49,6 @@ class SilenceForm extends ProfileActionForm
      *
      * @return string Name of the action, lowercased.
      */
-
     function target()
     {
         return 'silence';
@@ -61,10 +59,10 @@ class SilenceForm extends ProfileActionForm
      *
      * @return string Title of the form, internationalized
      */
-
     function title()
     {
-        return _('Silence');
+        // TRANS: Title of form to silence a user.
+        return _m('TITLE','Silence');
     }
 
     /**
@@ -72,9 +70,9 @@ class SilenceForm extends ProfileActionForm
      *
      * @return string description of the form, internationalized
      */
-
     function description()
     {
+        // TRANS: Description of form to silence a user.
         return _('Silence this user');
     }
 }
index 1cc5b4e48eccc18fda8289afadbab92829cac247..f10d884ed8bea9a231f613cef2941ff1d5854ff4 100644 (file)
@@ -46,13 +46,11 @@ require_once INSTALLDIR.'/lib/form.php';
  *
  * @see      UnsubscribeForm
  */
-
 class SubscribeForm extends Form
 {
     /**
      * Profile of user to subscribe to
      */
-
     var $profile = null;
 
     /**
@@ -61,7 +59,6 @@ class SubscribeForm extends Form
      * @param HTMLOutputter $out     output channel
      * @param Profile       $profile profile of user to subscribe to
      */
-
     function __construct($out=null, $profile=null)
     {
         parent::__construct($out);
@@ -74,37 +71,31 @@ class SubscribeForm extends Form
      *
      * @return int ID of the form
      */
-
     function id()
     {
         return 'subscribe-' . $this->profile->id;
     }
 
-
     /**
      * class of the form
      *
      * @return string of the form class
      */
-
     function formClass()
     {
         return 'form_user_subscribe ajax';
     }
 
-
     /**
      * Action of the form
      *
      * @return string URL of the action
      */
-
     function action()
     {
         return common_local_url('subscribe');
     }
 
-
     /**
      * Legend of the Form
      *
@@ -112,6 +103,7 @@ class SubscribeForm extends Form
      */
     function formLegend()
     {
+        // TRANS: Form of form to subscribe to a user.
         $this->out->element('legend', null, _('Subscribe to this user'));
     }
 
@@ -120,7 +112,6 @@ class SubscribeForm extends Form
      *
      * @return void
      */
-
     function formData()
     {
         $this->out->hidden('subscribeto-' . $this->profile->id,
@@ -133,9 +124,11 @@ class SubscribeForm extends Form
      *
      * @return void
      */
-
     function formActions()
     {
-        $this->out->submit('submit', _('Subscribe'), 'submit', null, _('Subscribe to this user'));
+        // TRANS: Button text to subscribe to a user.
+        $this->out->submit('submit', _m('BUTTON','Subscribe'), 'submit', null,
+                           // TRANS: Button title to subscribe to a user.
+                           _('Subscribe to this user.'));
     }
 }
index 5a570ae2823e8625fb35049b796a313fb3188c0b..47b94227e855860f24d672be464f20ed570f594a 100644 (file)
@@ -40,23 +40,17 @@ if (!defined('STATUSNET') && !defined('LACONICA')) {
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class SubscribersPeopleSelfTagCloudSection extends SubPeopleTagCloudSection
 {
     function title()
     {
+        // TRANS: Title of personal tag cloud section.
         return _('People Tagcloud as self-tagged');
     }
 
     function query() {
 //        return 'select tag, count(tag) as weight from subscription left join profile_tag on tagger = subscriber where subscribed=%d and subscribed != subscriber and tagger = tagged group by tag order by weight desc';
-
-
         return 'select tag, count(tag) as weight from subscription left join profile_tag on tagger = subscriber where subscribed=%d and subscribed != subscriber and tagger = tagged and tag is not null group by tag order by weight desc';
-
 //        return 'select tag, count(tag) as weight from subscription left join profile_tag on tagger = subscribed where subscriber=%d and subscribed != subscriber and tagger = tagged and tag is not null group by tag order by weight desc';
-
-
     }
 }
-
index 284996b5917b104d72141faca6646c640f35c35a..93cf4aa5dfede2327cdf01b54c77a375d7eefed4 100644 (file)
@@ -40,11 +40,11 @@ if (!defined('STATUSNET') && !defined('LACONICA')) {
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class SubscribersPeopleTagCloudSection extends SubPeopleTagCloudSection
 {
     function title()
     {
+        // TRANS: Title of personal tag cloud section.
         return _('People Tagcloud as tagged');
     }
 
@@ -58,4 +58,3 @@ class SubscribersPeopleTagCloudSection extends SubPeopleTagCloudSection
         return 'select tag, count(tag) as weight from subscription left join profile_tag on subscriber=tagged and subscribed=tagger where subscribed=%d and subscriber != subscribed and tag is not null group by tag order by weight desc';
     }
 }
-
index 3ca4603948004536195bca3e04d828dc68df743d..ea0aa7f1abe498914afcb632aeeb2b957ee89cfa 100644 (file)
@@ -1,5 +1,4 @@
 <?php
-
 /**
  * StatusNet, the distributed open-source microblogging tool
  *
@@ -101,8 +100,10 @@ class SubscriptionListItem extends ProfileListItem
         if ($this->isOwn()) {
             $this->out->element('a', array('href' => common_local_url('tagother',
                                                                       array('id' => $this->profile->id))),
+                                // TRANS: Description for link to "tag other users" in widget to show a list of profiles.
                                 _('Tags'));
         } else {
+            // TRANS: Text widget to show a list of profiles with their tags.
             $this->out->text(_('Tags'));
         }
         if ($tags) {
@@ -120,6 +121,7 @@ class SubscriptionListItem extends ProfileListItem
             }
             $this->out->elementEnd('ul');
         } else {
+            // TRANS: Text if there are no tags in widget to show a list of profiles by tag.
             $this->out->text(_('(None)'));
         }
     }
index 9be60dfa1481eccbb32aa85e6dacaf246ed6087a..134b5c4456f306da090e78cf77fa1d237fd8a353 100644 (file)
@@ -40,22 +40,17 @@ if (!defined('STATUSNET') && !defined('LACONICA')) {
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class SubscriptionsPeopleSelfTagCloudSection extends SubPeopleTagCloudSection
 {
     function title()
     {
+        // TRANS: Title of personal tag cloud section.
         return _('People Tagcloud as self-tagged');
     }
 
     function query() {
 //        return 'select tag, count(tag) as weight from subscription left join profile_tag on tagger = subscriber where subscribed=%d and subscriber != subscribed and tagger = tagged group by tag order by weight desc';
-
-
-
         return 'select tag, count(tag) as weight from subscription left join profile_tag on tagger = subscribed where subscriber=%d and subscribed != subscriber and tagger = tagged and tag is not null group by tag order by weight desc';
-
 //        return 'select tag, count(tag) as weight from subscription left join profile_tag on tagger = subscriber where subscribed=%d and subscribed != subscriber and tagger = tagged and tag is not null group by tag order by weight desc';
     }
 }
-
index fde24b282e17d097df805eeacf9fb7b37cbc36ee..6b888894ef3bf85166e8020156fba7068af626d8 100644 (file)
@@ -40,11 +40,11 @@ if (!defined('STATUSNET') && !defined('LACONICA')) {
  * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  * @link     http://status.net/
  */
-
 class SubscriptionsPeopleTagCloudSection extends SubPeopleTagCloudSection
 {
     function title()
     {
+        // TRANS: Title of personal tag cloud section.
         return _('People Tagcloud as tagged');
     }
 
@@ -58,4 +58,3 @@ class SubscriptionsPeopleTagCloudSection extends SubPeopleTagCloudSection
         return 'select tag, count(tag) as weight from subscription left join profile_tag on subscriber=tagger and subscribed=tagged where subscriber=%d and subscriber != subscribed and tag is not null group by tag order by weight desc';
     }
 }
-