From a5ae1715a3438a3d2d7d9de9943ff0333cfef959 Mon Sep 17 00:00:00 2001
From: jlgijsbers <jlgijsbers@57a73879-2fb5-44c3-a270-3262357dd7e2>
Date: Fri, 24 Oct 2003 19:48:05 +0000
Subject: [PATCH] Clarify listTemplates docstring using
 http://sourceforge.net/mailarchive/forum.php?thread_id=1983862&forum_id=1100.

git-svn-id: http://svn.roundup-tracker.org/svnroot/roundup/trunk@1932 57a73879-2fb5-44c3-a270-3262357dd7e2
---
 roundup/admin.py | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/roundup/admin.py b/roundup/admin.py
index c4cc737..413509a 100644
--- a/roundup/admin.py
+++ b/roundup/admin.py
@@ -16,7 +16,7 @@
 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 # 
-# $Id: admin.py,v 1.58 2003-08-29 12:43:03 richard Exp $
+# $Id: admin.py,v 1.59 2003-10-24 19:48:05 jlgijsbers Exp $
 
 '''Administration commands for maintaining Roundup trackers.
 '''
@@ -277,11 +277,18 @@ Command help:
     def listTemplates(self):
         ''' List all the available templates.
 
-            Look in three places:
-                <prefix>/share/roundup/templates/*
-                <__file__>/../templates/*
-                current dir/*
-                current dir as a template
+        Look in the following places, where the later rules take precedence:
+
+         1. <prefix>/share/roundup/templates/*
+            this should be the standard place to find them when Roundup is
+            installed
+         2. <roundup.admin.__file__>/../templates/*
+            this will be used if Roundup's run in the distro (aka. source)
+            directory
+         3. <current working dir>/*
+            this is for when someone unpacks a 3rd-party template
+         4. <current working dir>
+            this is for someone who "cd"s to the 3rd-party template dir
         '''
         # OK, try <prefix>/share/roundup/templates
         # -- this module (roundup.admin) will be installed in something
-- 
2.30.2