]> git.ipfire.org Git - thirdparty/bugzilla.git/commitdiff
Bug 141036 - add INTERFACE comments to all templates. This does the first 20 or so...
authorgerv%gerv.net <>
Tue, 7 May 2002 02:16:46 +0000 (02:16 +0000)
committergerv%gerv.net <>
Tue, 7 May 2002 02:16:46 +0000 (02:16 +0000)
26 files changed:
template/en/default/account/created.html.tmpl
template/en/default/account/email/change-old.txt.tmpl
template/en/default/account/email/confirm.html.tmpl
template/en/default/account/exists.html.tmpl
template/en/default/admin/attachstatus/edit.html.tmpl
template/en/default/admin/attachstatus/list.html.tmpl
template/en/default/attachment/created.html.tmpl
template/en/default/attachment/updated.html.tmpl
template/en/default/bug/choose-xml.html.tmpl
template/en/default/bug/create/comment.txt.tmpl
template/en/default/bug/votes/delete-all.html.tmpl
template/en/default/bug/votes/list-for-bug.html.tmpl
template/en/default/bug/votes/list-for-user.html.tmpl
template/en/default/global/choose-product.html.tmpl
template/en/default/global/code-error.html.tmpl
template/en/default/global/header.html.tmpl
template/en/default/global/message.html.tmpl
template/en/default/global/user-error.html.tmpl
template/en/default/index.html.tmpl
template/en/default/list/edit-multiple.html.tmpl
template/en/default/list/list-simple.html.tmpl
template/en/default/list/quips.html.tmpl
template/en/default/list/server-push.html.tmpl
template/en/default/reports/components.html.tmpl
template/en/default/search/search-advanced.html.tmpl
template/en/default/search/search.html.tmpl

index 314b71e470113a2c423f5852d939898237f3f5a1..4a68b63fd8b89f4f6d492596e4a128c191683248 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # login: string. The user's Bugzilla login email address.
+  #%]
+
 [% PROCESS global/header.html.tmpl 
   title = "Account Created"
 %]
index d50a958c6b21e5671a9e3d7d69ece3ae1d1ca5bb..cd1334d3f7ec9030390a00b762c94397da78d6eb 100644 (file)
   #
   # Contributor(s):     John Vandenberg <zeroj@null.net>
   #%]
+[%# INTERFACE:
+  # emailaddress: string. The user's old Bugzilla login email address.
+  # newemailaddress: string. The user's new Bugzilla login email address.
+  # token: string. The token associated with this change.
+  #%]
 [% expiration_ts = token_ts + (max_token_age * 86400) %]
 From: bugzilla-admin-daemon
 To: [% emailaddress %]
index 5fd1570e6c42b5ba2a776919e1ff6e7865c5ddaa..ebba5c76f02760caec3754ffb6e05d4bd1a02bf8 100644 (file)
   # Contributor(s):     John Vandenberg <zeroj@null.net>
   #%]
 
+[%# INTERFACE:
+  # token: string. The token to be used in this address change.
+  #%]
+  
 [% PROCESS global/header.html.tmpl %]
 
-
 <p>
   To change your email address, please enter the old email address:
 </p>
index 912b117f91996c63a0fbb06a35a4aad9c282f110..5281b20cf3a0269bde2af04ea4fc9a383fe3849f 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # login: string. The user's Bugzilla login email address.
+  #%]
+
 [% PROCESS global/header.html.tmpl 
   title = "Account Exists"
 %]
index ef8d5cf6a7c2a62c8a2efc744d5c06bdc2e8abe7..3c2fc2b9072449d36b59bb2ad7913cdb6202a5f5 100644 (file)
   # Contributor(s): Myk Melez <myk@mozilla.org>
   #%]
 
+[%# INTERFACE:
+  # name: string. The name of the attachment status we are editing.
+  # desc: string. Its description.
+  # sortkey: integer. Where it's sorted in the list.
+  # product: string. Which product it applies to.
+  # id: integer. Its internal ID number.
+  #%]
+
 [% PROCESS global/header.html.tmpl 
   title = "Edit Attachment Status"
   style = "
index e03b7dc7a726431fc0cd76feb9a6c7be8c664398..67d5640aed271f119856319fcef3a35982193a1f 100644 (file)
   # Contributor(s): Myk Melez <myk@mozilla.org>
   #%]
 
+[%# INTERFACE:
+  # statusdefs: list of hashes. may be empty. Each hash has six members:
+  #   name: string. The name of the attachment status.
+  #   description: string. Its description.
+  #   sortkey: integer. Sorting priority.
+  #   product: string. The product to which the attachment status applies.
+  #   id: integer. Its internal ID number.
+  #   attachcount: integer. How many attachments have that status.
+  #%]
+
 [% PROCESS global/header.html.tmpl 
   title = 'Administer Attachment Statuses'
   message = message
index b4af46e808eb29dcb84fc959824f9c13e8736345..880630ba2c1142d0b5a433e3fae625aebd2005b0 100644 (file)
   # Contributor(s): Myk Melez <myk@mozilla.org>
   #%]
 
+[%# INTERFACE:
+  # bugid: integer. ID of the bug we just attached an attachment to.
+  # attachid: integer. ID of the attachment just created.
+  # description: string. Description of the attachment just created.
+  # contenttype: string. The Content Type we attached it as.
+  # contenttypemethod: string. How we got the content type of the attachment.
+  #  Possible values: autodetect, list, manual.
+  # mailresults: string. who was mailed, and who wasn't.
+  #%]
+  
 [% PROCESS global/header.html.tmpl 
   title = "Changes Submitted"
   style = "th { text-align: left; }"
index d522c638d14bcffca8fd5e4e85e14d2e51f56ebb..5c2ffd10fe19ebf688560cfc484adcc8da49eca1 100644 (file)
   #                 Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # bugid: integer. ID of the bug we are updating.
+  # attachid: integer. ID of the attachment we just attached.
+  # mailresults: string. Who was mailed and who wasn't. 
+  #%]
+  
 [% PROCESS global/header.html.tmpl 
   title = "Changes Submitted"
   style = "th { text-align: left; }"
index d6bae93f6b8cabf10e93c413649d8cab0bd605d6..341df9414c8e712a41b6f5fd73f5b7dda9cb885f 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # This template has no interface.
+  #%]
+  
 [% PROCESS global/header.html.tmpl 
    title = "Display bugs as XML"
  %]
index 21a9f3ff800a49f20bc2dac3ae9caaf6ee208677..595ad3a808fa197215c5771438a6d7c292329a75 100644 (file)
@@ -18,4 +18,9 @@
   #
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
+[%# INTERFACE:
+  # form: hash. This is the $::FORM variable from a bug submission (i.e. the
+  # fields on a template from enter_bug.cgi.) It can be used to pull out 
+  # various custom fields and format an initial Description entry from them. 
+  #%]  
 [% form.comment %]
index f9df23894c930bbe4b85046b64c56ea4538b397d..c50b0cb1cacf5d6b9a84128fa7a4dd1ac5d0b8b4 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # This template has no interface. 
+  #%]
+  
 [% PROCESS global/header.html.tmpl
            title = "Remove your votes?"
  %]
index b58ba6ff480cd496b7027946705b6b71ff3ed650..cb68a2a4747830ea535ef0e064ed4c9246db18a3 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # bug_id: integer. ID of the bug we are listing the votes for.
+  # users: list of hashes. May be empty. Each hash has two members:
+  #   name: string. The login name of the user whose vote is attached
+  #   count: integer. The number of times that user has votes for this bug.
+  # total: integer. The total number of votes for this bug. 
+  #%]
+  
 [% PROCESS global/header.html.tmpl
            title = "Show Votes"
            h2 = "Bug <a href='show_bug.cgi?id=$bug_id'>$bug_id</a>"
index 261e0f86438379692db1918dc66afcf1424a6d5f..4797d71b7592e45bf2e83b7e3e99f2d609375953 100644 (file)
 
 [% PROCESS global/header.html.tmpl
            title = "Show Votes"
-           h2 = user.name
+           h2 = voting_user.name
  %]
 
+[% canedit = 1 IF voting_user.login == user.login %]
+
 [% IF votes_recorded %]
   <p>
     <font color="red">
@@ -76,7 +78,7 @@
               </a>
             </td>
             <td align="right">
-              [% IF user.canedit %]
+              [% IF canedit %]
                 [% IF product.onevoteonly %]
                   <input type="checkbox" name="[% bug.id %]" value="1"
                     [% " checked" IF bug.count %]>
       [% END %]
     </table>
 
-    [% IF user.canedit %]
+    [% IF canedit %]
       <input type="submit" value="Change My Votes">
       <br>
       <br>
   </form>
 [% ELSE %]
   <p>
-    [% IF user.canedit %]
+    [% IF canedit %]
     You are
     [% ELSE %]
     This user is
index 7bd27ffc8675c0e2731ca649eb26279aa3d0be48..e8d9aaf5c0f596485fb106e623844d3c8b702ff7 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # proddesc: hash. May be empty. The hash keys are the products, and the values
+  # are their descriptions.
+  #%]
+
 [% DEFAULT title = "Choose a Product" %]
 [% PROCESS global/header.html.tmpl %]
 
index b0f21f7ffc25bb162bb74f10e76ed63c9ef3e028..637fba6b1bb3dedb87513c4a37e3e9acceb64254 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # header_done: boolean. True if the header has already been printed.
+  # error: string. The error message to be printed. May contain HTML.
+  # variables: hash. Useful data about the problem. The keys are the variable
+  #  names, and the values the variable values.
+  #%]
+  
 [% UNLESS header_done %]
   [% PROCESS global/header.html.tmpl %]
 [% END %]
index bba911ff4fa9523efefc6971111ca4271dca1d0c..f77649ae3a1cd5921b447fb77b63791cda455ccc 100644 (file)
   # Contributor(s):
   #%]
 
+[%# INTERFACE:
+  # (All the below interface elements are optional.)
+  # title: string. Page title.
+  # h1: string. Main page header.
+  # h2: string. Page subheader.
+  # extra: string. Any other HTML to go inside the <head> tags.
+  # jscript: string. Javascript to go in the header.
+  # style: string. CSS style.
+  # message: string. A message to display to the user. May contain HTML.
+  #%]
+
 [% DEFAULT
   title = ""
   h1 = title
index 8738def08069545ebf39e5c4614ea702b89b7e58..14e1f10d0343784f1bdd1657ed0fb78cb8cebb9f 100644 (file)
   # Contributor(s):
   #%]
   
+[%# INTERFACE:
+  # url: string. An optional URL to go to.
+  # link: string. The link text for that URL.
+  #%]
+
 [% DEFAULT title = "Bugzilla Message" %]
 
 [% PROCESS global/header.html.tmpl %]
index d2e527dda50d8fdf33b4b4d07986218a352ab9f1..f24b5293f11e781387f75996a4464b9d355d8aab 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # header_done: boolean. True if the header has already been printed.
+  # error: string. The error message to be displayed. May contain HTML.
+  #%]
+  
 [% UNLESS header_done %]
   [% PROCESS global/header.html.tmpl %]
 [% END %]
index 35e4e9c85705c3e391b813cf609d29ba2b0e6e89..4a2844255183dd0fa56f3f31ab79c11a1cc15163 100644 (file)
   #                 Jacob Steenhagen <jake@acutex.net>
   #%]
 
+[%# INTERFACE:
+  # username: string. The login name of the user, if any.
+  #%]
+
 [% PROCESS global/header.html.tmpl
   title = 'Bugzilla Main Page'
 %]
index c7c8d00bf7eec4be90f740cb643580697d84bc6d..fb28845c519f5e3e8b5a17778fa1a9ea2436fb96 100644 (file)
   Reassign</A> bugs to
 </label>
 <input name="assigned_to" 
-       value="[% user FILTER html %]"
+       value="[% user.login FILTER html %]"
        onchange="document.forms.changeform.knob[[% knum %]].checked = true;"
        size="32"><br />
 
index b8d8241a3b6b0152c3004d0b12ee232051cf2eb5..b86f697edd797326bd692ed8ed93a5877f939438 100644 (file)
   # Contributor(s): Myk Melez <myk@mozilla.org>
   #%]
 
+[%# INTERFACE:
+  # title: string. The title for this page. (optional)
+  #%]
+
 [%############################################################################%]
 [%# Initialization                                                           #%]
 [%############################################################################%]
index 1d6143dfe16e884ace11affeae0f7125b1f8ebea..032f35fcfc764f3d567aa40ad32fd0f437a13b02 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # added_quip: string. Defined if the CGI added a quip data before 
+  #                displaying anything; if defined, its value is that quip.
+  # show_quips: boolean. True if we are showing the entire quip list.
+  # quips: list of strings. Defined iff show_quips is true. List of all quips.
+  #%]
+
 [% PROCESS global/header.html.tmpl
            title = "Bugzilla Quip System"
            h1 = "Add your own clever headline"
index 5a2dde0b1a9056efc9dfacdea4109e93c62a15fe..9b7131654d03850f41febc1706fccdbe7c32679a 100644 (file)
   # Contributor(s): Myk Melez <myk@mozilla.org>
   #%]
 
+[%# INTERFACE:
+  # debug: boolean. True if we want the query displayed while we wait.
+  # query: string. The SQL query which makes the buglist.
+  #%]
+  
 <html>
   <head>
     <title>Bugzilla is pondering your query</title>
index 9f275eda7282eedf13d4c91cafee9ef347f750c2..8bc549509ddffd809ba639011c6b5f5c183cb230 100644 (file)
   # Contributor(s): Bradley Baetz <bbaetz@student.usyd.edu.au>
   #%]
 
+[%# INTERFACE:
+  # product: string. The product this is the components list for.
+  # components: List of hashes. May be empty. Each hash has four members:
+  #   name: string. Name of the component.
+  #   description: string. Description of the component. May contain HTML.
+  #   initialowner: string. Component's initial owner.
+  #   initialqacontact: string. Component's initial QA contact.
+  #%]
+  
 [% filtered_product = product FILTER html %]
 [% PROCESS global/header.html.tmpl 
   title = "Components for $product"
index 63e947ad5641da1cbdf69bcfaa1abe938a2461fc..6284ec516baca47d5afff457fe0f9a5db763f94a 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # This template has no interface. However, to use it, you need to fulfill
+  # the interfaces of search/form.html.tmpl, search/knob.html.tmpl and
+  # search/boolean-charts.html.tmpl.
+  #%]
+
 [% PROCESS global/header.html.tmpl 
   title = "Search for bugs"
   extra = " onLoad=\"selectProduct(document.forms['queryform']);\""
index 63e947ad5641da1cbdf69bcfaa1abe938a2461fc..6284ec516baca47d5afff457fe0f9a5db763f94a 100644 (file)
   # Contributor(s): Gervase Markham <gerv@gerv.net>
   #%]
 
+[%# INTERFACE:
+  # This template has no interface. However, to use it, you need to fulfill
+  # the interfaces of search/form.html.tmpl, search/knob.html.tmpl and
+  # search/boolean-charts.html.tmpl.
+  #%]
+
 [% PROCESS global/header.html.tmpl 
   title = "Search for bugs"
   extra = " onLoad=\"selectProduct(document.forms['queryform']);\""