changeset 1863:d2ad3309c415

Clarify listTemplates docstring... ...using http://sourceforge.net/mailarchive/forum.php?thread_id=1983862&forum_id=1100.
author Johannes Gijsbers <jlgijsbers@users.sourceforge.net>
date Fri, 24 Oct 2003 19:48:05 +0000
parents 0afdf96ea9d7
children 969a14faf707
files roundup/admin.py
diffstat 1 files changed, 13 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- a/roundup/admin.py	Fri Oct 24 16:29:17 2003 +0000
+++ b/roundup/admin.py	Fri Oct 24 19:48:05 2003 +0000
@@ -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 @@
     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

Roundup Issue Tracker: http://roundup-tracker.org/