Adjusted comment at the top to be less confusing, following Fredrik

Lundh's example.

Converted comment to docstring.

diff --git a/Lib/colorsys.py b/Lib/colorsys.py
index c48b2cbc302f4579861df2f3c1488d74a95f226e..dd6865cbe0f30ff77a0361ea54c270ebb2da4876 100644 (file)
--- a/Lib/colorsys.py
+++ b/Lib/colorsys.py
@@ -1,17 +1,19 @@
-# Conversion functions between RGB and other color systems.
-#
-# Define two functions for each color system XYZ:
-#   rgb_to_xyz(r, g, b) --> x, y, z
-#   xyz_to_rgb(x, y, z) --> r, g, b
-# All inputs and outputs are triples of floats in the range [0.0...1.0].
-# Inputs outside this range may cause exceptions or invalid outputs.
-#
-# Supported color systems:
-# RGB: Red, Green, Blue components
-# YIQ: used by composite video signals
-# HLS: Hue, Luminance, S???
-# HSV: Hue, Saturation, Value(?)
-#
+"""Conversion functions between RGB and other color systems.
+
+This modules provides two functions for each color system ABC:
+
+  rgb_to_abc(r, g, b) --> a, b, c
+  abc_to_rgb(x, y, z) --> r, g, b
+
+All inputs and outputs are triples of floats in the range [0.0...1.0].
+Inputs outside this range may cause exceptions or invalid outputs.
+
+Supported color systems:
+RGB: Red, Green, Blue components
+YIQ: used by composite video signals
+HLS: Hue, Luminance, S???
+HSV: Hue, Saturation, Value(?)
+"""
 # References:
 # XXX Where's the literature?