From e1f5c11aeee468d0c27e78f30da6ad192aa8a703 Mon Sep 17 00:00:00 2001
From: Sam Reed <reedy@users.mediawiki.org>
Date: Sun, 27 Feb 2011 15:23:41 +0000
Subject: [PATCH] More bits of documentation

---
 includes/Title.php                | 3 +++
 includes/parser/Parser.php        | 9 ++++++++-
 includes/parser/ParserOptions.php | 4 ++++
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/includes/Title.php b/includes/Title.php
index d69610f4f4..399eb49688 100644
--- a/includes/Title.php
+++ b/includes/Title.php
@@ -3704,6 +3704,9 @@ class Title {
 	/**
 	 * Callback for usort() to do title sorts by (namespace, title)
 	 *
+	 * @param $a Title
+	 * @param $b Title
+	 *
 	 * @return Integer: result of string comparison, or namespace comparison
 	 */
 	public static function compare( $a, $b ) {
diff --git a/includes/parser/Parser.php b/includes/parser/Parser.php
index b9341d2393..5d1535ddf6 100644
--- a/includes/parser/Parser.php
+++ b/includes/parser/Parser.php
@@ -112,7 +112,6 @@ class Parser {
 	var $mVariables, $mSubstWords; # Initialised by initialiseVariables()
 	var $mConf, $mPreprocessor, $mExtLinkBracketedRegex, $mUrlProtocols; # Initialised in constructor
 
-
 	# Cleared with clearState():
 	var $mOutput, $mAutonumber, $mDTopen;
 
@@ -127,6 +126,10 @@ class Parser {
 	var $mTplExpandCache; # empty-frame expansion cache
 	var $mTplRedirCache, $mTplDomCache, $mHeadings, $mDoubleUnderscores;
 	var $mExpensiveFunctionCount; # number of expensive parser function calls
+
+	/**
+	 * @var User
+	 */
 	var $mUser; # User object; only used when doing pre-save transform
 
 	# Temporary
@@ -136,6 +139,10 @@ class Parser {
 	 * @var ParserOptions
 	 */
 	var $mOptions;
+
+	/**
+	 * @var Title
+	 */
 	var $mTitle;        # Title context, used for self-link rendering and similar things
 	var $mOutputType;   # Output type, one of the OT_xxx constants
 	var $ot;            # Shortcut alias, see setOutputType()
diff --git a/includes/parser/ParserOptions.php b/includes/parser/ParserOptions.php
index 7a6b877cde..39e9ec7fa0 100644
--- a/includes/parser/ParserOptions.php
+++ b/includes/parser/ParserOptions.php
@@ -91,6 +91,10 @@ class ParserOptions {
 	function getUser()                          { return $this->mUser; }
 	function getPreSaveTransform()              { return $this->mPreSaveTransform; }
 
+	/**
+	 * @param $title Title
+	 * @return Skin
+	 */
 	function getSkin( $title = null ) {
 		if ( !isset( $this->mSkin ) ) {
 			$this->mSkin = $this->mUser->getSkin( $title );
-- 
2.20.1