From 87209172f0c7b672c2662f75664de7b07edcb802 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Thu, 25 Feb 1999 14:24:22 +0000
Subject: Adjusted comment at the top to be less confusing, following Fredrik
 Lundh's example.

Converted comment to docstring.
---
 Lib/colorsys.py | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/Lib/colorsys.py b/Lib/colorsys.py
index c48b2cb..dd6865c 100644
--- 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?
 
-- 
cgit v0.12