* morituri/common/program.py:

Comment where we got the template variables from.
	* morituri/rip/cd.py:
	  Document the template variables.

ChangeLog

@@ -1,3 +1,10 @@
+2010-07-08  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+	* morituri/common/program.py:
+	  Comment where we got the template variables from.
+	* morituri/rip/cd.py:
+	  Document the template variables.
+
 2010-06-19  Thomas Vander Stichele  <thomas at apestaart dot org>
 
 	* morituri/program/cdparanoia.py:

morituri/common/program.py

@@ -249,6 +249,8 @@ class Program(log.Loggable):
         assert type(outdir) is unicode, "%r is not unicode" % outdir
         assert type(template) is unicode, "%r is not unicode" % template
 
+        # the template is similar to grip, except for %s/%S
+
         # returns without extension
 
         v = {}

morituri/rip/cd.py

@@ -36,6 +36,21 @@ from morituri.program import cdrdao, cdparanoia
 class Rip(logcommand.LogCommand):
     summary = "rip CD"
 
+    description = """
+Rips a CD.
+
+Tracks are named according to the track template:
+ - %t: track number
+ - %a: track artist
+ - %n: track title
+ - %s: track sort name
+
+Discs are named according to the disc template:
+ - %A: album artist
+ - %S: album sort name
+ - %d: disc title
+"""
+
     def addOptions(self):
         # FIXME: get from config
         default = 0