=== modified file 'lib/lp/bugs/interfaces/bugtask.py'
--- lib/lp/bugs/interfaces/bugtask.py	2010-04-19 14:47:49 +0000
+++ lib/lp/bugs/interfaces/bugtask.py	2010-05-04 01:26:40 +0000
@@ -776,7 +776,7 @@
     """The basic search controls."""
     searchtext = TextLine(title=_("Bug ID or text:"), required=False)
     status = List(
-        title=_('Status'),
+        title=_('Show only bugs with the given status value(s).\nAccepts either a string or list of strings.\nAcceptable values are: New, Incomplete (with response), Incomplete (without response), Incomplete, Invalid, Won\'t Fix, Confirmed, Triaged, In Progress, Fix Committed, Fix Released'),
         value_type=Choice(
             title=_('Status'),
             vocabulary=BugTaskStatusSearch,
@@ -784,56 +784,58 @@
         default=list(DEFAULT_SEARCH_BUGTASK_STATUSES),
         required=False)
     importance = List(
-        title=_('Importance'),
+        title=_('Show only bugs with the given importance(s).\nAccepts either a string or list of strings.\nAcceptable values are: Unknown, Critical, High, Medium, Low, Wishlist, Undecided.'),
         value_type=IBugTask['importance'],
         required=False)
     assignee = Choice(
-        title=_('Assignee'), vocabulary='ValidAssignee', required=False)
+        title=_('Person entity assigned for this bug.\nHint: Use the .people[] top-level object to retrieve the person object by launchpad username.'), vocabulary='ValidAssignee', required=False)
     bug_reporter = Choice(
-        title=_('Bug Reporter'), vocabulary='ValidAssignee', required=False)
+        title=_('Person entity who filed the bug report'), vocabulary='ValidAssignee', required=False)
     omit_dupes = Bool(
-        title=_('Omit duplicate bugs'), required=False,
+        title=_('Omit bugs marked as a duplicate (True by default)'), required=False,
         default=True)
     omit_targeted = Bool(
-        title=_('Omit bugs targeted to series'), required=False,
+        title=_('Omit bugs that have been targeted to a distro series (True by default)'), required=False,
         default=True)
     statusexplanation = TextLine(
+        #FIXME: What is this for?
         title=_("Status notes"), required=False)
     has_patch = Bool(
-        title=_('Show only bugs with patches available'), required=False,
+        title=_('Show only bugs with patch attachments (False by default)'), required=False,
         default=False)
     has_no_package = Bool(
-        title=_('Exclude bugs with packages specified'),
+        title=_('Exclude bugs with packages specified (False by default)'),
         required=False, default=False)
     milestone_assignment = Choice(
+        #FIXME: What is milestone_assignment for?
         title=_('Target'), vocabulary="Milestone", required=False)
     milestone = List(
-        title=_('Target'), value_type=IBugTask['milestone'], required=False)
+        title=_('Show only bug tasks targeted to this milestone entity or uri'), value_type=IBugTask['milestone'], required=False)
     component = List(
-        title=_('Component'), value_type=IComponent['name'], required=False)
+        title=_('Distribution package archive grouping.  E.g. main, universe, multiverse'), value_type=IComponent['name'], required=False)
     tag = List(title=_("Tag"), value_type=SearchTag(), required=False)
     status_upstream = List(
-        title=_('Status Upstream'),
+        title=_('Status upstream if the bug task is a remote watch.\nAcceptable values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.\nUse hide_upstream to search for bugs not known to affect upstream'),
         value_type=Choice(vocabulary=UPSTREAM_STATUS_VOCABULARY),
         required=False)
     has_cve = Bool(
         title=_('Show only bugs associated with a CVE'), required=False)
     bug_supervisor = Choice(
-        title=_('Bug supervisor'), vocabulary='ValidPersonOrTeam',
+        title=_('Bug supervisor person entity'), vocabulary='ValidPersonOrTeam',
         required=False)
     bug_commenter = Choice(
-        title=_('Bug commenter'), vocabulary='ValidPersonOrTeam',
+        title=_('Bug commenter person entity'), vocabulary='ValidPersonOrTeam',
         required=False)
     subscriber = Choice(
-        title=_('Bug subscriber'), vocabulary='ValidPersonOrTeam',
+        title=_('Bug subscriber person entity'), vocabulary='ValidPersonOrTeam',
         required=False)
     affects_me = Bool(
         title=_('Show only bugs affecting me'), required=False)
     has_branches = Bool(
-        title=_('Show bugs with linked branches'), required=False,
+        title=_('Show bugs with linked branches (True by default)'), required=False,
         default=True)
     has_no_branches = Bool(
-        title=_('Show bugs without linked branches'), required=False,
+        title=_('Show bugs without linked branches (True by default)'), required=False,
         default=True)
 
 
@@ -847,7 +849,7 @@
     one value can be selected.)
     """
     tag = List(
-        title=_("Tags"), description=_("Separated by whitespace."),
+        title=_("Tags"), description=_("String or list of strings for tags to search.  To exclude, prepend a '-', e.g. '-unwantedtag'"),
         value_type=SearchTag(), required=False)
     tags_combinator = Choice(
         title=_("Tags combination"),