* Standardised file description headers

* Added some descriptions

diff --git a/includes/media/BMP.php b/includes/media/BMP.php
index 89c763a..de836b5 100644 (file)
--- a/includes/media/BMP.php
+++ b/includes/media/BMP.php
@@ -1,5 +1,7 @@
 <?php
 /**
+ * Handler for Microsoft's bitmap format
+ *
  * @file
  * @ingroup Media
  */

diff --git a/includes/media/Bitmap.php b/includes/media/Bitmap.php
index 5a64b32..170c0c5 100644 (file)
--- a/includes/media/Bitmap.php
+++ b/includes/media/Bitmap.php
@@ -1,10 +1,14 @@
 <?php
 /**
+ * Generic handler for bitmap images
+ *
  * @file
  * @ingroup Media
  */
 
 /**
+ * Generic handler for bitmap images
+ *
  * @ingroup Media
  */
 class BitmapHandler extends ImageHandler {

diff --git a/includes/media/Bitmap_ClientOnly.php b/includes/media/Bitmap_ClientOnly.php
index d14876c..4cbc407 100644 (file)
--- a/includes/media/Bitmap_ClientOnly.php
+++ b/includes/media/Bitmap_ClientOnly.php
@@ -1,5 +1,19 @@
 <?php
+/**
+ * Handler for bitmap images that will be resized by clients
+ *
+ * @file
+ * @ingroup Media
+ */
 
+/**
+ * Handler for bitmap images that will be resized by clients.
+ *
+ * This is not used by default but can be assigned to some image types
+ * using $wgMediaHandlers.
+ *
+ * @ingroup Media
+ */
 class BitmapHandler_ClientOnly extends BitmapHandler {
        function normaliseParams( $image, &$params ) {
                return parent::normaliseParams( $image, $params );

diff --git a/includes/media/DjVu.php b/includes/media/DjVu.php
index 0812ae5..73b73a2 100644 (file)
--- a/includes/media/DjVu.php
+++ b/includes/media/DjVu.php
@@ -1,10 +1,14 @@
 <?php
 /**
+ * Handler for DjVu images
+ *
  * @file
  * @ingroup Media
  */
  
 /**
+ * Handler for DjVu images
+ *
  * @ingroup Media
  */
 class DjVuHandler extends ImageHandler {

diff --git a/includes/media/GIF.php b/includes/media/GIF.php
index ed3facb..70277c7 100644 (file)
--- a/includes/media/GIF.php
+++ b/includes/media/GIF.php
@@ -1,5 +1,7 @@
 <?php
 /**
+ * Handler for GIF images.
+ *
  * @file
  * @ingroup Media
  */

diff --git a/includes/media/GIFMetadataExtractor.php b/includes/media/GIFMetadataExtractor.php
index fac9012..bc1a480 100644 (file)
--- a/includes/media/GIFMetadataExtractor.php
+++ b/includes/media/GIFMetadataExtractor.php
@@ -1,12 +1,21 @@
 <?php
 /**
-  * GIF frame counter.
-  * Originally written in Perl by Steve Sanbeg.
-  * Ported to PHP by Andrew Garrett
-  * Deliberately not using MWExceptions to avoid external dependencies, encouraging
-  * redistribution.
-  */
+ * GIF frame counter.
+ *
+ * Originally written in Perl by Steve Sanbeg.
+ * Ported to PHP by Andrew Garrett
+ * Deliberately not using MWExceptions to avoid external dependencies, encouraging
+ * redistribution.
+ *
+ * @file
+ * @ingroup Media
+ */
 
+/**
+ * GIF frame counter.
+ *
+ * @ingroup Media
+ */
 class GIFMetadataExtractor {
        static $gif_frame_sep;
        static $gif_extension_sep;

diff --git a/includes/media/Generic.php b/includes/media/Generic.php
index f53ad7b..9dbd7e3 100644 (file)
--- a/includes/media/Generic.php
+++ b/includes/media/Generic.php
@@ -1,6 +1,7 @@
 <?php
 /**
  * Media-handling base classes and generic functionality
+ *
  * @file
  * @ingroup Media
  */

diff --git a/includes/media/MediaTransformOutput.php b/includes/media/MediaTransformOutput.php
index 21a3f5d..927db92 100644 (file)
--- a/includes/media/MediaTransformOutput.php
+++ b/includes/media/MediaTransformOutput.php
@@ -1,5 +1,7 @@
 <?php
 /**
+ * Base class for the output of file transformation methods.
+ *
  * @file
  * @ingroup Media
  */

diff --git a/includes/media/PNG.php b/includes/media/PNG.php
index 21de7f2..fb912c4 100644 (file)
--- a/includes/media/PNG.php
+++ b/includes/media/PNG.php
@@ -1,5 +1,7 @@
 <?php
 /**
+ * Handler for PNG images.
+ *
  * @file
  * @ingroup Media
  */

diff --git a/includes/media/PNGMetadataExtractor.php b/includes/media/PNGMetadataExtractor.php
index 2edeca5..490abea 100644 (file)
--- a/includes/media/PNGMetadataExtractor.php
+++ b/includes/media/PNGMetadataExtractor.php
@@ -1,11 +1,19 @@
 <?php
 /**
-  * PNG frame counter.
-  * Slightly derived from GIFMetadataExtractor.php
-  * Deliberately not using MWExceptions to avoid external dependencies, encouraging
-  * redistribution.
-  */
+ * PNG frame counter.
+ * Slightly derived from GIFMetadataExtractor.php
+ * Deliberately not using MWExceptions to avoid external dependencies, encouraging
+ * redistribution.
+ *
+ * @file
+ * @ingroup Media
+ */
 
+/**
+ * PNG frame counter.
+ *
+ * @ingroup Media
+ */
 class PNGMetadataExtractor {
        static $png_sig;
        static $CRC_size;

diff --git a/includes/media/SVG.php b/includes/media/SVG.php
index 69a36f3..fae3091 100644 (file)
--- a/includes/media/SVG.php
+++ b/includes/media/SVG.php
@@ -1,10 +1,14 @@
 <?php
 /**
+ * Handler for SVG images.
+ *
  * @file
  * @ingroup Media
  */
 
 /**
+ * Handler for SVG images.
+ *
  * @ingroup Media
  */
 class SvgHandler extends ImageHandler {

diff --git a/includes/media/Tiff.php b/includes/media/Tiff.php
index 859595b..8773201 100644 (file)
--- a/includes/media/Tiff.php
+++ b/includes/media/Tiff.php
@@ -1,10 +1,14 @@
 <?php
 /**
+ * Handler for Tiff images.
+ *
  * @file
  * @ingroup Media
  */
 
 /**
+ * Handler for Tiff images.
+ *
  * @ingroup Media
  */
 class TiffHandler extends BitmapHandler {