From b89965cded3205280eb659843a2baa5d0bcc1f3d Mon Sep 17 00:00:00 2001
From: Antoine Musso <hashar@users.mediawiki.org>
Date: Fri, 3 Sep 2004 21:02:18 +0000
Subject: [PATCH] Skins classes under their own phpdocumentor subpackage:
 "Skins"

---
 skins/Chick.php         | 16 ++++++++++++++++
 skins/CologneBlue.php   | 21 +++++++++++++++------
 skins/DaVinci.php       | 14 ++++++++++++++
 skins/Mono.php          | 14 ++++++++++++++
 skins/MonoBook.php      | 14 ++++++++++++++
 skins/MySkin.php        | 14 ++++++++++++++
 skins/Nostalgia.php     | 32 +++++++++++++++++++-------------
 skins/Standard.php      | 37 ++++++++++++++++++++++++++++---------
 skins/WikimediaWiki.php | 11 +++++++++--
 9 files changed, 143 insertions(+), 30 deletions(-)

diff --git a/skins/Chick.php b/skins/Chick.php
index 729d59e4d0..f3e06f3775 100644
--- a/skins/Chick.php
+++ b/skins/Chick.php
@@ -1,7 +1,23 @@
 <?php
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/** */
 if ($wgUsePHPTal) {
 require_once('includes/SkinPHPTal.php');
 
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinChick extends SkinPHPTal {
 	function initPage( &$out ) {
 		SkinPHPTal::initPage( $out );
diff --git a/skins/CologneBlue.php b/skins/CologneBlue.php
index b2f99aa275..871eff555a 100644
--- a/skins/CologneBlue.php
+++ b/skins/CologneBlue.php
@@ -1,18 +1,27 @@
 <?php
-# See skin.doc
-
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinCologneBlue extends Skin {
 
-	function getStylesheet()
-	{
+	function getStylesheet() {
 		return "cologneblue.css";
 	}
 	function getSkinName() {
 		return "cologneblue";
 	}
 
-	function doBeforeContent()
-	{
+	function doBeforeContent() {
 		global $wgUser, $wgOut, $wgTitle, $wgSiteNotice;
 
 		$s = "";
diff --git a/skins/DaVinci.php b/skins/DaVinci.php
index aa3631510b..3d8d13e4d1 100644
--- a/skins/DaVinci.php
+++ b/skins/DaVinci.php
@@ -1,7 +1,21 @@
 <?php
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/** */
 if ($wgUsePHPTal) {
 require_once('includes/SkinPHPTal.php');
 
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinDaVinci extends SkinPHPTal {
 	function initPage( &$out ) {
 		SkinPHPTal::initPage( $out );
diff --git a/skins/Mono.php b/skins/Mono.php
index 0ed50793cc..0c8b813298 100644
--- a/skins/Mono.php
+++ b/skins/Mono.php
@@ -1,7 +1,21 @@
 <?php
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/** */
 if ($wgUsePHPTal) {
 require_once('includes/SkinPHPTal.php');
 
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinMono extends SkinPHPTal {
 	function initPage( &$out ) {
 		SkinPHPTal::initPage( $out );
diff --git a/skins/MonoBook.php b/skins/MonoBook.php
index 1257c923f2..4fb9673d74 100644
--- a/skins/MonoBook.php
+++ b/skins/MonoBook.php
@@ -1,7 +1,21 @@
 <?php
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/** */
 if ($wgUsePHPTal) {
 require_once('includes/SkinPHPTal.php');
 
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinMonoBook extends SkinPHPTal {
 	function initPage( &$out ) {
 		SkinPHPTal::initPage( $out );
diff --git a/skins/MySkin.php b/skins/MySkin.php
index e1e332a376..5e3b8d5429 100644
--- a/skins/MySkin.php
+++ b/skins/MySkin.php
@@ -1,7 +1,21 @@
 <?php
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/** */
 if ($wgUsePHPTal) {
 require_once('includes/SkinPHPTal.php');
 
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinMySkin extends SkinPHPTal {
 	function initPage( &$out ) {
 		SkinPHPTal::initPage( $out );
diff --git a/skins/Nostalgia.php b/skins/Nostalgia.php
index 301bbf0338..0fceccc9bc 100644
--- a/skins/Nostalgia.php
+++ b/skins/Nostalgia.php
@@ -1,23 +1,31 @@
 <?php
-# See skin.doc
-
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinNostalgia extends Skin {
 
-	function initPage()
-	{
+	function initPage() {
 		# ...
 	}
 
-	function getStylesheet()
-	{
-		return "nostalgia.css";
+	function getStylesheet() {
+		return 'nostalgia.css';
 	}
 	function getSkinName() {
 		return "nostalgia";
 	}
 
-	function doBeforeContent()
-	{
+	function doBeforeContent() {
 		global $wgUser, $wgOut, $wgTitle, $wgSiteNotice;
 
 		$s = "\n<div id='content'>\n<div id='topbar'>";
@@ -44,8 +52,7 @@ class SkinNostalgia extends Skin {
 		return $s;
 	}
 
-	function topLinks()
-	{
+	function topLinks() {
 		global $wgOut, $wgUser;
 		$sep = " |\n";
 
@@ -66,8 +73,7 @@ class SkinNostalgia extends Skin {
 		return $s;
 	}
 
-	function doAfterContent()
-	{
+	function doAfterContent() {
 		global $wgUser, $wgOut;
 
 		$s = "\n</div><br clear='all' />\n";
diff --git a/skins/Standard.php b/skins/Standard.php
index ba367a370d..3c9d368437 100644
--- a/skins/Standard.php
+++ b/skins/Standard.php
@@ -1,10 +1,23 @@
 <?php
-# See skin.doc
+/**
+ * See skin.doc
+ *
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 
+/**
+ * @todo document
+ * @package MediaWiki
+ * @subpackage Skins
+ */
 class SkinStandard extends Skin {
 
-	function getHeadScripts()
-	{
+	/**
+	 *
+	 */
+	function getHeadScripts() {
 		global $wgStylePath;
 
 		$s = parent::getHeadScripts();
@@ -15,8 +28,10 @@ class SkinStandard extends Skin {
 		return $s;
 	}
 
-	function getUserStyles()
-	{
+	/**
+	 *
+	 */
+	function getUserStyles() {
 		global $wgStylePath;
 		$s = '';
 		if ( 3 == $this->qbSetting() ) { # Floating left
@@ -27,8 +42,10 @@ class SkinStandard extends Skin {
 		return $s;
 	}
 
-	function doGetUserStyles()
-	{
+	/**
+	 *
+	 */
+	function doGetUserStyles() {
 		global $wgUser, $wgOut, $wgStylePath;
 
 		$s = parent::doGetUserStyles();
@@ -46,8 +63,10 @@ class SkinStandard extends Skin {
 		return $s;
 	}
 
-	function getBodyOptions()
-	{
+	/**
+	 *
+	 */
+	function getBodyOptions() {
 		$a = parent::getBodyOptions();
 
 		if ( 3 == $this->qbSetting() ) { # Floating left
diff --git a/skins/WikimediaWiki.php b/skins/WikimediaWiki.php
index 9f4f2d6231..760e1ace15 100644
--- a/skins/WikimediaWiki.php
+++ b/skins/WikimediaWiki.php
@@ -1,6 +1,13 @@
 <?php
-# Tentative to make a skin for wikimedia.org
-# $Id$
+/**
+ * Tentative to make a skin for wikimedia.org
+ *
+ * @version $Id$
+ * @package MediaWiki
+ * @subpackage Skins
+ */
+
+/** */
 
 if($wgUsePHPTal) {
 require_once('includes/SkinPHPTal.php');
-- 
2.20.1