Move Tim Guirgies' help for status/severity overrides to .
authorW. Trevor King <wking@drexel.edu>
Wed, 25 May 2011 10:46:26 +0000 (06:46 -0400)
committerW. Trevor King <wking@drexel.edu>
Wed, 25 May 2011 10:46:26 +0000 (06:46 -0400)
libbe/command/set.py
libbe/command/severity.py
libbe/command/status.py

index b3eb5835cc3d1547132dcc79e09e1249eafad143..d2da2ecbf7195998d7a56aa1a6c2d6a4af3594e3 100644 (file)
@@ -100,7 +100,56 @@ To unset a setting, set it to "none".
 
 Allowed settings are:
 
-%s""" % ('\n'.join(get_bugdir_settings()),)
+%s
+
+Note that this command does not provide a good interface for some of
+these settings (yet!).  You may need to edit the bugdir settings file
+(`.be/<bugdir>/settings`) manually.  Examples for each troublesome
+setting are given below.
+
+Add the following lines to override the default severities and use
+your own:
+
+  severities:
+    - - target
+      - The issue is a target or milestone, not a bug.
+    - - wishlist
+      - A feature that could improve usefulness, but not a bug.
+
+You may add as many name/description pairs as you wish to have; they
+are sorted in order from least important at the top, to most important
+at the bottom.  The target severity gets special handling by `be
+target`.
+
+Note that the values here _override_ the defaults. That means that if
+you like the defaults, and wish to keep them, you will have to copy
+them here before adding any of your own.  See `be severity --help` for
+the current list.
+
+Add the following lines to override the default statuses and use your
+own:
+
+  active_status:
+    - - unconfirmed
+      - A possible bug which lacks independent existance confirmation.
+    - - open
+      - A working bug that has not been assigned to a developer.
+
+  inactive_status:
+    - - closed
+      - The bug is no longer relevant.
+    - - fixed
+      - The bug should no longer occur.
+
+You may add as many name/description pairs as you wish to have; they
+are sorted in order from most important at the top, to least important
+at the bottom.
+
+Note that the values here _override_ the defaults. That means that if
+you like the defaults, and wish to keep them, you will have to copy
+them here before adding any of your own.  See `be status --help` for
+the current list.
+""" % ('\n'.join(get_bugdir_settings()),)
 
 def get_bugdir_settings():
     settings = []
index 3aea386ce559412b42e25a2f711b9e311650fdda..4692b70fa75617280adf04dfe683894655ac395a 100644 (file)
@@ -98,19 +98,7 @@ is specified, it will be assigned to the bug.
 Severity levels are:
   %s
 
-You can overide the list of allowed severities on a per-repository basis.
-In order to do so, you must edit your be settings file. This can be found within your .be/xxx-xxx directory.
-
-Add the following lines to override the default severities and use your own:
-
-severities:
-    - - target
-      - The issue is a target or milestone, not a bug.
-    - - wishlist
-      - A feature that could improve usefulness, but not a bug.
-
-You may add as many name/description pairs as you wish to have; they are sorted in order from least important at the top, to most important at the bottom.
-
-Note that the values here _override_ the defaults. That means that if you like the defaults, and wish to keep them, you will have to copy them here before adding any of your own.
+You can overide the list of allowed severities on a per-repository
+basis.  See `be set --help` for details.
 """ % ('\n  '.join(severity_levels))
         return ret
index e708e8fd0252ded8dfbe4667105640b5185001d0..887ff0544ffc74883b3849d4102859fef5dd00d3 100644 (file)
@@ -110,25 +110,7 @@ Active status levels are:
 Inactive status levels are:
   %s
 
-You can overide the list of allowed statuses on a per-repository basis.
-In order to do so, you must edit your be settings file. This can be found within your .be/xxx-xxx directory.
-
-Add the following lines to override the default statuses and use your own:
-
-active_status:
-    - - unconfirmed
-      - A possible bug which lacks independent existance confirmation.
-    - - open
-      - A working bug that has not been assigned to a developer.
-
-inactive_status:
-    - - closed
-      - The bug is no longer relevant.
-    - - fixed
-      - The bug should no longer occur.
-
-You may add as many name/description pairs as you wish to have; they are sorted in order from most important at the top, to least important at the bottom.
-
-Note that the values here _override_ the defaults. That means that if you like the defaults, and wish to keep them, you will have to copy them here before adding any of your own.
+You can overide the list of allowed statuses on a per-repository
+basis.  See `be set --help` for details.
 """ % ('\n  '.join(active_statuses), '\n  '.join(inactive_statuses))
         return ret